Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

ctstat


NAME
     ctstat - display active system contracts

SYNOPSIS
     /usr/bin/ctstat [-a] [-i contractid...] [-t type...] [-v]
         [interval [count]]


DESCRIPTION
     The ctstat utility allows a user to  observe  the  contracts
     active on a system.

     Unless you specify the -i  or  -t  option,  ctstat  displays
     statistics on all contracts in the system.

OPTIONS
     The following options are supported:

     -a                  Display  all  contracts  regardless   of
                         state.  By default, only those contracts
                         which are in the  owned,  inherited,  or
                         orphan states are displayed.


     -i contractid...    Request status  on  the  specified  con-
                         tracts, identified by their numeric con-
                         tract identifier (contract_id).

                         This option accepts lists as arguments .
                         Items  in  the  list can be separated by
                         commas,  or  enclosed  in   quotes   and
                         separated by commas or spaces.


     -t type...          Request  status  on  contracts  of   the
                         specified type (type).

                         This option accepts lists as  arguments.
                         Items  in  the  list can be separated by
                         commas,  or  enclosed  in   quotes   and
                         separated by commas or spaces.

                         The following types are supported:

                         process    Process contracts



     -v                  Verbose output.



OPERANDS
     The following operands are supported:

     interval    Report once each interval seconds.


     count       Print only count reports.


OUTPUT
     The following list defines the column headings and the mean-
     ings of a ctstat report:

     CTID      The contract ID of the contract.


     ZONEID    The zone ID of the contract's creator.


     TYPE      The contract type.


     STATE     The state of the contract:

               owned        Contract is owned by a process.


               inherited    The contract owner has exited  abnor-
                            mally   and  the  contract  has  been
                            inherited by the owner's process con-
                            tract.


               orphan       The contract owner has abandoned  the
                            contract,  the  contract owner exited
                            abnormally and the contract  was  not
                            inherited by the owner's process con-
                            tract, or the process contract  which
                            had  inherited the contract was aban-
                            doned by its owner.


               dead         The contract is no longer active.  It
                            is  removed from the system automati-
                            cally when all references to it (open
                            file descriptors, contract templates,
                            and events) have been released.



     HOLDER    If the contract is in the owned state, the pid  of
               the   process  that  owns  the  contract.  If  the
               contract is in the inherited state, the id of  the
               regent process contract.


     EVENTS    The number of unacknowledged critical events pend-
               ing.


     QTIME     The time until quantum ends, or - if  no  negotia-
               tion is in progress.


     NTIME     The time until negotiation ends, or - if no  nego-
               tiation is in progress.


EXAMPLES
     Example 1 Reporting on all Contracts in the System

     The following example reports on all contracts in  the  sys-
     tem:


       example% ctstat -a

       CTID    TYPE    STATE   HOLDER  EVENTS  QTIME   NTIME
       1       process owned   100579  0       -       -
       2       process dead    -       1       -       -
       3       process inherit 1       3       -       -
       4       process orphan  -       0       -       -



     Example 2 Obtaining a Verbose Report of All Contracts in the
     System

     The following example obtains a verbose report of  all  con-
     tracts in the system:


       example% ctstat -av

       CTID    TYPE    STATE   HOLDER  EVENTS  QTIME   NTIME
       1       process owned   100579  0       -       -
              informative event set:  none
              critical event set:     hwerr core
              fatal event set:        hwerr
              parameter set:          none
              member processes:       100600 100601
              inherited ctids:        none
       2       process dead    -       1       -       -
              informative event set:  none
              critical event set:     none
              fatal event set:        hwerr core
              parameter set:          pgrponly
              member processes:       none
              inherited ctids:        none



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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | Interface Stability         | See below.                  |
    |_____________________________|_____________________________|


     Human Readable Output is Unstable. Invocation is Evolving.

SEE ALSO
     ctrun(1), ctwatch(1), contract(4), process(4), attributes(5)










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments