Content-type: text/html
Manpage of AGENT
AGENT
Section: Maintenance Commands (8) Updated: Feb 10, 1992 Return to Library's README
NAME
agent -- dfstrace client side data collector
SYNOPSIS
agent [ -v ] [ -l level ] [ -b bufsiz ] [ -h host ] [ -r RPC2 debug level ] [ -s sleeptime ]
DESCRIPTION
Agent is a program that reads blocks of trace data generated by
dfstrace from the kernel. Data is buffered in fixed size memory
buffers, then shipped to one of a small number of collection servers.
Agent must run as root; it is typically started from /etc/rc.local at
boot time. In addition to the switches below, agent responds to
signals SIGURG (flush data to server), SIGTERM (flush data and shut
down), SIGALRM (start a new file on the server), SIGEMT (turn RPC2
debugging up), and SIGIOT (turn RPC2 debugging off).
OPTIONS
-
-b bufsize
Set the buffer size to bufsize kbytes. Agent uses two of these
buffers. Default is 500 kbytes.
-
-h host
Send data to a collection server on host. Default is britten.coda.cs.cmu.edu.
-
-l level
Sets trace level to trace basic file system calls, name
resolution operations, and/or reads and writes. Default is
system calls and name resolution.
-
-r num
Set RPC2 debug level to num.
-
-s sleeptime
Sleep sleeptime seconds before starting to read data. Useful
for avoiding certain boot time processes, such as cache scans.
Default is no sleep.
-
-v
Verbose mode. Among other things,
prints a message on every read from the kernel.
DIAGNOSTICS
The following are frequently encountered errors:
``can't open /dev/dfstrace''. Either /dev/dfstrace doesn't
exist, or the program isn't being run as root.
``kernel vars not found''. You are probably not running
a tracing kernel.
``can't open /dev/kmem''. Program isn't running as root.
SEE ALSO
collector, traceinfo, tracelevel
BUGS
Agent should check to see if another agent is running
when it's started.
AUTHOR
Lily B. Mummert
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- DIAGNOSTICS
-
- SEE ALSO
-
- BUGS
-
- AUTHOR
-
This document was created on
Time: 05:25:53 GMT, October 10, 1998