From GhostBSD Wiki
Revision as of 16:55, 8 October 2020 by Slughorn (Talk | contribs) (Rc-update without options)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Welcome to Icon Disti GhostBSD.png Rc-update.
rc - shell
The generic hook into OpenRC.
Ordering rc-scripts
Scripts to run OpenRC
Scripts to run OpenRC
Scripts automatically executed at boot and shutdown
Special scripts
Configuration file for devd(8)
Initscript Configuration Files
Smaller configuration files
Specifies the default settings for all the available options.
The global OpenRC configuration file
GhostBSD specific configurations
Safely edit system rc files
Shows which services are running
Add or delete services
Locate and run an OpenRC service
Back to the Icon Disti GhostBSD.pngSystem


Managing runlevels is usually done through the rc-update helper, but could of course be done by hand if desired. e.g. rc-update add nginx default - add nginx to the default runlevel

All runlevels are represented as folders in /etc/runlevels/ with symlinks to the actual service scripts.
All services must reside in the /etc/init.d or /usr/local/etc/init.d directories. They must also conform to the OpenRC runscript standard.



rc-update – add and remove services to and from a runlevel


    rc-update [-s, --stack] add service [runlevel ...]
    rc-update [-s, --stack] [-a, --all] delete service [runlevel ...]
    rc-update [-u, --update] [-v, --verbose] show [runlevel ...]


OpenRC uses named runlevels. Rather than editing some obscure file or managing a directory of symlinks, rc-update exists to quickly add or delete services to and from from different runlevels. All services must reside in the /etc/init.d or /usr/local/etc/init.d directories.

They must also be standard OpenRC scripts, meaning they must use openrc-run.

    add service             Add the service to the runlevel or the current
                            one if none given.  Services added to the boot
                            runlevel must exist in /etc/init.d.
    delete service          Delete the service from the runlevel or the
                            current one if none given.
    show                    Show all enabled services and the runlevels they
                            belong to.  If you specify runlevels to show,
                            then only those will be included in the output.
    -v, --verbose           Show all services.
    -u, --update            Forces an update of the dependency tree cache.
                            This may be needed in the event of clock skew (a
                            file in /etc is newer than the system clock).

If the -s, --stack option is given then we either add or remove the runlevel from the runlevel. This allows inheritance of runlevels.

If the -a, --all option is given, we remove the service from all runlevels. This is useful, for example, to clean up the dangling symlinks after a service is removed.

Rc-update Example[edit]

Rc-update without options[edit]

rc-update without option shows all runlevels and services:

                 abi | boot                                   
           adjkerntz | boot                                   
        avahi-daemon |      default                           
      avahi-dnsconfd |      default                           
            bootmisc | boot                                   
              bridge | boot                                   
                cron | boot                                   
               cupsd |      default                           
                dbus |      default                           
                devd | boot                                   
               devfs |      default                           
               dmesg | boot                                   
              dumpon | boot                                   
                fsck | boot                                   
                hald |      default                           
              hostid | boot                                   
            hostname | boot
                ipfw |      default              
             kldxref | boot                                   
             lightdm |      default                           
               local |      default nonetwork                 
          localmount | boot                                   
             modules | boot                                   
                motd | boot                                   
              moused |      default                           
            netmount |      default                           
             network | boot                                   
           newsyslog | boot                                   
                ntpd |      default                           
                root | boot                                   
             routing | boot                                   
           savecache |                        shutdown        
            savecore | boot                                   
         staticroute | boot                                   
                swap | boot                                   
             syscons | boot                                   
              sysctl | boot                                   
             syslogd | boot                                   
             urandom | boot                                   
             vboxnet |      default                           
             webcamd |      default                           
                 zfs | boot                                   
                zvol | boot

boot shows if a service starts at boot.

Rc-update with option "add""[edit]

If you want a service starting at boot write as root:

rc-update add foo .

Rc-update with option "delate"[edit]

If a service don't have to start at boot write:

rc-update delete foo.