source: projects/specs/trunk/c/chkconfig/chkconfig.8 @ 7709

.\"
.\" Japanese Version Copyright (c) 1999 Project Vine
.\"         all rights reserved.
.\" Translated Tue Aug 3 20:00:00 JST 1999
.\"         by Norihito Ohmori

.TH CHKCONFIG 8 "Wed Oct 8 1997"
.UC 4
.SH 名前
chkconfig \- システムサービスの runlevel の情報をアップデートや検証する

.SH 書式
\fBchkconfig\fR \fB--list\fR [\fIname\fR]
.br
\fBchkconfig\fR \fB--add\fR \fIname\fR
.br
\fBchkconfig\fR \fB--del\fR \fIname\fR
.br
\fBchkconfig\fR [\fB--level\fR \fIlevels\fR] \fIname\fR <\fBon\fR|\fBoff\fR|\fBreset\fR>
.br
\fBchkconfig\fR [\fB--level\fR \fIlevels\fR] \fIname\fR 
.br

.SH 記述
\fBchkconfig\fR は /etc/rc.d ディレクトリにシステム管理者がたくさんの
シンボリックリンクを 直接手動で作成する仕事から解放する、ディレクトリ階層を
メンテナンスするシンプルなコマンドラインツールを提供する。

\fBchkconfig\fR の実装は IRIX オペレーティングシステムで使用される
\fBchkconfig\fR コマンドに由来する。しかしながら、 /etc/rc.d 階層の
外の設定情報をメンテナンスするのでなく、このバージョンでは /etc/rc.d の
シンボリックリンクを直接操作する。これはすべての設定情報を一つの場所に
 \fIinit\fR が起動するサービスをおいておける。

\fBchkconfig\fR は 5 つの個別の機能をもっている: 管理のために新しい
サービスを加える、管理のためにサービスを取り除く、現在起動している
サービスの情報をリストする、サービスの起動情報を変更する、そして
各サービスの起動情報をチェックする。

\fBchkconfig\fR をオプションなしで起動したときには、使用情報を表示する。
もしサービス名のみが与えられたとき、そのサービスが現在の runlevel で
起動される設定されるようになっているかをチェックする。もしそうなっていたら
\fBchkconfig\fR は真を返す; でなければ偽を返す。\fB--level\fR オプションは
\fBchkconfig\fR が現在 runlevel のかわりに別の runlevel を検証する
ようにするために使用される。

もし \fBon\fR、\fBoff\fR または \fRreset\fR のうち一つがサービス名のあと
指定されたら、\fBchkconfig\fR は指定されたサービスの起動情報を変更する。
\fBon\fR と \fBoff\fR のフラグはそれぞれ、変更される runlevel の中で
サービスをスタートしたりストップしたりする。
\fBreset\fR フラグはinit script の質問の中で指定されたサービスの
起動情報をリセットする。

デフォルトで、\fBon\fR と \fBoff\fR オプションの効力があるのは runlevel
3、4 そして 5 だけであり、\fBreset\fR のはすべての runlevel に効力を発揮する。
\fB--level\fR オプションはどの runlevel に効力を発揮するかを指定するため
に使われる。

各サービスにとって、それぞれの runlevel は開始スクリプト
か停止スクリプトのどちらかをもっていることを注意せよ。runlevel を
切り替えたとき、init はすでに起動しているサービスをリスタートしないし
実行されていないサービスを再ストップしない。

.SH オプション
.TP
\fB-\-levels \fIlevels\fR
オペレーションが属する runlevel を指定する。 0 から 7の数の並びである。
例えば、\fB--levels 35\fR は runlevel 3 と 5 を指定する。

.TP
\fB-\-add\fR \fIname\fR

このオプションは \fBchkconfig\fR によって操作される新しいサービスを
加える。新しいサービスが加わったとき、\fBchkconfig\fR はそのサービスが
それぞれの runlevel において起動または停止のエントリのどちらになるかを
確実に行う。もし、どの runlevel もエントリにない場合、\fBchkconfig\fR
は起動スクリプトにデフォルトの値として指定された適当なエントリを
作成する。

.TP
\fB-\-del\fR \fIname\fR
サービスが \fBchkconfig\fR の管理から取り除かれ、それに属する /etc/rc.d
の中のシンボリックリンクが取り除かれる。

.TP
\fB-\-list\fR \fIname\fR
このオプションは \fBchkconfig\fR が認知しているサービスのすべてについて
それぞれの runlevel で停止または起動しているかをリストする。
もし \fIname\fR が指定されたら、情報は \fIname\Rf のサービスに
ついてのみ表示される。

.SH RUNLEVEL ファイル

\fBchkconfig\fR によって管理される各サービスでは、 2 つまたはそれ以上の
コメント行を init.d script に加える必要がある。最初の行は
\fBchkconfig\fR に開始と終了の優先順位のレベルと、
デフォルトで開始されるサービスの runlevel がどれかを教える。もしサービスが
デフォルトで、どの runlevel でも開始されないときには、\fB\-\fR が
runlevel の場所に使用される。二番目の行はサービスの記述を含む。
それはバックスラッシュを使うことにより、複数行にわたって書かれる。

例えば、random.init はこれら3行からなる:
.nf
.fn C
# chkconfig: 2345 20 80
# description: Saves and restores system entropy pool for \e
#              higher quality random number generation.
.fn R
.fi
これは random スクリプトが 2、3、4 そして 5 のレベルで始まり、起動優先
順位が 20 で、そして終了優先順位が 80 であるといっている。
description がいってることを理解するべきである; \e は行が続くことになる。
行頭の余分な空白は無視される。

.SH 関連項目
.IR init (8)
.IR ntsysv (8)
.IR tksysv (8)

.SH 著者
.nf
Erik Troan <ewt@redhat.com>
.fi