.\" -*- nroff -*-
.\" Copyright 1996-2004 Hans Reiser.
.\" 
.\" Japanese Version Copyright (c) 2002-2005 Yuichi SATO
.\"         all rights reserved.
.\" Translated Sun Apr 14 14:45:41 JST 2002
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\" Updated & Modified Sat May  8 13:37:25 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated & Modified Sat Mar  5 21:46:42 JST 2005 by Yuichi SATO
.\" 
.\"WORD:	relocation	再配置
.\" 
.TH REISERFSTUNE 8 "February 2004" "Reiserfsprogs-3.6.19"
.SH 名前
reiserfstune \- ReiserFS ファイルシステムのチューニングツール
.SH 書式
.B reiserfstune
[ \fB-f\fR ]
[ \fB-j\fR | \fB--journal-device\fR \fIFILE\fR ]
[ \fB--no-journal-available\fR ]
[ \fB--journal-new-device\fR \fIFILE\fR ] [ \fB--make-journal-standard\fR ]
[ \fB-s\fR | \fB--journal-new-size\fR \fIN\fR ]
[ \fB-o\fR | \fB--journal-new-offset\fR \fIN\fR ]
[ \fB-t\fR | \fB--max-transaction-size\fR \fIN\fR ]
[ \fB-b\fR | \fB--add-badblocks\fR \fIfile\fR ]
[ \fB-B\fR | \fB--badblocks\fR \fIfile\fR ]
[ \fB-u\fR | \fB--uuid \fIUUID\fR ]
[ \fB-l\fR | \fB--label \fILABEL\fR ]
.I device
.SH 説明
\fBreiserfstune\fR は ReiserFS を調整するために使われる。
このプログラムは (ジャーナルサイズと最大トランザクションサイズという)
2 つのジャーナルパラメータを変更可能で、
ジャーナルの場所を指定された新しいブロックデバイスに移動できる
(以前の ReiserFS ジャーナルを使用しないままにすることもできるし、
ユーザーオプションにより破棄することもできる)。
それに加え、\fBreiserfstune\fR は不正ブロックのリストを
ReiserFS に格納したり、UUID や LABEL を設定できる。
注意: これを書いている時点では、ジャーナルの再配置は
ReiserFS の特別リリース用に実装されており、
Linux 2.5 あたりまでは、
メインストリームのカーネルに入れる予定はない。
つまり現在持っているカーネルに特別なパッチを適用する必要がある。
このパッチを適用しない場合、
カーネルは新しく修正されたファイルシステムのマウントを拒否する。
なぜこれが動作しないかを説明してほしければ、$25 いただきたい。
.PP
このコードのもっとも重要な応用としては、
ソリッドステートディスクにジャーナルを置くことが考えられる。
.TP
\fIdevice
デバイスに対応するスペシャルファイル
(例えば、/dev/hdXX は IDE ディスクパーティションで、 
/dev/sdXX は SCSI ディスクパーティションである)。
.SH オプション
.TP
\fB-j\fR | \fB--journal-device\fR \fIFILE
\fIFILE\fR はファイルシステムが現在 (reiserfstune を実行する前に)
ジャーナルを置いているブロックデバイスのファイル名である。
このオプションは、メインデータデバイスとは別のデバイスに
既にジャーナルが置かれている場合に必要になる
(\fB--no-journal-available\fR を指定すれば、使わないこともできる)。
このオプションでジャーナルデバイスを指定しない場合、
reiserfstune はジャーナルがメインデバイスにあると仮定する。
.TP
\fB--no-journal-available
現在のジャーナルのブロックデバイスが既に使用不能な場合でも、
\fBreiserfstune\fR に処理を実行させる。
このようなケースは、ディスクが故障してジャーナルを削除し
(その後に fsck をしている) といった場合に起る。
.TP
\fB--journal-new-device \fIFILE
\fIFILE\fR はファイルシステムの新しいジャーナルを入れる
ブロックデバイスのファイル名である。
このオプションを指定しない場合、
reiserfstune はジャーナルデバイスが以前と同じものであると仮定する。
.TP	
\fB \-s\fR | \fB\--journal-new-size \fIN
\fIN\fR は新しいジャーナルのサイズパラメータである。
ジャーナルが別のデバイスにある場合、
ジャーナルデバイスのブロック数がデフォルトサイズになる。
ジャーナルがファイルシステムと同じデバイスにある場合、
\fImkreiserfs\fR で作成されたジャーナルの総ブロック数がデフォルトになる。
どちらの場合でも最小値は 513 である。
.TP
\fB \-o\fR | \fB\--journal-new-offset \fIN
\fIN\fR は、ジャーナルが別のデバイスにある場合の
ジャーナルの開始オフセット (バイト単位) である。
デフォルトは 0 である。
ジャーナルがファイルシステムと同じデバイスにある場合は何も影響しない。
ほとんどのユーザーには、この機能は必要ない。
このオプションは、
複数のファイルシステムのジャーナルを同じデバイス上に置きたいが、
そのデバイスをパーティション分割したくない、
または分割できないといった場合に使える。
.TP
\fB \-t\fR | \fB\--maximal-transaction-size \fIN
\fIN\fR は新しいジャーナルのトランザクションサイズパラメータの最大値である。
デフォルト値と指定可能な最大値は 1024 ブロックである。
ジャーナルサイズの半分以下にすべきである。
不正な値が指定された場合は調整される。
.TP
\fB \-b\fR | \fB\--add-badblocks\fR \fIfile\fR
\fIfile\fR は、ファイルシステム上で不正とマークされる予定の
ブロックのリストが書かれたファイルの名前である。
このリストはファイルシステムの不正ブロックのリストに追加される。
.TP
\fB \-B\fR | \fB\--badblocks\fR \fIfile\fR
\fIfile\fR は、ファイルシステム上で不正とマークされる予定の
ブロックのリストが書かれたファイルの名前である。
ファイルシステム上の不正ブロックのリストは、
\fIfile\fR で指定されたリストがファイルシステムに追加される前に削除される。
.TP
\fB\-f\fR | \fB--force\fR 
通常 \fBreiserfstune\fR は、ジャーナルの再配置コードより以前に作成された
ファイルシステムのジャーナルの変更はしない。
これはジャーナルを変更すると、
(特別なオプション \fB--make-journal-standard\fR を使わずに)
以前のカーネルに戻すことが出来なくなるためである。
以前のカーネルでは今ある機能が存在せず、
ファイルシステムが使うことができなくなる。
このオプションは強制的にジャーナルの変更を行う。
このオプションを 2 つ以上指定すると、
確認を行わないようにすることができる。
.TP
\fB--make-journal-standard\fR 
上で述べたように、ファイルシステムに標準的なジャーナルがない場合、
ジャーナルの再配置コードがないカーネルではマウントできない。
このような問題を解決することもできるが、
標準ジャーナルのメインデバイスの予約領域が
8193 ブロックがなければいけないという唯一の条件がある
(標準ジャーナルを非標準ジャーナルに変換する場合などに必要である)。
ジャーナルを以前のものに再配置し直す場合は、
単にこのオプションを指定すれば良い。
メインデバイスに既にジャーナルが存在する場合、再配置はしない。
.TP
\fB-u\fR | \fB--uuid \fIUUID\fR
ファイルシステムの universally unique identifier (\fBUUID\fR)
(汎システム的に他とは重ならない識別子) を \fIUUID\fR に設定する。
(\fBuuidgen(8)\fR を参照)。
UUID のフォーマットはハイフンで区切った 16 進数の文字列であり、
"c1b9d5a2-f162-11cf-9ece-0020afc76f16" のようなフォーマットである。
.TP
\fB-l\fR | \fB--label \fILABEL\fR
ファイルシステムのボリュームラベルを設定する。
\fILABEL\fR は最大 16 文字である。
17 文字以上の場合、mkreiserfs は文字列を切り詰める。
.SH REISERFSTUNE を使用する可能性のあるシナリオ:
1. ReiserFS が /dev/hda1 にあり、
デバイス /dev/journal にジャーナルを置いて動作させたい場合。
.nf
.IP
特別な「ジャーナル再配置のサポート」パッチを適用した
カーネルでブートし、
reiserfstune /dev/hda1 --journal-new-device /dev/journal -f
mount /dev/hda1
として使用すること。

トランザクションサイズの最大値を 512 ブロックに変更する場合は、
以下のようにすること。
reiserfstune -t 512 /dev/hda1

再配置可能ジャーナルをサポートしていない別のカーネルで
ファイルシステムを使おうとする場合は、
umount /dev/hda1
reiserfstune /dev/hda1 -j /dev/journal \\
  --journal-new-device /dev/hda1 --make-journal-standard
mount /dev/hda1
として使用すること。
.LP
2. /dev/hda1 を ReiserFS にして、別のジャーナルに切り替えたい場合
(ファイルシステムがあるデバイスにジャーナルを置くことも含む)。
.nf
.IP
特別な「ジャーナル再配置のサポート」パッチを適用した
カーネルでブートし、
mkreiserfs /dev/hda1
を行う。

ソリッドステートディスクを使う
(SCSI ディスクと見なされるので、多分 /dev/sda などになる)。
reiserfstune --journal-new-device /dev/sda1 -f /dev/hda1

早朝 3 時に SCSI デバイスが死んで、
IDE デバイスが余っている場合は、
reiserfsck --no-journal-available /dev/hda1
または
reiserfsck --rebuild-tree --no-journal-available /dev/hda1
reiserfstune --no-journal-available \\
  --journal-new-device /dev/hda1 /dev/hda1
を実行して、パッチを適用したカーネルで /dev/hda1 を使用する。
.SH 著者
このバージョンの \fBreiserfstune\fR は、
Vladimir Demidov <vova@namesys.com> と
Edward Shishkin <edward@namesys.com> によって書かれた。
.SH バグ
バグは、できる限り多くの情報 (ハードウェア・カーネル・パッチ・設定・
表示された全てのメッセージ) とともに、
ReiserFS の開発者 <reiserfs-dev@namesys.com> に報告してほしい。
関連する情報があるかもしれないので syslog を調べてほしい。
.SH 関連項目
.BR reiserfsck (8),
.BR debugreiserfs (8),
.BR mkreiserfs (8)