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>