aboutsummaryrefslogtreecommitdiff
path: root/doc/sg_read_block_limits.8
blob: 75bbd8e33733b9bf606d4066799dd693fb1e6c9c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
.TH SG_READ_BLOCK_LIMITS "8" "November 2022" "sg3_utils\-1.48" SG3_UTILS
.SH NAME
sg_read_block_limits \- send SCSI READ BLOCK LIMITS command
.SH SYNOPSIS
.B sg_read_block_limits
[\fI\-\-help\fR] [\fI\-\-hex\fR] [--mloi] [\fI\-\-raw\fR]
[\fI\-\-readonly\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR]
\fIDEVICE\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
Send a SCSI READ BLOCK LIMITS command to \fIDEVICE\fR and outputs the
response. This command is defined for tape (drives) and its description
is found in the SSC documents at https://www.t10.org .
.SH OPTIONS
Arguments to long options are mandatory for short options as well.
.TP
\fB\-h\fR, \fB\-\-help\fR
output the usage message then exit.
.TP
\fB\-H\fR, \fB\-\-hex\fR
output response in hex (rather than decode it).
.TP
\fB\-m\fR, \fB\-\-mloi\fR
sets the MLOI bit in the READ BLOCK LIMITS command and if that
succeeds, prints out the Maximum Logical Object Identifier (MLOI)
value. The MLOI bit was introduced in the ssc4r02.pdf draft.
.TP
\fB\-r\fR, \fB\-\-raw\fR
output response in binary to stdout.
.TP
\fB\-R\fR, \fB\-\-readonly\fR
open \fIDEVICE\fR in read\-only mode. The default is to open it in
read\-write mode.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
increase the level of verbosity, (i.e. debug output).
.TP
\fB\-V\fR, \fB\-\-version\fR
print the version string and then exit.
.SH EXIT STATUS
The exit status of sg_read_block_limits is 0 when it is successful. Otherwise
see the sg3_utils(8) man page.
.SH EXAMPLES
It is usually okay to use no options. Here is an invocation (on the first
line following the "#" command prompt) followed by some typical output:
.PP
   # sg_read_block_limits /dev/st0
.br
Read Block Limits results:
.br
    Minimum block size: 1 byte(s)
.br
    Maximum block size: 16777215 byte(s), 16383 KB, 15 MB
.br
    Granularity: 0
.br
.SH AUTHORS
Written by Douglas Gilbert.
.SH "REPORTING BUGS"
Report bugs to <dgilbert at interlog dot com>.
.SH COPYRIGHT
Copyright \(co 2009\-2022 Douglas Gilbert
.br
This software is distributed under a BSD\-2\-Clause license. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH "SEE ALSO"
.B sg3_utils(sg3_utils)