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.

d
/////
vim:set ts=4 sw=4 syntax=asciidoc noet:
/////
rc.conf(5)
==========

Name
----
rc.conf - core system configuration file

Synopsis
--------
rc.conf

Description
-----------
This manual page is meant to describe the fields defined in /etc/rc.conf.

Localization
------------

*LOCALE*::
        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.

*HARDWARECLOCK*::
        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.

*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.

*KEYMAP*::
        The layout describing your keyboard. This defaults to qwerty. Available
        keymaps are in /usr/share/kbd/keymaps. Note that this setting has no 
effect
        in X.

*CONSOLEFONT*::
        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.

*CONSOLEMAP*::
        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.

*USECOLOR*::
        Set to 'yes' or 'no'. Enable (or disable) colorized status messages 
during
        bootup and when starting/stopping daemons.

Hardware
--------

*MOD_AUTOLOAD*::
        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.

*MODULES (array)*::
        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.

*USELVM*::
        Set to 'yes' or 'no'. If you use LVM, set this to 'yes'.

Networking
----------

*HOSTNAME*::
        Sets of the hostname of the machine.

*INTERFACES (array)*::
        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 '!'.

        Example:
                eth0="eth0 192.168.0.10 netmask 255.255.255.0 broadcast 
192.168.1.255
                eth1="dhcp"
                INTERFACES=(eth0 !eth1)

        

*ROUTES (array)*::
        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.
        
        Example:
                gateway="default gw 192.168.0.1"
                ROUTES=(gateway)

Daemons
-------

*DAEMONS (array)*::
        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.

Reply via email to