public inbox for linux-scsi@vger.kernel.org
 help / color / mirror / Atom feed
From: "Stephen M. Cameron" <scameron@beardog.cce.hp.com>
To: james.bottomley@hansenpartnership.com
Cc: stephenmcameron@gmail.com, akpm@linux-foundation.org,
	gregkh@suse.de, linux-kernel@vger.kernel.org,
	linux-scsi@vger.kernel.org
Subject: [PATCH] scsi: document generic scsi host sysfs attributes
Date: Wed, 17 Aug 2011 13:20:47 -0500	[thread overview]
Message-ID: <20110817182047.8821.55211.stgit@beardog.cce.hp.com> (raw)

From: Stephen M. Cameron <scameron@beardog.cce.hp.com>

Signed-off-by: Stephen M. Cameron <scameron@beardog.cce.hp.com>
---
 Documentation/ABI/testing/sysfs-bus-scsi |  121 ++++++++++++++++++++++++++++++
 1 files changed, 121 insertions(+), 0 deletions(-)
 create mode 100644 Documentation/ABI/testing/sysfs-bus-scsi

diff --git a/Documentation/ABI/testing/sysfs-bus-scsi b/Documentation/ABI/testing/sysfs-bus-scsi
new file mode 100644
index 0000000..fe4d36e
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-scsi
@@ -0,0 +1,121 @@
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/unique_id
+Date:		February, 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only unsigned integer uniquely identifying the SCSI host
+		within the system.  This value is assigned by the low level
+		driver.
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/host_busy
+Date:		February 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only unsigned short integer indicating whether the SCSI
+		host is busy.
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/cmd_per_lun
+Date:		February 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only short integer indicating how many concurrent
+		commands per logical unit the SCSI host supports.
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/can_queue
+Date:		October, 2006
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only short integer indicating the total number of
+		concurrent commands the SCSI host supports.
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/sg_tablesize
+Date:		February, 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only unsigned short integer indicating how many scatter
+		gather entries are available for each command.
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/sg_prot_tablesize
+Date:		September, 2010
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only unsigned short integer which indicates how many
+		scatter gather entries are available for DIX integrity data.
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/unchecked_isa_dma
+Date:		February, 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/proc_name
+Date:		March, 2004
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/scan
+Date:		August, 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only integer which indicates whether the host is an
+		ancient ISA device which therefore requires extra bounce
+		buffering.
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/hstate
+Date:		February, 2008
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		String value which indicates the state of the SCSI host.
+		Possible values are: "created", "running", "cancel",
+		"deleted", "recovery", "cancel/recovery" and "deleted/recovery"
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/supported_mode
+Date:		October, 2007
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only string value which indicates the supported modes of
+		the SCSI host.  Possible modes are: "Initiator" and "Target".
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/active_mode
+Date:		October, 2007
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only string value which indicates the currently active
+		mode of the SCSI host.  Possible values are "Initiator",
+		"Target" and "unknown".
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/prot_capabilities
+Date:		July, 2008
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only unsigned integer bitmap which indicates what
+		data integrity capabilities the SCSI host supports.
+		Bit 0: T10 DIF type 1
+		Bit 1: T10 DIF type 2
+		Bit 2: T10 DIF type 3
+		Bit 3: DIX between OS and HBA only.
+		Bit 4: DIX with DIF type 1
+		Bit 5: DIX with DIF type 2
+		Bit 6: DIX with DIF type 3
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/prot_guard_type
+Date:		July, 2008
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@HansenPartnership.com>
+Description:
+		Read only unsigned short bitmap value which indicates what
+		checksums DIX capable controllers implement.
+		Bit 0: DIX guard CRC.
+		Bit 1: DIX guard IP.
+


             reply	other threads:[~2011-08-17 18:20 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-08-17 18:20 Stephen M. Cameron [this message]
2011-08-18 12:55 ` [PATCH] scsi: document generic scsi host sysfs attributes Stefan Richter
  -- strict thread matches above, loose matches on Subject: below --
2011-08-19 14:44 Stephen M. Cameron

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20110817182047.8821.55211.stgit@beardog.cce.hp.com \
    --to=scameron@beardog.cce.hp.com \
    --cc=akpm@linux-foundation.org \
    --cc=gregkh@suse.de \
    --cc=james.bottomley@hansenpartnership.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-scsi@vger.kernel.org \
    --cc=stephenmcameron@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox