.\"
.\" Original man-page is part of at-3.1.14.
.\"
.\" This is the Debian GNU/Linux prepackaged version of the deferred
.\" execution scheduler called at.
.\"
.\" This package was debianized by its author Thomas Koenig
.\" <ig25@rz.uni-karlsruhe.de>, taken over and re-packaged first by Martin
.\" Schulze <joey@debian.org> and then by Siggy Brentrup <bsb@winnegan.de>,
.\" and then taken over by Ryan Murray <rmurray@debian.org>.
.\"
.\" In August 2009 the upstream development and Debian packaging were taken over
.\" by Ansgar Burchardt <ansgar@debian.org> and Cyril Brulebois <kibi@debian.org>.
.\"
.\" This may be considered the experimental upstream source, and since there
.\" doesn't seem to be any other upstream source, the only upstream source.
.\"
.\"    Copyright: 1993, 1994, 1995, 1996, 1997 (c) Thomas Koenig
.\"               1993 (c) David Parsons
.\" 	      2002, 2005 (c) Ryan Murray
.\"
.\"    This program is free software; you can redistribute it and/or modify
.\"    it under the terms of the GNU General Public License as published by
.\"    the Free Software Foundation; either version 2 of the License, or
.\"    (at your option) any later version.
.\"
.\"    This program is distributed in the hope that it will be useful,
.\"    but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"    GNU General Public License for more details.
.\"
.\" Japanese Version Copyright (c) 1996 Tanoshima Hidetohsi
.\"         all rights reserved.
.\" Dec 31, 1996   Tanoshima Hidetoshi <tano@sainet.or.jp>
.\"
.\" Modified to reflect changes at-3.1.7
.\" Mon 22 Jun 1998, by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.\" Modified to fix two errors(section name, OKURI-GANA)
.\" Mon 9 Aug 1999, by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" Modified to reflect changes at-3.1.14
.\" Fri 1 Aug 2014, by Takayuki Ogawa <takayuki@compusophia.com>
.\"
.TH AT 1 2009-11-14
.SH 名前
at, batch, atq, atrm \- 後で実行するコマンドジョブをキューに入れたり、そのようなジョブの閲覧・削除を行なう
.SH 書式
.B at
.RB [ -V ]
.RB [ -q
.IR queue ]
.RB [ -f
.IR file ]
.RB [ -mMlv ]
.IR timespec ...
.br
.B at
.RB [ -V ]
.RB [ -q
.IR queue ]
.RB [ -f
.IR file ]
.RB [ -mMkv ]
.RB [ -t
.IR time ]
.br
.B "at -c"
.I job
.RI [ job... ]
.br
.B atq
.RB [ -V ]
.RB [ -q
.IR queue ]
.br
.B at
.RB [ -rd ]
.I job
.RI [ job... ]
.br
.B atrm
.RB [ -V ]
.I job
.RI [ job... ]
.br
.B batch
.br
.B "at -b"
.SH 説明
.B at
と
.B batch
は、標準入力や指定されたファイルからコマンドを読み取り、後で
.BR /bin/sh
を使って実行する。
.TP 8
.BR at
指定された時刻にコマンドを実行する。
.TP 8
.BR atq
このコマンドを起動したユーザーの、実行されていないジョブを表
示する。スーパーユーザーで起動すると、全てのユーザー
のジョブを表示する。 (各ジョブごとに一行ずつ) 出力される行の形式は、
ジョブ番号・日付・時間・キュー・ユーザー名
となる。
.TP 8
.BR atrm
ジョブ番号で識別されるジョブを削除する。
.TP 8
.BR batch
システムの負荷レベルが許可したときコマンドを実行する。
すなわち、負荷平均が 0.8 か、または
.B atd
で指定された値を下回るとコマンドを実行する。
.PP
.B at
ではある程度複雑な
.B TIME
指定ができる。これは POSIX.2 標準を拡張したものである。
ジョブを実行する時刻は
.B HH:MM
という形式で指定できる。
(すでにその時刻を過ぎているときは次の日に実行する。)
また
.B midnight
(真夜中),
.B noon
(正午),
.B teatime
(午後４時のお茶の時間)
とか、
.B AM
,
.B PM
も指定できる。
さらに、コマンドの実行日を指定することもできる。
日付の指定は
.B month-name
.B day
(
.B year
も追加できる) のようにする。または
.IR MMDD [ CC ] YY 、
.IR MM / DD /[ CC ] YY 、
.IR DD . MM .[ CC ] YY 、
.RI [ CC ] YY - MM - DD
なども可能である。
日付の指定は、その日の時刻の\fI後に\fP指定しなければならない。
また
.B now
.B \+
.I count
.I time-units,
と指定することでコマンドをどのくらい後に実行するか指定できる。
時間の単位には
.B minutes,
.B hours,
.B days,
.B weeks
が使える。
さらにジョブを今日実行したい場合は
.B today
を、明日実行したい場合は
.B tomorrow
を、それぞれ時刻の後に付ければ良い。
.PP
例えば、今日から 3 日後の午後 4 時にジョブを実行する場合
.B at 4pm + 3 days,
とし、 7 月 31 日の午前 10 時にジョブを実行するときは
.B at 10am Jul 31
とし、明日の午前 1 時に実行するときは
.B at 1am tomorrow
とする。
.PP
時間指定方法の定義は
.IR /usr/share/doc/at/timespec
に書いてある。
.PP
.BR at " と " batch
はいずれも、コマンドを標準入力から、あるいは
.B -f
オプションで指定されたファイルから読み込んで、実行する。
作業ディレクトリ、環境 (環境変数
.BR BASH_VERSINFO ", " DISPLAY ", " EUID ", " GROUPS ", " SHELLOPTS ", " TERM ", " UID ", " _
を除く)、 umask には、
.BR at " や " batch
が起動されたときのものが保存される。

.BR at
は現在では setuid プログラムとして実装されているので、上記以外の環境変数、例えば
.BR LD_LIBRARY_PATH " や " LD_PRELOAD
のようなものもエクスポートされない。これは将来変更されるかもしれない。回避策として、
これらの変数はジョブ内で明示的にセットする必要がある。

.B su(1)
したあとのシェルから起動された
.B at
(または
.BR "batch " )
コマンドでは、カレントのユーザー ID が用いられる。
コマンドを実行した結果、標準エラー出力や標準出力が出ると、ユーザー
はメールを受け取る。
メールの配送には
.BR /usr/sbin/sendmail
が用いられる。
.B at
が
.B su(1)
したあとのシェルから起動されたときは、ログインシェルのオーナーがメール
を受け取る。
.PP
スーパーユーザーは、どんな場合でもこのコマンドを使うことができる。
他のユーザについて、at を使用できるかどうかを決めているのは、
.I /etc/at.allow
と
.I /etc/at.deny
の二つのファイルである。
詳細は
.BR at.allow (5)
を参照。
.SH オプション
.TP 8
.B -V
バージョン情報を標準エラー出力に表示し、正常終了する。
.TP 8
.BI \-q " queue"
キュー指定をする。指定は英字１文字で行う。
有効な文字は
.B a
から
.BR z
と
.B A
から
.BR Z
である。
.B a
キューが
.B at
のデフォルトキューで、
.B b
キューが
.BR batch
のデフォルトキューである。
後のほうの文字のキューほど、より nice レベルが大きくなる
(実行の優先度が下がる)。特殊キュー "=" は現在実行されているジョブのため
に予約されている。
.P
大文字のキューに登録したジョブは、そのジョブの実行時に、
batch に対して登録されたものであるかのように処理される。
すなわち、実行時刻になると、負荷平均に関するバッチ処理のルールが適用されることになる。
.BR atq
でキューを指定すると、そのキューにたまっている
未実行ジョブだけを表示する。
.TP 8
.B \-m
ジョブが完了したとき、そのジョブがなにも出力しなくても、
ユーザーに完了通知をメールする。
.TP 8
.B \-M
ユーザーにメールしない。
.TP 8
.BI \-f " file"
標準入力でなく、
.I file
からジョブを読み取る。
.TP 8
.BI \-t " time"
ジョブを [[CC]YY]MMDDhhmm[.ss] の形式で指定した日時
.RI ( time )
に実行する。
.TP 8
.B \-l
.B atq
と同じ働きをする。
.TP
.B \-r
.B atrm
と同じ働きをする。
.TP
.B \-d
.B atrm
と同じ働きをする。
.TP
.B \-b
.BR batch
と同じ働きをする。
.TP
.B \-v
ジョブの読み込み前に、ジョブが実行される日時を表示する。
.P
時刻は "Thu Feb 20 14:50:00 1997" の形式で表示される。
.TP
.B
\-c
コマンドラインで指定したジョブを標準出力に表示する。
.SH ファイル
.I /var/spool/cron/atjobs
.br
.I /var/spool/cron/atspool
.br
.I /proc/loadavg
.br
.I /var/run/utmp
.br
.I /etc/at.allow
.br
.I /etc/at.deny
.SH 関連項目
.BR at.allow (5),
.BR at.deny (5),
.BR atd (8),
.BR cron (1),
.BR nice (1),
.BR sh (1),
.BR umask (2)
.SH バグ
Linux で
.B batch
が正しく動作するためには、
.IR /proc
にマウントされた
.IR proc
形式のディレクトリが必要である。
.PP
もし
.I /etc/utmp
が壊れて使えなかったり、
.B at
がジョブを実行するときにユーザーがログインしてなかったりすると、
環境変数
.BR LOGNAME
で指定されたユーザー ID にメールを送る。もしこの変数が定義されて
いなかったり、空だったりした場合、カレントのユーザー ID に送られる。
.PP
.B at
と
.B batch
の現在の実装は、ユーザーが資源を取り合っているような状況下では
適当なものではない。このような場合は他の batch システム、たとえば
.BR nqs
などを考えるべきだろう。
.SH 作者
at のほとんどの部分を書いたのは Thomas Koenig, ig25@rz.uni-karlsruhe.de である。