マニュアルページ セクション 1: ユーザーコマンド

ctwatch(1)

名前

ctwatch - 契約または契約のグループのイベントの監視

形式

/usr/bin/ctwatch [-f] [-r] [-v] contract-type... | contract-id...

説明

ctwatch ユーティリティーを使用すると、一連の契約または契約タイプ内で発生するイベントを監視できます。デフォルトでは、ctwatch はすべての契約を監視します。

オプション

サポートしているオプションは、次のとおりです。

–f

イベントキューの先頭からイベントを報告します。通常、ctwatch は自身が呼び出されたあとに発生したイベントのみを報告します。–f オプションを指定すると、ctwatch が呼び出されたときに契約のイベントキューにまだ存在しているイベント (たとえば、確認されていない重大なイベント) も報告されます。

–r

すべてのメッセージを確実に監視します。通常、システムは情報イベントおよび確認済みの重大なイベントを随時削除することがあるため、ctwatch ではそれらすべてが表示されることは保証されません。実効セットで {PRIV_CONTRACT_EVENT} 特権が表明されて ctwatch が呼び出された場合にのみ、このオプションを使用できます。

–v

詳細なイベントの説明を要求します。

オペランド

次のオペランドがサポートされています。

contract-type

有効な契約タイプは次のとおりです。

process

プロセス契約。

contract-id

有効な契約ID。

出力

次に、ctwatch の報告の列見出しとその意味について説明します。

CTID

イベントが生成された契約 ID。

EVID

イベント ID。

CRIT

イベントが情報と重大のいずれであるか、あるいは終了ネゴシエーションが開始されるかどうか。値はそれぞれ info、crit、または neg です。

ACK

イベントが確認されました。値は yes または「no」です。

CTTYPE

契約タイプ。

SUMMARY

タイプごとのイベントのサマリー。

例

使用例 1 プロセス契約の監視

example% ctwatch -r 1

CTID    EVID    CRIT ACK CTTYPE  SUMMARY
1       2       crit no  process pid 100569 was created
1       3       info no  process pid 100569 encountered hardware error
1       4       info no  process pid 100568 exited
1       5       info no  process pid 100569 exited
1       6       crit no  process contract empty

終了ステータス

次の終了ステータスが返されます。

0

正常終了。

1

エラーが発生しました。

2

無効な引数

ファイル

/system/contract/*

属性

属性についての詳細は、マニュアルページの attributes(7) を参照してください。

属性タイプ 属性値 使用条件 system/core-os インタフェースの安定性 下記を参照。

人間が読める形式の出力は「不確実」です。呼び出しは「確実」です。

関連項目

ctrun(1)、ctstat(1)、contract(5)、process(5)、attributes(7)、privileges(7)

注

タイプを指定した場合、イベントの順序は単一の契約または単一のタイプ内でのみ保証されます。

実効セットで {PRIV_CONTRACT_OBSERVER} 特権が表明されている場合を除き、ctwatch は ctwatch と同じ実効ユーザー ID のプロセスが所有または作成した契約によって生成されたイベントのみを監視できます。