rc.d

RC.D(8)                 OpenBSD System Manager's Manual                RC.D(8)

NAME

     rc.d - daemon control scripts

SYNOPSIS

     /etc/rc.d/daemon [-df] action

DESCRIPTION

     The /etc/rc.d directory contains shell scripts to start, stop, and
     reconfigure daemon programs (``services'').

     Services installed from packages(7) may be started at boot time in the
     order specified by the pkg_scripts variable from rc.conf(8); the order
     will be reversed during shutdown.  Services comprising OpenBSD base are
     started by rc(8).

     The options are as follows:

     -d      Setting this option will print the function names as they are
             called and prevent the rc.subr(8) framework from redirecting
             stdin and stderr to /dev/null.  This is used to allow debugging
             of failed actions.

     -f      Setting this option will force operations with the given action.
             If daemon_flags is set to ``NO'', execution will continue with
             the script's own defaults unless other flags are specified.

     Each such script responds to the following actions:

           start    Start the service, if not already running.
           stop     Stop the service.
           reload   Tell the daemon to reload its configuration.
           restart  Perform a stop, then a start.
           check    Return 0 if the daemon is running or 1 if it is not.

ENVIRONMENT

     Daemon control scripts use a fixed number of sh(1) variables when
     starting a daemon.  The following two can be overridden by site-specific
     values provided in rc.conf.local(8):

           daemon_flags  Arguments to call the daemon with.  If set to ``NO'',
                         it will prevent the daemon from starting even when
                         listed in pkg_scripts.
           daemon_user   User to run the daemon as, using su(1).

     To obtain the actual variable names, replace daemon with the name of the
     script.  For example, postgres is managed through /etc/rc.d/postgresql.
     To run the daemon using a site-specific user account, define the
     following in rc.conf.local(8):

           postgresql_user=mypgsqluser

     Each script may define its own defaults, as explained in rc.subr(8).

     daemon_class is a special read-only variable.  It is set to ``daemon''
     unless there is a login class configured in login.conf(5) with the same
     name as the rc.d script itself, in which case it will be set to that
     login class.

FILES

     /etc/rc.d/
             Directory containing daemon control scripts.

     /etc/rc.d/rc.subr
             Functions and variables used by rc.d scripts.

SEE ALSO

     rc(8), rc.conf(8), rc.subr(8)

HISTORY

     The /etc/rc.d directory first appeared in OpenBSD 4.9.

OpenBSD 5.1                     October 9, 2011                    OpenBSD 5.1