///// 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 time zone, keymap, kernel modules, daemons to load at start-up, etc. It is split up in a few sections to categorize configuration settings: localization, hardware, networking, and daemons. LOCALIZATION[[L]] ----------------- *TIMEZONE=* Specifies the time zone. The setting takes effect on boot by ensuring that /etc/localtime is a symlink to the correct zoneinfo file. Possible time zones are the relative path to a zoneinfo file starting from the directory /usr/share/zoneinfo. For example, a German time zone would be Europe/Berlin, which refers to the file /usr/share/zoneinfo/Europe/Berlin. Note: If empty, /etc/localtime is not changed. This is useful if /etc/localtime is maintained manually or by a third-party tool, or if there is no reason to change it from what was set during install. Default: empty (recommended) *HARDWARECLOCK=* How to interpret/update the hardware clock. (used by hwclock) Options: - empty: fall back to the value in /etc/adjtime, which defaults to UTC. This is recommended as other users of hwclock might change the adjtime file and hence cause rc.conf and adjtime to be out of sync. - "UTC": allows the operating systems to abstract away local time and ease DST. - "localtime": apply time zone (and DST) in hardwareclock: strongly discouraged. Choose this if you dual-boot with an OS which cannot handle UTC BIOS times correctly, like Windows (note that recent Windows versions can use UTC, which is preferable). Default: empty (recommended) *KEYMAP=* Defines the keymap to load with the loadkeys program on boot. 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. KEYMAP in /etc/vconsole.conf takes precedence. Default: empty (recommended, see vconsole.conf(5)) *CONSOLEFONT=* Defines the console font to load with the setfont program on boot. Possible fonts are found in /usr/share/kbd/consolefonts (only needed for non-US). FONT in /etc/vconsole.conf takes precedence. Default: empty (recommended, see vconsole.conf(5)) *CONSOLEMAP=* Defines the console map to load with the setfont program on boot. 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. FONT_MAP in /etc/vconsole.conf takes precedence. Default: empty (recommended, see vconsole.conf(5)) *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 (recommended, see locale.conf(5)) *DAEMON_LOCALE=* - If set to 'no', export the C locale to daemons and during the boot process. - Otherwise, export LANG (or LOCALE) as configured in /etc/locale.conf (or /etc/rc.conf). Default: 'yes' (empty recommended) *USECOLOR=* Use ANSI color sequences in start-up messages, unless set to 'no'. Default: 'yes' (empty recommended) HARDWARE[[H]] ------------- *MODULES=* Modules to load at boot-up. To blacklist modules, see 'man 5 modprobe.d'. Default: empty (recommended, see modules-load.d(5)) *USEDMRAID=* Scan for FakeRAID (dmraid) volumes at start-up. Default: 'no' *USEBTRFS=* Scan for Btrfs volumes at start-up. Default: 'no' *USELVM=* Scan for LVM volume groups at start-up. This is required if you use LVM. Default: 'no' NETWORKING[[N]] --------------- *HOSTNAME=* Hostname of machine. Should also be put in /etc/hosts, unless nss-myhostname is used. The contents of /etc/hostname (if not empty) takes precedence. Default: empty (recommended, see hostname(5)) The following settings help you setting up a wired network. *interface=* Name of device. Use `ip addr` or `ls /sys/class/net/` to see all available interfaces. Default: empty Required for manual configuration. *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= 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=* This functionality is deprecated; please refer to netcfg(8). 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 by dual-booting), 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) SEE ALSO -------- hostname(5), vconsole.conf(5), locale.conf(5), hwclock(8), modules-load.d(5), modprobe.d(5), ip(8), dhcpcd(8) AUTHORS ------- Written by Dieter Plaetinck, Tom Gundersen, and others.