Lines Matching +full:command +full:- +full:and +full:- +full:control

1 .TH SG_SES "8" "October 2021" "sg3_utils\-1.47" SG3_UTILS
3 sg_ses \- access a SCSI Enclosure Services (SES) device
6 [\fI\-\-all\fR] [\fI\-\-ALL\fR] [\fI\-\-descriptor=DES\fR]
7 [\fI\-\-dev\-slot\-num=SN\fR] [\fI\-\-eiioe=A_F\fR] [\fI\-\-filter\fR]
8 [\fI\-\-get=STR\fR] [\fI\-\-hex\fR] [\fI\-\-index=IIA\fR |
9 \fI\-\-index=TIA,II\fR] [\fI\-\-inner\-hex\fR] [\fI\-\-join\fR]
10 [\fI\-\-maxlen=LEN\fR] [\fI\-\-page=PG\fR] [\fI\-\-quiet\fR] [\fI\-\-raw\fR]
11 [\fI\-\-readonly\fR] [\fI\-\-sas\-addr=SA\fR] [\fI\-\-status\fR]
12 [\fI\-\-verbose\fR] [\fI\-\-warn\fR] \fIDEVICE\fR
15 \fI\-\-control\fR [\fI\-\-byte1=B1\fR] [\fI\-\-clear=STR\fR]
16 [\fI\-\-data=H,H...\fR] [\fI\-\-data=@FN\fR] [\fI\-\-descriptor=DES\fR]
17 [\fI\-\-dev\-slot\-num=SN\fR] [\fI\-\-index=IIA\fR | \fI\-\-index=TIA,II\fR]
18 [\fI\-\-mask\fR] [\fI\-\-maxlen=LEN\fR] [\fI\-\-nickname=SEN\fR]
19 [\fI\-\-nickid=SEID\fR]  [\fI\-\-page=PG\fR] [\fI\-\-readonly\fR]
20 [\fI\-\-sas\-addr=SA\fR] [\fI\-\-set=STR\fR] [\fI\-\-verbose\fR]
24 \fI\-\-data=@FN\fR \fI\-\-status\fR [\fI\-\-raw\fR \fI\-\-raw\fR]
28 \fI\-\-inhex=FN\fR \fI\-\-status\fR [\fI\-\-raw\fR \fI\-\-raw\fR]
32 [\fI\-\-enumerate\fR] [\fI\-\-index=IIA\fR] [\fI\-\-list\fR] [\fI\-\-help\fR]
33 [\fI\-\-version\fR]
47 all, of the named dpages are defined in the SES standards and drafts. The
50 standards for SES, SES\-2 and SES\-3 are ANSI INCITS 305\-1998 and ANSI
51 INCITS 448\-2008 and ANSI INCITS 518\-2017 respectively.
58 of the HBA and whether anything is connected to its SCSI ports.
60 The first form shown in the synopsis is for fetching and decoding dpages or
61 fields from the SES \fIDEVICE\fR. A SCSI RECEIVE DIAGNOSTIC RESULTS command
64 \fI\-\-hex\fR or \fI\-\-raw \-\-raw\fR options.
67 the SES \fIDEVICE\fR. A SCSI SEND DIAGNOSTIC command containing a "control"
70 carrier in an array) is typically done using a read\-modify\-write cycle.
76 earlier invocation of the first form of this utility with the '\-HHHH'
80 The last form in the synopsis shows the options for providing command line
81 help (i.e. usage information), listing out dpage and field information tables
82 held by the utility (\fI\-\-enumerate\fR), or printing the version string
90 with a SCSI RECEIVE DIAGNOSTIC RESULTS command, sent to the \fIDEVICE\fR with
91 a SCSI SEND DIAGNOSTIC command, or fetched from data supplied by the
92 \fI\-\-data=\fR option.
98 \fB\-a\fR, \fB\-\-all\fR
99 shows (almost) all status dpages, following references and presenting
101 of nesting. This option is actually the same as \fI\-\-join\fR, see its
105 So it is the same as using \fI\-\-join\fRtwice.
107 \fB\-z\fR, \fB\-\-ALL\fR
108 shows (almost) all status dpages, following references and presenting
111 This option is the same as using  \fI\-\-join\fR rwice.
113 \fB\-b\fR, \fB\-\-byte1\fR=\fIB1\fR
115 Enclosure Control dpage, byte 1 contains the INFO, NON\-CRIT, CRIT and
116 UNRECOV bits. In the Subenclosure String Out, Subenclosure Nickname Control
117 and Download Microcode Control dpages, byte 1 is the Subenclosure identifier.
118 Active when the \fI\-\-control\fR and \fI\-\-data=H,H...\fR options are used
119 and the default value is 0. If the \fI\-\-clear=STR\fR or \fI\-\-set=STR\fR
124 \fB\-C\fR, \fB\-\-clear\fR=\fISTR\fR
125 Used to clear an element field in the Enclosure Control or Threshold Out
127 is to be changed. The Enclosure Control dpage is assumed if the
128 \fI\-\-page=PG\fR option is not given. See the STR FORMAT and the CLEAR, GET,
131 \fB\-c\fR, \fB\-\-control\fR
132 will send control information to the \fIDEVICE\fR via a SCSI SEND
133 DIAGNOSTIC command. Cannot give both this option and \fI\-\-status\fR.
134 The Enclosure Control, String Out, Threshold Out, Array Control (obsolete
135 in SES\-2), Subenclosure String Out, Subenclosure Nickname Control and
137 either the \fI\-\-clear=STR\fR or \fI\-\-set=STR\fR option is given.
139 \fB\-d\fR, \fB\-\-data\fR=\fIH,H...\fR
143 control dpage to be specified. The string given should not include the first 4
144 bytes (i.e. page code and length). See the DATA SUPPLIED section below.
146 \fB\-d\fR, \fB\-\-data\fR=\-
149 \fI\-\-data=H,H...\fR option). Additionally spaces, tabs and line feeds are
153 \fB\-d\fR, \fB\-\-data\fR=@\fIFN\fR
158 \fB\-D\fR, \fB\-\-descriptor\fR=\fIDES\fR
161 level \fI\-\-index=\fR options. If the descriptor name contains a space then
164 NUMBER AND SAS ADDRESS section below.
166 \fB\-x\fR, \fB\-\-dev\-slot\-num\fR=\fISN\fR, \fB\-\-dsn\fR=\fISN\fR
168 dpage. Only entries for FCP and SAS devices (with EIP=1) have device slot
171 indexing alternative to the low level \fI\-\-index=\fR options. See the
172 DESCRIPTOR NAME, DEVICE SLOT NUMBER AND SAS ADDRESS section below.
174 \fB\-E\fR, \fB\-\-eiioe\fR=\fIA_F\fR
177 Status (AES) dpage between SES\-2 and SES\-3. The EIIOE bit was introduced to
178 resolve the problem but not all enclosures have caught up. In the SES\-3
180 Using '\-\-eiioe=force' will decode the AES dpage as if the EIIOE field is set
181 to 1.  Using '\-\-eiioe=auto' will decode the AES dpage as if the EIIOE field
182 is set to 1 if the first AES descriptor has its EIP bit set and its element
187 no effect. It is recommended that HP JBOD users set \-\-eiioe=auto .
189 \fB\-e\fR, \fB\-\-enumerate\fR
190 enumerate all known diagnostic page (dpage) names and SES elements that this
195 If \fI\-\-enumerate\fR is given twice, then the recognised acronyms for the
196 \fI\-\-clear=STR\fR, \fI\-\-get=STR\fR and \fI\-\-set=STR\fR options are
198 options and \fIDEVICE\fR are ignored. Since there are many acronyms for
199 the Enclosure Control/Status dpage then the output can be further restricted
200 by giving the \fI\-\-index=IIA\fR option (e.g. "sg_ses \-ee \-I ts" to only
201 show the acronyms associated with the Enclosure Control/Status dpage's
204 \fB\-f\fR, \fB\-\-filter\fR
205 cuts down on the amount of output from the Enclosure Status dpage and the
210 field (in the Enclosure status dpage) are output. The \fI\-\-filter\fR option
211 is useful for reducing the amount of output generated by the \fI\-\-join\fR
214 \fB\-G\fR, \fB\-\-get\fR=\fISTR\fR
218 Threshold In and Additional Element Status dpages. If a value is found it is
220 if the \fI\-\-hex\fR option is also given. See the STR FORMAT and the CLEAR,
223 \fB\-h\fR, \fB\-\-help\fR
226 Use this option twice (e.g. '\-hh') to output the second page. Note: the
227 \fI\-\-enumerate\fR option might also be viewed as a help or usage type
228 option. And like this option it has a "given twice" form: '\-ee'.
230 \fB\-H\fR, \fB\-\-hex\fR
231 If the \fI\-\-get=STR\fR option is given then output the value found (if
234 twice, and simple hex if given three or more times. Ignored when all
235 elements from several dpages are being accessed (e.g. when the \fI\-\-join\fR
236 option is used). Also see the \fI\-\-raw\fR option which may be used
240 use \fI\-HHH\fR or \fI\-HHHH\fR. The triple H form only outputs hexadecimals
242 with \fI\-\-page=all\fR) then the quad H form adds the name of each dpage
243 following a hash mark ('#'). The \fI\-\-data=\fR option parser ignores
244 everything from and including a hash mark to the end of the line. Hence the
246 view and possibly edit. \fI\-HHHHH\fR (that is 5) adds the page code in
249 \fB\-I\fR, \fB\-\-index\fR=\fIIIA\fR
251 abbreviation (A). See the INDEXES section below. If the \fI\-\-page=PG\fR
252 option is not given then the Enclosure Status (or Control) dpage is assumed.
253 May be used with the \fI\-\-join\fR option or one of the \fI\-\-clear=STR\fR,
254 \fI\-\-get=STR\fR or \fI\-\-set=STR\fR options. To enumerate the available
255 Element type abbreviations use the \fI\-\-enumerate\fR option.
257 \fB\-I\fR, \fB\-\-index\fR=\fITIA,II\fR
260 below. If the \fI\-\-page=PG\fR option is not given then the Enclosure
261 Status (or Control) dpage is assumed. May be used with the \fI\-\-join\fR
262 option or one of the \fI\-\-clear=STR\fR, \fI\-\-get=STR\fR or
263 \fI\-\-set=STR\fR options. To enumerate the available Element type
264 abbreviations use the \fI\-\-enumerate\fR option.
266 \fB\-X\fR, \fB\-\-inhex\fR=\fIFN\fR
268 \fI\-\-data=@FN\fR option. If \fIFN\fR is '\-' then stdin is read. This
270 package that use \fI\-\-inhex=FN\fR (or \fI\-\-in=FN\fR) is a similar
274 \fB\-i\fR, \fB\-\-inner\-hex\fR
275 the outer levels of a status dpage are decoded and printed out but the
277 active with the Additional Element Status and Threshold In dpages. Can be
278 used with an indexing option and/or \fI\-\-join\fR options.
280 \fB\-j\fR, \fB\-\-join\fR
281 group elements from the Element Descriptor, Enclosure Status and Additional
289 matching elements and their associated fields are output. The \fI\-\-filter\fR
291 Also "\-\-page=aes" (or "\-p 0xa") can be added to suppress the output of
292 rows that don't have a "aes" dpage component. See the INDEXES and DESCRIPTOR
293 NAME, DEVICE SLOT NUMBER AND SAS ADDRESS sections below.
295 \fB\-l\fR, \fB\-\-list\fR
296 This option is equivalent to \fI\-\-enumerate\fR. See that option.
298 \fB\-M\fR, \fB\-\-mask\fR
300 mask, modify (based on \fI\-\-clear=STR\fR or \fI\-\-set=STR\fR) then write
301 back as the control element. The mask step is new in sg_ses version 1.98
302 and is based on what is allowable (and in the same location) in draft SES\-3
304 re\-instates the previous logic which was to ignore the mask step. The
306 the read\-mask\-modify\-write sequence.
308 \fB\-m\fR, \fB\-\-maxlen\fR=\fILEN\fR
315 is used, otherwise if it is less than 4 then it is ignored (and a warning is
318 \fB\-n\fR, \fB\-\-nickname\fR=\fISEN\fR
323 \fB\-N\fR, \fB\-\-nickid\fR=\fISEID\fR
329 \fB\-p\fR, \fB\-\-page\fR=\fIPG\fR
338 or less to be output. This can be used with either the \fI\-HHHH\fR or
339 \fI\-rr\fR to send either hexadecimal ASCII or binary respectively to
343 information can also be found with the \fI\-\-enumerate\fR option.
345 \fB\-q\fR, \fB\-\-quiet\fR
346 this suppresses the number of warnings and messages output. The exit status
349 \fB\-r\fR, \fB\-\-raw\fR
351 later invocation using the \fI\-\-data=\fR option. A dpage less its first
352 4 bytes (page code and length) is output. When used twice (e.g. \fI\-rr\fR)
355 when \fI\-rr\fR is used together with the \fI\-\-data=\-\fR or
356 \fI\-\-data=@FN\fR then stdin or file FN is decoded as a binary stream that
359 the \fI\-rr\fR option either changes how the input or output is treated,
362 \fB\-R\fR, \fB\-\-readonly\fR
363 open the \fIDEVICE\fR read\-only (e.g. in Unix with the O_RDONLY flag).
364 The default is to open it read\-write.
366 \fB\-A\fR, \fB\-\-sas\-addr\fR=\fISA\fR
371 Most SAS disks and tapes have two such target ports, usually numbered
381  indexing alternative to the low level \fI\-\-index=\fR options.
382 See the DESCRIPTOR NAME, DEVICE SLOT NUMBER AND SAS ADDRESS section below.
384 \fB\-S\fR, \fB\-\-set\fR=\fISTR\fR
385 Used to set an element field in the Enclosure Control or Threshold Out dpage.
387 be changed. The Enclosure Control dpage is assumed if the \fI\-\-page=PG\fR
388 option is not given. See the STR FORMAT and CLEAR, GET, SET sections below.
390 \fB\-s\fR, \fB\-\-status\fR
392 command (or from \fI\-\-data=@FN\fR). In the absence of other options that
393 imply modifying a dpage (e.g.  \fI\-\-control\fR or \fI\-\-set=STR\fR) then
394 \fI\-\-status\fR is assumed, except when the \fI\-\-data=\fR option is given.
395 When the \fI\-\-data=\fR option is given there is no default action: either
396 the \fI\-\-control\fR or this option must be given to distinguish between
399 \fB\-v\fR, \fB\-\-verbose\fR
401 times (in which case the short form is more convenient: '\-vvvv') then if
405 \fB\-V\fR, \fB\-\-version\fR
406 print the version string and then exit.
408 \fB\-w\fR, \fB\-\-warn\fR
411 synchronized. The quality of SES devices vary and to be fair, the
412 descriptions from T10 drafts and standards have been tweaked several
415 An enclosure can have information about its disk and tape drives plus other
421 following section (DESCRIPTOR NAME, DEVICE SLOT NUMBER AND SAS ADDRESS)
426 Device Slot), a Subenclosure identifier (0 for the primary enclosure) and
432 type header. The Element Descriptor dpage and the Threshold (In and Out)
435 The numeric index corresponding to the overall element is "\-1". If the
437 and n is greater than 0 then its indexes range from 0 to n\-1 .
448 with two indexes: TI and II. Both are origin 0. TI=0 corresponds to the
450 Element type (according to the SES\-2 standard). To address the corresponding
451 overall instance, II is set to \-1, otherwise II can be set to the individual
457 One of two command lines variants can be used to specify indexes:
458 \fI\-\-index=TIA,II\fR where \fITIA\fR is either an type header index (TI)
460 an individual index or "\-1" to specify the overall element. The second
461 variant is \fI\-\-index=IIA\fR where \fIIIA\fR is either an individual
463 individual index then the option is equivalent to \fI\-\-index=0,II\fR. When
465 \fI\-\-index=A,\-1\fR.
468 individual index range. It has the form: <first_ii>\-<last_ii>. For
469 example: '3\-5' will select individual indexes 3, 4 and 5 .
473 a leading underscore. For example these are equivalent: \fI\-\-index=arr\fR
474 and \fI\-\-index=_23\fR since the Array Device Slot Element type code is 23.
475 Also \fI\-\-index=ps1\fR and \fI\-\-index=_2_1\fR are equivalent.
478 has Array Device Slot Element type then \fI\-\-index=0,\-1\fR is
479 equivalent to \fI\-\-index=arr\fR. Also \fI\-\-index=arr,3\fR is equivalent
480 to \fI\-\-index=3\fR.
482 The \fI\-\-index=\fR options  can be used to reduce the amount of
485 \fI\-\-clear=STR\fR, \fI\-\-get=STR\fR and \fI\-\-set=STR\fR options which
487 .SH DESCRIPTOR NAME, DEVICE SLOT NUMBER AND SAS ADDRESS
488 The three options: \fI\-\-descriptor=DES\fR, \fI\-\-dev\-slot\-num=SN\fR
489 and \fI\-\-sas\-addr=SA\fR allow medium level indexing, as an alternative
490 to the low level \fI\-\-index=\fR options. Only one of the three options
492 \fI\-\-join\fR option since they need either the Element Descriptor dpage
494 \fI\-\-index=\fR option.
496 These medium level indexing options need support from the SES device and
497 that support is optional. For example the \fI\-\-descriptor=DES\fR needs
499 optional. Also the provided descriptor names need to be useful, and having
505 They may also be used together with with the \fI\-\-clear=STR\fR,
506 \fI\-\-get=STR\fR and \fI\-\-set=STR\fR options which are described in the
508 remove" (dnr)) and that field can be read back with \fI\-\-get=STR\fR
512 The \fISTR\fR operands of the \fI\-\-clear=STR\fR, \fI\-\-get=STR\fR and
513 \fI\-\-set=STR\fR options all have the same structure. There are two forms:
519 The <acronym> is one of a list of common fields (e.g. "ident" and "fault")
522 7 and the <num_bits> must be in the range 1 to 64 (default 1). The
526 2:7 and the least significant bit being 2:0 .
528 The <value> is optional but is ignored if provided to \fI\-\-get=STR\fR.
529 For \fI\-\-set=STR\fR the default <value> is 1 while for \fI\-\-clear=STR\fR
534 \fI\-\-enumerate\fR option twice (or "\-ee").
536 The \fI\-\-clear=STR\fR, \fI\-\-get=STR\fR and \fI\-\-set=STR\fR options can
541 order in which they appear on the command line. So if options contradict each
542 other, the last one appearing on the command line will be enforced. When
543 there are multiple \fI\-\-clear=STR\fR and \fI\-\-set=STR\fR options, then
547 \fI\-\-data=\fR option is given. These scenarios are the same irrespective
548 of whether the argument to the \fI\-\-data=\fR option is a string of
549 hex bytes on the command line, stdin (indicated by \fI\-\-data=\-\fR) or
550 names a file (e.g. \fI\-\-data=@thresh_in_dpage.hex\fR).
552 The first scenario is flagged by the \fI\-\-control\fR option. It uses the
553 supplied data to build a 'control' dpage that will be sent to the
554 \fIDEVICE\fR using the SCSI SCSI SEND DIAGNOSTIC command. The supplied dpage
556 utility using the \fI\-\-page=PG\fR option with \fIPG\fR placed at byte
557 offset 0). If needed, the \fI\-\-byte1=B1\fR option sets byte offset 1,
559 provided (i.e. its length) goes into byte offsets 2 and 3.
561 The second scenario is flagged by the \fI\-\-status\fR option. It decodes
565 invocations could use the '\-HHH' or '\-HHHH' option and file redirection to
567 response data is decoded according to the other command line options. For
568 example the \fI\-\-join\fR option could be given and that would require the
570 Element descriptor and Additional element status dpages. If in doubt use
571 \fI\-\-page=all\fR in the capture phase; having more dpages than needed
575 lines that don't exceed 512 characters. Anything on a line from and
577 line can be a LF or CR,LF and blank lines are ignored. Each separated
578 pair (or single) hexadecimal digits represent a byte (and neither a
582 Alternatively binary can be used and this is flagged by the '\-rr' option.
583 The \fI\-\-data=H,H...\fR form cannot use binary values for the 'H's, only
584 ASCII hexadecimal. The other two forms (\fI\-\-data=\-\fR and
585 \fI\-\-data=@FN\fR) may contain binary data. Note that when the '\-rr'
586 option is used with \fI\-\-data=@FN\fR that it only changes the
587 interpretation of the input data, it does not change the decoding and output
591 As noted above this is typically a read\-modify\-write type operation.
592 Most modifiable dpages have a "status" (or "in") page that can be read, and
593 a corresponding "control" (or "out") dpage that can be written back to change
597 a "status" dpage in hex with \fI\-\-raw\fR. Then a text editor can be used
598 to edit the hex (note: to change an Enclosure Control descriptor the SELECT
599 bit needs to be set). Next the control dpage data can fed back with the
600 \fI\-\-data=H,H...\fR option together with the \fI\-\-control\fR option;
601 the \fI\-\-byte1=B1\fR option may need to be given as well.
603 Changes to the Enclosure Control dpage (and the Threshold Out dpage) can be
605 case is the Enclosure Control dpage). Next choose an individual or overall
608 element (e.g. in an Array Device Slot Control element RQST IDENT is byte 2,
609 bit 1 and 1 bit long ("2:1:1")). Finally a value can be given, if not the
610 value for \fI\-\-set=STR\fR defaults to 1 and for \fI\-\-clear=STR\fR
613 The format of the Subenclosure Nickname control dpage is different from its
615 Nicknames (and Subenclosure identifier 0 is the main enclosure) while the
616 control dpage allows only one of them to be changed. Therefore using the
617 \fB\-\-data\fR option technique to change a Subenclosure nickname is
620 To simplify changing a Subenclosure nickname the \fI\-\-nickname=SEN\fR and
621 \fI\-\-nickid=SEID\fR options have been added. If the \fISEN\fR string
624 \fI\-\-nickid=SEID\fR is not given then a Subenclosure identifier of 0 is
625 assumed. As a guard the \fI\-\-control\fR option must also be given. If
626 the \fI\-\-page=PG\fR option is not given then \fI\-\-page=snic\fR is
629 When \fI\-\-nickname=SEN\fR is given then the Subenclosure Nickname Status
631 together with no more than 32 bytes from the Nickname (\fISEN\fR) and the
633 Control dpage.
639 experimental in sg3_utils package version 1.43 and sg_ses version 2.34 .
641 This support is based on a decision by NVME\-MI (Management Interface)
642 developers to support the SES\-3 standard. This was facilitated by adding
643 NVME\-MI SES Send and SES Receive commands that tunnel dpage contents as
647 the SCSI READ DIAGNOSTIC command). To this end the \fI\-\-page=PG\fR and
648 \fI\-\-hex\fR options would be appropriate. Non\-SES dpages can be sent to
653 misinterpreted the SES\-2 standard, specifically with its "element index"
655 index" field as per the SES\-2 standard and if that yields an inappropriate
657 misinterpretation. The SES\-3 drafts have introduced the EIIOE (Element
659 resolve this ambiguity. See the \fI\-\-eiioe=A_F\fR option.
661 In draft SES\-3 revision 5 the "Door Lock" element name was changed to
662 the "Door" (and an OPEN field was added to the status element). As a
667 It has been reported that some MegaRAID controllers do this and the
668 following command is needed to expose them:
674 There is a related command set called SAF\-TE (SCSI attached fault\-tolerant
675 enclosure) for enclosure (including RAID) status and control. SCSI devices
676 that support SAF\-TE report "Processor" peripheral device type (0x3) in their
678 safte\-monitor utility on the Internet.
680 The internal join array is statically allocated and its size is controlled
694    sg_ses \-\-page=cf /dev/bsg/6:0:2:0
698    sg_ses \-\-page=es /dev/bsg/6:0:2:0
703    sg_ses \-p aes \-D ArrayDevice07 \-G at_sas_addr \-H /dev/sg3
706 and Additional Element Status dpages the \fI\-\-join\fR option can be used:
708    sg_ses \-\-join /dev/sg3
711 much information add the \fI\-\-filter\fR option:
713    sg_ses \-\-join \-\-filter /dev/sg3
715 Fields in the various elements of the Enclosure Control and Threshold dpages
716 can be changed with the \fI\-\-clear=STR\fR and \fI\-\-set=STR\fR
717 options. [All modifiable dpages can be changed with the \fI\-\-raw\fR and
718 \fI\-\-data=H,H...\fR options.] The following example looks at making
722    sg_ses \-\-index=7 \-\-set=2:1:1 /dev/sg3
728    sg_ses \-\-descriptor=ArrayDevice07 \-\-set=2:1:1 /dev/sg3
730 Further the byte 2, bit 1 (for 1 bit) field in the Array Device Slot Control
735    sg_ses \-\-descriptor=ArrayDevice07 \-\-set=ident /dev/sg3
739    sg_ses \-\-dev\-slot\-num=7 \-\-clear=ident /dev/sg3
745 a modifiable diagnostic dpage. The String (In and Out) diagnostics dpage is
746 relatively simple (compared with the Enclosure Status/Control dpage). However
750    sg_ses \-\-page=str /dev/bsg/6:0:2:0
752 Now the "read" step. The following command will send the contents of the
757    sg_ses \-\-page=str \-\-raw /dev/bsg/6:0:2:0 > t
759 Then with the aid of the SES\-3 document (in revision 3: section 6.1.6)
763    sg_ses \-\-page=str \-\-control \-\-data=\- /dev/bsg/6:0:2:0 < t
768    sg_ses \-\-page=str /dev/bsg/6:0:2:0
772    sg_ses \-\-nickname='1st enclosure' \-\-control /dev/bsg/6:0:2:0
777    sg_ses \-\-page=all \-HHHH /dev/sg5 > enc_sg5_all.hex
780 they will appear on the command line (since only stdout is redirected).
786    sg_ses \-\-data=@enc_sg5_all.hex \-\-status \-\-join
795 Copyright \(co 2004\-2021 Douglas Gilbert
797 This software is distributed under a BSD\-2\-Clause license. There is NO
801 .B safte\-monitor (Internet)