fcrontab

La configuration de l'environnement

La configuration de l'environnement est de la forme

nom = valeur

o les espaces autour du signe d'galit = sont ignores et optionnelles. Les espaces en fin de ligne sont galement ignores, mais vous pouvez placer la valeur entre guillemets (simple ou double, mais appareills) pour prserver les caractres blancs dans la valeur.

Lorsque fcron excute une commande, il positionne toujours les variables d'environnement USER, HOME, et SHELL comme elles sont dfinies dans /etc/passwd pour le propritaire de la table fcrontab dont la commande est issue. Les variables d'environnement HOME et SHELL peuvent tre crases par la configuration contenue dans le fichier fcrontab, mais USER ne peut pas l'tre. Toute autre affectation d'environnement dfinie dans le fcrontab de l'utilisateur est effectue et la commande excute.

De plus, la variable spciale MAILTO vous permet d'indiquer fcron qui envoyer par courriel la sortie de la commande. Veuillez noter que MAILTO est en fait quivalente la dclaration globale de l'option mailto (voir plus loin). Elle n'est utilise que pour assurer une rtrocompatibilit, aussi, vous devriez plutt utiliser directement l'option mailto.

Entres bases sur le temps coul depuis le dmarrage du systme

Les entres des commandes qui doivent tre excutes une fois toutes les m minutes de l'excution de fcron (qui sont normalement les mmes m minutes de l'excution du systme) sont de la forme

@options frquence commande

o frquence est une valeur de temps de la forme valeur*multiplicateur+valeur*multiplicateur+...+valeur-en-minutes comme \12h02\ ou \3w2d5h1\. La premire signifie \12 heures et 2 minutes d'excution de fcron\ tant dis que la seconde signifie \3 semaines, 2 jours, 5 heures et 1 minute d'excution de fcron\. Les multiplicateurs valides sont:

la place de options, l'utilisateur peut mettre une valeur de temps qui sera interprte comme @first(temps). Si l'option first n'est pas positionne, la valeur de frquence est utilise.

Ce type d'entre ne garantie pas une date et heure d'excution (vu que la tche est retarde chaque dmarrage du systme par le temps coul depuis l'arrt du systme), mais peut tre pratique pour des tches dpendant du nombre de choses faites par les utilisateurs (par exemple, il vaudrait mieux vrifier le systme de fichiers aprs un certain nombre d'utilisation par les utilisateurs plutt que tous les x jours, vu que le systme peut tre lanc de 1 jour x jours pendant cet intervalle de x jours).

Le temps restant avant la prochaine excution est sauvegard toutes les 1800 secondes (afin de limiter les dommages provoqus par un plantage) et lorsque fcron quitte aprs avoir reu un signal SIGTERM, c.--d. lorsque l'on arrte le systme. Ainsi, ce type d'entre est particulirement utile pour des systmes qui ne tournent pas de manire rgulire. La syntaxe tant trs simple, il est galement pratique pour des tches qui n'ont pas besoin d'tre excutes une date et une heure spcifique.

Voir aussi: les options first, mail, nolog, serial, lavg, nice, runas (voir plus loin).

# Rcuprer vos courriels toutes les 30 minutes
@ 30 getmails -all 

# Effectuer quelques tests de scurit toutes les 48 heures de fonctionnement
# du systme, envoyer un courriel au super-utilisateur mme s'il n'a pas de sortie
@mailto(root),forcemail 2d /etc/security/msec/cron-sh/security.sh

Entres bases sur une date et une heure

Le deuxime type d'entre d'un fichier fcrontab commence par un caractre & optionnel qui peut tre immdiatement suivi par un nombre optionnel dfinissant la frquence d'excution (ceci est quivalent l'option runfreq) ou par une dclaration d'options; il possde cinq champs de date et d'heure, ainsi qu'une commande shell:

&options min hrs jour-du-mois mois jour-de-la-semaine commande

Veuillez noter que la commande shell peut tre prcde par un nom d'utilisateur, ce qui est quivalent runas (user): vu que cela n'existe que pour une retrocompatibilit, vous devriez plutt utiliser l'option runas (voir plus loin). La frquence est interprte de la faon suivante: lancer cette commande aprs x correspondances des champs date et heure. Les champs date et heure sont:

Un champ est toujours renseign soit par une astrique *, qui signifie un intervalle comme premier-dernier, soit un nombre seul, soit une liste.

Les listes sont des nombres ou des intervalles spars par des virgules ,. Par exemple: 2,5,15,23.

Les intervalles de nombres sont de la forme dbut-fin, o dbut et fin sont inclus. Par exemple, 3-5 signifie les valeurs 3, 4 et 5. Vous pouvez galement ajouter un /nombre optionnel l'intervalle, o le nombre signifie le pas dans l'intervalle. Par exemple, 0-23/2 peut tre utilis dans le champ heure pour spcifier l'excution d'une commande toutes les heures paires. Enfin, un ou plusieurs ~nombre peuvent tre ajouts afin de dsactiver certaines valeurs dans l'intervalle. Par exemple, 5-8~6~7 est quivalent 5,8. La forme finale d'un champ est:

a[-b[/c][~d][~e][...]][,f[-g[/h][~i][~j][...]]][,...]

o les lettres sont des nombres entiers.

Vous pouvez galement utiliser unE astrisque * dans un champ. Il agira comme premier-dernier. Par exemple, un * dans le champ minute signifie toutes les minutes de la minute 0 la minute 59.

Des intervalles peuvent tre inclus dans une liste comme un simple nombre. Par exemple: 2,5-10/2~6,15,20-25,30.

Les noms (Ndt: en anglais) peuvent tre utiliss pour les champs mois et jour de la semaine. Pour ce faire, utilisez les trois premires lettres du jour ou du mois concern (la casse n'a pas d'importance). Veuillez noter que les noms sont utiliss exactement comme les nombres: vous pouvez les utiliser dans une liste ou un intervalle.

Si un jour de mois et un jour de semaine sont donns, la commande sera excute seulement si les deux correspondent au jour et l'heure actuels moins que l'option dayor n'ait t positionne. Par exemple, avec la ligne

5 10 31 * 7 echo ''

Voir aussi: options dayor, bootrun, runfreq, mail, nolog, serial, lavg, nice, runas (voir plus loin).

# lancer macommande tous les jours  12:05, 12:35, 13:05, 13:35,
# 14:05 *et* 14:35
& 05,35 12-14 * * * macommande -u moi -o fichier

# rcuprer les courriels toutes les heures aux minutes 20, 21, 22, et 24.
20-24~23 * * * * getmail 

# sauvegarder mon travail de la journe toutes les nuits  03:45 avec une
# faible priorit, sauf le dimanche, envoyer la sortie par courriel  jim et
# lancer cette tche au dmarrage si la machine tait teinte  03:45
&nice(10),mailto(jim),bootrun 45 03 * * *~0 "save --mon travail"

Entres lances priodiquement

Le troisime type d'entre fcrontab commence par le caractre %, suivi par un mot-clef pris parmi une des trois diffrentes listes, puis par des options.

%nightly,mail(no) * 21-23,3-5 echo "une entre nigthly"

%hours * 0-23 * * * echo "Ligne INCORRECTE !"

%hours * 0-22 * * * echo "Ok."

Options

Les options peuvent tre positionnes soit pour chaque ligne situe aprs la dclaration, soit pour une ligne de manire individuelle. Dans le premier cas, la configuration est faite sur une ligne complte aprs un point d'exclamation !, dans le second cas, elle est faite aprs l'un des symboles suivants &, % ou @, suivant le type de planification. Veuillez noter qu'une dclaration d'option dans une planification crase la dclaration globale de la mme option.

Les options sont spares par des virgules , et leurs arguments, s'il y en a, sont placs entre parenthses ( et ). Les espaces ne sont pas permises. Une dclaration d'option est de la forme

option[(arg1[,arg2][...])][,option[(arg1[...])]][...]

o option est soit le nom complet de l'option, soit son abrviation. Les options sont (avec leur valeur par dfaut entre parenthses):

Un argument de type boolen peut ne pas tre indiqu, auquel cas les parenthses ne seront pas utilises et il sera interprt comme tant true; les chanes true, yes ou 1 signifient true; et les chanes false, no ou 0 signifient false. Voir plus haut les explications sur les valeurs de temps (section Entres bases sur le temps coul depuis le dmarrage du systme).

Veuillez noter que dayand et dayor sont, en fait, la mme option: une valeur false pour dayand est quivalente une valeur true pour dayor et rciproquement, une valeur false pour dayor est quivalente une valeur true pour dayand. C'est galement le cas pour les options lavgand et lavgor.

Veuillez noter un cas particulier grer: une tche aurait due tre place dans la file d'attente squentielle, *mais* la prcdente entre de cette tche n'est pas encore acheve cause d'une forte charge systme ou d'un quelconque vnement extrieur. L'option serialonce rpond cette question: La nouvelle entre de cette tche doit-elle tre ignore?. De cette faon, on peut distinguer d'une part les tches sans contrainte forte sur l'heure d'excutionqui doivent tre excutes un nombre de fois bien dfini (serial(yes), serialonce(false)), et d'autre part les tches toujours sans contrainte forte sur l'heure d'excution mais dont le nombre d'excutions n'est pas important ou qu'il est inutile de lancer deux fois d'affile (serial(true), serialonce(true)), qu'on ne rentrera donc pas une deuxime fois dans la file squentielle de faon viter de charger le systme inutilement. Par exemple, Payer ses employs est une tche qui doit tre excute exactement une fois par mois (serialonce(false)), alors que faire le mnage doit tre excute de prfrence une fois par semaine, mais il est inutile de le faire deux fois d'affile si par hasard on avait pris du retard (serialonce(true)).

Les mmes considrations s'appliquent pour la file d'attente charge systme et peuvent tre exprimes par l'option lavgonce.

De plus, si les files d'attente squentielle et charge systme contiennent respectivement plus de 30 et 30 tches, toute nouvelle tche sera rejete (et donc non excute) pour viter une saturation de ressources systme. Dans ce cas, un message d'erreur sera journalis travers syslog.

Enfin, s'il reste des tches dans les files d'attente squentielle et charge systme au moment de l'arrt de fcron, celles-ci seront dposes une fois dans leur file correspondante au redmarrage (l'ordre peut ne pas tre conserv).

!reset,serial(true),dayor,bootrun(0),mailto(root),lavg(.5,2,1.5)