.\" -*- 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. .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .\" .\" 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 .\" Updated Tue 16 Nov 1999 by NAKANO Takeo .\" Updated & Modified Tue Aug 7 08:35:46 JST 2001 .\" by Yuichi SATO .\" 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 .\" 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 .\" .TH E2FSCK 8 "February 2012" "E2fsprogs version 1.42.1" .SH 名前 e2fsck \- Linux ext2/ext3/ext4 ファイルシステムをチェックする .SH 書式 \fBe2fsck\fP [ \fB\-pacnyrdfkvtDFV\fP ] [ \fB\-b\fP \fIsuperblock\fP ] [ \fB\-B\fP \fIblocksize\fP ] [ \fB\-l|\-L\fP \fIbad_blocks_file\fP ] [ \fB\-C\fP \fIfd\fP ] [ \fB\-j\fP \fIexternal\-journal\fP ] [ \fB\-E\fP \fIextended_options\fP ] \fIdevice\fP .SH 説明 \fBe2fsck\fP は ext2/ext3/ext4 系のファイルシステムのチェックに使われる。ジャーナルを使っているファイルシステム ext3 と ext4 の場合、システムがエラーはないが適切にシャットダウンされていなかった場合、通常は、ジャーナル内のコミット済みのトランザクションを再生した後は、そのファイルシステムには clean であるという印が付けられることになる。したがって、ジャーナルを使っているファイルシステムでは、スーパーブロックでさらなるチェックが必要とされていない限り、\fBe2fsck\fP は通常ジャーナルの再生を行い、終了することになる。 .PP \fIdevice\fP はファイルシステムが保存されているデバイスファイルである (例: \fIdev/hdc1\fP)。 .PP マウントされているファイルシステムに対して \fBe2fsck\fP を実行するのは、一般的に言って、安全でないという点に注意すること。 唯一の例外は、 \fB\-n\fP が指定されていて、かつ \fB\-c\fP, \fB\-l\fP, \fB\-L\fP オプションが指定されて\fIいない\fP場合である。 しかし安全に実行できたとしても、 ファイルシステムがマウントされているときに \fBe2fsck\fP で表示される結果は有効ではない。 マウントされているファイルシステムをチェックすべきか否かを \fBe2fsck\fP が質問してきた場合、唯一の正しい答えは \*(lqno\*(rq である。 何をしているかを本当に分かっているエキスパートのみが、 この質問に対して別の答えを出すかを考えるべきである。 .SH オプション .TP \fB\-a\fP このオプションは \fB\-p\fP オプションと同様のものとみなされる。 下位互換性のためにのみ準備されているオプションであるため、 できる限り \fB\-p\fP オプションを使うことが推奨される。 .TP \fB\-b\fP\fI superblock\fP 通常のスーパーブロックのかわりに、 \fIsuperblock\fP をスーパーブロックとして利用する。 このオプションが用いられるのは、 プライマリなスーパーブロックが壊れた場合である。 バックアップスーパーブロックの場所は、 ファイルシステムのブロックサイズによって異なる。 ファイルシステムのブロックサイズが 1k の場合、 バックアップスーパーブロックは 8193 にある。 また、ブロックサイズが 2k の場合は 16384 に、 4k の場合は 32768 にある。 .IP バックアップ用の追加スーパーブロックの位置を決めるには、 \fBmke2fs\fP プログラムを \fB\-n\fP オプション付きで実行して、 スーパーブロックが生成された場所を表示させればよい。 スーパーブロックの正確な場所を表示させたければ、 \fB\-b\fP オプションでファイルシステムのブロックサイズを指定して \fBmke2fs\fP を実行しなければならない。 .IP 代替スーパーブロックが指定され、 ファイルシステムが read\-only 以外で open されている場合、 e2fsck はファイルシステムのチェックが終わったときに プライマリのスーパーブロックを適切な値に更新するかどうかの 確認を求める。 .TP \fB\-B\fP\fI blocksize\fP 通常 \fBe2fsck\fP は、 適切なブロックサイズを探すために スーパーブロックを様々なブロックサイズでサーチする。 この作業は無駄な場合がある。このオプションは、 ブロックサイズを指定してスーパーブロックをサーチするよう指定する。 スーパーブロックが見つからない場合、 \fBe2fsck\fP は致命的なエラー (fatal error) で終了する。 .TP \fB\-c\fP このオプションを指定すると、 \fBe2fsck\fP は \fBbadblocks\fP(8) を使ってデバイスの read\-only スキャンを行い、不良ブロックを探す。 不良ブロックが見つかると、それを不良ブロック inode に加え、 ファイルやディレクトリとして確保 (allocate) されないようにする。 このオプションが 2 つ指定されると、 不良ブロックのスキャンは非破壊的 read\-write テストを用いて行われる。 .TP \fB\-C\fP\fI fd\fP このオプションを指定すると、 \fBe2fsck\fP は完了状況を指定されたファイルディスクリプタに書き込む。これにより、ファイルシステムチェックの進行状況を監視することができる。このオプションは通常 \fBe2fsck\fP を走らせているプログラムが使用する。ファイルディスクリプタ番号が負の場合、ファイルディスクリプタの絶対値がディスクリプタ値として使用され、最初は進行状況の出力が行わない。後で SIGUSR1 シグナルを \fBe2fsck\fP プロセスに送ることで出力を有効にできる。指定されたファイルディスクリプタが 0 の場合、 \fBe2fsck\fP は進行状況をプログレスバーで表示する。このためには、 \fBe2fsck\fP がビデオコンソールか端末で実行されている必要がある。 .TP \fB\-d\fP デバッグ情報を出力する (\fBe2fsck\fP をデバッグするときにしか役に立たない)。 .TP \fB\-D\fP ファイルシステム中のディレクトリを最適化する。 このオプションが指定された場合、 e2fsck はすべてのディレクトリの最適化を行おうとする。 ファイルシステムがディレクトリインデクシングをサポートしている場合には、 インデックスを再生成することで、 最適化を行う。 従来の線形的なディレクトリ構造を使うファイルシステムでは、 小さなディレクトリから順にソートして圧縮することで、 最適化を行う。 .IP \fB\-D\fP オプションが指定されていない場合でも、 \fBe2fsck\fP は時にはいくつかのディレクトリの最適化を行うことがある。 \-\-\- 例えば、 ディレクトリインデクシングが有効になっていて、 ディレクトリのインデックスが作成されておらず、インデックスを作成した方がよい場合や、インデックス構造が壊れていて作成し直す必要がある場合、などである。 \fB\-D\fP オプションを指定した場合、そのファイルシステムのすべてのディレクトリの最適化が行われる。その結果、場合によっては、少しサイズが小さくなったり、検索が早くなることがあるが、実際には、このオプションを使う必要がある場面はめったにないだろう。 .IP \fB\-D\fP オプションを指定すると、1 つのディレクトリ内の重複した名前のディレクトリエントリを検出する。通常 e2fsck は、性能上の理由からこの検出を行わない。 .TP \fB\-E\fP\fI extended_options\fP e2fsck に拡張オプションを設定する。 拡張オプション間はコンマで区切り、 等号 ('=') に続ける形で引数を取ることもできる。 次のオプションがサポートされている。 .RS 1.2i .TP \fBea_ver=\fP\fIextended_attribute_version\fP \fBe2fsck\fP がファイルシステムをチェックする際に必要な、拡張属性ブロックのバージョンを指定する。バージョン番号は 1 または 2 である。デフォルトの拡張属性バージョンフォーマットは 2 である。 .TP \fBjournal_only\fP 必要な場合にジャーナルの再生のみを行う。チェックや修復は行わない。 .TP \fBfragcheck\fP pass 1 で、ファイルシステムのファイルに不連続なブロックがある場合に、詳細なレポートを表示する。 .TP \fBdiscard\fP ファイルシステムチェックが完了した後に、空きブロックと未使用 inode を破棄する (ブロックの破棄は、ソリッドステートデバイスとスパース (sparse) / シンプロビジョニングされたストレージでは有益である)。破棄は、ファイルシステムの完全なチェックが行われ、かつ認識されたエラーがない場合にのみ、pass 5 で行われる。しかし、\fBe2fsck\fP が問題を認識できないケースでは、このオプションを使うと手動でのデータ修復ができなくなる。 .TP \fBnodiscard\fP 空きブロックと未使用 inode ブロックを破棄しない。このオプションは discard オプションと正反対である。これがデフォルトで設定されている。 .RE .TP \fB\-f\fP ファイルシステムが clean な場合でも、強制的にチェックする。 .TP \fB\-F\fP チェックを始める前に、ファイルシステムデバイスのキャッシュバッファを フラッシュする。 \fBe2fsck\fP を用いたタイムトライアルにのみ有用。 .TP \fB\-j\fP\fI external\-journal\fP このファイルシステムの外部ジャーナルがあるパス名を設定する。 .TP \fB\-k\fP \fB\-c\fP オプションと組み合わせると、 不良ブロックリストにある既存の不良ブロックは保存され、 \fBbadblocks\fP(8) を実行して見つかった新たな不良ブロックが 既存の不良ブロックリストに追加される。 .TP \fB\-l\fP\fI filename\fP \fIfilename\fP で指定したファイルにリストされているブロック番号を 不良ブロックのリストに追加する。このファイルのフォーマットは \fBbadblocks\fP(8) プログラムが出力するものと同じである。 ブロック番号はファイルシステムのブロックサイズに基づいていることに注意。 したがって正しい結果を得るためには \fBbadblocks\fP(8) にファイルシステムのブロックサイズを与えなければならない。 よって、 \fBe2fsck\fP に \fB\-c\fP オプションを与える方が、ずっと単純かつ安全である。 このオプションを指定すれば、正しいパラメータが \fBbadblocks\fP プログラムに渡ることになっている。 .TP \fB\-L\fP\fI filename\fP \fIfilename\fP で指定したファイルに書かれているブロックリストを、 不良ブロックのリストに指定する。 (このオプションは \fB\-l\fP オプションとは異なり、ファイルにリストされているブロックを 不良ブロックリストに加える前に、 不良ブロックリストをいったんクリアする。) .TP \fB\-n\fP ファイルシステムを read\-only で open し、全ての問いに対して「no」と答える。 \fBe2fsck\fP を非対話的に動作させることができる。 このオプションは \fB\-p\fP または \fB\-y\fP オプションと同時に指定してはならない。 .TP \fB\-p\fP ファイルシステムを質問なしで自動的に修復 (preen) する。 このオプションを指定すると、 \fBe2fsck\fP は安全に修正できるファイルシステムの問題を、 使用者と対話せずに自動的に修正する。 \fBe2fsck\fP は、システム管理者が別に正しい行動をとる必要のある問題を見つけると、 問題の説明を表示し、値 4 と返り値の論理 OR をとった値で終了する。 (「\fB返り値\fP」のセクションを参照すること。) 通常、このオプションはシステムのブートスクリプトで使われる。 このオプションは \fB\-n\fP または \fB\-y\fP オプションと同時に指定してはならない。 .TP \fB\-r\fP このオプションは何もしない。 過去との互換性のために準備されているだけである。 .TP \fB\-t\fP \fBe2fsck\fP のタイミング統計 (statistics) を表示する。 このオプションを 2 つ指定すると、より詳細なタイミング統計が 次々と得られる。 .TP \fB\-v\fP 詳細な表示をする。 .TP \fB\-V\fP バージョン情報を表示して終了する。 .TP \fB\-y\fP 全ての問いに対して「yes」と答える。これによって \fBe2fsck\fP を非対話的に動作させることができる。 このオプションは \fB\-n\fP または \fB\-p\fP オプションと同時に指定してはならない。 .SH 返り値 \fBe2fsck\fP の返り値は、以下の状態を表す数の和になる。 .br \ 0\ \-\ エラーなし .br \ 1\ \-\ ファイルシステムのエラーが修正された .br \ 2\ \-\ ファイルシステムのエラーが修正された。 .br \ \ \ \ システムをリブートしなければならない .br \ 4\ \-\ ファイルシステムのエラーが修正されないまま残っている .br \ 8\ \-\ 操作エラー .br \ 16\ \-\ 利用法・文法のエラー .br \ 32\ \-\ e2fsck がユーザ要求によってキャンセルされた .br \ 128\ \-\ 共有ライブラリのエラー .br .SH シグナル 以下のシグナルが \fBe2fsck\fP に送られると、記述されているような効果を及ぼす。 .TP \fBSIGUSR1\fP このシグナルを受けると \fBe2fsck\fP はプログレスバーを表示し、進捗情報を表示する。(\fB\-C\fP オプションの説明を参照。) .TP \fBSIGUSR2\fP このシグナルを受けると、\fBe2fsck\fP はプログレスバーの表示と、進捗情報の表示をやめる。 .SH バグ報告 どんなソフトウェアにもバグはつきものである。 もしも \fBe2fsck\fP がクラッシュしたり、 \fBe2fsck\fP によって修復できない事態が発生したりした場合は、 作者に連絡してほしい。 .PP バグ報告にはできるだけ多くの情報を入れてほしい。 \fBe2fsck\fP の完全な実行記録があれば、 私はどのようなエラーが発生しているかを確認することができる。 (\fBe2fsck\fP で表示されるメッセージが英語であることを確認してほしい。 \fBe2fsck\fP のメッセージが他の言語に翻訳されるようにシステムが設定されている場合は、 環境変数 \fBLC_ALL\fP を \fBC\fP に設定して、e2fsck の出力の実行記録が私にとって役立つようにしてほしい。) 実行記録を書き込むことのできるファイルシステムがあるなら、 \fBscript\fP(1) プログラムを用いれば、簡単に \fBe2fsck\fP の出力を保存できる。 .PP \fBdumpe2fs\fP(8) の出力も役に立つ。 特定の inode の不良が \fBe2fsck\fP の動作をおかしくしているようなら、 \fBdebugfs\fP(8) コマンドを起動し、該当する inode に対して \fIstat\fP コマンドを実行して、その出力を送ってほしい。 その inode がディレクトリである場合は、debugfs の \fIdump\fP コマンドを利用すれば、ディレクトリ inode の内容を取り出すことができる。 その内容を \fBuuencode\fP(1) にかければ、そのまま私に報告することができる。 バグを再現するためにユーザが送ることのできる最も有用なデータは、 \fBe2image\fP(8) を使って生成されるファイルシステムの圧縮された raw イメージダンプである。 より詳細な情報は \fBe2image\fP(8) を参照すること。 .PP 私に報告する際には、どのバージョンなのか私にわかるよう、 \fBe2fsck\fP の実行時に表示されるバージョン文字列を必ず入れてほしい。 .SH 作者 このバージョンの \fBe2fsck\fP は Theodore Ts'o が作成した。 .SH 関連項目 \fBe2fsck.conf\fP(5), \fBbadblocks\fP(8), \fBdumpe2fs\fP(8), \fBdebugfs\fP(8), \fBe2image\fP(8), \fBmke2fs\fP(8), \fBtune2fs\fP(8)