====== CRONTAB ======
  * Objet : Lancer une tache automatiquement à l'aide de cron
  * Niveau requis :{{tag>avisé}}
  * Commentaires : //Fonctionnement et syntaxe//
  * Suivi : {{tag>}}
    * Création par [[user>smolki]] le 13/05/2010
    * Testé par [[user>Kao]] le 06/03/2014 
  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?id=2575 | ici]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))





===== Le service cron =====

{{/file-R8f8dee23a289f272b42ba50abbb33892.png}}

  * Il est chargé de faire exécuter par le système toutes tâches (commandes et scripts) définies et planifiées à l'avance (cron vient de chronos, le dieu du temps !)
  * Ces tâches, allant de la simple commande aux scripts complexes, peuvent ainsi être exécutées à heure fixe et même de façon périodique, et font l'objet de messages de compte-rendu.
  * La commande /usr/bin/crontab permet cette programmation. Son usage est en principe réservé à root. On peut toutefois autoriser certains utilisateurs. Pour cela on en dresse la liste sur des lignes successives dans le fichier ''/etc/crond.allow'', et de façon symétrique, on peut mettre dans ''/etc/crond.deny'' la liste des utilisateurs non autorisés.

Exemple : seuls jean et toto ont la permission d'utiliser le service crontab
<code user>cat /etc/crond.allow</code>
<file crontab /etc/crond.allow>
jean
toto</file>

===== Fonctionnement =====

Le processus crond est normalement lancé au démarrage.

On peut le lancer ou l'arrêter avec :
<code root>systemctl stop cron</code>

<code root>systemctl start cron</code>

Il lit toutes les minutes les fichiers présents dans le répertoire ''/var/spool/cron'' ainsi que le fichier ''/etc/crontab'', pour voir si des tâches doivent être exécutées. \\
Chaque action de crond ajoute une ligne de message dans le fichier ''/var/log/cron'', qu'il faut purger de temps en temps ... par une commande crontab ! \\
Par défaut si une commande produit un affichage, il est dirigé vers la messagerie.

===== Commande crontab =====

''[-u user] {-l | -r | -e }''

==== Options : ====

<code user>crontab -l</code>
affiche le fichier crontab de l'utilisateur
<note warning><code user>crontab -r</code>
efface ce fichier ; attention aucune demande de confirmation</note>

<code user>crontab -l -u jean</code>
root examine le fichier crontab de l'user jean

<code user>crontab -e</code>
crée ou édite (pour modification) un fichier temporaire dans ''/tmp'' ouvert dans votre éditeur en ligne de commande par défaut.

Lors de la sauvegarde, le fichier est écrit dans ''/var/spool/cron/$USER'', où ''$USER'' est le nom de login de l'utilisateur.

<note>Sur Stretch, les crontab des user sont dans ''/var/spool/cron/crontabs'' à lister en root</note>

<note>Pour éditer ce fichier avec votre éditeur préféré, par exemple vim, il faut éditer la variable EDITOR, à mettre cette ligne dans votre //shell// tel que bashrc, zshrc etc.
<code user>export EDITOR=/usr/bin/vim</code></note>
===== Syntaxe des lignes des tables crontab =====

Chaque ligne du fichier contient 6 champs.

Les 5 premières déterminent, indiqués par une étoile, les moments d'exécution de la tâche décrite au 6ème champ.

les 5 premiers, indiqués par des étoiles (*) séparées par des espaces,  sont appelés ''champs temporels'', décrivent la périodicité :
  - minutes (0-59),
  - heures (0-23),
  - jour du mois (1-31),
  - mois de l'année (1-12),
  - jour de la semaine (0-6, 0= dimanche)
  - l'espace finale est libre car destiné soit à la //rédaction ...// de la commande , soit au // /chemin/.../ // du script à exécuter.

Un champ temporel peut contenir :
  - une valeur précise et valide pour le champ (par exemple 15 sur le champ minute)
  - une liste de valeurs valides, séparées par des virgules (1,3,5 dans le champ mois : janvier, mars, mai)
  - un intervalle valide (1-5 dans le champ jour : du lundi au vendredi)
  - * pour signifier toutes les valeurs possibles du champ (* dans le champ minute : toutes les minutes)
  - */5 (dans le champ minutes : tous les 5 minutes), 0-23/3 (dans le champ heures : toutes les 3 heures) 

==== Exemples ====

Exécution chaque 1er et 15 de chaque mois à minuit :
<file actionscrip crontab>0 0 1,15 * * <commande></file>

Provoquer un reboot la machine chaque 1er et 15 du mois à 2h 30 du matin :
<file actionscript crontab>30 2  1,15 * * /sbin/shutdown -r</file>

Appeler un script de sauvegarde tous les lundis a 3 h 15 du matin :
<file actionscript crontab>15  3  *  * 1 /usr/bin/backup</file>

Appeler un script de sauvegarde tous les mardis à 3 h du matin :
<file actionscript crontab>0  3  *  * 2 /usr/bin/backup</file>
Si on laisse l'étoile des minutes, : ''*  3  *  * 1'' le script va se lancer toutes les minutes de l'heure 3... \\
Merci à l'amicale vigilance du **captnfab**, le Zorro des redresseur d'erreurs du wiki qui m'a indiqué cela ! 8-)

Exécution toutes les 15 minutes de la <commande> :
<file actionscript crontab>*/15 * * * *  <commande></file>

Exécution toutes les heures passées 15 minutes :
<file actionscript crontab>15 * * * * <commande></file>

Exécution tous les matins du lundi au vendredi à 7 h 30 :
<file actionscript crontab>30 7 * * 1-5 <commande></file>

Exécution tous les quarts d'heure de 15h à 19h du lundi au vendredi  seulement en 1ère quinzaine du troisième trimestre :
<file actionscript crontab>0,15,30,45  15-19  1-15  7-9  1-5 <commande></file>
      
Trouver puis nettoyer le répertoire /tmp des vieux fichiers (non modifiés depuis 31 jours) tous les 1er jour de chaque mois, à 2 heures du matin :
<file actionscript crontab>0 2 1 * * find /tmp -atime 31 -exec rm -f {} \;</file>

Faire apparaitre un message dans la GUI d'un utilisateur à une heure précice
<file actionscript crontab>50 18 * * * export DISPLAY=localhost:0.0; xhost + | zenity --info --text="Reboot de l'ordinateur dans 10min, penser à faire vos sauvegardes"</file>

===== Liens vers le forum df =====

  * [[https://debian-facile.org/viewtopic.php?id=14414|Crontab - lancer une tache une seule fois]]

===== Liens: =====

  *Article Wikipedia avec de nombreux exemples (fr) http://fr.wikipedia.org/wiki/Crontab