1SCSI_LOGGING_LEVEL(8)              SG3_UTILS             SCSI_LOGGING_LEVEL(8)
2
3
4

NAME

6       scsi_logging_level - access Linux SCSI logging level information
7

SYNOPSIS

9       scsi_logging_level   [--all=LEV]   [--create]   [--error=LEV]   [--get]
10       [--help]    [--highlevel=LEV]    [--hlcomplete=LEV]     [--hlqueue=LEV]
11       [--ioctl=LEV]   [--llcomplete=LEV]   [--llqueue=LEV]   [--lowlevel=LEV]
12       [--midlevel=LEV]   [--mlcomplete=LEV]   [--mlqueue=LEV]    [--scan=LEV]
13       [--set] [--timeout=LEV] [--version]
14

DESCRIPTION

16       This bash shell script accesses the Linux SCSI subsystem logging level.
17       The current values can be shown (e.g. with --get) or changed (e.g. with
18       --set).  Superuser  permissions  will  typically be required to set the
19       logging level.
20
21       One of these options: --create, --get or --set is required. Only one of
22       them can be given.
23

OPTIONS

25       Arguments to long options are mandatory for short options as well.
26
27       -a, --all=LEV
28              LEV is used for all SCSI_LOG fields.
29
30       -c, --create
31              Options  are  parsed and placed in internal fields that are dis‐
32              played but no logging levels are changed within the  Linux  ker‐
33              nel.
34
35       -E, --error=LEV
36              LEV is placed in the SCSI_LOG_ERROR field.
37
38       -g, --get
39              Fetches  the  current  SCSI logging levels from the Linux kernel
40              and displays them.
41
42       -h, --help
43              print out the usage message then exit.
44
45       -H, --highlevel=LEV
46              LEV is placed in the  SCSI_LOG_HLQUEUE  and  SCSI_LOG_HLCOMPLETE
47              fields.
48
49       --hlcomplete=LEV
50              LEV is placed in the SCSI_LOG_HLCOMPLETE field.
51
52       --hlqueue=LEV
53              LEV is placed in the SCSI_LOG_HLQUEUE field.
54
55       -I, --ioctl=LEV
56              LEV is placed in the SCSI_LOG_IOCTL field.
57
58       --llcomplete=LEV
59              LEV is placed in the SCSI_LOG_LLCOMPLETE field.
60
61       --llqueue=LEV
62              LEV is placed in the SCSI_LOG_LLQUEUE field.
63
64       -L, --lowlevel=LEV
65              LEV  is  placed  in the SCSI_LOG_LLQUEUE and SCSI_LOG_LLCOMPLETE
66              fields.
67
68       -M, --midlevel=LEV
69              LEV is placed in the  SCSI_LOG_MLQUEUE  and  SCSI_LOG_MLCOMPLETE
70              fields.
71
72       --mlcomplete=LEV
73              LEV is placed in the SCSI_LOG_MLCOMPLETE field.
74
75       --mlqueue=LEV
76              LEV is placed in the SCSI_LOG_MLQUEUE field.
77
78       -S, --scan=LEV
79              LEV is placed in the SCSI_LOG_SCAN field.
80
81       -s, --set
82              Uses the fields specified in this command's options and attempts
83              to apply them to the Linux SCSI subsystem logging levels.  Typi‐
84              cally superuser permissions will be required to do this.
85
86       -T, --timeout=LEV
87              LEV is placed in the SCSI_LOG_TIMEOUT field.
88
89       -v, --version
90              Outputs the version information and then exits.
91

NOTES

93       The --get and --set options access the /proc/sys/dev/scsi/logging_level
94       pseudo file.
95

EXIT STATUS

97       The exit status of this script is 0 when it is  successful.  Any  other
98       exit status indicates that an error has occurred.
99

EXAMPLES

101       The  following  will set SCSI_LOG_ERROR to level 5 in the Linux kernel.
102       It requires root permissions:
103
104         scsi_logging_level -s -E 5
105
106       So as to not interfere with other SCSI subsystem  upper  level  drivers
107       (ULDs)  which most likely will be active at the same time, the Linux sg
108       driver uses SCSI_LOG_TIMEOUT for logging purposes. To see  full  debug‐
109       ging and trace from the sg driver use:
110
111         scsi_logging_level -s -T 7
112
113       The output from the sg driver caused by this will go to the system logs
114       (e.g. /var/log/syslog). To reduce the amount of  output  use  a  number
115       lower than 7. Using 0 will turn off the tracing and debug.
116

AUTHORS

118       Written by IBM. Small alterations by Douglas Gilbert.
119

REPORTING BUGS

121       Report bugs to <dgilbert at interlog dot com>.
122
124       Copyright © IBM Corp. 2006
125       This  software is distributed under the GPL version 2. There is NO war‐
126       ranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR‐
127       POSE.
128
129       The  software  was obtained from an IBM package called s390-tools-1.6.2
130       found on that company's "developerworks" site. The most recent  version
131       of that package at this time is 1.8.3 .
132
133
134
135sg3_utils-1.41                   January 2014            SCSI_LOGGING_LEVEL(8)
Impressum