aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Gundersen <teg@jklm.no>2012-07-18 17:50:06 +0200
committerTom Gundersen <teg@jklm.no>2012-07-18 17:53:39 +0200
commitecc8af27039c9174301b9eb94884ccf56f00b33a (patch)
treed7b0e72223b6213559ee453d9316b744ffa21fb9
parent8d84c52feb46129551a36d59aba1d108015c7658 (diff)
downloadinitscripts-ecc8af27039c9174301b9eb94884ccf56f00b33a.tar.xz
man: update rc.conf(5)
Recommend using the 'systemd' configuration files whereever that makes sense. Update to reflect various changes that have occurred since this was first written. Signed-off-by: Tom Gundersen <teg@jklm.no>
-rw-r--r--rc.conf.5.txt69
1 files changed, 36 insertions, 33 deletions
diff --git a/rc.conf.5.txt b/rc.conf.5.txt
index debb789..85a1551 100644
--- a/rc.conf.5.txt
+++ b/rc.conf.5.txt
@@ -32,7 +32,7 @@ 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
+Default: empty (recommended)
*HARDWARECLOCK=*
@@ -40,32 +40,33 @@ How to interpret/update the hardware clock. (used by hwclock)
Options:
- - empty: fall back to the value in /var/lib/hwclock/adjtime, which defaults to UTC. This is recommended
+ - 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": most robust, allows operating systems to abstract local time and ease DST.
- - "localtime": apply time zone (and DST) in hardwareclock: discouraged.
+ - "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).
- - any other value will result in the hardware clock being left untouched (useful for virtualization)
-Default: empty
+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.
+your TTYs, not any graphical window managers or X.
-Default: empty
+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
+Default: empty (recommended, see vconsole.conf(5))
*CONSOLEMAP=*
@@ -73,66 +74,68 @@ Defines the console map to load with the setfont program on boot. Possible maps
/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
+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.
+See `locale -a` (or locale.gen) for available options.
-Default: empty
+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 'yes', use $LOCALE as the locale during daemon start-up and during the boot process.
- - If set to 'no', the C locale is used.
+ - 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"
+Default: 'yes' (empty recommended)
*USECOLOR=*
-Use ANSI color sequences in start-up messages
+Use ANSI color sequences in start-up messages, unless set to 'no'.
-Default: "yes"
+Default: 'yes' (empty recommended)
HARDWARE[[H]]
-------------
*MODULES=*
-Modules to load at boot-up. To blacklist modules, see 'man 5 modprobe.d'. See also
-'man 5 modules-load.d'.
+Modules to load at boot-up. To blacklist modules, see 'man 5 modprobe.d'.
-Default: ().
+Default: empty (recommended, see modules-load.d(5))
*USEDMRAID=*
Scan for FakeRAID (dmraid) volumes at start-up.
-Default: "no"
+Default: 'no'
*USEBTRFS=*
Scan for Btrfs volumes at start-up.
-Default: "no"
+Default: 'no'
*USELVM=*
Scan for LVM volume groups at start-up. This is required if you use LVM.
-Default: "no"
+Default: 'no'
NETWORKING[[N]]
---------------
*HOSTNAME=*
-Hostname of machine. Should also be put in /etc/hosts. The contents of
-/etc/hostname (if not empty) takes precedence.
+Hostname of machine. Should also be put in /etc/hosts, unless nss-myhostname is used.
-Default: empty
+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.
@@ -142,7 +145,7 @@ Name of device. Use `ip addr` or `ls /sys/class/net/` to see all available inter
Default: empty
-Required for manual configuration as well as DHCP.
+Required for manual configuration.
*address=*
@@ -186,7 +189,7 @@ Required for manual configuration, ignored for DHCP.
*DHCP example*
- interface=eth0
+ interface=
address=
netmask=
gateway=
@@ -197,11 +200,11 @@ The following options might be needed for advanced use cases.
Setting this to "yes" will skip network shutdown. This is required if your root device is on NFS.
-Default: "no"
+Default: 'no'
*NETWORKS=*
-This functionality is deprecated; please refer to 'man 8 netcfg'.
+This functionality is deprecated; please refer to netcfg(8).
DAEMONS[[D]]
------------
@@ -223,7 +226,7 @@ Default: (syslog-ng network crond)
SEE ALSO
--------
-hostname(5), vconsole.conf(5), locale.conf(5), hwclock(8)
+hostname(5), vconsole.conf(5), locale.conf(5), hwclock(8), modules-load.d(5), modprobe.d(5), ip(8), dhcpcd(8)
AUTHORS
-------