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

FreeBSD Manual Pages

  
 
  

home | help
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  ct-
       watch, unless the {PRIV_CONTRACT_OBSERVER} privilege is asserted	in its
       effective set.

SunOS 5.10			  14 Jul 2004			    ctwatch(1)

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

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

home | help