OSDN Git Service

Convert release and draft pages to UTF-8.
[linuxjm/jm.git] / manual / e2fsprogs / draft / man8 / badblocks.8
1 .\" -*- nroff -*-
2 .\" 
3 .\" Japanese Version Copyright 1998 by MATSUMOTO Shoji. All Rights Reserved.
4 .\" Translated Fri Mar 13 02:58:01 JST 1998 by MATSUMOTO Shoji.
5 .\" Updated Sat 23 Oct 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
6 .\" Updated Tue 16 Nov 1999 by NAKANO Takeo
7 .\" Updated & Modified Fri Aug 17 10:17:07 JST 2001
8 .\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
9 .\" Updated Tue 3 Oct 2002 by NAKANO Takeo
10 .\" Updated & Modified Sat Apr 17 11:53:16 JST 2004
11 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
12 .\" Updated & Modified Sat Apr 30 06:46:50 JST 2005 by Yuichi SATO
13 .\" 
14 .\"WORD:        bad blocks      不良ブロック
15 .\" 
16 .TH BADBLOCKS 8 "May 2006" "E2fsprogs version 1.39"
17 .\"O .SH NAME
18 .\"O badblocks \- search a device for bad blocks
19 .SH 名前
20 badblocks \- デバイス上の不良ブロックを探す
21 .\"O .SH SYNOPSIS
22 .SH 書式
23 .B badblocks
24 [
25 .B \-svwnf
26 ]
27 [
28 .B \-b
29 .I block-size
30 ]
31 [
32 .B \-c
33 .I blocks_at_once
34 ]
35 [
36 .B \-i
37 .I input_file
38 ]
39 [
40 .B \-o
41 .I output_file
42 ]
43 [
44 .B \-p
45 .I num_passes
46 ]
47 [
48 .B \-t
49 .I test_pattern
50 ]
51 .I device
52 [
53 .I last-block
54 ] [
55 .I start-block 
56 ]
57 .\"O .SH DESCRIPTION
58 .SH 説明
59 .\"O .B badblocks
60 .\"O is used to search for bad blocks on a device (usually a disk partition).
61 .B badblocks
62 はデバイス (通常はディスクパーティション) 上の
63 不良ブロックを探すために使用される。
64 .\"O .I device
65 .\"O is the special file corresponding to the device (e.g
66 .\"O .IR /dev/hdc1 ).
67 .I device
68 はデバイスに対応するスペシャルファイルである (例:
69 .IR /dev/hdc1 )。
70 .\"O .I last-block
71 .\"O is the last block to be checked; if it is not specified, the last block
72 .\"O on the device is used as a default.
73 .I last-block
74 はチェックされる最終ブロックである。
75 指定されない場合、デフォルトではデバイスの最終ブロックが使われる。
76 .\"O .I start-block
77 .\"O is an optional parameter specifying the starting block number
78 .\"O for the test, which allows the testing to start in the middle of the
79 .\"O disk.  If it is not specified the first block on the disk is used as a default.
80 .I start-block
81 は、テストを開始するブロックを指定するパラメータである (省略可能)。
82 これを用いると、ディスクの途中からテストを開始できる。
83 指定されない場合、デフォルトではディスクの開始ブロックが使われる。
84 .PP
85 .\"O .B Important note:
86 .\"O If the output of 
87 .\"O .B badblocks
88 .\"O is going to be fed to the
89 .\"O .B e2fsck
90 .\"O or 
91 .\"O .B mke2fs
92 .\"O programs, it is important that the block size is properly specified,
93 .\"O since the block numbers which are generated are very dependent on the 
94 .\"O block size in use by the filesystem.   
95 .B 重要な注意:
96 .B badblocks
97 の出力を
98 .B e2fsck
99
100 .B mke2fs
101 といったプログラムに与える場合には、
102 ブロックサイズを正しく指定することが大切である。
103 生成されたブロック番号は、ファイルシステムにおいて、
104 どのようなブロックサイズを用いるかに大きく依存するからである。
105 .\"O For this reason, it is strongly recommended that
106 .\"O users 
107 .\"O .B not
108 .\"O run 
109 .\"O .B badblocks 
110 .\"O directly, but rather use the 
111 .\"O .B \-c
112 .\"O option of the
113 .\"O .B e2fsck
114 .\"O and 
115 .\"O .B mke2fs
116 .\"O programs.
117 このため、
118 .B badblocks
119 を直接ユーザが利用することはできるだけ避けるほうがよい。
120 代わりに
121 .B e2fsck
122
123 .B mke2fs
124
125 .B \-c
126 オプションを用いるようにすることを強く勧める。
127 .\"O .SH OPTIONS
128 .SH オプション
129 .TP
130 .BI -b " block-size"
131 .\"O Specify the size of blocks in bytes.  The default is 1024.
132 ブロックサイズをバイト単位で指定する。
133 デフォルトは 1024 である。
134 .TP
135 .BI \-c " number of blocks"
136 .\"O is the number of blocks which are tested at a time.  The default is 64.
137 ブロックをまとめて何個ずつテストするかを指定する。
138 デフォルトは 64 である。
139 .TP
140 .B \-f
141 .\"O Normally, badblocks will refuse to do a read/write or a non-destructive
142 .\"O test on a device which is mounted, since either can cause the system to 
143 .\"O potentially crash and/or damage the filesystem even if it is mounted
144 .\"O read-only.  This can be overridden using the
145 .\"O .B \-f
146 .\"O flag, but should almost never be used --- if you think you're smarter
147 .\"O than the 
148 .\"O .B badblocks
149 .\"O program, you almost certainly aren't.  The only time when this option 
150 .\"O might be safe to use is if the /etc/mtab file is incorrect, and the device
151 .\"O really isn't mounted.
152 通常 badblocks は、マウントされているデバイスに対しては、
153 読み出し/書き込みテストや非破壊テストを行わない。
154 このいずれもシステムをクラッシュさせたり、
155 (たとえリードオンリーでマウントされていても)
156 ファイルシステムを壊す可能性があるからである。
157 .B \-f
158 フラグを使えばこの動作を強制できるが、
159 まず用いないようにする方がよい。
160 自分が
161 .B badblocks
162 プログラムよりも賢いと考えるなら別だが、
163 ほとんどそんなことは無いはずだ。
164 このオプションが唯一安全なのは、/etc/mtab が間違っていて、
165 デバイスが実際にはマウントされていない場合だけである。
166 .TP
167 .BI \-i " input_file"
168 .\"O Read a list of already existing known bad blocks.
169 .\"O .B Badblocks
170 .\"O will skip testing these blocks since they are known to be bad.  If
171 .\"O .I input_file
172 .\"O is specified as "-", the list will be read from the standard input.
173 .\"O Blocks listed in this list will be omitted from the list of
174 .\"O .I new
175 .\"O bad blocks produced on the standard output or in the output file.
176 既存の不良ブロックのリストを読み込む。
177 不良ブロックであることが分かっているため、
178 .B badblocks
179 はこれらのブロックのテストを飛ばす。
180 .I input_file
181 が "-" と指定された場合、リストを標準入力から読み込む。
182 ここで挙げられたリストにあるブロックは、
183 標準出力や出力ファイルに書き出される
184 \fI新たに見つかった\fP不良ブロックのリストからは除かれる。
185 .\"O The
186 .\"O .B \-b
187 .\"O option of
188 .\"O .BR dumpe2fs (8)
189 .\"O can be used to retrieve the list of blocks currently marked bad on
190 .\"O an existing filesystem, in a format suitable for use with this option.
191 .BR dumpe2fs (8)
192
193 .B \-b
194 オプションを使うと、
195 既存のファイルシステム上で不良ブロックとして
196 マークされているブロックのリストを、
197 このオプションで使用するのに適した形式で取り出すことができる。
198 .TP
199 .BI -o " output_file"
200 .\"O Write the list of bad blocks to the specified file.  Without this option,
201 .\"O .B badblocks
202 .\"O displays the list on its standard output.  The format of this file is suitable
203 .\"O for use by the
204 .\"O .B \-l
205 .\"O option in 
206 .\"O .BR e2fsck (8)
207 .\"O or
208 .\"O .BR mke2fs (8).
209 指定されたファイルに不良ブロックのリストを書き出す。
210 このオプションを指定しない場合、
211 .B badblocks
212 は標準出力にリストを表示する。このファイルのフォーマットは、
213 .BR e2fsck (8)
214
215 .BR mke2fs (8)
216
217 .B \-l
218 オプションで使用するのに適している。
219 .TP
220 .BI \-p " num_passes"
221 .\"O Repeat scanning the disk until there are no new blocks discovered in
222 .\"O num_passes consecutive scans of the disk.
223 .\"O Default is 0, meaning
224 .\"O .B badblocks
225 .\"O will exit after the first pass.
226 新たな不良ブロックが見つからなくなるまで、
227 num_passes 回連続でディスクのスキャンを繰り返す。
228 デフォルトは 0 で、
229 .B badblocks
230 は最初の 1 回で終了する。
231 .TP
232 .BI \-t " test_pattern"
233 .\"O Specify a test pattern to be read (and written) to disk blocks.   The
234 .\"O .I test_pattern
235 .\"O may either be a numeric value between 0 and ULONG_MAX-1 inclusive, or the word 
236 .\"O "random", which specifies that the block should be filled with a random
237 .\"O bit pattern.
238 ディスクブロックから読み出す (ディスクブロックに書き込む)
239 テストパターンを指定する。
240 .I test_pattern
241 は 0 以上 ULONG_MAX-1 以下の数値でも文字列 "random" でもよい。
242 "random" はブロックをランダムなビットパターンで埋めることを表す。
243 .\"O For read/write (\fB-w\fR) and non-destructive (\fB-n\fR) modes,
244 .\"O one or more test patterns may be specified by specifying the
245 .\"O .B -t
246 .\"O option for each test pattern desired.  For
247 .\"O read-only mode only a single pattern may be specified and it may not be
248 .\"O "random".  Read-only testing with a pattern assumes that the
249 .\"O specified pattern has previously been written to the disk - if not, large
250 .\"O numbers of blocks will fail verification.  
251 読み出し/書き込み (\fB-w\fR) モードと非破壊 (\fB-n\fR) モードでは、
252 使いたい各テストパターンについて
253 .B -t
254 を指定することで、複数のテストパターンを指定することができる。
255 読み出しだけのモードでは 1 つのパターンしか指定することができず、
256 "random" は指定できない。
257 1 つのパターンを指定した読み出しだけのテストでは、
258 指定されたパターンが前もってディスクに書き込まれていると仮定する。
259 指定されたパターンが書き込まれていない場合は、
260 たくさんのブロックが検証に失敗する。
261 .\"O If multiple patterns
262 .\"O are specified then all blocks will be tested with one pattern 
263 .\"O before proceeding to the next pattern.
264 複数のパターンが指定された場合、
265 (1 つのブロックに対して) 1 つのパターンをテストした後に
266 次のパターンをテストするようにして、
267 全てのブロックをテストする。
268 .TP
269 .B \-n
270 .\"O Use non-destructive read-write mode.  By default only a non-destructive 
271 .\"O read-only test is done.  This option must not be combined with the 
272 .\"O .B \-w
273 .\"O option, as they are mutually exclusive.
274 非破壊の読み出し/書き込みモードを使う。
275 デフォルトでは、非破壊読み出しテストだけが行われる。
276 このオプションと
277 .B \-w 
278 オプションは一方しか指定できないので、同時に指定してはならない。
279 .TP
280 .B \-s
281 .\"O Show the progress of the scan by writing out the block numbers as they
282 .\"O are checked.
283 スキャンの進行状況を表示する。ブロックがチェックされるごとに
284 そのブロックの番号を書き出す。
285 .TP
286 .B \-v
287 .\"O Verbose mode.
288 詳細な表示を行う。
289 .TP
290 .B \-w
291 .\"O Use write-mode test. With this option,
292 .\"O .B badblocks
293 .\"O scans for bad blocks by writing some patterns (0xaa, 0x55, 0xff, 0x00) on
294 .\"O every block of the device, reading every block and comparing the contents.  
295 .\"O This option may not be combined with the 
296 .\"O .B \-n 
297 .\"O option, as they are mutually exclusive.
298 書き込みモードでテストする。このオプションを指定すると、
299 .B badblocks 
300 はデバイスの各ブロックに、あるパターン (0xaa, 0x55, 0xff, 0x00) を書き込み、
301 またそれを読み出して比べることにより、不良ブロックを探索する。
302 このオプションを
303 .B \-n 
304 オプションと組み合わせて使うことはできない。
305 この 2 つのオプションはどちらか一方しか指定できない。
306 .\"O .SH WARNING
307 .SH 警告
308 .\"O Never use the
309 .\"O .B \-w
310 .\"O option on a device containing an existing file system.
311 .\"O This option erases data!  If you want to do write-mode testing on
312 .\"O an existing file system, use the
313 .\"O .B \-n
314 .\"O option instead.  It is slower, but it will preserve your data.  
315 ファイルシステムが存在するデバイスに対して
316 .B \-w 
317 オプションを使用してはならない。
318 このオプションはデータを消去する。
319 既存のファイルシステムに書き込みモードテストをする場合は、
320 代わりに
321 .B \-n 
322 オプションを使うこと。
323 .B \-n 
324 オプションでのテストは遅いが、データは保存される。
325 .\"O .SH AUTHOR
326 .SH 著者
327 .\"O .B badblocks
328 .\"O was written by Remy Card <Remy.Card@linux.org>.  Current maintainer is
329 .\"O Theodore Ts'o <tytso@alum.mit.edu>.  Non-destructive read/write test
330 .\"O implemented by David Beattie <dbeattie@softhome.net>.
331 .B badblocks
332 は Remy Card <Remy.Card@linux.org> によって作成された。
333 現在のメンテナは Theodore Ts'o <tytso@alum.mit.edu> である。
334 非破壊の読み出し/書き込みテストは
335 David Beattie <dbeattie@softhome.net> が実装した。
336 .\"O .SH AVAILABILITY
337 .SH 入手方法
338 .\"O .B badblocks
339 .\"O is part of the e2fsprogs package and is available from 
340 .\"O http://e2fsprogs.sourceforge.net.
341 .B badblocks
342 は e2fsprogs パッケージの一部であり、
343 http://e2fsprogs.sourceforge.net で入手できる。
344 .\"O .SH SEE ALSO
345 .SH 関連項目
346 .BR e2fsck (8),
347 .BR mke2fs (8)