DOC:UNIX:Crontab

Accueil	SysAdmin	Hobbies

crontab

crontab est le nom du programme sous Unix (et Linux) qui permet d'éditer des tables de configuration du programme cron. Ces tables spécifient les tâches à exécuter et leur horaire d'exécution avec éventuellement une périodicité. Par extension, on appelle souvent cron (ou cron job en anglais) toute tâche lancée à horaire périodique.

Fonctionnement

La commande crontab modifie un fichier relatif à l'utilisateur. Par sécurité, crontab vérifie la syntaxe avant de mettre à jour le fichier. Ce fichier se situe dans l'arborescence /var, par exemple :

• /var/spool/cron/crontabs/<utilisateur> (AIX, HP-UX, Solaris, Debian GNU/Linux et Ubuntu)
• /var/spool/cron/tabs/<utilisateur> (SuSE GNU/Linux)
• /var/cron/tabs/<utilisateur> (FreeBSD et OpenBSD)
• /var/spool/cron/<utilisateur> (Arch Linux, Fedora et CentOS)
• /usr/lib/cron/tabs/<utilisateur> (OS X)

Ainsi pour l'utilisateur root sur une machine Debian, la table cron sera stockée dans /var/spool/cron/crontabs/root

La majorité des systèmes Linux (SuSE, Debian, Red Hat) disposent en plus d'une table cron centralisée dans /etc/crontab.

On trouve également des dossiers /etc/cron.d, /etc/cron.hourly, /etc/cron.daily, /etc/cron.weekly et /etc/cron.monthly qui contiennent les tables cron des différentes parties du système (rotation des journaux, mise à jour de fichiers...).

Pour les postes de travail qui ne fonctionnent pas forcément 24h/24, l'application anacron permet de lancer les commandes qui auraient dû l'être lorsque l'ordinateur était éteint.

Utilisation

Lecture de la table

La ligne de commande suivante affiche le contenu de la table cron pour l'utilisateur courant :

$ crontab -l

Cette commande ne permet pas d'afficher la table centralisée (/etc/crontab).

Modification de la table

La commande suivante permet de modifier la table cron pour l'utilisateur courant :

$ crontab -e

Cette commande a pour effet de lancer l'éditeur par défaut<ref>Défini par la variable d'environnement $EDITOR ou $VISUAL</ref> (en général vi). L'éditeur affiche alors la table actuelle. Lors du premier lancement de crontab, la table est vierge, éventuellement composée de commentaires d'aide (lignes commençant par le caractère #).

L'éditeur par défaut se configure à l'aide des variables d'environnement $EDITOR ou $VISUAL. Par exemple, pour configurer l'éditeur vim :

$ export EDITOR=vim

Cette commande ne permet pas non plus de modifier la table centralisée (/etc/crontab).

Remplacement de la table

crontab peut aussi écraser la table courante par une nouvelle. Cette nouvelle table peut être fournie dans un fichier en paramètre :

$ crontab fichier-contenant-la-nouvelle-table.txt

Suppression de la table

La ligne de commande suivante supprime le contenu, sans confirmation, de la table cron pour l'utilisateur courant :

$ crontab -r

Syntaxe de la table

Notation

Chaque entrée de la table (chaque ligne) correspond à une tâche à exécuter et doit respecter cette notation :

mm hh jj MMM JJJ tâche

• mm représente les minutes (de 0 à 59)
• hh représente l'heure (de 0 à 23)
• jj représente le numéro du jour du mois (de 1 à 31)
• MMM représente l'abréviation du nom du mois (jan, feb, ...) ou bien le numéro du mois (de 1 à 12)
• JJJ représente l'abréviation du nom du jour ou bien le numéro du jour dans la semaine :
  • 0 = dimanche
  • 1 = lundi
  • 2 = mardi
  • …
  • 6 = samedi
  • 7 = dimanche (représenté deux fois pour les deux types de semaine)

Pour chaque valeur numérique (mm, hh, jj, MMM, JJJ) les notations possibles sont :

• * : à chaque unité (0, 1, 2, 3, 4…)
• 5,8 : les unités 5 et 8
• 2-5 : les unités de 2 à 5 (2, 3, 4, 5)
• */3 : toutes les 3 unités (0, 3, 6, 9…)
• 10-20/3 : toutes les 3 unités, entre la dixième et la vingtième (10, 13, 16, 19)

Si, sur la même ligne, le « numéro du jour du mois » et le « jour de la semaine » sont renseignés, alors cron exécutera la tâche quand l'un des champs correspond. Par exemple, la ligne suivante indique que la tâche doit être exécutée les vendredis ainsi que le 13 de chaque mois, à minuit :

0 0 13 * 5 tâche

Description de la syntaxe d'une tâche dans un fichier crontab

Journal des opérations

La tâche est une commande à exécuter. Si cette tâche écrit sur sa sortie standard ou son erreur standard, alors le daemon crond les envoie par courriel à l'utilisateur correspondant (celui indiqué par le sixième paramètre).

Afin d'éviter que ces informations soient transmises par courriel, il est possible de les rediriger dans des fichiers. Par exemple :

mm hh jj MMM JJJ tâche  > fichier-1  2> fichier-2  

• fichier-1 contiendra la sortie standard
• fichier-2 contiendra l'erreur standard

Ou pour accumuler les sorties et erreur standards dans un même fichier nommé journal.txt :

mm hh jj MMM JJJ tâche >> /mon/répertoire/journal.txt 2>&1

Raccourcis

Raccourcis	Description	Équivalent
@reboot	Au démarrage	Aucun
@yearly	Tous les ans	0 0 1 1 *
@annually	Tous les ans	0 0 1 1 *
@monthly	Tous les mois	0 0 1 * *
@weekly	Toutes les semaines	0 0 * * 0
@daily	Tous les jours	0 0 * * *
@midnight	Toutes les nuits	0 0 * * *
@hourly	Toutes les heures	0 * * * *

Exemples

Chacun des exemples enregistre l'espace disque libre (commande df) dans le fichier /tmp/df.log à des horaires différents. Afin de conserver l'historique, ces exemples utilisent la redirection >> qui permet d'ajouter les nouvelles données à la fin du fichier (si celui-ci existe déjà, dans le cas contraire il sera créé).

Tous les jours à 23 h 30 :

 30 23 * * * df >> /tmp/df.log

Toutes les heures, passées de 5 minutes :

 5 * * * * df >> /tmp/df.log

Tous les premiers du mois à 23h30 :

 30 23 1 * * df >> /tmp/df.log

Tous les lundis à 22h28 :

 28 22 * * 1 df >> /tmp/df.log

Tous les vendredis et tous les 13 de n'importe quel mois à 11h22 :

 22 11 13 * 5 df >> /tmp/df.log

Tous les vendredis 13 de n'importe quel mois à 11h22 :

 22 11 13 * * [ `date '+\%w'` -eq 5 ] && df >> /tmp/df.log

Du 2 au 5 de chaque mois à 10h12 :

 12 10 2-5 * * df >> /tmp/df.log

Tous les jours pairs du mois à 23h59 :

 59 23 */2 * * df >> /tmp/df.log

Tous les jours ouvrés à 22 heures :

 0 22 * * 1-5 df >> /tmp/df.log

Toutes les 5 minutes :

 */5 * * * * df >> /tmp/df.log

Tous les derniers jours du mois (la barre oblique inversée devant % est obligatoire en édition de crontab, contrairement à l'exécution manuelle de la commande) :

 0 0 28-31 * * [ `/bin/date +\%d` -gt `/bin/date +\%d -d "1 day"` ] && df >> /tmp/df.log

• Tous les derniers dimanches du mois :
  • Première solution : comparer tous les dimanches avec celui de la semaine d'après.

 0 0 * * 0 [ `/bin/date +\%d` -gt `/bin/date +\%d -d "7 day"` ] && df >> /tmp/df.log

• • Deuxième solution : tester la dernière semaine tous les mois.

 0 0 25-31 1,3,5,7,8,10,12 0 my-script.sh
 0 0 24-30 4,6,9,11 0 my-script.sh
 0 0 22-29 2 0 my-script.sh

• • Troisième solution : lancer un script avec le calendrier.

 0 0 21-31 * * /bin/script.sh

 $ cat /bin/script.sh

$ cat /bin/script.sh
#!/bin/sh

#(Pour les OS où `cal -m` met lundi en position 1)
#dernierdimanche=`cal -m | awk '{print $7}' | tail -1`; #(ERREUR lignes vides si $7="")
#CORRECTIF pour tous les OS
dernierdimanche=`cal -m |awk 'BEGIN{p=7};(NR==2 && $1=="di"){p=1};(NF>=p){di=$p};END{print di};'`;
aujourdhui=`date +%d`

if [ $aujourdhui -eq $dernierdimanche ]
then
df >> /tmp/df.log
else
echo "Nous ne sommes pas encore le dernier dimanche du mois."
fi

• • Quatrième solution, utiliser fcron.

• Tous les premiers dimanches du mois :
  • Première solution : tester tous les dimanches<ref>Modèle:En Cron job -- to execute at every first Sunday of every month</ref> :

0 0 * * 0 [ `date '+\%e'` -le 7 ] && df >> /tmp/df.log

• • Autre solution : le script avec calendrier :

 0 0 1-7 * * /bin/script2.sh

$ cat /bin/script2.sh
#!/bin/sh

#premierdimanche=`cal -m | awk '{print $7}' | head -3 | tail -1`; #(ERREUR si lundi "")
premierdimanche=`cal -m | awk '(NR==3){print $NF}'`; #(CORRECTIF simple, pour lundi en position 1)
aujourdhui=`date +%d`

if [ $aujourdhui -eq $premierdimanche ]
then
df >> /tmp/df.log
else
echo "Nous ne sommes pas encore le premier dimanche du mois."
fi

Horodatage du fichier de sortie

Les exemples ci-dessus utilisent la redirection >> afin de créer un journal sur plusieurs exécutions.

Afin, d'écrire dans des fichiers différents, il est possible d'utiliser la commande date, comme avec l'exemple suivant :

 30 23 * * * df > /tmp/df_`date +\%d_\%m_\%Y_\%H_\%M`.log

(le caractère ` (accent grave, U+0060) est produit par la combinaison des touches [Alt Gr]+[7] sur le clavier AZERTY en France)

Bien entendu, une autre solution est de réaliser l'écriture du fichier dans un script appelle-df.sh :

 #!/bin/sh
 JJ_MM_ANNEE_HH_MM=`date +\%d_\%m_\%Y_\%H_\%M`
 df > /tmp/df_${JJ_MM_ANNEE_HH_MM}.log

Et de remplacer la table cron précédente par :

 30 23 * * * appelle-df.sh

Commandes utiles

Ces commandes ne fonctionnent pas pour toutes les distributions Linux et Unix.

Indique l'horaire de la dernière tâche exécutée pour l'ensemble des utilisateurs :

ls -lut /etc/init.d/cron

Extrait du journal du système les informations concernant la table cron :

grep -w cron /var/log/syslog

Relance le démon cron :

/etc/init.d/cron force-reload