ALPM-HOOKS(5) Manuel de Pacman ALPM-HOOKS(5) NOM alpm-hooks - format du fichier d'amorcage du gestionnaire de paquetages d'Arch Linux SYNOPSIS [Trigger] (obligatoire, repetable) Operation = Install|Upgrade|Remove (obligatoire, repetable) Type = Path|Package (obligatoire) Target = (obligatoire, repetable) [Action] (obligatoire) Description = ... (optionnel) When = PreTransaction|PostTransaction (obligatoire) Exec = (obligatoire) Depends = (optionnel) AbortOnFail (optionnel, PreTransaction uniquement) NeedsTargets (optionnel) DESCRIPTION libalpm, la bibliotheque d'Arch Linux, permet de specifier des actions d'amorcage a lancer avant ou apres les transactions de paquetage en fonction des paquetages ou des fichiers qui ont ete modifies. Les fichiers d'amorce ne comportent qu'une seule section [Action] qui decrit l'action a executer, et une ou plusieurs conditions [Trigger] decrivant pour quelles transactions il faut la declencher. Les conditions d'amorcage sont lues sur des fichiers situes dans le repertoire racine /usr/share/libalpm/hooks, ainsi que d'autres repertoires choisis definis dans le fichier de configuration pacman.conf(5) (le repertoire par defaut est /etc/pacman.d/hooks). Les noms de fichier doivent porter l'extension ".hook". Les actions d'amorcage sont lancees dans l'ordre lexicographique des noms des fichiers qui les decrivent, le suffixe n'entrant pas en ligne de compte pour ce tri. DECLENCHEURS Les fichiers d'amorcage doivent comporter au moins une section [Trigger] (declencheur) qui determine pour quelles transactions il faut la declencher. Si plusieurs conditions [Trigger] sont indiquees, l'amorcage sera lance des que l'une des conditions sera remplie. Operation = Install|Upgrade|Remove Determine le type d'operation vise par l'amorcage. Peut etre specifie plusieurs fois. Une installation est consideree comme une mise a jour (Upgrade) si le paquetage ou fichier est deja present sur le systeme, independamment du numero de version du nouveau paquetage par rapport a celui de la version installee. Cela vaut egalement pour les conditions [Trigger] de type Path, si le fichier change de proprietaire entre les deux paquetages. Cette directive Operation est obligatoire. Type = Path|Package Indique si les transactions cibles sont des transactions de fichier ou des transactions de paquetages. Voir PRECAUTIONS pour le cas particulier des declencheurs de type Path. On rencontre encore parfois dans certaines installations le type vieilli File a la place de Path : il devrait disparaitre progressivement. Target = Indique le nom du chemin ou paquetage vise par l'amorcage. Les chemins sont ceux des fichiers dans le fichier tar du paquetage ; il ne faut pas y inclure le repertoire-racine de l'installation. Il est possible d'utiliser des metacaracteres, et d'exclure des fichiers ou des groupes de fichiers en faisant preceder leur nom d'un point d'exclamation. Obligatoire, peut etre utilise plusieurs fois par commande. ACTIONS Description = ... Champ descriptif optionnel qui decrit l'action executee par le declencheur, utilisable pour l'interface utilisateur. Exec = Commande a executer. Les arguments de la commande sont separes par des espaces. Compte tenu de cette convention, les valeurs contenant elles-memes des espaces devraient etre protegee par des guillemets. Obligatoire. When = PreTransaction|PostTransaction Caracterise l'amorce comme anterieure ou posterieure a la transaction. Obligatoire. Depends = Paquetage a installer pour que l'amorcage fonctionne correctement.Peut etre utilise plusieurs fois, pour designer plusieurs paquetages. AbortOnFail Aura pour effet d'interrompre la transaction si l'amorcage renvoie un code d'execution non-nul. Ne s'applique qu'aux amorcages de PreTransaction. NeedsTargets Passe la liste des cibles d'amorcages detectees a l'entree standard stdin du shell d'amorcage. POUR COURT-CIRCUITER LES AMORCAGES Il est possible de court-circuiter chaque amorcage en creant simplement un fichier vide de meme nom dans un repertoire d'amorcage de plus haute priorite. On peut aussi faire pointer le fichier d'amorce vers /dev/null a l'aide d'un lien symbolique (cf. ln(1)). EXEMPLES # Force la synchronisation du disque pour limiter le risque de corruption de donnees. [Trigger] Operation = Install Operation = Upgrade Operation = Remove Type = Package Target = * [Action] Depends = coreutils When = PostTransaction Exec = /usr/bin/sync PRECAUTIONS Dans certains cas, les declencheurs sur presence d'un fichier (type path) peuvent se comporter de facon imprevue. Les actions d'amorcage sont declenchees en fonction de la liste de fichiers du paquetage installe, mis a niveau ou supprime. Chaque fois que l'on installe ou met a niveau un fichier qui est extrait avec une extension .pacnew, c'est bien le nom original du fichier qui est teste pour declencher l'amorcage. Quand on supprime un paquetage, tous les fichiers du paquetage peuvent declencher un amorcage, qu'ils soient ou non effectivement presents sur le systeme de fichiers avant la suppression du paquetage. Les amorcages de post-transaction ne seront pas lances si, pour une raison ou une autre, la transaction s'interrompt avant la fin. Consulter le site internet de pacman a l'adresse https://.archlinux.org/pacman/ pour de nouvelles informations sur pacman et ses outils associes. BOGUES Bogues ? C'est une blague ; il n'y a pas de bogues dans ce logiciel. Mais s'il y en a, envoyez un rapport de bogue contenant autant de details que possible dans la section Pacman du systeme de suivi de bogues de Arch Linux. AUTEURS Developpeurs actuels : o Allan McRae o Andrew Gregory o Eli Schwartz o Morgan Adamiec Contributeurs anterieurs majeurs : o Judd Vinet o Aurelien Foret o Aaron Griffin o Dan McGee o Xavier Chantry o Nagy Gabor o Dave Reisner Pour des contributeurs supplementaires, utiliser git shortlog -s sur le depot pacman.git. TRADUCTION La traduction francaise de cette page de manuel a ete creee par Jean- Jacques Brioist Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pacman 6.0.2 6 fevrier 2024 ALPM-HOOKS(5)