RC(7)

NAME
rc - Description of the /etc/rc.d heirarchy

DESCRIPTION
Mastodon uses its own kind of rc heirarchy, which is almost completely unlike everything else out there. It contains:

/etc/rc.d/bootscript
    This script is run when the system starts up.

/etc/rc.d/functions
    This directory contains programs and scripts that are used by rc(8) when changing runlevels.

/etc/rc.d/init.d
    This directory contains scripts that are used to start, configure, and stop system services. Nothing is executed out of this directory -- files are linked into runlevel directories and executed there.

/etc/rc.d/net.cf
    This directory contains configuration information for each network interface configured into the system. When the network service starts or stops, it reads this directory and handles every network interface described in it.

/etc/net.cfg
    This file contains the module name of the first detected network card in the system. It is used by bootscript to load the kernel module containing the driver for that card.

/etc/rc
    Rc(8) is the program that is run when the system changes runlevels. It performs an orderly shutdown of the services that were started in the old runlevel, then starts the new services required for the new runlevel.

/etc/rc.1
    This directory contains links to the rc scripts (in init.d)neededtobringthesystemtosingle-usermode.

/etc/rc.h
    This directory contains links to the rc scripts needed to halt the system.

/etc/rc.m
    This directory contains links to the rc scripts needed to bring the system into normal multiuser mode, plus it contains executable scripts that are used to start and stop locally defined services.

/etc/rc.r
    This directory contains links to the rc scripts needed to reboot the system.

/etc/rc.0(optional)
    This directory, if it exists, is a link to rc.h.

/etc/rc.2-5(optional)
    These directories, if they exist, are links to rc.h; they will only exist to provide SysV compatability for stupid application installers that insist on tweaking with /etc/rc.d, but only know about SysV and Berkeley rc scripts.

/etc/rc.d/sysconfig
    This is the global configuration file for the system. It contains settings for such things as the machine name, the console mouse, and the domain name.

Mastodon has runlevels just like System V does, but it uses different set of them:

halt(h)
    It is safe to power off the machine in this mode. When you halt the system, a message will be put on the console telling you that it's okay to power off or press any key. If you press any key, the system will start up as if it had just rebooted.

single(1)
    Single-user mode. When the system is in single-user mode, the root filesystem will be mounted, /proc will be mounted, update will be running, and a single shell will be running on the console (usually /dev/tty0)

multi(m)
    Multi-user mode. When the system is in this mode, all services are running and the machine is ready for use.

reboot(r)
    This mode reboots the machine.

CONFORMS TO
Mastodon, and nothing else. It may superficially resemble the System V rc setup, but it's does not operate the same.

SEE ALSO
rc(8), rcfile(5), chkconfig(1)

AUTHOR
David Parsons (orc@pell.chi.il.us)