.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DH_INSTALLINIT 1" .TH DH_INSTALLINIT 1 "2019-09-14" "12.6" "Debhelper" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" dh_installinit \- installiert Dienstinitialisierungsdateien in Paketbauverzeichnisse .SH "ÜBERSICHT" .IX Header "ÜBERSICHT" \&\fBdh_installinit\fR [\fIDebhelper-Optionen\fR] [\fB\-\-name=\fR\fIName\fR] [\fB\-n\fR] [\fB\-R\fR] [\fB\-r\fR] [\fB\-d\fR] [\fB\-\-\fR \fIParameter\fR] .SH "BESCHREIBUNG" .IX Header "BESCHREIBUNG" \&\fBdh_installinit\fR is a debhelper program that is responsible for installing init scripts with associated defaults files. In compatibility levels up to and including 10, \fBdh_installinit\fR will also install some systemd related files provided by the debian packaging (see the \*(L"\s-1FILES\*(R"\s0 section below). In compatibility levels up to and including 11, \fBdh_installinit\fR will also handle upstart jobs provided in the debian packaging (see the \*(L"\s-1FILES\*(R"\s0 for more information on this as well). .PP Es erzeugt außerdem automatisch die \fIpostinst\fR\-, \fIpostrm\fR\- und \&\fIprerm\fR\-Skripte, die nötig sind, um die symbolischen Links in \&\fI/etc/rc*.d/\fR einzurichten und die Init-Skripte zu starten und zu stoppen. .PP In Kompatibilitätsstufe 10 oder älter: Falls ein Paket nur eine Systemd-Dienstdatei mitbringt und kein Sysvinit-Skript bereitgestellt wird, möchten Sie möglicherweise den Aufruf von »dh_installinit« für dieses Paket ausschließen (z.B. per \fB\-N\fR). Andernfalls könnten Sie Warnungen von Lintian über »init.d«\-Skripte bekommen, die nicht im Paket enthalten sind. .SH "DATEIEN" .IX Header "DATEIEN" .IP "debian/\fIPaket\fR.init" 4 .IX Item "debian/Paket.init" Falls dies existiert, wird es in etc/init.d/\fIPaket\fR im Paketbauverzeichnis installiert. .IP "debian/\fIPaket\fR.default" 4 .IX Item "debian/Paket.default" Falls dies existiert, wird es in etc/default/\fIPaket\fR im Paketbauverzeichnis installiert. .IP "debian/\fIPaket\fR.upstart" 4 .IX Item "debian/Paket.upstart" In Kompatibilitätsstufe 11 wird diese Datei einen Fehler auslösen, der daran erinnert, dass das ordentliche Entfernen der Upstart-Datei in der vorherigen Paketversion sichergestellt werden soll. Bitte ziehen Sie die Verwendung der Funktionalität »rm_conffile« von \fBdh_installdeb\fR\|(1) in Betracht, um das ordentliche Entfernen früherer Upstart-Dateien sicherzustellen. .Sp Falls diese Datei in Kompatibilitätsstufe 10 existiert, wird sie in etc/init/\fIPaket\fR.conf im Paketbauverzeichnis installiert. .IP "debian/\fIPaket\fR.service" 4 .IX Item "debian/Paket.service" Falls dies existiert, wird es in lib/systemd/system/\fIPaket\fR.service im Paketbauverzeichnis installiert. Nur in Kompatibilitätsstufen 10 und darunter benutzt. .IP "debian/\fIPaket\fR.tmpfile" 4 .IX Item "debian/Paket.tmpfile" Falls dies existiert, wird es in usr/lib/tmpfiles.d/\fIPaket\fR.conf im Paketbauverzeichnis installiert. (Der »tmpfiles.d«\-Mechanismus wird derzeit nur von Systemd benutzt.) Nur in Kompatibilitätsstufe 10 und darunter. .SH "OPTIONEN" .IX Header "OPTIONEN" .IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4 .IX Item "-n, --no-scripts" ändert keine \fIpostinst\fR\-/\fIpostrm\fR/\fIprerm\fR\-Skripte. .IP "\fB\-o\fR, \fB\-\-only\-scripts\fR" 4 .IX Item "-o, --only-scripts" verändert nur die \fIpostinst\fR\-/\fIpostrm\fR\-/\fIprerm\fR\-Skripte, installiert aber tatsächlich kein Init-Skript, keine Vorgabedateien, keinen Upstart-Job und keine Systemd-Dienstdatei; kann nützlich sein, falls die Datei von den Originalautoren auf eine Art mitgeliefert/installiert wird, die es \&\fBdh_installinit\fR nicht leicht macht, sie zu finden. .Sp \&\fBWarnung\fR: Dies wird alle normalen Prüfungen umgehen und die Skripte \&\fIbedingungslos\fR verändern. Sie werden dies in den meisten Fällen mit \fB\-p\fR verwenden wollen, um einzugrenzen, welche Pakete von dem Aufruf betroffen sind. Beispiel: .Sp .Vb 3 \& override_dh_installinit: \& dh_installinit \-pfoo \-\-only\-scripts \& dh_installinit \-\-remaining .Ve .IP "\fB\-R\fR, \fB\-\-restart\-after\-upgrade\fR" 4 .IX Item "-R, --restart-after-upgrade" stoppt das Init-Skript nicht, bis das Paket-Upgrade komplett durchgeführt wurde. Dies ist das Standardverhalten für Kompatibilitätsmodus 10. .Sp In älteren Kompatibilitätsmodi war es Standardverhalten, dass das Skript in \&\fIprerm\fR stoppt und es in \fIpostinst\fR wieder startet. .Sp Dies kann nützlich für Daemons sein, die nicht lange während des Upgrades ausgeschaltet sein sollen. Sie sollten aber sicherstellen, dass der Daemon nicht von dem Paket, von dem ein Upgrade durchgeführt wird, durcheinander gebracht wird, während er läuft, bevor diese Option benutzt wird.Dies kann nützlich für Daemons sein, die während des Upgrades nicht für längere Zeit ausgeschaltet sein sollen. Bevor diese Option benutzt wird, sollten Sie sicherstellen, dass der Betrieb des Daemon nicht negativ beeinflusst wird, wenn dessen Paket zwischendurch aktualisiert wird. .IP "\fB\-\-no\-restart\-after\-upgrade\fR" 4 .IX Item "--no-restart-after-upgrade" macht ein vorhergehendes \fB\-\-restart\-after\-upgrade\fR (oder die Voreinstellung des Kompatibilitätsmodus 10) rückgängig. Falls keine weiteren Optionen angegeben wurden, wird dies dafür sorgen, dass der Dienst im \fIprerm\fR\-Skript gestoppt und im \fIpostinst\fR\-Skript wieder gestartet wird. .IP "\fB\-r\fR, \fB\-\-no\-stop\-on\-upgrade\fR, \fB\-\-no\-restart\-on\-upgrade\fR" 4 .IX Item "-r, --no-stop-on-upgrade, --no-restart-on-upgrade" stoppt das Init-Skript nicht beim Upgrade. Dies hat den Nebeneffekt, dass der Dienst nicht als Teil des Upgrades neu gestartet wird. .Sp Falls Sie den Dienst mit minimaler Stillstandzeit neu starten möchten, benutzen Sie bitte \fB\-\-restart\-after\-upgrade\fR (Voreinstellung in Kompatibilitätsstufe 10 oder höher). Falls Sie wollen, dass der Dienst neu gestartet, jedoch während des Upgrades gestoppt wird, benutzen Sie bitte \&\fB\-\-no\-restart\-after\-upgrade\fR (beachten Sie das »after\-upgrade«). .Sp Beachten Sie, dass der Alias \fB\-\-no\-restart\-on\-upgrade\fR missbilligt ist und in Kompatibilitätsstufe 12 entfernt wird. Dies soll Verwirrung mit der Option \fB\-\-no\-restart\-after\-upgrade\fR vermeiden. Die Variante \&\fB\-\-no\-stop\-on\-upgrade\fR wurde in Debhelper 10.2 eingeführt (enthalten in Debian Stretch). .IP "\fB\-\-no\-start\fR" 4 .IX Item "--no-start" startet das Init-Skript nicht bei der Installation oder dem Upgrade und stoppt es nicht beim Entfernen. Rufen Sie nur \fBupdate\-rc.d\fR auf. Nützlich für rcS-Skripte. .IP "\fB\-\-no\-enable\fR" 4 .IX Item "--no-enable" Disable the init script on purge, but do not enable them on install. This implies a versioned dependency on \fBinit-system-helpers (>= 1.51)\fR as it is the first (functional) version that supports \fBupdate\-rc.d