NAME

fs_trace - Enable or disable Auristor Cache Manager tracing [Windows only]

SYNOPSIS

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

DESCRIPTION

This command enables or disables 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. For UNIX see the fstrace command.

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:

   Cache Manager tracing enabled

If unsuccessful:

   Cache Manager 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 Auristor Client Administrator access to issue this command.

SEE ALSO

fs(1), fstrace(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.

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.