From ecc8af27039c9174301b9eb94884ccf56f00b33a Mon Sep 17 00:00:00 2001 From: Tom Gundersen Date: Wed, 18 Jul 2012 17:50:06 +0200 Subject: 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 --- rc.conf.5.txt | 69 +++++++++++++++++++++++++++++++---------------------------- 1 file changed, 36 insertions(+), 33 deletions(-) (limited to 'rc.conf.5.txt') 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 ------- -- cgit v1.2.3