Attachment #23367 for bug #40237

View | Details | Raw Unified | Return to bug 40237
Collapse All | Expand All




.Nm
contains descriptive information on bootstrapping the system. Through
it you can specify the kernel to be booted, parameters to be passed to
it, and additional modules to be loaded; and generally set all variables
described in
.Xr loader 8 .
.Pp

and can be sourced by
.Xr sh 1 ,
some settings are treated in a special fashion. Also, the
behavior of some settings is defined by the setting's suffix; the prefix identifies which module the setting controls.
.Pp
The general parsing rules are:
.Bl -bullet

.Pp
Unless it belongs to one of the classes of settings that receive special
treatment, a setting will set the value of a
.Xr loader 8
environment variable. The settings that receive special
treatment are listed below. Settings beginning with
.Qq *
below define the modules to be loaded and
may have any prefix; the prefix identifies a module. All such settings sharing a common
prefix refer to the same module.
.Bl -tag -width Ar
.It Ar exec

command. This type of setting cannot be processed by programs other
than
.Xr loader 8 ,
so its use should be avoided. Multiple instances of it will be processed
independently.
.It Ar loader_conf_files
Defines additional configuration files to be processed right after the

.It Ar kernel_options
Flags to be passed to the kernel.
.It Ar password
Provides a password to be required by check-password before execution is
allowed to continue.
.It Ar verbose_loading
If set to
.Dq YES ,
module names will be displayed as they are loaded.
.It Ar *_load
If set to
.Dq YES ,

a bitmap will be loaded to be displayed on screen while booting.
.It Va bitmap_name
.Pq Dq /boot/splash.bmp
Name of the bitmap to be loaded. Any valid bitmap path can be used.
.It Va kernel
.Pq Dq /kernel
.It Va loader_conf_files

.Pq Dq NO
If set to
.Dq YES ,
will load the splash screen module, making it possible to display a bmp image
on the screen while booting.
.It Va splash_pcx_load
.Pq Dq NO
If set to
.Dq YES ,
will load the splash screen module, making it possible to display a pcx image
on the screen while booting.
.It Va userconfig_script_load
.Pq Dq NO

Return to bug 40237

Lines 34-40 Link Here

(-)loader.conf.5.fixed (-12 / +12 lines)
34	.Nm	34	.Nm
35	contains descriptive information on bootstrapping the system. Through	35	contains descriptive information on bootstrapping the system. Through
36	it you can specify the kernel to be booted, parameters to be passed to	36	it you can specify the kernel to be booted, parameters to be passed to
37	it, additional modules to be loaded, and generally set all variables	37	it, and additional modules to be loaded; and generally set all variables
38	described in	38	described in
39	.Xr loader 8 .	39	.Xr loader 8 .
40	.Pp	40	.Pp
Lines 58-64 Link Here
58	and can be sourced by	58	and can be sourced by
59	.Xr sh 1 ,	59	.Xr sh 1 ,
60	some settings are treated in a special fashion. Also, the	60	some settings are treated in a special fashion. Also, the
61	behavior of some settings depends only on it's suffix.	61	behavior of some settings is defined by the setting's suffix; the prefix identifies which module the setting controls.
62	.Pp	62	.Pp
63	The general parsing rules are:	63	The general parsing rules are:
64	.Bl -bullet	64	.Bl -bullet
Lines 76-87 Link Here
76	.Pp	76	.Pp
77	Unless it belongs to one of the classes of settings that receive special	77	Unless it belongs to one of the classes of settings that receive special
78	treatment, a setting will set the value of a	78	treatment, a setting will set the value of a
79	.Xr loader 8 Ns 's	79	.Xr loader 8
80	environment variable. The settings that receive special	80	environment variable. The settings that receive special
81	treatment are listed below. The ones beginning with a	81	treatment are listed below. Settings beginning with
82	.Qq *	82	.Qq *
83	define the modules to be loaded and	83	below define the modules to be loaded and
84	may have any prefix. All such settings sharing a common	84	may have any prefix; the prefix identifies a module. All such settings sharing a common
85	prefix refer to the same module.	85	prefix refer to the same module.
86	.Bl -tag -width Ar	86	.Bl -tag -width Ar
87	.It Ar exec	87	.It Ar exec
Lines 90-96 Link Here
90	command. This type of setting cannot be processed by programs other	90	command. This type of setting cannot be processed by programs other
91	than	91	than
92	.Xr loader 8 ,	92	.Xr loader 8 ,
93	so it's use should be avoided. Multiple instances of it will be processed	93	so its use should be avoided. Multiple instances of it will be processed
94	independently.	94	independently.
95	.It Ar loader_conf_files	95	.It Ar loader_conf_files
96	Defines additional configuration files to be processed right after the	96	Defines additional configuration files to be processed right after the
Lines 101-112 Link Here
101	.It Ar kernel_options	101	.It Ar kernel_options
102	Flags to be passed to the kernel.	102	Flags to be passed to the kernel.
103	.It Ar password	103	.It Ar password
104	Provides a password to be asked by check-password before execution is	104	Provides a password to be required by check-password before execution is
105	allowed to continue.	105	allowed to continue.
106	.It Ar verbose_loading	106	.It Ar verbose_loading
107	If set to	107	If set to
108	.Dq YES ,	108	.Dq YES ,
109	the modules' names will be displayed as they are loaded.	109	module names will be displayed as they are loaded.
110	.It Ar *_load	110	.It Ar *_load
111	If set to	111	If set to
112	.Dq YES ,	112	.Dq YES ,
Lines 143-149 Link Here
143	a bitmap will be loaded to be displayed on screen while booting.	143	a bitmap will be loaded to be displayed on screen while booting.
144	.It Va bitmap_name	144	.It Va bitmap_name
145	.Pq Dq /boot/splash.bmp	145	.Pq Dq /boot/splash.bmp
146	Name of the bitmap to be loaded. Any other name can be used.	146	Name of the bitmap to be loaded. Any valid bitmap path can be used.
147	.It Va kernel	147	.It Va kernel
148	.Pq Dq /kernel	148	.Pq Dq /kernel
149	.It Va loader_conf_files	149	.It Va loader_conf_files
Lines 152-164 Link Here
152	.Pq Dq NO	152	.Pq Dq NO
153	If set to	153	If set to
154	.Dq YES ,	154	.Dq YES ,
155	will load the splash screen module, making possible to display a bmp image	155	will load the splash screen module, making it possible to display a bmp image
156	on the screen while booting.	156	on the screen while booting.
157	.It Va splash_pcx_load	157	.It Va splash_pcx_load
158	.Pq Dq NO	158	.Pq Dq NO
159	If set to	159	If set to
160	.Dq YES ,	160	.Dq YES ,
161	will load the splash screen module, making possible to display a pcx image	161	will load the splash screen module, making it possible to display a pcx image
162	on the screen while booting.	162	on the screen while booting.
163	.It Va userconfig_script_load	163	.It Va userconfig_script_load
164	.Pq Dq NO	164	.Pq Dq NO