view vinit.conf.5 @ 7:7d40d4ae7377 default tip @

misc: update copyright years
author David Demelier <markand@malikania.fr>
date Sun, 02 Jan 2022 10:26:58 +0100
parents 3db6ca1fe07d
children
line wrap: on
line source

.\"
.\" Copyright (c) 2019-2022 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 29, 2021
.Dt VINIT.CONF 5
.Os
.Sh NAME
.Nm vinit.conf
.Nd system configuration
.Sh DESCRIPTION
The file
.Nm
contains information about the system.
.Pp
It is evaluated at boot time when
.Pa @SYSCONFDIR@/vinit.start
is started from
.Xr vinit 8
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 @SHAREDIR@/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).
.Pp
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
Entries in this variable should contain file names located in
.Pa @SYSCONFDIR@/vinit.d
directory.
.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
.Pa @SHAREDIR@/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
.Pa @SHAREDIR@/kbd/keymaps .
(Default: empty).
.Pp
Note: this requires package
.Ar kbd
to be installed.
.It Va INTERFACES
Interfaces to pass to
.Pa @SYSCONFDIR@/vinit.net
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 @SYSCONFDIR@/vinit.net
file.
.It Va TTYS
List of ttys to configure. (Default: tty1 to tty8).
.Pp
For each tty listed in this variable two variables
.Va <TTY>_ARGS
and
.Va <TTY>_FONT
can be specified where <TTY> is the uppercase tty number (e.g. TTY1 for tty1).
The first one specifies the arguments to pass to the getty program which is set
to
.Dq 38400
by default. If the boolean _FONT isn't set to
.Dq no ,
its console font will be changed according to
.Va FONT
value.
.El
.Sh EXAMPLES
.Ss Starting sysklogd package
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"
.Ed
.Sh SEE ALSO
.Xr vinit 7