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)