diff options
Diffstat (limited to 'doc/scsi_logging_level.8')
-rw-r--r-- | doc/scsi_logging_level.8 | 128 |
1 files changed, 128 insertions, 0 deletions
diff --git a/doc/scsi_logging_level.8 b/doc/scsi_logging_level.8 new file mode 100644 index 00000000..57a5cf4b --- /dev/null +++ b/doc/scsi_logging_level.8 @@ -0,0 +1,128 @@ +.TH SCSI_LOGGING_LEVEL "8" "April 2022" "sg3_utils\-1.48" SG3_UTILS +.SH NAME +scsi_logging_level \- access Linux SCSI logging level information +.SH SYNOPSIS +.B scsi_logging_level +[\fI\-\-all=LEV\fR] [\fI\-\-create\fR] [\fI\-\-error=LEV\fR] [\fI\-\-get\fR] +[\fI\-\-help\fR] [\fI\-\-highlevel=LEV\fR] [\fI\-\-hlcomplete=LEV\fR] +[\fI\-\-hlqueue=LEV\fR] [\fI\-\-ioctl=LEV\fR] [\fI\-\-llcomplete=LEV\fR] +[\fI\-\-llqueue=LEV\fR] [\fI\-\-lowlevel=LEV\fR] [\fI\-\-midlevel=LEV\fR] +[\fI\-\-mlcomplete=LEV\fR] [\fI\-\-mlqueue=LEV\fR] [\fI\-\-scan=LEV\fR] +[\fI\-\-set\fR] [\fI\-\-timeout=LEV\fR] [\fI\-\-version\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +This bash shell script accesses the Linux SCSI subsystem logging +level. The current values can be shown (e.g. with \fI\-\-get\fR) +or changed (e.g. with \fI\-\-set\fR). Superuser permissions will +typically be required to set the logging level. +.PP +One of these options: \fI\-\-create\fR, \fI\-\-get\fR or \fI\-\-set\fR +is required. Only one of them can be given. +.SH OPTIONS +Arguments to long options are mandatory for short options as well. +.TP +\fB\-a\fR, \fB\-\-all\fR=\fILEV\fR +\fILEV\fR is used for all SCSI_LOG fields. +.TP +\fB\-c\fR, \fB\-\-create\fR +Options are parsed and placed in internal fields that are displayed but +no logging levels are changed within the Linux kernel. +.TP +\fB\-E\fR, \fB\-\-error\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_ERROR field. +.TP +\fB\-g\fR, \fB\-\-get\fR +Fetches the current SCSI logging levels from the Linux kernel and +displays them. +.TP +\fB\-h\fR, \fB\-\-help\fR +print out the usage message then exit. +.TP +\fB\-H\fR, \fB\-\-highlevel\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_HLQUEUE and SCSI_LOG_HLCOMPLETE fields. +.TP +\fB\-\-hlcomplete\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_HLCOMPLETE field. +.TP +\fB\-\-hlqueue\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_HLQUEUE field. +.TP +\fB\-I\fR, \fB\-\-ioctl\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_IOCTL field. +.TP +\fB\-\-llcomplete\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_LLCOMPLETE field. +.TP +\fB\-\-llqueue\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_LLQUEUE field. +.TP +\fB\-L\fR, \fB\-\-lowlevel\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_LLQUEUE and SCSI_LOG_LLCOMPLETE fields. +.TP +\fB\-M\fR, \fB\-\-midlevel\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_MLQUEUE and SCSI_LOG_MLCOMPLETE fields. +.TP +\fB\-\-mlcomplete\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_MLCOMPLETE field. +.TP +\fB\-\-mlqueue\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_MLQUEUE field. +.TP +\fB\-S\fR, \fB\-\-scan\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_SCAN field. +.TP +\fB\-s\fR, \fB\-\-set\fR +Uses the fields specified in this command's options and attempts to +apply them to the Linux SCSI subsystem logging levels. Typically superuser +permissions will be required to do this. +.TP +\fB\-T\fR, \fB\-\-timeout\fR=\fILEV\fR +\fILEV\fR is placed in the SCSI_LOG_TIMEOUT field. +.TP +\fB\-v\fR, \fB\-\-version\fR +Outputs the version information and then exits. +.SH NOTES +The \fI\-\-get\fR and \fI\-\-set\fR options access the +/proc/sys/dev/scsi/logging_level pseudo file. +.SH EXIT STATUS +The exit status of this script is 0 when it is successful. Any other +exit status indicates that an error has occurred. +.SH EXAMPLES +The following will set SCSI_LOG_ERROR to level 5 in the Linux kernel. It +requires root permissions: +.PP + scsi_logging_level \-s \-E 5 +.PP +So as to not interfere with other SCSI subsystem upper level drivers (ULDs) +which most likely will be active at the same time, the Linux sg driver uses +SCSI_LOG_TIMEOUT for logging purposes. To see full debugging and trace from +the sg driver use: +.PP + scsi_logging_level \-s \-T 7 +.PP +The output from the sg driver caused by this will go to the system +logs (e.g. /var/log/syslog). To reduce the amount of output use a number +lower than 7. Using 0 will turn off the tracing and debug. +.PP +To turn on maximum SCSI subsystem logging use: +.PP + scsi_logging_level \-s \-a 7 +.PP +That is probably best done on a system that does not use a SCSI command +device to hold the root file system, or the file system that holds the +system log. Note that SATA disks and USB attached storage nearly always +use the SCSI subsystem. +.SH AUTHORS +Written by IBM. Small alterations by Douglas Gilbert. +.SH "REPORTING BUGS" +Report bugs to <dgilbert at interlog dot com>. +.SH COPYRIGHT +Copyright \(co IBM Corp. 2006 +.br +This software is distributed under the GPL version 2. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.PP +The software was obtained from an IBM package called s390\-tools\-1.6.2 +found on that company's "developerworks" site. The most recent version of +that package at this time is 1.8.3 . |