.\" -*- 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 Wed Mar 11 03:38:49 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 Sun Sep  2 23:23:05 JST 2001
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\" Updated Sun 6 Oct 2002 by NAKANO Takeo
.\" Updated & Modified Sat Apr 17 14:16:33 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>, v1.35
.\" Updated & Modified Tue May  3 06:43:13 JST 2005 by Yuichi SATO, v1.37
.\" Updated & Modified Sat Feb 17 02:05:53 JST 2007 by Yuichi SATO, v1.39
.\" 
.\"WORD:	special file	スペシャルファイル
.\"WORD:        filesystem feature      ファイルシステム属性
.\"WORD:	bad blocks	不良ブロック
.\"WORD:	reserved blocks	予約ブロック
.\"WORD:	super-user	スーパーユーザ
.\"WORD:	native OS	ネイティブな OS
.\"WORD:	volume label	ボリュームラベル
.\"WORD:	revision	リビジョン
.\"WORD:	argument	引き数
.\"WORD:	RAID stripe	RAID ストライプ
.\"WORD:	AVAILABILITY	入手方法
.\" 
.TH MKE2FS 8 "May 2006" "E2fsprogs version 1.39"
.SH 名前
mke2fs \- ext2/ext3 ファイルシステムを作成する
.SH 書式
.B mke2fs
[
.B \-c
| 
.B \-l
.I filename
]
[
.B \-b
.I block-size
]
[
.B \-f
.I fragment-size
]
[
.B \-g
.I blocks-per-group
]
[
.B \-i
.I bytes-per-inode
]
[
.B \-j
]
[
.B \-J
.I journal-options
]
[
.B \-N
.I number-of-inodes
]
[
.B -n
]
[
.B \-m
.I reserved-blocks-percentage
]
[
.B \-o
.I creator-os
]
[
.B \-O 
.IR feature [,...]
]
[
.B \-q
]
[
.B \-r
.I fs-revision-level
]
[
.B \-E
.I extended-options
]
[
.B \-v
]
[
.B \-F
]
[
.B \-L
.I volume-label
]
[
.B \-M
.I last-mounted-directory
]
[
.B \-S
]
[
.B \-T
.I filesystem-type
]
[
.B \-V
]
.I device
[
.I blocks-count
]
.sp
.B "mke2fs \-O journal_dev"
[
.B \-b
.I block-size
]
.\" 外部ジャーナルに固有のオプションはまだない (サイズは無視される)
.\" [
.\" .B \-J
.\" .I journal-options
.\" ]
[
.B \-L
.I volume-label
]
[
.B \-n
]
[
.B \-q
]
[
.B \-v
]
.I external-journal
[
.I blocks-count
]


.SH 説明
.B mke2fs
は ext2/ext3 ファイルシステムを (通常はディスクのパーティションに) 作成する。
.I device
はデバイスに対応するスペシャルファイルである (例:
.IR /dev/hdXX )。
.I blocks-count
はデバイスのブロック数である。省略すると
.B mke2fs
が自動的にファイルシステムサイズを計算する。
.B mkfs.ext3
として起動されると、
.B \-j
オプションが指定された場合のようにジャーナルを作る。
.SH オプション
.TP
.BI \-b " block-size"
ブロックサイズをバイト単位で指定する。指定できるブロックサイズは
ブロックあたり 1024, 2048, 4096 バイトである。省略すると、
.B mke2fs
はファイルシステムのサイズと予想されるファイルシステムの利用法
.RB ( \-T
オプションを見よ) とからブロックサイズを
ヒューリスティック (heuristic) に基づいて決定する。
.I block-size
が負の数である場合、
.B mke2fs
はヒューリスティックを使って
適切なブロックサイズを決定する。
この場合、ブロックサイズを少なくとも
.I block-size
バイトにするという制限を付ける。
これは、ブロックサイズが 2k の倍数でなければいけない
特定のハードウェアなどで役に立つ。
.TP
.B \-c
デバイスにファイルシステムを作成する前に不良ブロックを検査する。
このオプションを 2 つ指定すると、
より遅い read-write テストを用いる。
1 つの場合は高速な read-only テストを用いる。
.TP
.BI \-E " extended-options"
ファイルシステムの拡張オプションを設定する。
拡張オプションはコンマで区切られ、
引き数がある場合は「= (イコール)」記号を使って指定する。
.B -E
オプションは、以前のバージョンの
.B mke2fs
では
.B -R
であった。
後方互換として
.B -R
オプションはまだ受け付けられる。
以下のオプションがサポートされている:
.RS 1.2i
.TP
.BI stride= stripe-size
RAID アレイのファイルシステムに対して、
1 ストライプあたりのファイルシステムブロックを
.I stripe-size
に設定する。
.TP
.BI resize= max-online-resize
ブロック数が max-online-resize のファイルシステムをサポートするために、
ブロックグループディスクリプタテーブルを拡大できる
十分な領域を予約する。
.RE
.TP
.BI \-f " fragment-size"
フラグメントサイズをバイト単位で指定する。
.TP
.B \-F
指定したデバイスがブロックスペシャルデバイスでない場合や、
マウントされている場合であっても、
.B mke2fs
を実行させる。
.TP
.BI \-g " blocks-per-group"
ブロックグループに含まれるブロック数を指定する。
デフォルトでファイルシステムに最適な値であるため、
ユーザがこのパラメータを設定する一般的な理由はない。
(RAID アレイ上にファイルシステムを作成しようとする管理者にとっては、
グループ毎のブロック数を操作するよりも、
.B \-R
オプションの一部として
.I stride
RAID パラメータを使う方がよい。)
一般にこのオプションは、テストケースを開発する開発者が使う。
.TP
.BI \-i " bytes-per-inode"
バイト数/inode 数の比率を指定する。
.B mke2fs
は、ディスク上の各
.I bytes-per-inode
バイトの領域に対してひとつの inode を生成する。
.I bytes-per-inode
比を大きくすると、作成される inode の数は少なくなる。
この値は、一般にはファイルシステムのブロックサイズより小さくすべきではない。
さもないと不必要に多くの inode が作られてしまう。
注意してほしいが、一度ファイルシステムを作成したら、
あとから inode の数を増やすことはできない。
したがって、このパラメータには正しい値を与えるよう、慎重になってほしい。
.TP
.B \-j
ext3 ジャーナルを持ったファイルシステムを作成する。
.B \-J 
オプションが指定されていない場合は、
デフォルトのジャーナルパラメータが用いられ、
(ファイルシステムのサイズに対して) 適切な大きさのジャーナルを作成して
ファイルシステムに格納する。
実際にジャーナルを利用するためには、
ext3 をサポートしたカーネルが必要である。
.TP
.BI \-J " journal-options"
コマンドラインで指定されたオプションを使って
ext3 ジャーナルを作成する。
ジャーナルオプションはコンマで区切り、
引き数がある場合は「= (イコール)」記号を使って指定する。
以下のオプションがサポートされている:
.RS 1.2i
.TP
.BI size= journal-size
内部ジャーナル (ファイルシステム内部に置かれるジャーナル) をサイズ
.I journal-size 
メガバイトで作成する。
ジャーナルのサイズは少なくともファイルシステムブロック 1024 個分より
大きくなくてはならない
(すなわち 1k のブロックなら 1MB、4k のブロックなら 4MB、など)。
またおそらく 102400 個分より大きくすべきではない。
.TP
.BI device= external-journal
ファイルシステムを
.I external-journal 
にあるジャーナルブロックデバイスにアタッチする。
外部ジャーナルは、前もって
.IP
.B mke2fs -O journal_dev 
.IR external-journal
.IP
コマンドで作成しておかなければならない。
また
.I external-journal
は、新しいファイルシステムと同じブロックサイズで
作成しなければならない。
さらに、1 つの外部ジャーナルに対して
複数ファイルシステムをアタッチすることはサポートされているが、現時点では、
Linux カーネルと
.BR e2fsck (8)
は外部ジャーナルの共有をサポートしていない。
.IP
デバイス名を直接指定する代わりに、
.BI LABEL= label
や
.BI UUID= UUID
という形式でも
.I external-journal
を指定できる。
この形式では、外部ジャーナルの場所を、
ジャーナルの先頭の ext2 スーパーブロックに格納されている
UUID やボリュームラベルで指定する。
ジャーナルデバイスのボリュームラベルと UUID を表示するには、
.BR dumpe2fs (8)
を使うこと。
.BR tune2fs (8)
の
.B -L
オプションも参照のこと。
.RE
.IP
ひとつのファイルシステムに対しては、
.BR size " オプションまたは " device
オプションのどちらか一方しか指定できない。
.TP
.BI \-l " filename"
不良ブロックのリストを
.I filename
から読み込む。このリストのブロック番号は、
mke2fs の用いるブロックサイズと同じもので作る必要がある。
よって、フォーマットの前にディスクの不良ブロックをチェックするには、
.B mke2fs
の
.B \-c
オプションを用いるほうが、ずっと単純かつ間違いの起こりにくい方法である。
このオプションを指定すれば、
.B mke2fs
は自動的に正しいパラメータを
.B badblocks
に渡すからである。
.TP
.BI \-L " new-volume-label"
ファイルシステムのボリュームラベルを
.I new-volume-label
に設定する。
ボリュームラベルの最大長は 16 バイトである。
.TP
.BI \-m " reserved-blocks-percentage"
スーパーユーザのみが利用できる予約ブロックのパーセンテージを指定する。
このオプションは断片化を防ぐとともに、
非特権プロセスによるファイルシステムへの書き込みが防止された後でも、
root が所有する
.BR syslogd (8)
といったデーモンが正しく機能し続けるようにする。
デフォルトのパーセンテージは 5% である。
.TP
.B \-M
ファイルシステムに、「最後にマウントされたディレクトリ」を設定する。
ファイルシステムがマウントされたディレクトリを検知して、
どこにファイルシステムをマウントすべきかを決定するような
ユーティリティに対して有用。
.TP
.B \-n
実際にはファイルシステムを作らないが、
あたかもファイルシステムを作成しているかのように表示を出す。
このオプションは、ある特定のファイルシステムのバックアップスーパーブロックの
位置を知るのに利用できる。
ただしこの際 mke2fs にはそのファイルシステムを作ったときと
同じパラメータを渡す必要がある
(もちろん
.B \-n
は加えてよい!)。
.TP
.BI \-N " number-of-inodes"
このファイルシステムに作成すべき
inode の個数に関するデフォルトの計算値を変更する
(計算値はブロックの個数と
.I bytes-per-inode
比をもとにしている)。
これによりユーザが必要な inode の個数を直接指定できる。
.TP
.BI \-o " creator-os"
ファイルシステムの「creator os」フィールドの値を手動で変更する。
通常「creator os」フィールドは
.B mke2fs
によってネイティブな OS に設定される。
.TP
.B "\-O \fIfeature\fR[,...]"
デフォルトのファイルシステムオプションを上書きし、
指定された属性 (ファイルシステムオプション) でファイルシステムを作成する。
デフォルトで有効にされる属性は、
.I base_features
リレーションで指定される。
このリレーションは、設定ファイル
.B /etc/mke2fs.conf
の
.I [libdefaults]
セクション、または
.B -T
オプションで指定されたファイルシステムタイプに対応する
.I [fs_types]
セクションのサブセクションにある。
.I [fs_types]
セクションにあるファイルシステムタイプに固有の設定は、
.I [libdefaults]
にある大域的なデフォルト値を上書きする。
.sp
ファイルシステム属性のセットは、以下の方法で更に変更できる。
このオプションで指定される属性セット指定で変更する。
このオプションが指定されない場合は、
作成されるファイルシステムタイプに対応する
.I default_features
リレーションで変更する。
設定ファイルの
.I [libdefaults]
セクションで変更する。
.sp
ファイルシステム属性セットは、
コンマで区切った属性のリストとして構成されており、
これに含まれる属性が有効にされる。
属性を無効にする場合は、単に属性名の前にキャレット ('^') 文字を置けばよい。
仮想的なファイルシステム属性 "none" は、
全てのファイルシステム属性をクリアする。
.RS 1.2i
.TP
.B dir_index
ハッシュ B ツリーを使い、
ファイルが多いディレクトリ内での検索を高速化する。
.TP
.B filetype
ディレクトリエントリにファイルタイプ情報を保存する。
.TP
.B has_journal
.RB ( \-j
オプションを使った場合のように) ext3 ジャーナルを作成する。
.TP
.B journal_dev
ext3 ジャーナルを、通常の ext2 ファイルシステム上にではなく、
指定されたデバイス上に作成する。
.I external-journal
は、それが使われるファイルシステムと
同じブロックサイズで作成されなければならない。
.TP
.B resize_inode
ブロックグループディスクリプタテーブルを
将来大きくできるように、領域を予約しておく。
.B resize2fs
を使ってオンラインでサイズ変更をするときに役立つ。
.B mke2fs
はデフォルトで十分な領域を予約するので、
ファイルシステムは初期サイズの 1024 倍まで大きくできる。
これは
.B resize
拡張オプションを使って変更できる。
.TP
.B sparse_super
スーパーブロックのバックアップコピーを少なくした
ファイルシステムを作成する
(大きなファイルシステムでは使用量を少なくできる)。
.RE
.TP
.B \-q
表示を抑制する。
.B mke2fs
をスクリプト内で実行する場合に有用。
.TP
.BI \-r " revision"
新しいファイルシステムに対してファイルシステムリビジョンを設定する。
1.2 系のカーネルはリビジョン 0 のファイルシステムにしか対応していない。
デフォルトではリビジョン 1 のファイルシステムを作成する。
.TP
.B \-S
スーパーブロックとグループディスクリプタのみを書き出す。
スーパーブロックもそのバックアップも壊れてしまい、
復旧の最終手段が必要な場合に有用。
このオプションを使用すると
mke2fs はスーパーブロックとグループディスクリプタを再初期化する。
inode テーブルとブロックそのものと inode ビットマップには手をつけない。
このオプションを使用した場合、ただちに
.B e2fsck
プログラムを使用しなければならない。
また、データが救済されるかどうかは保証の限りではない。
このオプションを使う際には、現在のファイルシステムの
ブロックサイズを指定することが重要である。
さもなければ、復帰できる見込みはない。
.\" .TP
.\" .BI \-t " test"
.\" ファイルシステムを作成する前に、
.\" 指定されたテストを使ってデバイスの不良ブロックを検査する。
.TP
.BI \-T " fs-type"
ファイルシステムの利用目的を指定し、 
.B mke2fs 
が最適なファイルシステムパラメータを選択できるようにする。
サポートできるファイルシステムタイプは、設定ファイル
.BR /etc/mke2fs.conf (5)
に定義されている。
デフォルトの設定ファイルには、ファイルシステムタイプ
small, floppy, news, largefile, largefile4 の定義が書かれている。
.TP
.B \-v
詳細な表示をする。
.TP
.B \-V
.B mke2fs
のバージョンを表示して終了する。
.SH 著者
このバージョンの
.B mke2fs
は Theodore Ts'o <tytso@mit.edu> によって作成された。
.SH バグ
.B mke2fs
には
.B \-f
オプションを付けることができるが、現時点では無視される。
現時点の ext2 ファイルシステムはフラグメントに対応していないからである。
.br
たぶん他にもあるだろう。見つけたら作者に連絡してほしい。
.SH 入手方法
.B mke2fs
は e2fsprogs パッケージの一部であり、
http://e2fsprogs.sourceforge.net
から入手できる。
.SH 関連項目
.BR mke2fs.conf (5),
.BR badblocks (8),
.BR dumpe2fs (8),
.BR e2fsck (8),
.BR tune2fs (8)