ctstat(1)                                                          User Commands                                                         ctstat(1)

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, this option only displays those contracts which are
                                       in the owned, inherited, or orphan states.

       -i contractid...                Request status on the specified contracts, identified by their numeric contract 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 meanings 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 abnormally and the contract has been inherited  by  the  owner's  process
                                           contract.

                                       orphan

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

                                       dead

                                           The contract is no longer active. It is removed from the system automatically 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 pending.

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

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

EXAMPLES

       Example 1: Reporting on all Contracts in the System

       The following example reports on all contracts in the system:

       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 contracts 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 attributes:

       +-----------------------------+-----------------------------+
       |      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)

SunOS 5.10                                                          15 Jul 2004                                                          ctstat(1)