Content-type: text/html; charset=UTF-8
Man page of SCSI_LOGGING_LEVEL
SCSI_LOGGING_LEVEL
Section: SG3_UTILS (8)
Updated: September 2018
Index
Return to Main Contents
NAME
scsi_logging_level - access Linux SCSI logging level information
SYNOPSIS
scsi_logging_level
[--all=LEV] [--create] [--error=LEV] [--get]
[--help] [--highlevel=LEV] [--hlcomplete=LEV]
[--hlqueue=LEV] [--ioctl=LEV] [--llcomplete=LEV]
[--llqueue=LEV] [--lowlevel=LEV] [--midlevel=LEV]
[--mlcomplete=LEV] [--mlqueue=LEV] [--scan=LEV]
[--set] [--timeout=LEV] [--version]
DESCRIPTION
This bash shell script accesses the Linux SCSI subsystem logging
level. The current values can be shown (e.g. with --get)
or changed (e.g. with --set). Superuser permissions will
typically be required to set the logging level.
One of these options: --create, --get or --set
is required. Only one of them can be given.
OPTIONS
Arguments to long options are mandatory for short options as well.
- -a, --all=LEV
-
LEV is used for all SCSI_LOG fields.
- -c, --create
-
Options are parsed and placed in internal fields that are displayed but
no logging levels are changed within the Linux kernel.
- -E, --error=LEV
-
LEV is placed in the SCSI_LOG_ERROR field.
- -g, --get
-
Fetches the current SCSI logging levels from the Linux kernel and
displays them.
- -h, --help
-
print out the usage message then exit.
- -H, --highlevel=LEV
-
LEV is placed in the SCSI_LOG_HLQUEUE and SCSI_LOG_HLCOMPLETE fields.
- --hlcomplete=LEV
-
LEV is placed in the SCSI_LOG_HLCOMPLETE field.
- --hlqueue=LEV
-
LEV is placed in the SCSI_LOG_HLQUEUE field.
- -I, --ioctl=LEV
-
LEV is placed in the SCSI_LOG_IOCTL field.
- --llcomplete=LEV
-
LEV is placed in the SCSI_LOG_LLCOMPLETE field.
- --llqueue=LEV
-
LEV is placed in the SCSI_LOG_LLQUEUE field.
- -L, --lowlevel=LEV
-
LEV is placed in the SCSI_LOG_LLQUEUE and SCSI_LOG_LLCOMPLETE fields.
- -M, --midlevel=LEV
-
LEV is placed in the SCSI_LOG_MLQUEUE and SCSI_LOG_MLCOMPLETE fields.
- --mlcomplete=LEV
-
LEV is placed in the SCSI_LOG_MLCOMPLETE field.
- --mlqueue=LEV
-
LEV is placed in the SCSI_LOG_MLQUEUE field.
- -S, --scan=LEV
-
LEV is placed in the SCSI_LOG_SCAN field.
- -s, --set
-
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.
- -T, --timeout=LEV
-
LEV is placed in the SCSI_LOG_TIMEOUT field.
- -v, --version
-
Outputs the version information and then exits.
NOTES
The --get and --set options access the
/proc/sys/dev/scsi/logging_level pseudo file.
EXIT STATUS
The exit status of this script is 0 when it is successful. Any other
exit status indicates that an error has occurred.
EXAMPLES
The following will set SCSI_LOG_ERROR to level 5 in the Linux kernel. It
requires root permissions:
scsi_logging_level -s -E 5
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:
scsi_logging_level -s -T 7
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.
AUTHORS
Written by IBM. Small alterations by Douglas Gilbert.
REPORTING BUGS
Report bugs to <dgilbert at interlog dot com>.
COPYRIGHT
Copyright © IBM Corp. 2006
This software is distributed under the GPL version 2. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
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 .
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- NOTES
-
- EXIT STATUS
-
- EXAMPLES
-
- AUTHORS
-
- REPORTING BUGS
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 21:13:10 GMT, March 29, 2021