Re: [PATCH] scsi: Document generic scsi device attributes

On Fri, Aug 19, 2011 at 11:21:47AM -0400, Douglas Gilbert wrote:

On 11-08-19 10:44 AM, Stephen M. Cameron wrote:

quoted

From: Stephen M. Cameron<redacted>

<snip>

quoted

+What:           /sys/class/scsi_device/..../device/modalias
+Date:           April, 2007
+KernelVersion:  Unknown
+Contact:        James Bottomley[off-list ref]
+Description:
+		This read only string value contains a string of the form
+		"scsi:t-0xXX" where "XX" are two hex digits representing the
+		SCSI device type.  See also the "type" attribute and table 47
+		in section 8.2.5.1 "Standard INQUIRY data" of the SCSI-2
+		specification.

My copy of SCSI-2 is draft 10b from 1989 and it doesn't have a
section 8.2.5.1 . Since SCSI-2 was withdrawn over 10 years
ago perhaps you could use a more recent reference. [I see
webstore.ansi.org still sells the SCSI-2 standard for $30 .]

SPC-3 is a standard [ANSI INCITS 408-2005; ISO/IEC 14776-453]
and the relevant section, judging from its last draft, would
be table 83 in section 6.4.2 . And it is now called the
"peripheral device type".

I knew it was a mistake for me to try to figure out what the
proper reference should be.  If such things change, maybe 
having a reference in there at all is a mistake.  Maybe it should just
say something like, "the numbers correspond to the entries in
the scsi_device_types[] array in drivers/scsi/scsi.c" since 
that file is more likely to be close at hand than whichever
spec we might refer to.

-- steve