HP CIFS Server 3.0f Administrator's Guide verison A.02.03

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.
152 CIFS File System Module (CFSM) Support