.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)
.\" MJ 30/07/2003 at-3.1.8
.TH AT 1 "30 juillet 2003" at "Manuel de l'utilisateur Linux"
.SH NOM
at, batch, atq, atrm \- Mmoriser, examiner ou supprimer des jobs  excuter ultrieurement.
.SH SYNOPSIS
.B at
.RB [ -V ]
.RB [ -q 
.IR file ]
.RB [ -f
.IR fichier ]
.RB [ -mldbv ]
.B HEURE
.br
.B "at -c"
.I commande
.RI [ commande... ]
.br
.B atq
.RB [ -V ]
.RB [ -q
.IR file ]
.br
.B atrm
.RB [ -V ]
.I commande
.RI [ commande... ]
.br
.B batch
.RB [ -V ]
.RB [ -q
.IR file ]
.RB [ -f
.IR fichier ]
.RB [ -mv ]
.RB [ HEURE ]
.SH DESCRIPTION
.B at
et
.B batch
lisent, depuis l'entre standard, ou depuis un fichier, des commandes
qu'ils excuteront ultrieurement, en utilisant le shell indiqu dans
la variable d'environnement
.BR SHELL ,
le shell de connexion de l'utilisateur, ou en dernier ressort
.BR /bin/sh .
.TP 8
.BR at
lance les commandes indiques  une heure prcise.
.TP 8
.BR atq
affiche la liste des commandes en attente d'excution pour l'utilisateur
appelant, sauf s'il s'agit du Super\-Utilisateur auquel cas toutes les 
commandes en attente sont listes. Le format de sortie est (une ligne par
job)\ : numro de job, date, heure, classe.
.TP 8
.BR atrm
efface les travaux en attente, identifis par leurs numros de job.
.TP 8
.BR batch
excute les commandes indiques lorsque la charge systme le permet,
c'est  dire lorsque la charge du processeur descend sous 0.8, ou
en dessous d'une valeur mentionne explicitement durant l'invocation de
.BR atrun .
.PP
.B At
permet d'indiquer l'heure de lancement de manire assez complexe, en
extension du standard POSIX.2. Il accepte des spcifications de la forme
.B HH:MM
pour excuter un travail  une heure donne de la journe en cours (ou
du lendemain si l'heure mentionne est dj dpasse).
On peut aussi lui fournir l'un des arguments suivants :
.BR midnight " (minuit),"
.BR noon " (midi),"
ou
.BR teatime " (l'heure du th, soit 16 heures)."
Il est galement possible de fournir un suffixe du type
.BR AM " (matin),"
ou
.BR PM " (aprs-midi)"
avec une heure sur un cadran de 12 heures.
On peut indiquer le jour de lancement, en prcisant une date
du type
.BR nom-du-mois " (en anglais)"
.B jour
et ventuellement
.BR anne ,
ou encore une date du type
.B MMJJAA
ou
.B MM/JJ/AA
ou
.BR JJ.MM.AA .
La date
.I doit
suivre l'heure.
On peut indiquer une heure de la forme
.BR now "(maintenant) "
.B \+
.I nombre
.RI "d'" units ,
o les units peuvent tre
.BR minutes ,
.BR hours ,
.BR days " (jours),"
ou
.BR weeks " (semaines)"
et on peut galement demander 
.B at
de dclencher le travail le jour mme en ajoutant le suffixe
.B today
ou le lendemain en ajoutant
.BR tomorrow .
.PP
Par exemple, pour lancer une commande  16 heures, 3 jours plus tard,
on peut indiquer
.BR "at 4pm + 3 days" ,
pour lancer le travail  10 heures du matin le 31 Juillet, il faut invoquer
.B at 10am Jul 31
et pour lancer une commande  1 heure du matin le lendemain, effectuez
.BR "at 1am tomorrow" .
.PP
.IR /usr/share/doc/at-3.1.8/timespec
contient les dfinitions exactes des spcifications horaires.
.PP
Aussi bien
.BR at " que " batch 
lisent les commandes  mmoriser depuis l'entre standard, ou dans le
fichier indiqu par l'option
.BR -f .
Le rpertoire de travail, l'environnement (sauf pour les variables
.BR TERM ,
.BR DISPLAY
et
.BR _ )
ainsi que le \fIumask\fP sont mmoriss au moment de l'invocation.
Une commande
.BR "at " -
ou
.BR "batch " -
invoque depuis un shell obtenu par
.B su(1)
mmorisera l'U-ID en cours.
L'appelant recevra par courrier (mail) les messages crits sur les flux de
sortie standard et d'erreur standard, s'il y en a.
Le courrier sera envoy en utilisant la commande
.BR /usr/sbin/sendmail .
Si
.B at
est invoque depuis un shell obtenu par
.BR su(1) ,
le courrier sera envoy  l'utilisateur correspondant au login.
.PP
Le Super-Utilisateur peut toujours employer ces commandes. Pour les
autres utilisateurs, les permissions sont dtermines
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 mentionns dans
ce fichier peuvent utiliser
.BR at .
.PP
Si
.I /etc/at.allow
n'existe pas, \fBat\fP vrifie si
.I /etc/at.deny
existe, et tous les utilisateurs non-mentionns 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 dfaut.
.SH OPTIONS
.TP 8
.B -V
Afficher un numro de version sur la sortie d'erreur standard.
.TP 8
.BI \-q " file"
Utiliser la \fIfile\fP d'attente mentionne.
Une file est dsigne par une lettre unique, dans l'intervalle
.B a
jusqu'
.BR z ,
et
.B A
jusqu'
.BR Z .
La file
.B a
est la file d'attente par dfaut pour
.B at
tandis que la file
.B b
est celle par dfaut pour
.BR batch .
Plus les files ont une lettre importante, plus les travaux seront excuts
avec une valeur de gentillesse (voir \fBnice\fP(1)) leve. La file spciale
"=" est rserve pour les jobs en cours d'excution.
.PP
Si un travail est enregistr dans une file avec une lettre majuscule, il
sera transmis 
.BR batch
 l'\fIheure\fP indique.
Si l'on invoque
.BR atq
avec un nom de file spcifique, il ne montrera que les travaux en attente
dans cette file.
.TP 8
.B \-m
Envoyer un courrier  l'utilisateur lorsque le travail est termin, mme
s'il n'a rien crit sur ses flux de sortie.
.TP 8
.BI \-f " fichier"
Lire la commande  excuter dans le
.BI fichier
et non pas sur l'entre standard.
.TP 8
.B \-l
Est un alias pour
.BR atq .
.TP
.B \-d
Est un alias pour
.BR atrm .
.TP
.B \-v
Afficher les heures de lancement programmes.
.P
Les heures seront affiches avec le format "1997-02-20 14:50" sauf si la
variable d'environnement
.B POSIXLY_CORRECT 
est remplie, auquel cas ce sera "Thu Feb 20 14:50:00 1996".
.TP
.B
\-c
Imprimer sur la sortie standard les travaux mentionns sur la ligne de commande.
.SH FICHIERS
.I /var/spool/at
.br
.I /var/spool/at/spool
.br
.I /proc/loadavg
.br
.I /var/run/utmp
.br
.I /etc/at.allow
.br
.I /etc/at.deny
.SH "VOIR AUSSI"
.BR cron (1),
.BR nice (1),
.BR sh (1),
.BR umask (2),
.BR atd (8).
.SH BOGUES
Sous Linux, 
.B batch
est tributaire d'un systme de fichiers de type
.I proc
mont sur le rpertoire
.IR /proc .
.PP
Si le fichier
.I /var/run/utmp
n'est pas disponible, ou est endommag, ou si l'utilisateur n'est pas
connect lorsque 
.B at
est invoque, le courrier est envoy a l'U-ID correspondant  la variable
d'environnement
.BR LOGNAME .
Si celle-ci est indfinie ou vide, l'U-ID courant est utilis par dfaut.
.PP
.B At
et
.BR batch ,
tels qu'ils sont implments actuellement, ne sont pas fiables lorsqu'il
y a une situation de manque de ressources systmes. Si c'est rgulirement
le cas sur votre site, vous devriez vous orienter vers un autre systme
de lancements diffrs, comme
.BR nqs .
.SH AUTEURS
At a t crit principalement par Thomas Koenig, ig25@rz.uni-karlsruhe.de.
.SH TRADUCTION
Christophe Blaess, 1997-2003.