version 1.12, 1999/09/14 05:28:23 |
version 1.13, 2000/03/04 21:12:00 |
|
|
.Op Fl mv |
.Op Fl mv |
.Op Ar time |
.Op Ar time |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm at |
and |
and |
.Nm batch |
.Nm batch |
read commands from standard input or a specified file which |
read commands from standard input or a specified file which |
are to be executed at a later time, using |
are to be executed at a later time, using |
.Xr sh 1 . |
.Xr sh 1 . |
|
.Pp |
|
The related programs are as follows: |
.Bl -tag -width indent |
.Bl -tag -width indent |
.It Nm at |
.It Nm at |
Executes commands at a specified time. |
Executes commands at a specified time. |
.It Nm atq |
.It Nm atq |
Lists the user's pending jobs, unless the user is the superuser. |
Lists the user's pending jobs, unless the user is the super-user. |
In that case, all users' jobs are listed. |
In that case, all users' jobs are listed. |
.It Nm atrm |
.It Nm atrm |
Deletes jobs. |
Deletes jobs. |
|
|
.Nm atrun . |
.Nm atrun . |
.El |
.El |
.Pp |
.Pp |
.Nm |
The options are as follows: |
|
.Bl -tag -width indent |
|
.It Fl V |
|
Prints the version number to standard error. |
|
.It Fl q Ar queue |
|
Uses the specified queue. |
|
A queue designation consists of a single letter. Valid queue designations |
|
range from |
|
.Sy a |
|
to |
|
.Sy z |
|
and |
|
.Sy A |
|
to |
|
.Sy Z . |
|
The |
|
.Sy c |
|
queue is the default for |
|
.Nm at |
|
and the |
|
.Sy E |
|
queue for |
|
.Nm batch . |
|
Queues with higher letters run with increased niceness. |
|
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. |
|
If |
|
.Nm atq |
|
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 |
|
For |
|
.Nm atq , |
|
shows completed but not yet deleted jobs in the queue. Otherwise |
|
shows the time the job will be executed. |
|
.It Fl c |
|
Prints the jobs listed on the command line to standard output. |
|
.El |
|
.Pp |
|
.Nm at |
allows some moderately complex |
allows some moderately complex |
.Ar time |
.Ar time |
specifications. It accepts times of the form |
specifications. It accepts times of the form |
|
|
to run a job at a specific time of day. |
to run a job at a specific time of day. |
(If that time is already past, the next day is assumed.) |
(If that time is already past, the next day is assumed.) |
You may also specify |
You may also specify |
.Nm midnight , |
.Sy midnight , |
.Nm noon , |
.Sy noon , |
or |
or |
.Nm teatime |
.Sy teatime |
(4pm) |
(4pm) |
and you can have a time-of-day suffixed with |
and you can have a time-of-day suffixed with |
.Nm AM |
.Dq AM |
or |
or |
.Nm PM |
.Dq PM |
for running in the morning or the evening. |
for running in the morning or the evening. |
You can also say what day the job will be run, |
You can also say what day the job will be run, |
by giving a date in the form |
by giving a date in the form |
|
|
.Ar MM/DD/YY |
.Ar MM/DD/YY |
or |
or |
.Ar DD.MM.YY . |
.Ar DD.MM.YY . |
The year may be given as two digits or four digits. |
.Pp |
|
The year may be given as two or four digits. |
If the year is given as two digits, it is taken to occur as soon as |
If the year is given as two digits, it is taken to occur as soon as |
possible in the future, which may be in the next century -- |
possible in the future, which may be in the next century -- |
unless it's last year, in which case it's considered to be |
unless it's last year, in which case it's considered to be |
a typo. |
a typo. |
|
.Pp |
The specification of a date must follow the specification of |
The specification of a date must follow the specification of |
the time of day. |
the time of day. |
You can also give times like |
You can also give times like |
.Op Nm now |
.Op Sq now |
.Nm + Ar count \%time-units , |
.Sy + Ar count \%time-units , |
where the time-units can be |
where the time-units can be |
.Nm minutes , |
.Sy minutes , |
.Nm hours , |
.Sy hours , |
.Nm days , |
.Sy days , |
or |
or |
.Nm weeks |
.Sy weeks |
and you can tell |
and you can tell |
.Nm |
.Nm at |
to run the job today by suffixing the time with |
to run the job today by suffixing the time with |
.Nm today |
.Sy today |
and to run the job tomorrow by suffixing the time with |
and to run the job tomorrow by suffixing the time with |
.Nm tomorrow . |
.Sy tomorrow . |
.Pp |
.Pp |
For example, to run a job at 4pm three days from now, you would do |
For example, to run a job at 4pm three days from now, you would do |
.Nm at 4pm + 3 days . |
.Ic at 4pm + 3 days . |
To run a job at 10:00am on July 31, you would do |
To run a job at 10:00am on July 31, you would do |
.Nm at 10am Jul 31 . |
.Ic at 10am Jul 31 . |
To run a job at 1am tomorrow, you would do |
To run a job at 1am tomorrow, you would do |
.Nm at 1am tomorrow . |
.Ic at 1am tomorrow . |
.Pp |
.Pp |
For both |
For both |
.Nm |
.Nm at |
and |
and |
.Nm batch , |
.Nm batch , |
commands are read from standard input or the file specified |
commands are read from standard input or the file specified |
|
|
.Ev TERMCAP , |
.Ev TERMCAP , |
.Ev DISPLAY , |
.Ev DISPLAY , |
and |
and |
.Ev _ ) |
.Ev _ ) , |
and the |
and the |
.Ar umask |
.Ar umask |
are retained from the time of invocation. |
are retained from the time of invocation. |
An |
An |
.Nm |
.Nm at |
or |
or |
.Nm batch |
.Nm batch |
command invoked from a |
command invoked from a |
|
|
commands, if any. Mail will be sent using the command |
commands, if any. Mail will be sent using the command |
.Xr sendmail 8 . |
.Xr sendmail 8 . |
If |
If |
.Nm |
.Nm at |
is executed from a |
is executed from a |
.Xr su 1 |
.Xr su 1 |
shell, the owner of the login shell will receive the mail. |
shell, the owner of the login shell will receive the mail. |
.Pp |
.Pp |
The superuser may use these commands in any case. |
The super-user may use these commands in any case. |
For other users, permission to use at is determined by the files |
For other users, permission to use at is determined by the files |
.Pa /var/at/at.allow |
.Pa /var/at/at.allow |
and |
and |
|
|
.Pa /var/at/at.allow |
.Pa /var/at/at.allow |
exists, only usernames mentioned in it are allowed to use |
exists, only usernames mentioned in it are allowed to use |
.Nm at . |
.Nm at . |
.Pp |
|
If |
If |
.Pa /var/at/at.allow |
.Pa /var/at/at.allow |
does not exist, |
does not exist, |
|
|
is checked. Every username not mentioned in it is then allowed |
is checked. Every username not mentioned in it is then allowed |
to use |
to use |
.Nm at . |
.Nm at . |
.Pp |
If neither exists, only the super-user is allowed use of |
If neither exists, only the superuser is allowed use of |
|
.Nm at . |
.Nm at . |
.Pp |
.Pp |
An empty |
An empty |
.Pa /var/at/at.deny |
.Pa /var/at/at.deny |
means that every user is allowed use these commands. |
means that every user is allowed use these commands. |
This is the default configuration. |
This is the default configuration. |
.Sh OPTIONS |
.Pp |
.Bl -tag -width indent |
|
.It Fl V |
|
Prints the version number to standard error. |
|
.It Fl q Ar queue |
|
Uses the specified queue. |
|
A queue designation consists of a single letter. Valid queue designations |
|
range from |
|
.Nm a |
|
to |
|
.Nm z |
|
and |
|
.Nm A |
|
to |
|
.Nm Z . |
|
The |
|
.Nm c |
|
queue is the default for |
|
.Nm |
|
and the |
|
.Nm E |
|
queue for |
|
.Nm batch . |
|
Queues with higher letters run with increased niceness. |
|
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. |
|
If |
|
.Nm atq |
|
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 |
|
Is an alias for |
|
.Nm atq . |
|
.It Fl d |
|
Is an alias for |
|
.Nm atrm . |
|
.It Fl b |
|
Is an alias for |
|
.Nm batch . |
|
.It Fl v |
|
For |
|
.Nm atq , |
|
shows completed but not yet deleted jobs in the queue. Otherwise |
|
shows the time the job will be executed. |
|
.It Fl c |
|
Prints the jobs listed on the command line to standard output. |
|
.Sh FILES |
.Sh FILES |
.Bl -tag -width /var/at/.lockfile -compact |
.Bl -tag -width /var/at/.lockfile -compact |
.It Pa /var/at/jobs |
.It Pa /var/at/jobs |
|
|
.Xr atrun 8 , |
.Xr atrun 8 , |
.Xr cron 8 , |
.Xr cron 8 , |
.Xr sendmail 8 |
.Xr sendmail 8 |
.El |
|
.Sh BUGS |
.Sh BUGS |
If the file |
If the file |
.Pa /var/run/utmp |
.Pa /var/run/utmp |
is not available or corrupted, or if the user is not logged on at the |
is not available or corrupted, or if the user is not logged on at the |
time |
time |
.Nm |
.Nm at |
is invoked, the mail is sent to the user ID found |
is invoked, the mail is sent to the user ID found |
in the environment variable |
in the environment variable |
.Ev LOGNAME . |
.Ev LOGNAME . |
If that is undefined or empty, the current user ID is assumed. |
If that is undefined or empty, the current user ID is assumed. |
.Pp |
.Pp |
.Nm |
.Nm at |
and |
and |
.Nm batch |
.Nm batch |
as presently implemented are not suitable when users are competing for |
as presently implemented are not suitable when users are competing for |
|
|
only permits submission of jobs in the future, it is somewhat |
only permits submission of jobs in the future, it is somewhat |
clear which century the job will run in. |
clear which century the job will run in. |
.Sh AUTHORS |
.Sh AUTHORS |
.Nm |
.Nm at |
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>. |