summaryrefslogtreecommitdiff
path: root/rc.conf.5.txt
blob: 05cf74fc640a370cc44c82751b3e26b01140526b (plain)
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
172
173
174
175
176
177
178
179
180
181
182
/////
vim:set ts=4 sw=4 syntax=asciidoc noet:
/////
rc.conf(5)
==========

Name
----
rc.conf - Arch Linux main configuration file

Synopsis
--------
*/etc/rc.conf*

Description
-----------
The */etc/rc.conf* file is the system configuration file for Arch-specific
settings. The format is bash. It contains several commonly-edited settings such
as timezone; keymap; kernel modules; daemons to load at start-up; etc. It's
split up in a few sections to categorize configuration settings: localization,
hardware, networking and daemons.

Localization[[L]]
-----------------
*TIMEZONE*::
	Specifies your time zone. Possible time zones are the relative path to a zoneinfo file starting
	from the directory /usr/share/zoneinfo. For example, a German timezone would be Europe/Berlin,
	which refers to the file /usr/share/zoneinfo/Europe/Berlin.
	Note: if unset, the value in /etc/localtime is used unchanged
	Default: "Canada/Pacific"

*HARDWARECLOCK*::
	How to interpret/update the hardware clock. (used by hwclock)
	Options:
	    - empty: fall back to the value in /var/lib/hwclock/adjfile, which defaults to UTC. (recommended)
	    - "UTC": most robust, allows operating systems to abstract local time and ease DST.
	    - "localtime": apply timezone (and DST) in hardwareclock: discouraged.
	      Choose this if you dualboot with an OS which cannot handle UTC BIOS times correctly, like Windows.
	    - any other value will result in the hardware clock being left untouched (useful for virtualization)
	Default: empty

*KEYMAP*::
	Defines the keymap to load with the loadkeys program on bootup.
	Possible keymaps are found in /usr/share/kbd/keymaps. Please note that this
	setting is only valid for your TTYs, not any graphical window managers or X.
	Defalut: empty

*CONSOLEFONT*::
	Defines the console font to load with the setfont program on bootup.
	Possible fonts are found in /usr/share/kbd/consolefonts. (only needed for non-US)
	Default: empty

*CONSOLEMAP*::
	Defines the console map to load with the setfont program on bootup.
	Possible maps are found in /usr/share/kbd/consoletrans.
	Set this to a map suitable for the appropriate locale (8859-1 for Latin1, for example)
	if you're using an UTF-8 locale and use programs that generate 8-bit output.
	If you're using X11 for everyday work, don't bother,
	as it only affects the output of Linux console applications.
	Default: empty

*LOCALE*::
	This sets your system language, which will be used by all i18n-friendly applications and utilities.
	See `locale -a` (or locale.gen) for available options. 	LANG in /etc/locale.conf takes precedence.
	If unset, it falls back to the C locale.
	Default: empty

*DAEMON_LOCALE*::
	If set to 'yes', use $LOCALE as the locale during daemon startup and during the boot process.
	If set to 'no', the C locale is used.
	Default: "no"

*USECOLOR*::
	use ANSI color sequences in startup messages
	Default: "yes"

Hardware[[H]]
-------------

*MODULES*::
	Modules to load at boot-up.  To blacklist modules, see "man modprobe.conf".
	Default: ().

*UDEV_TIMEOUT*::
	Udev settle timeout.
	Default: 30

*USEDMRAID*::
	Scan for FakeRAID (dmraid) Volumes at startup.
	Default: "no"

*USEBTRFS*::
	Scan for BTRFS volumes at startup.
	Default: "no"

*USELVM*::
	Scan for LVM volume groups at startup, required if you use LVM.
	Default: "no"

Networking[[N]]
---------------

*HOSTNAME*::
	Hostname of machine. Should also be put in /etc/hosts.
	Default: "myhost"

The following settings help you setting up a wired network.

*interface*::
	Name of device.
	Default: empty
	Required for manual configuration as well as DHCP.
	Use 'ip addr' or 'ls /sys/class/net/' to see all available interfaces.

*address*::
	IP address.
	Default: empty
	Required for manual configuration, empty for DHCP.

*netmask*::
	Subnet mask.
	Default: empty (which means 255.255.255.0)
	Optional for manual configuration, ignored for DHCP.

*broadcast*::
	Broadcast address.
	Default: empty
	Optional for manual configuration, ignored for DHCP.

*gateway*::
	Default route.
	Default: empty
	Required for manual configuration, ignored for DHCP.

*Static IP example*::
	interface=eth0
	address=192.168.0.2
	netmask=255.255.255.0
	broadcast=192.168.0.255
	gateway=192.168.0.1

*DHCP example*::
	interface=eth0
	address=
	netmask=
	gateway=

The following options might be needed for advanced use-cases.

*NETWORK_PERSIST*::
	Setting this to "yes" will skip network shutdown.
	This is required if your root device is on NFS.
	Default: "no"

*NETWORKS*::
	Enable these netcfg profiles at boot-up. These are useful if you happen to
	need more advanced network features than the simple network service
	supports, such as multiple network configurations (ie, laptop users)
	   - set to 'menu' to present a menu during boot-up (dialog package required)
	   - prefix an entry with a ! to disable it
	Network profiles are found in /etc/network.d
	This requires the netcfg package
	Default: (main), (commented out).

Daemons[[D]]
------------
*DAEMONS*::
	Daemons to start at boot-up (in this order)
	   - prefix a daemon with a ! to disable it
	   - prefix a daemon with a @ to start it up in the background

	If you are sure nothing else touches your hardware clock (such as ntpd or
	a dual-boot), you might want to enable 'hwclock'. Note that this will only
	make a difference if the hwclock program has been calibrated correctly.

	If you use a network filesystem you should enable 'netfs'.

	Default: (syslog-ng network crond)

Authors
-------
	Written by Tom Gundersen, Dieter Plaetinck and others.