dh_metainit - install metainit files into package build directories
dh_metainit is a debhelper program that is responsible for installing metainit
files (for further creation of initscripts via the update-metainit facility)
into package build directories.
It also automatically generates the postinst and postrm and prerm commands
needed to create the appropriate initscripts for the init system employed on
the user machine.
If generated postinst script finds /etc/init.d/ or
/etc/default files with the same name as the shipped metainit files, and these
are conffiles from non-installed packages (probably earlier version of this
package) they are removed (or renamed if the user has modified them). This
works only if the name of the new metainit is the same as the name of the old
init.d and default file, otherwise you will have to remove these files
yourself. See http://wiki.debian.org/DpkgConffileHandling for that.
If a file named debian/package.metainit exists, then it is installed into
etc/metainit/package in the package build directory, with "package"
replaced by the package name.
- -n, --noscripts
- Do not modify postinst/postrm/prerm scripts.
- -o, --onlyscripts
- Only modify postinst/postrm/prerm scripts, do not actually
install any metainit files. May be useful if the init script is shipped
and/or installed by upstream in a way that doesn't make it easy to let
dh_metainit find it.
- Install the metainit script using the filename name
instead of the default filename, which is the package name. When this
parameter is used, dh_metainit looks for and installs files named
debian/package.name.metainit, instead of the usual
- Call the named shell function if running the init script
fails. The function should be provided in the prerm and postinst scripts,
before the #DEBHELPER# token.
Note that this command is not idempotent. "dh_clean -k" should be
called between invocations of this command. Otherwise, it may cause multiple
instances of the same text to be added to maintainer scripts.
This program is a part of debhelper.
Urs Ganse <email@example.com> based on dh_installinit by Joey Hess