1
2
3BLKTOOL(8)                  System Manager's Manual                 BLKTOOL(8)
4
5
6

NAME

8       blktool - Display or change block device settings
9

SYNOPSIS

11       blktool [options] device [acoustic-mgmt nnn]
12
13       blktool [options] device [block-sz nnn]
14
15       blktool [options] device [bus-id]
16
17       blktool [options] device [bus-state nnn]
18
19       blktool [options] device [class]
20
21       blktool [options] device [cd-speed nnn]
22
23       blktool [options] device [defect-mgmt off|on]
24
25       blktool [options] device [dev-keep-settings off|on]
26
27       blktool [options] device [dev-read-ahead off|on]
28
29       blktool [options] device [dma off|on]
30
31       blktool [options] device [geometry]
32
33       blktool [options] device [i2o-rcache nnn]
34
35       blktool [options] device [i2o-wcache nnn]
36
37       blktool [options] device [id]
38
39       blktool [options] device [keep-settings off|on]
40
41       blktool [options] device [media unlock|lock]
42
43       blktool [options] device [multiple-count nnn]
44
45       blktool [options] device [no-write-err off|on]
46
47       blktool [options] device [pio-data 16-bit|32-bit]
48
49       blktool [options] device [pio-mode nnn]
50
51       blktool [options] device [pm-mode nnn]
52
53       blktool [options] device [queue-depth nnn]
54
55       blktool [options] device [read-ahead nnn]
56
57       blktool [options] device [readonly off|on]
58
59       blktool [options] device [reread-part]
60
61       blktool [options] device [reset]
62
63       blktool [options] device [sector-sz]
64
65       blktool [options] device [sleep]
66
67       blktool [options] device [standby]
68
69       blktool [options] device [unmask-irq off|on]
70
71       blktool [options] device [version]
72
73       blktool [options] [version]
74
75       blktool [options] device [wcache off|on]
76
77

DESCRIPTION

79       blktool  is  used  for  querying  and/or  changing  settings of a block
80       device.
81
82       device is the name of the block device to query or modify.
83
84

OPTIONS

86       -f     For a few commands, blktool will flush the buffers of the  block
87              device  out  to  disk,  before performing the requested command.
88              Specify this option,  "force",  disables  any  flushing  blktool
89              would attempt to do.
90
91
92       -t class
93              where  class is one of 'ide', 'ata', 'scsi', 'i2o', or 'auto' to
94              override the default auto-detection of device class.
95
96

COMMANDS

98       acoustic-mgmt
99              Query or set underlying device's acoustic level.
100
101
102       block-sz
103              Query or set device block size.
104
105
106       bus-id Query device bus id.
107
108
109       bus-state
110              Query or set device bus state (0 off, 1 on, 2 tristate)
111
112
113       class  Query the detected (or overridden, via -t) device class.   Typi‐
114              cally  this  will  result  in  'ATA' or 'SCSI' for most devices.
115              Detection is based on device major; thus your  SATA  device  may
116              appear as
117
118
119       cd-speed
120              Set CD-ROM device speed (in Kbytes/sec).
121
122
123       defect-mgmt
124              Toggle underlying device's defect management (obsolete).
125
126
127       dev-keep-settings
128              Toggle underlying device's revert-to-defaults-on-reset feature.
129
130
131       dev-read-ahead
132              Toggle underlying device's read-ahead feature.
133
134
135       dma    Toggle  DMA  data  transfer.   Omitting the on/off argument will
136              print the current state.
137
138
139       geometry
140              Query device geometry (cylinders / heads / sectors / etc.).
141
142
143       i2o-rcache
144              Query or set an I2O block device's read cache.
145
146
147       i2o-wcache
148              Query or set an I2O block device's write cache.
149
150
151       id     Query IDENTIFY [PACKET] DEVICE data.
152
153
154       keep-settings
155              Keep settings across device resets.  Omitting the  on/off  argu‐
156              ment will print the current state.
157
158
159       media  Lock in (or unlock) a removeable device.
160
161
162       multiple-count
163              Set multiple count for use in READ/WRITE MULTIPLE commands.
164
165
166       no-write-err
167              Toggle  ignore-write-errors  flag.  Omitting the on/off argument
168              will print the current state.
169
170
171       pio-data
172              ATA PIO data transfer via 16-bit or 32-bit  I/O.   Omitting  the
173              on/off argument will print the current state.
174
175
176       pio-mode
177              Set underlying ATA device's PIO data transfer mode.
178
179
180       pm-mode
181              Set underlying device's Advanced Power Management mode.
182
183
184       queued-depth
185              Query or set underlying device's queue depth.
186
187
188       read-ahead
189              Query or set block device read-ahead (in units of sectors).
190
191
192       readonly
193              Toggle  block  device  read-only  setting.   Omitting the on/off
194              argument will print the current state.
195
196
197       reread-part
198              Re-read partition table.
199
200
201       reset  Execute device reset.
202
203
204       sector-sz
205              Query device sector size.
206
207
208       sleep  Put device to sleep immediately.
209
210
211       standby
212              Put device in standby mode.
213
214
215       unmask-irq
216              Toggle unmasked irqs.  Omitting the on/off argument  will  print
217              the current state.
218
219
220       version
221              Print version number and exit.
222
223
224       wcache Toggle underlying device's writeback cache.
225
226

BUGS

228       Inevitably there are some.  Please report any you find.
229
230

AUTHOR

232       blktool was written by Jeff Garzik.
233
234

AVAILABILITY

236       blktool   is  available  over  the  Web  on  the  SourceForge  site  at
237       http://sourceforge.net/projects/gkernel/
238
239
240
241
242blktool version 4                 August 2004                       BLKTOOL(8)