Lines Matching +full:command +full:- +full:line

1 .TH SG_OPCODES "8" "September 2022" "sg3_utils\-1.48" SG3_UTILS
3 sg_opcodes \- report supported SCSI commands or task management functions
6 [\fI\-\-alpha\fR] [\fI\-\-compact\fR] [\fI\-\-enumerate\fR] [\fI\-\-help\fR]
7 [\fI\-\-hex\fR] [\fI\-\-inhex=FN\fR] [\fI\-\-json[=JO]\fR] [\fI\-\-mask\fR]
8 [\fI\-\-mlu\fR] [\fI\-\-no-inquiry\fR] [\fI\-\-opcode=OP[,SA]\fR]
9 [\fI\-\-pdt=DT\fR] [\fI\-\-raw\fR] [\fI\-\-rctd\fR] [\fI\-\-repd\fR]
10 [\fI\-\-sa=SA\fR] [\fI\-\-tmf\fR] [\fI\-\-unsorted\fR] [\fI\-\-verbose\fR]
11 [\fI\-\-version\fR] \fIDEVICE\fR
14 [\fI\-a\fR] [\fI\-c\fR] [\fI\-e\fR] [\fI\-H\fR] [\fI\-i=FN\fR] [\fI\-j\fR]
15 [\fI\-m\fR] [\fI\-M\fR] [\fI\-n\fR] [\fI\-o=OP\fR] [\fI\-p=DT\fR] [\fI\-q\fR]
16 [\fI\-R\fR] [\fI\-s=SA\fR] [\fI\-t\fR] [\fI\-u\fR] [\fI\-v\fR] [\fI\-V\fR]
17 [\fI\-?\fR] \fIDEVICE\fR
22 SUPPORTED TASK MANAGEMENT FUNCTIONS command to the \fIDEVICE\fR and then
25 detailed information on a specific command identified by the
26 \fI\-\-opcode=OP\fR option (perhaps with additional information from the
27 \fI\-\-sa=SA\fR option).
29 The name of a SCSI command depends on its peripheral device type (e.g. a
31 MANAGEMENT FUNCTIONS commands are not supported in the MMC command set for
36 via the CmdDt bit in the SCSI INQUIRY command (see sg_inq(8)). However that
38 CODES command in SPC\-3 (revision 4) during February 2002.
40 This utility supports two command line syntaxes, the preferred one is
42 on the old command line syntax outlines the second group of options.
46 \fB\-a\fR, \fB\-\-alpha\fR
50 name (alphabetically). When this option and the \fB\-\-unsorted\fR option are
54 \fB\-c\fR, \fB\-\-compact\fR
55 some command names, especially those associated with some service actions,
56 are getting longer. This may cause line wrap in the one line per command
60 action associated with the command, then the comma and the service action
64 \fB\-e\fR, \fB\-\-enumerate\fR
65 this option prints the name of the SCSI command based on the given opcode,
73 \fB\-h\fR, \fB\-\-help\fR
74 outputs the usage message summarizing command line options
77 \fB\-H\fR, \fB\-\-hex\fR
79 twice, each line starts with a relative (hex) address starting at 0
80 on the first hex line output. The difference is when used twice the
81 hexadecimal bytes are rendered in ASCII at the right of each line;
82 non\-printable characters are replaced by "." .
85 on each line. This output is suitable for being redirected to a file
86 which can later by given to the \fI\-\-inhex=FN\fR option.
88 \fB\-i\fR, \fB\-\-inhex\fR=\fIFN\fR
93 sg3_utils manpage for more information. If the \fI\-\-raw\fR option is
96 \fB\-j\fR, \fB\-\-json[\fR=\fIJO\fR]
100 \fB\-m\fR, \fB\-\-mask\fR
109 \fB\-M\fR, \fB\-\-mlu\fR
110 additionally prints out an indication (0 or 1) whether the command
113 introduced by proposal 18\-045r1 (and possibly in spc5r20). Without
117 \fB\-n\fR, \fB\-\-no-inquiry\fR
119 SUPPORTED TASK MANAGEMENT FUNCTIONS command, a SCSI INQUIRY command
122 to the command names. By default this utility prints a summary of INQUIRY
123 command response on stdout. If this option (or the \fI\-\-raw\fR option)
126 \fB\-O\fR, \fB\-\-old\fR
129 \fB\-o\fR, \fB\-\-opcode\fR=\fIOP[,SA]\fR
131 \fIOP\fR value) which is the first byte of a SCSI command. Optionally, if
132 a \fISA\fR value is given, it will be used as that SCSI command's service
134 does allow the service action to be 0 (but not in this command). \fIOP\fR
141 \fB\-p\fR, \fB\-\-pdt\fR=\fIDT\fR
143 the \fI\-\-enumerate\fR to differentiate when a command opcode (and perhaps
146 This option may also be used with the \fI\-\-no-inquiry\fR option to
147 suppress this utility doing an INQUIRY command since the main reason
150 \fB\-r\fR, \fB\-\-raw\fR
151 output response in binary (to stdout) unless the \fI\-\-inhex=FN\fR option
155 \fB\-R\fR, \fB\-\-rctd\fR
156 set report command timeout descriptor (RCTD) bit in the cdb. The response
157 may or may not contain command timeout descriptors. If available they are
158 output. If supported there are two values: a nominal command timeout
159 and a recommended command timeout. Both have units of seconds. A value
161 the corresponding decoded output as "\-".
163 \fB\-q\fR, \fB\-\-repd\fR
166 response. This was added in SPC\-4 (revision 26).
168 \fB\-s\fR, \fB\-\-sa\fR=\fISA\fR
169 the \fIDEVICE\fR will be queried for a command with the given service
171 \fI\-\-opcode=OP\fR option. If this option is not given, \fI\-\-opcode=OP\fR
172 is given and the command in question does have a service action then a value
176 \fB\-t\fR, \fB\-\-tmf\fR
178 SUPPORTED TASK MANAGEMENT FUNCTIONS command.  When this option is chosen
179 the \fI\-\-alpha\fR, \fI\-\-opcode=OP\fR, \fI\-\-rctd\fR, \fI\-\-sa=SA\fR
180 and \fI\-\-unsorted\fR options are ignored.
182 \fB\-u\fR, \fB\-\-unsorted\fR
189 \fB\-v\fR, \fB\-\-verbose\fR
192 \fB\-V\fR, \fB\-\-version\fR
195 As of SPC\-5 revision 8 the recognized task management functions are:
198 In SPC\-4 revision 26 target reset and wakeup task management functions
208 .SH OLDER COMMAND LINE OPTIONS
210 version 1.23 . Since then this utility defaults to the newer command line
211 options which can be overridden by using \fI\-\-old\fR (or \fI\-O\fR) as the
213 force the use of these older command line options.
215 \fB\-a\fR
216 sort command alphabetically. Equivalent to \fI\-\-alpha\fR in main
219 \fB\-c\fR
220 see the \fI\-\-compact\fR option above.
222 \fB\-e\fR
223 see the \fI\-\-enumerate\fR option above.
225 \fB\-H\fR
226 see the \fI\-\-hex\fR option above.
228 \fB\-m\fR
229 see the \fI\-\-mask\fR option above.
231 \fB\-n\fR
234 \fB-N\fR, \fB\-\-new\fR
237 \fB\-o\fR=\fIOP\fR
239 \fIOP\fR) which is the first byte of a SCSI command. \fIOP\fR is
244 \fB\-p\fR=\fIDT\fR
245 see the \fI\-\-pdt=DT\fR option above.
247 \fB\-q\fR
249 Equivalent to \fI\-\-repd\fR in main description.
251 \fB\-R\fR
252 set the report command timeout descriptor (RCTD) bit in cdb. Equivalent
253 to \fI\-\-rctd\fR in main description.
255 \fB\-s\fR=\fISA\fR
256 the \fIDEVICE\fR will be queried for a command with the given service
257 action (i.e. \fISA\fR). Used in conjunction with the \fI\-o=OP\fR
258 option. If this option is not given, \fI\-o=OP\fR is given and the command
262 \fB\-t\fR
263 list supported task management functions. Equivalent to \fI\-\-tmf\fR in
266 \fB\-u\fR
268 Equivalent to \fI\-\-unsorted\fR in main description.
270 \fB\-v\fR
273 \fB\-V\fR
276 \fB\-?\fR
282 To see the information about a specific command give its operation
283 code to the '\-\-op=' option. A command line invocation is shown first
286    # sg_opcodes \-\-op=93h /dev/sdb
292   Command supported [conforming to SCSI standard]
298    # sg_opcodes \-\-tmf \-n /dev/sdb
314 Enumerate can be used to look up a SCSI command name in the absence of a
315 device that supports that command. The opcode and service action (if
318    # sg_opcodes \-\-enumerate \-\-op=0x9b,0xa
320   SCSI command:
326 can be given. When it is present this utility will expect the older command
327 line options. So the presence of this environment variable is equivalent to
328 using \fI\-\-old\fR (or \fI\-O\fR) as the first command line option.
334 Copyright \(co 2004\-2022 Douglas Gilbert