Opened 8 years ago

Closed 8 years ago

#169 closed defect (fixed)

smartctl man page outdated (SMART offline test ranges)

Reported by: koitsu2009 Owned by: Christian Franke
Priority: trivial Milestone: Release 5.41
Component: smartctl Version: 5.40
Keywords: Cc:

Description

The man page for smartctl(8) on version 5.40 states the following about smartctl -t vendor,XXX:

vendor,N  - [ATA only] issues the ATA command SMART EXECUTE OFF-
            LINE IMMEDIATE with subcommand N in LBA LOW register.  The  sub-
            command  is  specified as a hex value in the range 0x00 to 0xff.
            Subcommands 0x40-0x7f and 0x90-0xff are reserved for vendor spe-
            cific use, see table 61 of T13/1699-D Revision 6a (ATA8-ACS).

This information has been deprecated per working draft of ATA-8 ACS, T13/2015-D Revision 3 (dated June 18, 2010), table 152, provides a more accurate portrait of what the current vendor and reserved SMART test ranges are for OFF-LINE IMMEDIATE:

00h = Execute SMART off-line routine immediately in off-line mode
01h = Execute SMART Short self-test routine immediately in off-line mode
02h = Execute SMART Extended self-test routine immediately in off-line mode
03h = Execute SMART Conveyance self-test routine immediately in off-line mode
04h = Execute SMART Selective self-test routine immediately in off-line mode
05h-3Fh = Reserved
40h-7Eh = Vendor specific
7Fh = Abort off-line mode self-test routine
80h = Reserved
81h = Execute SMART Short self-test routine immediately in captive mode
82h = Execute SMART Extended self-test routine immediately in captive mode
83h = Execute SMART Conveyance self-test routine immediately in captive mode
84h = Execute SMART Selective self-test routine immediately in captive mode
85h-8Fh = Reserved
90h-FFh = Vendor specific

Let me know and I can come up with a patch for smartctl.8.in with this information.

Change History (3)

comment:1 Changed 8 years ago by koitsu2009

Aforementioned T13 doc can be read here:

http://www.malkavian.com/~jdc/03_d2015r3-ATA-ACS-2.pdf

comment:2 Changed 8 years ago by Christian Franke

Owner: changed from somebody to Christian Franke
Status: newaccepted

No - this was not changed since ATA-7 (which only added Conveyance and Selective self-tests). The table above is identical to table 48 from ATA/ATAPI-7 Volume 1 rev 4b (April 2004). See our Links page.

There is actually a typo on the man page: "0x40-0x7f" should be "0x40-0x7e".

And it should probably be noted that it does not make sense to use values defined by the standard because this is already supported by "-t offline (0x00), -t short (0x01), ... -t select (0x04), -X (0x7f), -C -t short (0x81), ...".

comment:3 Changed 8 years ago by Christian Franke

Resolution: fixed
Status: acceptedclosed
Note: See TracTickets for help on using tickets.