👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for ctwatch (opensolaris section 1)

ctwatch(1)				  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 con-
       tracts 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  exam-
	     ple, unacknowledged 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 {PRIV_CON-
	     TRACT_EVENT} 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 meanings of a ctwatch report:

       CTID	  The contract ID generating the event.

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

       CTTYPE	  The contract type.

       SUMMARY	  A type-specific summary of the event.

EXAMPLES
       Example 1 Watching a process contract

	 example% ctwatch -r 1

	 CTID	 EVID	 CRIT ACK CTTYPE  SUMMARY
	 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/*

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), ctstat(1), contract(4), process(4), attributes(5), privileges(5)

NOTES
       Ordering  of  events  is only guaranteed within a single contract, 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  {PRIV_CON-
       TRACT_OBSERVER} privilege is asserted in its effective set.

SunOS 5.11				   14 Jul 2004				       ctwatch(1)


All times are GMT -4. The time now is 01:34 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password