version 1.24, 2002/05/13 18:43:53 |
version 1.25, 2002/05/14 18:05:39 |
|
|
.\" $OpenBSD$ |
.\" $OpenBSD$ |
.\" $FreeBSD: at.man,v 1.6 1997/02/22 19:54:05 peter Exp $ |
.\" $FreeBSD: at.man,v 1.6 1997/02/22 19:54:05 peter Exp $ |
.Dd April 12, 1995 |
.Dd May 13, 2002 |
.Dt AT 1 |
.Dt AT 1 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm at , |
.Nm at , |
.Nm atq , |
|
.Nm atrm , |
|
.Nm batch |
.Nm batch |
.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 blmrv |
.Op Fl blmr |
.Op Fl f Ar file |
.Op Fl f Ar file |
.Op Fl q Ar queue |
.Op Fl q Ar queue |
.Fl t Ar time_arg |
.Fl t Ar time_arg |
.Nm at |
.Nm at |
.Op Fl blmrv |
.Op Fl blmr |
.Op Fl f Ar file |
.Op Fl f Ar file |
.Op Fl q Ar queue |
.Op Fl q Ar queue |
.Ar timespec |
.Ar timespec |
.Nm at |
.Nm at |
.Fl c Ar job Op Ar job ... |
.Fl c Ar job Op Ar job ... |
.Nm atq |
|
.Op Fl q Ar queue |
|
.Op Fl v |
|
.Nm atrm |
|
.Ar job |
|
.Op Ar job ... |
|
.Nm batch |
.Nm batch |
.Op Fl mv |
.Op Fl m |
.Op Fl f Ar file |
.Op Fl f Ar file |
.Op Fl q Ar queue |
.Op Fl q Ar queue |
.Op Ar timespec |
.Op Ar timespec |
|
|
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Nm at |
.It Nm at |
Executes commands at a specified time. |
Executes commands at a specified time. |
.It Nm atq |
|
Lists the user's pending jobs, unless the user is the superuser. |
|
In that case, all users' jobs are listed. |
|
.It Nm atrm |
|
Deletes jobs. |
|
.It Nm batch |
.It Nm batch |
Executes commands when system load levels permit. |
Executes commands when system load levels permit. |
In other words, when |
In other words, when |
|
|
.Ar file |
.Ar file |
rather than standard input. |
rather than standard input. |
.It Fl l |
.It Fl l |
An alias for |
Lists the user's pending jobs, unless the user is the superuser. |
.Nm atq . |
In that case, all users' jobs are listed. |
|
.\" XXX - should document that user names may be specified (like atq) |
.It Fl m |
.It Fl m |
Send mail to the user when the job has completed, even if there was no |
Send mail to the user when the job has completed, even if there was no |
output. |
output. |
|
|
Queues with higher letters run with increased niceness. |
Queues with higher letters run with increased niceness. |
If a job is submitted to a queue designated with an uppercase letter, it |
If a job is submitted to a queue designated with an uppercase letter, it |
is treated as if it had been submitted to batch at that time. |
is treated as if it had been submitted to batch at that time. |
If |
If the user specified the |
.Nm atq |
.Fl l |
is given a specific queue, it will only show jobs pending in that queue. |
option and |
|
.Nm at |
|
is given a specific queue, only jobs pending in that queue will be shown. |
.It Fl r |
.It Fl r |
An alias for |
Remove the specified job(s) from the |
.Nm atrm . |
.Nm at |
|
queue. |
.It Fl t Ar time_arg |
.It Fl t Ar time_arg |
Specify the job time using the format specified by |
Specify the job time using the format specified by |
.Xr touch 1 . |
.Xr touch 1 . |
|
|
.Ar SS |
.Ar SS |
letter pair is not specified, the value defaults to 0. |
letter pair is not specified, the value defaults to 0. |
.It Fl v |
.It Fl v |
For |
When used in conjuction with the |
.Nm atq , |
.Fl l |
shows completed but not yet deleted jobs in the queue. |
option, shows completed but not yet deleted jobs in the queue. |
Otherwise shows the time the job will be executed. |
|
.El |
.El |
.Pp |
.Pp |
.Nm at |
.Nm at |