ctwatch man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

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	contracts  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. Nor‐
		mally, 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
		example, 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	initi‐
		       ates  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), privi‐
       leges(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_CONTRACT_OBSERVER} privilege is asserted in
       its effective set.

SunOS 5.10			  14 Jul 2004			    ctwatch(1)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net