Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FSTRACE(8)		     AFS Command Reference		    FSTRACE(8)

NAME
       fstrace - Introduction to the fstrace command suite

DESCRIPTION
       The commands in the fstrace command suite are the interface that	system
       administrators employ to	trace Cache Manager operations for debugging
       purposes. Examples of Cache Manager operations are fetching file	data
       or the status information used to produce output	for the	UNIX ls
       command.

       The fstrace command interpreter defines an extensive set	of Cache
       Manager operations as the "cm" event set.  When the event set is
       activated, the Cache Manager writes a message to	the "cmfx" trace log
       in kernel memory	each time it performs one of the defined operations.
       The log expands only to a defined size (by default, 60 KB), after which
       it is overwritten in a circular fashion (new trace messages overwrite
       the oldest ones). If an operation of particular interest	occurs,	the
       administrator can afterward display the log on the standard output
       stream or write it to a file for	later study. For more specific
       procedural instructions,	see the	OpenAFS	Administration Guide.

       There are several categories of commands	in the fstrace command suite:

       o   Commands to administer or display information about the trace log:
	   fstrace clear, fstrace lslog, and fstrace setlog.

       o   Commands to set or display the status of the	event set: fstrace
	   lsset and fstrace setset.

       o   A command to	display	the contents of	the trace log: fstrace dump.

       o   Commands to obtain help: fstrace apropos and	fstrace	help.

OPTIONS
       All fstrace commands accept the following optional flag.	 It is listed
       in the command descriptions and described in detail here:

       -help
	   Prints a command's online help message on the standard output
	   stream. Do not combine this flag with any of	the command's other
	   options; when it is provided, the command interpreter ignores all
	   other options, and only prints the help message.

PRIVILEGE REQUIRED
       To issue	most fstrace commands, the issuer must be logged on as the
       local superuser "root" on the machine that is generating	the trace log.

SEE ALSO
       fstrace_apropos(8), fstrace_clear(8), fstrace_dump(8), fstrace_help(8),
       fstrace_lslog(8), fstrace_lsset(8), fstrace_setlog(8),
       fstrace_setset(8)

COPYRIGHT
       IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

       This documentation is covered by	the IBM	Public License Version 1.0.
       It was converted	from HTML to POD by software written by	Chas Williams
       and Russ	Allbery, based on work by Alf Wachsmann	and Elizabeth Cassell.

OpenAFS				  2016-12-14			    FSTRACE(8)

NAME | DESCRIPTION | OPTIONS | PRIVILEGE REQUIRED | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fstrace&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help