d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update the ses(4) man page

Browse Source 
This driver was largely rewritten in 2015 (svn r235911) but the man page was
never updated to match.

Reviewed by:	trasz
MFC after:	2 weeks
Sponsored by:	Axcient
Differential Revision:	https://reviews.freebsd.org/D22339
This commit is contained in:
Alan Somers 2019-11-18 14:12:33 +00:00
parent 2d5603fe65
commit af4b7924f1
1 changed files with 39 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
share/man/man4/ses.4
View File

@ -25,7 +25,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd September 5, 2015 .Dd November 12, 2019
.Dt SES 4 .Dt SES 4
.Os .Os
.Sh NAME .Sh NAME
@ -77,33 +77,47 @@ calls apply to
.Nm .Nm
devices. devices.
They are defined in the header file They are defined in the header file
.In cam/scsi/scsi_ses.h .In cam/scsi/scsi_enc.h
(\fIq.v.\fR). (\fIq.v.\fR).
.Bl -tag -width SESIOC_GETENCSTAT .Bl -tag -width ENCIOC_GETENCSTAT
.It Dv SESIOC_GETNOBJ .It Dv ENCIOC_GETNELM
Used to find out how many Used to find out how many
.Nm .Nm
objects are driven by this particular device instance. elements are driven by this particular device instance.
.It Dv SESIOC_GETOBJMAP .It Dv ENCIOC_GETELMMAP
Read, from the kernel, an array of SES objects which contains Read, from the kernel, an array of SES elements which contains
the object identifier, which subenclosure it is in, and the the element identifier, which subenclosure it is in, and the
.Nm .Nm
type of the object. type of the element.
.It Dv SESIOC_GETENCSTAT .It Dv ENCIOC_GETENCSTAT
Get the overall enclosure status. Get the overall enclosure status.
.It Dv SESIOC_SETENCSTAT .It Dv ENCIOC_SETENCSTAT
Set the overall enclosure status. Set the overall enclosure status.
.It Dv SESIOC_GETOBJSTAT .It Dv ENCIOC_GETELMSTAT
Get the status of a particular object. Get the status of a particular element.
.It Dv SESIOC_SETOBJSTAT .It Dv ENCIOC_SETELMSTAT
Set the status of a particular object. Set the status of a particular element.
.It Dv SESIOC_GETTEXT .It Dv ENCIOC_GETTEXT
Get the associated help text for an object (not yet implemented). Get the associated help text for an element (not yet implemented).
.Nm .Nm
devices often have descriptive text for an object which can tell devices often have descriptive text for an element which can tell
you things like location (e.g., "left power supply"). you things like location (e.g., "left power supply").
.It Dv SESIOC_INIT .It Dv ENCIOC_INIT
Initialize the enclosure. Initialize the enclosure.
.It Dv ENCIOC_GETELMDESC
Get the element's descriptor string.
.It Dv ENCIOC_GETELMDEVNAMES
Get the device names, if any, associated with this element.
.It Dv ENCIOC_GETSTRING
Used to read the SES String In Diagnostic Page.
The contents of this page are device-specific.
.It Dv ENCIOC_SETSTRING
Used to set the SES String Out Diagnostic Page.
The contents of this page are device-specific.
.It Dv ENCIOC_GETENCNAME
Used to get the name of the enclosure.
.It Dv ENCIOC_GETENCID
Used to get the Enclosure Logical Identifier.
.El .El
.Sh EXAMPLE USAGE .Sh EXAMPLE USAGE
The files contained in The files contained in
@ -128,9 +142,12 @@ parameters to the console.
.Sh HISTORY .Sh HISTORY
The The
.Nm .Nm
driver was written for the driver was originally written for the
.Tn CAM .Tn CAM
.Tn SCSI .Tn SCSI
subsystem by Matthew Jacob. subsystem by Matthew Jacob and first released in
This is a functional equivalent of a similar .Fx 4.3 .
It was a functional equivalent of a similar
driver available in Solaris, Release 7. driver available in Solaris, Release 7.
It was largely rewritten by Alexander Motin, Justin Gibbs, and Will Andrews for
.Fx 9.2 .