rcctl(8) is a utility to manage
/etc/rc.conf.local, for running, killing and managing system services.
thankfully since rcctl is part of base system, nothing is needed to install it.
rcctl ls can used for list-ing kinds of services
$ doas rcctl ls failed
$ doas rcctl ls on
rcctl check can used to check if a service is still running or not.
$ doas rcctl check vmd
if vmd is running:
rcctl enable enables services, making them executed on next boot.
it doesn't show anything after running.
see start for starting a service without rebooting.
$ doas rcctl enable xenodm
rcctl disable disables services, and don't let them to run on next boot. you might want to stop these as well.
rcctl disable xendom
rcctl start is for starting services which are allowed to run.
if you try to run a disabled service, following will happen:
$ doas rcctl start sndiod /etc/rc.d/sndiod: need -f to force start since sndiod_flags=NO
you can enable it's service, or use
rcctl start -f to start it without enabling it.
in both cases, you will see this:
rcctl stop stops running services, if a service is not running or not enabled, it won't say anything.
$doas rcctl stop sndiod sndiod(ok)
rcctl restart it first stop services, then starts them again (thats why it shows two). this is useful for when you have updated configurations. however, you most use reload always. (unless service is stopped or it doesn't support reload)
$doas rcctl restart smtpd smtpd(ok) smtpd(ok)
rcctl reload is used to tell a service to reload it's configuration files. it's useful for places such as an irc server which restarting will cause all users getting disconnected. not all services support this action.
it will send a signal to called service in order to reload it:
$ doas rcctl reload nsd nsd(ok)
some deamons ship with custom flags to change their functionality instad of a config file, you can change them with
flags if they are enabled.
apmd is a example of following, you can set @@-H@ to apmd to set maximum perforamce mode on apmd
$ doas rcctl set apmd flags -H
you can get information from services (no matter if they are running or not)
$ rcctl get pflogd pflogd_class=daemon pflogd_flags= pflogd_logger= pflogd_rtable=0 pflogd_timeout=30 pflogd_user=root