.\" .Id $Id: at.1,v 1.3 2003/12/16 13:28:31 nakano Exp $
.\"
.\" Original man-page is part of at-3.1.7.
.\"
.\" Copyright: 1993, 1994, 1995, 1996, 1997 (c) Thomas Koenig
.\"            1993 (c) David Parsons
.\" 
.\" 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>
.\"
.TH AT 1 "Nov 1996" local "Linux Programmer's Manual"
.SH 名前
at, batch, atq, atrm \- 後で実行するコマンドジョブをキューに入れたり、そのようなジョブの閲覧・削除を行なう
.SH 書式
.B at
.RB [ -V ]
.RB [ -q 
.IR queue ]
.RB [ -f
.IR file ]
.RB [ -mldbv ]
.B TIME
.br
.B "at -c"
.I job
.RI [ job... ]
.br
.B atq
.RB [ -V ]
.RB [ -q
.IR queue ]
.RB [ -v ]
.br
.B atrm
.RB [ -V ]
.I job
.RI [ job... ]
.br
.B batch
.RB [ -V ]
.RB [ -q
.IR queue ]
.RB [ -f
.IR file ]
.RB [ -mv ]
.RB [ TIME ]
.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 atrun
で指定された値を下回るとコマンドを実行する。
.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
も追加できる) のようにする。または
.BR MMDDYY ,
.BR MM/DD/YY ,
.B DD.MM.YY
なども可能である。
日付の指定は、その日の時刻の\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
時間指定方法の厳密な定義は
.I /usr/doc/at/timespec
に書いてある。
.PP
.BR at " と " batch
は、ともに標準入力や
.B -f
オプションで指定されたファイルのコマンドを実行する。
作業ディレクトリ、環境 (環境変数
.BR TERM ", " DISPLAY ", " _
を除く)、 umask には、
.BR at " や " batch
が起動されたときのものが保存される。
.B su(1)
したあとのシェルから起動された
.B at 
(または
.BR "batch " )
コマンドでは、カレントのユーザー ID が用いられる。
コマンドを実行した結果、標準エラー出力や標準出力が出ると、ユーザー
はメールを受け取る。
メールの配送には
.BR /usr/bin/sendmail
が用いられる。
.B at
が
.B su(1)
したあとのシェルから起動されたときは、ログインシェルのオーナーがメール
を受け取る。
.PP
スーパーユーザーは、どんな場合でも必ずこのコマンドを使うことができる。
他のユーザーのパーミッションは
.I /etc/at.allow
と
.I /etc/at.deny
で指定する。
.PP
.I /etc/at.allow
があれば、そこに書かれたユーザーのみが
.BR at
を使える。
.PP
.I /etc/at.allow
がなければ
.I /etc/at.deny
をチェックし、そこに書かれて「いない」ユーザーすべてが
.B at
を使える。
.PP
もしどちらのファイルもなければ、スーパーユーザーのみ
at を使うことができる。
.PP
空の 
.I /etc/at.deny
があるときは、全てのユーザーがこれらのコマンドを使うことができる。
この設定がデフォルトである。
.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 レベルが大きくなる
(実行の優先度が下がる)。特殊キュー "=" は現在実行されているジョブのため
に予約されている。

大文字のキューで予約されたジョブは、 batch で指定されたかのよう
に扱われる。
.BR atq
でキューを指定すると、そのキューにたまっている
未実行ジョブだけを表示する。
.TP 8
.B \-m
ジョブが完了したとき、そのジョブがなにも出力しなくても、
ユーザーに完了通知をメールする。
.TP 8
.BI \-f " file"
標準入力でなく、
.I file
からジョブを読み取る。
.TP 8
.B \-l
.B atq
と同じ働きをする。
.TP
.B \-d
.B atrm
と同じ働きをする。
.BR atq
で指定された場合には、キューの中に存在している「終了したがまだ削除され
ていない」ジョブを表示する。そのほかのコマンドで指定された場合は、その
ジョブを実行する時刻を表示する。

時刻は "1997-02-20 14:50" のような形式で表示される。ただし環境変数
.B POSIXLY_CORRECT
が指定されている場合は "Thu Feb 20 14:50:00 1996" のようになる。
.TP
.B
\-c
コマンドラインで指定したジョブを標準出力に表示する。
.SH ファイル
.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 関連項目
cron(1), nice(1), sh(1), umask(2), atd(8)
.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 によって書かれた。