| loader.conf.5 (96247) | loader.conf.5 (102465) |
|---|---|
| 1.\" Copyright (c) 1999 Daniel C. Sobral 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" | 1.\" Copyright (c) 1999 Daniel C. Sobral 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
| 25.\" $FreeBSD: head/sys/boot/forth/loader.conf.5 96247 2002-05-09 11:47:42Z joe $ | 25.\" $FreeBSD: head/sys/boot/forth/loader.conf.5 102465 2002-08-27 01:01:31Z trhodes $ |
| 26.Dd April 18, 1999 27.Dt LOADER.CONF 5 28.Os 29.Sh NAME 30.Nm loader.conf 31.Nd system bootstrap configuration information 32.Sh DESCRIPTION 33The file 34.Nm 35contains descriptive information on bootstrapping the system. Through 36it you can specify the kernel to be booted, parameters to be passed to | 26.Dd April 18, 1999 27.Dt LOADER.CONF 5 28.Os 29.Sh NAME 30.Nm loader.conf 31.Nd system bootstrap configuration information 32.Sh DESCRIPTION 33The file 34.Nm 35contains descriptive information on bootstrapping the system. Through 36it you can specify the kernel to be booted, parameters to be passed to |
| 37it, additional modules to be loaded, and generally set all variables | 37it, and additional modules to be loaded; and generally set all variables |
| 38described in 39.Xr loader 8 . 40.Pp 41The file 42.Pa /boot/loader.rc 43must contain the following two lines for 44.Nm 45to be automatically processed: --- 7 unchanged lines hidden (view full) --- 53.Sh SYNTAX 54Though 55.Nm Ns 's 56format was defined explicitly to resemble 57.Xr rc.conf 5 , 58and can be sourced by 59.Xr sh 1 , 60some settings are treated in a special fashion. Also, the | 38described in 39.Xr loader 8 . 40.Pp 41The file 42.Pa /boot/loader.rc 43must contain the following two lines for 44.Nm 45to be automatically processed: --- 7 unchanged lines hidden (view full) --- 53.Sh SYNTAX 54Though 55.Nm Ns 's 56format was defined explicitly to resemble 57.Xr rc.conf 5 , 58and can be sourced by 59.Xr sh 1 , 60some settings are treated in a special fashion. Also, the |
| 61behavior of some settings depends only on it's suffix. | 61behavior of some settings is defined by the setting's suffix; the prefix identifies which module the setting controls. |
| 62.Pp 63The general parsing rules are: 64.Bl -bullet 65.It 66Spaces and empty lines are ignored. 67.It 68A # sign will mark the remainder of the line as a comment. 69.It 70Only one setting can be present on each line. 71.El 72.Pp 73All settings have the following format: 74.Pp 75.Dl variable="value" 76.Pp 77Unless it belongs to one of the classes of settings that receive special 78treatment, a setting will set the value of a | 62.Pp 63The general parsing rules are: 64.Bl -bullet 65.It 66Spaces and empty lines are ignored. 67.It 68A # sign will mark the remainder of the line as a comment. 69.It 70Only one setting can be present on each line. 71.El 72.Pp 73All settings have the following format: 74.Pp 75.Dl variable="value" 76.Pp 77Unless it belongs to one of the classes of settings that receive special 78treatment, a setting will set the value of a |
| 79.Xr loader 8 Ns 's | 79.Xr loader 8 |
| 80environment variable. The settings that receive special | 80environment variable. The settings that receive special |
| 81treatment are listed below. The ones beginning with a | 81treatment are listed below. Settings beginning with |
| 82.Qq * | 82.Qq * |
| 83define the modules to be loaded and 84may have any prefix. All such settings sharing a common | 83below define the modules to be loaded and 84may have any prefix; the prefix identifies a module. All such settings sharing a common |
| 85prefix refer to the same module. 86.Bl -tag -width Ar 87.It Ar exec 88Immediately executes a 89.Xr loader 8 90command. This type of setting cannot be processed by programs other 91than 92.Xr loader 8 , | 85prefix refer to the same module. 86.Bl -tag -width Ar 87.It Ar exec 88Immediately executes a 89.Xr loader 8 90command. This type of setting cannot be processed by programs other 91than 92.Xr loader 8 , |
| 93so it's use should be avoided. Multiple instances of it will be processed | 93so its use should be avoided. Multiple instances of it will be processed |
| 94independently. 95.It Ar loader_conf_files 96Defines additional configuration files to be processed right after the 97present file. 98.It Ar kernel 99Name of the kernel to be loaded. If no kernel name is set, no additional 100modules will be loaded. 101.It Ar kernel_options 102Flags to be passed to the kernel. 103.It Ar password | 94independently. 95.It Ar loader_conf_files 96Defines additional configuration files to be processed right after the 97present file. 98.It Ar kernel 99Name of the kernel to be loaded. If no kernel name is set, no additional 100modules will be loaded. 101.It Ar kernel_options 102Flags to be passed to the kernel. 103.It Ar password |
| 104Provides a password to be asked by check-password before execution is | 104Provides a password to be required by check-password before execution is |
| 105allowed to continue. 106.It Ar verbose_loading 107If set to 108.Dq YES , | 105allowed to continue. 106.It Ar verbose_loading 107If set to 108.Dq YES , |
| 109the modules' names will be displayed as they are loaded. | 109module names will be displayed as they are loaded. |
| 110.It Ar *_load 111If set to 112.Dq YES , 113that module will be loaded. If no name is defined (see below), the 114module's name is taken to be the same as the prefix. 115.It Ar *_name 116Defines the name of the module. 117.It Ar *_type --- 38 unchanged lines hidden (view full) --- 156.It Va kernel 157.Pq Dq /boot/kernel/kernel 158.It Va loader_conf_files 159.Pq Do /boot/loader.conf /boot/loader.conf.local Dc 160.It Va splash_bmp_load 161.Pq Dq NO 162If set to 163.Dq YES , | 110.It Ar *_load 111If set to 112.Dq YES , 113that module will be loaded. If no name is defined (see below), the 114module's name is taken to be the same as the prefix. 115.It Ar *_name 116Defines the name of the module. 117.It Ar *_type --- 38 unchanged lines hidden (view full) --- 156.It Va kernel 157.Pq Dq /boot/kernel/kernel 158.It Va loader_conf_files 159.Pq Do /boot/loader.conf /boot/loader.conf.local Dc 160.It Va splash_bmp_load 161.Pq Dq NO 162If set to 163.Dq YES , |
| 164will load the splash screen module, making possible to display a bmp image | 164will load the splash screen module, making it possible to display a bmp image |
| 165on the screen while booting. 166.It Va splash_pcx_load 167.Pq Dq NO 168If set to 169.Dq YES , | 165on the screen while booting. 166.It Va splash_pcx_load 167.Pq Dq NO 168If set to 169.Dq YES , |
| 170will load the splash screen module, making possible to display a pcx image | 170will load the splash screen module, making it possible to display a pcx image |
| 171on the screen while booting. 172.It Va userconfig_script_load 173.Pq Dq NO 174If set to 175.Dq YES , 176will load the userconfig data. 177.It Va vesa_load 178.Pq Dq NO --- 32 unchanged lines hidden --- | 171on the screen while booting. 172.It Va userconfig_script_load 173.Pq Dq NO 174If set to 175.Dq YES , 176will load the userconfig data. 177.It Va vesa_load 178.Pq Dq NO --- 32 unchanged lines hidden --- |