dh_runit - install/enable runit runscripts
] [path options
is a debhelper program that is responsible for installing and
runscripts. If file named
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
file. Every enabled program is represented by symbolic link under
(which itself is symbolic link to
) pointing to some directory under
reads it's arguments from command line and
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
Options are comma-separated, like to mount. Unsupported option is error,
following are supported:
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
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.
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.
This option is meaningful only with I<logscript>. It allows
overriding default log directory F</var/log/runit/I<name>>.
If you need no other options, put this one.
This section contains several example snippets from
# In this case file is installed as 'run' script. Directory name under
# /etc/sv is derived from file basename
# Same, but install directory as whole. It is your responsibility
# to ensure is contains everything required.
# Same as above, but do not create symlink under /etc/service
# You can explicitly specify name of directory under /etc/sv.
# Standard log/run script will be created.