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,  unack-
           nowledged 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  {PRIVCONTRACTEVENT}  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 mean-
     ings of a ctwatch report:

     CTID       The contract ID generating the event.




SunOS 5.11          Last change: 14 Jul 2004                    1






User Commands                                          ctwatch(1)



     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".


     CTYPE     The contract type.


     SUMARY    A type-specific summary of the event.


EXAMPLES
     Example 1 Watching a process contract

       example% ctwatch -r 1

       CTID    EVID    CRIT ACK CTYPE  SUMARY
       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/*

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:





SunOS 5.11          Last change: 14 Jul 2004                    2






User Commands                                          ctwatch(1)



     
           ATRIBUTE TYPE               ATRIBUTE 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  con-
     tract, 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
     {PRIVCONTRACTOBSERVER} privilege is asserted in its effec-
     tive set.





























SunOS 5.11          Last change: 14 Jul 2004                    3