DH_INSTALLINIT

Section: Debhelper (1)
Updated: 2002-01-27
Index
Return to Main Contents

NAME

dh_installinit - install init scripts into package build directories

SYNOPSIS

dh_installinit [debhelper options] [--init-script=scriptname] [-n] [-r] [-d] [-- params]

DESCRIPTION

dh_installinit is a debhelper program that is responsible for installing init scripts and associated defaults files into package build directories.

It also automatically generates the postinst and postrm and prerm commands needed to set up the symlinks in /etc/rc*.d/ and to start and stop the init scripts.

If a file named debian/package.init exists, then it is installed into etc/init.d/package in the package build directory, with ``package'' replaced by the package name.

If a file named debian/package.default exists, then it is installed into etc/default/package in the package build directory, with ``package'' replaced by the package name.

Historically this program generates postrm and prerm commands that run the init scripts by hand. In V4 mode, it uses the invoke-rc.d program instead. See debhelper(1) for details about V4 mode. If you decide to use this, you should make your package depend on sysvinit (>= 2.80-1) (this dependency is added to ${misc:Depends} by this program in V4 mode).

OPTIONS

-n, --noscripts: Do not modify postinst/postrm/prerm scripts.
-r, --no-restart-on-upgrade: Do not restart daemon on upgrade.
-d, --remove-d: Remove trailing ``d'' from the name of the package, and use the result for the filename the init script is installed as in etc/init.d/ , and the default file is installed as in etc/default/ . This may be useful for daemons with names ending in ``d''. (Note: this takes precedence over the --init-script parameter described below.)
-uparams --update-rcd-params=params
-- params: Pass ``params'' to update-rc.d(8). If not specified, ``defaults'' will be passed to update-rc.d(8).
--init-script=scriptname: Use ``scriptname'' as for the filename the init script is installed as in etc/init.d/ (and also use it as the filename for the defaults file, if it is installed). This is useful if you need to have an init script with a name different from the package's name. Note that if you use this parameter, dh_installinit will look to see if a file in the debian/ directory exists that looks like ``package.scriptname'' and if so will install it as the init script in preference to the files it normally installs. This feature is really only useful if you need a single package to install more than one init script.

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.

AUTHOR

Joey Hess <joeyh@debian.org>

This document was created by man2html, using the manual pages.
Time: 16:09:43 GMT, May 08, 2025