NAME
dh_metainit - install metainit files into package build directories
SYNOPSIS
dh_metainit [debhelper options] [--name=name] [-n] [-o]
DESCRIPTION
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.
Important: 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.
OPTIONS
-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.
--name=name
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
debian/package.init.
--error-handler=function
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.
NOTES
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.
SEE ALSO
debhelper(7)
This program is a part of debhelper.
AUTHOR
Urs Ganse <urs@nerd2nerd.org> based on dh_installinit by Joey Hess
<joeyh@debian.org>