Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 con-
				       tracts,	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 sepa-
				       rated 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 sepa-
				       rated 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 ab-
					   normally 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
					   contract  was  abandoned   by   its
					   owner.

				       dead

					   The	contract  is no	longer active.
					   It is removed from the system auto-
					   matically 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 in-
				       herited	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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | OUTPUT | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ctstat&sektion=1&manpath=SunOS+5.10>

home | help