.\" -*- coding: UTF-8 -*- '\" t .\" Title: alpm-hooks .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2024-02-06 .\" Manual: Pacman Manual .\" Source: Pacman 6.0.2 .\" Language: English .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ALPM\-HOOKS 5 "6. Februar 2024" "Pacman 6\&.0\&.2" Pacman\-Handbuch .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH BEZEICHNUNG alpm\-hooks \- Hook\-Dateiformat für alpm .SH ÜBERSICHT .sp .nf [Trigger] (erforderlich, wiederholbar) Operation = Install|Upgrade|Remove (erforderlich, wiederholbar) Type = Path|Package (erforderlich) Target = (erforderlich, wiederholbar) [Action] (erforderlich) Description = … (optional) When = PreTransaction|PostTransaction (erforderlich) Exec = (erforderlich) Depends = (optional) AbortOnFail (optional, nur vor der Transaktion) NeedsTargets (optional) .fi .SH BESCHREIBUNG .sp libalpm bietet die Möglichkeit, Hooks anzugeben, die vor oder nach Transaktionen ausgeführt werden, basierend auf den während der Transaktion geänderten Paketen und/oder Dateien\&. Hooks bestehen aus einem einzelnen \fI[Action]\fP\-Abschnitt, der die auszuführende Aktion beschreibt und einem oder mehreren \fI[Trigger]\fP\-Abschnitten, die angeben, auf welche Transaktionen sie angewendet werden sollen\&. .sp Hooks werden aus den Dateien im systemweiten Hook\-Verzeichnis /usr/share/libalpm/hooks sowie zusätzlichen, in \fBpacman.conf\fP(5) angegebenen Verzeichnissen gelesen (Vorgabe ist /etc/pacman\&.d/hooks)\&. Die Dateinamen müssen zwingend die Endung »\&.hook« haben\&. Hooks werden in alphabetischer Reihenfolge ausgeführt, wobei die Endung ignoriert wird\&. .SH TRIGGER .sp Hooks müssen mindestens einen \fI[Trigger]\fP\-Abschnitt enthalten, in welchem festgelegt wird, welche Transaktionen die Ausführung des Hooks auslösen\&. Sind mehrere Trigger\-Abschnitte vorhanden, wird die Hook ausgeführt, wenn ein \fBbeliebiger\fP Trigger auf die Transaktion zutrifft\&. .PP \fBOperation =\fP Install|Upgrade|Remove .RS 4 wählt den Typ der Operation, dem das Ziel entsprechen muss\&. Dies kann mehrmals angegeben werden\&. Installationen werden als Aktualisierung betrachtet, wenn das Paket oder die Datei bereits im System vorhanden ist, unabhängig davon, ob das neue Paket gemäß dessen Version tatsächlich neuer als das aktuell installierte Paket ist\&. Für Pfad\-Trigger gilt dies sogar dann, wenn die Zugehörigkeit der Datei von einem Paket zu einem anderen gewechselt hat\&. Diese Angabe ist zwingend erforderlich\&. .RE .PP \fBType =\fP Path|Package .RS 4 wählt aus, ob die Transaktion Paketen oder Dateien entsprechen muss\&. Im Abschnitt WARNUNGEN finden Sie spezielle Anmerkungen zu Datei\-Triggern\&. \fIFile\fP ist ein veralteter Alias für \fIPath\fP und wird in einer zukünftigen Veröffentlichung entfernt\&. Diese Angabe ist zwingend erforderlich\&. .RE .PP \fBTarget =\fP .RS 4 gibt den Dateipfad oder Paketnamen an, denen die aktive Transaktion entsprechen muss\&. Die Pfade beziehen sich auf die Dateien im Paketarchiv; die Installationswurzel sollte \fBnicht\fP im Pfad enthalten sein\&. Glob\-Muster im Shell\-Stil sind zulässig\&. Sie können die Trefferanzeige umkehren, indem Sie einer Datei ein Ausrufezeichen voranstellen\&. Kann mehrmals angegeben werden\&. Diese Angabe ist zwingend erforderlich\&. .RE .SH AKTIONEN .PP \fBDescription =\fP \&… .RS 4 gibt eine optionale Beschreibung der vom Hook auszuführenden Aktion an, die dann in der Benutzeroberfläche verwendet wird\&. .RE .PP \fBExec =\fP .RS 4 gibt den auszuführenden Befehl an\&. Befehlszeilenargumente werden durch Leerzeichen getrennt\&. Werte, die Leerzeichen enthalten, sollten in Anführungszeichen gesetzt werden\&. Diese Angabe ist zwingend erforderlich\&. .RE .PP \fBWhen =\fP PreTransaction|PostTransaction .RS 4 legt fest, wann der Hook ausgeführt werden soll\&. Diese Angabe ist zwingend erforderlich\&. .RE .PP \fBDepends =\fP .RS 4 gibt Pakete an, die installiert sein müssen, um den Hook auszuführen\&. Dies kann mehrfach angegeben werden\&. .RE .PP \fBAbortOnFail\fP .RS 4 führt dazu, dass die Transaktion abgebrochen wird, wenn der Hook einen von Null verschiedenen Exit\-Code zurückliefert\&. Dies ist nur auf Hooks anwendbar, die vor der Installation ausgeführt werden\&. .RE .PP \fBNeedsTargets\fP .RS 4 bewirkt, dass die Liste der passenden Trigger\-Ziele an den laufenden Hook in die Standardeingabe \fIstdin\fP übergeben wird\&. .RE .SH "HOOKS AUẞER KRAFT SETZEN" .sp Hooks können außer Kraft gesetzt werden, indem Sie eine Datei gleichen Namens in einem Hook\-Verzeichnis höherer Priorität platzieren\&. Sie können Hooks durch einen Symlink deaktivieren, der auf \fI/dev/null\fP verweist\&. .SH BEISPIELE .sp .if n \{\ .RS 4 .\} .nf # Synchronisation von Festplatten erzwingen, um die Gefahr des Datenverlusts zu verringern [Trigger] Operation = Install Operation = Upgrade Operation = Remove Type = Package Target = * [Action] Depends = coreutils When = PostTransaction Exec = /usr/bin/sync .fi .if n \{\ .RE .\} .SH WARNUNGEN .sp Es gibt Situationen, in denen Datei\-Trigger auf unerwartete Weise agieren\&. Hooks werden unter Anwendung der Dateiliste der installierten, aktualisierten oder entfernten Pakete getriggert\&. Wenn Sie eine Datei installieren oder aktualisieren, die mit einer \fI\&.pacnew\fP\-Endung entpackt wird, dann wird der ursprüngliche Dateiname zum Triggern der Hook verwendet\&. Beim Entfernen eines Pakets können alle im Eigentum eines Pakets befindlichen Dateien eine Hook triggern, ganz gleich, ob sie vor dem Entfernen des Pakets im System vorhanden waren\&. .sp Nach der Transaktion auszuführende Hooks werden \fBnicht\fP angewendet, wenn die Transaktion aus irgendeinem Grund nicht abgeschlossen werden kann\&. .sp Auf der .UR https://archlinux\&.org/pacman/ Pacman\-Website .UE finden Sie aktuelle Informationen zu Pacman und den zugehörigen Werkzeugen\&. .SH FEHLER .sp Fehler? Sie machen wohl Witze, es gibt keine Fehler in dieser Software\&. Nun ja, sollte unsere Annahme doch falsch sein, senden Sie uns einen Fehlerbericht (auf Englisch) mit so vielen Details wie möglich in der .UR https://bugs.archlinux.org/ Fehlerdatenbank von Archlinux .UE im Bereich »Pacman«\&. .SH AUTOREN .sp Derzeitige Betreuer: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT allan@archlinux\&.org Allan McRae .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT andrew\&.gregory\&.8@gmail\&.com Andrew Gregory .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT eschwartz@archlinux\&.org Eli Schwartz .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT morganamilo@archlinux\&.org Morgan Adamiec .ME .RE .sp Bedeutende frühere Mitwirkende: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT jvinet@zeroflux\&.org Judd Vinet .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT aurelien@archlinux\&.org Aurelien Foret .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT aaron@archlinux\&.org Aaron Griffin .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT dan@archlinux\&.org Dan McGee .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT shiningxc@gmail\&.com Xavier Chantry .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT ngaba@bibl\&.u\-szeged\&.hu Nagy Gábor .ME .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03' .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} .MT dreisner@archlinux\&.org Dave Reisner .ME .RE .sp Informationen zu weiteren Mitwirkenden erhalten Sie, wenn Sie den Befehl \fBgit shortlog \-s\fP im Git\-Repositorium pacman\&.git aufrufen\&. .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .