-
Notifications
You must be signed in to change notification settings - Fork 0
/
rc.conf.5
171 lines (169 loc) · 4.49 KB
/
rc.conf.5
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
.\" rc.conf(5) manual page
.\" See COPYING and COPYRIGHT files for corresponding information.
.Dd September 3, 2023
.Dt RC.CONF 5
.Os
.\" ==================================================================
.Sh NAME
.Nm rc.conf
.Nd system configuration file
.\" ==================================================================
.Sh SYNOPSIS
.Nm /etc/rc.conf
.\" ==================================================================
.Sh DESCRIPTION
This manual page describes the format of the
.Pa /etc/rc.conf
file.
This file is a simple POSIX
.Xr sh 1p
script that defines font, timezone, hostname and services which are
used on system initialization and shutdown.
.Pp
The file consists of a number of variable assignments of the form
.Dq variable=value .
Comments can be specified by putting a hash
.Pf ( Ql # )
symbol as the first character on the line.
.Pp
The different configuration variables are:
.Bl -tag -width Ds
.It Sy BLANKTIME Ns = Ns Aq Ar 0-60 | force | poke
Specifies the interval of console inactivity, in minutes, after which
the screen will be automatically blanked.
The contents of this variable will be passed as argument to
.Xr setterm 1 .
.Pp
The
.Ar force
argument keeps the screen blank even if a key is pressed.
.Pp
The
.Ar poke
argument unblanks the screen.
.Pp
If
.Sy BLANKTIME
is unset, then
.Xr rc 8
make screen blanks after 15 minutes of idle time.
.Pp
Example:
.Dq BLANKTIME=15
.It Sy FONT Ns = Ns Aq Ar STRING
Specifies which console font to load at system startup.
The contents of this variable will be passed as argument to
.Xr setfont 8 .
The available fonts are located in
.Pa /usr/share/kbd/consolefonts/ .
.Pp
Example:
.Dq FONT=default
.It Sy KEYMAP Ns = Ns Aq Ar STRING
Specifies which console keyboard map to load at system startup.
The contents of this variable will be passed as argument to
.Xr loadkeys 1 .
The available keyboard maps are located in
.Pa /usr/share/kbd/keymaps/ .
.Pp
Example:
.Dq KEYMAP=us
.It Sy TIMEZONE Ns = Ns Aq Ar STRING
Specifies the timezone used by the system.
The available zone description files are located in
.Pa /usr/share/zoneinfo/ .
.Pp
Example:
.Dq TIMEZONE=Europe/Stockholm
.It Sy HOSTNAME Ns = Ns Aq Ar STRING
Specifies the hostname.
.Pp
Example:
.Dq HOSTNAME=pluto
.It Sy SEEDRNG_SKIP_CREDIT Ns = Ns Aq Ar 1 | true | yes | y
Specifies
.Xr seedrng 8
that seeds never credit the RNG, even if the seed file is creditable.
Disabled by default.
.Pp
Example:
.Dq SEEDRNG_SKIP_CREDIT=false
.It Sy BOOTLOG Ns = Ns Aq Ar STRING
Specifies the boot logging daemon to run at startup.
The daemon specified in this string must have a matching start/stop
script in
.Pa /etc/rc.d .
.Pp
Example:
.Dq BOOTLOG=bootlogd
.It Sy DEVMGR Ns = Ns Aq Ar STRING
Specifies the device manager to run at startup instead of default
.Xr udevd 8 .
The daemon specified in this string must have a matching start/stop
script in
.Pa /etc/rc.d .
.Pp
Example:
.Dq DEVMGR=udevd
.It Sy SYSLOG Ns = Ns Aq Ar STRING
Specifies the system logging daemon to run at startup.
The daemon specified in this string must have a matching start/stop
script in
.Pa /etc/rc.d .
.Pp
Example:
.Dq SYSLOG=sysklogd
.It Sy SERVICES Ns = Ns Ql Aq Ar STRING ...
Specifies which services to start at system startup.
The services specified in this string must be separated by space and
have a matching start/stop script in
.Pa /etc/rc.d/ .
When entering multi-user mode the specified scripts will be called in
the specified order with the argument
.Dq Li start .
At system shutdown or when entering single-user mode these scripts will
be called in the reverse order with the argument
.Dq Li stop .
.Pp
Example:
.Dq SERVICES Ns = Ns Ql lo crond net sshd
.El
.Pp
The reason why the
.Sy SYSLOG
is specified separately from the
.Sy SERVICES
variable is as follows: firstly, the syslog daemon also starts in the
single-user mode, and secondly, it is needed before the start of any
services, so that the services can log the result if their work.
.\" ==================================================================
.Sh FILES
.Bl -tag -width "/etc/rc.conf"
.It Pa /etc/rc.conf
System configuration file.
.El
.\" ==================================================================
.Sh EXAMPLES
A sample
.Pa /etc/rc.conf
file:
.Bd -literal -offset indent
#
# /etc/rc.conf: system configuration
#
# See rc.conf(5) for more information.
#
BLANKTIME=15
FONT=default
KEYMAP=us
TIMEZONE=UTC
HOSTNAME=host
SYSLOG=sysklogd
SERVICES='lo crond net'
# End of file.
.Ed
.\" ==================================================================
.Sh SEE ALSO
.Xr rc 8
.\" vim: cc=72 tw=70
.\" End of file.