RTMON-DUMP(1)RTMON-DUMP(1)NAMErtmon-dump - dump the contents of events collect from rtmond
SYNOPSISrtmon-dump [ options ] [ file ]
DESCRIPTIONrtmon-dump prints binary event data collected from an rtmond(1) server
process using rtmon-client(1) or padc(1). Data can be read from a file
or from the standard input. By default, rtmon-dump displays all
interesting events found in a file using the same format as par(1).
Various options are provided for filtering which events are printed and
how they are displayed.
OPTIONS-d usecs
Use usecs for the threshold for displaying system calls as begin and
end entries. By default, rtmon-dump will display system call events
as single line if there are no events to display between the start
and finish of the system call and if the duration of the system is
less than a nominal threshold (default 2 milliseconds). If a system
call takes longer than this threshold than it is displayed as
separate begin and end events so that it is easy to pick out long-
running calls.
-f Follow the growth of event data collected in a file. If a file is
specified on the command line and the -f option is specified, then
rtmon-dump will dump the contents of the file and then periodically
monitor it for new data. In this situation rtmon-dump will never
exit voluntarily; it must be terminated with an interrupt signal
(e.g. from a keyboard interrupt).
-i Display ``internal'' event as well as normal events. This option
causes the display of certain events that are normally used only in
decoding other events: CPU configuration, task names, process
execs, etc.
-K Display kernel thread IDs.
-k kthread-ID
Display only events for the specified thread. Events that do not
affect a specific thread will also be displayed.
-m event-mask
Display only events specified by event-mask. An event mask
specifies a set of events; it is a set of event classes with each
class specified symbolically as one of the following:
Name Description
all All events (default)
alloc Memory allocation
disk Disk i/o work
Page 1
RTMON-DUMP(1)RTMON-DUMP(1)
intr Hardware interrupts
io I/O-related events (disk+intr)
netflow Network I/O flow
netsched Network I/O scheduling
network Network-related events (netflow+netsched)
none No events
profile Kernel profiling
scheduler Process and thread scheduler
signal Signal delivery and reception
syscall System calls and their arguments
task Process and thread scheduling
taskproc Process scheduling (system threads are not included)
vm Virtual memory operation
Event class names are case insensitive; i.e. ``SIGNAL'' is
interpreted the same as ``signal''. Multiple event classes may be
included by using a ``+'', ``|'', or ``,'' symbol to separate the
names. Event classes may be excluded by using a ``-'' to separate
the name. For example, ``network+io-disk'' indicates all network
and i/o events should be included except for disk-related events.
In addition to the above names, a number may be used to specify a
value, where the various events are selected by bits in the value,
as defined in ``<sys/rtmon.h>''.
-O Print unrecognized event data in octal instead of decimal.
-x Print unrecognized event data in hexadecimal instead of decimal.
-p process-ID
Display only events for the specified process. Events that do not
affect a specific process will also be displayed. By default,
rtmon-dump displays events from all processes.
-R Display all times as raw times in terms of the absolute valued
system real-time clock values when they occured.
-r Display event decoding; display all events as raw data.
-u Display event times as milliseconds with a microsecond fraction and
show the number of microseconds between displayed events.
-v Enable verbose output.
SEE ALSOpadc(1), par(1), rtmond(1), rtmon_log_user_tstamp(3)
Page 2
