ctwatch(1) [xfree86 man page]
ctwatch(1) User Commands ctwatch(1) NAME
ctwatch - watch events in a contract or group of contracts SYNOPSIS
/usr/bin/ctwatch [-f] [-r] [-v] contract-type... | contract-id... DESCRIPTION
The ctwatch utility allows a user to observe the events occurring within a set of contracts or contract types. By default, ctwatch watches all contracts. OPTIONS
The following options are supported: -f Report events starting at the front of the event queue. Normally, ctwatch reports only events which occur after it has been invoked. With the -f option, any events that still exist in the contracts' event queues when ctwatch is invoked (for example, unacknowledged critical events) are also reported. -r Reliably watches all messages. Normally, the system may drop informative events and acknowledged critical events at any time, so ctwatch isn't guaranteed to see them all. This option may only be used if the ctwatch is invoked with the {PRIV_CONTRACT_EVENT} privilege asserted in its effective set. -v Request verbose event descriptions. OPERANDS
The following operands are supported: contract-type Valid contract types are: process Process contracts. contract-id A valid contract id. OUTPUT
The following list defines the column headings and the meanings of a ctwatch report: CTID The contract ID generating the event. EVID The event ID. CRIT Whether the event is informative, critical, or initiates an exit negotiation. Values are info, crit, or neg, respectively. ACK The event has been acknowledged. Values are yes or "no". CTTYPE The contract type. SUMMARY A type-specific summary of the event. EXAMPLES
Example 1: Watching a process contract 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 EXIT STATUS
The following exit values are returned: 0 Successful completion. 1 An error occurred. 2 Invalid arguments. FILES
/system/contract/* ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Interface Stability |See below. | +-----------------------------+-----------------------------+ Human Readable Output is Unstable. Invocation is Evolving. SEE ALSO
ctrun(1), ctstat(1), contract(4), process(4), attributes(5), privileges(5) NOTES
Ordering of events is only guaranteed within a single contract, or within a single type when a type is specified. ctwatch can only observe those events which are generated by contracts owned or authored by processes with the same effective user ID as ctwatch, unless the {PRIV_CONTRACT_OBSERVER} privilege is asserted in its effective set. SunOS 5.10 14 Jul 2004 ctwatch(1)
Check Out this Related Man Page
ctwatch(1) User Commands ctwatch(1) NAME
ctwatch - watch events in a contract or group of contracts SYNOPSIS
/usr/bin/ctwatch [-f] [-r] [-v] contract-type... | contract-id... DESCRIPTION
The ctwatch utility allows a user to observe the events occurring within a set of contracts or contract types. By default, ctwatch watches all contracts. OPTIONS
The following options are supported: -f Report events starting at the front of the event queue. Normally, ctwatch reports only events which occur after it has been invoked. With the -f option, any events that still exist in the contracts' event queues when ctwatch is invoked (for example, unacknowledged critical events) are also reported. -r Reliably watches all messages. Normally, the system may drop informative events and acknowledged critical events at any time, so ctwatch isn't guaranteed to see them all. This option may only be used if the ctwatch is invoked with the {PRIV_CONTRACT_EVENT} privilege asserted in its effective set. -v Request verbose event descriptions. OPERANDS
The following operands are supported: contract-type Valid contract types are: process Process contracts. contract-id A valid contract id. OUTPUT
The following list defines the column headings and the meanings of a ctwatch report: CTID The contract ID generating the event. EVID The event ID. CRIT Whether the event is informative, critical, or initiates an exit negotiation. Values are info, crit, or neg, respectively. ACK The event has been acknowledged. Values are yes or "no". CTTYPE The contract type. SUMMARY A type-specific summary of the event. EXAMPLES
Example 1: Watching a process contract 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 EXIT STATUS
The following exit values are returned: 0 Successful completion. 1 An error occurred. 2 Invalid arguments. FILES
/system/contract/* ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Interface Stability |See below. | +-----------------------------+-----------------------------+ Human Readable Output is Unstable. Invocation is Evolving. SEE ALSO
ctrun(1), ctstat(1), contract(4), process(4), attributes(5), privileges(5) NOTES
Ordering of events is only guaranteed within a single contract, or within a single type when a type is specified. ctwatch can only observe those events which are generated by contracts owned or authored by processes with the same effective user ID as ctwatch, unless the {PRIV_CONTRACT_OBSERVER} privilege is asserted in its effective set. SunOS 5.10 14 Jul 2004 ctwatch(1)