RTMON-RUN(1)RTMON-RUN(1)NAMErtmon-run - enable system call event tracing
SYNOPSISrtmon-run-c cookie [ -i ] [ -p pid ] [ -t secs ]
DESCRIPTIONrtmon-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-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
/dev/par for enabling system event tracing
SEE ALSOpar(1), padc(1), rtmon-client(1), rtmond(1), par(7).
Page 2
