diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/at.1')
-rw-r--r-- | upstream/opensuse-leap-15-6/man1/at.1 | 327 |
1 files changed, 327 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/at.1 b/upstream/opensuse-leap-15-6/man1/at.1 new file mode 100644 index 00000000..b42eaf34 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/at.1 @@ -0,0 +1,327 @@ +.TH AT 1 2009-11-14 +.SH NAME +at, batch, atq, atrm \- queue, examine, or delete jobs for later execution +.SH SYNOPSIS +.B at +.RB [ \-V ] +.RB [ \-q +.IR queue ] +.RB [ \-f +.IR file ] +.RB [ \-u +.IR username ] +.RB [ \-mMlv ] +.IR timespec " ...\&" +.br +.B at +.RB [ \-V ] +.RB [ \-q +.IR queue ] +.RB [ \-f +.IR file ] +.RB [ \-u +.IR username ] +.RB [ \-mMkv ] +.RB [ \-t +.IR time ] +.br +.B "at \-c" +.I job +[...\&] +.br +.B atq +.RB [ \-V ] +.RB [ \-q +.IR queue ] +.RB [ -o +.IR timeformat ] +.br +.B at +.RB [ \-rd ] +.I job +[...\&] +.br +.B atrm +.RB [ \-V ] +.I job +[...\&] +.br +.B batch +.br +.B "at \-b" +.SH DESCRIPTION +.B at +and +.B batch +read commands from standard input or a specified file which are to +be executed at a later time, using +.BR /bin/sh . +.TP 8 +.B at +executes commands at a specified time. +.TP 8 +.B atq +lists the user's pending jobs, unless the user is the superuser; in that +case, everybody's jobs are listed. The format of the output lines (one +for each job) is: Job number, date, hour, queue, and username. +.TP 8 +.B atrm +deletes jobs, identified by their job number. +.TP 8 +.B batch +executes commands when system load levels permit; in other words, when the load average +drops below 0.8, or the value specified in the invocation of +.BR atd . +Note that because of the load meaning on Linux, +this number is multiplied by the amount of CPUs when compared to the +system loadavg. +.PP +.B At +allows fairly complex time +specifications, extending the POSIX.2 standard. It accepts times +of the form +.B 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 +.B midnight, +.B noon, +or +.B teatime +(4pm) +and you can have a time-of-day suffixed with +.B AM +or +.B 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 +.B month-name +.B day +with an optional +.B year, +or giving a date of the form +.IR MMDD [ CC ] YY , +.IR MM / DD /[ CC ] YY , +.IR DD . MM .[ CC ] YY +or +.RI [ CC ] YY - MM - DD . +The specification of a date +.I must +follow the specification of the time of day. +You can also give times like +.B now +.B + +.I count +.I time-units, +where the time-units can be +.B minutes, +.B hours, +.B days, +or +.B weeks +and you can tell +.B at +to run the job today by suffixing the time with +.B today +and to run the job tomorrow by suffixing the time with +.B tomorrow. +.PP +For example, to run a job at 4pm three days from now, you would do +.B at 4pm + 3 days, +to run a job at 10:00am on July 31, you would do +.B at 10am Jul 31 +and to run a job at 1am tomorrow, you would do +.B at 1am tomorrow. +.PP +If you specify a job to absolutely run at a specific time and date in +the past, the job will run as soon as possible. For example, if it is +8pm and you do a +.B at 6pm today, +it will run more likely at 8:05pm. +.PP +The definition of the time specification can be found in +.IR /usr/share/doc/packages/at/timespec . +.PP +For both +.BR at " and " batch , +commands are read from standard input or the file specified +with the +.B \-f +option and executed. +The working directory, the environment (except for the variables +.BR BASH_VERSINFO , +.BR DISPLAY , +.BR EUID , +.BR GROUPS , +.BR SHELLOPTS , +.BR TERM , +.BR UID , +and +.BR _ ) +and the umask are retained from the time of invocation. + +As +.B at +is currently implemented as a setuid program, other environment variables (e.g., +.BR LD_LIBRARY_PATH " or " LD_PRELOAD ) +are also not exported. This may change in the future. As a workaround, +set these variables explicitly in your job. + +An +.BR "at " \- +or +.BR "batch "\- +command invoked from a +.BR 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 +.BR /usr/sbin/sendmail . +If +.B at +is executed from a +.BR 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 at is determined by the files +.I /etc/at.allow +and +.IR /etc/at.deny . +See +.BR at.allow (5) +for details. +.SH OPTIONS +.TP 8 +.B \-V +prints the version number to standard error and exit successfully. +.TP 8 +.BI \-q " queue" +uses the specified queue. +A queue designation consists of a single letter; valid queue designations +range from +.B a +to +.B z +and +.B A +to +.BR Z . +The +.B a +queue is the default for +.B at +and the +.B b +queue for +.BR batch . +Queues with higher letters run with increased niceness. The special +queue "=" is reserved for jobs which are currently running. +.P +If a job is submitted to a queue designated with an uppercase letter, the +job is treated as if it were submitted to batch at the time of the job. +Once the time is reached, the batch processing rules with respect to load +average apply. +If +.B atq +is given a specific queue, it will only show jobs pending in that queue. +.TP 8 +.B \-m +Send mail to the user when the job has completed even if there was no +output. +.TP 8 +.B \-M +Never send mail to the user. +.TP 8 +.BI \-u " username" +Sends mail to +.I username +rather than the current user. +.TP 8 +.BI \-f " file" +Reads the job from +.I file +rather than standard input. +.TP 8 +.BI \-t " time" +run the job at +.IR time , +given in the format [[CC]YY]MMDDhhmm[.ss] +.TP 8 +.B \-l +Is an alias for +.B atq. +.TP +.B \-r +Is an alias for +.B atrm. +.TP +.B \-d +Is an alias for +.B atrm. +.TP +.B \-b +is an alias for +.BR batch . +.TP +.B \-v +Shows the time the job will be executed before reading the job. +.P +Times displayed will be in the format "Thu Feb 20 14:50:00 1997". +.TP +.B +\-c +cats the jobs listed on the command line to standard output. +.TP 8 +.BI \-o " fmt" +strftime-like time format used for the job list +.SH FILES +.I /var/spool/atjobs +.br +.I /var/spool/atspool +.br +.I /proc/loadavg +.br +.I /var/run/utmp +.br +.I /etc/at.allow +.br +.I /etc/at.deny +.SH SEE ALSO +.BR at.allow (5), +.BR at.deny (5), +.BR atd (8), +.BR cron (1), +.BR nice (1), +.BR sh (1), +.BR umask (2). +.SH BUGS +The correct operation of +.B batch +for Linux depends on the presence of a +.IR proc - +type directory mounted on +.IR /proc . +.PP +If the file +.I /var/run/utmp +is not available or corrupted, or if the user is not logged on at the +time +.B at +is invoked, the mail is sent to the userid found +in the environment variable +.BR LOGNAME . +If that is undefined or empty, the current userid is assumed. +.PP +.B At +and +.B 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 +.BR nqs . +.SH AUTHOR +At was mostly written by Thomas Koenig. |