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