dh_runit − install/enable runit runscripts
dh_runit [debhelper options] [path options] ...
dh_runit is a debhelper program that is responsible for installing and enabling runit runscripts. If file named debian/package.runit exists, then different actions are performed, depending on its format.
For runit, every unit of supervision, simply speaking program, is represented by directory under /etc/sv, containing at least run executable file. Every enabled program is represented by symbolic link under /etc/services (which itself is symbolic link to /etc/runit/runsvdir/default) pointing to some directory under /etc/sv.
dh_runit reads it’s arguments from command line and debian/package.runit by two, with first one being an file/directory and second one is options. If first argument is file, it is considered ’run’ script, and it is installed under /etc/sv/*/run, executable bit is added. If first argument is directory, it is copied as whole under /etc/sv.
Options are comma-separated, like to mount. Unsupported option is error, following are supported:
disable
With this option, runscript is installed, but not enabled by default. It means that corresponding service will not be started. System administrator can always do it manually or via update−service(8).
name=preferred−name
By default, name of directory under F</etc/sv> for given runscript is basename of first argument of pair. This option allows you to be explicit about it.
logscript
Install standard F<log/run> script, which invokes svlogd(8) with rights of dedicated user. It is error, if first argument in pair is directory, which already contains F</log/run> script.
logdir=/path/to/log/directory
This option is meaningful only with I<logscript>. It allows overriding default log directory F</var/log/runit/I<name>>.
defaults
If you need no other options, put this one.
This section contains several example snippets from package.runit
# In this case file is installed as 'run' script. Directory name under # /etc/sv is derived from file basename path/to/file/to/be/installed/as/run/script defaults # Same, but install directory as whole. It is your responsibility # to ensure is contains everything required. path/to/directory defaults # Same as above, but do not create symlink under /etc/service path/to/directory disable # You can explicitly specify name of directory under /etc/sv. # Standard log/run script will be created. path/to/directory name=my−preferred−name,logscript