.\" Copyright (c) 1999 Daniel C. Sobral
.\" 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.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 OR CONTRIBUTORS 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.
.\"
.\"	%Id: loader.conf.5,v 1.1.2.1 1999/04/24 17:44:35 dcs Exp %
.\" jpman %Id: loader.conf.5,v 1.4 1999/05/13 05:58:04 horikawa Stab %
.Dd April 18, 1999
.Dt LOADER.CONF 5
.Os
.Sh 名称
.Nm loader.conf
.Nd システムブートストラップの設定情報
.Pp
.Nm loader.conf.local
.Nd ローカライズされたシステムブートストラップの設定情報
.Sh 解説
ファイル
.Nm
は、システムのブートストラップに関する記述的な情報を含みます。
これを通じて、ブートすべきカーネル、カーネルに渡すパラメータ、
ロードすべき追加のモジュールを指定可能であり、また、一般的に、
.Xr loader 8
で記述されているすべての変数を設定可能です。
.Pp
.Nm
が自動的に処理されるようにするために、
ファイル
.Pa /boot/loader.rc
は次の 2 行を含む必要があります。
.Pp
.Dl include /boot/loader.4th
.Dl start
.Pp
インストール時に
.Pa /boot/loader.rc
が存在しない場合、前述の行を含むものが組み込まれることになります。
.Sh 文法
.Nm loader.conf
の書式は、明らかに
.Xr rc.conf 8
の書式を受け継いだものであり、
.Xr sh 1
を起源とするものですが、特別な方法で扱われる設定があります。
また、サフィックスのみに依存する設定もあります。
.Pp
一般的な解釈の規則は次の通りです:
.Bl -bullet
.It
空白と空行は無視されます。
.It
記号 # は、行の残りがコメントであるという印です。
.It
各行には 1 個の設定のみ存在可能です。
.El
.Pp
すべての設定は、次の書式です:
.Pp
.Dl variable="value"
.Pp
特殊な扱いを受ける設定のクラスに属すのでなければ、
おのおのの設定は
.Xr loader 8
の環境変数の値を設定します。
特殊な扱いを受ける設定は、ここに列挙しています。
.Qq *
で開始する設定は、ロードされるモジュールを定義し、
任意のプレフィックスを持ちえます。
共通のプレフィックスを持つような設定はすべて、
同一のモジュールを参照します。
.Bl -tag -width Ar
.It Ar exec
即時に
.Xr loader 8
のコマンドを実行します。
このタイプの設定は、
.Xr loader 8
以外のプログラムでは処理できませんので、使用は避けるべきです。
複数個指定すると、別々に処理されます。
.It Ar loader_conf_files
現在のファイルのすぐ後に処理すべき、追加の設定ファイルを定義します。
.It Ar kernel
ロードすべきカーネルの名前です。
カーネルの名前を設定しないと、
追加のモジュールはロードされません。
.It Ar kernel_options
カーネルに渡されるフラグです。
.It Ar verbose_loading
.Dq YES
に設定すると、モジュールがロードされると、その名前が表示されます。
.It Ar *_load
.Dq YES
に設定すると、そのモジュールがロードされます。
名前を定義しないと (後述)、モジュールの名前はプレフィックスと同じになります。
.It Ar *_name
モジュールの名前を定義します。
.It Ar *_type
モジュールのタイプを定義します。
なにも指定しないと、デフォルトの kld モジュールになります。
.It Ar *_flags
モジュールに渡されるフラグとパラメータです。
.It Ar *_before
モジュールのロード前に実行すべきコマンドです。
この設定の使用は避けるべきです。
.It Ar *_after
モジュールのロード後に実行すべきコマンドです。
この設定の使用は避けるべきです。
.It Ar *_error
モジュールのロードに失敗した場合に実行されるコマンドです。
ブートストラップ処理を異常終了させる特殊な値
.Dq abort
以外では、この設定の使用は避けるべきです。
.El
.Sh デフォルト設定
ほとんどの
.Nm loader.conf
のデフォルト設定は無視可能です。少数の重要または有用なものを次に示します:
.Bl -tag -width bootfile -offset indent
.It Va bitmap_load
.Pq Dq NO
.Dq YES
に設定すると、ビットマップがロードされ、ブート中に画面に表示されます。
.It Va bitmap_name
.Pq Dq /boot/splash.bmp
ロードされるビットマップの名前です。他のいかなる名前でも使用可能です。
.It Va kernel
.Pq Dq /kernel
.It Va loader_conf_files
.Pq Do /boot/loader.conf /boot/loader.conf.local Dc
.It Va splash_bmp_load
.Pq Dq NO
.Dq YES
に設定すると、起動画面モジュールをロードし、
ブート中にビットマップを画面に表示することを可能にします。
.It Va userconfig_script_load
.Pq Dq NO
.Dq YES
に設定すると、ユーザコンフィグのデータをロードします。
.It Va vesa_load
.Pq Dq NO
.Dq YES
に設定すると、vesa モジュールをロードし、
VGA を越える解像度を表示可能とします。
.El
.Sh 関連ファイル
.Bl -tag -width /boot/defaults/loader.conf -compact
.It Pa /boot/defaults/loader.conf
デフォルト設定 -- このファイルを変更しないでください。
.It Pa /boot/loader.4th
loader が使用するコマンドを定義し、
.Nm loader.conf
を読み込んで処理します。
.It Pa /boot/loader.conf
ユーザが定義した設定です。
.It Pa /boot/loader.conf.local
共通の loader.conf と共に使用する、サイトのマシン固有の設定です。
.It Pa /boot/loader.rc
.Nm loader.conf
を自動的に処理する指示を含みます。
.El
.Sh 関連項目
.Xr boot 8 ,
.Xr loader 8 ,
.Xr loader.4th 8
.Sh 歴史
ファイル
.Nm
が最初に登場したのは
.Fx 3.2
です。
.Sh 作者
このマニュアルページは
.An Daniel C. Sobral Aq dcs@FreeBSD.org
が書きました。