lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [day] [month] [year] [list]
Message-ID: <20110819144424.15165.6621.stgit@beardog.cce.hp.com>
Date:	Fri, 19 Aug 2011 09:44:24 -0500
From:	"Stephen M. Cameron" <scameron@...rdog.cce.hp.com>
To:	james.bottomley@...senpartnership.com
Cc:	stephenmcameron@...il.com, akpm@...ux-foundation.org,
	gregkh@...e.de, linux-kernel@...r.kernel.org,
	linux-scsi@...r.kernel.org
Subject: [PATCH] scsi: document generic scsi host sysfs attributes

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

Signed-off-by: Stephen M. Cameron <scameron@...rdog.cce.hp.com>
---
 Documentation/ABI/testing/sysfs-bus-scsi |  129 ++++++++++++++++++++++++++++++
 1 files changed, 129 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..088d16a
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-scsi
@@ -0,0 +1,129 @@
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/unique_id
+Date:		February, 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@...senPartnership.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@...senPartnership.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@...senPartnership.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@...senPartnership.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@...senPartnership.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@...senPartnership.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@...senPartnership.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*/proc_name
+Date:		March, 2004
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@...senPartnership.com>
+Description:
+		Read only string which indicates the name of the proc
+		directory of a driver
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/scan
+Date:		August, 2003
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@...senPartnership.com>
+Description:
+		Write only attribute which causes the SCSI mid layer to
+		scan the SCSI host at the specified channel, bus, and id for
+		devices.  The integer decimal value of -1 interpreted as
+		an unsigned integer (4294967295 on most architectures) may
+		be used as a wild card.  For example:
+		echo 4294967295 4294967295 4294967295 > /sys/.../scan
+
+What:		/sys/bus/scsi/devices/host*/scsi_host/host*/hstate
+Date:		February, 2008
+KernelVersion:	Unknown
+Contact:	James Bottomley <James.Bottomley@...senPartnership.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@...senPartnership.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@...senPartnership.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@...senPartnership.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@...senPartnership.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.
+

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ