348 lines
7.1 KiB
Groff
348 lines
7.1 KiB
Groff
.\" %FreeBSD: src/usr.bin/at/at.man,v 1.34 2003/03/26 02:38:18 keramida Exp %
|
|
.\" $FreeBSD$
|
|
.Dd January 13, 2002
|
|
.Dd April 12, 1995
|
|
.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 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 _
|
|
は除く)、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
|
|
を実行できます。
|
|
これがデフォルトの設定です。
|
|
.Pp
|
|
空の
|
|
.Pa /var/at/at.deny
|
|
は全てのユーザがこれらのコマンドを使用できることを意味します。
|
|
.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
|
|
が少し拡張しました。
|