.\" -*- nroff -*-
.\" 
.\" Japanese Version Copyright 1998 by MATSUMOTO Shoji. All Rights Reserved.
.\" Translated Fri Mar 13 02:58:01 JST 1998 by MATSUMOTO Shoji.
.\" Updated Sat 23 Oct 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Tue 16 Nov 1999 by NAKANO Takeo
.\" Updated & Modified Fri Aug 17 10:17:07 JST 2001
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\" Updated Tue 3 Oct 2002 by NAKANO Takeo
.\" Updated & Modified Sat Apr 17 11:53:16 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated & Modified Sat Apr 30 06:46:50 JST 2005 by Yuichi SATO
.\" 
.\"WORD:	bad blocks	不良ブロック
.\" 
.TH BADBLOCKS 8 "May 2006" "E2fsprogs version 1.39"
.SH 名前
badblocks \- デバイス上の不良ブロックを探す
.SH 書式
.B badblocks
[
.B \-svwnf
]
[
.B \-b
.I block-size
]
[
.B \-c
.I blocks_at_once
]
[
.B \-i
.I input_file
]
[
.B \-o
.I output_file
]
[
.B \-p
.I num_passes
]
[
.B \-t
.I test_pattern
]
.I device
[
.I last-block
] [
.I start-block 
]
.SH 説明
.B badblocks
はデバイス (通常はディスクパーティション) 上の
不良ブロックを探すために使用される。
.I device
はデバイスに対応するスペシャルファイルである (例:
.IR /dev/hdc1 )。
.I last-block
はチェックされる最終ブロックである。
指定されない場合、デフォルトではデバイスの最終ブロックが使われる。
.I start-block
は、テストを開始するブロックを指定するパラメータである (省略可能)。
これを用いると、ディスクの途中からテストを開始できる。
指定されない場合、デフォルトではディスクの開始ブロックが使われる。
.PP
.B 重要な注意:
.B badblocks
の出力を
.B e2fsck
や
.B mke2fs
といったプログラムに与える場合には、
ブロックサイズを正しく指定することが大切である。
生成されたブロック番号は、ファイルシステムにおいて、
どのようなブロックサイズを用いるかに大きく依存するからである。
このため、
.B badblocks
を直接ユーザが利用することはできるだけ避けるほうがよい。
代わりに
.B e2fsck
や
.B mke2fs
の
.B \-c
オプションを用いるようにすることを強く勧める。
.SH オプション
.TP
.BI -b " block-size"
ブロックサイズをバイト単位で指定する。
デフォルトは 1024 である。
.TP
.BI \-c " number of blocks"
ブロックをまとめて何個ずつテストするかを指定する。
デフォルトは 64 である。
.TP
.B \-f
通常 badblocks は、マウントされているデバイスに対しては、
読み出し／書き込みテストや非破壊テストを行わない。
このいずれもシステムをクラッシュさせたり、
(たとえリードオンリーでマウントされていても)
ファイルシステムを壊す可能性があるからである。
.B \-f
フラグを使えばこの動作を強制できるが、
まず用いないようにする方がよい。
自分が
.B badblocks
プログラムよりも賢いと考えるなら別だが、
ほとんどそんなことは無いはずだ。
このオプションが唯一安全なのは、/etc/mtab が間違っていて、
デバイスが実際にはマウントされていない場合だけである。
.TP
.BI \-i " input_file"
既存の不良ブロックのリストを読み込む。
不良ブロックであることが分かっているため、
.B badblocks
はこれらのブロックのテストを飛ばす。
.I input_file
が "-" と指定された場合、リストを標準入力から読み込む。
ここで挙げられたリストにあるブロックは、
標準出力や出力ファイルに書き出される
\fI新たに見つかった\fP不良ブロックのリストからは除かれる。
.BR dumpe2fs (8)
の
.B \-b
オプションを使うと、
既存のファイルシステム上で不良ブロックとして
マークされているブロックのリストを、
このオプションで使用するのに適した形式で取り出すことができる。
.TP
.BI -o " output_file"
指定されたファイルに不良ブロックのリストを書き出す。
このオプションを指定しない場合、
.B badblocks
は標準出力にリストを表示する。このファイルのフォーマットは、
.BR e2fsck (8)
や
.BR mke2fs (8)
の
.B \-l
オプションで使用するのに適している。
.TP
.BI \-p " num_passes"
新たな不良ブロックが見つからなくなるまで、
num_passes 回連続でディスクのスキャンを繰り返す。
デフォルトは 0 で、
.B badblocks
は最初の 1 回で終了する。
.TP
.BI \-t " test_pattern"
ディスクブロックから読み出す (ディスクブロックに書き込む)
テストパターンを指定する。
.I test_pattern
は 0 以上 ULONG_MAX-1 以下の数値でも文字列 "random" でもよい。
"random" はブロックをランダムなビットパターンで埋めることを表す。
読み出し／書き込み (\fB-w\fR) モードと非破壊 (\fB-n\fR) モードでは、
使いたい各テストパターンについて
.B -t
を指定することで、複数のテストパターンを指定することができる。
読み出しだけのモードでは 1 つのパターンしか指定することができず、
"random" は指定できない。
1 つのパターンを指定した読み出しだけのテストでは、
指定されたパターンが前もってディスクに書き込まれていると仮定する。
指定されたパターンが書き込まれていない場合は、
たくさんのブロックが検証に失敗する。
複数のパターンが指定された場合、
(1 つのブロックに対して) 1 つのパターンをテストした後に
次のパターンをテストするようにして、
全てのブロックをテストする。
.TP
.B \-n
非破壊の読み出し／書き込みモードを使う。
デフォルトでは、非破壊読み出しテストだけが行われる。
このオプションと
.B \-w 
オプションは一方しか指定できないので、同時に指定してはならない。
.TP
.B \-s
スキャンの進行状況を表示する。ブロックがチェックされるごとに
そのブロックの番号を書き出す。
.TP
.B \-v
詳細な表示を行う。
.TP
.B \-w
書き込みモードでテストする。このオプションを指定すると、
.B badblocks 
はデバイスの各ブロックに、あるパターン (0xaa, 0x55, 0xff, 0x00) を書き込み、
またそれを読み出して比べることにより、不良ブロックを探索する。
このオプションを
.B \-n 
オプションと組み合わせて使うことはできない。
この 2 つのオプションはどちらか一方しか指定できない。
.SH 警告
ファイルシステムが存在するデバイスに対して
.B \-w 
オプションを使用してはならない。
このオプションはデータを消去する。
既存のファイルシステムに書き込みモードテストをする場合は、
代わりに
.B \-n 
オプションを使うこと。
.B \-n 
オプションでのテストは遅いが、データは保存される。
.SH 著者
.B badblocks
は Remy Card <Remy.Card@linux.org> によって作成された。
現在のメンテナは Theodore Ts'o <tytso@alum.mit.edu> である。
非破壊の読み出し／書き込みテストは
David Beattie <dbeattie@softhome.net> が実装した。
.SH 入手方法
.B badblocks
は e2fsprogs パッケージの一部であり、
http://e2fsprogs.sourceforge.net で入手できる。
.SH 関連項目
.BR e2fsck (8),
.BR mke2fs (8)