DH_OPENRC(1)

NAME
dh_openrc - install OpenRC service registration into package maintainer scripts

SYNOPSIS
dh_openrc [debhelper options] [-n] [service options ...]

DESCRIPTION
dh_openrc is a debhelper program that registers OpenRC services using rc-update(8) and rc-service(8) in package maintainer scripts.

It is intended to be used with dh --with openrc. In that mode, dh_installinit(1) still installs debian/package.init (and related files) into /etc/init.d/, but does not emit sysvinit update-rc.d(8) snippets. dh_openrc supplies the OpenRC equivalents according to debian/package.openrc.

FILES

debian/package.openrc
    Lists OpenRC services to register. Each non-comment line has the form:

      I<service> [I<options>]

    where options is a comma-separated list (same style as dh_runit(1)).

    If this file is absent, dh_openrc does nothing for that package.

OPTIONS IN debian/package.openrc

defaults
    Explicit no-op placeholder.

runlevel=runlevel
    OpenRC runlevel(s) passed to rc-update add. Default: default. Multiple runlevels may be separated by spaces inside the value if quoted via a single token without commas, e.g. "runlevel=default" (one runlevel).

name=name
    Service / /etc/init.d script name. Defaults to the first field on the line.

disable
    Do not enable the service (skip rc-update add).

nostart
    Do not start/stop/restart via rc-service; only manage runlevel membership.

onupgrade=restart|stop|nostop
    Upgrade policy (default restart):

    restart
        Restart (or start on fresh install) after upgrade; do not stop in preinst during upgrade (like dh_installinit --restart-after-upgrade).

    stop
        Stop before upgrade and start after (classic prerm/postinst).

    nostop
        Do not stop or restart on upgrade; still stop on remove.

noscripts
    Do not modify maintainer scripts for this entry.

EXAMPLES
  # debian/rsyslog.openrc
  rsyslog runlevel=default

  # debian/netbase.openrc
  networking runlevel=sysinit,nostart

  # debian/foo.openrc
  foo defaults
  foo-extra name=foo-extra,runlevel=default,disable

OPTIONS

-n, --no-scripts
    Do not modify maintainer scripts (global).

SEE ALSO
debhelper(7), dh_installinit(1), rc-update(8), rc-service(8), dh_runit(1)

AUTHOR
OpenRC packaging helpers for Devuan-style systems.