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)