rtmon-run(1)

NAME
     rtmon-run - enable system call event tracing

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

DESCRIPTION
     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
     -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.
     -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 ALSO
     par(1), padc(1), rtmon-client(1), rtmond(1), par(7).