doc/ja_JP.eucJP/man/man8/ccdconfig.8

.\"	$NetBSD: ccdconfig.8,v 1.1.2.1 1995/11/11 02:43:33 thorpej Exp %
.\"
.\" Copyright (c) 1995 Jason R. Thorpe.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgment:
.\"    must display the following acknowledgement:
.\"	This product includes software developed for the NetBSD Project
.\"	by Jason R. Thorpe.
.\" 4. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" %FreeBSD: src/sbin/ccdconfig/ccdconfig.8,v 1.9.2.4 2001/01/16 10:36:35 ru Exp %
.\"
.\" $FreeBSD$
.Dd July 17, 1995
.Dt CCDCONFIG 8
.Os FreeBSD
.Sh 名称
.Nm ccdconfig
.Nd 結合ディスクドライバ用設定ユーティリティ
.Sh 書式
.Nm
.Op Fl cv
.Ar ccd
.Ar ileave
.Op Ar flags
.Ar dev
.Op Ar
.Nm
.Fl C
.Op Fl v
.Op Fl f Ar config_file
.Nm
.Fl u
.Op Fl v
.Ar ccd
.Op Ar
.Nm
.Fl U
.Op Fl v
.Op Fl f Ar config_file
.Nm
.Fl g
.Op Fl M Ar core
.Op Fl N Ar system
.Op Ar ccd Op Ar ...
.Sh 解説
.Nm
は結合ディスクデバイス (concatenated disk device, ccd) の動的な設定および
解除を行う場合に使用します。ccd の詳細については、
.Xr ccd 4
を参照して下さい。
.Pp
以下のオプションが使用できます。
.Bl -tag -width indent
.It Fl c
ccd の設定を行います。
.Nm
のデフォルトの動作です。
.It Fl C
設定ファイルに書かれている全てのデバイスの設定を行います。
.It Fl f Ar config_file
全てのデバイスの設定あるいは解除を行う時に、デフォルトの
.Pa /etc/ccd.conf
ではなく、
.Pa config_file
から設定情報を読み込みます。
.It Fl g
ccd の設定ファイルとして使用できる形式で、現在の ccd の設定を出力します。
引数が指定されていなければ、設定されている全ての ccd について出力します。
引数が指定されていれば、指定された ccd についてのみ出力します。
.It Fl M Ar core
名前リストに対応する値の展開に、デフォルトの
.Pa /dev/mem
ではなく、
.Pa core
を使用します。
.It Fl N Ar system
(
.Xr getbootfile 3
により判断される)
現在稼働中のカーネルの代わりに
.Ar system
をカーネルとして使用します。
.It Fl u
ccd の設定を解除します。
.It Fl U
ccd 設定ファイルに書かれている全ての ccd デバイスの設定を解除します。
.It Fl v
より冗長な出力を行います。
.El
.Pp
ccd は、コマンド行ないし ccd 設定ファイルにて、ccd の名前、インタリーブ
ファクタ、ccd 設定フラグ、ひとつ以上のデバイスのリストの情報により
定義されます。フラグは、十進数、十六進数、コンマで区切られた名前のリスト、
.Dq none
のいずれかで表すことができます。
フラグには以下の物があります。
.\" 以下の表の部分のマクロはオリジナルの英語版とは異なるが、こちらの方が
.\" きれいに(見やすい形で)フォーマットされるので、変更した。
.\" マクロ自体は NetBSD の ccdconfig.8 の日本語版を参考にした。
.\" 2.2.2-RELEASE 対象
.\" By yugawa@orleans.rim.or.jp (May 20 1997)
.\"
.\" "-offset indent" 追加。
.\" 2.2.2-RELEASE 対象
.\" By konuma@de.mtex.co.jp (Jul 28 1997)
.Pp
.Bl -tag -width "CCDF_UNIFORM 0x02" -ffset intent -compact -offset indent
.It "CCDF_SWAP    0x01"
dmmax (swap の単位ブロックの最大値) 単位でインタリーブします
.It "CCDF_UNIFORM 0x02"
ディスク間で均一なインタリーブ動作になります
.It "CCDF_MIRROR  0x04"
データのミラーリングを行います
.It "CCDF_PARITY  0x08"
パリティ検査を行います (現状では使用できません)
.El
.Pp
設定ファイルのフォーマットは、コマンド行から指定する場合と
同一の形式になります。コマンド行から指定する場合も、
設定ファイルから指定する場合も、
.Pa flags
引数はオプションです。
.Bd -unfilled -offset indent
#
# /etc/ccd.conf
# Configuration file for concatenated disk devices
#
.Pp
# ccd           ileave  flags   component devices
ccd0            16      none    /dev/da2e /dev/da3e
.Ed
.Pp
構成要素のデバイスは、パーティションタイプが
.Li FS_BSDFFS
.Pf ( Xr disklabel 8
では
.Dq 4.2BSD
と表示されます) であることが必要です。
.Sh 使用例
.Pp
ccdconfig の例をいくつか以下に示します。
ccdconfig に渡される引数は、
.Pa /etc/ccd.conf 
設定ファイルに書けるものと正に同じものです。
1 番目の例は、
4 ディスクのストライプを 4 SCSI ディスクパーティションから作成します。
ストライプは 64 セクタインタリープを使用します。
2 番目の例は、
複雑なストライプ/ミラーの組み合わせの例です。
これは、
da2e と da3e の 2 ディスクストライプを、
da4e と da5e の 2 ディスクストライプへミラーすると、解釈します。
最後の例は、単純なミラーです。
/dev/da2e は /dev/da4e へミラーされ、ccd0 に割り当てられます。
.Pp
.Bd -unfilled -offset
# ccdconfig ccd0 64 none /dev/da2e /dev/da3e /dev/da4e /dev/da5e
# ccdconfig ccd0 128 CCDF_MIRROR /dev/da2e /dev/da3e /dev/da4e /dev/da5e
# ccdconfig ccd0 128 CCDF_MIRROR /dev/da2e /dev/da4e
.Ed
.Pp
新規 ccd ディスクを作成するとき、一般的には他のことに先駆けて
.Nm disklabel
をしたいでしょう。
最初のラベルを作成した後は、
これを編集して、追加パーティションを追加可能です。
ラベル自身は、ccd ディスクの最初の 16 セクタを占めます。
ファイルシステムを newfs で作成するだけなら、
newfs がラベル領域を飛ばしますので、心配することはありません。
しかし、ccd パーティションからまたは ccd パーティション宛へ
.Nm dd
するつもりなら、一般的には、
パーティションを作成してラベルデータに重ならないようにするのが良い考えです。
例えば、10000 セクタの ccd ディスクがある場合、
オフセット 16 大きさ 9984 のパーティション 'd' を作成するでしょう。
.Pp
.Bd -unfilled -offset
# disklabel -r -w ccd0c auto
# disklabel -e ccd0c
.Ed
.Pp
ccd ディスクに対する disklabel 処理は 1 度の機会です。
他のデバイスと異なり、disklabel 実行時には、
ccd はパーティション 'c' を指定するよう要求しています。
マシンをリブートし ccd ディスクを再構成する場合、
以前作成したディスクラベルが残っているため再作成は不要です。
ccd パラメータの変更には注意してください。
インタリーブ、フラグ、ccd ディスクを構成するデバイスリストを変えると、
通常、ccd ディスク上にあったデータを壊してしまいます。
こうなってしまった場合、
ccd ディスクを (再) 初期化する前にラベルを再初期化するのは、
通常良い考えです。
.Pp
.Sh 回復
.Pp
ccd ディスク上のエラーは、
ミラーリングオプションを使用していない限り、通常は回復不可能です。
しかし、ミラーリングにはそれ自身の危険性があります。
これは、すべてのセクタの両方のコピーが同一であることを仮定していることです。
この仮定は、書き込みエラーが発生するか、
どちらかのミラーを交換するまでは、成り立ちます。
.Nm ccd
は、貧者のミラーリング実装を使用しています。
ディスクエラーが発生し始めたら、
ccd ディスクのバックアップを取って、
壊れたハードウェアを交換して、
ccd ディスクを再作成可能である限りは、この実装は十分うまく働きます。
これ以上を望むなら、外部ハードウェア RAID SCSI ボックスや、
.Nm dpt
コントローラ等の RAID コントローラや、
.Nm vinum
等のソフトウェア RAID システムを検討すべきです。
.Pp
.Sh 関連ファイル
.Bl -tag -width /etc/ccd.conf -compact
.It Pa /etc/ccd.conf
デフォルトの ccd 設定ファイル
.El
.Sh 関連項目
.Xr ccd 4 ,
.Xr rc 8 ,
.Xr vinum 8
.Sh 歴史
.Nm
コマンドは
.Nx 1.0a
から登場しました。