NAME¶

fs_trace - Enable or disable AFS Cache Manager tracing

SYNOPSIS¶

fs trace [-on|-off] [-reset] [-dump]

DESCRIPTION¶

This command enables or disables AFS Cache Manager tracing, resets the trace log, or dumps the log. When you dump the log, two files are created in the Windows Temporary directory: afs-buffer.log and afsd.log. Any existing files with those names will be replaced.

CAUTIONS¶

This command is only available on Windows.

OPTIONS¶

Any combination of the following options may be specified, except that both -on and -off cannot be specified at the same time.

-on

Turn tracing on.

-off

Turn tracing off.

-reset

Resets the tracing information, discarding any trace-information collected up to this time.

-dump

Creates a dump file containing the trace information.

OUTPUT¶

If successful, the output of this command (for any option) will be:

   AFS tracing enabled

If unsuccessful:

   AFS tracing disabled

EXAMPLES¶

The following command starts tracing:

   % fs trace -on

The following dumps the current contents and resets the trace log, then turns tracing off:

   % fs trace -dump -reset -off

PRIVILEGE REQUIRED¶

The issuer must be have AFS Client Administrator access to issue this command.

SEE ALSO¶

fs(1)

COPYRIGHT¶

Copyright 2008. This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Mike Robinson (mike@endpoint.com) for OpenAFS.