MAN page from PLD vixie-cron-4.1-21.i386.rpm

CRONTAB

Section: Manuel de l'administrateur Linux (5)
Updated: 2 Mai 1999
Index

NOM

crontab - Table permettant de gérer le démon Cron.

DESCRIPTION

Un fichiercrontabcontient des instructions pour le démoncron(8).Ces instructions ont la forme générale suivante : ``lancer cette commandeŕ telle heure, tel jour''.

Chaque utilisateur dispose de sa propre table crontab, et les commandescontenues dans une table seront éxécutées sous l'identifiant du propriétairede la table.

Les pseudo-utilisateurs Uucp et News disposent généralement de leurs proprescrontabs, ce qui évite d'invoquer explicitementsu(1)dans une commande cron.

Les lignes blanches, et les espaces et tabulations en tęte de lignes sontignoreés. Les lignes dont le premier caractčre non-blanc est un dičse (#) sontconsidérées comme des commentaires, et sont également ignorées.Notez que les commentaires ne peuvent pas se trouver sur la męme lignequ'une commande cron, car ils seraient considérés comme des argumentsen ligne pour la commande ŕ invoquer.De męme, un commentaire ne peut pas se trouver sur la męme ligne qu'uneaffectation de variable d'environnement.

Une ligne active dans une crontab devra donc ętre soit une affectationde variable d'environnement, soit une commande cron. Une ligne d'affectation d'environnement est de la forme

nom = valeur

oů les espaces autour du signe égal (=) sont facultatifs, et oů tous lesespaces ultérieurs feront partie intégrante de la valeur affectée ŕ lavariable ayant lenomindiqué.La chaîne devaleurpeut ętre inscrite entre guillemets ou entre quotes afin de protéger lesblancs initiaux et finaux.

Plusieurs variables d'environnement sont automatiquementconfigurées par le démoncron(8).SHELL est rempli avec /bin/sh, LOGNAME et HOME sont configuréesŕ partir de la ligne de /etc/passwd correspondant au propriétaire de la crontab.HOME et SHELL peuvent ętre surchargés par des affectations explicitesdans la crontab, LOGNAME non.

(Note : la variable LOGNAME est parfois nommée USER sur les systčmes BSD,elle sera alors configurée).

En plus de LOGNAME, HOME, et SHELL,cron(8)prendra en compte la variable MAILTO s'il doit envoyer le résultat d'unecommande exécutée dans cette crontab. Si MAILTO est définie (et non vide),le résultat est envoyé ŕ l'utilisateur indiqué. Si MAILTO est défini et vide(MAILTO=""), aucun courrier ne sera envoyé.Sinon, le courrier sera émis vers le propriétaire de la crontab.

Cette option est utile si vous utilisez /bin/mail comme agent ŕ la place de/usr/lib/sendmail lorsque vous installez cron. /bin/mail ne gčre pas d'alias,et UUCP ne lit généralement pas son courrier.

Le format d'une commande cron est trčs proche du standard V7, avec quelquesoptions gardant une compatibilité ascendante.Chaque ligne dispose de 5 champs de date et heure, suivi d'un nom d'utilisateurs'il s'agit du fichier crontab central du systčme, suivi d'une commande.Les commandes sont éxécutée parcron(8)lorsque les champs minute, heure, et mois de l'année correspondent ŕ la dateetquand au moins l'un des deux autres champs (jour du mois, jour de la semaine)correspond aussi (voir le paragraphe ``Note'' plus bas).cron(8)examine ses données une fois par minute.Les champs de date et heure sont :

: champs         valeurs autorisées

-----         --------------

minute        0-59

heure         0-23

jour du mois  0-31

mois          0-12 (ou noms, voir plus bas)

jour de semaine0-7 (0 et 7 snt Dimanche, ou les noms)

Un champ peut contenir un astérisque (*), qui correspond ŕ l'intervalle``premier-dernier''

Les intervalles de nombres sont permis. Il se présentent sous formede deux nombres séparés par un tiret. Les bornes sont inclues. Par exemple,l'intervalle horaire 8-11 correspond ŕ une éxécution aux heures 8, 9, 10, et 11.

Les listes sont permises. Une liste est une série de nombres ou d'intervallesséparés par des virgules. Exemple ``1,2,5,9'', ``0-4,8-12''.

Des valeurs de "pas" peuvent ętre associées aux intervalles. A la suite d'un intervalle, un ``/nombre'' précise le pas ŕ adopter pour parcourirl'intervalle. Par exemple ``0-23/2'' dans le champs horaire demandeune exécution toutes les heures paires. Une alternative avec le standardV7 serait ``0,2,4,6,8,10,12,14,16,18,20,22''). Les pas sont égalementautorisés ŕ la suite d'un astérisque, ainsi, pour dire``toutes les deux heures'', on peut utiliser ``*/2''.

On peut employer les noms des mois ou des jours de la semaine, enutilisant les trois premičres lettres (pas de différence majuscule/minuscule).Les intervalles, ou les listes de noms ne sont pas acceptés.

Le sixičme champ (le reste de la ligne) indique la commande ŕ exécuter.Tout le reste de la ligne, jusqu'au retour chariot ou au caractčre %,sera exécuté par /bin/sh, ou par le shell mentionné dans la variableSHELL du fichier cron.Les signes pourcentages (%) dans les commandes seront transformés enretour-chariot, sauf s'ils sont précédés par un backslash (\). Toutesles données se trouvant ŕ la suite du premier % seront transmisesŕ la commande sur son entrée standard.

Note: Le jour d'éxécution d'une commande peut ętre spécifié part deuxchamps (jour du mois, et jour de la semaine). Si les deux champs sontremplis (i.e, pas *), la commande sera lancée quand l'undes champs correspond ŕ la date en cours. Par exemple
``30 4 1,15 * 5''exécutera une commande ŕ 4:30 du matin les 1er et 15 de chaque mois, ETchaque Vendredi.

EXEMPLE DE FICHIER CRONTAB

# utiliser /bin/sh pour lancer les commandes, quoiqu'en dise /etc/passwd.SHELL=/bin/sh# Envoyer les résultats ŕ Paul, sans tenir compte du propriétaireMAILTO=paul## Chaque jour, 5 minutes aprčs Minuit5 0 * * *       $HOME/bin/daily.job >> $HOME/tmp/out 2>&1# Le premier de chaque mois ŕ 14h15 - Résultat envoyé ŕ Paul15 14 1 * *     $HOME/bin/monthly# Les jours de la semaine ŕ 22h, énerver Joe0 22 * * 1-5   mail -s "Il est 22h" joe%Joe,%%Oů sont tes enfants ?%23 0-23/2 * * * echo "Tous les jours, ŕ 23mn aprčs 0h, 2h, 4h..."5 4 * * sun     echo "Tous les dimanches ŕ 4h 05"

VOIR AUSSI

cron(8), crontab(1)

EXTENSIONS

Dans l'utilisation du jour de la semaine, le 0 et le 7 correspondent tous deuxau Dimanche.BSD et ATT ne sont pas tout ŕ fait d'accord lŕ-dessus.

On autorise les intervalles et les listes dans le męme champs."1-3,7-9" sera rejetté par le cron ATT ou BSD, ils n'acceptent que "1-3" ou "7,8,9".

Les intervalles peuvent inclure des "pas", ainsi "1-9/2" équivaut ŕ "1,3,5,7,9".

Les noms des mois ou des jours de la semaine peuvent ętre utilisés.

Les variables d'environnement peuvent ętre configurées dans la crontab.Avec BSD ou ATT, les environnements transmis aux processus filssont globalement ceux de /etc/rc.

La sortie des commandes est normalement envoyée au propriétaire de la crontab(pas sous BSD), mais peut ętre dirigée vers une autre personne (pas sous SysV),ou l'on peut empęcher toute redirection du courrier (pas sous SysV non plus).

AUTEUR

Paul Vixie <paulAATTvix.com>

TRADUCTION

Christophe Blaess, 1999.

This document was created byman2html,using the manual pages.