src/usr.bin/at/at.1 - diff

Return to at.1 CVS log

Up to [local] / src / usr.bin / at

Diff for /src/usr.bin/at/at.1 between version 1.6 and 1.7

version 1.6, 1998/06/05 00:47:46

version 1.7, 1998/09/23 04:32:34

Line 1

.\" $OpenBSD$

.\" $FreeBSD: at.man,v 1.6 1997/02/22 19:54:05 peter Exp $

.Dd April 12, 1995

.Dt "AT" 1

.Dt AT 1

.Os

.Sh NAME

.Nm at, batch, atq, atrm

.Nm at, atq, atrm, batch

.Nd queue, examine or delete jobs for later execution

.Sh SYNOPSIS

.Nm at

Line 13

.Op Fl f Ar file

.Op Fl mldbv

.Ar time

.Pp

.Nm at

.Op Fl V

.Fl c Ar job Op Ar job ...

.Pp

.Nm atq

.Op Fl V

.Op Fl q Ar queue

.Op Fl v

.Pp

.Nm atrm

.Op Fl V

.Ar job

.Op Ar job ...

.Pp

.Nm batch

.Op Fl V

.Op Fl q Ar queue

Line 35

Line 31

.Op Fl mv

.Op Ar time

.Sh DESCRIPTION

.Nm At

.Nm at

and

.Nm batch

read commands from standard input or a specified file which

Line 46

Line 42

Executes commands at a specified time.

.It Nm atq

Lists the user's pending jobs, unless the user is the superuser.

In that case, everybody's jobs are listed.

In that case, all users' jobs are listed.

.It Nm atrm

Deletes jobs.

.It Nm batch

Line 55

Line 51

.Nm atrun .

.El

.Pp

.Nm At

.Nm at

allows some moderately complex

.Ar time

specifications. It accepts times of the form

Line 81

Line 77

with an optional

.Ar year ,

or giving a date of the form

.Ar MMDDYY

.Ar MMDDYY ,

.Ar MM/DD/YY

.Ar DD.MM.YY .

Line 105

Line 100

.Nm tomorrow.

.Pp

For example, to run a job at 4pm three days from now, you would do

.Nm at 4pm + 3 days ,

.Nm 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

.Nm at 10am Jul 31 .

and to run a job at 1am tomorrow, you would do

To run a job at 1am tomorrow, you would do

.Nm at 1am tomorrow.

.Pp

For both

Line 120

Line 115

.Fl f

option and executed.

The working directory, the environment (except for the variables

.Nm TERM ,

.Ev TERM ,

.Nm TERMCAP ,

.Ev TERMCAP ,

.Nm DISPLAY

.Ev DISPLAY ,

and

.Nm _ )

.Ev _ )

and the

.Ar umask

are retained from the time of invocation.

Line 134

Line 129

.Nm batch

command invoked from a

.Xr su 1

shell will retain the current userid.

shell will retain the current user ID.

The user will be mailed standard error and standard output from his

commands, if any. Mail will be sent using the command

.Xr sendmail 8 .

Line 159

Line 154

.Pa /var/at/at.allow

does not exist,

.Pa /var/at/at.deny

is checked, every username not mentioned in it is then allowed

is checked. Every username not mentioned in it is then allowed

to use

.Nm at .

.Pp

Line 200

Line 195

.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

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

Line 208

Line 203

rather than standard input.

.It Fl l

Is an alias for

.Nm atq.

.Nm atq .

.It Fl d

Is an alias for

.Nm atrm.

.Nm atrm .

.It Fl b

Is an alias for

.Nm batch.

.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

Cats the jobs listed on the command line to standard output.

Prints the jobs listed on the command line to standard output.

.Sh FILES

.Bl -tag -width /var/at/.lockfile -compact

.It Pa /var/at/jobs

Directory containing job files

directory containing job files

.It Pa /var/at/spool

Directory containing output spool files

directory containing output spool files

.It Pa /var/run/utmp

.It Pa /var/at/at.allow

Allow permission control

allow permission control

.It Pa /var/at/at.deny

Deny permission control

deny permission control

.It Pa /var/at/.lockfile

Job-creation lock file.

job-creation lock file

.Sh SEE ALSO

.Xr cron 8 ,

.Xr nice 1 ,

.Xr umask 2 ,

.Xr sh 1 ,

.Xr sendmail 8 ,

.Xr umask 2 ,

.Xr atrun 8 .

.Xr atrun 8 ,

.Xr cron 8 ,

.Xr sendmail 8

.El

.Sh BUGS

.Pp

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 userid found

is invoked, the mail is sent to the user ID found

in the environment variable

.Nm LOGNAME .

.Ev LOGNAME .

If that is undefined or empty, the current userid is assumed.

If that is undefined or empty, the current user ID is assumed.

.Pp

.Nm At

.Nm at

and

.Nm batch

as presently implemented are not suitable when users are competing for

Line 265

Line 259

batch system, such as

.Nm nqs .

.Sh AUTHORS

At was mostly written by Thomas Koenig <ig25@rz.uni-karlsruhe.de>.

.Nm at

was mostly written by Thomas Koenig <ig25@rz.uni-karlsruhe.de>.

The time parsing routines are by David Parsons <orc@pell.chi.il.us>.