[arch-general] rc.conf man page
d at falconindy.com
Mon Aug 23 14:59:11 EDT 2010
I threw together a man page for rc.conf based on info gleaned from the
Wiki, rc.conf itself, and my own experiences. I offer it up for for
adoption into the initscripts package along with comments, critcisms,
and rotten tomatoes. The format is asciidoc, which is the same format
used by pacman.
If desirable, I'm willing to compile other pages for system config files
in a similar manner.
-------------- next part --------------
vim:set ts=4 sw=4 syntax=asciidoc noet:
rc.conf - core system configuration file
This manual page is meant to describe the fields defined in /etc/rc.conf.
This sets your system language, which will be used by all i18n-friendly
applications and utilities. You can get a list of the available locales by
running locale -a from the command line. This setting's default is fine for
US English users.
Specifies whether the hardware clock, which is synchronized from on bootup
and to on shutdown, stores UTC time, or the localtime. UTC makes sense
because it greatly simplifies changing timezones and daylight savings time.
localtime is necessary if you dual boot with an operating system that only
stores localtime to the hardware clock, such as Windows.
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
The layout describing your keyboard. This defaults to qwerty. Available
keymaps are in /usr/share/kbd/keymaps. Note that this setting has no effect
Defines the console font to load with the setfont program on boot-up (e.g.
ter-v14b). Available fonts are in /usr/share/kbd/consolefonts.
Defines the console map to load with the setfont program on boot-up
(8859-1_to_uni for example). Available maps are found in
/usr/share/kbd/consoletrans. You will want to set this to a map suitable
for your locale (8859-1 for Latin1, for example) if you use an utf8 locale
above and use programs that generate 8-bit output. Note that this setting
has no effect in X.
Set to 'yes' or 'no'. Enable (or disable) colorized status messages during
bootup and when starting/stopping daemons.
Set to 'yes' or 'no'. If set to 'yes', your hardware will be scanned at boot
time by udev and the appropriate kernel modules will be loaded.
Explicit list of modules to be loaded or blacklisted during bootup. This
can be defined in addition to setting MOD_AUTOLOAD as 'yes' and *must* be
defined if MOD_AUTOLOAD is set to 'no'. To blacklist a module, prefix it
with a '!' symbol.
Set to 'yes' or 'no'. If you use LVM, set this to 'yes'.
Sets of the hostname of the machine.
A list of network interfaces, specified by their kernel name (e.g. eth0).
For each interface in this list, the 'network' service expects a variable
of the same name to exist providing either a parameter string for
initialization, or 'dhcp'. Interfaces can be prevented from starting by
prefixing with a '!'.
eth0="eth0 192.168.0.10 netmask 255.255.255.0 broadcast 192.168.1.255
A list of routes to be created. For each item in this list, the 'network'
service expects to find a variable of the same name to exist providing a
string of parameters to be passed to the 'route' command in order to create
the route. Routes can prevented from being created by prefixing with a '!' symbol.
gateway="default gw 192.168.0.1"
A list of daemons to be started by 'rc.multi'. Daemons are started *in the
order listed* and shutdown in reverse order. Each entry must have a
corresponding script existing in '/etc/rc.d'. To start a daemon in the
background, prefix it with a '@' symbol. To prevent a daemon from being
started, prefix it with a '!' symbol.
More information about the arch-general