.Id $Id: at.man,v 1.3 1995/08/08 15:24:51 ig25 Exp $
.\" Traduction 16/04/1997 par Christophe Blaess (ccb@club-internet.fr)
.\"
.TH AT 1 "16 Avril 1997" Linux "Manuel de l'utilisateur Linux"
.SH NOM
at, batch, atq, atrm \- Memoriser, examiner ou supprimer des jobs a executer plus tard.
.SH SYNOPSIS
.B at
.RB [ -V ]
.RB [ -q 
.IR fichier ]
.RB [ -f
.IR fichier ]
.RB [ -mldbv ]
.B HEURE
.br
.B "at -c"
.I commande
.RI [ commande... ]
.br
.B atq
.RB [ -V ]
.RB [ -q
.IR fichier ]
.RB [ -v ]
.br
.B atrm
.RB [ -V ]
.I commande
.RI [ commande... ]
.br
.B batch
.RB [ -V ]
.RB [ -q
.IR fichier ]
.RB [ -f
.IR fichier ]
.RB [ -mv ]
.RB [ HEURE ]
.SH DESCRIPTION
.B at
et
.B batch
lisent, depuis l'entree standard, ou depuis un fichier, des commandes
qu'ils executeront ulterieurement, en utilisant 
.BR /bin/sh .
.TP 8
.BR at
lance les commandes indiquees a une heure precise.
.TP 8
.BR atq
affiche la liste des commandes en attente d'execution, sauf si l'appelant
est le Super\-Utilisateur. Dans ce dernier cas, \fBatq\fP affiche la liste
des travaux en attente pour tous les utilisateurs.
.TP 8
.BR atrm
efface les travaux en attente.
.TP 8
.BR batch
execute les commandes indiquees lorsque la charge systeme le permet, c'est a dire lorsque
la charge du processeur, obtenue depuis le fichier
.I /proc/loadavg
descend en dessous de 1,5 par defaut, ou en dessous d'une valeur mentionnee explicitement
durant l'invocation de
.BR atrun .
.PP
.B At
permet d'indiquer l'heure de lancement de maniere assez complexe.

Il accepte des specifications de la forme
.B HHMM
ou
.B HH:MM
pour executer un travail a une heure donnee de la journee en cours (ou
du lendemain si l'heure mentionnee est deja depassee).
On peut aussi lui fournir l'un des arguments suivants :
.BR midnight " (minuit),"
.BR noon " (midi),"
ou
.BR teatime " (l'heure du the, soit 16 heures)."
Il est egalement possible de fournir un suffixe du type
.BR AM " (matin),"
ou
.BR PM " (apres-midi)"
avec une heure sur un cadran de 12 heures.
On peut indiquer le jour de lancement, en precisant une date
du type
.BR nom-du-mois " (en anglais)"
.B jour
et eventuellement
.B annee,
ou encore une date du type
.B MMJJAA
ou
.B MM/JJ/AA
ou
.B JJ.MM.AA.
(NDT : C'est sympa de penser aux gens qui notent le jour avant le mois :-)

On peut indiquer une heure de la forme
.BR now "(maintenant) "
.B \+
.I nombre
.RI "d'" unites ,
ou les unites peuvent etre
.B minutes,
.B hours,
.BR days " (jours),"
ou
.BR weeks " (semaines)"
et on peut egalement demander a
.B at
de declencher le travail le jour meme en ajoutant le suffixe
.B today
ou le lendemain en ajoutant
.B tomorrow.
.PP
Par exemple, pour lancer une commande a 16 heures, 3 jours plus tard,
on peut indiquer
.B at 4pm + 3 days,
pour lancer le travail a 10 heures du matin le 31 Juillet, il faut invoquer
.B at 10am Jul 31
et pour lancer une commande a 1 heure du matin le lendemain, effectuez
.B at 1am tomorrow.
.PP
Aussi bien
.BR at " que " batch 
lisent les commandes a memoriser depuis l'entree standard, ou dans le
fichier indique par l'option
.BR -f .
Le repertoire de travail, l'environnement (sauf pour les variables
.BR TERM ,
.BR DISPLAY
et
.BR _ )
ainsi que le \fImask\fP sont memorises au moment de l'invocation.
Une commande
.BR "at " -
ou
.BR "batch " -
invoquee depuis un shell obtenu par
.B su(1)
memorisera l'U-ID en cours.
L'apppelant recevra par courrier (mail) les messages ecrits sur les flux de
sortie standard et d'erreur standard, s'il y en a.
Le courrier sera envoye en utilisant la commande
.BR /bin/mail .
Si
.B at
est invoquee depuis un shell obtenu par
.BR su(1) ,
le courier sera envoye a l'utilisateur courresondant au login.
.PP
Le Super-Utilisateur peut toujours employer ces commandes. Pour les
autres utilisateurs, les permissions sont determinees
par les fichiers
.I /etc/at.allow
et
.IR /etc/at.deny .
.PP
Si le fichier
.I /etc/at.allow
existe, seuls les utilisateurs dont les noms sont mentionnes dans
ce fichier peuvent utiliser
.BR at .
.PP
Si
.I /etc/at.allow
n'existe pas, \fBat\fP verifie si
.I /etc/at.deny
existe, et tous les utilisateurs non-mentionnes dans ce fichier ont
le droit d'invoquer
.BR at .
.PP
Si aucun de ces deux fichiers n'existe, seul le Super-utilisateur a
le droit d'appeler
.BR at .
.PP
un fichier
.I /etc/at.deny
vide signifie que tous les utilisateurs ont le droit d'appeler ces
commandes, c'est la configuration par defaut.
.SH OPTIONS
.TP 8
.B -V
Afficher un numero de version sur la sortie d'erreur standard.
.TP 8
.BI \-q " file"
Utiliser la \fIfile\fP d'attente mentionnee.
Une file est designee par une simple lettre, dans l'intervalle
.B a
jusqu'a
.BR z ,
et
.B A
jusqu'a
.BR Z .
La file
.B c
est la file d'attente par defaut pour
.B at
tandis que la file
.B E
est celle par defaut pour
.BR batch .
Plus les files ont une lettre importante, plus les travaux seront executes
avec une valeur de gentillesse (voir \fBnice\fP(1)) elevee.
Si un travail est enregistre dans une file avec une lettre majuscule, il
sera traite comme s'il etait soumis a
.BR batch
a l'\fIheure\fP indiquee.
Si l'on invoque
.BR atq
avec un nom de file specifique, il ne montrera que les travaux en attente
dans cette file.
.TP 8
.B \-m
Envoyer un courier a l'utilisateur lorsque le travail est termine, meme
s'il n'a rien ecrit sur ses flux de sortie.
.TP 8
.BI \-f " fichier"
Lire la commande a executer dans le
.BI fichier
et non pas sur l'entree standard.
.TP 8
.B \-l
Est un alias pour
.B atq.
.TP
.B \-d
Est un alias pour
.B atrm.
.TP
.B \-b
Est un alias pour
.B batch.
.TP
.B \-v
Pour
.BR atq ,
afficher les travaux termines mais pas encore effaces de la file. Pour
les autres, afficher les heures de lancement programmees.
.TP
.B
\-c
Imprimer sur la sortie standard les travaux mentionnes sur la ligne de commande.
.SH FICHIERS
.I /var/spool/at
.br
.I /var/spool/at/spool
.br
.I /proc/loadavg
.br
.I /etc/utmp
.br
.I /etc/at.allow
.br
.I /etc/at.deny
.SH "VOIR AUSSI"
cron(1), nice(1), sh(1), umask(2), atrun(8)
.SH BUGS
Sous Linux, 
.B batch
est tributaire d'un systeme de fichiers de type
.I proc
monte sur le repertoire
.IR /proc .
.PP
Si le fichier
.I /etc/utmp
n'est pas disponible, ou est endommage, ou si l'utilisateur n'est pas
connecte lorsque 
.B at
est invoquee, le courrier est envoye a l'U-ID correspondant a la variable
d'environnement
.BR LOGNAME .
Si celle-ci est indefinie ou vide, l'U-ID courant est utilise par defaut.
.PP
.B At
et
.BR batch ,
tels qu'ils sont implementes actuellement, ne sont pas fiables lorsqu'il
y a une situation de manque de ressources systemes. Si c'est regulierement
le cas sur votre site, vous devriez vous orienter vers un autre systeme
de lancements differes, comme
.BR nqs .
.SH AUTEURS
At a ete ecrit principalement par Thomas Koenig, ig25@rz.uni-karlsruhe.de.
Les routines d'analyse des dates et heures sont de David Parsons, orc@pell.chi.il.us.