# diff -c /tmp/oldmanpage.txt /tmp/newmanpage.txt *** /tmp/oldmanpage.txt Wed Sep 23 08:55:24 2009 --- /tmp/newmanpage.txt Wed Sep 23 08:54:18 2009 *************** *** 5,12 **** system and in applications SYNOPSIS ! latencytop [-o log file] [-k log-level] [-t interval] [-f] ! [-s] [-l log interval] [-h] DESCRIPTION LatencyTOP is an observability tool that reports statistics --- 5,12 ---- system and in applications SYNOPSIS ! latencytop [-t interval] [-o log-file] [-k log-level] [c config-file] ! [-f (no)feature,...] [-l log-interval] [-h] DESCRIPTION LatencyTOP is an observability tool that reports statistics *************** *** 45,56 **** OPTIONS The following options are supported: ! -o [log file] Specifies the log file where output will be written. The default log file is /var/log/latencytop.log. ! -k [log level] Specifies the level of logging in the log file. Valid values are: 0 = none (default), 1 = unknown, and 2 = all; --- 45,56 ---- OPTIONS The following options are supported: ! -o [log-file] Specifies the log file where output will be written. The default log file is /var/log/latencytop.log. ! -k [log-level] Specifies the level of logging in the log file. Valid values are: 0 = none (default), 1 = unknown, and 2 = all; *************** *** 61,74 **** collects statistics from the system. The possible values are between 1 and 60; the default is 5 seconds. ! -f ! Filter large interruptible latencies (e.g. sleep). ! -s ! Monitors the sched (PID=0) process for any latency. -l [log-interval] Writes data to the log file every log-interval seconds; --- 61,84 ---- collects statistics from the system. The possible values are between 1 and 60; the default is 5 seconds. ! -f, --feature [no]feature1,[no]feature2,... ! ! Enables/disables features in LatencyTOP. Features can only ! be one of the following : ! [no]filter: Filter large interruptible latencies, ! e.g. sleep. Default: off ! [no]sched: Monitors sched (PID=0). Default: off ! [no]sobj: Monitors synchronize objects. Default: on + [no]low: Lower overhead by sampling small latencies. + Enabling this feature will lower CPU utilization + by estimating small latencies statistically. + Use it for heavy workloads such as a very busy + web server. Default: off + -l [log-interval] Writes data to the log file every log-interval seconds; *************** *** 105,111 **** --- 115,129 ---- % latencytop -l 2 + Example 4 Enabling tracing of latencies caused by synchronization + objects. + The following command enables the tracing of latencies caused by + synchronization objects. + + % latencytop -f sobj + + EXIT STATUS 0 *************** *** 133,140 **** SEE ALSO kstat(1M), dtrace(1M) - Among non-SunOS man pages, xscreensaver(1), from the - OpenWindows man pages. - USAGE You must have DTrace privileges to run LatencyTOP. --- 151,155 ----