uustat(1)

名称
uustat - UUCP システム状態のチェックや制御を行なう

書式
uustat -a

uustat --all

uustat [ -eKRiMNQ ] [ -sS system ] [ -uU user ] [ -cC command ] [ -oy hours ] [ -B lines ] [ --executions ] [ --kill-all ] [ --rejuvenate-all ] [ --prompt ] [ --mail ] [ --notify ] [ --no-list ] [ --system system ] [ --not-system system ] [ --user user ] [ --not-user user ] [ --command command ] [ --not-command command ] [ --older-than hours ] [ --younger-than hours ] [ --mail-lines lines ]

uustat [ -kr jobid ] [ --kill jobid ] [ --rejuvenate jobid ]

uustat -q [ -sS system ] [ -oy hours ] [ --system system ] [ --not-system system ] [ --older-than hours ] [ --younger-than hours ]

uustat --list [ -sS system ] [ -oy hours ] [ --system system ] [ --not-system system ] [ --older-than hours ] [ --younger-than hours ]

uustat -m

uustat --status

uustat -p

uustat --ps

解説
uustat コマンドは、UUCP システムに関するいろんな情報を表示します。 また、本コマンドを用いることで、 uucp (1) や uux (1) で作成されたジョブを取り消したり、 ジョブのタイムスタンプの若返りを行なったりすることが出来ます。 デフォルトでは、 uustat は、コマンド を起動したユーザが要求したジョブをすべて表示します。これは、 --user オプションで自分を指定した場合の動作と同じです。 -a, --all, -e, --executions, -s, --system, -S, --not-system, -u, --user, -U, --not-user, -c, --command, -C, --not-command, -o, --older-than, -y, --younger-than のいずれかのオプションが指定されると、 指定条件の組み合わせに合致するすべてのジョブを表示します。 -K または --kill-all オプションは、要求してから 7 日間経過した全てのジョブのような、 選択したグループのジョブを削除出来ます。

オプション
uustat では、以下のオプションが使用可能です。

-a, --all
    キューイングされたすべてのファイル転送要求を表示します。

-e, --executions
    ファイル転送要求ではなく、 コマンド実行要求を表示します。キューイングされたコマンド実行要求は、 uucico (8) ではなく uuxqt (8) にて処理されます。 キューイング中のコマンド実行要求には、リモートシステムから転送される ファイルを待っているものもあります。これらの要求は、 uux (1) を起動することで作成されます。

-s system, --system system
    指定したシステムに対するジョブをすべて表示します。本オプションは、 1 回のコマンド起動時に複数指定することが可能です。 この場合、指定したシステムに対応するジョブが全て表示されます。 --list オプションと共に指定したときは、指定したシステムのジョブだけが表示されます。

-S system, --not-system system
    指定したシステム向け以外のジョブをすべて表示します。本オプションは、 1 回のコマンド起動時に複数指定することが可能です。 この場合、指定しなかったシステムのジョブが全て表示されます。 --list オプションと共に指定したときは、 指定しなかったシステムのジョブだけが表示されます。 なお、本オプションは、 -s や --system とは同時に指定してはいけません。

-u user, --user user
    指定したユーザのジョブをすべて表示します。本オプションは、 1 回のコマンド起動時に複数指定することが可能です。 この場合、指定したユーザのジョブが全て表示されます。

-U user, --not-user user
    指定したユーザのジョブを除くジョブをすべて表示します。本オプションは、 1 回のコマンド起動時に複数指定することが可能です。 この場合、指定しなかったユーザのジョブが全て表示されます。 なお、本オプションは、 -u や --user とは同時に指定してはいけません。

-c command, --command command
    指定したコマンドの実行を要求するジョブをすべて表示します。 command を ALL と指定した場合、すべての (単なる uucp ファイル転送ではない) コマンドの実行を要求するジョブ を表示します。本オプションは、1回のコマンド起動時に複数指定することが 可能です。 この場合、指定したコマンドの実行を要求するジョブが全て表示されます。

-C command, --not-command command
    指定したコマンド以外の実行を要求するジョブをすべて表示します。 command が ALL と指定した場合、 単なる uucp ファイル転送要求がすべて表示されます。 本オプションは、1 回のコマンド起動時に複数指定することが 可能です。 この場合、指定したコマンドの実行を要求しないジョブが全て表示されます。 なお、本オプションは、 -c や --command と同時に指定してはいけません。

-o hours, --older-than hours
    キューイングされてから指定した時間 (単位: 時間) 以上超過した ジョブを全て表示します。 --list オプションと共に指定した場合は、 そのシステムに関するもっとも古いジョブが、指定した時間より 古いという条件を満たすシステムの名前だけを表示します。

-y hours, --younger-than hours
    キューイングされてから経過した時間が指定した時間 (単位: 時間) を 超過していないジョブを全て表示します。 --list オプションと共に指定した場合は、 そのシステムに関するもっとも古いジョブが指定した時間より 新しいという条件を満たすシステムの名前だけを表示します。

-k jobid, --kill jobid
    指定したジョブを削除します。 ジョブ id は、デフォルトの出力結果から取得可能です。また、 uucp (1) や uux (1)にて -j や --jobid オプションを付加して実行することで、 当該ジョブのジョブ id を取得することも出来ます。 ジョブの削除を行なうことが出来るのは、ジョブを要求したユーザ、UUCP システム管理者、もしくはスーパユーザです。 -k や --kill オプションは、1回のコマンド実行で複数回指定することが可能です。

-r jobid, --rejuvenate jobid
    指定したジョブのジョブ時刻を、本コマンドを起動した時刻に変更します。 このことにより、 -o, --older-than, -y, --younger-than の各オプションの出力結果に影響が出ます。 このオプションの使用により、 クリーンアップデーモンにより削除されるのを免れることができます。 ジョブ id は、デフォルトの出力結果から取得可能 です。また、 uucp (1) や uux (1)にて -j や --jobid オプションを付加して実行することで、当該ジョブのジョブ id を取得する ことも出来ます。 本操作を行なうことが出来るのは、ジョブを要求したユーザ、UUCP システム管理者、 もしくはスーパユーザです。 -r や --rejuvenate オプションは、1回のコマンド実行で複数回指定することが可能です。

-q, --list
    要求がキューイングされている全てのリモートシステムに対する要求の ステータス、そして対話のステータスを表示します。 -s, --system, -S, --not-system, -o, --older-than, -y, --younger-than の各オプションはシステムの表示を制限するために用います。 要求がキューイングされていないシステムは表示されません。

-m, --status
    すべてのリモートシステムとの対話のステータスを表示します。

-p, --ps
    UUCP ロックまたはポートを保持するすべての処理のステータスを表示します。

-i, --prompt
    各ジョブについて、削除するかどうかを問い合わせるよう指示します。その 問い合わせに対してユーザが y もしくは Y を先頭に含む文字列を入力した場合 (y もしくは Y だけでも)、そのジョブ は削除されます。

-K, --kill-all
    各ジョブを自動的に削除します。本機能は、 --mail や --notify オプションと組み合わせて使用することで、自動メンテナンスを行なう スクリプトを作成するのに役立ちます。

-R, --rejuvenate-all
    指定したジョブを自動的に若返らせます。本オプションは --kill-all と同時に指定できません。

-M, --mail
    各ジョブについて、UUCP システム管理者に対してメールを送ります。もし ジョブが ( --kill-all や --prompt を用いることで) 削除された場合、その旨がメールに明記されます。 --comment オプションで指定したコメントについても、そのメールの中に含まれます。 ジョブが実行された場合、標準入力から入力された最初の部分がメールの メッセージに含まれます。 メールに含まれる行数は、 --mail-lines オプションで設定可能です (デフォルトでは 100 行です)。 標準入力からの入力データが NULL キャラクタを含む場合、そのファイルはバイナリ ファイルであるとみなされ、メールには含まれません。

-N, --notify
    各ジョブについて、要求を行なったユーザに対してメールを送ります。メール の内容については、 -M や --mail オプションで説明したものと同一です。

-W comment, --comment comment
    -M, --mail, -N, --notify の各オプションでメールを送る際に、そのメールに含めるコメントを指定します。

-B lines, --mail-lines lines
    -M, --mail, -N, --notify のいずれかのオプションで、 標準入力を用いるコマンドを実行するジョブの結果をメールで送るように 指定している場合、メールに含める標準入力の行数を指定します。 デフォルトは 100 行です。

-Q, --no-list
    -i, --prompt, -K, --kill-all, -M, --mail, -N --notify オプションと同時に使用します。ジョブの表示を行なわず、 指定した動作のみ行います。

-x type, --debug type
    特定のデバッグタイプを指定します。タイプとしては、abnormal, chat, handshake, uucp-proto, proto, port, config, spooldir, execute, incoming, outgoing がありますが、 uustat では、abnormal, config, spooldir ,execute のみが意味を持ちます。 本オプションでは、 コンマで区切ることで複数のデバッグタイプが指定可能です。そして、 --debug オプションは、1 回のコマンド起動で複数回指定可能です。 また、タイプとして数字を指定することも可能です。例えば、 --debug 2 という指定は、 --debug abnormal,chat と同じ意味です。

-I file, --config file
    使用する設定ファイルの指定を行ないます。ただし、本オプションは、本コマンドの コンパイル条件によっては使用できないことがあります。

-v, --version
    バージョン情報を表示します。実行は行ないません。

--help
    ヘルプメッセージを表示します。実行は行ないません。

使用例
uustat --all
全てのジョブのステータスを表示します。出力例を以下に示します。
bugsA027h bugs ian 04-01 13:50 Executing rmail ian@airs.com (sending 1283 bytes)
フォーマットは、以下の通りです。
jobid system user queue-date command (size)
ジョブ id は、 --kill もしくは --rejuvenate オプションで主に使用します。 size は、リモートシステムにどれだけのデータが転送されるかを示します。 また、ファイル受信要求の場合は表示されません。 --system, --not-system, --user, --not-user, --command, --not-command, --older-than, --younger-than オプションは、ジョブの表示制御のために用いられます。
uustat --executions
キューイングされたコマンド実行ジョブのステータスを表示します。出力 例を以下に示します。
bugs bugs!ian 05-20 12:51 rmail ian
フォーマットは以下の通りです。
system requestor queue-date command
--system, --not-system, --user, --not-user, --command, --not-command, --older-than, --younger-than オプションは、ジョブの表示制御のために用いられます。
uustat --list
全てのシステムについてキューイングされたコマンドのステータスを表示します。 以下に出力例を示します。
bugs            4C (1 hour)   0X (0 secs) 04-01 14:45 Dial failed
システム、キューイングされたコマンド数、 もっとも古いコマンドがキューイングされてからの時間、 キューイングされたローカル実行数と もっとも古いコマンドがローカル実行キューイングされてからの時間、 最後の対話の日時とステータスが表示されています。
uustat --status
全てのリモートシステムについて対話のステータスを表示します。出力例を以下に 示します。
bugs           04-01 15:51 Conversation complete
システム、最後の対話の日時とステータスが示されています。最後の対話が失敗した 場合、 uustat はシステムを呼び出そうとした回数を表示します。 次のリトライ間隔までシステムを呼び出せないときには uustat は次にコールできる時刻を表示します。
uustat --ps
UUCP ロックしている全てのプロセスのステータスを表示します。 uustat は単にロックしている各プロセス上で ps (1) を起動するだけなので、出力書式はシステムにより異なります。
uustat --command rmail --older-than 168 --kill-all --no-list --mail --notify --comment "Queued for over 1 week"
これは 1 週間 (168 時間) 以上配送待ちになっているキューイングされている全ての rmail コマンドの実行を取り止めます。各コマンドに対し、UUCP 管理者と rmail の実行を 要求したユーザの双方にメールが送られます。メールには --comment オプションで指定した文字列が含まれています。 --no-list オプションはジョブの出力を端末に出力しません。このときプログラムから出力される のはエラーメッセージだけです。

関連ファイル
関連ファイル名は、コンパイル時の指定により変化します。以下に挙げるものは、 一例です。
/usr/lib/uucp/config - 初期化ファイル
/usr/spool/uucp - UUCP スプールディレクトリ

関連項目
ps(1), rmail(8), uucp(1), uux(1), uucico(8), uuxqt(8)

作者
Ian Lance Taylor (ian@airs.com)