aboutsummaryrefslogtreecommitdiff
path: root/rc.conf.5.txt
diff options
context:
space:
mode:
authorDieter Plaetinck <dieter@plaetinck.be>2011-12-26 00:46:44 +0100
committerTom Gundersen <teg@jklm.no>2011-12-26 11:32:01 +0100
commit38fb6e378f153ceec01b9570a01ec4b7a029661d (patch)
tree546c523bd8ace9618cfa462bd2d7430af3382fe1 /rc.conf.5.txt
parent74397f08bc511a84b6ee9a3a453f43e1adaaf9df (diff)
downloadinitscripts-38fb6e378f153ceec01b9570a01ec4b7a029661d.tar.xz
Add manpage(5) for rc.conf
[tomegun: fixed whitespace error] Signed-off-by: Tom Gundersen <teg@jklm.no>
Diffstat (limited to 'rc.conf.5.txt')
-rw-r--r--rc.conf.5.txt167
1 files changed, 167 insertions, 0 deletions
diff --git a/rc.conf.5.txt b/rc.conf.5.txt
new file mode 100644
index 0000000..e28e9ad
--- /dev/null
+++ b/rc.conf.5.txt
@@ -0,0 +1,167 @@
+/////
+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]]
+-----------------
+*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.
+ Default: "en_US.UTF-8"
+
+*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"
+
+*HARDWARECLOCK*::
+ How to interpret/update the hardware clock. (used by hwclock)
+ Options:
+ - "": fall back to the value in /var/lib/hwclock/adjfile.
+ - "UTC": most robust, allows operating systems to abstract local time and ease DST. (recommended)
+ - "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: "UTC"
+
+*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"
+
+*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: "us"
+
+*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
+
+*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.
+
+
+*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 Dieter Plaetinck and others.