unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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. Nor-
                mally, 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_CON-
                TRACT_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  initi-
                       ates  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:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE   VALUE   AvailabilitySUNWcsu
       Interface StabilitySee below.


       Human Readable Output is Unstable. Invocation is Evolving.

SEE ALSO
       ctrun(1),  ctstat(1),  contract(4),  process(4),  attributes(5), privi-
       leges(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)