.\" -*- nroff -*-
.\" Copyright 1993, 1994, 1995 by Theodore Ts'o.  All Rights Reserved.
.\" This file may be copied under the terms of the GNU Public License.
.\" 
.\" Japanese Version Copyright 1998 by MATSUMOTO Shoji. All Rights Reserved.
.\" Translated Thu Mar 12 12:06:45 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 Tue Aug  7 08:35:46 JST 2001
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\" Updated & Modified Sun Sep  9 22:13:00 JST 2001 by Yuichi SATO
.\" Updated Fri 4 Oct 2002 by NAKANO Takeo
.\" Updated & Modified Sat Apr 17 02:08:36 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated & Modified Tue Dec 20 06:30:28 JST 2005 by Yuichi SATO
.\" Updated & Modified Sun Oct 29 02:07:11 JST 2006 by Yuichi SATO
.\"
.\"WORD:	fatal error	致命的なエラー(fatal error)
.\"WORD:	bad block	不良ブロック
.\"WORD:	non-interactively	非対話的に
.\"WORD:	byte-swap	バイトスワップ(エンディアン)
.\"WORD:	byte-order	バイトオーダー
.\"WORD:	statistics	統計(statistisc)
.\"WORD:	verbose		詳細な
.\"WORD:	REPORTING BUGS	バグ報告
.\"WORD:	crush		クラッシュ
.\"WORD:	reboot		リブート
.\"WORD:	transcript	実行記録
.\" 
.TH E2FSCK 8 "May 2006" "E2fsprogs version 1.39"
.SH 名前
e2fsck \- Linux ext2/ext3 ファイルシステムをチェックする
.SH 書式
.B e2fsck
[
.B \-pacnyrdfkvstDFSV
]
[
.B \-b
.I superblock
]
[
.B \-B
.I blocksize
]
[
.B \-l|\-L
.I bad_blocks_file
]
[
.B \-C
.I fd
]
[
.B \-j
.I external-journal
]
[
.B \-E
.I extended_options
]
.I device
.SH 説明
.B e2fsck
は Linux 第 2 拡張ファイルシステム (ext2fs) をチェックする。
e2fsck はジャーナル付きの ext2 ファイルシステムもサポートする。
このファイルシステムは ext3 ファイルシステムとも呼ばれ、
この場合は通常の
.B e2fsck
処理を行う前に、まずジャーナルをファイルシステムに適用する。
ジャーナルを適用した後、ファイルシステムは通常
clean であるとマークされる。
よって、ext3 ファイルシステムに対しては、
.B e2fsck
は通常ジャーナルを実行して終了するだけになる
(ただしスーパーブロックに、
より詳細なチェックを要求する内容が記述されている場合は別)。
.PP
.I device
はファイルシステムが保存されているデバイスファイルである (例:
.IR dev/hdc1 )。
.PP
マウントされているファイルシステムに対して
.B e2fsck
を実行するのは、一般的に言って、安全でないという点に注意すること。
唯一の例外は、
.B \-n
が指定されていて、かつ
.BR \-c , 
.BR \-l ,
.B -L
オプションが指定されて\fIいない\fR場合である。
しかし安全に実行できたとしても、
ファイルシステムがマウントされているときに
.B e2fsck
で表示される結果は有効ではない。
マウントされているファイルシステムをチェックすべきか否かを
.B e2fsck
が質問してきた場合、唯一の正しい答えは ``no'' である。
何をしているかを本当に分かっているエキスパートのみが、
この質問に対して別の答えを出すかを考えるべきである。
.SH オプション
.TP
.B \-a 
このオプションは
.B \-p
オプションと同様のものとみなされる。
下位互換性のためにのみ準備されているオプションであるため、
できる限り
.B -p
オプションを使うことが推奨される。
.TP
.BI \-b " superblock"
通常のスーパーブロックのかわりに、
.IR superblock 
をスーパーブロックとして利用する。
このオプションが用いられるのは、
プライマリなスーパーブロックが壊れた場合である。
バックアップスーパーブロックの場所は、
ファイルシステムのブロックサイズによって異なる。
ファイルシステムのブロックサイズが 1k の場合、
バックアップスーパーブロックは 8193 にある。
また、ブロックサイズが 2k の場合は 16384 に、
4k の場合は 32768 にある。
.IP
バックアップ用の追加スーパーブロックの位置を決めるには、
.B mke2fs 
プログラムを
.B \-n
オプション付きで実行して、
スーパーブロックが生成された場所を表示させればよい。
スーパーブロックの正確な場所を表示させたければ、
.B \-b 
オプションでファイルシステムのブロックサイズを指定して
.B mke2fs
を実行しなければならない。
.IP
代替スーパーブロックが指定され、
ファイルシステムが read-only 以外で open されている場合、
e2fsck はファイルシステムのチェックが終わったときに
プライマリのスーパーブロックを適切な値に更新するかどうかの
確認を求める。
.TP
.BI \-B " blocksize"
通常
.B e2fsck 
は、
適切なブロックサイズを探すために
スーパーブロックを様々なブロックサイズでサーチする。
この作業は無駄な場合がある。このオプションは、
ブロックサイズを指定してスーパーブロックをサーチするよう指定する。
スーパーブロックが見つからない場合、
.B e2fsck
は致命的なエラー (fatal error) で終了する。
.TP
.B \-c
このオプションを指定すると、
.B e2fsck
は
.BR badblocks (8)
を使ってデバイスの read-only スキャンを行い、不良ブロックを探す。
不良ブロックが見つかると、それを不良ブロック inode に加え、
ファイルやディレクトリとして確保 (allocate) されないようにする。
このオプションが 2 つ指定されると、
不良ブロックのスキャンは非破壊的 read-write テストを用いて行われる。
.TP
.BI \-C " fd"
このオプションを指定すると
.B e2fsck
は作業状況を指定したファイルディスクリプタに書き出し、
ファイルシステムのチェックの進行状況をモニターできるようにする。
このオプションは、
.BR e2fsck
を動作させるプログラムから良く用いられる。
指定されたファイルディスクリプタが 0 の場合、
.B e2fsck
は作業を進めるごとに棒グラフを出力する。
この動作をさせるには、
.B e2fsck
をビデオコンソールか端末から実行する必要がある。
.TP
.B \-d
デバッグ情報を出力する
.RB ( e2fsck 
をデバッグするときにしか役に立たない)。
.TP
.B \-D
ファイルシステム中のディレクトリを最適化する。
このオプションを指定すると、
e2fsck はすべてのディレクトリを最適化しようとする。
ファイルシステムがディレクトリインデクシングをサポートしていれば、
インデックスを再生成する。
また従来の線形的なディレクトリ構造を使うファイルシステムでは、
小さなディレクトリから順にソートして圧縮する。
.TP
.BI \-E " extended_options"
e2fsck に拡張オプションを設定する。
拡張オプション間はコンマで区切り、
等号 ('=') に続ける形で引数を取ることもできる。
次のオプションがサポートされている。
.RS 1.2i
.TP
.BI ea_ver= extended_attribute_version
対象ファイルシステムの拡張属性ブロックのフォーマットを、
指定したバージョン番号のものであると仮定する。
バージョン番号には 1 または 2 が指定できる。
デフォルトの拡張属性フォーマットのバージョンは 2 である。
.RE
.TP
.B \-f
ファイルシステムが clean な場合でも、強制的にチェックする。
.TP
.B \-F
チェックを始める前に、ファイルシステムデバイスのキャッシュバッファを
フラッシュする。
.B e2fsck
を用いたタイムトライアルにのみ有用。
.TP
.BI \-j " external-journal"
このファイルシステムの外部ジャーナルがあるパス名を設定する。
.TP
.BI \-k
.B \-c
オプションと組み合わせると、
不良ブロックリストにある既存の不良ブロックは保存され、
.BR badblocks (8) 
を実行して見つかった新たな不良ブロックが
既存の不良ブロックリストに追加される。
.TP
.BI \-l " filename"
.I filename
で指定したファイルにリストされているブロック番号を
不良ブロックのリストに追加する。このファイルのフォーマットは
.BR badblocks (8)
プログラムが出力するものと同じである。
ブロック番号はファイルシステムのブロックサイズに基づいていることに注意。
したがって正しい結果を得るためには
.BR badblocks (8)
にファイルシステムのブロックサイズを与えなければならない。
よって、
.BR e2fsck
に
.B \-c
オプションを与える方が、ずっと単純かつ安全である。
このオプションを指定すれば、正しいパラメータが
.B badblocks
プログラムに渡ることになっている。
.TP
.BI \-L " filename"
.IR filename
で指定したファイルに書かれているブロックリストを、
不良ブロックのリストに指定する。
(このオプションは
.B \-l
オプションとは異なり、ファイルにリストされているブロックを
不良ブロックリストに加える前に、
不良ブロックリストをいったんクリアする。)
.TP
.B \-n
ファイルシステムを read-only で open し、全ての問いに対して「no」と答える。
.B e2fsck
を非対話的に動作させることができる。(注意:
.B \-n
オプションに加えて
.BR \-c ,
.BR \-l ,
.B \-L
のいずれかのオプションを付加した場合は、
不良ブロックリストを更新するためにファイルシステムは
read/write でオープンされる。
ただしファイルシステム自体は変更されない。)
このオプションは
.B \-p
または
.B \-y
オプションと同時に指定してはならない。
.TP
.B \-p
ファイルシステムを質問なしで自動的に修復 (preen) する。
このオプションを指定すると、
.B e2fsck
は安全に修正できるファイルシステムの問題を、
使用者と対話せずに自動的に修正する。
.B e2fsck
は、システム管理者が別に正しい行動をとる必要のある問題を見つけると、
問題の説明を表示し、値 4 と返り値の論理 OR をとった値で終了する。
(「\fB返り値\fR」のセクションを参照すること。)
通常、このオプションはシステムのブートスクリプトで使われる。
このオプションは
.B \-n
または
.B \-y
オプションと同時に指定してはならない。
.TP
.B \-r
このオプションは何もしない。
過去との互換性のために準備されているだけである。
.TP 
.B \-s
このオプションはファイルシステムのバイトスワップ (エンディアンの変更) を行う。
すなわち、i386 やリトルエンディアンで標準的なバイトオーダーにする。
ファイルシステムがすでに標準的なバイトオーダーになっているならば、
.B e2fsck
は何もしない。
.TP
.B \-S
ファイルシステムがバイトスワップされている場合でも、
現在のバイトオーダーを保つ。
.TP
.B \-t
.B e2fsck
のタイミング統計 (statistics) を表示する。
このオプションを 2 つ指定すると、より詳細なタイミング統計が
次々と得られる。
.TP
.B \-v
詳細な表示をする。
.TP
.B \-V
バージョン情報を表示して終了する。
.TP
.B \-y
全ての問いに対して「yes」と答える。これによって
.B e2fsck
を非対話的に動作させることができる。
このオプションは
.B \-n
または
.B \-p
オプションと同時に指定してはならない。
.SH 返り値
.B e2fsck
の返り値は、以下の状態を表す数の和になる。
.br
\	0\	\-\ エラーなし
.br
\	1\	\-\ ファイルシステムのエラーが修正された
.br
\	2\	\-\ ファイルシステムのエラーが修正された。
.br
\	\	\ \ システムをリブートしなければならない
.br
\	4\	\-\ ファイルシステムのエラーが修正されないまま
.br
\	\	\ \ 残っている
.br
\	8\	\-\ 操作エラー
.br
\	16\	\-\ 利用法・文法のエラー
.br
\	32\	\-\ e2fsck がユーザ要求によってキャンセルされた
.br
\	128\	\-\ 共有ライブラリエラー
.SH シグナル
以下のシグナルが
.B e2fsck
に送られると、記述されているような効果を及ぼす。
.TP
.B SIGUSR1
このシグナルを送ると
.B e2fsck
は作業状況の棒グラフの表示を始める
.RI ( \-C
オプションの記述を見よ)。
.TP
.B SIGUSR2
このシグナルを送ると
.B e2fsck
は作業状況の棒グラフの表示をやめる。
.SH バグ報告
どんなソフトウェアにもバグはつきものである。
もしも
.B e2fsck 
がクラッシュしたり、
.B e2fsck
によって修復できない事態が発生したりした場合は、
作者に連絡してほしい。
.PP
バグ報告にはできるだけ多くの情報を入れてほしい。
.B e2fsck 
の完全な実行記録があれば、
私はどのようなエラーが発生しているかを確認することができる。
.RB ( e2fsck
で表示されるメッセージが英語であることを確認してほしい。
.B e2fsck
のメッセージが他の言語に翻訳されるようにシステムが設定されている場合は、
環境変数
.B LC_ALL
を
.B C
に設定して、e2fsck の出力の実行記録が私にとって役立つようにしてほしい。)
実行記録を書き込むことのできるファイルシステムがあるなら、
.BR script (1)
プログラムを用いれば、簡単に
.B e2fsck
の出力を保存できる。
.PP
.BR dumpe2fs (8)
の出力も役に立つ。
特定の inode の不良が
.B e2fsck 
の動作をおかしくしているようなら、
.BR debugfs (8)
コマンドを起動し、該当する inode に対して
.I stat
コマンドを実行して、その出力を送ってほしい。
その inode がディレクトリである場合は、debugfs の
.I dump
コマンドを利用すれば、ディレクトリ inode の内容を取り出すことができる。
その内容を
.BR uuencode (1)
にかければ、そのまま私に報告することができる。
バグを再現するためにユーザが送ることのできる最も有用なデータは、
.BR e2image (8)
を使って生成されるファイルシステムの圧縮された raw イメージダンプである。
より詳細な情報は
.BR e2image (8)
を参照すること。
.PP
私に報告する際には、どのバージョンなのか私にわかるよう、
.B e2fsck
の実行時に表示されるバージョン文字列を必ず入れてほしい。
.SH 著者
このバージョンの
.B e2fsck
は、Theodore Ts'o <tytso@mit.edu> によって作成された。
.SH 関連項目
.BR badblocks (8),
.BR dumpe2fs (8),
.BR debugfs (8),
.BR e2image (8),
.BR mke2fs (8),
.BR tune2fs (8)