1 fs debug AFS Commands fs debug
6 fs debug -- enable/disable Cache Manager debugging trace.
9 fs debug -debug <'on' or 'off'> [-dafs <afs debug level>]
10 [-dnet <network debug level>] [-syslog] [-help]
12 ACCEPTABLE ABBREVIATIONS/ALIASES
14 fs de -de <on> or <off> [-da <afs debug level>]
15 [-dn <network debug level>] [-s] [-h]
19 Determines whether the Cache Manager records information
20 about its activities that may prove helpful in debugging or
21 other trouble-shooting. The output goes into the file
22 /usr/vice/etc/AFSLog (unless an alternate directory or name
23 is specified for the file with the -logfile switch of the
24 afsd command). See the ARGUMENTS section for information
25 about the different types of debugging output that can be
28 You can use the more command (or an equivalent command such
29 as the pg command on AIX systems) to read the debugging
30 output recorded in the AFSLog file. You must be logged in
31 as root on the machine on which the AFSLog file resides to
32 read the file. Interpreting the output requires familiarity
33 with the AFS source code.
38 controls whether debugging information is produced.
39 The legal values are on, which directs debugging
40 information into the AFSLog file, and off, which stops
41 the recording of information in the file.
43 -dafs determines the types of debugging information the
44 Cache Manager produces about its activities. The
45 following list describes the legal values for this
46 switch and the type of debugging output each causes
47 the Cache Manager to write to the AFSLog file:
49 - 1, which causes the Cache Manager to write
50 standard debugging information. Using this
51 value provides a good deal of general
54 - 2, which causes the Cache Manager to write
55 low-level debugging information about the
56 AFS network. Use this value only if you are
57 convinced that network problems exist.
59 - 4, which causes the Cache Manager to write
60 debugging information about the RX protocol.
62 - 8, which causes the Cache Manager to write
63 debugging information about the interface
64 layer to AFS. This value is not useful on
68 machines running a Sun operating system.
70 In addition, if a value of 1, 4, or 8 is specified,
71 the Cache Manager also records in the AFSLog file the
72 AFS UID of each user who accesses data from a file
73 server machine. It records the appropriate AFS UID
74 with each operation that accesses data.
76 The legal values can be added to specify different
77 combinations of output. For example, a value of 15
78 specifies that all possible types of output are to be
79 provided. The default value of 1 is used if no value
82 Note: The AFSLog file also records the type of volume
83 (ReadWrite, ReadOnly, or Backup) accessed from a file
84 server machine. The type of the volume is displayed
85 along with the volumeID in the "state" flag in bitmap
86 form. If a ReadWrite volume is accessed, the bits are
87 clear; if a ReadOnly volume is accessed, the 1 bit is
88 set; if a Backup volume is accessed, the 4 bit is set.
90 -dnet is not currently implemented and should not be used.
93 specifies that debugging output is to be redirected to
94 the syslogd daemon. This flag can be used only on
95 machines running Sun OS 4.1 or higher.
99 The following turns on debugging using the default debugging