Takayuki Ogawa
andro****@compu*****
2014年 8月 12日 (火) 18:15:09 JST
<STATUS> stat: RO ppkg: at page: at.1 date: 2014/08/01 mail: takay****@compu***** name: Takayuki Ogawa </STATUS> .\" .\" Original man-page is part of****@-3*****. .\" .\" 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*****>, taken over and re-packaged first by Martin .\" Schulze <joey****@debia*****> and then by Siggy Brentrup <bsb****@winne*****>, .\" and then taken over by Ryan Murray <rmurr****@debia*****>. .\" .\" In August 2009 the upstream development and Debian packaging were taken over .\" by Ansgar Burchardt <ansga****@debia*****> and Cyril Brulebois <kibi****@debia*****>. .\" .\" 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****@saine*****> .\" .\" Modified to reflect chang****@-3***** .\" Mon 22 Jun 1998, by NAKANO Takeo <nakan****@apm*****> .\" .\" Modified to fix two errors(section name, OKURI-GANA) .\" Mon 9 Aug 1999, by FUJIWARA Teruyoshi <fujiw****@linux*****> .\" .\" Modified to reflect chang****@-3***** .\" Fri 1 Aug 2014, by Takayuki Ogawa <takay****@compu*****> .\" .TH AT 1 2009-11-14 .\"O .SH NAME .SH 名前 .\"O at, batch, atq, atrm \- queue, examine or delete jobs for later execution 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" .\"O .SH DESCRIPTION .SH 説明 .\"O .B at .\"O and .\"O .B batch .\"O read commands from standard input or a specified file which are to .\"O be executed at a later time, using .\"O .BR /bin/sh . .B at と .B batch は、標準入力や指定されたファイルからコマンドを読み取り、後で .BR /bin/sh を使って実行する。 .TP 8 .BR at .\"O executes commands at a specified time. 指定された時刻にコマンドを実行する。 .TP 8 .BR atq .\"O lists the user's pending jobs, unless the user is the superuser; in that .\"O case, everybody's jobs are listed. The format of the output lines (one .\"O for each job) is: Job number, date, hour, queue, and username. このコマンドを起動したユーザーの、実行されていないジョブを表 示する。スーパーユーザーで起動すると、全てのユーザー のジョブを表示する。 (各ジョブごとに一行ずつ) 出力される行の形式は、 ジョブ番号・日付・時間・キュー・ユーザー名 となる。 .TP 8 .BR atrm .\"O deletes jobs, identified by their job number. ジョブ番号で識別されるジョブを削除する。 .TP 8 .BR batch .\"O executes commands when system load levels permit; in other words, when the load average .\"O drops below 0.8, or the value specified in the invocation of .\"O .BR atd . システムの負荷レベルが許可したときコマンドを実行する。 すなわち、負荷平均が 0.8 か、または .B atd で指定された値を下回るとコマンドを実行する。 .PP .\"O .B At .\"O allows fairly complex time .\"O specifications, extending the POSIX.2 standard. It accepts times .\"O of the form .\"O .B HH:MM .\"O to run a job at a specific time of day. .\"O (If that time is already past, the next day is assumed.) .B at ではある程度複雑な .B TIME 指定ができる。これは POSIX.2 標準を拡張したものである。 ジョブを実行する時刻は .B HH:MM という形式で指定できる。 (すでにその時刻を過ぎているときは次の日に実行する。) .\"O You may also specify .\"O .B midnight, .\"O .B noon, .\"O or .\"O .B teatime .\"O (4pm) .\"O and you can have a time-of-day suffixed with .\"O .B AM .\"O or .\"O .B PM .\"O for running in the morning or the evening. また .B midnight (真夜中), .B noon (正午), .B teatime (午後４時のお茶の時間) とか、 .B AM , .B PM も指定できる。 .\"O You can also say what day the job will be run, .\"O by giving a date in the form .\"O .B month-name .\"O .B day .\"O with an optional .\"O .B year, .\"O or giving a date of the form .\"O .IR MMDD [ CC ] YY , .\"O .IR MM / DD /[ CC ] YY , .\"O .IR DD . MM .[ CC ] YY .\"O or .\"O .RI [ CC ] YY - MM - DD . さらに、コマンドの実行日を指定することもできる。 日付の指定は .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 なども可能である。 .\"O The specification of a date .\"O .I must .\"O follow the specification of the time of day. 日付の指定は、その日の時刻の\fI後に\fP指定しなければならない。 .\"O You can also give times like .\"O .B now .\"O .B \+ .\"O .I count .\"O .I time-units, .\"O where the time-units can be .\"O .B minutes, .\"O .B hours, .\"O .B days, .\"O or .\"O .B weeks .\"O and you can tell .\"O .B at .\"O to run the job today by suffixing the time with .\"O .B today .\"O and to run the job tomorrow by suffixing the time with .\"O .B tomorrow. また .B now .B \+ .I count .I time-units, と指定することでコマンドをどのくらい後に実行するか指定できる。 時間の単位には .B minutes, .B hours, .B days, .B weeks が使える。 さらにジョブを今日実行したい場合は .B today を、明日実行したい場合は .B tomorrow を、それぞれ時刻の後に付ければ良い。 .PP .\"O For example, to run a job at 4pm three days from now, you would do .\"O .B at 4pm + 3 days, .\"O to run a job at 10:00am on July 31, you would do .\"O .B at 10am Jul 31 .\"O and to run a job at 1am tomorrow, you would do .\"O .B at 1am tomorrow. 例えば、今日から 3 日後の午後 4 時にジョブを実行する場合 .B at 4pm + 3 days, とし、 7 月 31 日の午前 10 時にジョブを実行するときは .B at 10am Jul 31 とし、明日の午前 1 時に実行するときは .B at 1am tomorrow とする。 .PP .\"O The definition of the time specification can be found in .\"O .IR /usr/share/doc/at/timespec . 時間指定方法の定義は .IR /usr/share/doc/at/timespec に書いてある。 .PP .\"O For both .\"O .BR at " and " batch , .\"O commands are read from standard input or the file specified .\"O with the .\"O .B -f .\"O option and executed. .BR at " と " batch はいずれも、コマンドを標準入力から、あるいは .B -f オプションで指定されたファイルから読み込んで、実行する。 .\"O The working directory, the environment (except for the variables .\"O .BR BASH_VERSINFO , .\"O .BR DISPLAY , .\"O .BR EUID , .\"O .BR GROUPS , .\"O .BR SHELLOPTS , .\"O .BR TERM , .\"O .BR UID , .\"O and .\"O .BR _ ) .\"O and the umask are retained from the time of invocation. 作業ディレクトリ、環境 (環境変数 .BR BASH_VERSINFO ", " DISPLAY ", " EUID ", " GROUPS ", " SHELLOPTS ", " TERM ", " UID ", " _ を除く)、 umask には、 .BR at " や " batch が起動されたときのものが保存される。 .\"O .\"O As .\"O .BR at .\"O is currently implemented as a setuid program, other environment variables (e.g. .\"O .BR LD_LIBRARY_PATH " or " LD_PRELOAD ) .\"O are also not exported. This may change in the future. As a workaround, .\"O set these variables explicitly in your job. .\"O .BR at は現在では setuid プログラムとして実装されているので、上記以外の環境変数、例えば .BR LD_LIBRARY_PATH " や " LD_PRELOAD のようなものもエクスポートされない。これは将来変更されるかもしれない。回避策として、 これらの変数はジョブ内で明示的にセットする必要がある。 .\"O An .\"O .BR "at " \- .\"O or .\"O .BR "batch "\- .\"O command invoked from a .\"O .B su(1) .\"O shell will retain the current userid. .B su(1) したあとのシェルから起動された .B at (または .BR "batch " ) コマンドでは、カレントのユーザー ID が用いられる。 .\"O The user will be mailed standard error and standard output from his .\"O commands, if any. コマンドを実行した結果、標準エラー出力や標準出力が出ると、ユーザー はメールを受け取る。 .\"O Mail will be sent using the command .\"O .BR /usr/sbin/sendmail . メールの配送には .BR /usr/sbin/sendmail が用いられる。 .\"O If .\"O .B at .\"O is executed from a .\"O .B su(1) .\"O shell, the owner of the login shell will receive the mail. .B at が .B su(1) したあとのシェルから起動されたときは、ログインシェルのオーナーがメール を受け取る。 .PP .\"O The superuser may use these commands in any case. .\"O For other users, permission to use at is determined by the files .\"O .I /etc/at.allow .\"O and .\"O .IR /etc/at.deny . スーパーユーザーは、どんな場合でもこのコマンドを使うことができる。 他のユーザについて、at を使用できるかどうかを決めているのは、 .I /etc/at.allow と .I /etc/at.deny の二つのファイルである。 .\"O See .\"O .BR at.allow (5) .\"O for details. 詳細は .BR at.allow (5) を参照。 .\"O .SH OPTIONS .SH オプション .TP 8 .B -V .\"O prints the version number to standard error and exit successfully. バージョン情報を標準エラー出力に表示し、正常終了する。 .TP 8 .BI \-q " queue" .\"O uses the specified queue. .\"O A queue designation consists of a single letter; valid queue designations .\"O range from .\"O .B a .\"O to .\"O .BR z .\"O and .\"O .B A .\"O to .\"O .BR Z . キュー指定をする。指定は英字１文字で行う。 有効な文字は .B a から .BR z と .B A から .BR Z である。 .\"O The .\"O .B a .\"O queue is the default for .\"O .B at .\"O and the .\"O .B b .\"O queue for .\"O .BR batch . .B a キューが .B at のデフォルトキューで、 .B b キューが .BR batch のデフォルトキューである。 .\"O Queues with higher letters run with increased niceness. The special .\"O queue "=" is reserved for jobs which are currently running. 後のほうの文字のキューほど、より nice レベルが大きくなる (実行の優先度が下がる)。特殊キュー "=" は現在実行されているジョブのため に予約されている。 .P .\"O If a job is submitted to a queue designated with an uppercase letter, the .\"O job is treated as if it were submitted to batch at the time of the job. .\"O Once the time is reached, the batch processing rules with respect to load .\"O average apply. 大文字のキューに登録したジョブは、そのジョブの実行時に、 batch に対して登録されたものであるかのように処理される。 すなわち、実行時刻になると、負荷平均に関するバッチ処理のルールが適用されることになる。 .\"O If .\"O .BR atq .\"O is given a specific queue, it will only show jobs pending in that queue. .BR atq でキューを指定すると、そのキューにたまっている 未実行ジョブだけを表示する。 .TP 8 .B \-m .\"O Send mail to the user when the job has completed even if there was no .\"O output. ジョブが完了したとき、そのジョブがなにも出力しなくても、 ユーザーに完了通知をメールする。 .TP 8 .B \-M .\"O Never send mail to the user. ユーザーにメールしない。 .TP 8 .BI \-f " file" .\"O Reads the job from .\"O .I file .\"O rather than standard input. 標準入力でなく、 .I file からジョブを読み取る。 .TP 8 .BI \-t " time" .\"O run the job at .\"O .IR time , .\"O given in the format [[CC]YY]MMDDhhmm[.ss] ジョブを [[CC]YY]MMDDhhmm[.ss] の形式で指定した日時 .RI ( time ) に実行する。 .TP 8 .B \-l .\"O Is an alias for .\"O .B atq. .B atq と同じ働きをする。 .TP .B \-r .\"O Is an alias for .\"O .B atrm. .B atrm と同じ働きをする。 .TP .B \-d .\"O Is an alias for .\"O .B atrm. .B atrm と同じ働きをする。 .TP .B \-b .\"O is an alias for .\"O .BR batch . .BR batch と同じ働きをする。 .TP .B \-v .\"O Shows the time the job will be executed before reading the job. ジョブの読み込み前に、ジョブが実行される日時を表示する。 .P .\"O Times displayed will be in the format "Thu Feb 20 14:50:00 1997". 時刻は "Thu Feb 20 14:50:00 1997" の形式で表示される。 .TP .B \-c .\"O cats the jobs listed on the command line to standard output. コマンドラインで指定したジョブを標準出力に表示する。 .\"O .SH FILES .SH ファイル .\"O .I /var/spool/cron/atjobs .I /var/spool/cron/atjobs .br .\"O .I /var/spool/cron/atspool .I /var/spool/cron/atspool .br .I /proc/loadavg .br .I /var/run/utmp .br .I /etc/at.allow .br .I /etc/at.deny .\"O .SH SEE ALSO .SH 関連項目 .BR at.allow (5), .BR at.deny (5), .BR atd (8), .BR cron (1), .BR nice (1), .BR sh (1), .\"O .BR umask (2). .BR umask (2) .\"O .SH BUGS .SH バグ .\"O The correct operation of .\"O .B batch .\"O for Linux depends on the presence of a .\"O .IR proc - .\"O type directory mounted on .\"O .IR /proc . Linux で .B batch が正しく動作するためには、 .IR /proc にマウントされた .IR proc 形式のディレクトリが必要である。 .PP .\"O If the file .\"O .I /var/run/utmp .\"O is not available or corrupted, or if the user is not logged on at the .\"O time .\"O .B at .\"O is invoked, the mail is sent to the userid found .\"O in the environment variable .\"O .BR LOGNAME . .\"O If that is undefined or empty, the current userid is assumed. もし .I /etc/utmp が壊れて使えなかったり、 .B at がジョブを実行するときにユーザーがログインしてなかったりすると、 環境変数 .BR LOGNAME で指定されたユーザー ID にメールを送る。もしこの変数が定義されて いなかったり、空だったりした場合、カレントのユーザー ID に送られる。 .PP .\"O .B At .\"O and .\"O .B batch .\"O as presently implemented are not suitable when users are competing for .\"O resources. .\"O If this is the case for your site, you might want to consider another .\"O batch system, such as .\"O .BR nqs . .B at と .B batch の現在の実装は、ユーザーが資源を取り合っているような状況下では 適当なものではない。このような場合は他の batch システム、たとえば .BR nqs などを考えるべきだろう。 .\"O .SH AUTHOR .SH 作者 .\"O At was mostly written by Thomas Koenig, ig25****@rz*****. at のほとんどの部分を書いたのは Thomas Koenig, ig25****@rz***** である。
Fork