RTMON-RUN(1)							  RTMON-RUN(1)

NAME    [Toc]    [Back]

     rtmon-run - enable	system call event tracing

SYNOPSIS    [Toc]    [Back]

     rtmon-run -c cookie [ -i ]	[ -p pid ] [ -t	secs ]

DESCRIPTION    [Toc]    [Back]

     rtmon-run is used in conjuction with rtmon-client(1) to collect system
     call and context switch events from a remote machine.  rtmon-run marks
     one or more processes for system call and context switch event tracing
     and then pauses waiting for an interrupt or a time	limit to expire.  If
     no	processes are specified	on the command line, the entire	system is
     monitored.	 Event collection must be done separately; typically from
     another machine with the rtmon-client application.	 rtmon-run must	be run
     on	the machine where the processes	to be traced are located because it
     must access the /dev/par special file to enable system call and context
     switch tracing for	the processes.	rtmon-run is normally not needed; the
     par(1) and	padc(1)	programs are the preferred means for collecting	event
     traces.  The only reason to use rtmon-run instead of padc is to avoid any
     overhead associated with running padc on the system where data is to be
     collected.

OPTIONS    [Toc]    [Back]

     -c	cookie
	  Use cookie when enabling system call tracing for the specified
	  processes.  A	cookie is a magic number that is used by rtmond(1) to
	  determine which client programs may receive system call event	data.
	  The cookie to	pass to	rtmon-run is obtained by specifying the	-v
	  option when starting rtmon-client(1).	 The rtmon-client program must
	  be started before running rtmon-run in order to obtain a valid
	  cookie to supply as a	parameter to the -c option.

     -i	  Inherit system call event tracing to future children of the
	  specified processes.

     -r	  This option marks the	specified processes for	collection of context
	  switch events.  If no	processes are specified, all processes which
	  you have access privileges will be marked.  This option is really
	  only useful when used	with the taskproc event	mask class of rtmon-
	  client since the task	event class can	be used	collect	context	switch
	  events for all execution threads without the use of rtmon-run.

     -s	  This option marks the	specified processes for	collection of system
	  call events.	Since this is the default it serves the	sole purpose
	  of preventing	needless complaints from rtmon-run when	a user
	  absent-mindedly types	in -s while thinking in	terms of padc/par...

     -p	pid
	  Enable system	call tracing for the process pid.  This	option may be
	  used multiple	times to enable	tracing	of multiple processes.
	  Processes specified with this	option must belong to the current user
	  unless the user has super-user privilege.



									Page 1






RTMON-RUN(1)							  RTMON-RUN(1)



     -t	secs
	  Collect tracing information for secs seconds before terminating.  If
	  this option is not specified then rtmon-run will pause until it is
	  interrupted from the keyboard	or by receiving	a signal.

FILES    [Toc]    [Back]

     /dev/par	 for enabling system event tracing

SEE ALSO    [Toc]    [Back]

     par(1), padc(1), rtmon-client(1), rtmond(1), par(7).


									PPPPaaaaggggeeee 2222