SYNOPSIS

dh_runit [debhelper options]

DESCRIPTION

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 pointing to some directory under /etc/sv.

debian/package.runit is a list of lines, where every line is either starts with hash symbol and considered comment, or contains two or three space-separated words.

  # In this case file is installed as 'run' script. Directory name under
  # /etc/sv is derived from file basename
  enable path/to/file/to/be/installed/as/run/script
  # Same, but install directory as whole. It is your responsibility
  # to ensure is contains everything required.
  enable path/to/directory
  # Same as above, but do not create symlink under /etc/service
  disable path/to/directory
  # Also, you can explicitly specify name of directory under /etc/sv
  enable path/to/directory my-preferred-name