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 ignor�es et optionnelles. Les espaces en fin de ligne sont �galement ignor�es, mais vous pouvez placer la valeur entre guillemets (simple ou double, mais appareill�s) pour pr�server les caract�res blancs dans la valeur.

Lorsque fcron ex�cute une commande, il positionne toujours les variables d'environnement USER, HOME, et SHELL comme elles sont d�finies dans /etc/passwd pour le propri�taire de la table fcrontab dont la commande est issue. Les variables d'environnement HOME et SHELL peuvent �tre �cras�es par la configuration contenue dans le fichier fcrontab, mais USER ne peut pas l'�tre. Toute autre affectation d'environnement d�finie dans le fcrontab de l'utilisateur est effectu�e et la commande ex�cut�e.

De plus, la variable sp�ciale MAILTO vous permet d'indiquer � fcron � qui envoyer par courriel la sortie de la commande. Veuillez noter que MAILTO est en fait �quivalente � la d�claration globale de l'option mailto (voir plus loin). Elle n'est utilis�e que pour assurer une r�trocompatibilit�, aussi, vous devriez plut�t utiliser directement l'option mailto.

Entr�es bas�es sur le temps �coul� depuis le d�marrage du syst�me

Les entr�es des commandes qui doivent �tre ex�cut�es une fois toutes les m minutes de l'ex�cution de fcron (qui sont normalement les m�mes m minutes de l'ex�cution du syst�me) sont de la forme

@options fr�quence commande

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

� la place de options, l'utilisateur peut mettre une valeur de temps qui sera interpr�t�e comme @first(temps). Si l'option first n'est pas positionn�e, la valeur de ��fr�quence�� est utilis�e.

Ce type d'entr�e ne garantie pas une date et heure d'ex�cution (vu que la t�che est retard�e � chaque d�marrage du syst�me par le temps �coul� depuis l'arr�t du syst�me), mais peut �tre pratique pour des t�ches d�pendant du nombre de choses faites par les utilisateurs (par exemple, il vaudrait mieux v�rifier le syst�me de fichiers apr�s un certain nombre d'utilisation par les utilisateurs plut�t que tous les x jours, vu que le syst�me peut �tre lanc� de 1 jour � x jours pendant cet intervalle de x jours).

Le temps restant avant la prochaine ex�cution est sauvegard� toutes les 1800 secondes (afin de limiter les dommages provoqu�s par un plantage) et lorsque fcron quitte apr�s avoir re�u un signal SIGTERM, c.-�-d. lorsque l'on arr�te le syst�me. Ainsi, ce type d'entr�e est particuli�rement utile pour des syst�mes qui ne tournent pas de mani�re r�guli�re. La syntaxe �tant tr�s simple, il est �galement pratique pour des t�ches qui n'ont pas besoin d'�tre ex�cut�es � une date et une heure sp�cifique.

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

# R�cup�rer vos courriels toutes les 30 minutes
@ 30 getmails -all 

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

Entr�es bas�es sur une date et une heure

Le deuxi�me type d'entr�e d'un fichier fcrontab commence par un caract�re ��&�� optionnel qui peut �tre imm�diatement suivi par un nombre optionnel d�finissant la fr�quence d'ex�cution (ceci est �quivalent � l'option runfreq) ou par une d�claration d'options�; il poss�de 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 pr�c�d�e par un nom d'utilisateur, ce qui est �quivalent � runas (user)�: vu que cela n'existe que pour une retrocompatibilit�, vous devriez plut�t utiliser l'option runas (voir plus loin). La fr�quence est interpr�t�e de la fa�on suivante�: ��lancer cette commande apr�s x correspondances des champs date et heure��. Les champs date et heure sont�:

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

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

Les intervalles de nombres sont de la forme ��d�but-fin��, o� ��d�but�� 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 sp�cifier l'ex�cution d'une commande toutes les heures paires. Enfin, un ou plusieurs ��~nombre�� peuvent �tre ajout�s afin de d�sactiver 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 ast�risque ��*�� 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 utilis�s pour les champs ��mois�� et ��jour de la semaine��. Pour ce faire, utilisez les trois premi�res lettres du jour ou du mois concern� (la casse n'a pas d'importance). Veuillez noter que les noms sont utilis�s 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 donn�s, la commande sera ex�cut�e seulement si les deux correspondent au jour et � l'heure actuels � moins que l'option dayor n'ait �t� positionn�e. 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

# r�cup�rer les courriels toutes les heures aux minutes 20, 21, 22, et 24.
20-24~23 * * * * getmail 

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

Entr�es lanc�es p�riodiquement

Le troisi�me type d'entr�e fcrontab commence par le caract�re ��%��, suivi par un mot-clef pris parmi une des trois diff�rentes listes, puis par des options.

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

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

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

Options

Les options peuvent �tre positionn�es soit pour chaque ligne situ�e apr�s la d�claration, soit pour une ligne de mani�re individuelle. Dans le premier cas, la configuration est faite sur une ligne compl�te apr�s un point d'exclamation ��!��, dans le second cas, elle est faite apr�s l'un des symboles suivants ��&��, ��%�� ou ��@��, suivant le type de planification. Veuillez noter qu'une d�claration d'option dans une planification �crase la d�claration globale de la m�me option.

Les options sont s�par�es par des virgules ��,�� et leurs arguments, s'il y en a, sont plac�s entre parenth�ses ��(�� et ��)��. Les espaces ne sont pas permises. Une d�claration d'option est de la forme

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

o� option est soit le nom complet de l'option, soit son abr�viation. Les options sont (avec leur valeur par d�faut entre parenth�ses)�:

Un argument de type bool�en peut ne pas �tre indiqu�, auquel cas les parenth�ses ne seront pas utilis�es et il sera interpr�t� comme �tant true�; les cha�nes ��true��, ��yes�� ou ��1�� signifient true�; et les cha�nes ��false��, ��no�� ou ��0�� signifient false. Voir plus haut les explications sur les valeurs de temps (section ��Entr�es bas�es sur le temps �coul� depuis le d�marrage du syst�me��).

Veuillez noter que dayand et dayor sont, en fait, la m�me option�: une valeur ��false�� pour dayand est �quivalente � une valeur ��true�� pour dayor et r�ciproquement, 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 � g�rer�: une t�che aurait due �tre plac�e dans la file d'attente s�quentielle, *mais* la pr�c�dente entr�e de cette t�che n'est pas encore achev�e � cause d'une forte charge syst�me ou d'un quelconque �v�nement ext�rieur. L'option serialonce r�pond � cette question�: ��La nouvelle entr�e de cette t�che doit-elle �tre ignor�e�?��. De cette fa�on, on peut distinguer d'une part les t�ches sans contrainte forte sur l'heure d'ex�cution�qui doivent �tre ex�cut�es un nombre de fois bien d�fini (serial(yes), serialonce(false)), et d'autre part les t�ches toujours sans contrainte forte sur l'heure d'ex�cution mais dont le nombre d'ex�cutions n'est pas important ou qu'il est inutile de lancer deux fois d'affil�e (serial(true), serialonce(true)), qu'on ne rentrera donc pas une deuxi�me fois dans la file s�quentielle de fa�on � �viter de charger le syst�me inutilement. Par exemple, ��Payer ses employ�s�� est une t�che qui doit �tre ex�cut�e exactement une fois par mois (serialonce(false)), alors que ��faire le m�nage�� doit �tre ex�cut�e de pr�f�rence une fois par semaine, mais il est inutile de le faire deux fois d'affil�e si par hasard on avait pris du retard (serialonce(true)).

Les m�mes consid�rations s'appliquent pour la file d'attente charge syst�me et peuvent �tre exprim�es par l'option lavgonce.

De plus, si les files d'attente s�quentielle et charge syst�me contiennent respectivement plus de 30 et 30 t�ches, toute nouvelle t�che sera rejet�e (et donc non ex�cut�e) pour �viter une saturation de ressources syst�me. Dans ce cas, un message d'erreur sera journalis� � travers syslog.

Enfin, s'il reste des t�ches dans les files d'attente s�quentielle et charge syst�me au moment de l'arr�t de fcron, celles-ci seront d�pos�es une fois dans leur file correspondante au red�marrage (l'ordre peut ne pas �tre conserv�).

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