diff options
Diffstat (limited to 'usr.bin/at/at.1')
-rw-r--r-- | usr.bin/at/at.1 | 339 |
1 files changed, 0 insertions, 339 deletions
diff --git a/usr.bin/at/at.1 b/usr.bin/at/at.1 deleted file mode 100644 index cdd97e1..0000000 --- a/usr.bin/at/at.1 +++ /dev/null @@ -1,339 +0,0 @@ -.\" $NetBSD: at.1,v 1.29 2016/11/18 12:16:48 abhinav Exp $ -.\" $OpenBSD: at.1,v 1.6 1998/06/05 00:47:46 deraadt Exp $ -.\" $FreeBSD: at.man,v 1.6 1997/02/22 19:54:05 peter Exp $ -.Dd March 10, 2008 -.Dt AT 1 -.Os -.Sh NAME -.Nm at , -.Nm batch , -.Nm atq , -.Nm atrm -.Nd queue, examine or delete jobs for later execution -.Sh SYNOPSIS -.Nm at -.Op Fl bdlmrVv -.Op Fl f Ar file -.Op Fl q Ar queue -.Fl t Ar [[CC]YY]MMDDhhmm[.SS] -.Nm -.Op Fl bdlmrVv -.Op Fl f Ar file -.Op Fl q Ar queue -.Ar time -.Nm -.Op Fl V -.Fl c Ar job Op Ar job ... -.Nm atq -.Op Fl Vv -.Op Fl q Ar queue -.Nm atrm -.Op Fl V -.Ar job -.Op Ar job ... -.Nm batch -.Op Fl mVv -.Op Fl f Ar file -.Op Fl q Ar queue -.Op Fl t Ar [[CC]YY]MMDDhhmm[.SS] -.Nm batch -.Op Fl mVv -.Op Fl f Ar file -.Op Fl q Ar queue -.Op Ar time -.Sh DESCRIPTION -.Nm -and -.Nm batch -read commands from standard input or a specified file which -are to be executed at a later time, using -.Xr sh 1 . -.Bl -tag -width indent -.It Nm at -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. -.It Nm atrm -Deletes jobs. -.It Nm batch -Executes commands when system load levels permit. -In other words, when -the load average drops below 1.5, or the value specified in the invocation of -.Xr atrun 8 . -.El -.Pp -.Nm -allows some moderately complex -.Ar time -specifications. -It accepts times of the form -.Ar HHMM -or -.Ar HH:MM -to run a job at a specific time of day. -(If that time is already past, the next day is assumed.) -You may also specify -.Sq midnight , -.Sq noon , -or -.Sq teatime -(4pm) -and you can have a time-of-day suffixed with -.Sq AM -or -.Sq PM -for running in the morning or the evening. -You can also say what day the job will be run, -by giving a date in the form -.Ar %month-name day -with an optional -.Ar year , -or giving a date of the form -.Ar MMDDYY -or -.Ar MM/DD/YY -or -.Ar DD.MM.YY . -The specification of a date must follow the specification of -the time of day. -You can also give times like -.Op Nm now -or -.Op Nm now -.Sq + Ar count %time-units , -where the time-units can be -.Sq minutes , -.Sq hours , -.Sq days , -.Sq weeks , -.Sq months , -or -.Sq years -and you can tell -.Nm -to run the job today by suffixing the time with -.Sq today -and to run the job tomorrow by suffixing the time with -.Sq tomorrow . -.Pp -For example, to run a job at 4pm three days from now, you would do -.Dl at 4pm + 3 days , -to run a job at 10:00am on July 31, you would do -.Dl at 10am Jul 31 -and to run a job at 1am tomorrow, you would do -.Dl at 1am tomorrow . -.Pp -Alternatively the time may be specified in a language-neutral fashion -by using the -.Fl t -options. -.Pp -For both -.Nm -and -.Nm batch , -commands are read from standard input or the file specified -with the -.Fl f -option and executed. -The working directory, the environment (except for the variables -.Ev TERM , -.Ev TERMCAP , -.Ev DISPLAY -and -.Ev _ ) -and the -.Ar umask -are retained from the time of invocation. -An -.Nm -or -.Nm batch -command invoked from a -.Xr su 1 -shell will retain the current userid. -The user will be mailed standard error and standard output from his -commands, if any. -Mail will be sent using the command -.Xr sendmail 1 . -If -.Nm -is executed from a -.Xr su 1 -shell, the owner of the login shell will receive the mail. -.Pp -The superuser may use these commands in any case. -For other users, permission to use -.Nm at -is determined by the files -.Pa /var/at/at.allow -and -.Pa /var/at/at.deny . -.Pp -If the file -.Pa /var/at/at.allow -exists, only usernames mentioned in it are allowed to use -.Nm . -.Pp -If -.Pa /var/at/at.allow -does not exist, -.Pa /var/at/at.deny -is checked; every username not mentioned in it is then allowed -to use -.Nm . -.Pp -If neither exists, only the superuser is allowed use of -.Nm . -.Pp -An empty -.Pa /var/at/at.deny -means that every user is allowed use these commands. -This is the default configuration. -.Sh OPTIONS -.Bl -tag -offset indent -width XqXqueueXX -.It Fl b -Is an alias for -.Nm batch . -.It Fl c -Cats the jobs listed on the command line to standard output. -.It Fl d -Is an alias for -.Nm atrm . -.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 m -Send mail to the user when the job has completed even if there was no -output. -.It Fl q Ar queue -Uses the specified queue. -A queue designation consists of a single letter. -Valid queue designations -range from -.Sq a -to -.Sq z -and -.Sq A -to -.Sq Z . -The -.Sq c -queue is the default for -.Nm -and the -.Sq 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 r -Is an alias for -.Nm atrm . -.It Fl t -For both -.Nm -and -.Nm batch , -the time may be specified in a language-neutral format consisting of: -.Bl -tag -width Ds -compact -offset indent -.It Ar CC -The first two digits of the year (the century). -.It Ar YY -The second two digits of the year. -If -.Ar YY -is specified, but -.Ar CC -is not, a value for -.Ar YY -between 69 and 99 results in a -.Ar CC -value of 19. -Otherwise, a -.Ar CC -value of 20 is used. -.It Ar MM -The month of the year, from 01 to 12. -.It Ar \&DD -The day of the month, from 01 to 31. -.It Ar hh -The hour of the day, from 00 to 23. -.It Ar mm -The minute of the hour, from 00 to 59. -.It Ar \&SS -The second of the minute, from 00 to 61. -.El -.It Fl V -Prints the version number to standard error. -.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. -.El -.Sh FILES -.Bl -tag -width /var/at/.lockfile -compact -.It Pa /var/at/jobs -Directory containing job files -.It Pa /var/at/spool -Directory containing output spool files -.It Pa /var/run/utmp -Login records -.It Pa /var/at/at.allow -Allow permission control -.It Pa /var/at/at.deny -Deny permission control -.It Pa /var/at/.lockfile -Job-creation lock file. -.El -.Sh SEE ALSO -.Xr nice 1 , -.Xr sendmail 1 , -.Xr sh 1 , -.Xr umask 2 , -.Xr atrun 8 , -.Xr cron 8 -.Sh STANDARDS -The -.Nm -and -.Nm batch -utilities conform to -.St -p1003.2-92 . -.Sh AUTHORS -.An -nosplit -.Nm -was mostly written by -.An Thomas Koenig Aq Mt ig25@rz.uni-karlsruhe.de . -The time parsing routines are implemented by -.An David Parsons Aq Mt orc@pell.chi.il.us . -.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 -is invoked, the mail is sent to the userid found -in the environment variable -.Ev LOGNAME . -If that is undefined or empty, the current userid is assumed. -.Pp -.Nm -and -.Nm batch -as presently implemented are not suitable when users are competing for -resources. -If this is the case for your site, you might want to consider another -batch system, such as -.Ic nqs . |