From b86570f63e533abcbcb97c2572e0e5732a96307b Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 27 Apr 2024 11:40:31 +0200 Subject: Adding upstream version 1.20.13. Signed-off-by: Daniel Baumann --- man/de/dpkg-maintscript-helper.pod | 342 +++++++++++++++++++++++++++++++++++++ 1 file changed, 342 insertions(+) create mode 100644 man/de/dpkg-maintscript-helper.pod (limited to 'man/de/dpkg-maintscript-helper.pod') diff --git a/man/de/dpkg-maintscript-helper.pod b/man/de/dpkg-maintscript-helper.pod new file mode 100644 index 0000000..db4ebbd --- /dev/null +++ b/man/de/dpkg-maintscript-helper.pod @@ -0,0 +1,342 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 BEZEICHNUNG + +dpkg-maintscript-helper - Bekannte Einschränkungen in Dpkg in +Betreuerskripten umgehen + +=head1 ÜBERSICHT + +B I [I …] B<--> +I … + +=head1 BEFEHLE UND PARAMETER + +=over + +=item B I + +=item B I [I [I]] + +=item B I I [I +[I]] + +=item B I I [I +[I]] + +=item B I I [I +[I]] + +=back + +=head1 BESCHREIBUNG + +Dieses Programm wurde so entworfen, dass es in Betreuerskripten ausgeführt +werden kann, um einige Aufgaben zu erledigen, die B (noch) nicht +selbst erledigen kann, entweder aufgrund von Design-Entscheidungen oder +aufgrund aktueller Einschränkungen. + +Viele dieser Aufgaben benötigen koordinierte Aktionen aus mehreren +Betreuerskripten (B, B, B, B). Um Fehler +zu vermeiden, wird der gleiche Aufruf einfach in alle Skripte eingefügt und +das Programm wird sein Verhalten automatisch abhängig von der Variable +B und den Argumenten im Betreuerskript, die Sie nach +einem doppelten Bindestrich übergeben müssen, anpassen. + +=head1 GEMEINSAME PARAMETER + +=over + +=item I + +Definiert die letzte Version des Pakets, dessen Upgrade die Aktion auslösen +soll. Es ist wichtig, I korrekt zu berechnen, so dass +die Aktionen korrekt ausgeführt werden, selbst falls der Benutzer das Paket +mit einer lokalen Version neu gebaut hat. Falls I +leer ist oder weggelassen wurde, wird die Aktion bei jedem Upgrade versucht +(Hinweis: Es ist sicherer, die Version anzugeben und damit die Aktion nur +einmal versuchen zu lassen). + +Falls die Conffile in mehreren Versionen nicht ausgeliefert wurde und Sie +jetzt die Betreuerskripte anpassen, um die überflüssige Datei zu entfernen, +sollte I auf die Version des Pakets gesetzt werden, +die Sie jetzt zusammenstellen, nicht auf die erste Version des Pakets, bei +dem die Conffile fehlte. Dies trifft genauso auch auf alle anderen Aktionen +zu. + +Wird beispielsweise eine Conffile in Version B<2.0-1> eines Pakets entfernt, +sollte I auf B<2.0-1~> gesetzt werden. Dies führt +dazu, dass die Conffile entfernt wird, selbst falls der Benutzer die +vorhergehende Version B<1.0-1> als B<1.0-1local1> neu gebaut hat. Oder ein +Paket, das einen Pfad von einem Symlink (das in Version B<1.0-1> +ausgeliefert wurde) zu einem Verzeichnis (ausgeliefert in Version B<2.0-1>) +wechselt, aber die eigentliche Umstellung in den Betreuerskripten in Version +B<3.0-1> durchführt, sollte I auf B<3.0-1~> setzen. + +=item I + +Der Paketname, dem der Pfadname gehört bzw. die Pfadnamen gehören. Wenn das +Paket „Multi-Arch: same“ ist, muss dieser Parameter die +Architekturspezifikation enthalten, andernfalls sollte er normalerweise die +Architekturspezifikation B enthalten (da dies Cross-Grades verhindern +oder die Umstellung von architekturspezifisch auf die Architektur B +oder umgekehrt verhindern würde). Falls dieser Parameter leer oder nicht +angegeben ist, werden die (von B bei der Ausführung der +Betreuerskripte gesetzten) Umgebungsvariablen B +und B verwandt, um den Architektur-spezifizierten +Paketnamen zu erstellen. + +=item B<--> + +Alle Parameter der Betreuerskripte müssen nach B<--> an das Programm +weitergeleitet werden. + +=back + +=head1 CONFFILE-BEZOGENE AUFGABEN + +Beim Upgrade eines Pakets wird B eine Conffile (eine +Konfigurationsdatei, bei der B die Änderungen des Benutzers erhalten +soll) nicht automatisch entfernen, falls sie nicht in der neueren Version +enthalten ist. Es gibt zwei Hauptgründe dafür; der erste ist, dass die +Conffile versehentlich entfallen sein und die nächste Version sie wieder +herstellen könnte und die Benutzer die Änderung nicht weggeworfen sehen +wollen. Der zweite besteht darin, dass Paketen erlaubt werden soll, von +einer Dpkg-betreuten Conffile auf eine Datei, die von den Betreuerskripten +des Pakets, normalerweise mit einem Werkzeug wie Debconf oder Ucf, verwaltet +wird, umzustellen. + +Das bedeutet, falls ein Paket eine Conffile umbenennen oder entfernen soll, +muss es dies explizit durchführen und B kann dazu +verwandt werden, eine sanfte Löschung und Verschiebung von Conffiles +innerhalb von Betreuerskripten durchzuführen. + +=head2 Eine Conffile entfernen + +Hinweis: In den meisten Fällen kann dies durch den Schalter +C in F (seit Dpkg 1.20.6) ersetzt +werden, siehe L. + +Falls eine Conffile komplett entfernt wird, sollte sie von der Platte +entfernt werden, falls der Benutzer sie nicht verändert hat. Falls es lokale +Anpassungen gibt, sollten diese erhalten werden. Falls das Upgrade des +Pakets abgebrochen wird, sollte die neuerdings veraltete Conffile nicht +verschwinden. + +All dies wird durch Einsetzen der folgenden Shell-Schnipsel in die +Betreuerskripte B, B und B implementiert: + +=over + +Z<> + dpkg-maintscript-helper rm_conffile \ + I I I -- "$@" + +=back + +I ist der Dateiname der zu entfernenden Conffile. + +Aktuelle Implementierung: im B wird geprüft, ob die Conffile +geändert wurde. Dann wird sie entweder in IB<.dpkg-remove> (falls +sie nicht geändert wurde) oder in IB<.dpkg-backup> (falls sie +geändert wurde) umbenannt. Im B wird Letztere in +IB<.dpkg-bak> umbenannt und als Referenz behalten, da sie +Benutzeränderungen enthält, während Erstere entfernt wird. Falls das Upgrade +des Pakets abgebrochen wird, reinstalliert B die ursprüngliche +Conffile. Während des vollständigen Löschens wird B auch die bisher +behaltene Datei B<.dpkg-bak> entfernen. + +=head2 Eine Conffile umbenennen + +Falls eine Conffile von einem Ort zu einem anderen verschoben wird, müssen +Sie sicherstellen, dass Sie auch alle Änderungen des Benutzers mit +übernehmen. Anfänglich erscheint dies als einfache Änderung am Skript +B, allerdings wird dies dazu führen, dass der Benutzer von B +aufgefordert wird, die Bearbeitung der Conffile zu bestätigen, obwohl sie +für diese gar nicht verantwortlich sind. + +Sanfte Umbenennung kann durch Einsetzen der folgenden Shell-Schnipsel in die +Betreuerskripte B, B und B implementiert werden: + +=over + +Z<> + dpkg-maintscript-helper mv_conffile \ + I I I I -- "$@" + +=back + +I und I sind der alte und der neue Name der +umzubenennenden Conffile. + +Aktuelle Implementierung: das B überprüft, ob die Conffile +verändert wurde, falls ja, verbleibt sie am Platz, andernfalls wird sie in +IB<.dpkg-remove> umbenannt. Bei der Konfiguration entfernt +das B IB<.dpkg-remove> und benennt I +in I um, falls I noch existiert. Falls +abort-upgrade/abort-install eintritt, benennt das B wieder +IB<.dpkg-remove> in I zurück, falls notwendig. + +=head1 SYMLINK- UND VERZEICHNISUMWANDLUNGEN + +Beim Upgrade eines Pakets wird B einen Symlink nicht automatisch in +ein Verzeichnis und umgekehrt umwandeln. Installationen älterer Versionen +(„downgrades“) werden nicht unterstützt und der Pfad verbleibt wie er ist. + +=head2 Einen Symlink in ein Verzeichnis umwandeln + +Falls ein Symlink in ein echtes Verzeichnis umgewandelt wird, müssen Sie vor +dem Entpacken sicherstellen, dass der Symlink entfernt wird. Anfänglich +erscheint dies als einfache Änderung am Skript B, allerdings wird +dies zu einigen Problemen führen, falls der Administrator lokale Anpassungen +des Symlinks durchgeführt hat oder falls ein Downgrade des Pakets auf eine +alte Version durchgeführt wird. + +Sanfte Umbenennung kann durch Einsetzen der folgenden Shell-Schnipsel in die +Betreuerskripte B, B und B implementiert werden: + +=over + +Z<> + dpkg-maintscript-helper symlink_to_dir \ + I I I I -- "$@" + +=back + +I ist der absolute Name des alten Symlinks (der Pfad wird am Ende +der Installation ein Verzeichnis sein) und I ist der Name des +Ziels des vorherigen Symlinks unter I. Es kann entweder absolut +oder relativ zum Verzeichnis, das I enthält, sein. + +Aktuelle Implementierung: das B überprüft, ob der Symlink existiert +und auf I zeigt. Falls dies nicht der Fall ist, bleibt der +Symlink existent, andernfalls wird er in IB<.dpkg-backup> +umbenannt. Bei der Konfiguration entfernt das B +IB<.dpkg-backup>, falls IB<.dpkg-backup> noch ein +Symlink ist. Falls abort-upgrade/abort-install eintritt, benennt das +B wieder IB<.dpkg-backup> in I zurück, falls +notwendig. + +=head2 Ein Verzeichnis in einen Symlink umwandeln + +Falls ein echtes Verzeichnis in einen Symlink umgewandelt wird, müssen Sie +vor dem Entpacken sicherstellen, dass das Verzeichnis entfernt +wird. Anfänglich erscheint dies als einfache Änderung am Skript B, +allerdings wird dies zu einigen Problemen führen, falls das Verzeichnis +Conffiles, Pfadnamen anderer Pakete oder lokal erstellte Pfadnamen enthält +oder wenn ein Downgrade des Pakets durchgeführt wird. + +Sanfte Umwandlung kann durch Einsetzen der folgenden Shell-Schnipsel in die +Betreuerskripte B, B und B implementiert werden: + +=over + +Z<> + dpkg-maintscript-helper dir_to_symlink \ + I I I I -- "$@" + +=back + +I ist der absolute Name des alten Verzeichnisses (der Pfad wird am +Ende der Installation ein Symlink sein) und I ist das Ziel des +neuen Symlinks unter I. Es kann entweder absolut oder relativ zum +Verzeichnis, das I enthält, sein. + +Aktuelle Implementierung: das B überprüft, ob das Verzeichnis +existiert, keine Conffiles, Pfadnamen anderer Pakete oder lokal erstellte +Pfadnamen enthält. Falls nicht, bleibt es an Ort und Stelle, andernfalls +wird es in IB<.dpkg-backup> umbenannt und ein leeres +Vorbereitungsverzeichnis mit Namen I erstellt und durch eine Datei +markiert, so dass Dpkg es nachverfolgen kann. Bei der Konfiguration beendet +B die Umstellung, falls I.B<.dpkg-backup> noch ein +Verzeichnis und I noch das Vorbereitungsverzeichnis ist. Es +entfernt die Markierungsdatei im Vorbereitungsverzeichnis, verschiebt die +neu erstellten Dateien im Vorbereitungsverzeichnis in das Symlink-Ziel +I/, ersetzt das jetzt leere Vorbereitungsverzeichnis I +durch einen Symlink auf I und entfernt +I.B<.dpkg-backup>. Falls abort-upgrade/abort-install eintritt, +benennt das B wieder IB<.dpkg-backup> in I +zurück, falls notwendig. + +=head1 INTEGRATION IN PAKETE + +Bei der Benutzung der Paketierungshelfer prüfen Sie bitte, ob eine native +B-Integration existiert. Hierdurch könnte Ihr +Aufwand verringert werden. Lesen Sie beispielsweise B(1). + +Da B im B verwandt wird, benötigt der +bedingungslose Einsatz eine prä-Abhängigkeit (I), um +sicherzustellen, dass die Mindestversion von B bereits entpackt +wurde. Die benötigte Version hängt vom verwandten Befehl ab, für +B und B lautet sie 1.15.7.2, für B +und B lautet sie 1.17.14: + +=over + + Pre-Depends: dpkg (>= 1.17.14) + +=back + +In vielen Fällen sind aber die Ausführungen des Programms für das Paket +nicht kritisch und statt einer prä-Abhängigkeit soll das Programm nur +aufgerufen werden, falls bekannt ist, dass der benötigte Befehl vom derzeit +installierten B unterstützt wird: + +=over + +Z<> + if dpkg-maintscript-helper supports I; then + dpkg-maintscript-helper I … + fi + +=back + +Der Befehl B liefert im Erfolgsfall 0, ansonsten 1 zurück. Der +Befehl B überprüft, ob die durch Dpkg gesetzten und vom Skript +benötigten Umgebungsvariablen vorhanden sind und betrachtet es als +Fehlschlag, falls die Umgebung nicht ausreichend ist. + +=head1 UMGEBUNG + +=over + +=item B + +Falls gesetzt wird dies als Dateisystemwurzelverzeichnis verwandt. + +=item B + +Falls gesetzt wird dies als Datenverzeichnis von B verwandt. + +=item B + +Setzt den Farbmodus (seit Dpkg 1.19.1). Die derzeit unterstützten Werte +sind: B (Vorgabe), B und B. + +=back + +=head1 SIEHE AUCH + +B(1). + + +=head1 ÜBERSETZUNG + +Die deutsche Übersetzung wurde 2004, 2006-2020 von Helge Kreutzmann +, 2007 von Florian Rehnisch und +2008 von Sven Joachim +angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die +GNU General Public License Version 2 oder neuer für die Kopierbedingungen. +Es gibt KEINE HAFTUNG. -- cgit v1.2.3