HP CIFS Server 3.0k Administrator's Guide version A.02.04

CFSM Tracing
The CIFS File System Module provides diagnostic functionality to trace the CFSM activities by
sending trace messages to a log file. All of CFSM tracing are controlled through the cfsmutil
command.
NOTE: If the CIFS File System Module is not used by any file systems then it will not be loaded,
cfsmutil will not function, except for the help (-h) option.
cfsmutil Command
Use the cfsmutil command to control and retrieve various CIFS File System Module tracing
parameters.
Syntax
cfsmutil [option]
where option can be any of the following:
-i
Displays the current parameters and trace state. The parameters
displayed are:
CFSM Tracing on/off
CFSM Tracing level
CFSM Tracing file name
CFSM Tracing file maximum size
-s
Enables the CFSM tracing.
-k
Disables the CFSM tracing.
-l <level>
Sets the CFSM trace level. The minimum is 0, the maximum is 8. Setting
to 0 corresponds to no tracing. The default level is 0. Trace level 1
corresponds to minimal tracing, only crucial, major events are logged.
Trace level 8 corresponds to maximum tracing.
-f <filename> Sets the trace filename. The default is /var/opt/samba/log/
cfsmtrace.log.
-m <filemaxsize>
Sets maximum size of the trace file in megabytes. The defaults value
is 1.
NOTE: To use the —m option, you must disable CFSM tracing.
-h
Displays help text.
For detailed information on how to use this command, refer to the cfsmutil man page.
The trace level, tracing log file name and maximum tracing log file size settings are all persistent
across reboots.
The trace messages may be useful to understand the actions CFSM takes to enforce the CIFS
client file locks, and HP support engineers may need this data to diagnose problems. However,
enabling CFSM tracing will greatly reduce the performance of any file system using CFSM.
Hence, it is best to leave tracing turned off, unless it is needed to diagnose a suspected problem.
NOTE: The CFSM trace level setting is persistent across reboots. If the CFSM trace level is
non-zero when CFSM is loaded, then tracing will automatically be turned on. This allows trace
messages to be logged while file systems are mounted at boot time. Therefore the trace level
should be kept at 0, otherwise tracing will be automatically turned on when booting the system.
CFSM Tracing 167