NAME    [Toc]    [Back]

       dh_installinit - install init scripts into package build directories

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       -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    [Toc]    [Back]

       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    [Toc]    [Back]

       debhelper(1)

       This program is a part of debhelper.

AUTHOR    [Toc]    [Back]

       Joey Hess <joeyh@debian.org>



3rd Berkeley Distribution	  2002-01-27		     DH_INSTALLINIT(1)