doc/ja_JP.eucJP/man/man1/at.1

.\" %FreeBSD: src/usr.bin/at/at.man,v 1.34 2003/03/26 02:38:18 keramida Exp %
.\" $FreeBSD$
.Dd January 13, 2002
.Dt "AT" 1
.Os
.Sh 名称
.Nm at ,
.Nm batch ,
.Nm atq ,
.Nm atrm
.Nd あとでジョブを実行させるためのキューの設定、確認、ジョブの削除を行なう
.Sh 書式
.Nm at
.Op Fl q Ar queue
.Op Fl f Ar file
.Op Fl mldbv
.Ar time
.Nm at
.Op Fl q Ar queue
.Op Fl f Ar file
.Op Fl mldbv
.Fl t
.Sm off
.Op Oo Ar CC Oc Ar YY
.Ar MM DD hh mm Op . Ar SS
.Sm on
.Nm at
.Fl c Ar job Op Ar job ...
.Nm at
.Fl l Op Ar job ...
.Nm at
.Fl l
.Fl q Ar queue
.Nm at
.Fl r Ar job Op Ar job ...
.Pp
.Nm atq
.Op Fl q Ar queue
.Op Fl v
.Pp
.Nm atrm
.Ar job
.Op Ar job ...
.Pp
.Nm batch
.Op Fl q Ar queue
.Op Fl f Ar file
.Op Fl mv
.Op Ar time
.Sh 解説
.Nm at
と
.Nm batch
のユーティリティは、標準入力もしくは指定したファイルからコマンドを読み
込み、あとで
.Xr sh 1
を使って実行します。
.Bl -tag -width indent
.It Nm at
コマンドを、引数で指定した時間に実行します。
.It Nm atq
ユーザの、実行待ち状態のジョブのリストを表示します。
スーパユーザが実行した場合は全員のジョブが表示されます。
.It Nm atrm
指定したジョブを削除します。
.It Nm batch
ロードアベレージが特定の値以下になったときにジョブを実行
します。この値は、デフォルトでは 1.5 です。
この値は
.Nm atrun
によって指定可能です。
.El
.Pp
.Nm at
ユーティリティでは、様々な形式の時間を
.Ar time
として受け付けます。
時刻は
.Ar HHMM
もしくは
.Ar HH:MM
の形で指定します
(もしこの時刻が過ぎていた場合は、次の日のその時刻に設定されます)。
また、
.Em midnight ,
.Em noon ,
.Em teatime
(4pm) のキーワードも受け付けますし、時刻の後ろに
.Em AM
もしくは
.Em PM
をつけた時間も受け付けます。
日付は、
.Ar \%month-name day
およびオプションの
.Ar year
の形で受け付けます。
.Ar DD.MM.YYYY ,
.Ar DD.MM.YY ,
.Ar MM/DD/YYYY ,
.Ar MM/DD/YY ,
.Ar MMDDYYYY ,
.Ar MMDDYY
も受け付けます。
日付の指定は時刻の指定の後に記述します。
.Op Em now
.Em  + Ar count \%time-units
のような形式で時間を指定することも可能です。time-units は時間の単位で、
.Em minutes ,
.Em hours ,
.Em days ,
.Em weeks ,
.Em months ,
.Em years
のいずれかです。時間のサフィックスの
.Em today
はジョブを今日に設定すること、
.Em tomorrow
はジョブを明日に設定することを意味します。
.Pp
例えば、今から 3 日後の午後 4 時にジョブを走らせるためには
.Nm at Ar 4PM + 3 days
とします。7 月 31 日の午前 10 時の場合は
.Nm at Ar 10am Jul 31
とします。明日の午前 1 時は
.Nm at Ar 1am tomorrow
です。
.Pp
.Nm at
ユーティリティは、
.Tn POSIX
時刻書式 (
.Fl t
オプションを参照してください) もサポートしています。
.Pp
.Nm at
と
.Nm batch
はどちらも、標準入力または
.Fl f
オプションで指定したファイルからコマンドを読み込み、実行します。
ワーキングディレクトリと環境変数 (
.Ev TERM ,
.Ev TERMCAP ,
.Ev DISPLAY
および
.Em _
は除く)、
.Ar umask
は実行時のものが保持されます。
.Nm at
もしくは
.Nm batch
が
.Xr su 1
で起動されたシェルから実行された場合は、カレントの userid を保持します。
出力結果が得られた場合は、
その標準出力と標準エラー出力がメールで送られます。メールは
.Xr sendmail 8
を使って送られます。もし
.Nm at
が
.Xr su 1
で起動されたシェルから実行された場合は、そのログインシェルの所有者が
メールを受けることになります。
.Pp
スーパユーザはどんな場合でもこれらのコマンドを実行できます。
その他のユーザは
.Pa /var/at/at.allow
と
.Pa /var/at/at.deny
のファイルによって
.Nm
を実行できるか決められます。
.Pp
もし
.Pa /var/at/at.allow
が存在するならば、その中にユーザ名を記述されたユーザだけが
.Nm at
の実行を許可されます。
これらの 2 ファイルでは、ユーザ名の行において、
ユーザ名の前に空白や他の文字が無く、
たとえファイルの最後であってもユーザ名の直後に改行がある場合のみ、
ユーザが列挙されているとみなされます。
他の行は無視され、コメントとして使用可能です。
.Pp
もし
.Pa /var/at/at.allow
が存在しなければ、
.Pa /var/at/at.deny
がチェックされ、その中にユーザ名が記述されていないすべてのユーザが
.Nm at
の実行を許可されます。
.Pp
もし両方ともなければ、スーパユーザだけが
.Nm at
を実行できます。
これがデフォルトの設定です。
.Sh 実装に関する注
.Nm
の実装は、
.Xr atrun 8
を 5 分毎に呼び出す
.Xr cron 8
デーモンを通じて実装されていることに注意してください。
これは、
.Nm
の粒度がすべての用途において最適ではないかもしれないことを意味します。
より細かい粒度が必要な場合、システムの crontab
.Pa /etc/crontab
を変更してください。
.Sh オプション
.Bl -tag -width indent
.It Fl q Ar queue
指定したキューを用います。キューの名称は単一の文字からなります。
有効なキューの名前は
.Ar a
から
.Ar z
と
.Ar A
から
.Ar Z
です。
.Nm at
のデフォルトのキューは
.Ar c
で、
.Nm batch
のデフォルトのキューは
.Ar E
です。
キューの文字が後の方であればあるほど nice 値が上がります。
もし大文字のキューがジョブに対して指定されたならば、時間を指定して
batch が実行されたものとして扱われます。
もし
.Nm atq
でキューが指定されたときは、そのキューだけの実行待ちのジョブを表示します。
.It Fl m
出力がなかった場合でも、ジョブの完了時にメールをユーザに送ります。
.It Fl f Ar file
標準入力のかわりにファイルからジョブを読み込みます。
.It Fl l
引数無しの場合、起動したユーザの全ジョブを表示します。
1 個以上のジョブ番号を指定した場合、それらのジョブのみを表示します。
.It Fl d
.Nm atrm
の別名
(本オプションは価値が低下しています。
代りに
.Fl r
を使用してください)。
.It Fl b
.Nm batch
の別名。
.It Fl v
.Nm atq
の場合は、キューの中の実行されたがまだ削除されていないジョブを
表示します。さもなければジョブが実行される時間を表示します。
.It Fl c
コマンドラインにリストされたジョブを標準出力に出力します。
.It Fl r
指定したジョブを削除します。
.It Fl t
\*[Px] 時刻書式を使用して、ジョブの時刻を指定します。
引数の書式は
.Sm off
.Op Oo Ar CC Oc Ar YY
.Ar MM DD hh mm Op . Ar SS
.Sm on
という形式であることが必要であり、各文字の組は以下の意味です:
.Pp
.Bl -tag -width indent -compact -offset indent
.It Ar CC
年の最初の 2 桁 (世紀)。
.It Ar YY
年の次の 2 桁。
.It Ar MM
月であり 1 から 12 です。
.It Ar DD
日であり 1 から 31 です。
.It Ar hh
時間であり、0 から 23 です。
.It Ar mm
分であり、0 から 59 です。
.It Ar SS
秒であり、0 から 61 です。
.El
.Pp
.Ar CC
および
.Ar YY
の文字の組が指定されない場合、今年を意味します。
.Ar SS
の文字の組が指定されない場合、値は 0 になります。
.El
.Sh 関連ファイル
.Bl -tag -width /var/at/jobs/.lockfile -compact
.It Pa /var/at/jobs
ジョブファイルを保管しておくディレクトリ
.It Pa /var/at/spool
出力ファイルを保管しておくディレクトリ
.It Pa /var/run/utmp
ログインレコード
.It Pa /var/at/at.allow
許可属性の設定
.It Pa /var/at/at.deny
不許可属性の設定
.It Pa /var/at/jobs/.lockfile
ジョブ作成のロックファイル
.El
.Sh 関連項目
.Xr nice 1 ,
.Xr sh 1 ,
.Xr umask 2 ,
.Xr atrun 8 ,
.Xr cron 8 ,
.Xr sendmail 8
.Sh バグ
.Pa /var/run/utmp
が利用できないか不正であった場合、もしくは
.Nm at
が実行された時にユーザがログインしていない場合、
環境変数
.Ev LOGNAME
で表される userid にメールが送られます。
もし定義されていないか空ならばカレントの userid になります。
.Pp
ユーザ同士でリソースの競合がある場合は現実装の
.Nm at
と
.Nm batch
ユーティリティは適当ではありません。
もしこのような場合にあてはまるのなら、
.Em nqs
のような他のバッチシステムを検討してください。
.Pp
2038 年以降の日付を指定しても動作しないシステムがあるかもしれません。
.Sh 作者
at のほとんどの部分は
.An Thomas Koenig Aq ig25@rz.uni-karlsruhe.de
が作成しました。
時間の構文解析部分は
.An David Parsons Aq orc@pell.chi.il.us
が作成し、
.An Joe Halpin Aq joe.halpin@attbi.com
が少し拡張しました。