version 1.20, 2002/05/11 21:56:54 |
version 1.21, 2002/05/11 22:14:48 |
|
|
.Nd queue, examine or delete jobs for later execution |
.Nd queue, examine or delete jobs for later execution |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm at |
.Nm at |
.Op Fl q Ar queue |
.Op Fl bdlmv |
.Op Fl f Ar file |
.Op Fl f Ar file |
.Op Fl mldbv |
.Op Fl q Ar queue |
.Ar time |
.Ar time |
.Nm at |
.Nm at |
.Fl c Ar job Op Ar job ... |
.Fl c Ar job Op Ar job ... |
|
|
.Ar job |
.Ar job |
.Op Ar job ... |
.Op Ar job ... |
.Nm batch |
.Nm batch |
.Op Fl q Ar queue |
|
.Op Fl f Ar file |
|
.Op Fl mv |
.Op Fl mv |
|
.Op Fl f Ar file |
|
.Op Fl q Ar queue |
.Op Ar time |
.Op Ar time |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm at |
.Nm at |
|
|
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width indent |
.Bl -tag -width indent |
|
.It Fl b |
|
An alias for |
|
.Nm batch . |
|
.It Fl c |
|
Prints the jobs listed on the command line to standard output. |
|
.It Fl d |
|
An alias for |
|
.Nm atrm . |
|
.It Fl f Ar file |
|
Reads the job from |
|
.Ar file |
|
rather than standard input. |
|
.It Fl l |
|
An alias for |
|
.Nm atq . |
|
.It Fl m |
|
Send mail to the user when the job has completed, even if there was no |
|
output. |
.It Fl q Ar queue |
.It Fl q Ar queue |
Uses the specified queue. |
Uses the specified queue. |
A queue designation consists of a single letter. |
A queue designation consists of a single letter. |
|
|
If |
If |
.Nm atq |
.Nm atq |
is given a specific queue, it will only show jobs pending in that queue. |
is given a specific queue, it will only show jobs pending in that queue. |
.It Fl m |
|
Send mail to the user when the job has completed, even if there was no |
|
output. |
|
.It Fl f Ar file |
|
Reads the job from |
|
.Ar file |
|
rather than standard input. |
|
.It Fl l |
|
An alias for |
|
.Nm atq . |
|
.It Fl d |
|
An alias for |
|
.Nm atrm . |
|
.It Fl b |
|
An alias for |
|
.Nm batch . |
|
.It Fl v |
.It Fl v |
For |
For |
.Nm atq , |
.Nm atq , |
shows completed but not yet deleted jobs in the queue. |
shows completed but not yet deleted jobs in the queue. |
Otherwise shows the time the job will be executed. |
Otherwise shows the time the job will be executed. |
.It Fl c |
|
Prints the jobs listed on the command line to standard output. |
|
.El |
.El |
.Pp |
.Pp |
.Nm at |
.Nm at |
|
|
directory containing job files |
directory containing job files |
.It Pa /var/at/spool |
.It Pa /var/at/spool |
directory containing output spool files |
directory containing output spool files |
.It Pa /var/run/utmp |
|
login records |
|
.It Pa /var/at/at.allow |
.It Pa /var/at/at.allow |
allow permission control |
allow permission control |
.It Pa /var/at/at.deny |
.It Pa /var/at/at.deny |
|
|
was mostly written by Thomas Koenig <ig25@rz.uni-karlsruhe.de>. |
was mostly written by Thomas Koenig <ig25@rz.uni-karlsruhe.de>. |
The time parsing routines are by David Parsons <orc@pell.chi.il.us>. |
The time parsing routines are by David Parsons <orc@pell.chi.il.us>. |
.Sh BUGS |
.Sh BUGS |
If the file |
|
.Pa /var/run/utmp |
|
is not available or corrupted, or if the user is not logged on at the |
|
time |
|
.Nm at |
|
is invoked, the mail is sent to the user ID found |
|
in the environment variable |
|
.Ev LOGNAME . |
|
If that is undefined or empty, the current user ID is assumed. |
|
.Pp |
|
.Nm at |
.Nm at |
and |
and |
.Nm batch |
.Nm batch |