.\"
.\" Copyright (c) 2019 David Demelier <markand@malikania.fr>
.\"
.\" Permission to use, copy, modify, and/or distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd July 08, 2019
.Dt RC.CONF 5
.Os
.Sh NAME
.Nm rc.conf
.Nd system configuration
.Sh DESCRIPTION
The file
.Nm
contains information about the system.
.Pp
It is evaluated at boot time when
.Pa /etc/rc.init
is started from init and performs initialization. The file is sourced from a
shell script and therefore can contain shell code.
.Pp
The following options are available:
.Bl -tag -width indent-two
.It Va HOSTNAME
Sets the machine hostname. (Default: localhost)
.It Va TIMEZONE
Sets the time zone. You can get a list of timezones in the
.Pa /share/zoneinfo
directory. The variable must be in the form
.Ar Area/Region .
(Default: empty)
.Pp
Note: this requires package
.Ar tzdata
to be installed.
.It Va SERVICES
This variable contains services to be started at boot. (Default: empty).
In Vanilla Linux, services have no dependencies and therefore user is
responsible of starting them is a specific order if needed. Thus, services
marked in this list separated by spaces are executed in order.
.Pp
Services names are in the form
.Ar name[:N]
where name is the actual service file located in
.Pa /etc/rc.d
directory. The optional
.Ar N
argument is the minimal runlevel number required to start this service. For
example, a value of 3 means that the service will be started only if the desired
runlevel is 3 or higher.
.Pp
Some services offer tunables to pass additional configuration to them. See the
service file header for more information.
.Pp
Note: don't forget to mark the service file as executable or it won't be
executed by init process.
.It Va FONT
Sets the console font. A list is available in /share/kbd/consolefonts. (Default:
empty).
.Pp
Note: this requires package
.Ar kbd
to be installed.
.It Va KEYMAP
Sets the console keymap. A list is available in /share/kbd/keymaps. (Default:
empty).
.Pp
Note: this requires package
.Ar kbd
to be installed.
.It Va INTERFACES
Interfaces to pass to
.Pa /etc/rc.networking
script during bootup and shutdown. Mostly used for static IP addresses. It's
strongly advised to keep
.Ar lo
interface in this variable. (Default: lo)
.Pp
See the documentation in the
.Pa /etc/rc.networking
file.
.El
.Sh EXAMPLES
.Ss Starting sysklogd package
In this example we will start
.Ar sysklogd
from the runlevel 2 and higher.
.Pp
The
.Ar sysklogd
package understand the variable
.Va SYSKLOGD_ARGS
and may be used instead. However, please note that setting this variable replace
the original arguments so double check the service file before setting any
variable.
.Bd -literal
SYSKLOGD_ARGS="-4"
SERVICES="sysklogd:2"
.Ed
.Sh SEE ALSO
.Xr rc 7