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 events from a remote machine.  rtmon-run marks one or more processes
     for system call 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 tracing for the processes.  rtmon-run is normally not
     needed; the par(1) and padc(1) programs are the preferred means for
     collecting system call 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.

     -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).