~ubuntu-branches/ubuntu/wily/sg3-utils/wily

« back to all changes in this revision

Viewing changes to doc/sg_sat_set_features.8

  • Committer: Package Import Robot
  • Author(s): Ritesh Raj Sarraf
  • Date: 2013-06-23 16:08:01 UTC
  • mfrom: (1.2.7)
  • Revision ID: package-import@ubuntu.com-20130623160801-7rt7zb2dwk0ba7ut
Tags: 1.36-1
* [69e9dac] Imported Upstream version 1.36
* [cb75936] Add debian compat, level 7
* [68fed25] update README.source
* [3c724fc] Add build-dep autotools-dev
* [e4b9fdd] add destdir to install path
* [7cfff11] Simplify build with debhelper
* [f9a7540] Update symbols for 1.36 release
* [7b0b48d] Enable hardening build

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH SG_SAT_SET_FEATURES "8" "March 2011" "sg3_utils\-1.32" SG3_UTILS
 
1
.TH SG_SAT_SET_FEATURES "8" "April 2013" "sg3_utils\-1.36" SG3_UTILS
2
2
.SH NAME
3
 
sg_sat_set_features \- sends a ATA SET FEATURES command via a
4
 
SCSI to ATA Translation (SAT) layer
 
3
sg_sat_set_features \- use ATA SET FEATURES command via a SCSI to ATA
 
4
Translation (SAT) layer
5
5
.SH SYNOPSIS
6
6
.B sg_sat_set_features
7
 
[\fI\-\-count=\fRCO] [\fI\-\-ck_cond\fR] [\fI\-\-feature=\fRFEA]
8
 
[\fI\-\-help\fR] [\fI\-\-len=\fR16|12] [\fI\-\-lba=\fRLBA]
 
7
[\fI\-\-count=CO\fR] [\fI\-\-ck_cond\fR] [\fI\-\-feature=FEA\fR]
 
8
[\fI\-\-help\fR] [\fI\-\-lba=LBA\fR] [\fI\-\-len=\fR16|12]
9
9
[\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
10
10
.SH DESCRIPTION
11
11
.\" Add any additional description here
55
55
outputs the usage message summarizing command line options
56
56
then exits. Ignores \fIDEVICE\fR if given.
57
57
.TP
 
58
\fB\-L\fR, \fB\-\-lba\fR=\fILBA\fR
 
59
the number \fILBA\fR is placed in the "lba" field of the ATA SET
 
60
FEATURES command. Only some sub\-commands (a term used for the value
 
61
placed in the "feature" field) require the lba field to be set. This
 
62
value is typically not a "logical block address" as the acronym might
 
63
imply.  The default value placed in the "lba" field is 0. The maximum value
 
64
allowed for \fILBA\fR is 0xfffffffe (or 0xffffff if \fI\-\-len=\fR12).
 
65
.TP
58
66
\fB\-l\fR, \fB\-\-len\fR=16 | 12
59
67
this is the length of the SCSI cdb used for the ATA PASS\-THROUGH commands.
60
68
The argument can either be 16 or 12. The default is 16. Some SCSI
61
69
transports cannot convey SCSI commands longer than 12 bytes.
62
70
.TP
63
 
\fB\-L\fR, \fB\-\-lba\fR=\fILBA\fR
64
 
the number \fILBA\fR is placed in the "lba" field in the ATA SET
65
 
FEATURES command. Only some subcommands (a term used for the value
66
 
placed in the "feature" field) require the lba field to be set.
67
 
This value is not a "logical block address" as the acronym might imply.
68
 
The default value placed in the "lba" field is 0.
69
 
.TP
70
71
\fB\-v\fR, \fB\-\-verbose\fR
71
72
increases the level or verbosity.
72
73
.TP
74
75
print out version string
75
76
.SH NOTES
76
77
In the 2.4 series of Linux kernels the \fIDEVICE\fR must be
77
 
a SCSI generic (sg) device. In the 2.6 series block devices (e.g. disks
 
78
a SCSI generic (sg) device. In the 2.6 and 3 series block devices (e.g. disks
78
79
and ATAPI DVDs) can also be specified. For example "sg_inq /dev/sda"
79
80
will work in the 2.6 series kernels. From lk 2.6.6 other SCSI "char"
80
81
device names may be used as well (e.g. "/dev/st0m"). Prior to lk 2.6.29
84
85
The exit status of sg_sat_set_features is 0 when it is successful. Otherwise
85
86
see the sg3_utils(8) man page.
86
87
.SH AUTHOR
87
 
Written by Doug Gilbert
 
88
Written by Douglas Gilbert
88
89
.SH "REPORTING BUGS"
89
90
Report bugs to <dgilbert at interlog dot com>.
90
91
.SH COPYRIGHT
91
 
Copyright \(co 2007\-2011 Douglas Gilbert
 
92
Copyright \(co 2007\-2013 Douglas Gilbert
92
93
.br
93
94
This software is distributed under a FreeBSD license. There is NO
94
95
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
95
96
.SH "SEE ALSO"
96
 
.B sg_sat_identify(sg3_utils), sg_inq(sg3_utils), sdparm(sdparm), hdparm(hdparm)
 
97
.B sg_sat_identify(sg3_utils), sg_inq(sg3_utils), sdparm(sdparm),
 
98
.B hdparm(hdparm)