Provided by: sg3-utils_1.17-2_i386
sg_logs - read SCSI device log pages
sg_logs [-a] [-c=<page_control>] [-h] [-H] [-l] [-p=<page_code>]
[-paramp=<parameter_pointer>] [-pcb] [-ppc] [-r] [-sp] [-t] [-v] [-V]
This utility sends a LOG SENSE SCSI command to the given device and
then outputs the response. This is used in most cases to fetch log
pages stored on the given device and known log pages are decoded and
output in ASCII. In one case a LOG SELECT SCSI command is issued to
reset parameters back to the device manufacturer’s default values.
-a outputs all the log pages supported by the device.
accepts 0, 1, 2 or 3 as an argument. 0 for current threshold
values, 1 for current cumulative values, 2 for default threshold
values and 3 for default cumulative values. The default is 1
(i.e. current threshold values).
-h suppresses decoding of known log sense pages and prints out the
response in hex instead.
-H same action as ’-h’.
-l lists the names of all logs sense pages supported by this
device. See the list of common log page codes below.
log page code to fetch. Should be a hexadecimal number between 0
and 3f inclusive.
parameter pointer value (in hex) to place in command. Should be
a number between 0 and ffff inclusive.
-pcb show Parameter Control Byte settings (only relevant when log
parameters being output in ASCII).
-ppc sets the Parameter Pointer Control (PPC) bit. Default is 0 (i.e.
-r use LOG SELECT SCSI command to reset all implemented parameter
values to be the device defined (i.e. manufacturer’s) default
values. In most cases the default values are zeroes. This option
seems to clear error counter log pages but leaves pages like
self-test results, start-stop cycle counter and temperature log
pages unaffected. This option may be required to clear log
pages if a counter reaches its maximum value since the log page
in which the counter is found will remain "stuck" until
something is done.
-sp sets the Saving Parameters (SP) bit. Default is 0 (i.e.
cleared). When set this instructs the device to store the
current log page parameters (as indicated by the DS and TSD
parameter codes) in some non-volatile location. Hence the log
parameters will be preserved across power cycles. This option is
typically not needed, especially if the GLTSD flag is clear in
the control mode page as this instructs the device to
periodically save all saveable log parameters to non-volatile
-t outputs the temperature. First looks in the temperature log page
and if that is not available tries the Informational Exceptions
page which may also have the current temperature (especially in
-v verbose: show SCSI command blocks prior to execution. ’-vv’ and
’-vvv’ are also accepted yielding greater verbosity.
-V print out version string
-? output usage message. Ignore all other parameters.
Various log pages hold information error rates, device temperature,
start stop cycles since device produced and the results of the last 20
self tests. Self tests can be initiated by the sg_senddiag utility.
The smartmontools package provides much of the information found with
sg_logs in a form suitable for monitoring the health of SCSI disks and
Here is a list of log pages that are decoded by this utility. [Drop the
"0x" prefix when using them as an argument to the ’-p=’ option]:
0x0 Supported log pages
0x1 Buffer overrun/underrun
0x2 Write error counter
0x3 Read error counter
0x4 Read reverse error counter
0x5 Verify error counter
0x6 Non-medium error
0x7 Last n error events
0x8 Format status (sbc-2)
0xb Last n deferred errors or asynchronous events
0xc Sequential access device (ssc-2)
0xe Start-stop cycle counter
0x10 Self-test results
0x17 Non-volatile cache
0x18 Protocol specific port (SAS transport)
0x2f Informational exceptions
0x37 Seagate cache (vendor, disk)
0x3e Seagate factory (vendor, disk)
In the 2.4 series of Linux kernels the given device must be a SCSI
generic (sg) device. In the 2.6 series block devices (e.g. disks and
SCSI DVDs) can also be specified. For example "sg_logs -a /dev/sda"
will work in the 2.6 series kernels.
Written by Doug Gilbert
Report bugs to <dgilbert at interlog dot com>.
Copyright © 2002-2005 Douglas Gilbert
This software is distributed under the GPL version 2. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
smartctl(smartmontools: see net), sg_senddiag(sg3_utils)