NAME

SYNOPSIS

DESCRIPTION

Operation of rc

1. If autobooting, set autoboot=yes and enable a flag (rc_fast=yes), which prevents the rc.d/ scripts from performing the check for already running processes (thus speeding up the boot process). This rc_fast=yes speedup will not occur when rc is started up after exiting the single-user shell.
2. Determine whether the system is booting diskless, and if so run the /etc/rc.initdiskless script.
3. Source /etc/rc.subr to load various rc.subr(8) shell functions to use.
4. Load the configuration files.
5. Determine if booting in a jail, and add “nojail” (no jails allowed) or “nojailvnet” (only allow vnet-enabled jails) to the list of KEYWORDS to skip in rcorder(8).
6. If the file ${firstboot_sentinel} does not exist, add “firstboot” to the list of KEYWORDS to skip in rcorder(8).
7. Invoke rcorder(8) to order the files in /etc/rc.d/ that do not have a “nostart” KEYWORD (refer to rcorder(8)'s -s flag).
8. Call each script in turn using run_rc_script() (from rc.subr(8)), which sets $1 to “start”, and sources the script in a subshell. If the script has a .sh suffix then it is sourced directly into the current shell. Stop processing when the script that is the value of the $early_late_divider has been run.
9. Check again to see if the file ${firstboot_sentinel} exists (in case it is located on a newly mounted file system) and adjust the list of KEYWORDs to skip appropriately.
10. Re-run rcorder(8), this time including the scripts in the $local_startup directories. Ignore everything up to the $early_late_divider, then start executing the scripts as described above.
11. If the file ${firstboot_sentinel} exists, delete it. If the file ${firstboot_sentinel}-reboot also exists (because it was created by a script), then delete it and reboot.

Operation of rc.shutdown

1. Source /etc/rc.subr to load various rc.subr(8) shell functions to use.
2. Load the configuration files.
3. Invoke rcorder(8) to order the files in /etc/rc.d/ and the $local_startup directories that have a “shutdown” KEYWORD (refer to rcorder(8)'s -k flag), reverse that order, and assign the result to a variable.
4. Call each script in turn using run_rc_script() (from rc.subr(8)), which sets $1 to “stop”, and sources the script in a subshell. If the script has a .sh suffix then it is sourced directly into the current shell.

Contents of rc.d/

• Scripts are only executed if their basename(1) matches the shell globbing pattern *.sh, and they are executable. Any other files or directories present within the directory are silently ignored.
• When a script is executed at boot time, it is passed the string “start” as its first and only argument. At shutdown time, it is passed the string “stop” as its first and only argument. All rc.d/ scripts are expected to handle these arguments appropriately. If no action needs to be taken at a given time (either boot time or shutdown time), the script should exit successfully and without producing an error message.
• The scripts within each directory are executed in lexicographical order. If a specific order is required, numbers may be used as a prefix to the existing filenames, so for example 100.foo would be executed before 200.bar; without the numeric prefixes the opposite would be true.
• The output from each script is traditionally a space character, followed by the name of the software package being started or shut down, without a trailing newline character (see the EXAMPLES section).

SCRIPTS OF INTEREST

FILES

/etc/rc

 

/etc/rc.conf

 

/etc/rc.conf.local

 

/etc/rc.d/

 

/etc/rc.firewall

 

/etc/rc.local

 

/etc/rc.shutdown

 

/etc/rc.subr

 

/var/run/dmesg.boot

dmesg(8) results soon after the rc process begins. Useful when dmesg(8) buffer in the kernel no longer has this information.

EXAMPLES

#!/bin/sh 
# 
 
# PROVIDE: foo 
# REQUIRE: bar_service_required_to_precede_foo 
 
. /etc/rc.subr 
 
name="foo" 
rcvar=foo_enable 
command="/usr/local/bin/foo" 
 
load_rc_config $name 
run_rc_command "$1"

#!/bin/sh 
# 
 
# PROVIDE: foo 
# REQUIRE: bar_service_required_to_precede_foo 
# BEFORE:  baz_service_requiring_foo_to_precede_it 
 
. /etc/rc.subr 
 
name="foo" 
rcvar=foo_enable 
command="/usr/local/bin/foo" 
extra_commands="nop hello" 
hello_cmd="echo Hello World." 
nop_cmd="do_nop" 
 
do_nop() 
{ 
	echo "I do nothing." 
} 
 
load_rc_config $name 
run_rc_command "$1"

SEE ALSO

HISTORY