.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" 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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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 2024-03-27 13.15.3 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 ist ein Debhelper-Programm, das für die Installation von Init-Skripten mit den zugehörigen Standarddateien verantwortlich ist. In Kompatibilitätsstufen bis einschließlich 10 wird \fBdh_installinit\fR auch einige Systemd-bezogenen Dateien installieren, die von Debian-Paketen bereitgestellt werden (siehe den nachfolgenden Abschnitt "DATEIEN"). In Kompatibilitätsstufen bis einschließlich 11 wird \fBdh_installinit\fR auch die in der Debian-Paketierung bereitgestellten Upstart-Jobs handhaben (weitere Informationen darüber finden Sie auch unter "DATEIEN"). .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 von Lintian Warnungen vor »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 vorhanden, wird es in etc/init.d/\fIPaket\fR im Paketbauverzeichnis installiert. .IP debian/\fIPaket\fR.default 4 .IX Item "debian/Paket.default" Falls vorhanden, 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" If this exists, it is installed into \fIusr/lib/systemd/system/package.service\fR in the package build directory. Only used in compat levels 10 and below. .IP debian/\fIPaket\fR.tmpfile 4 .IX Item "debian/Paket.tmpfile" Falls vorhanden, wird es in lib/systemd/system/\fIPaket\fR.conf im Paketbauverzeichnis installiert. Wird nur in Kompatibilitätsstufen 10 und darunter benutzt. .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 und installiert 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 erschwert, sie zu finden. .Sp \&\fBWarnung\fR: Dies wird alle normalen Prüfungen umgehen und die Skripte \fIbedingungslos\fR verändern. Sie werden es mit Sicherheit 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 während des Upgrades nicht allzu lange ausfallen sollen. Sie sollten aber, bevor Sie diese Option verwenden, sicherstellen, dass der Daemon damit zurechtkommt, dass im laufenden Betrieb sein Paket ausgetauscht 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" lässt das Init-Skript beim Upgrade weiterlaufen. 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, um Verwirrung mit der Option \fB\-\-no\-restart\-after\-upgrade\fR zu vermeiden. Die Variante \fB\-\-no\-stop\-on\-upgrade\fR wurde in Debhelper 10.2 (enthalten in Debian Stretch) eingeführt. .IP \fB\-\-no\-start\fR 4 .IX Item "--no-start" startet das Init-Skript bei der Installation oder dem Upgrade nicht 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" deaktiviert das Startskript beim vollständigen Entfernen, aktiviert es aber nicht bei der Installation. Dies impliziert eine versionierte Abhängigkeit von \fBinit-system-helpers (>= 1.51)\fR, da dies die erste (funktionsfähige) Version ist, die \fBupdate\-rc.d