Mercurial > vanilla

annotate core/rc/rc.conf.5 @ 1341:9f35c15329d1 default tip @

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
dev/meson: downgrade to 0.59.4 due to many regression
author David Demelier <markand@malikania.fr>
date Wed, 22 Dec 2021 21:52:57 +0100
parents 58211c615a8c
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 .\" Copyright (c) 2019 David Demelier <markand@malikania.fr>
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 .\" Permission to use, copy, modify, and/or distribute this software for any
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 .\" purpose with or without fee is hereby granted, provided that the above
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 .\" copyright notice and this permission notice appear in all copies.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 .\"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 .Dd July 08, 2019
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 .Dt RC.CONF 5
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
18 .Os
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 .Sh NAME
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 .Nm rc.conf
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
21 .Nd system configuration
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 .Sh DESCRIPTION
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
23 The file
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 .Nm
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 contains information about the system.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 It is evaluated at boot time when
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 .Pa /etc/rc.init
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 is started from init and performs initialization. The file is sourced from a
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 shell script and therefore can contain shell code.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 The following options are available:
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 .Bl -tag -width indent-two
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 .It Va HOSTNAME
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 Sets the machine hostname. (Default: localhost)
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 .It Va TIMEZONE
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 Sets the time zone. You can get a list of timezones in the
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 .Pa /share/zoneinfo
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 directory. The variable must be in the form
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 .Ar Area/Region .
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 (Default: empty)
630
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
42 .Pp
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
43 Note: this requires package
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
44 .Ar tzdata
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
45 to be installed.
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 .It Va SERVICES
630
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
47 This variable contains services to be started at boot. (Default: empty).
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
48 In Vanilla Linux, services have no dependencies and therefore user is
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
49 responsible of starting them is a specific order if needed. Thus, services
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
50 marked in this list separated by spaces are executed in order.
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 Services names are in the form
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 .Ar name[:N]
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 where name is the actual service file located in
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 .Pa /etc/rc.d
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 directory. The optional
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 .Ar N
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 argument is the minimal runlevel number required to start this service. For
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 example, a value of 3 means that the service will be started only if the desired
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 runlevel is 3 or higher.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 Some services offer tunables to pass additional configuration to them. See the
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
63 service file header for more information.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
65 Note: don't forget to mark the service file as executable or it won't be
630
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
66 executed by init process.
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 .It Va FONT
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 Sets the console font. A list is available in /share/kbd/consolefonts. (Default:
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
69 empty).
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 Note: this requires package
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 .Ar kbd
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 to be installed.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
74 .It Va KEYMAP
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 Sets the console keymap. A list is available in /share/kbd/keymaps. (Default:
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 empty).
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
77 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
78 Note: this requires package
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
79 .Ar kbd
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
80 to be installed.
630
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
81 .It Va INTERFACES
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
82 Interfaces to pass to
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
83 .Pa /etc/rc.networking
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
84 script during bootup and shutdown. Mostly used for static IP addresses. It's
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
85 strongly advised to keep
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
86 .Ar lo
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
87 interface in this variable. (Default: lo)
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
88 .Pp
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
89 See the documentation in the
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
90 .Pa /etc/rc.networking
58211c615a8c core/rc: add basic rc.networking support
David Demelier <markand@malikania.fr>
parents: 585
diff changeset
91 file.
585
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
92 .El
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
93 .Sh EXAMPLES
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
94 .Ss Starting sysklogd package
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
95 In this example we will start
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
96 .Ar sysklogd
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
97 from the runlevel 2 and higher.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
98 .Pp
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
99 The
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 .Ar sysklogd
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
101 package understand the variable
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
102 .Va SYSKLOGD_ARGS
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
103 and may be used instead. However, please note that setting this variable replace
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
104 the original arguments so double check the service file before setting any
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
105 variable.
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
106 .Bd -literal
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 SYSKLOGD_ARGS="-4"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
108 SERVICES="sysklogd:2"
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
109 .Ed
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
110 .Sh SEE ALSO
75c8521c9b7a core/rc: add initial documentation
David Demelier <markand@malikania.fr>
parents:
diff changeset
111 .Xr rc 7