Mercurial > vinit
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