X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installinit;h=9c8c1550997ffac3c41c87ba22aa224a8b536b2b;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hp=f870e99d60fb2b17d016eab53cf382133463b404;hpb=79b3d37f35b41351f5f0c3e458a8c33460452c12;p=debhelper.git diff --git a/dh_installinit b/dh_installinit index f870e99..9c8c155 100755 --- a/dh_installinit +++ b/dh_installinit @@ -2,7 +2,7 @@ =head1 NAME -dh_installinit - install upstart jobs or init scripts into package build directories +dh_installinit - install init scripts and/or upstart jobs into package build directories =cut @@ -11,30 +11,38 @@ use Debian::Debhelper::Dh_Lib; =head1 SYNOPSIS -B [S>] [B<--name=>I] [B<-n>] [B<-R>] [B<-r>] [B<-d>] [B<-O>] [S I>] +B [S>] [B<--name=>I] [B<-n>] [B<-R>] [B<-r>] [B<-d>] [S I>] =head1 DESCRIPTION -dh_installinit is a debhelper program that is responsible for installing -upstart job files or init scripts with associated defaults files into package -build directories, and in the former case providing compatibility handling -for non-upstart systems. +B is a debhelper program that is responsible for installing +init scripts with associated defaults files, as well as upstart job 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. +It also automatically generates the F and F and F +commands needed to set up the symlinks in F to start and stop +the init scripts. -If a file named debian/package.upstart exists, then it is installed into -etc/init/package.conf in the package build directory, with "package" replaced -by the package name. +=head1 FILES -Otherwise, 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. +=over 4 + +=item debian/I.init + +If this exists, it is installed into etc/init.d/I in the package +build directory. + +=item debian/I.default + +If this exists, it is installed into etc/default/I in the package +build directory. -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. +=item debian/I.upstart + +If this exists, it is installed into etc/init/I.conf in the package +build directory. + +=back =head1 OPTIONS @@ -42,25 +50,20 @@ by the package name. =item B<-n>, B<--noscripts> -Do not modify postinst/postrm/prerm scripts. +Do not modify F/F/F scripts. =item B<-o>, B<--onlyscripts> -Only modify postinst/postrm/prerm scripts, do not actually install any init -script, default files, or upstart job. May be useful if the init script or +Only modify F/F/F scripts, do not actually install any init +script, default files, or upstart job. May be useful if the init script or upstart job is shipped and/or installed by upstream in a way that doesn't -make it easy to let dh_installinit find it. - -If no upstart job file is installed in the target directory when -dh_installinit --onlyscripts is called, this program will assume that an -init script is being installed and not provide the compatibility symlinks -or upstart dependencies. +make it easy to let B find it. =item B<-R>, B<--restart-after-upgrade> Do not stop the init script until after the package upgrade has been completed. This is different than the default behavior, which stops the -script in the prerm, and starts it again in the postinst. +script in the F, and starts it again in the F. This can be useful for daemons that should not have a possibly long downtime during upgrade. But you should make sure that the daemon will not @@ -74,50 +77,51 @@ Do not stop init script on upgrade. =item B<--no-start> Do not start the init script on install or upgrade, or stop it on removal. -Only call update-rc.d. Useful for rcS scripts. +Only call B. Useful for rcS scripts. =item B<-d>, B<--remove-d> -Remove trailing "d" from the name of the package, and use the result for the -filename the upstart job file is installed as in etc/init/ , or for the +Remove trailing B from the name of the package, and use the result for the +filename the upstart job file is installed as in F , and 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 +is installed as in F . This may be useful for daemons with names +ending in B. (Note: this takes precedence over the B<--init-script> parameter described below.) =item B<-u>I B<--update-rcd-params=>I =item B<--> I -Pass "params" to L. If not specified, "defaults" will be +Pass I to L. If not specified, B will be passed to L. =item B<--name=>I -Install the upstart job file or the init script (and default file) using the -filename I instead of the default filename, which is the package name. -When this parameter is used, dh_installinit looks for and installs files -named debian/package.name.upstart, debian/package.name.init and -debian/package.name.default, instead of the usual debian/package.upstart, -debian/package.init and debian/package.default. +Install the init script (and default file) as well as upstart job file +using the filename I instead of the default filename, which is +the package name. When this parameter is used, B looks +for and installs files named F, +F and F +instead of the usual F, F and +F. =item B<--init-script=>I -Use "scriptname" as 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). 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 +Use I as the filename the init script is installed as in +F (and also use it as the filename for the defaults file, if it +is installed). If you use this parameter, B will look to see +if a file in the F directory exists that looks like +F and if so will install it as the init script in preference to the files it normally installs. -This parameter is deprecated, use the --name parameter instead. This -parameter will be ignored completely for upstart jobs. +This parameter is deprecated, use the B<--name> parameter instead. This +parameter is incompatible with the use of upstart jobs. =item B<--error-handler=>I -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. +Call the named shell I if running the init script fails. The +function should be provided in the F and F scripts, before the +B<#DEBHELPER#> token. =back @@ -166,34 +170,18 @@ foreach my $package (@{$dh{DOPACKAGES}}) { else { $script=$package; } - + my $job=pkgfile($package,"upstart"); - my ($init,$default) = ('',''); - if ($job ne '' || ($dh{ONLYSCRIPTS} && -e "$tmp/etc/init/$jobfile.conf")) { - if (! $dh{ONLYSCRIPTS}) { - if (! -d "$tmp/etc/init") { - doit("install","-d","$tmp/etc/init"); - } - - doit("install","-p","-m644",$job,"$tmp/etc/init/$jobfile.conf"); + if ($job ne '' && ! $dh{ONLYSCRIPTS}) { + if (! -d "$tmp/etc/init") { + doit("install","-d","$tmp/etc/init"); } - # ensures that our /etc/init.d/ symlink points to a valid - # implementation - addsubstvar($package, "misc:Depends", "upstart-job"); - - if (! -d "$tmp/etc/init.d") { - doit("install","-d","$tmp/etc/init.d"); - } - doit("ln","-sf","/lib/init/upstart-job","$tmp/etc/init.d/$jobfile"); - } - else { - $init=pkgfile($package,$script) || pkgfile($package,"init") || - pkgfile($package,"init.d"); - $default=pkgfile($package,'default'); + doit("install","-p","-m644",$job,"$tmp/etc/init/$jobfile.conf"); } + my $default=pkgfile($package,'default'); if ($default ne '' && ! $dh{ONLYSCRIPTS}) { if (! -d "$tmp/etc/default") { doit("install","-d","$tmp/etc/default"); @@ -201,6 +189,8 @@ foreach my $package (@{$dh{DOPACKAGES}}) { doit("install","-p","-m644",$default,"$tmp/etc/default/$script"); } + my $init=pkgfile($package,$script) || pkgfile($package,"init") || + pkgfile($package,"init.d"); if ($init ne '' && ! $dh{ONLYSCRIPTS}) { if (! -d "$tmp/etc/init.d") { doit("install","-d","$tmp/etc/init.d"); @@ -209,12 +199,11 @@ foreach my $package (@{$dh{DOPACKAGES}}) { doit("install","-p","-m755",$init,"$tmp/etc/init.d/$script"); } - if ($job ne '' || $init ne '' || $dh{ONLYSCRIPTS}) - { - if (-e "$tmp/etc/init/$jobfile.conf") { - $script=$jobfile; - } + if ($dh{INIT_SCRIPT} && $job ne '' && $init ne '') { + error("Can't use --init-script with an upstart job"); + } + if ($job ne '' || $init ne '' || $dh{ONLYSCRIPTS}) { # This is set by the -u "foo" command line switch, it's # the parameters to pass to update-rc.d. If not set, # we have to say "defaults".