diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 00:45:20 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 00:45:20 +0000 |
commit | 9a08cbfcc1ef900a04580f35afe2a4592d7d6030 (patch) | |
tree | 004cc7027bca2f2c0bcb5806527c8e0c48df2d6e /man/fr | |
parent | Initial commit. (diff) | |
download | dpkg-9a08cbfcc1ef900a04580f35afe2a4592d7d6030.tar.xz dpkg-9a08cbfcc1ef900a04580f35afe2a4592d7d6030.zip |
Adding upstream version 1.19.8.upstream/1.19.8upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
55 files changed, 12643 insertions, 0 deletions
diff --git a/man/fr/deb-buildinfo.man b/man/fr/deb-buildinfo.man new file mode 100644 index 0000000..d59578c --- /dev/null +++ b/man/fr/deb-buildinfo.man @@ -0,0 +1,227 @@ +.\" dpkg manual page - deb-buildinfo(5) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2010 Russ Allbery <rra@debian.org> +.\" Copyright © 2015-2016 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-buildinfo 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-buildinfo \- Format des fichiers d'information de construction de Debian +. +.SH SYNOPSIS +\fInom\-du\-fichier\fP\fB.buildinfo\fP +. +.SH DESCRIPTION +Chaque construction de paquet source Debian peut enregistrer les +informations de construction dans un fichier de contrôle \fB.buildinfo\fP qui +contient un certain nombre de champs. Chaque champ commence par une +étiquette, telle que \fBSource\fP ou \fBBinary\fP (la casse n'importe pas), suivie +d'un «\ :\ » et du contenu du champ. Les champs sont séparés seulement par des +étiquettes de champ. En d'autres termes, le contenu d'un champ peut +s'étendre sur plusieurs lignes, mais les outils d'installation joindront en +général les lignes pendant le traitement du contenu du champ (sauf dans le +cas des champs à lignes multiples \fBBinary\-Only\-Changes\fP, +\fBInstalled\-Build\-Depends\fP, \fBEnvironment\fP, \fBChecksums\-Md5\fP, +\fBChecksums\-Sha1\fP et \fBChecksums\-Sha256\fP, voir ci\-dessous). +.PP +Les données de contrôle pourraient être incluses dans une signature OpenPGP +«\ ASCII Armored\ », comme spécifié dans RFC4880. +.PP +Le nom du fichier \fB.buildinfo\fP dépendra du type de construction et sera +aussi spécifique que nécessaire mais pas plus\ ; lorsque la construction +inclut \fBany\fP, le nom sera +\fInom\-source\fP\fB_\fP\fIversion\-binaire\fP\fB_\fP\fIarch\fP\fB.buildinfo\fP, ou sinon pour +une construction \fBall\fP le nom sera +\fInom\-source\fP\fB_\fP\fIbinary\-version\fP\fB_\fP\fBall.buildinfo\fP ou encore pour une +construction qui inclut \fBsource\fP le nom sera +\fInom\-source\fP\fB_\fP\fIversion\-source\fP\fB_\fP\fBsource.buildinfo\fP. +. +.SH "LES CHAMPS" +.TP +\fBFormat:\fP \fIversion\-format\fP (requis) +La valeur de ce champ déclare la version du format du fichier. La syntaxe de +la valeur du champ est un numéro de version avec un composant majeur et +mineur. Les modifications incompatibles avec les versions précédentes du +format incrémenteront la version majeure, tandis que les modifications +compatibles (telles que les ajouts de champ) incrémenteront la version +mineure. La version de format actuelle est \fB1.0\fP. +.TP +\fBSource:\fP \fInom\-source\fP [\fB(\fP\fIversion\-source\fP\fB)\fP] (requis) +Le nom du paquet source. Si la version du source diffère de la version +binaire, alors le \fInom\-source\fP sera suivi par une \fIversion\-source\fP entre +parenthèses. Cela peut arriver quand la construction concerne un envoi +seulement binaire NMU («\ non\-maintainer upload\ »). +.TP +\fBBinary:\fP \fIliste\-paquets\-binaires\fP (requis) +Ce champ coupé est une liste, séparée par des espaces, de paquets binaires +construits. +.TP +\fBArchitecture:\fP \fIliste\-architectures\fP (requis) +Ce champ, séparé par des espaces, liste les architectures des fichiers +actuellement en construction. Voici quelques architectures habituelles\ : +\fBamd64\fP, \fBarmel\fP, \fBi386\fP,\ etc. Remarquez que l'option \fBall\fP signifie que +le paquet est indépendant de toute architecture. Si le source du paquet est +aussi en construction, l'entrée spéciale \fBsource\fP est aussi présente. Les +architectures joker ne doivent jamais être présentes dans la liste. +.TP +\fBVersion:\fP \fIchaîne\-de\-la\-version\fP (requis) +C'est classiquement le numéro de version du paquet d'origine dans la forme +choisie par l'auteur du programme. Il peut y avoir aussi un numéro de +révision Debian (pour les paquets non natifs). Le format exact et +l'algorithme de tri sont décrits dans \fBdeb\-version\fP(7). +.TP +\fBBinary\-Only\-Changes:\fP +.TQ +\fIentrées\-du\-changelog\fP +Ce champ à lignes multiples contient le texte concaténé des entrées de +changelog pour un envoi seulement binaire (binNMU), si c'est le cas. Pour +faire de ce champ un champ à lignes multiples valable, les lignes vides sont +remplacées par un point \fB«\ .\ »\fP et toutes les lignes sont indentées par une +seule espace. Le contenu exact dépend du format du changelog. +.TP +\fBChecksums\-Md5:\fP (requis) +.TQ +\fBChecksums\-Sha1:\fP (requis) +.TQ +\fBChecksums\-Sha256:\fP (requis) +.TQ +\fIsomme\-de\-contrôle\fP \fItaille\fP \fInom\-du\-fichier\fP +Ces champs à lignes multiples contiennent la liste des fichiers avec la +somme de contrôle et la taille de chacun. Ces champs ont la même syntaxe et +ne diffèrent que par l'algorithme de somme de contrôle utilisé\ : MD5 pour +\fBChecksums\-Md5\fP, SHA\-1 pour \fBChecksums\-Sha1\fP et SHA\-256 pour +\fBChecksums\-Sha256\fP. + +La première ligne de la valeur du champ (la partie sur la même ligne que le +nom du champ suivi par deux\-points) est toujours vide. Le contenu du champ +est exprimé par des lignes de continuation, une ligne par fichier. Chaque +ligne consiste en des entrées séparées par des espaces décrivant le +fichier\ :la somme de contrôle, la taille du fichier et le nom du fichier. + +Ces champs listent tous les fichiers qui composent la construction. +.TP +\fBBuild\-Origin:\fP \fInom\fP +Nom de la distribution dont ce paquet provient. +.TP +\fBBuild\-Architecture:\fP \fIarch\fP (requis) +L'architecture Debian pour l'installation des paquets en construction. Les +architectures habituelles sont \fBamd64\fP, \fBarmel\fP, \fBi386\fP,\ etc. +.TP +\fBBuild\-Date:\fP \fIdate\-construction\fP +La date à laquelle le paquet a été construit. Elle peut être au même format +que la date dans les entrées dans \fBdeb\-changelog\fP(5). +.TP +\fBBuild\-Kernel\-Version:\fP \fIversion\-du\-noyau\-de\-construction\fP +La publication et la version (dans un format non spécifié) du noyau exécuté +dans le système de construction. Ce champ va seulement être présent si le +constructeur l'a demandé explicitement, pour éviter de révéler des +informations potentiellement sensibles. +.TP +\fBBuild\-Path:\fP \fIchemin\-de\-construction\fP +Le chemin de construction absolu qui correspond à l'arborescence des sources +dépaquetée. Ce champ va seulement être présent si le distributeur l'a mis en +liste blanche grâce à une recherche de motif pour éviter de révéler des +informations potentiellement sensibles. + +Dans Debian et ses dérivés, seuls les chemins de construction débutant par +\fI/build/\fP émettront ce champ. +.TP +\fBBuild\-Tainted\-By:\fP +.TQ +\fIliste\-des\-raisons\-de\-souillure\fP +Ce champ coupé est une liste, séparée par des espaces, non exhaustive des +étiquettes de raison (formées de caractères alphanumériques et de tirets) +qui définissent pourquoi la construction actuelle a été souillée (depuis +dpkg\ 1.19.5). +.IP +Dans Debian et ses dérivées, les étiquettes de raisons suivantes peuvent +être émises. +.RS +.TP +\fBmerged\-usr\-via\-symlinks\fP +Le système possède un \fI/usr\fP fusionné au moyen de liens symboliques. Cela +peut tromper \fBdpkg\-query\fP, \fBdpkg\-statoverride\fP, \fBdpkg\-trigger\fP, +\fBupdate\-alternatives\fP et tous les autres outils qui utilisent les noms de +chemin comme clés de leurs bases de données, parce que cela crée des +problèmes d'alias du système de fichiers, et perturbe la compréhension du +système de fichiers que \fBdpkg\fP a enregistré dans sa base de données. Pour +des systèmes construits qui codent en dur les noms de chemin vers des +binaires ou des bibliothèques particuliers sur les objets produits, cela +peut aussi produire des paquets qui seront incompatibles avec des systèmes +de fichiers sans \fI/usr\fP fusionné. +.TP +\fBusr\-local\-has\-configs\fP +Le système a des fichiers de configuration dans \fI/usr/local/etc\fP. +.TP +\fBusr\-local\-has\-includes\fP +Le système a des fichiers d'en\-tête dans \fI/usr/local/include\fP. +.TP +\fBusr\-local\-has\-programs\fP +Le système a des programmes dans \fI/usr/local/bin\fP ou \fI/usr/local/sbin\fP. +.TP +\fBusr\-local\-has\-libraries\fP +Le système a des bibliothèques statiques ou partagées dans +\fI/usr/local/lib\fP. +.RE +.TP +\fBInstalled\-Build\-Depends:\fP (requis) +.TQ +\fIliste\-paquets\fP +La liste des paquets installés et configurés que pourrait affecter le +processus de construction du paquet. + +La liste contient le nom de chaque paquet, éventuellement avec une +qualification d'architecture pour celles différentes, avec une restriction +de version précise, séparés par des virgules. + +La liste inclut tous les paquets essentiels, les paquets listés dans les +champs de contrôle des sources \fBBuild\-Depends\fP, \fBBuild\-Depends\-Arch\fP, +\fBBuild\-Depends\-Indep\fP, chaque dépendance interne spécifique au +distributeur, et toutes leurs dépendances récursives. Dans Debian et ses +dérivés, une dépendance interne est \fBbuild\-essential\fP. + +Pour les dépendances provenant des champs de contrôle des sources, toutes +les alternatives de dépendance et tous les fournisseurs de paquets virtuels +dépendants seront inclus. +.TP +\fBEnvironment:\fP +.TQ +\fIliste\-de\-variables\fP +La liste des variables d'environnement qui sont connues pour affecter le +processus de construction du paquet. Chaque variable d'environnement est +suivie d'un signe égal («\ =\ ») et de la valeur de la variable protégé avec +des guillemets doubles («\ "\ ») et des barres obliques inverses («\ \e\e\ »). +. +.\" .SH EXAMPLE +.\" .RS +.\" .nf +.\" +.\" .fi +.\" .RE +. +.SH "VOIR AUSSI" +\fBdeb\-changes\fP(5), \fBdeb\-version\fP(7), \fBdpkg\-genbuildinfo\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-changelog.man b/man/fr/deb-changelog.man new file mode 100644 index 0000000..b997d9d --- /dev/null +++ b/man/fr/deb-changelog.man @@ -0,0 +1,189 @@ +.\" dpkg manual page - deb-changelog(5) +.\" +.\" Copyright © 1996-1998 Ian Jackson and Christian Schwarz +.\" Copyright © 1998, 2001 Manoj Srivastava <srivasta@debian.org> +.\" Copyright © 2001 Julian Gilbey <jdg@debian.org> +.\" Copyright © 2003 Josip Rodin <joy@debian.org> +.\" Copyright © 2008, 2010 Russ Allbery <rra@debian.org> +.\" Copyright © 2010 Charles Plessy <plessy@debian.org> +.\" Copyright © 2014 Bill Allombert <ballombe@debian.org> +.\" Copyright © 2015-2017 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-changelog 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-changelog \- Format du fichier de journal des modifications +(«\ changelog\ ») des paquets source dpkg +. +.SH SYNOPSIS +changelog +. +.SH DESCRIPTION +Les modifications de la version empaquetée d'un projet sont expliquées dans +le fichier \fIdebian/changelog\fP. Cela comprend les modifications réalisées +dans les sources par rapport au paquet amont ainsi que les autres +modifications et mises à jour du paquet. +.PP +Le format de \fIdebian/changelog\fP permet aux outils de construction du paquet +de découvrir la version du paquet en construction et de découvrir d'autres +informations spécifiques à la version. +.PP +Ce format est une série d'entrées comme celles\-ci\ : + +.nf +\fIpaquet\fP (\fIversion\fP) \fIdistributions\fP; \fImétadonnées\fP + [ligne(s) blanches(s) facultative(s), retirée(s)] + * \fIdétails\-de\-modification\fP + \fIplus\-de\-détails\-de\-modification\fP + [ligne(s) blanches(s), y compris dans la sortie de + \fBdpkg\-parsechangelog\fP(1)] + * \fIencore\-plus\-de\-détails\-de\-modification\fP + [ligne(s) blanches(s) facultative(s), retirée(s)] + \-\- \fInom\-responsable\fP <\fIadresse\-électronique\fP> \fIdate\fP +.fi + +.PP +\fIpaquet\fP et (\fIversion\fP) sont le nom et le numéro de version du paquet +source. +.PP +\fIdistributions\fP liste une ou plusieurs distributions, séparées par une +espace, dans lesquelles cette version peut être installée après +téléchargement\ ; l'entrée est copiée dans le champ \fBDistribution\fP dans le +fichier \fI.changes\fP. +.PP +\fImetadata\fP est une liste séparée par des virgules de paires +\fImot\-clé\fP=\fIvaleur\fP. Les seuls \fImots\-clés\fP gérés actuellement par \fBdpkg\fP +sont \fBurgency\fP et \fBbinary\-only\fP. La valeur d'\fBurgency\fP est utilisée pour +le champ \fBUrgency\fP dans le fichier \fI.changes\fP pour l'envoi. \fBbinary\-only\fP +avec une valeur \fByes\fP est utilisé pour indiquer que cette entrée de +changelog est liée à un envoi seulement binaire (binNMU) (une reconstruction +automatique du binaire avec uniquement une modification de l'entrée du +changelog). +.PP +Les détails de modification peuvent être en fait une série de lignes +démarrant par au moins deux espaces, mais par convention, chaque +modification débute par un astérisque et une espace de séparation et les +lignes de continuation sont indentées de telle manière qu'elles s'alignent +sur le début du texte au\-dessus. Des lignes blanches peuvent être utilisées +pour séparer des groupes de modifications, si désiré. +.PP +Si cet envoi résout des bogues enregistrés dans le système de suivi de +bogues de la distribution, ceux\-ci peuvent être automatiquement fermés lors +de l'inclusion de ce paquet dans l'archive de la distribution en incluant la +chaîne\ : +.nf + \fBCloses: Bug#\fP\fInnnnn\fP +.fi +dans les détails de modification (l'expression rationnelle précise en Perl +est +\fB/closes:\es*(?:bug)?\e#?\es?\ed+(?:,\es*(?:bug)?\e#?\es?\ed+)*/i\fP). Cette +information est transmise à travers le champs \fBCloses\fP dans le \fI.changes\fP. +.PP +Le nom du responsable et l'adresse électronique utilisés dans le changelog +seront les détails sur la personne qui a préparé cette version du paquet. Ce +ne sont \fBpas\fP nécessairement ceux de celui qui fait l'envoi ou du +responsable habituel du paquet. Ces informations seront copiées dans le +champ \fBChanged\-By\fP du fichier \fI.changes\fP, et pourront plus tard être +utilisées pour envoyer une confirmation lorsque l'envoi a été installé dans +l'archive de la distribution. +.PP +La \fIdate\fP est au format suivant (compatible et avec la même sémantique que +RFC2822 et RFC5322, ou avec ce que crée «\ date\ \-R\ »)\ : +.IP +\fIjour\-de\-la\-semaine\fP\fB,\fP \fIjj\fP \fImois\fP \fIaaaa\fP \fIhh\fP\fB:\fP\fImm\fP\fB:\fP\fIss\fP +\fB+\fP\fIzzzz\fP +.PP +où\ : +.TP +\fIjour\-de\-la\-semaine\fP +C'est au choix\ : \fBMon\fP, \fBTue\fP, \fBWed\fP, \fBThu\fP, \fBFri\fP, \fBSat\fP, \fBSun\fP. +.TP +\fIjj\fP +C'est le numéro, à un ou deux chiffres, du jour du mois (\fB01\fP\-\fB31\fP). +.TP +\fImois\fP +C'est au choix\ : \fBJan\fP, \fBFeb\fP, \fBMar\fP, \fBApr\fP, \fBMay\fP, \fBJun\fP, \fBJul\fP, +\fBAug\fP, \fBSep\fP, \fBOct\fP, \fBNov\fP, \fBDec\fP. +.TP +\fIaaaa\fP +C'est l'année en chiffre (par exemple 2010). +.TP +\fIhh\fP +Il s'agit de l'heure en deux chiffres (\fB00\fP\-\fB23\fP). +.TP +\fImm\fP +Il s'agit des minutes en deux chiffres (\fB00\fP\-\fB59\fP). +.TP +\fIss\fP +Il s'agit des secondes en deux chiffres (\fB00\fP\-\fB59\fP). +.TP +[\fB+\-\fP]\fIzzzz\fP +Il s'agit du décalage horaire par rapport au temps universel coordonné +(UTC). «\ \fB+\fP\ » indique que l'heure est en avance (c'est\-à\-dire à l'est) par +rapport à l'UTC et «\ \fB\-\fP\ » indique que l'heure est en retard (c'est\-à\-dire +à l'ouest) par rapport à l'UTC. Les deux premiers chiffres indiquent la +différence d'heures par rapport à l'UTC et les deux derniers le nombre de +minutes additionnelles par rapport à l'UTC. Ces deux derniers chiffres +doivent être entre \fB00\fP et \fB59\fP. +.PP +La première ligne de «\ titre\ » avec le nom du paquet doit débuter à la marge +gauche. La ligne terminale avec les détails sur le responsable et la date +doit être précédée d'une espace précisément. Les détails sur le responsable +et la date doivent être séparés par exactement deux espaces. +.PP +Toute ligne qui consiste uniquement (c'est\-à\-dire sans espace au début de la +ligne) en commentaires de style \fB#\fP ou \fB/*\ */\fP, mots\-clés RCS. +.PP +Les lignes de mode («\ modeline\ ») de Vim ou variables locales d'Emacs et les +anciennes entrées de changelog avec d'autres formats à la fin du fichier +devraient être acceptées et conservées à la sortie, mais leur contenu +pourrait être autrement ignoré et l'analyse arrêtée à ce moment\-là. +.PP +La totalité du journal des modifications doit être encodé en UTF\-8. +.SH FICHIERS +.TP +\fIdebian/changelog\fP +.SH EXEMPLES +.nf +dpkg (1.17.18) unstable; urgency=low + + [ Guillem Jover ] + * Handle empty minimum versions when initializing dependency versions, + as the code is mapping the minimum version 0 to \*(rq to avoid outputting + useless versions. Regression introduced in dpkg 1.17.17. Closes: #764929 + + [ Updated programs translations ] + * Catalan (Guillem Jover). + + [ Updated dselect translations ] + * Catalan (Guillem Jover). + * German (Sven Joachim). + + \-\- Guillem Jover <guillem@debian.org> Sun, 12 Oct 2014 15:47:44 +0200 +.fi +. +.SH "VOIR AUSSI" +\fBdeb\-version\fP(7), \fBdeb\-changes\fP(5), \fBdpkg\-parsechangelog\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-changes.man b/man/fr/deb-changes.man new file mode 100644 index 0000000..cc494ab --- /dev/null +++ b/man/fr/deb-changes.man @@ -0,0 +1,196 @@ +.\" dpkg manual page - deb-changes(5) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2010 Russ Allbery <rra@debian.org> +.\" Copyright © 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-changes 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-changes \- Format des fichiers «\ .changes\ » Debian +. +.SH SYNOPSIS +\fInom\-du\-fichier\fP\fB.changes\fP +. +.SH DESCRIPTION +Chaque envoi dans Debian est composé d'un fichier de contrôle .changes qui +contient un certain nombre de champs. Chaque champ commence par une +étiquette, telle que \fBSource\fP ou \fBBinary\fP (la casse n'importe pas), suivie +d'un «\ :\ », et du contenu du champ. Les champs sont séparés seulement par +des étiquettes de champ. En d'autres termes, le contenu d'un champ peut +s'étendre sur plusieurs lignes, mais les outils d'installation joindront en +général les lignes pendant le traitement du contenu du champ (sauf pour les +champs à lignes multiples \fBDescription\fP, \fBChanges\fP, \fBFiles\fP, +\fBChecksums\-Sha1\fP et \fBChecksums\-Sha256\fP, voir ci\-dessous). +.PP +Les données de contrôle pourraient être incluses dans une signature OpenPGP +«\ ASCII Armored\ », comme spécifié dans RFC4880. +. +.SH "LES CHAMPS" +.TP +\fBFormat:\fP \fIversion\-format\fP (requis) +La valeur de ce champ déclare la version du format du fichier. La syntaxe de +la valeur du champ est un numéro de version avec un composant majeur et +mineur. Les modifications incompatibles avec les versions précédentes du +format incrémenteront la version majeure, tandis que les modifications +compatibles (telles que les ajouts de champ) incrémenteront la version +mineure. La version de format actuelle est \fB1.8\fP. +.TP +\fBDate:\fP \fIdate\-publication\fP (requis) +La date à laquelle le paquet a été construit ou modifié pour la dernière +fois. Elle doit avoir le même format que la date dans l'entrée +de\fBdeb\-changelog\fP(5). + +La valeur de ce champ est habituellement extraite du fichier +\fIdebian/changelog\fP. +.TP +\fBSource:\fP \fInom\-source\fP [\fB(\fP\fIversion\-source\fP\fB)\fP] (requis) +Le nom du paquet source. Si la version du source diffère de la version +binaire, alors le \fInom\-source\fP sera suivi par une \fIversion\-source\fP entre +parenthèses. Cela peut arriver quand il s'agit d'un envoi seulement binaire +NMU («\ non\-maintainer upload\ »). +.TP +\fBBinary:\fP \fIliste\-paquets\-binaires\fP (requis selon le contexte) +Ce champ coupé est une liste, séparée par des espaces, de paquets binaires à +envoyer. Si l'envoi ne concerne que les sources, le champ est omis (depuis +dpkg\ 1.19.3). +.TP +\fBArchitecture:\fP \fIliste\-architectures\fP +Liste des architectures des fichiers actuellement envoyés. Voici quelques +architectures habituelles\ : \fBamd64\fP, \fBarmel\fP, \fBi386\fP,\ etc. Remarquez que +l'option \fBall\fP signifie que le paquet est indépendant de toute +architecture. Si les sources du paquet sont également envoyées, l'entrée +spéciale \fBsource\fP est aussi présente. Les architectures joker ne doivent +jamais être présentes dans la liste. +.TP +\fBVersion:\fP \fIchaîne\-de\-la\-version\fP (requis) +C'est classiquement le numéro de version du paquet d'origine dans la forme +choisie par l'auteur du programme. Il peut y avoir aussi un numéro de +révision Debian (pour les paquets non natifs). Le format exact et +l'algorithme de tri sont décrits dans \fBdeb\-version\fP(7). +.TP +\fBDistribution:\fP \fIdistribution\fPs (requis) +Liste une ou plusieurs distributions, séparées par des espaces, dans +lesquelles cette version peut être installée après envoi dans l'archive. +.TP +\fBUrgency:\fP \fIurgence\fP (recommandé) +L'urgence de l'envoi. Les valeurs actuelles reconnues sont, par ordre +croissant d'urgence\ : \fBlow\fP, \fBmedium\fP, \fBhigh\fP, \fBcritical\fP et +\fBemergency\fP. +.TP +\fBMaintainer:\fP \fInom\-complet\-et\-adresse\-électronique\fP (requis) +Le format de ce champ sera «\ Jean Dupont <jdupont@example.org>\ »\ ; +et c'est bien sûr le créateur du paquet, par opposition à l'auteur du +programme mis en paquet. +.TP +\fBChanged\-By:\fP\fI nom\-complet\-et\-adresse\-électronique\fP +Le format de ce champ sera «\ Jean Dupont <jdupont@example.org>\ »\ ; +et c'est bien sûr celui qui a préparé les modifications du paquet pour cette +version. +.TP +\fBDescription:\fP (recommandé) +.TQ + \fInom\-du\-paquet\-binaire\fP \fB\-\fP \fIrésumé\-du\-paquet\-binaire\fP +Ce champ à lignes multiples contient une liste de noms de paquets binaires +suivis d'une espace, d'un tiret («\ \fB\-\fP\ ») et de leur description courte +éventuellement tronquée. Si l'envoi ne concerne que les sources, le champ +est omis (depuis dpkg\ 1.19.3). +.TP +\fBCloses:\fP\fI liste\-numéros\-bogue\fP +Une liste, séparée par des espaces, de numéros de rapports de bogue qui ont +été résolus par cet envoi. Le logiciel d'archive de la distribution pourrait +utiliser ce champ pour fermer automatiquement les bogues dont les numéros +sont référencés dans le système de suivi de bogues (BTS) de la distribution. +.TP +\fBBinary\-Only: yes\fP +Ce champ indique que l'envoi est une construction seulement binaire +indépendante (NMU). Il est issu de la paire clé/valeur \fBbinary\-only=yes\fP de +l'entrée metadata du changelog. +.TP +\fBBuilt\-For\-Profiles:\fP\fI liste\-de\-profils\fP +Ce champ définit une liste, séparée par des espaces, de profils de +construction avec lesquels cet envoi a été construit. +.TP +\fBChanges:\fP (requis) +.TQ +\fIentrées\-du\-journal\-des\-modifications\fP +Ce champ à lignes multiples fournit le texte concaténé de toutes les entrées +de changelog faisant partie de cet envoi. Pour faire de ce champ à lignes +multiples valable, les lignes vides sont remplacées par un point «\ \fB.\fP\ » et +toutes les lignes sont indentées par une seule espace. Le contenu exact +dépend du format du changelog. +.TP +\fBFiles:\fP (requis) +.TQ +\fImd5sum\fP \fItaille\fP \fIsection\fP \fIpriorité\fP \fInom\-de\-fichier\fP +Ce champ à lignes multiples fournit une liste de fichiers avec la md5sum, la +taille, la section et la priorité de chacun. + +La première ligne de la valeur du champ (la partie sur la même ligne que le +nom du champ suivi par deux\-points) est toujours vide. Le contenu du champ +est exprimé sous la forme de lignes de continuation, un ligne par +fichier. Chaque ligne consiste en des entrées, séparées par des espaces, +décrivant le fichier\ : la md5sum, la taille du fichier, sa section, sa +priorité et son nom. + +Ce champ liste tous les fichiers qui composent l'envoi. La liste de fichiers +de ce champ doit correspondre à celle présente dans les autres champs +relatifs aux \fBChecksums\fP. +.TP +\fBChecksums\-Sha1:\fP (requis) +.TQ +\fBChecksums\-Sha256:\fP (requis) +.TQ +\fIsomme\-de\-contrôle\fP \fItaille\fP \fInom\-du\-fichier\fP +Ces champs à lignes multiples fournissent une liste de fichiers avec la +somme de contrôle et la taille de chacun. Ces champs ont la même syntaxe et +ne diffèrent que par l'algorithme de somme de contrôle utilisé\ : SHA\-1 pour +\fBChecksums\-Sha1\fP et SHA\-256 pour \fBChecksums\-Sha256\fP. + +La première ligne de la valeur du champ (la partie sur la même ligne que le +nom du champ suivi par deux\-points) est toujours vide. Le contenu du champ +est exprimé par des lignes de continuation, une ligne par fichier. Chaque +ligne consiste en des entrées séparées par des espaces décrivant le +fichier\ :la somme de contrôle, la taille du fichier et le nom du fichier. + +Ces champs listent tous les fichiers qui composent l'envoi. La liste de +fichiers de ce champ doit correspondre à celle présente dans le champ +\fBFiles\fP et les autres champs relatifs aux \fBChecksums\fP. +. +.\" .SH EXAMPLE +.\" .RS +.\" .nf +.\" +.\" .fi +.\" .RE +. +.SH BOGUES +Le champ \fBFiles\fP n'est pas cohérent avec des autres fichiers +\fBChecksums\fP. Les champs \fBChanged\-By\fP et \fBMaintainer\fP ont des noms qui +provoquent la confusion. Le champ \fBDistribution\fP fournit des informations +sur ce à quoi une suite fait référence habituellement. +.SH "VOIR AUSSI" +\fBdeb\-src\-control\fP(5), \fBdeb\-version\fP(7). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-conffiles.man b/man/fr/deb-conffiles.man new file mode 100644 index 0000000..4f2cbd0 --- /dev/null +++ b/man/fr/deb-conffiles.man @@ -0,0 +1,56 @@ +.\" dpkg manual page - deb-conffiles(5) +.\" +.\" Copyright © 2016-2017 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-conffiles 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-conffiles \- Fichiers de configuration du paquet +. +.SH SYNOPSIS +conffiles +. +.SH DESCRIPTION +Un paquet déclare sa liste de fichiers de configuration en incluant un +fichier \fIconffiles\fP dans son archive de contrôle (c'est\-à\-dire +\fIDEBIAN/conffiles\fP au moment de la création du paquet). +.PP +Ce fichier fournit une liste de fichiers, un par ligne. Ils devront être +listés comme des chemins absolus et exister dans le paquet binaire, +autrement, \fBdpkg\fP(1) les ignorera (même si \fBdpkg\-deb\fP(1) refusera par +défaut de construire ces fichiers binaires). Les espaces résiduelles seront +rognées et les lignes vides ignorées. +. +.SH EXEMPLE +.nf +%CONFDIR%/alternatives/README +%CONFDIR%/cron.daily/dpkg +%PKGCONFDIR%/dpkg.cfg +%CONFDIR%/logrotate.d/dpkg +.fi +. +.SH "VOIR AUSSI" +\fBdpkg\-deb\fP(1), \fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-control.man b/man/fr/deb-control.man new file mode 100644 index 0000000..7cf1968 --- /dev/null +++ b/man/fr/deb-control.man @@ -0,0 +1,360 @@ +.\" dpkg manual page - deb-control(5) +.\" +.\" Copyright © 1995 Raul Miller, Ian Jackson, Ian Murdock +.\" Copyright © 1999 Ben Collins <bcollins@debian.org> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2007-2011, 2013-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2008-2012 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-control 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-control \- Format du fichier principal de contrôle dans les paquets +binaires Debian +. +.SH SYNOPSIS +contrôle +. +.SH DESCRIPTION +Chaque paquet Debian possède un fichier \fIcontrol\fP principal qui contient un +certain nombre de champs. Chaque champ commence par une étiquette, telle que +\fBPackage\fP ou \fBVersion\fP (la casse n'importe pas), suivie d'un «\ :\ », et du +contenu du champ. Les champs sont séparés seulement par des étiquettes de +champ. En d'autres termes, le contenu d'un champ peut s'étendre sur +plusieurs lignes, mais les outils d'installation joindront en général les +lignes pendant le traitement du contenu du champ (sauf pour le champ +\fBDescription\fP, voir ci\-dessous). +. +.SH "LES CHAMPS" +.TP +\fBPackage:\fP \fInom\-du\-paquet\fP (requis) +La valeur de ce champ donne le nom du paquet, et la plupart des outils +d'installation s'en servent pour produire les noms des paquets. +.TP +\fBPackage\-Type:\fP \fBdeb\fP|\fBudeb\fP|\fItype\fP +Ce champ indique le type de paquet. La valeur \fBudeb\fP est à utiliser pour +les paquets à taille contrôlée utilisés par l'installateur Debian. La valeur +\fBdeb\fP est la valeur par défaut qui est utilisée si le champ n'est pas +présent. De nouveaux types pourraient être ajoutés au fil du temps. +.TP +\fBVersion:\fP \fIchaîne\-de\-la\-version\fP (requis) +C'est classiquement le numéro de version du paquet d'origine dans la forme +choisie par l'auteur du programme. Il peut y avoir aussi un numéro de +révision Debian (pour les paquets non natifs). Le format exact et +l'algorithme de tri sont décrits dans \fBdeb\-version\fP(7). +.TP +\fBMaintainer:\fP \fInom\-complet\-et\-adresse\-électronique\fP (recommandé) +Le format de ce champ sera «\ Jean Dupont <jdupont@foo.com>\ »\ ; et +c'est bien sûr le créateur du paquet, par opposition à l'auteur du programme +mis en paquet. +.TP +\fBDescription:\fP \fIdescription\-courte\fP (recommandé) +.TQ +\fB \fP\fIdescription\-longue\fP +.br +Le format de la description du paquet est un résumé bref sur la première +ligne (après le champ \fBDescription\fP). Les lignes suivantes peuvent servir à +une description plus longue et plus détaillée. Chaque ligne de cette +description longue doit être précédée d'une espace\ ; quand c'est une ligne +blanche, elle doit contenir un seul «\ \fB.\fP\ » après cette espace. +.TP +\fBSection:\fP \fIsection\fP +Champ général qui indique la catégorie d'un paquet\ ; cette catégorie est +fondée sur le programme que ce paquet installe. \fButils\fP, \fBnet\fP, \fBmail\fP, +\fBtext\fP, \fBx11\fP,\ etc., représentent quelques catégories habituelles. +.TP +\fBPriority:\fP\fI priorité\fP +Définit l'importance du paquet à l'intérieur du système +général. \fBrequired\fP, \fBstandard\fP, \fBoptional\fP, \fBextra\fP,\ etc., représentent +des priorités habituelles. +.LP +Les champs \fBSection\fP et \fBPriority\fP possèdent un ensemble défini de valeurs +acceptées, tiré de la Charte particulière de la distribution. +. +.TP +\fBInstalled\-Size:\fP \fItaille\fP +La taille approximative totale des fichiers installés du paquet, en Kio⋅ +. +.TP +\fBEssential:\fP \fByes\fP|\fBno\fP +On se sert habituellement de ce champ uniquement si la réponse est +\fByes\fP. Cela signifie que ce paquet est exigé pour un fonctionnement correct +du système. Dpkg et les autres outils d'installation interdisent la +suppression d'un paquet \fBEssential\fP (du moins tant qu'une des options de +forçage n'est pas utilisée). +.TP +\fBBuild\-Essential:\fP \fByes\fP|\fBno\fP +Ce champ est habituellement nécessaire seulement si la réponse est \fByes\fP, +et il est généralement injecté par le logiciel d'archive. Il désigne un +paquet qui est requis lors de la construction d'autres paquets. +.TP +\fBArchitecture:\fP \fIarch\fP|\fBall\fP (recommandé) +L'architecture précise pour quel type de matériel le paquet a été +compilé. Voici quelques architectures habituelles\ : \fBamd64\fP, \fBarmel\fP, +\fBi386\fP, \fBpowerpc\fP,\ etc. Remarquez que l'option \fBall\fP signifie que le +paquet est indépendant de toute architecture. C'est le cas, par exemple, des +scripts d'interpréteur de commandes (shell) ou Perl, ainsi que de la +documentation. +.TP +\fBOrigin:\fP\fI nom\fP +Nom de la distribution dont ce paquet provient. +.TP +\fBBugs:\fP\fI URL\fP +L'\fIURL\fP du système de suivi de bogues (BTS) de ce paquet. Le format utilisé +est \fItype_de_bts\fP\fB://\fP\fIadresse\-du\-bts\fP, par exemple +\fBdebbugs://bugs.debian.org\fP. +.TP +\fBHomepage:\fP\fI URL\fP +\fIURL\fP de la page d'accueil du projet amont. +.TP +\fBTag:\fP\fI liste\-d'étiquettes\fP +Liste d'étiquettes décrivant les qualités du paquet. La description et la +liste des étiquettes («\ tags\ ») gérées peuvent être trouvées dans le paquet +\fBdebtags\fP. +.TP +\fBMulti\-Arch:\fP \fBno\fP|\fBsame\fP|\fBforeign\fP|\fBallowed\fP +Ce champ est utilisé pour indiquer comment ce paquet se comportera sur les +installations multi\-architectures. +.RS +.TP +\fBno\fP +C'est la valeur par défaut quand le champ est omis\ ; dans ce cas, ajouter le +champ avec une valeur \fBno\fP explicite est généralement inutile. +.TP +\fBsame\fP +Ce paquet est co\-installable avec lui\-même, mais il ne doit pas être utilisé +pour satisfaire la dépendance d'un paquet d'une autre architecture que la +sienne. +.TP +\fBforeign\fP +Ce paquet n'est pas co\-installable avec lui\-même, mais il pourra être +autorisé pour permettre de satisfaire les dépendances sans qualification +d'architecture d'un paquet d'une architecture différente de la sienne (si +une dépendance a une qualification d'architecture explicite, alors la valeur +\fBforeign\fP est ignorée). +.TP +\fBallowed\fP +Cela permet aux dépendances inverses d'indiquer dans leur champ +\fBDepends\fPqu'elles acceptent ce paquet d'une autre architecture en +qualifiant le nom du paquet avec \fB:any\fP, mais n'a pas d'autres effets. +.RE +.TP +\fBSource:\fP \fInom\-du\-paquet\-source\fP [\fB(\fP\fIversion\-source\fP\fB)\fP] +Le nom du paquet source d'où est issu ce paquet binaire, s'il est différent +du nom du paquet lui\-même. Si la version des sources diffère de la version +du binaire, alors le \fInom\-du\-paquet\-source\fP sera suivi par la +\fIversion\-source\fP entre parenthèses. Cela peut arriver par exemple sur un +envoi seulement binaire NMU («\ non\-maintainer upload\ »), ou lorsqu'une +version différente de binaire est fixée avec «\ \fBdpkg\-gencontrol \-v\fP\ ». +.TP +\fBSubarchitecture:\fP\fI valeur\fP +.TQ +\fBKernel\-Version:\fP\fI valeur\fP +.TQ +\fBInstaller\-Menu\-Item:\fP\fI valeur\fP +Ces champs sont utilisés par l'installateur et ne sont en général pas +nécessaires. Veuillez consulter +/usr/share/doc/debian\-installer/devel/modules.txt fourni avec le paquet +\fBdebian\-installer\fP pour plus de détails. + +.TP +\fBDepends:\fP\fI liste\-de\-paquets\fP +C'est la liste des paquets exigés pour que ce paquet procure un nombre +important de fonctionnalités. Le programme de maintenance des paquets +interdit l'installation d'un paquet quand les paquets répertoriés dans le +champ \fBDepends\fP ne sont pas installés (du moins tant qu'une option de +forçage n'est pas utilisée). Lors d'une installation, il lance les scripts +«\ postinst\ » des paquets répertoriés dans les champs \fBDepends\fP avant les +scripts «\ postinst\ » des paquets qui dépendent d'eux. À l'inverse, lors +d'une suppression, le script «\ prerm\ » d'un paquet est lancé avant ceux des +paquets listés dans son champ \fBDepends\fP. +.TP +\fBPre\-Depends:\fP\fI liste\-de\-paquets\fP +C'est la liste des paquets qui doivent être installés \fBet\fP configurés avant +que ce paquet puisse être installé. Habituellement, on utilise ce champ +quand un paquet a besoin d'un autre paquet pour lancer son script +«\ preinst\ ». +.TP +\fBRecommends:\fP\fI liste\-de\-paquets\fP +C'est la liste des paquets qu'on trouverait avec ce paquet dans toute +installation standard. Le programme de maintenance des paquets avertit +l'utilisateur quand il installe un paquet sans installer les paquets +répertoriés dans le champ \fBRecommends\fP. +.TP +\fBSuggests:\fP\fI liste\-de\-paquets\fP +C'est la liste des paquets qui, associés avec ce paquet, peuvent améliorer +son utilité\ ; néanmoins, une installation sans ces paquets est parfaitement +raisonnable. +.LP +La syntaxe des champs \fBDepends\fP, \fBPre\-Depends\fP, \fBRecommends\fP et +\fBSuggests\fP est une liste d'ensembles de paquets alternatifs. Chaque +ensemble est une liste de paquets séparés par des barres verticales (le +symbole du tube) «\ \fB|\fP\ ». Les ensembles sont séparés par des virgules. Une +virgule représente un «\ ET\ » logique et une barre verticale représente un +«\ OU\ » logique\ ; le tube a la précédence dans l'évaluation de +l'expression. Chaque nom de paquet est suivi éventuellement par un type +d'architecture après deux\-points «\ \fB:\fP\ », et par une contrainte sur le +numéro de version mise entre parenthèses. +.LP +Un nom de type d'architecture peut être un nom d'architecture réelle de +Debian (depuis dpkg\ 1.16.5) ou \fBany\fP (depuis dpkg\ 1.16.2). S'il est omis, +la valeur par défaut est l'architecture du paquet binaire actuel. Un nom +d'architecture réelle de Debian correspondra exactement à l'architecture +pour ce nom de paquet, \fBany\fP correspondra à toute architecture pour ce nom +de paquet si le paquet a été marqué \fBMulti\-Arch: allowed\fP. +.LP +Une contrainte sur le numéro de version peut commencer par +«\ \fB>>\fP\ », et dans ce cas toute version supérieure correspondra, et +il peut indiquer (ou pas) le numéro de révision pour le paquet Debian (les +deux numéros étant séparés par un trait d'union). Voici les relations +acceptées pour les versions\ : «\ \fB>>\fP\ » pour supérieur à, +«\ \fB<<\fP\ » pour inférieur à, «\ \fB>=\fP\ » pour supérieur ou égal, +«\ \fB<=\fP\ » pour inférieur ou égal, et «\ \fB=\fP\ » pour égal à. +.TP +\fBBreaks:\fP\fI liste\-de\-paquets\fP +C'est une liste de paquets que ce paquet «\ casse\ », par exemple en révélant +des bogues quand les paquets concernés dépendent de celui\-ci. Le programme +de maintenance des paquets interdit la configuration de paquets cassés\ ; une +méthode usuelle de résolution est la mise à niveau des paquets mentionnés +dans le champ \fBBreaks\fP. +.TP +\fBConflicts:\fP\fI liste\-de\-paquets\fP +C'est une liste de paquets qui sont en conflit avec ce paquet\ ; ils +contiennent par exemple des fichiers qui ont le même nom. Le programme de +maintenance des paquets interdit l'installation simultanée de paquets en +conflit. Deux paquets en conflit renseigneront une ligne \fBConflicts\fP avec +le nom de l'autre paquet. +.TP +\fBReplaces:\fP\fI liste\-de\-paquets\fP +C'est une liste de paquets que ce paquet remplace. Il peut ainsi remplacer +les fichiers de ces autres paquets\ ; on se sert pour cela du champ +\fBConflicts\fP pour forcer la suppression des autres paquets, si celui\-là +possède aussi les mêmes fichiers que le paquet en conflit. +.LP +La syntaxe des champs \fBBreaks\fP, \fBConflicts\fP et \fBReplaces\fP est une liste +de noms de paquets, séparés par des virgules (et des espaces +facultatives). Dans les champs \fBBreaks\fP et \fBConflicts\fP, la virgule sera +lue comme un «\ OU\ ». Un type d'architecture optionnel peut être aussi ajouté +au nom de paquet avec la même syntaxe que ci\-dessus, mais par défaut la +valeur est \fBany\fP plutôt que l'architecture du paquet binaire. On peut +donner une version optionnelle de la même façon que ci\-dessus dans les +champs \fBBreaks\fP, \fBConflicts\fP et \fBReplaces\fP. +. +.TP +\fBEnhances:\fP\fI liste\-de\-paquets\fP +C'est une liste de paquets que ce paquet améliore. C'est similaire à +\fBSuggests\fP mais en sens inverse. +.TP +\fBProvides:\fP\fI liste\-de\-paquets\fP +C'est une liste de paquets virtuels que ce paquet procure. On s'en sert +habituellement pour des paquets qui offrent le même service. Par exemple, +sendmail et exim sont des serveurs de courrier, et donc ils procurent chacun +un paquet commun («\ mail\-transport\-agent\ ») duquel d'autres paquets peuvent +dépendre. Sendmail et exim peuvent ainsi servir d'option valable pour +satisfaire la dépendance. Cela permet aux paquets qui dépendent d'un serveur +de courrier de ne pas avoir à connaître les noms de paquet de tous les +serveurs de courrier, en utilisant «\ \fB|\fP\ » comme séparateur de liste. +.LP +La syntaxe du champ \fBProvides\fP est une liste de noms de paquets, séparés +par des virgules (et des espaces facultatives). Un type d'architecture +facultatif peut également être ajouté au nom de paquet de la même façon que +ci\-dessus. S'il est omis l'architecture par défaut est celle du paquet +binaire actuel. Un numéro de version précis (égal à) optionnel peut être +donné de la même façon que ci\-dessus (pris en compte depuis dpkg\ 1.17.11). +. +.TP +\fBBuilt\-Using:\fP\fI liste\-de\-paquets\fP +Ce champ affiche les paquets source supplémentaires utilisés lors de la +construction du paquet binaire. Il permet d'indiquer au logiciel de gestion +de l'archive que des paquets source supplémentaires doivent être conservés +tant que le paquet binaire est maintenu. Ce champ doit être une liste de +paquets source avec des références strictes de version «\ \fB=\fP\ ». Veuillez +noter que le logiciel de gestion de l'archive risque de ne pas accepter un +envoi qui déclare une relation \fBBuilt\-Using\fP qui ne peut pas être +satisfaite dans l'archive. +. +.TP +\fBBuilt\-For\-Profiles:\fP\fI liste\-de\-profils\fP (obsolète) +Ce champ sert à spécifier une liste, séparée par des espaces, de profils de +construction avec lesquels ce paquet binaire a été construit (depuis +dpkg\ 1.17.2 et jusqu'à la version\ 1.18.18). Les informations précédemment +trouvées dans ce champ sont maintenant dans le champ \fB.buildinfo\fP qui l'a +remplacé. +. +.TP +\fBAuto\-Built\-Package:\fP\fI liste\-de\-raisons\fP +Ce champ définit une liste, séparée par des espaces, des raisons pour +lesquelles ce paquet a été généré automatiquement. Les paquets binaires +marqués avec ce champ n'apparaîtront pas dans le fichier principal de +contrôle des sources \fIdebian/control\fP. \fBdebug\-symbols\fP est la seule raison +utilisée actuellement. +. +.TP +\fBBuild\-Ids:\fP\fI liste\-identifiants\-de\-construction\-elf\fP +Ce champ définit une liste, séparée par des espaces, des identifiants de +construction ELF. Il s'agit des identifiants uniques d'objets ELF +sémantiquement identiques, pour chacun de ces objets présents dans le +paquet. +. +Le format ou la manière de calculer chaque identifiant de construction n'est +pas défini par nature. +. +.SH EXEMPLE +.\" .RS +.nf +Package: grep +Essential: yes +Priority: required +Section: base +Maintainer: Wichert Akkerman <wakkerma@debian.org> +Architecture: sparc +Version: 2.4\-1 +Pre\-Depends: libc6 (>= 2.0.105) +Provides: rgrep +Conflicts: rgrep +Description: GNU grep, egrep and fgrep. + Il se peut que le grep de la famille GNU des utilitaires grep soit + le plus rapide de l'ouest\ ! Le grep de GNU est fondé sur un mécanisme + rapide de mise en correspondance déterministe d'états simples (environ + deux fois plus rapide que le «\ egrep\ » standard d'Unix), modifié par une + recherche de type Boyer\-Moore\-Gosper qui cherche une chaîne donnée en + empêchant que les textes impossibles soient analysés par le mécanisme de + mise en correspondance d'expressions rationnelles et sans avoir + nécessairement besoin de voir chaque caractère. C'est beaucoup plus + rapide que les «\ grep\ » ou «\ egrep\ » d'Unix. + (Des expressions rationnelles contenant des références circulaires + ralentissent cependant le programme.) +.fi +.\" .RE +. +.SH BOGUES +Le champ \fBBuild\-Ids\fP utilise un nom plutôt générique à partir de son +contexte original dans l'objet ELF qui sert un objectif très spécifique et a +un format exécutable. +. +.SH "VOIR AUSSI" +\fBdeb\-src\-control\fP(5), \fBdeb\fP(5), \fBdeb\-version\fP(7), \fBdebtags\fP(1), +\fBdpkg\fP(1), \fBdpkg\-deb\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-extra-override.man b/man/fr/deb-extra-override.man new file mode 100644 index 0000000..8a81587 --- /dev/null +++ b/man/fr/deb-extra-override.man @@ -0,0 +1,60 @@ +.\" dpkg manual page - deb-extra-override(5) +.\" +.\" Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-extra\-override 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-extra\-override \- Fichier override supplémentaire d'une archive Debian +. +.SH SYNOPSIS +override +. +.SH DESCRIPTION +Bien que la majorité des informations d'un paquet source ou binaire puisse +être trouvée dans le fichier control/.dsc, ces informations peuvent être +remplacées lors de l'exportation dans des fichiers Packages ou Sources. Le +fichier d'«\ override\ » supplémentaire contient les valeurs remplacées. +.PP +Les éléments du fichier «\ override\ » supplémentaire sont séparés simplement +par des espaces. Les commentaires commencent par un caractère \fB«\ #\ »\fP. +.PP +.in +5 +\fIpaquet\fP \fInom\-de\-champ\fP \fIvaleur\fP +.in -5 +.PP +\fIpaquet\fP est le nom du paquet binaire/source. +.PP +\fInom\-de\-champ\fP est le nom du champ qui est remplacé. \fIvaleur\fP est la +valeur à mettre dans ce champ. Elle peut contenir des espaces car la ligne +est découpée en trois colonnes au plus quand elle est analysée. +.PP +Les fichiers de dérogation («\ override\ ») supplémentaires utilisés pour +établir les fichiers officiels «\ Packages\ » se trouvent dans le répertoire +\fIindices\fP des miroirs Debian. +. +.SH "VOIR AUSSI" +\fBdpkg\-scanpackages\fP(1), \fBdpkg\-scansources\fP(1), \fBapt\-ftparchive\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-old.man b/man/fr/deb-old.man new file mode 100644 index 0000000..af081e4 --- /dev/null +++ b/man/fr/deb-old.man @@ -0,0 +1,72 @@ +.\" dpkg manual page - deb-old(5) +.\" +.\" Copyright © 1995 Raul Miller +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-old 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-old \- Ancien format des paquets binaires Debian +. +.SH SYNOPSIS +\fInom\-du\-fichier\fP\fB.deb\fP +. +.SH DESCRIPTION +Le format de fichier \fB.deb\fP correspond aux paquets binaires Debian. Cette +page de manuel décrit l'\fBancien\fP format, utilisé avant la version\ 0.93 de +Debian. Veuillez consulter \fBdeb\fP(5) pour les informations sur le nouveau +format. +. +.SH FORMAT +Le fichier consiste en deux lignes d'information au format texte ASCII, +suivi par la concaténation de deux fichiers ustar compressés avec gzip. +.PP +La première ligne indique la version du format, remplie sur 8\ chiffres, +c'est\-à\-dire \fB0.939000\fP pour toutes les archives dans l'ancien format. +.PP +La deuxième ligne fournit un nombre décimal (sans zéros en tête), qui +indique la taille de la première archive tar compressée avec gzip. +.PP +Chacune de ces lignes se termine par un unique caractère de nouvelle ligne. +.PP +La première archive tar contient les informations de contrôle, sous forme +d'une série de fichiers ordinaires. Le fichier \fBcontrol\fP doit être présent, +puisqu'il contient les informations principales de contrôle. +.PP +Dans certaines archives vraiment anciennes, les fichiers de l'archive de +contrôle peuvent se trouver dans un sous\-répertoire \fBDEBIAN\fP. Dans ce cas, +le sous\-répertoire \fBDEBIAN\fP se trouve également dans l'archive de contrôle, +qui ne contiendra que des fichiers de ce répertoire. En option, l'archive de +contrôle peut contenir une entrée pour «\ \fB.\fP\ », le répertoire courant. +.PP +La seconde archive compressée avec gzip correspond à l'archive du système de +fichiers. Elle contient des chemins relatifs à la racine du système dans +lequel se fera l'installation. Les noms de fichiers ne débutent pas par des +barres obliques («\ /\ »). +. +.SH "VOIR AUSSI" +\fBdeb\fP(5), \fBdpkg\-deb\fP(1), \fBdeb\-control\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-origin.man b/man/fr/deb-origin.man new file mode 100644 index 0000000..03b9641 --- /dev/null +++ b/man/fr/deb-origin.man @@ -0,0 +1,76 @@ +.\" dpkg manual page - deb-origin(5) +.\" +.\" Copyright © 2011 Matt Kraai <kraai@ftbfs.org> +.\" Copyright © 2011 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-origin 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-origin \- Fichiers d'informations propre au distributeur +.SH SYNOPSIS +\fB%PKGCONFDIR%/origins/\fP\fIfichier\fP +.SH DESCRIPTION +Les fichiers de \fB%PKGCONFDIR%/origins\fP peuvent fournir des informations sur +les différents distributeurs qui fournissent des paquets Debian. + +Ils contiennent un certain nombre de champs ou de commentaires pour les +lignes commençant par un caractère «\ \fB#\fP\ ». Chaque champ commence par une +étiquette, telle que \fBVendor\fP ou \fBParent\fP, suivi du caractère +«\ deux\-points\ » et du contenu du champ. Les champs sont délimités par les +étiquettes de champs. En d'autres termes, le contenu d'un champ peut +s'étendre sur plusieurs lignes, mais les outils d'installation joindront en +général les lignes pendant le traitement du contenu du champ. + +Le fichier sera nommé d'après le nom du distributeur. La convention +habituelle est d'appeler le fichier distributeur avec le nom du distributeur +tout en minuscules, mais des différences sont possibles. Notamment, les +espaces sont remplacées par des tirets («\ \fB\-\fP\ ») et le fichier peut avoir +la même casse que la valeur du champ \fBVendor\fP ou il peut être mis en +capitales. +.SH "LES CHAMPS" +.TP +\fBVendor:\fP\fI distributeur\fP (requis) +La valeur de ce champ donne le nom du distributeur. +.TP +\fBVendor\-URL:\fP\fI adresse\-URL\-distributeur\fP +La valeur de ce champ donne l'adresse URL du distributeur +.TP +\fBBugs:\fP\fI url\-du\-bogue\fP +La valeur de ce champ donne le type et l'adresse du système de suivi des +bogues du distributeur. Cela peut être une URL mailto ou debbugs (par +exemple debbugs://bugs.debian.org/). +.TP +\fBParent:\fP\fI distributeur\fP +La valeur de ce champ donne le nom du distributeur dont le présent éditeur +est dérivé. +.SH EXEMPLE +.nf +Vendor: Debian +Vendor\-URL: https://www.debian.org/ +Bugs: debbugs://bugs.debian.org +.fi +.SH "VOIR AUSSI" +\fBdpkg\-vendor\fP(1) +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-override.man b/man/fr/deb-override.man new file mode 100644 index 0000000..88a4bc9 --- /dev/null +++ b/man/fr/deb-override.man @@ -0,0 +1,70 @@ +.\" dpkg manual page - deb-override(5) +.\" +.\" Copyright © 1996 Michael Shields <shields@crosslink.net> +.\" Copyright © 2010 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-override 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-override \- Fichier override d'une archive Debian +. +.SH SYNOPSIS +override +. +.SH DESCRIPTION +Bien que l'on puisse trouver dans le fichier «\ control\ » la plupart des +informations concernant un paquet, certaines doivent être inscrites par les +responsables de la distribution plutôt que par le responsable du paquet afin +de garantir une cohérence globale. Ces informations se trouvent dans le +fichier «\ override\ ». +.PP +Les éléments du fichier «\ override\ » sont séparés simplement par des +espaces. Les commentaires commencent par un caractère \fB«\ #\ »\fP. +.PP +.in +5 +\fIpaquet\fP \fIpriorité\fP \fIsection\fP [\fIresponsable\fP] +.in -5 +.PP +\fIpaquet\fP est le nom du paquet. Les entrées du fichier «\ override\ » +concernant des paquets qui ne sont pas dans l'arborescence des paquets +binaires sont ignorées. +.PP +\fIpriority\fP et \fIsection\fP correspondent respectivement aux champs de +contrôle présents dans le fichier .deb. Les valeurs autorisées sont +distinctes pour l'archive de chaque distribution. +.PP +L'élément \fIresponsable\fP, quand il existe, peut représenter soit le nom du +responsable quand il s'agit d'un remplacement sans condition, soit la chaîne +\fIancienresponsable\fP \fB=>\fP \fInouveauresponsable\fP pour un changement de +responsable. +.PP +On peut trouver les fichiers «\ override\ », dont on se sert pour établir les +fichiers officiels «\ Packages\ », dans le répertoire \fIindices\fP des miroirs +Debian. +. +.SH "VOIR AUSSI" +.ad l +\fBdpkg\-scanpackages\fP(1), \fBdpkg\-scansources\fP(1), \fBapt\-ftparchive\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-postinst.man b/man/fr/deb-postinst.man new file mode 100644 index 0000000..aec8604 --- /dev/null +++ b/man/fr/deb-postinst.man @@ -0,0 +1,66 @@ +.\" dpkg manual page - deb-postinst(5) +.\" +.\" Copyright © 2016 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-postinst 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-postinst \- Script du responsable pour la fin d'installation du paquet +. +.SH SYNOPSIS +postinst +. +.SH DESCRIPTION +Un paquet peut réaliser plusieurs actions post\-installation à l'aide de +scripts du responsable, en incluant un fichier \fIpostinst\fP exécutable dans +son archive de contrôle (c'est\-à\-dire \fIDEBIAN/postinst\fP au moment de la +création du paquet). +.PP +Le script peut être appelé de diverses manières\ : +.TP +\fIpostinst\fP \fBconfigure\fP \fIversion\-ancienne\fP +Après l'installation paquet +.TP +\fIpostinst\fP \fBtriggered\fP \fInom\-action\-différée...\fP +Après activation d'une action différée de ce paquet. +.TP +\fIancien\-postinst\fP \fBabort\-upgrade\fP \fInouvelle\-version\fP +Si \fIprerm\fP échoue durant la mise à niveau ou échoue après l'échec de la +mise à niveau. +.TP +\fIancien\-postinst\fP \fBabort\-remove\fP +Si \fIprerm\fP échoue durant la suppression. +.TP +\fIpostinst\fP \fBabort\-deconfigure in\-favour\fP \fInouveau\-paquet nouvelle\-version\fP +.TQ + [ \fBremoving\fP \fIancien\-paquet ancienne\-version\fP ] +Si \fIprerm\fP échoue durant la déconfiguration d'un paquet. +.TP +\fIpostinst\fP \fBabort\-remove in\-favour\fP \fInouveau\-paquet nouvelle\-version\fP +Si \fIprerm\fP échoue durant un remplacement à cause d'un conflit. +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-postrm.man b/man/fr/deb-postrm.man new file mode 100644 index 0000000..b03c5db --- /dev/null +++ b/man/fr/deb-postrm.man @@ -0,0 +1,69 @@ +.\" dpkg manual page - deb-postrm(5) +.\" +.\" Copyright © 2016 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-postrm 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-postrm \- Script du responsable pour la fin du retrait du paquet +. +.SH SYNOPSIS +postrm +. +.SH DESCRIPTION +Un paquet peut réaliser plusieurs actions post\-retrait à l'aide de scripts +du responsable, en incluant un fichier \fIpostrm\fP exécutable dans son archive +de contrôle (c'est\-à\-dire \fIDEBIAN/postrm\fP au moment de la création du +paquet). +.PP +Le script peut être appelé de diverses manières\ : +.TP +\fIpostrm\fP \fBremove\fP +Après le retrait du paquet +.TP +\fIpostrm\fP \fBpurge\fP +Après la purge du paquet. +.TP +\fIancien\-postrm\fP \fBupgrade\fP \fInouvelle\-version\fP +Après la mise à niveau du paquet. +.TP +\fInouveau\-postrm \fP\fBfailed\-upgrade\fP \fIancienne\-version nouvelle\-version\fP +Si l'appel \fBupgrade\fP ci\-dessus échoue. +.TP +\fIpostrm\fP \fBdisappear\fP \fIpaquet\-de\-remplacement\fP \fIversion\-de\-remplacement\fP +Après que l'ensemble des fichiers de paquets ont été remplacés +.TP +\fInouveau\-postrm\fP \fBabort\-install\fP +Si \fIpreinst\fP échoue lors de l'installation. +.TP +\fInouveau\-postrm\fP \fBabort\-install\fP \fIancienne\-version nouvelle\-version\fP +Si \fIpreinst\fP échoue lors de la mise à niveau d'un paquet supprimé. +.TP +\fInouveau\-postrm\fP \fBabort\-upgrade\fP \fIancienne\-version nouvelle\-version\fP +Si \fIpreinst\fP échoue lors d'une mise à niveau. +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-preinst.man b/man/fr/deb-preinst.man new file mode 100644 index 0000000..2387498 --- /dev/null +++ b/man/fr/deb-preinst.man @@ -0,0 +1,58 @@ +.\" dpkg manual page - deb-preinst(5) +.\" +.\" Copyright © 2016 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-preinst 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-preinst \- Script du responsable pour la pré\-installation du paquet +. +.SH SYNOPSIS +preinst +. +.SH DESCRIPTION +Un paquet peut réaliser plusieurs actions pré\-installation à l'aide de +scripts du responsable, en incluant un fichier \fIpreinst\fP exécutable dans +son archive de contrôle (c'est\-à\-dire \fIDEBIAN/preinst\fP au moment de la +création du paquet). +.PP +Le script peut être appelé de diverses manières\ : +.TP +\fInouveau\-preinst\fP \fBinstall\fP +Avant que le paquet ne soit installé. +.TP +\fInouveau\-preinst\fP \fBinstall\fP \fIancienne\-version nouvelle\-version\fP +Avant qu'un paquet supprimé ne soit mis à niveau. +.TP +\fInouveau\-preinst\fP \fBupgrade\fP \fIancienne\-version nouvelle\-version\fP +Avant qu'un paquet ne soit mis à niveau. +.TP +\fIancien\-preinst\fP \fBabort\-upgrade\fP \fInouvelle\-version\fP +Si \fIpostrm\fP échoue lors de la mise à niveau ou échoue après l'échec de la +mise à niveau. +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-prerm.man b/man/fr/deb-prerm.man new file mode 100644 index 0000000..b522583 --- /dev/null +++ b/man/fr/deb-prerm.man @@ -0,0 +1,63 @@ +.\" dpkg manual page - deb-prerm(5) +.\" +.\" Copyright © 2016 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-prerm 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-prerm \- Script du responsable pour le pré\-retrait du paquet +. +.SH SYNOPSIS +prerm +. +.SH DESCRIPTION +Un paquet peut réaliser plusieurs actions de pré\-retrait à l'aide de scripts +du responsable, en incluant un fichier \fIprerm\fP exécutable dans son archive +de contrôle (c'est\-à\-dire \fIDEBIAN/prerm\fP au moment de la création du +paquet). +.PP +Le script peut être appelé de diverses manières\ : +.TP +\fIprerm\fP \fBremove\fP +Avant le retrait du paquet +.TP +\fIancien\-prerm\fP \fBupgrade\fP \fInouvelle\-version\fP +Avant une mise à niveau. +.TP +\fInouveau\-prerm\fP \fBfailed\-upgrade\fP \fIancienne\-version nouvelle\-version\fP +Si le \fBupgrade\fP ci\-dessus échoue. +.TP +\fIprerm\fP \fBdeconfigure in\-favour\fP \fInouveau\-paquet nouvelle\-version\fP +.TQ + [ \fBremoving\fP \fIancien\-paquet ancienne\-version\fP ] +Avant qu'un paquet soit déconfiguré pendant qu'une dépendance est remplacée +du fait d'un conflit. +.TP +\fIprerm\fP \fBremove in\-favour\fP \fInouveau\-paquet nouvelle\-version\fP +Avant que le paquet soit remplacé du fait d'un conflit. +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-shlibs.man b/man/fr/deb-shlibs.man new file mode 100644 index 0000000..7ed2229 --- /dev/null +++ b/man/fr/deb-shlibs.man @@ -0,0 +1,66 @@ +.\" dpkg manual page - deb-shlibs(5) +.\" +.\" Copyright © 1996 Michael Shields <shields@crosslink.net> +.\" Copyright © 2008 Zack Weinberg <zackw@panix.com> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-shlibs 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-shlibs \- Fichier d'information sur les bibliothèques partagées Debian +. +.SH DESCRIPTION +.PP +Les fichiers \fBshlibs\fP associent les noms et versions (\fIsonames\fP) des +bibliothèques partagées aux dépendances correspondantes dans les fichiers de +contrôle des paquets. Il y a une entrée par ligne et les lignes vides ne +sont \fBpas\fP autorisées. Les lignes commençant par le caractère \fB(«\ #\ »)\fP +sont considérées comme étant des commentaires et sont ignorées. Toutes les +autres lignes doivent être au format +.IP +[\fItype\fP\fB:\fP] \fIbibliothèque\fP \fIversion\fP \fIdépendances\fP +.PP +Les champs \fIbibliothèque\fP et \fIversion\fP sont séparés par des espaces. Le +champ \fIdépendances\fP finit la ligne. Le champ \fItype\fP est optionnel et donc +normalement pas nécessaire. +.PP +Le champ \fIdépendances\fP utilise la même syntaxe que le champ \fBDepends\fP d'un +fichier de contrôle d'un paquet binaire, voir \fBdeb\-control\fP(5). +. +.SH EXEMPLES +.PP +Le fichier \fBshlibs\fP pour un paquet nommé \fIlibcrunch1\fP, qui fournit une +bibliothèque dont le nom est \fIlibcrunch.so.1\fP, doit avoir la ligne +.IP +libcrunch 1 libcrunch1 (>= 1.2\-1) +.PP +Les \fIdépendances\fP doivent indiquer la version la plus récente du paquet qui +ajoute de nouveaux symboles à la bibliothèque\ : dans l'exemple précédent, de +nouveaux symboles ont été ajoutés avec la version\ 1.2 de \fIlibcrunch\fP. Ce +n'est pas la seule raison pour laquelle les dépendances doivent être suivies +avec soin. +. +.SH "VOIR AUSSI" +\fBdeb\-control\fP(5), \fBdpkg\-shlibdeps\fP(1), \fBdeb\-symbols\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-split.man b/man/fr/deb-split.man new file mode 100644 index 0000000..6d26718 --- /dev/null +++ b/man/fr/deb-split.man @@ -0,0 +1,83 @@ +.\" dpkg manual page - deb-split(5) +.\" +.\" Copyright © 2009-2012 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-split 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-split \- Formatage de paquets binaires Debian en plusieurs parties +.SH SYNOPSIS +\fInom\-du\-fichier\fP\fB.deb\fP +.SH DESCRIPTION +Le format \fB.deb\fP en plusieurs parties (multi\-part) permet de découper de +gros paquets en petites parties pour faciliter leur transport sur des +supports de faible capacité. +.SH FORMAT +Le fichier est une archive \fBar\fP avec un numéro magique de +\fB!<arch>.\fP. Les noms de fichiers peuvent comporter un caractère +«\ /\ » final (depuis dpkg\ 1.15.6). +.PP +Le premier membre est appelé \fBdebian\-split\fP et contient un ensemble de +lignes, séparées par des retours à la ligne. Actuellement, huit lignes sont +présentes\ : +.IP • 4 +Numéro de version du format, \fB2.1\fP au moment de la rédaction de cette page +de manuel. +.IP • +Nom du paquet +.IP • +Version du paquet +.IP • +Somme de contrôle MD5 du paquet +.IP • +Taille totale du paquet +.IP • +Taille maximale d'un membre +.IP • +Numéro du membre courant, suivi d'une barre oblique (/) et du nombre total +de membres (par exemple ‘1/10’). +.IP • +Architecture du paquet (depuis dpkg\ 1.16.1) +.PP +Les programmes qui lisent des archives en parties multiples doivent pouvoir +gérer l'augmentation du numéro de version mineure et autoriser la présence +de lignes supplémentaires (et les ignorer si elles existent). +.PP +Si le numéro de version majeure a changé, cela signifie qu'une modification +incompatible a été effectuée, et le programme doit alors s'arrêter. Si ce +n'est pas le cas, le programme doit être en mesure de poursuivre +correctement, à moins qu'il ne rencontre un membre non reconnu dans +l'archive (excepté à la fin de cette dernière), comme décrit ci\-dessous. +.PP +Le deuxième et dernier membre requis se nomme \fBdata.\fP\fIN\fP où \fIN\fP est le +numéro de la partie. Il contient les données brutes de la partie. +.PP +Ces membres doivent apparaître dans cet ordre exact. Les implémentations +actuelles devraient ignorer tout membre additionnel suivant +\fBdata.\fP\fIN\fP. D'autres membres seront éventuellement proposés, et (si +possible) seront placés après les deux premiers. +.SH "VOIR AUSSI" +\fBdeb\fP(5), \fBdpkg\-split\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-src-control.man b/man/fr/deb-src-control.man new file mode 100644 index 0000000..e0fed73 --- /dev/null +++ b/man/fr/deb-src-control.man @@ -0,0 +1,475 @@ +.\" dpkg manual page - deb-src-control(5) +.\" +.\" Copyright © 2010 Oxan van Leeuwen <oxan@oxanvanleeuwen.nl> +.\" Copyright © 2011 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2011-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-src\-control 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-src\-control \- Format du fichier principal de contrôle dans les paquets +source Debian +. +.SH SYNOPSIS +debian/control +. +.SH DESCRIPTION +Chaque paquet source Debian contient un fichier «\ control\ » maître, qui +contient au moins deux paragraphes, séparés par une ligne vide. Le premier +paragraphe donne toutes les informations à propos du paquet source en +général et chaque paragraphe qui suit décrit exactement un paquet +binaire. Chaque paragraphe contient au moins un champ. Un champ commence par +le nom du champ, par exemple \fBPackage\fP ou \fBSection\fP (la casse n'est pas +significative), suivi d'un caractère «\ deux\-points\ », du contenu du champ et +d'un retour à la ligne. Les champs à lignes multiples sont aussi possibles, +mais chaque ligne supplémentaire, qui ne comporte pas de nom de champ, doit +commencer par au moins une espace. Le contenu des champs à lignes multiples +est en général réassemblé en une ligne unique par les outils (sauf pour le +champ \fBDescription\fP, voir ci\-dessous). Pour inclure des lignes vides dans +un champ à lignes multiples, il est nécessaire de mettre un point après +l'espace initiale. Les lignes commençant par \fB«\ #\ »\fP sont traitées comme +des commentaires. +. +.SH "LES CHAMPS SOURCE" +.TP +\fBSource:\fP \fInom\-du\-paquet\-source\fP (requis) +La valeur de ce champ est le nom du paquet source et doit correspondre au +nom du paquet source dans le fichier debian/changelog. Un nom de paquet doit +être constitué uniquement de lettres minuscules (a\-z), de chiffres (0\-9), +des caractères plus (+) et moins (\-) et de points (.). Les noms de paquets +doivent comporter au moins deux caractères et doivent commencer par un +caractère alphanumérique (a\-z0\-9) en minuscule. + +.TP +\fBMaintainer:\fP \fInom\-complet\-et\-adresse\-électronique\fP (recommandé) +Le format de ce champ sera «\ Jean Dupont <jdupont@foo.com>\ »\ ; il +indique le responsable actuel du paquet, par opposition à l'auteur du +logiciel ou au responsable originel. + +.TP +\fBUploaders:\fP\fI nom\-complet\-et\-adresse\-électronique\fP +Affiche les noms et les adresses électroniques des co\-responsables du +paquet, au même format que le champ \fBMaintainer\fP. Des co\-responsables +multiples peuvent être séparés par des virgules. + +.TP +\fBStandards\-Version:\fP \fIchaîne\-de\-la\-version\fP +Ce champ indique la version la plus récente des normes de la charte de la +distribution auxquelles ce paquet se conforme. + +.TP +\fBDescription\fP \fIdescription\-courte\fP +.TQ +\fB \fP\fIdescription\-longue\fP +Le format de la description du paquet est un résumé bref sur la première +ligne (après le champ \fBDescription\fP). Les lignes suivantes peuvent servir à +une description plus longue et plus détaillée. Chaque ligne de cette +description longue doit être précédée d'une espace\ ; quand c'est une ligne +blanche, elle doit contenir un seul «\ \fB.\fP\ » après cette espace. + +.TP +\fBHomepage:\fP\fI URL\fP +URL de la page d'accueil du projet amont. + +.TP +\fBBugs:\fP\fI URL\fP +L'\fIURL\fP du système de suivi de bogues (BTS) de ce paquet. Le format utilisé +est \fItype_de_bts\fP\fB://\fP\fIadresse_du_btsE\fP, par exemple +\fBdebbugs://bugs.debian.org\fP. Ce champ est en général inutile. + +.TP +\fBRules\-Requires\-Root:\fP \fBno\fP|\fBbinary\-targets\fP|\fImots\-clés\-implémentation\fP +Ce champ est utilisé pour indiquer si le fichier \fBdebian/rules\fP exige des +droits (fake)root pour exécuter certaines de ses cibles et quand, si c'est +le cas. +.RS +.TP +\fBno\fP +Les cibles binaires n'exigeront aucun (fake)root. +.TP +\fBbinary\-targets\fP +Les cibles binaires doivent toujours être exécutées avec les droits +(fake)root. C'est la valeur par défaut quand le champ est omis\ ; l'ajout du +champ avec un \fBbinary\-targets\fP explicite, alors qu'il n'est pas strictement +nécessaire, marque qu'il a été analysé pour cette exigence. +.TP +\fImots\-clés\-implémentation\fP +Il s'agit d'une liste, séparée par des espaces, de mots\-clés qui définissent +quand (fake)root est exigé. + +Les mots\-clés sont composés de \fIespace\-de\-nommage\fP/\fIcas\fP. La partie +\fIespace\-de\-nommage\fP ne peut pas inclure de «\ /\ » ou d'espace. La partie +\fIcas\fP ne peut pas inclure d'espace. Par ailleurs, les deux parties doivent +être entièrement composées de caractères ASCII imprimables. + +Chaque outil ou paquet définira un espace de nommage nommé d'après lui\-même +et fournira le nombre des cas où (fake)root est exigé. (Voir «\ Mots\-clés +fournis par l'implémentation\ » dans \fIrootless\-builds.txt\fP). + +Quand le champ est défini pour un des \fImots\-clés\-implémentation\fP, le +constructeur exposera une interface qui est utilisée pour exécuter une +commande avec les droits (fake)root. (Voir «\ API pour obtenir les droits +root\ » dans \fIrootless\-builds.txt\fP). +.RE + +.TP +\fBTestsuite:\fP\fI liste\-de\-noms\fP +.TQ +\fBTestsuite\-Triggers:\fP\fI liste\-de\-paquets\fP +Ces champs sont décrits dans la page de manuel de \fBdsc\fP(5), car ils sont +créés à partir des informations déduites de \fBdebian/tests/control\fP ou +copiés littéralement dans le fichier «\ control\ » du paquet source. + +.TP +\fBVcs\-Arch:\fP\fI URL\fP +.TQ +\fBVcs\-Bzr:\fP\fI URL\fP +.TQ +\fBVcs\-Cvs:\fP\fI URL\fP +.TQ +\fBVcs\-Darcs:\fP\fI URL\fP +.TQ +\fBVcs\-Git:\fP\fI URL\fP +.TQ +\fBVcs\-Hg:\fP\fI URL\fP +.TQ +\fBVcs\-Mtn:\fP\fI URL\fP +.TQ +\fBVcs\-Svn:\fP\fI URL\fP +Ce champ indique l'\fIURL\fP du système de gestion de version utilisé pour la +gestion du paquet. Les systèmes gérés sont \fBArch\fP, \fBBzr\fP (Bazaar), \fBCvs\fP, +\fBDarcs\fP, \fBGit\fP, \fBHg\fP (Mercurial), \fBMtn\fP (Monotone) et \fBSvn\fP +(Subversion). En général, ce champ fait référence à la dernière version du +paquet, c'est\-à\-dire la branche principale ou le «\ trunk\ ». + +.TP +\fBVcs\-Browser:\fP\fI URL\fP +Indique l'\fIURL\fP de l'interface web permettant de parcourir le dépôt du +système de gestion de version. + +.TP +\fBOrigin:\fP\fI nom\fP +Indique le nom de la distribution dont le paquet provient. Ce champ n'est +souvent pas nécessaire. + +.TP +\fBSection:\fP \fIsection\fP +Champ général qui indique la catégorie d'un paquet\ ; cette catégorie est +fondée sur le programme que ce paquet installe. \fButils\fP, \fBnet\fP, \fBmail\fP, +\fBtext\fP, \fBx11\fP,\ etc., représentent quelques catégories habituelles. + +.TP +\fBPriority:\fP\fI priorité\fP +Définit l'importance du paquet à l'intérieur du système +général. \fBrequired\fP, \fBstandard\fP, \fBoptional\fP, \fBextra\fP,\ etc., représentent +des priorités habituelles. + +Les champs \fBSection\fP et \fBPriority\fP possèdent un ensemble défini de valeurs +acceptées, tiré de la Charte particulière de la distribution. + +.TP +\fBBuild\-Depends:\fP\fI liste\-de\-paquets\fP +Liste de paquets à installer et configurer pour pouvoir construire à partir +du paquet source. Ces dépendances doivent être satisfaites lors de la +construction des paquets binaires dépendant ou non de l'architecture, et des +paquets source. Ajouter une dépendance à ce champ n'aura pas exactement le +même effet que de l'inclure à la fois dans \fBBuild\-Depends\-Arch\fP et +\fBBuild\-Depends\-Indep\fP, parce que la dépendance a aussi besoin d'être prise +en compte lors de la construction du paquet source. +. +.TP +\fBBuild\-Depends\-Arch:\fP\fIliste\-de\-paquets\fP +Liste analogue à \fBBuild\-Depends\fP, mais restreinte aux paquets nécessaires +pour construire les paquets dépendants de l'architecture. Les paquets +indiqués dans \fBBuild\-Depends\fP sont alors également installés. Ce champ est +géré depuis la version\ 1.16.4 de dpkg\ ;\ pour pouvoir construire des paquets +avec des versions plus anciennes de dpkg, il est préférable d'utiliser +\fBBuild\-Depends\fP. + +.TP +\fBBuild\-Depends\-Indep:\fP\fI liste\-de\-paquets\fP +Liste analogue à \fBBuild\-Depends\fP, mais restreinte aux paquets nécessaires +pour construire les paquets indépendants de l'architecture. Les paquets +indiqués dans \fBBuild\-Depends\fP sont alors aussi installés. + +.TP +\fBBuild\-Conflicts:\fP\fI liste de paquets\fP +Liste de paquets qui ne doivent pas être installés lors de la construction +du paquet, par exemple s'ils interfèrent avec le système de construction +utilisé. Si une dépendance est ajoutée à cette liste, l'effet sera le même +que si elle était ajoutée à la fois dans \fBBuild\-Conflicts\-Arch\fP et +\fBBuild\-Conflicts\-Indep\fP, en ayant de plus l'effet d'être prise en compte +pour les constructions de paquets uniquement source («\ source\-only +builds\ »). + +.TP +\fBBuild\-Conflicts\-Arch:\fP\fI liste\-de\-paquets\fP +Identique à \fBBuild\-Conflicts\fP, mais n'est prise en compte que pour les +paquets dépendants de l'architecture. Ce champ est géré depuis la +version\ 1.16.4 de dpkg\ ; pour pouvoir construire des paquets avec des +versions plus anciennes de dpkg, il est préférable d'utiliser +\fBBuild\-Conflicts\fP. + +.TP +\fBBuild\-Conflicts\-Indep:\fP\fI liste\-de\-paquets\fP +liste analogue à \fBBuild\-Conflicts\fP mais restreinte à la construction des +paquets indépendants de l'architecture. + +.PP +La syntaxe des champs \fBBuild\-Depends\fP, \fBBuild\-Depends\-Arch\fP et +\fBBuild\-Depends\-Indep\fP est une liste de groupes contenant des paquets +alternatifs. Chaque groupe est une liste de paquets séparés par des barres +verticales (le symbole du tube) «\ \fB|\fP\ ». Les groupes sont séparés par des +virgules «\ \fB,\fP\ », et la liste peut finir par une virgule qui peut être +éliminée lors de la création des champs pour \fBdeb\-control\fP(5) (depuis +dpkg\ 1.10.14). Une virgule représente un «\ ET\ » logique et une barre +verticale représente un «\ OU\ » logique\ ; le tube représente un lien plus +fort. Chaque nom de paquet est suivi de façon optionnelle par un type +d'architecture entre crochets après deux\-points «\ \fB:\fP\ », éventuellement +suivi par un numéro de version entre parenthèses «\ \fB(\fP\ » et «\ \fB)\fP\ », une +spécification d'architecture entre crochets «\ \fB[\fP\ » et «\ \fB]\fP\ », et une +formule de restriction constituée d'une ou plusieurs listes de noms de +profil entre chevrons «\ \fB<\fP\ » et «\ \fB>\fP\ ». + +La syntaxe des champs \fBBuild\-Conflicts\fP, \fBBuild\-Conflicts\-Arch\fP et +\fBBuild\-Conflicts\-Indep\fP est une liste de paquets séparés par des virgules +qui représentent le «\ ET\ » logique et peut finir par une virgule qui peut +être éliminée lors de la création des champs pour \fBdeb\-control\fP(5) (depuis +dpkg\ 1.10.14). L'indication de paquets alternatifs avec une barre verticale +(le symbole du tube) «\ |\ » n'est pas prise en charge. Chaque nom de paquet +peut être suivi de façon optionnelle par un numéro de version entre +parenthèses, un type d'architecture entre crochets et une formule de +restriction constituée d'une ou plusieurs listes de noms de profil entre +chevrons. + +Un nom de type d'architecture peut être un nom d'architecture réelle de +Debian (depuis dpkg\ 1.16.5), \fBany\fP (depuis dpkg\ 1.16.2) ou \fBnative\fP +(depuis dpkg\ 1.16.5). S'il est omis, la valeur par défaut des champs +\fBBuild\-Depends\fP est l'architecture de l'hôte actuel, la valeur par défaut +des champs \fBBuild\-Conflicts\fP est \fBany\fP. Un nom d'architecture réelle de +Debian correspondra exactement à l'architecture pour ce nom de paquet, +\fBany\fP correspondra à toute architecture pour ce nom de paquet si le paquet +a été marqué \fBMulti\-Arch: allowed\fP, et \fBnative\fP correspondra à +l'architecturede construction actuelle si le paquet n'a été marqué +\fBMulti\-Arch: foreign\fP. + +Une contrainte sur le numéro de version peut commencer par +«\ \fB>>\fP\ », et dans ce cas toute version supérieure correspondra, et +il peut indiquer (ou pas) le numéro de révision pour le paquet Debian (les +deux numéros étant séparés par un trait d'union). Voici les relations +acceptées pour les versions\ : «\ \fB>>\fP\ » pour supérieur à, +«\ \fB<<\fP\ » pour inférieur à, «\ \fB>=\fP\ » pour supérieur ou égal, +«\ \fB<=\fP\ » pour inférieur ou égal, et «\ \fB=\fP\ » pour égal à. + +Une indication d'architecture consiste en un ou plusieurs noms +d'architectures, séparés par des espaces. Un nom d'architecture peut être +précédé d'un point d'exclamation qui correspond alors au «\ NON\ » logique. + +Une formule de restriction consiste en une ou plusieurs listes de +restriction séparées par des espaces. Chaque liste de restriction est +incluse entre chevrons. Les éléments des listes de restriction sont des noms +de profils de construction séparés par des espaces et pouvant être préfixés +d'un point d'exclamation représentant un «\ NON\ » logique. Une formule de +restriction représente une forme normale disjonctive. + +Veuillez noter que les dépendances des paquets du jeu \fBbuild\-essential\fP +peuvent être omises et qu'il n'est pas possible de déclarer des conflits +avec ces paquets. La liste des paquets concernés est fournie par le paquet +build\-essential. + + +.SH "CHAMPS BINAIRES" + +.LP +Veuillez noter que les champs \fBPriority\fP, \fBSection\fP et \fBHomepage\fP peuvent +être placés dans le paragraphe d'un paquet binaire et leur valeur remplace +alors celle du paquet source. + +.TP +\fBPackage:\fP \fInom\-du\-paquet\-binaire\fP (requis) +Ce champ sert à indiquer le nom du paquet binaire. Les restrictions sont les +mêmes que celles des paquets source. + +.TP +\fBPackage\-Type:\fP \fBdeb\fP|\fBudeb\fP|\fItype\fP +Ce champ indique le type de paquet. La valeur \fBudeb\fP est à utiliser pour +les paquets à taille contrôlée utilisés par l'installateur Debian. La valeur +\fBdeb\fP est la valeur par défaut qui est utilisée si le champ n'est pas +présent. De nouveaux types pourraient être ajoutés au fil du temps. + +.TP +\fBArchitecture:\fP \fIarch\fP|\fBall\fP|\fBany\fP (requis) +Ce champ indique l'architecture matérielle sur laquelle le paquet peut être +utilisé. Les paquets qui peuvent être utilisés sur toute architecture +doivent utiliser le champ \fBany\fP. Les paquets indépendants de +l'architecture, tels les scripts shell ou Perl ou la documentation utilisent +la valeur \fBall\fP. Pour restreindre un paquet à certaines architectures, +leurs noms doivent être indiqués séparés par des espaces. Il est également +possible d'utiliser des noms génériques d'architectures dans cette liste +(voir \fBdpkg\-architecture\fP(1) pour plus d'informations sur ces architectures +génériques). + +.TP +\fBBuild\-Profiles:\fP \fIformule\-de\-restriction\fP +Ce champ précise les conditions pour lesquelles ce paquet binaire est ou +n'est pas construit. Cette condition est exprimée en utilisant la même +syntaxe de formule de restriction qui provient du champ \fBBuild\-Depends\fP. + +Si un paragraphe de paquet binaire ne contient pas ce champ, cela signifie +de façon implicite que ce paquet se construit avec tous les profils de +construction (y compris aucun profil). + +En d'autres termes, si un paragraphe de paquet binaire est annoté d'un champ +\fBBuild\-Profiles\fP non vide, alors, ce paquet binaire est créé si et +seulement si la condition exprimée par l'expression en forme normale +conjonctive est évaluée à vrai. + +.TP +\fBEssential:\fP \fByes\fP|\fBno\fP +.TQ +\fBBuild\-Essential:\fP \fByes\fP|\fBno\fP +.TQ +\fBMulti\-Arch:\fP \fBsame\fP|\fBforeign\fP|\fBallowed\fP|\fBno\fP +.TQ +\fBTag:\fP\fI liste\-d'étiquettes\fP +.TQ +\fBDescription:\fP \fIdescription\-courte\fP (recommandé) +Ces champs sont décrits dans la page de manuel de \fBdeb\-control\fP(5), car ils +sont copiés littéralement dans le fichier «\ control\ » du paquet binaire. + +.TP +\fBDepends:\fP\fI liste\-de\-paquets\fP +.TQ +\fBPre\-Depends:\fP\fI liste\-de\-paquets\fP +.TQ +\fBRecommends:\fP\fI liste\-de\-paquets\fP +.TQ +\fBSuggests:\fP\fI liste\-de\-paquets\fP +.TQ +\fBBreaks:\fP\fI liste\-de\-paquets\fP +.TQ +\fBEnhances:\fP\fI liste\-de\-paquets\fP +.TQ +\fBReplaces:\fP\fI liste\-de\-paquets\fP +.TQ +\fBConflicts:\fP\fI liste\-de\-paquets\fP +.TQ +\fBProvides:\fP\fI liste\-de\-paquets\fP +.TQ +\fBBuilt\-Using:\fP\fI liste\-de\-paquets\fP +Ces champs déclarent les relations entre les paquets. Ils sont discutés dans +la page de manuel de \fBdeb\-control\fP(5). Quand ces champs se trouvent dans +\fIdebian/control\fP, ils peuvent aussi se terminer par une virgule (depuis +dpkg\ 1.10.14)\ ; ils comprennent des spécifications d'architecture et des +formules de restriction qui seront réduites lors de la génération des champs +pour \fBdeb\-control\fP(5). + +.TP +\fBSubarchitecture:\fP\fI valeur\fP +.TQ +\fBKernel\-Version:\fP\fI valeur\fP +.TQ +\fBInstaller\-Menu\-Item:\fP\fI valeur\fP +Ces champs sont utilisés par l'installateur dans les \fBudeb\fP et ne sont en +général pas nécessaires. Veuillez consulter +/usr/share/doc/debian\-installer/devel/modules.txt fourni avec le paquet +\fBdebian\-installer\fP pour plus de détails. + +.SH "LES CHAMPS UTILISATEUR" +Il est autorisé d'ajouter au fichier de contrôle des champs supplémentaires +définis par l'utilisateur. L'outil ignorera ces champs. Si vous souhaitez +que ces champs soient copiés dans ces fichiers de sortie, tels que les +paquets binaires, vous devez utiliser un schéma de nommage personnalisé\ : +les champs démarreront par un \fBX\fP, suivi de zéro ou plusieurs des lettres +\fBSBC\fP et un trait d'union. + +.TP +\fBS\fP +Ce champ apparaîtra dans le fichier de contrôle du paquet des sources, voir +\fBdsc\fP(5). +.TP +\fBB\fP +Le champ apparaîtra dans le fichier de contrôle du paquet binaire, voir +\fBdeb\-control\fP(5). +.TP +\fBC\fP +Le champ apparaîtra dans le fichier de contrôle d'envoi (.changes), voir +\fBdeb\-changes\fP(5). + +.P +Veuillez noter que les préfixes \fBX\fP[\fBSBC\fP]\fB\-\fP sont retirés quand les +champs sont copiés dans les fichiers de sortie. Un champ \fBXC\-Approved\-By\fP +apparaîtra sous la forme \fBApproved\-By\fP dans le fichier des modifications et +n'apparaîtra pas dans les fichiers de contrôle des paquets binaires ou +source. + +Il faut prendre en compte le fait que ces champs définis par l'utilisateur +se serviront de l'espace de nommage global lequel pourrait, dans le futur, +entrer en conflit avec des champs officiellement reconnus. Pour éviter de +telles situations, il est conseillé de les préfixer avec \fBPrivate\-\fP +(exemple\ : \fBXB\-Private\-New\-Field\fP). + +.SH EXEMPLE +.\" .RS +.nf +# Commentaire +Source: dpkg +Section: admin +Priority: required +Maintainer: Dpkg Developers <debian\-dpkg@lists.debian.org> +# ce champ est copié dans les paquets source et binaires +XBS\-Upstream\-Release\-Status: stable +Homepage: https://wiki.debian.org/Teams/Dpkg +Vcs\-Browser: https://git.dpkg.org/cgit/dpkg/dpkg.git +Vcs\-Git: https://git.dpkg.org/git/dpkg/dpkg.git +Standards\-Version: 3.7.3 +Build\-Depends: pkg\-config, debhelper (>= 4.1.81), + libselinux1\-dev (>= 1.28\-4) [!linux\-any] + +Package: dpkg\-dev +Section: utils +Priority: optional +Architecture: all +# champ personnalisé dans le paquet binaire +XB\-Mentoring\-Contact: Raphael Hertzog <hertzog@debian.org> +Depends: dpkg (>= 1.14.6), perl5, perl\-modules, cpio (>= 2.4.2\-2), bzip2, lzma, + patch (>= 2.2\-1), make, binutils, libtimedate\-perl +Recommends: gcc | c\-compiler, build\-essential +Suggests: gnupg, debian\-keyring +Conflicts: dpkg\-cross (<< 2.0.0), devscripts (<< 2.10.26) +Replaces: manpages\-pl (<= 20051117\-1) +Description: Debian package development tools + This package provides the development tools (including dpkg\-source) + required to unpack, build and upload Debian source packages. + . + Most Debian source packages will require additional tools to build; + for example, most packages need make and the C compiler gcc. +.fi + + +.\" .RE +.SH "VOIR AUSSI" +\fBdeb\-control\fP(5), \fBdeb\-version\fP(7), \fBdpkg\-source\fP(1) +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-src-files.man b/man/fr/deb-src-files.man new file mode 100644 index 0000000..d309aa3 --- /dev/null +++ b/man/fr/deb-src-files.man @@ -0,0 +1,64 @@ +.\" dpkg manual page - deb-src-files(5) +.\" +.\" Copyright © 2016 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-src\-files 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-src\-files \- Format des fichiers distribués de Debian +. +.SH SYNOPSIS +debian/files +. +.SH DESCRIPTION +Ce fichier fournit la liste des objets qui seront distribués au moyen du +fichier de contrôle \fB.changes\fP. +.PP +Les éléments du fichier \fIdebian/files\fP sont séparés simplement par des +espaces. +.PP +.in +5 +\fInom\-de\-fichier\fP \fIsection\fP \fIpriorité\fP [ \fImot\-clé=valeur\&...\&\fP ] +.in -5 +.PP +\fInom\-de\-fichier\fP est le nom de l'objet à distribuer. +.PP +\fIsection\fP et \fIpriority\fP correspondent respectivement aux champs de +contrôle présents dans le fichier .deb. Les valeurs autorisées sont +spécifiques pour chaque distribution. +.PP +\fImot\-clé=valeur\&...\&\fP correspond à une liste optionnelle des attributs +séparés par des espaces pour cette entrée. Le seul mot clé pris en charge +actuellement est \fBautomatic\fP avec la valeur \fByes\fP, pour marquer les +fichiers générés automatiquement. +. +.SH NOTES +Ce fichier n'est pas censé être modifié directement, veuillez utiliser soit +\fBdpkg\-gencontrol\fP ou \fBdpkg\-distaddfile\fP pour lui ajouter des entrées. +. +.SH "VOIR AUSSI" +.ad l +\fBdpkg\-genchanges\fP(1), \fBdpkg\-distaddfile\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-src-rules.man b/man/fr/deb-src-rules.man new file mode 100644 index 0000000..5d08ae0 --- /dev/null +++ b/man/fr/deb-src-rules.man @@ -0,0 +1,92 @@ +.\" dpkg manual page - deb-src-rules(5) +.\" +.\" Copyright © 2016-2017 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-src\-rules 5 2017\-09\-05 "Projet Debian" "Utilitaires de dpkg" +.SH NOM +deb\-src\-rules \- Fichier de règles des paquets source Debian +. +.SH SYNOPSIS +debian/rules +. +.SH DESCRIPTION +Ce fichier fournit les instructions nécessaires à la construction des +paquets binaires à partir de paquets sources. +.PP +Le fichier \fIdebian/rules\fP est un Makefile exécutable avec un «\ shebang\ » +qui est habituellement positionné sur «\ #!/usr/bin/make \-f\ ». +.PP +Il doit prendre en charge les cibles «\ make\ » suivantes\ : + +.TP +\fBclean\fP +Nettoyer l'arborescence des sources, en supprimant toutes les modifications +réalisées par toutes les constructions et cibles binaires. Cette cible sera +appelée avec les droits du superutilisateur. +.TP +\fBbuild\-indep\fP +Construction des fichiers indépendants de l'architecture requis pour +construire tout paquet binaire indépendant de l'architecture. S'il n'y a pas +de paquet binaire indépendant de l'architecture à créer, la cible doit tout +de même exister mais ne fait rien. Cette cible ne doit pas requérir les +droits du superutilisateur. +.TP +\fBbuild\-arch\fP +Construction des fichiers dépendants de l'architecture requis pour +construire tout paquet binaire dépendant de l'architecture. S'il n'y a pas +de paquet binaire dépendant de l'architecture à créer, la cible doit tout de +même exister mais ne fait rien. Cette cible ne doit pas requérir les droits +du superutilisateur. +.TP +\fBbuild\fP +Construction des fichiers indépendants et dépendants de l'architecture, soit +en dépendant (au moins transitivement) de \fBbuild\-indep\fP et/ou de +\fBbuild\-arch\fP, ou en entrant en ligne de commande ce que les cibles +feront. Cette cible ne doit pas requérir les droits du superutilisateur. +.TP +\fBbinary\-indep\fP +Construction des paquets binaires indépendants de l'architecture. Cette +cible doit dépendre (au moins transitivement) soit de \fBbuild\-indep\fP, soit +de \fBbuild\fP. Cette cible sera appelée avec les droits du superutilisateur. +.TP +\fBbinary\-arch\fP +Construction des paquets dépendants de l'architecture. Cette cible doit +dépendre (au moins transitivement) soit de \fBbuild\-arch\fP, soit de +\fBbuild\fP. Cette cible sera appelée avec les droits du superutilisateur. +.TP +\fBbinary\fP +Construction des paquets binaires indépendants et dépendants de +l'architecture, soit en dépendant (au moins transitivement) de +\fBbinary\-indep\fP et/ou de \fBbinary\-arch\fP, ou en entrant en ligne de commande +ce que les cibles feront. Cette cible sera appelée avec les droits du +superutilisateur. +. +.SH "VOIR AUSSI" +.ad l +.nh +\fBdpkg\-architecture\fP(1), \fBdpkg\-vendor\fP(1), \fBdpkg\-buildflags\fP(1), +\fBdpkg\-parsechangelog\fP(1), \fBdpkg\-shlibdeps\fP(1), \fBdpkg\-gencontrol\fP(1), +\fBdpkg\-deb\fP(1), \fBdpkg\-distaddfile\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-substvars.man b/man/fr/deb-substvars.man new file mode 100644 index 0000000..597a8fd --- /dev/null +++ b/man/fr/deb-substvars.man @@ -0,0 +1,184 @@ +.\" dpkg manual page - deb-substvars(5) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006-2009,2012-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-substvars 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-substvars \- Variables de substitution de source Debian +. +.SH SYNOPSIS +substvars +. +.SH DESCRIPTION +Avant que \fBdpkg\-source\fP, \fBdpkg\-gencontrol\fP et \fBdpkg\-genchanges\fP +n'écrivent leurs informations de contrôle (dans le fichier source de +contrôle \fB.dsc\fP pour \fBdpkg\-source\fP et sur la sortie standard pour +\fBdpkg\-gencontrol\fP et \fBdpkg\-genchanges\fP), ils réalisent quelques +substitutions de variables dans le fichier de sortie. + +Une substitution de variable est de la forme\ : \fB${\fP\fInom\-variable\fP\fB}\fP. Les +noms de variable consistent en caractères alphanumériques (a\-zA\-Z0\-9), +traits d'union (\-) et «\ deux points\ » (:)\ ; ils commencent par une lettre ou +un chiffre et sont sensibles à la casse même si ils se réfèrent à d'autres +entités qui préservent la casse. La substitution se fait répétitivement +jusqu'à ce qu'il n'en reste aucune à faire\ ; le texte entier du champ après +la substitution est réexaminé pour chercher d'autres substitutions. + +Quand toutes les substitutions ont été faites, chaque occurrence de la +chaîne \fB${}\fP (laquelle n'est pas une substitution autorisée) est remplacée +par un signe \fB$\fP. + +Alors que le remplacement de variables est effectué sur tous les champs de +contrôle, certains de ces champs sont utilisés et nécessaires pendant la +construction alors même que la substitution n'a pas encore pu être +effectuée. Cela explique pourquoi il n'est pas possible d'utiliser de +variables dans les champs \fBPackage\fP, \fBSource\fP et \fBArchitecture\fP. + +La substitution de variables se fait dans le contenu des champs après leur +analyse. En conséquence, si vous souhaitez qu'une variable soit remplacée +sur plusieurs lignes, il n'est pas nécessaire de placer une espace après le +retour à la ligne. Cela se fait implicitement quand le champ est +affiché. Par exemple, si la variable \fB${Description}\fP est positionnée sur +«\ foo est bar.${Newline}foo est super.\ » et si vous avez le champ suivant\ : + + Description: application foo + ${Description} + . + Encore du texte. + +Le résultat final sera\ : + + Description: application foo + foo est bar. + foo est super. + . + Encore du texte. + +On peut définir les variables en utilisant l'option commune \fB\-V\fP. On peut +aussi se servir du fichier \fBdebian/substvars\fP (ou tout autre fichier avec +l'option \fB\-T\fP). Ce fichier est composé de lignes de la forme suivante\ : +\fInom\fP\fB=\fP\fIvaleur\fP. Les espaces résiduelles sur chaque ligne, les lignes +vides et les lignes qui commencent par un symbole \fB#\fP sont ignorées. + +En outre, les variables standard suivantes sont disponibles\ : +.TP +\fBArch\fP +L'architecture de l'hôte actuel (c'est\-à\-dire l'architecture pour laquelle +le paquet est construit, équivalent de \fBDEB_HOST_ARCH\fP). +.TP +\fBsource:Version\fP +Version du paquet source (depuis dpkg\ 1.13.19). +.TP +\fBsource:Upstream\-Version\fP +La version amont du paquet source, avec éventuellement l'«\ epoch\ » de la +version Debian (depuis dpkg\ 1.13.19). +.TP +\fBbinary:Version\fP +La version du paquet binaire (qui peut être différente de \fBsource:Version\fP +dans un binNMU par exemple\ ; depuis dpkg\ 1.13.19). +.TP +\fBSource\-Version\fP +La version du paquet source, selon le fichier changelog. Cette variable est +maintenant \fBobsolète\fP et produit une erreur lors de son utilisation car sa +signification est distincte de sa fonction. Utilisez plutôt +\fBsource:Version\fP ou \fBbinary:Version\fP. +.TP +\fBsource:Synopsis\fP +Le synopsis du paquet source, extrait du champ \fBDescription\fP du paragraphe +source, s'il existe (depuis dpkg\ 1.19.0). +.TP +\fBsource:Extended\-Description\fP +La description étendue du paquet source, extraite du champ \fBDescription\fP du +paragraphe source, s'il existe (depuis dpkg\ 1.19.0). +.TP +\fBInstalled\-Size\fP +La taille approximative de tous les fichiers installés du paquet. Cette +valeur est copiée dans le champ adéquat du fichier «\ control\ »\ ; quand on +fixe cette variable, cela modifie la valeur de ce champ. Quand elle est +indéterminée, \fBdpkg\-gencontrol\fP calcule la valeur par défaut en +additionnant la taille de chaque fichier ordinaire et lien symbolique +arrondie en unité d'un kio utilisée et sur la base d'un kio pour n'importe +quel type d'objet du système de fichiers. + +\fBRemarque\fP\ : Il faut tenir compte que cela ne peut jamais être qu'une +approximation dans la mesure où la taille véritablement occupée sur un +système installé dépend largement du système de fichiers utilisé et de ses +paramètres, ce qui pourrait finir par l'utilisation de plus ou moins +d'espace que ce qui est spécifié dans ce champ. +.TP +\fBExtra\-Size\fP +L'espace disque supplémentaire utilisé pour l'installation du paquet. Quand +on fixe cette variable, on ajoute sa valeur à la valeur de la variable +\fBInstalled\-Size\fP (qu'elle soit définie explicitement ou calculée par +défaut) avant qu'elle soit copiée dans le champ \fBInstalled\-Size\fP du fichier +«\ control\ ». +.TP +\fBS:\fP\fInom\-de\-champ\fP +La valeur du champ \fInom\-de\-champ\fP du paragraphe source (qui doit être +classiquement en majuscules, depuis dpkg\ 1.18.11). Quand on fixe ces +variables, cela ne prend effet que là où elles sont explicitement +développées. Ces variables ne sont disponibles que lors de la création des +fichiers de contrôle binaires. +.TP +\fBF:\fP\fInom\-de\-champ\fP +La valeur du champ \fInom\-de\-champ\fP affichée en sortie (qui doit être +classiquement en majuscules). Quand on fixe ces variables, cela ne prend +effet que là où elles sont explicitement développées. +.TP +\fBFormat\fP +La version du format du fichier \fB.changes\fP produite par la version des +scripts construisant le source. Quand on détermine cette variable, le +contenu du champ \fBFormat\fP dans le fichier \fB.changes\fP est aussi modifié. +.TP +\fBNewline\fP, \fBSpace\fP, \fBTab\fP +Ces variables contiennent chacune le caractère correspondant. +.TP +\fBshlibs:\fP\fIchamp\-dépendance\fP +Les variables déterminées de cette façon sont produites par +\fBdpkg\-shlibdeps\fP. +.TP +\fBdpkg:Upstream\-Version\fP +La version amont de dpkg (depuis dpkg\ 1.13.19). +.TP +\fBdpkg:Version\fP +La version complète de dpkg (depuis dpkg\ 1.13.19). +.LP +Quand une variable est référencée mais n'est pas définie, cela produit un +avertissement et une valeur vide est supposée. +. +.SH FICHIERS +.TP +\fBdebian/substvars\fP +La liste des variables de substitution et leurs valeurs. +. +.SH "VOIR AUSSI" +.ad l +\fBdpkg\fP(1), \fBdpkg\-genchanges\fP(1), \fBdpkg\-gencontrol\fP(1), +\fBdpkg\-shlibdeps\fP(1), \fBdpkg\-source\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-symbols.man b/man/fr/deb-symbols.man new file mode 100644 index 0000000..87564fb --- /dev/null +++ b/man/fr/deb-symbols.man @@ -0,0 +1,108 @@ +.\" dpkg manual page - deb-symbols(5) +.\" +.\" Copyright © 2007-2012 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2011, 2013-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-symbols 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-symbols \- Fichier d'information sur les bibliothèques partagées Debian +. +.SH SYNOPSIS +symboles +. +.SH DESCRIPTION +Les fichiers de symboles sont fournis dans les paquets binaires de Debian et +leur format est un sous\-ensemble des fichiers modèles de symboles utilisés +par \fBdpkg\-gensymbols\fP(1) dans les paquets source Debian. +.P +Le format pour une entrée d'information sur les dépendances étendues avec +bibliothèques partagées dans ces fichiers est le suivant\ : +.PP +\fIsoname\-de\-bibliothèque modèle\-principal\-de\-dépendance\fP +.br +[| \fImodèle\-alternatif\-de\-dépendance\fP] +.br +[...] +.br +[* \fInom\-du\-champ\fP: \fIvaleur\-du\-champ\fP] +.br +[...] + \fIsymbole\fP \fIversion\-minimale\fP[\fIid\-du\-modèle\-de\-dépendance\fP] +.P +La variable \fIsoname\-de\-bibliothèque\fP est exactement la valeur du champ +SONAME telle qu'exportée par \fBobjdump\fP(1). Un \fImodèle\-de\-dépendance\fP est +une dépendance où \fI#MINVER#\fP est dynamiquement remplacé soit par une +version comme «\ (>= \fIversion\-minimale\fP)\ » soit par rien (si une +dépendance quelle que soit sa version est reconnue suffisante). +.P +Chaque \fIsymbole\fP exporté (noté \fInom\fP@\fIversion\fP, avec \fIversion\fP réglé à +«\ Base\ » si la bibliothèque n'a pas de version) est associé à une +\fIversion\-minimale\fP dans son modèle de dépendance (le modèle principal de +dépendance est toujours utilisé et se termine combiné avec le modèle de +dépendance référencé par l'\fIid\-du\-modèle\-de\-dépendance\fP est présent). La +première alternative au modèle de dépendance est numérotée\ 1, la +seconde\ 2,\ etc. +.P +Chaque entrée pour une bibliothèque peut aussi avoir des champs de +méta\-information. Ces champs sont enregistrés dans des lignes qui débutent +par un astérisque («\ *\ »). Actuellement, le seul champ valable est\ : +.TP +\fBBuild\-Depends\-Package\fP +Il indique le nom du paquet «\ \-dev\ » associé à la bibliothèque et est +utilisé par \fBdpkg\-shlibdeps\fP pour s'assurer que la dépendance produite est +au moins aussi stricte que la dépendance de construction correspondante +(depuis dpkg\ 1.14.13). +.TP +\fBIgnore\-Blacklist\-Groups\fP +Il indique que les groupes blacklistés seront ignorés, sous forme de liste +séparée par des espaces, afin que les symboles contenus dans ces groupes +soient inclus dans le fichier de sortie (depuis dpkg\ 1.17.6). Cela sera +seulement nécessaire pour les paquets de chaîne d'outils qui fournissent ces +symboles blacklistés. Les groupes disponibles dépendent des systèmes et, +pour les systèmes basés sur ELF et GNU, ce sont \fBaeabi\fP et \fBgomp\fP. +.SH EXEMPLES +.SS "Simple fichier de symboles" +.PP +libftp.so.3 libftp3 #MINVER# + DefaultNetbuf@Base 3.1\-1\-6 + FtpAccess@Base 3.1\-1\-6 + [...] +.SS "Fichier avancé de symboles" +.PP +libGL.so.1 libgl1 +.br +| libgl1\-mesa\-glx #MINVER# +.br +* Build\-Depends\-Package: libgl1\-mesa\-dev + publicGlSymbol@Base 6.3\-1 + [...] + implementationSpecificSymbol@Base 6.5.2\-7 1 + [...] +.SH "VOIR AUSSI" +\fBhttps://wiki.debian.org/Projects/ImprovedDpkgShlibdeps\fP +.br +\fBdpkg\-shlibdeps\fP(1), \fBdpkg\-gensymbols\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-triggers.man b/man/fr/deb-triggers.man new file mode 100644 index 0000000..544aa59 --- /dev/null +++ b/man/fr/deb-triggers.man @@ -0,0 +1,122 @@ +.\" dpkg manual page - deb-triggers(5) +.\" +.\" Copyright © 2008, 2013-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2011, 2014 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-triggers 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-triggers \- Actions différées du paquet +. +.SH SYNOPSIS +actions différées +. +.SH DESCRIPTION +Un paquet déclare ses relations avec des actions différées en incluant un +fichier \fItriggers\fP dans son archive de contrôle (c'est\-à\-dire +\fIDEBIAN/triggers\fP au moment de la création du paquet). +.PP +Ce fichier contient des directives, une par ligne. Les espaces de début et +fin de ligne et tout ce qui suit le premier caractère \fB«\ #\ »\fP sont +supprimés, et les lignes vides seront ignorées. +.PP +Les directives actuellement gérées sont\ : +.TP +\fBinterest\fP \fInom\-action\-différée\fP +.TQ +\fBinterest\-await\fP \fInom\-action\-différée\fP +.TQ +\fBinterest\-noawait\fP \fInom\-action\-différée\fP +.IP +Indique que le paquet est concerné par l'action différée indiquée. Toutes +les actions différées associées au paquet doivent être listées en utilisant +cette directive depuis le fichier de contrôle des actions différées. +.IP +Les variantes «\ await\ » placent le paquet qui provoque l'action différée +dans l'état «\ triggers\-awaited\ » (actions différées attendues) selon la +manière dont l'action différée est activée. La variante «\ noawait\ » ne place +pas les paquets qui provoquent cette action différée dans l'état +«\ triggers\-awaited\ » même si le paquet déclenchant a déclaré une activation +«\ await\ » (par soit une directive \fBactivate\-await\fP ou \fBactivate\fP, soit en +utilisant l'option en ligne de commande \fBdpkg\-trigger\fP \fB\-\-no\-await\fP. La +variante «\ await\ » ne devrait être utilisée que lorsque la fonctionnalité +fournie par l'action différée n'est pas critique. +.TP +\fBactivate\fP \fInom\-action\-différée\fP +.TQ +\fBactivate\-await\fP \fInom\-action\-différée\fP +.TQ +\fBactivate\-noawait\fP \fInom\-action\-différée\fP +.IP +Cette directive permet que tout changement dans l'état de ce paquet active +l'action différée spécifiée. L'action différée sera activée au début des +opérations suivantes\ : dépaquetage, configuration, suppression (y compris en +cas de remplacement par un paquet conflictuel), purge et déconfiguration. +.IP +Les variantes «\ await\ » ne placent le paquet qui provoque cette action +différée dans l'état «\ triggers\-awaited\ » que si la directive concernée est +aussi «\ await\ ». La variante «\ noawait\ » ne place jamais les paquets qui +provoquent cette action différée dans l'état «\ triggers\-awaited\ ». Elle ne +devrait être utilisée que lorsque la fonctionnalité fournie par l'action +différée n'est pas critique. +.IP +Si ce paquet disparaît durant le dépaquetage d'un autre paquet, l'action +différée sera activée lorsque la disparition est constatée vers la fin du +dépaquetage. L'exécution d'une action différée, et donc le passage du statut +triggers\-awaited (action\-différée\-attendue) à installed (installé), ne +provoquera pas l'activation. Dans le cas d'un dépaquetage, les actions +différées listées dans l'ancienne et la nouvelle version du paquet seront +activées. +.PP +Les directives inconnues sont des erreurs qui empêcheront l'installation du +paquet. +.PP +Les variantes «\ \-noawait\ » doivent toujours être privilégiées quand c'est +possible dans la mesure où les paquets provoquant une action différée ne +sont pas placés en état «\ triggers\-awaited\ » (actions différées attendues), +et peuvent donc être immédiatement configurés sans recourir à l'exécution de +l'action différée. Si les paquets provoquant l'action différée sont des +dépendances d'autres paquets mis à jour, cela évitera le lancement de +l'action différée et rendra possible l'exécution de l'action différée une +seule fois au cours des étapes finales de la mise à jour. +.PP +Les variantes «\ \-noawait\ » ne sont gérées qu'à partir de dpkg\ 1.16.1 et +provoqueront des erreurs avec les versions plus anciennes. +.PP +Les alias de variantes «\ \-await\ » ne sont gérés qu'à partir de dpkg\ 1.17.21 +et provoqueront des erreurs avec les versions plus anciennes. +.PP +Si un paquet fournit une directive \fBinterest\-noawait\fP, toute activation +mettra le paquet provoquant l'action différée en mode «\ noawait\ », +indépendamment du mode d'attente demandé par l'activation (soit «\ await\ », +soit «\ noawait\ »). Si un paquet fournit une directive \fBinterest\fP ou +\fBinterest\-await\fP, toute activation mettra le paquet provoquant l'action +différée en mode «\ await\ » ou «\ noawait\ » selon la manière dont il a été +activé. +. +.SH "VOIR AUSSI" +.\" FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev. +\fBdpkg\-trigger\fP(1), \fBdpkg\fP(1), \fB/usr/share/doc/dpkg\-dev/triggers.txt.gz\fP. +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb-version.man b/man/fr/deb-version.man new file mode 100644 index 0000000..34c0d7c --- /dev/null +++ b/man/fr/deb-version.man @@ -0,0 +1,129 @@ +.\" dpkg manual page - deb-version(7) +.\" +.\" Copyright © 1996-1998 Ian Jackson and Christian Schwarz +.\" for parts of the text reused from the Debian Policy +.\" Copyright © 2007 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2011, 2013, 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb\-version 7 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb\-version \- Format du numéro de version des paquets Debian +. +.SH SYNOPSIS +[\fIepoch\fP\fB:\fP]\fIversion_amont\fP[\fB\-\fP\fIrévision_debian\fP] +.SH DESCRIPTION +Les numéros de version utilisés pour les paquets sources et binaires se +composent de trois parties. Celles\-ci sont\ : +.TP +\fIepoch\fP +Ce nombre est un entier positif (usuellement petit). Il peut être omis (dans +ce cas, la valeur nulle est implicite). S'il est omis, la \fIversion_amont\fP +peut ne pas contenir de caractère deux\-points. +.IP +Cette valeur est destinée à permettre de gérer des erreurs dans les anciens +numéros de version d'un paquet ou un changement dans la méthode de +numérotation des versions amont. +.TP +\fIversion_amont\fP +Cela est la partie principale du numéro de version. Cela correspond +normalement au numéro de version du paquet d'origine («\ upstream\ ») qui a +servi à créer le fichier \fI.deb\fP, si cela peut s'appliquer. Le format +d'origine spécifié par l'auteur est généralement conservé\ ; cependant, il +arrive qu'il soit nécessaire d'adapter ce numéro pour qu'il se conforme au +format du système de gestion de paquet et du procédé de comparaison des +numéros de version. +.IP +Le principe de comparaison du système de gestion de paquets en ce qui +concerne la \fIversion_amont\fP est décrit ci\-dessous. La partie +\fIversion_amont\fP du numéro de version est obligatoire. +.IP +La \fIversion_amont\fP ne doit contenir que des caractères alphanumériques +(«\ A\-Za\-z0\-9\ ») et les caractères \fB.\fP \fB+\fP \fB\-\fP \fB:\fP \fB~\fP (point, plus, +tiret, deux\-points, tilde) et devrait commencer par un chiffre. S'il n'y a +pas de partie \fIrévision_Debian\fP alors le tiret n'est pas autorisé\ ; s'il +n'y a pas d'\fIepoch\fP, alors c'est le caractère deux\-points qui n'est pas +autorisé. +.TP +\fIrévision_Debian\fP +Cette partie du numéro de version indique la version du paquet Debian à +partir du numéro de la version amont. Elle ne doit contenir que des symboles +alphanumériques et les caractères \fB+\fP \fB.\fP \fB~\fP (plus, point, tilde). Elle +est analysée de la même façon que la \fIversion_amont\fP. +.IP +Cette partie est facultative\ ; si elle n'est pas présente, la +\fIversion_amont\fP ne doit pas contenir de tiret. Ce format est prévu pour le +cas où un logiciel a été directement conçu comme paquet Debian, il n'y a +donc qu'une seule «\ debianisation\ » et donc par la suite pas besoin +d'indication de révision. +.IP +Il est convenu de repartir à «\ 1\ » pour la \fIrévision_Debian\fP à chaque fois +que la \fIversion_amont\fP est incrémentée. +.IP +Dpkg s'arrêtera au dernier tiret du numéro de version (s'il y en a un) pour +déterminer la partie \fIversion_amont\fP et la \fIrévision_Debian\fP. L'absence de +\fIrévision_Debian\fP est comparée avant sa présence, mais il faut noter que la +\fIrévision_Debian\fP est la partie la moins significative du numéro de +version. +.SS "Algorithme de tri" +Les parties \fIversion_amont\fP et \fIrévision_Debian\fP sont comparées par le +système de gestion de paquet en utilisant le même algorithme\ : +.PP +Les chaînes sont comparées de la gauche vers la droite. +.PP +Pour commencer, la première partie de chaque chaîne composée uniquement de +caractères non numériques est déterminée. Puis ces deux parties (l'une peut +être vide) sont comparées lexicalement. Si une différence est trouvée, elle +est renvoyée. La comparaison lexicale est effectuée sur une version modifiée +des valeurs ASCII afin que les lettres passent avant les autres caractères +et que les tildes ("~") passent avant tous les caractères, même la fin d'une +partie. Par exemple, les éléments suivants sont ordonnés ainsi\ : «\ ~~\ », +«\ ~~a\ », «\ ~\ », partie vide, «\ a\ ». +.PP +Puis, le début de ce qui reste des chaînes de caractères qui ne doivent plus +contenir que des chiffres est déterminé. Ces valeurs numériques sont +comparées et les différences sont remontées. Dans le cas d'une chaîne vide +(ce qui peut arriver si une chaîne est plus longue que l'autre lors de la +comparaison) elle compte pour un zéro. +.PP +Ces deux étapes (comparaison et suppression des caractères non numériques +puis de suppression des caractères numériques dans le début de la chaîne) +sont répétées jusqu'à ce qu'une différence soit trouvée ou la fin des +chaînes atteinte. +.PP +Notez que le rôle de epoch est de permettre de se sortir des problèmes de +numérotation de version, et de faire face à des situations de changement de +logique de numérotation. Cela n'est \fBpas\fP destiné à faire face à des +numéros de version qui contiennent des chaînes de lettres que le système de +gestion de paquet ne sait pas interpréter (comme «\ ALPHA\ », «\ pre\-\ ») ou +d'autres choses stupides. +.SH NOTES +Le caractère tilde («\ ~\ ») et sa propriété spéciale pour les comparaisons +ont été introduites dans la version\ 1.10 de dpkg. Ce n'est qu'à partir des +versions supérieures (1.10.x) que certaines parties des scripts de +construction de dpkg ont commencé à gérer ce système. +.SH "VOIR AUSSI" +\fBdeb\-control\fP(5), \fBdeb\fP(5), \fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb.man b/man/fr/deb.man new file mode 100644 index 0000000..094e8fe --- /dev/null +++ b/man/fr/deb.man @@ -0,0 +1,120 @@ +.\" dpkg manual page - deb(5) +.\" +.\" Copyright © 1995 Raul Miller +.\" Copyright © 1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006-2017 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb \- Format des paquets binaires Debian +.SH SYNOPSIS +\fInom\-du\-fichier\fP\fB.deb\fP +.SH DESCRIPTION +Le format \fB.deb\fP est le format des paquets binaires de Debian. Il est +compatible depuis la version\ 0.93.76 de dpkg, et il est généré par défaut +depuis les versions\ 1.2.0 de dpkg et\ 1.1.1elf (constructions i386/ELF). +.PP +Le format décrit ici est utilisé depuis la version\ 0.93 de Debian\ ; les +détails concernant le vieux format sont consultables dans \fBdeb\-old\fP(5). +.SH FORMAT +Ce fichier est une archive \fBar\fP avec une valeur magique de +\fB!<arch>\fP. Seul le format commun \fBar\fP est géré, sans extension +pour les noms longs de fichiers, mais avec optionnellement un caractère +«\ /\ » final, ce qui limite leur longueur utile à 15\ caractères (sur les +16\ autorisés). Les tailles de fichiers sont limitées à 10\ chiffres décimaux +ASCII, ce qui permet d'utiliser des fichiers membres d'une taille jusqu'à +environ 9536,74\ Mio. +.PP +Les archives \fBtar\fP actuellement gérées sont le format\ v7 d'origine, le +format ustar pré\-POSIX, un sous\-ensemble du format GNU (uniquement le +nouveau format de noms longs pour les chemins et les liens, gérés depuis +dpkg\ 1.4.1.17\ ; «\ large file metadata\ » depuis dpkg\ 1.18.24) et le format +ustar POSIX (noms longs gérés depuis dpkg\ 1.15.0). Les marqueurs tar +(«\ typeflags\ ») inconnus provoquent une erreur. La taille de chaque entrée +dans une archive tar est limitée à 11\ chiffres en octal ASCII ce qui permet +d'utiliser des entrées tar d'une taille jusqu'à 8\ Gio. La gestion des +«\ large file metadata\ » de GNU permet des entrées tar 95\ bits et des +horodatages négatifs, ainsi que des numéros de 63\ bits d'UID, GID et de +périphériques. +.PP +Le premier membre est nommé \fBdebian\-binary\fP et contient une succession de +lignes, séparées par des caractères saut de ligne. Pour le moment, une seule +ligne est présente\ : le numéro de version du format, \fB2.0\fP à l'heure où ce +document a été écrit. Les programmes lisant des archives Debian récentes +doivent être préparés à une augmentation du numéro de version mineur et à la +présence de nouvelles lignes, et doivent les ignorer si tel est le cas. +.PP +Si le numéro de version majeur a changé, cela signifie qu'une modification +entraînant une incompatibilité entre les versions a été effectuée, et le +programme doit alors s'arrêter. Si ce n'est pas le cas, le programme doit +être en mesure de continuer à traiter correctement le fichier, à moins qu'il +ne rencontre un membre non reconnu dans l'archive (excepté à la fin de cette +dernière), comme décrit ci\-dessous. +.PP +Le second membre requis est nommé \fBcontrol.tar\fP. Il s'agit d'une archive +tar contenant les informations de contrôle du paquet, soit non compressée +(gérée depuis dpkg\ 1.17.6) ou compressée grâce à gzip (avec extension +\&\fB.gz\fP) ou xz (avec extension \fB.xz\fP, gérée depuis dpkg\ 1.17.6), sous la +forme d'une série de fichiers simples, parmi lesquels le fichier \fBcontrol\fP +est strictement requis et contient les principales informations de contrôle, +les fichiers \fBconffiles\fP, \fBtriggers\fP, \fBshlibs\fP et \fBsymbols\fP qui +contiennent des informations de contrôle optionnelles, et les fichiers +\fBpreinst\fP, \fBpostinst\fP, \fBprerm\fP et \fBpostrm\fP qui sont des scripts +optionnels du responsable. L'archive de contrôle peut éventuellement +contenir une entrée pour «\ .\ », le répertoire courant. +.PP +Le troisième et dernier membre obligatoire est appelé \fBdata.tar\fP. Il +contient le système de fichiers sous forme d'une archive tar, soit non +compressée (gérée depuis dpkg\ 1.10.24) ou compressée avec gzip (avec +extension \fB.gz\fP), xz (avec extensions \fB.xz\fP, gérée depuis dpkg\ 1.15.6), +bzip2 (avec extensions \fB.bz2\fP, gérée depuis dpkg\ 1.10.24) ou lzma (avec +extension \fB.lzma\fP, gérée depuis dpkg\ 1.13.25). +.PP +Ces membres doivent apparaître dans cet ordre exact. Les implémentations +actuelles devraient ignorer tout membre additionnel après +\fBdata.tar\fP. D'autres membres seront éventuellement proposés, et (si +possible) seront placés après ces trois derniers. Tout autre membre qui +nécessitera d'être inséré après \fBdebian\-binary\fP et avant \fBcontrol.tar\fP ou +\fBdata.tar\fP et qui pourra être ignoré sans problème par des programmes plus +anciens, aura un nom commençant par un caractère de soulignement, «\ \fB_\fP\ ». +.PP +Les nouveaux membres qui ne pourront pas être ignorés sans conséquence +seront insérés avant \fBdata.tar\fP avec des noms préfixés par quelque chose +d'autre qu'un caractère de soulignement, ou impliqueront plus probablement +une incrémentation du numéro majeur de version. +.SH "TYPE DE SUPPORT" +.SS Actuel +application/vnd.debian.binary\-package +.SS Obsolète +application/x\-debian\-package +.br +application/x\-deb +.SH "VOIR AUSSI" +\fBdeb\-old\fP(5), \fBdpkg\-deb\fP(1), \fBdeb\-control\fP(5), \fBdeb\-conffiles\fP(5), +\fBdeb\-triggers\fP(5), \fBdeb\-shlibs\fP(5), \fBdeb\-symbols\fP(5), \fBdeb\-preinst\fP(5), +\fBdeb\-postinst\fP(5), \fBdeb\-prerm\fP(5), \fBdeb\-postrm\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/deb822.man b/man/fr/deb822.man new file mode 100644 index 0000000..95bd015 --- /dev/null +++ b/man/fr/deb822.man @@ -0,0 +1,146 @@ +.\" dpkg manual page - deb822(5) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH deb822 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +deb822 \- Format des données de contrôle RFC822 Debian +. +.SH DESCRIPTION +Le système de gestion de paquets manipule des données représentées dans un +format commun, connues comme \fIdonnées de contrôle\fP, stockées dans les +\fIfichiers de contrôle\fP. Les fichiers de contrôle sont utilisés pour les +paquets source, les paquets binaires et les fichiers \fB.changes\fP qui +contrôlent l'installation des fichiers téléversés (les bases de données +internes de \fBdpkg\fP sont dans un format similaire). +. +.SH SYNTAXE +Un fichier de contrôle consiste en un ou plusieurs paragraphes de champs +(les paragraphes sont aussi parfois appelés strophes, «\ stanzas\ »). Les +paragraphes sont séparés par des lignes vides. Les analyseurs peuvent +accepter des lignes qui ne contiennent que des caractères U+0020 \fBESPACE\fP +et U+0009 \fBTABULATION\fP comme séparateurs de paragraphes, mais les fichiers +de contrôle utiliseront des lignes vides. Certains fichiers de contrôle +acceptent seulement un paragraphe unique, d'autres plusieurs, dans ce cas, +chaque paragraphe fait référence habituellement à un paquet différent. (Par +exemple, dans les paquets source, le premier paragraphe fait référence au +paquet source, et les paragraphes suivants font références aux paquets +binaires créés à partir du source.) L'ordre des paragraphes dans les +fichiers de contrôles est important. + +Chaque paragraphe consiste en une série de champs de données. Chaque champ +est constitué d'un nom de champ suivi de deux\-points (U+003A «\ \fB:\fP\ »), puis +les données ou valeur associées à ce champ. Le nom du champ est composé de +caractères US\-ASCII à l'exception des caractères de contrôle, de l'espace et +des deux\-points (c'est\-à dire des caractères entre U+0021 «\ \fB!\fP\ » et U+0039 +«\ \fB9\fP\ », et entre U+003B «\ \fB;\fP\ » et U+007E «\ \fB~\fP\ » compris). Les noms de +champ ne doivent pas commencer par le caractère de commentaire «\ (U+0023 +\fB#\fP\ », ni par le caractère trait d'union (U+002D «\ \fB\-\fP\ ». + +Les champs se terminent à la fin de la ligne ou à la fin de la dernière +ligne de continuation (voir ci\-dessous). Une espace horizontale (U+0020 +\fBESPACE\fP et U+0009 \fBTABULATION\fP) peut apparaître immédiatement avant ou +après la valeur et est ignorée dans ce cas\ ; par convention, il y une espace +unique après les deux\-points. Par exemple, un champ pourrait être\ : +.RS +.nf +Package: dpkg +.fi +.RE +le nom du champ est \fBPackage\fP et la valeur du champ \fBdpkg\fP. + +Des valeurs de champ vides ne sont permises que dans les fichiers de +contrôle des paquets source (\fIdebian/control\fP). Ces champs sont ignorés. + +Un paragraphe ne doit pas contenir plus d'une instance d'un nom de champ +particulier. + +Il y a trois types de champ\ : + +.RS 0 +.TP +\fBsimple\fP +Ce champ, y compris sa valeur, doit être une ligne unique. La coupure du +champ est interdite. Il s'agit du type de champ par défaut lorsque la +définition du champ ne précise pas un type différent. +.TP +\fBcoupé\fP +La valeur d'un champ coupé («\ folded\ ») est une ligne logique qui peut +s'étendre sur plusieurs lignes. Les lignes qui suivent la première sont +appelées ligne de continuation et doivent commencer par un caractère U+0020 +\fBESPACE\fP ou U+0009 \fBTABULATION\fP. Une espace, y compris les caractères saut +de ligne, n'est pas importante dans les valeurs de champ des champs coupés. + +La méthode de coupure est similaire à RFC5322, permettant des fichiers de +contrôle, qui contiennent seulement un paragraphe et pas des champs à +plusieurs lignes, d'être lus par les analyseurs écrits pour RFC5322. +.TP +\fBà lignes multiples\fP +La valeur d'un champ à lignes multiples peut comprendre de multiples lignes +de continuation. La première ligne de la valeur, la partie sur la même ligne +que le nom du champ, a souvent une signification particulière ou peut devoir +être vide. Les autres lignes sont ajoutées avec la même syntaxe que les +lignes de continuation des champs coupés. Une espace, y compris les +caractères saut de ligne, est importante dans les valeurs des champs à +lignes multiples. +.RE + +Aucune espace ne doit apparaître dans les noms (de paquet, d'architecture, +de fichier ou n'importe quoi d'autre) ou les numéros de version, ou entre +les caractères des relations des versions multi\-caractères. + +La présence et le but d'un champ, ainsi que la syntaxe de sa valeur peuvent +différer selon les types de fichiers de contrôle. + +Les noms de champ ne sont pas sensibles à la casse, mais il est habituel de +mettre en capitale l'initiale des noms de champ utilisant une casse mixte +comme indiqué plus bas. Les valeurs de champ sont sensibles à la casse à +moins que la description du champ ne dise le contraire. + +Les séparateurs de paragraphes (lignes vides) et les lignes constituées +uniquement de U+0020 \fBESPACE\fP et U+0009 \fBTABULATION\fP, ne sont pas permis +dans les valeurs de champ ou entre les champs. Les lignes vides dans les +valeurs de champ sont habituellement protégées par une U+0020 \fBESPACE\fP +suivie par un point (U+002E «\ \fB.\fP\ »). + +Les lignes débutant par un U+0023 «\ \fB#\fP\ », sans être précédée d'une espace +sont des lignes de commentaires qui ne sont permises que dans les fichiers +de contrôle de paquet source et dans les fichiers \fBdeb\-origin\fP(5). Ces +lignes de commentaires sont ignorées, même entre deux lignes de +continuation. Elles ne peuvent terminer les lignes logiques. + +Tous les fichiers de contrôle doivent être encodés en UTF\-8. +. +.\" .SH EXAMPLE +.\" .RS +.\" .nf +.\" .fi +.\" .RE +. +.SH "VOIR AUSSI" +\fBRFC822\fP, \fBRFC5322\fP. +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-architecture.man b/man/fr/dpkg-architecture.man new file mode 100644 index 0000000..cc9ab71 --- /dev/null +++ b/man/fr/dpkg-architecture.man @@ -0,0 +1,394 @@ +.\" dpkg manual page - dpkg-architecture(1) +.\" +.\" Copyright © 2005 Marcus Brinkmann <brinkmd@debian.org> +.\" Copyright © 2005 Scott James Remnant <scott@netsplit.com> +.\" Copyright © 2006-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2009-2012 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-architecture 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-architecture \- Fixer et déterminer l'architecture pour la construction +d'un paquet +. +.SH SYNOPSIS +\fBdpkg\-architecture\fP [\fIoption\fP...] [\fIcommande\fP] +.PP +. +.SH DESCRIPTION +\fBdpkg\-architecture\fP aide à déterminer et à fixer l'architecture de +construction et l'architecture hôte pour la création d'un paquet. +.PP +L'architecture de construction est toujours déterminée par un appel externe +à \fBdpkg\fP(1). Elle ne peut pas être spécifiée en ligne de commande. +.PP +Vous pouvez spécifier une architecture hôte en utilisant une des options +\fB\-\-host\-arch\fP et \fB\-\-host\-type\fP (ou les deux). Par défaut, la valeur est +déterminée par un appel à \fBgcc\fP(1), ou en utilisant l'architecture de +construction si \fBCC\fP ou gcc ne sont pas disponibles. Utiliser une seule des +options \fB\-\-host\-arch\fP et \fB\-\-host\-type\fP est suffisant, la valeur de l'une +est utilisée comme valeur par défaut de l'autre. Bien sûr, il est préférable +de n'en préciser qu'une seule, puisque \fBdpkg\-architecture\fP affichera un +avertissement si le choix ne correspond pas à la valeur par défaut. +. +.SH COMMANDES +.TP +\fB\-l\fP, \fB\-\-list\fP +Affiche les variables d'environnement, une par ligne, en utilisant le format +\fIVARIABLE=valeur\fP. C'est l'action par défaut. +.TP +\fB\-e\fP, \fB\-\-equal\fP \fIarchitecture\fP +Vérifie l'égalité d'architectures (depuis dpkg\ 1.13.13). Cela compare +l'architecture Debian en cours (ou celle spécifiée) à \fIarchitecture\fP afin +de vérifier leur égalité. Cette action ne gère pas les architectures +joker. La commande quitte avec un code de retour de \fB0\fP si l'architecture +correspond et de \fB1\fP dans le cas contraire. + +.TP +\fB\-i\fP, \fB\-\-is\fP \fIarchitecture\-joker\fP +Vérifie l'identité des architectures (depuis dpkg\ 1.13.13). Cela compare +l'architecture Debian en cours (ou celle spécifiée) à \fIarchitecture\-joker\fP +(après expansion de celle\-ci) afin de vérifier leur correspondance. La +commande quitte avec un code de retour de \fB0\fP si l'architecture correspond +et de \fB1\fP dans le cas contraire. +.TP +\fB\-q\fP, \fB\-\-query\fP \fInom\-de\-variable\fP +Affiche la valeur d'une seule variable. +.TP +\fB\-s\fP, \fB\-\-print\-set\fP +Produit une commande, qui peut être utilisée pour positionner les variables +d'environnement avec «\ eval\ ». +.TP +\fB\-u\fP, \fB\-\-print\-unset\fP +Affiche une commande similaire à celle produite par \fB\-\-print\-unset\fP, mais +pour supprimer toutes les variables. +.TP +\fB\-c\fP, \fB\-\-command\fP \fIchaîne\-de\-commande\fP +Exécute une \fIchaîne\-de\-commande\fP dans un environnement où toutes les +variables sont positionnées aux valeurs spécifiées. +.TP +\fB\-L\fP, \fB\-\-list\-known\fP +Affiche une liste des architectures valables. Elle peut être restreinte par +une ou plusieurs des options correspondantes \fB\-\-match\-wildcard\fP, +\fB\-\-match\-bits\fP ou \fB\-\-match\-endian\fP (depuis dpkg\ 1.17.14). +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-a\fP, \fB\-\-host\-arch\fP \fIarchitecture\fP +Définit l'architecture Debian en cours. +.TP +\fB\-t\fP, \fB\-\-host\-type\fP \fItype\-de\-système\-gnu\fP +Définit le type de système GNU en cours. +.TP +\fB\-A\fP, \fB\-\-target\-arch\fP \fIarchitecture\fP +Définit l'architecture Debian de la cible (depuis dpkg\ 1.17.14). +.TP +\fB\-T\fP, \fB\-\-target\-type\fP \fItype\-de\-système\-gnu\fP +Définit le type de système GNU de la cible (depuis dpkg\ 1.17.14). +.TP +\fB\-W\fP, \fB\-\-match\-wildcard\fP \fIarchitecture\-joker\fP +Restreindre les architectures listées par \fB\-\-list\-known\fP à celles +correspondant à l'architecture\-joker (depuis dpkg\ 1.17.14). +.TP +\fB\-B\fP, \fB\-\-match\-bits\fP \fIbits\-de\-l'architecture\fP +Restreindre les architectures listées par \fB\-\-list\-known\fP à celles employant +un CPU disposant du nombre de bits indiqués (depuis dpkg\ 1.17.14). Soit +\fB32\fP, soit\ \fB64\fP. +.TP +\fB\-E\fP, \fB\-\-match\-endian\fP \fIboutisme\-d'architecture\fP +Restreindre les architectures listées par \fB\-\-list\-known\fP à celles +correspondant au boutisme spécifié (depuis dpkg\ 1.17.14). Soit \fBlittle\fP, +soit \fBbig\fP. +.TP +\fB\-f\fP, \fB\-\-force\fP +Les valeurs positionnées par les variables d'environnement ayant le même nom +que celles utilisées par les scripts sont prises en compte (c'est\-à\-dire +utilisées par \fBdpkg\-architecture\fP), sauf si cette option est présente. Cela +permet à un utilisateur de surcharger une valeur même lorsque l'appel à +\fBdpkg\-architecture\fP est inclus dans un autre script (par exemple +\fBdpkg\-buildpackage\fP(1)). +. +.SH TERMINOLOGIE +.IP "Machine de construction" 4 +Machine sur laquelle le paquet est construit. +.IP "Machine hôte" 4 +Machine pour laquelle le paquet est construit. +.IP "Machine cible" 4 +La machine pour laquelle le compilateur construit. Cela est nécessaire +uniquement lors de la construction d'une chaîne d'outils de compilation +croisée qui sera construite sur l'architecture de construction, pour être +exécutée sur l'architecture hôte, afin de construire du code pour +l'architecture cible. +.IP "Architecture Debian" 4 +Chaîne de caractères de l'architecture Debian qui spécifie l'emplacement +dans l'archive FTP. Par exemple\ : i386, sparc, hurd\-i386. +.IP "N\-uplet d'architecture Debian" 4 +Un n\-uplet d'architecture Debian est l'architecture pleinement qualifiée +avec tous ses composants énoncés. C'est différent des architectures Debian +en ce que le composant \fIprocesseur\fP n'intègre pas l'\fIABI\fP. Le n\-uplet +actuel a la forme \fIABI\fP\-\fIlibc\fP\-\fIos\fP\-\fIprocesseur\fP. Exemples\ : +base\-gnu\-linux\-amd64, eabihf\-musl\-linux\-arm. +.IP "Architecture Debian joker" 4 +Une architecture Debian joker est une architecture spéciale qui correspond à +toutes les architectures réelles qui en font partie. Il est en général de la +forme d'un n\-uplet d'architecture Debian avec quatre éléments ou moins dont +au moins l'un deux est \fBany\fP. Les éléments manquants du n\-uplet sont +préfixés implicitement par \fBany\fP, et donc les paires suivantes sont +équivalentes. +.nf + \fBany\fP\-\fBany\fP\-\fBany\fP\-\fBany\fP = \fBany\fP + \fBany\fP\-\fBany\fP\-\fIos\fP\-\fBany\fP = \fIos\fP\-\fBany\fP + \fBany\fP\-\fIlibc\fP\-\fBany\fP\-\fBany\fP = \fIlibc\fP\-\fBany\fP\-\fBany\fP +.fi +Exemples\ : linux\-any, any\-i386, hurd\-any, eabi\-any\-any\-arm, musl\-any\-any. +.IP "Type de système GNU" 4 +Chaîne de caractères définissant l'architecture et constituée de deux +parties séparées par un tiret\ : processeur et système. Par exemple\ : +i586\-linux\-gnu, sparc\-linux\-gnu, i386\-gnu, x86_64\-netbsd. +.IP "n\-uplet multiarchitecture" 4 +Type en clair de système GNU, utilisé pour les chemins du système de +fichiers. Ce n\-uplet ne change pas même quand l'ISA de base est incrémentée, +de sorte que les chemins résultants sont stables dans la durée. La seule +différence actuelle avec le type du système GNU est que la partie processeur +pour les systèmes basés sur l'i386 est toujours i386. Exemples\ : +i386\-linux\-gnu, x86_64\-linux\-gnu. Exemple de chemins\ : +/lib/powerpc64le\-linux\-gnu/, /usr/lib/i386\-kfreebsd\-gnu/. +. +.SH "VARIABLES D'ENVIRONNEMENT" +Les variables suivantes sont positionnées par \fBdpkg\-architecture\fP (voir la +section \fBTERMS\fP pour une description du schéma de nommage)\ : +.IP \fBDEB_BUILD_ARCH\fP 4 +Architecture Debian de la machine de construction. +.IP \fBDEB_BUILD_ARCH_ABI\fP 4 +Nom de l'ABI Debian de la machine de construction (depuis dpkg\ 1.18.11). +.IP \fBDEB_BUILD_ARCH_LIBC\fP 4 +Nom de la libc Debian de la machine de construction (depuis dpkg\ 1.18.11). +.IP \fBDEB_BUILD_ARCH_OS\fP 4 +Nom du système Debian de la machine de construction (depuis dpkg\ 1.13.2). +.IP \fBDEB_BUILD_ARCH_CPU\fP 4 +Nom de processeur Debian de la machine de construction (depuis dpkg\ 1.13.2). +.IP \fBDEB_BUILD_ARCH_BITS\fP 4 +Taille de pointeur de la machine de construction (en bits, depuis +dpkg\ 1.15.4). +.IP \fBDEB_BUILD_ARCH_ENDIAN\fP 4 +Boutisme de la machine de construction (petit ou gros, depuis dpkg\ 1.15.4). +.IP \fBDEB_BUILD_GNU_CPU\fP 4 +Partie CPU de \fBDEB_BUILD_GNU_TYPE\fP. +.IP \fBDEB_BUILD_GNU_SYSTEM\fP 4 +Partie «\ système\ » de \fBDEB_BUILD_GNU_TYPE\fP. +.IP \fBDEB_BUILD_GNU_TYPE\fP 4 +Type de système GNU de la machine de construction. +.IP \fBDEB_BUILD_MULTIARCH\fP 4 +Le type en clair de système GNU de la machine de construction, utilisé pour +les chemins du système de fichiers (depuis dpkg\ 1.16.0). +.IP \fBDEB_HOST_ARCH\fP 4 +Architecture Debian de la machine hôte. +.IP \fBDEB_HOST_ARCH_ABI\fP 4 +Nom de l'ABI Debian de la machine hôte (depuis dpkg\ 1.18.11). +.IP \fBDEB_HOST_ARCH_LIBC\fP 4 +Nom de la libc Debian de la machine hôte (depuis dpkg\ 1.18.11). +.IP \fBDEB_HOST_ARCH_OS\fP 4 +Nom du système Debian de la machine hôte (depuis dpkg\ 1.13.2). +.IP \fBDEB_HOST_ARCH_CPU\fP 4 +Nom du processeur Debian de la machine hôte (depuis dpkg\ 1.13.2). +.IP \fBDEB_HOST_ARCH_BITS\fP 4 +Taille de pointeur de la machine hôte (en bits, depuis dpkg\ 1.15.4). +.IP \fBDEB_HOST_ARCH_ENDIAN\fP 4 +Boutisme de la machine hôte (petit ou gros, depuis dpkg\ 1.15.4). +.IP \fBDEB_HOST_GNU_CPU\fP 4 +Partie «\ processeur\ » de \fBDEB_HOST_GNU_TYPE\fP. +.IP \fBDEB_HOST_GNU_SYSTEM\fP 4 +Partie «\ système\ » de \fBDEB_HOST_GNU_TYPE\fP. +.IP \fBDEB_HOST_GNU_TYPE\fP 4 +Type de système GNU de la machine hôte. +.IP \fBDEB_HOST_MULTIARCH\fP 4 +Le type en clair de système GNU de la machine hôte, utilisé pour les chemins +du système de fichiers (depuis dpkg\ 1.16.0). +.IP \fBDEB_TARGET_ARCH\fP 4 +L'architecture Debian de la machine cible (depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_ARCH_ABI\fP 4 +Nom de l'ABI Debian de la machine cible (depuis dpkg\ 1.18.11). +.IP \fBDEB_TARGET_ARCH_LIBC\fP 4 +Nom de la libc Debian de la machine cible (depuis dpkg\ 1.18.11). +.IP \fBDEB_TARGET_ARCH_OS\fP 4 +Nom du système Debian de la machine cible (depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_ARCH_CPU\fP 4 +Nom du processeur Debian de la machine cible (depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_ARCH_BITS\fP 4 +Taille de pointeur de la machine cible (en bits, depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_ARCH_ENDIAN\fP 4 +Boutisme de la machine cible (petit ou gros, depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_GNU_CPU\fP 4 +Partie «\ processeur\ » de \fBDEB_TARGET_GNU_TYPE\fP (depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_GNU_SYSTEM\fP 4 +Partie «\ système\ » de \fBDEB_TARGET_GNU_TYPE\fP (depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_GNU_TYPE\fP 4 +Type du système GNU de la machine cible (depuis dpkg\ 1.17.14). +.IP \fBDEB_TARGET_MULTIARCH\fP 4 +Le type en clair du système GNU de la machine cible, utilisé pour les +chemins du système de fichiers (depuis dpkg\ 1.17.14). +. +.SH FICHIERS +.SS "Tables d'architectures" +Tous ces fichiers sont nécessaires afin que \fBdpkg\-architecture\fP puisse +fonctionner. Leurs emplacements peuvent être modifiés lors du traitement à +l'aide de la variable d'environnement \fBDPKG_DATADIR\fP. Ces tables +contiennent en première ligne un pseudo\-champ de \fBVersion\fP de format pour +indiquer leur format de sorte que les analyseurs peuvent vérifier s'ils les +comprennent, tel que «\ #\ Version=1.0\ ». +.TP +\fI%PKGDATADIR%/table\-processeur\fP +Table des noms de processeurs connus et liaison avec leur nom +GNU. Version\ 1.0 de format (depuis dpkg\ 1.13.2). +.TP +\fI%PKGDATADIR%/table\-système\-exploitation\fP +Table des noms des systèmes d'exploitation connus et liaison avec leurs noms +GNU. Version\ 2.0 de format (depuis dpkg\ 1.18.11). +.TP +\fI%PKGDATADIR%/table\-n\-uplet\fP +Correspondances entre les n\-uplets de l'architecture Debian et les noms des +architectures Debian. Format version\ 1.0 (depuis dpkg\ 1.18.11). +.TP +\fI%PKGDATADIR%/table\-ABI\fP +Table des substituts d'attributs d'ABI d'architecture Debian. Format +version\ 2.0 (depuis dpkg\ 1.18.11). +.SS "Gestion de l'empaquetage" +.TP +\fI%PKGDATADIR%/architecture.mk\fP +Un fragment de fichier Makefile qui définit correctement et exporte toutes +les variables que \fBdpkg\-architecture\fP peut fournir (depuis dpkg\ 1.16.1). +. +.SH EXEMPLES +\fBdpkg\-buildpackage\fP accepte l'option \fB\-a\fP, et la passe à +\fBdpkg\-architecture\fP. Voici d'autres exemples\ : +.IP +CC=i386\-gnu\-gcc dpkg\-architecture \-c debian/rules build +.IP +eval \`dpkg\-architecture \-u\` +.PP +Vérifie si l'architecture en cours (ou celle spécifiée) est identique à une +architecture\ : +.IP +dpkg\-architecture \-elinux\-alpha +.IP +dpkg\-architecture \-amips \-elinux\-mips +.PP +Vérifie si l'architecture en cours (ou celle spécifiée) est un système +Linux\ : +.IP +dpkg\-architecture \-ilinux\-any +.IP +dpkg\-architecture \-ai386 \-ilinux\-any +. +.SS "Utilisation dans debian/rules" +Les variables d'environnement définies par \fBdpkg\-architecture\fP sont +fournies à \fIdebian/rules\fP comme variables pour make (consultez la +documentation de make). Cependant, vous ne devez pas compter là\-dessus +puisque cela empêche les appels manuels à ce script. À la place, vous devez +toujours les initialiser en utilisant \fBdpkg\-architecture\fP avec l'option +\fB\-q\fP. Voici quelques exemples, qui indiquent aussi comment améliorer la +gestion des compilations croisées de votre paquet\ : +.PP +Récupération du type de système GNU et passage à ./configure\ : +.PP +.RS 4 +.nf +DEB_BUILD_GNU_TYPE\ ?= $(shell dpkg\-architecture \-qDEB_BUILD_GNU_TYPE) +DEB_HOST_GNU_TYPE\ ?= $(shell dpkg\-architecture \-qDEB_HOST_GNU_TYPE) +[...] +ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE)) + confflags += \-\-build=$(DEB_HOST_GNU_TYPE) +else + confflags += \-\-build=$(DEB_BUILD_GNU_TYPE) \e + \-\-host=$(DEB_HOST_GNU_TYPE) +endif +[...] +\&./configure $(confflags) +.fi +.RE +.PP +Effectuer une action pour une architecture spécifique\ : +.PP +.RS 4 +.nf +DEB_HOST_ARCH\ ?= $(shell dpkg\-architecture \-qDEB_HOST_ARCH) + +ifeq ($(DEB_HOST_ARCH),alpha) + [...] +endif +.fi +.RE +.PP +Ou, si vous n'avez besoin que de vérifier le type du processeur et du +système, utilisez les variables \fBDEB_HOST_ARCH_CPU\fP ou \fBDEB_HOST_ARCH_OS\fP. +.PP +Veuillez noter qu'il est également possible d'utiliser un fragment externe +de fichier Makefile pour définir correctement toutes les variables que +\fBdpkg\-architecture\fP peut fournir\ : +.PP +.RS 4 +.nf +include %PKGDATADIR%/architecture.mk + +ifeq ($(DEB_HOST_ARCH),alpha) + [...] +endif +.fi +.RE +.PP +Dans tous les cas, il ne faut jamais utiliser \fBdpkg \-\-print\-architecture\fP +pour récupérer les informations relatives à l'architecture pendant la +construction d'un paquet. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_DATADIR\fP +Si cette variable est définie, elle sera utilisée comme répertoire de +données de \fBdpkg\fP où sont placées les tables d'architecture (depuis +dpkg\ 1.14.17). Par défaut «%PKGDATADIR%». +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH NOTES +Tous les noms de commandes et d'options longs ne sont disponibles qu'à +partir de dpkg\ 1.17.17. +. +.SH "VOIR AUSSI" +\fBdpkg\-buildpackage\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-buildflags.man b/man/fr/dpkg-buildflags.man new file mode 100644 index 0000000..f25f208 --- /dev/null +++ b/man/fr/dpkg-buildflags.man @@ -0,0 +1,685 @@ +.\" dpkg manual page - dpkg-buildflags(1) +.\" +.\" Copyright © 2010-2011 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2011 Kees Cook <kees@debian.org> +.\" Copyright © 2011-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-buildflags 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-buildflags \- Renvoie les options de compilation à utiliser pour la +construction du paquet +. +.SH SYNOPSIS +\fBdpkg\-buildflags\fP [\fIoption\fP...] [\fIcommande\fP] +. +.SH DESCRIPTION +\fBdpkg\-buildflags\fP est un script qui permet de récupérer les options de +compilation à utiliser pour la construction d'un paquet. +. +Les drapeaux par défaut sont définis par le distributeur mais peuvent être +étendus ou remplacés de plusieurs façons\ : +.IP 1. +pour tout le système avec \fB%PKGCONFDIR%/buildflags.conf\fP\ ; +.IP 2. +pour l'utilisateur courant avec \fB$XDG_CONFIG_HOME/dpkg/buildflags.conf\fP où +la valeur par défaut de \fB$XDG_CONFIG_HOME\fP est \fB$HOME/.config\fP\ ; +.IP 3. +temporairement par l'utilisateur avec des variables d'environnement (voir +\fBVARIABLES D'ENVIRONNEMENT\fP)\ ; +.IP 4. +dynamiquement par le responsable du paquet avec des variables +d'environnement à l'aide de \fBdebian/rules\fP (voir \fBVARIABLES +D'ENVIRONNEMENT\fP). +.P +Les fichiers de configuration peuvent contenir quatre types de directives\ : +.TP +\fBSET\fP\fI drapeau valeur\fP +Remplace le drapeau \fIdrapeau\fP par la valeur \fIvaleur\fP. +.TP +\fBSTRIP\fP\fI drapeau valeur\fP +Retire du drapeau \fIdrapeau\fP tous les drapeaux de construction listés dans +\fIvaleur\fP. +.TP +\fBAPPEND\fP\fI drapeau valeur\fP +Étend le drapeau \fIdrapeau\fP avec les options indiquées dans \fIvaleur\fP. Une +espace est ajoutée au début de ce qui est ajouté si la valeur actuelle du +drapeau n'est pas vide. +.TP +\fBPREPEND\fP\fI drapeau valeur\fP +Préfixe le drapeau \fIdrapeau\fP avec les options indiquées dans \fIvaleur\fP. Une +espace est ajoutée au début de ce qui est ajouté si la valeur actuelle du +drapeau n'est pas vide. +.P +Les fichiers de configuration peuvent contenir des commentaires sur les +lignes commençant par un dièse (#). Les lignes vides sont également +ignorées. +.SH COMMANDES +.TP +\fB\-\-dump\fP +Affiche sur la sortie standard tous les drapeaux de compilation et leurs +valeurs. Un drapeau par ligne est affiché, suivi de sa valeur, séparée par +le caractère «\ égal\ » («\ \fIdrapeau\fP=\fIvaleur\fP\ »). Il s'agit de l'action par +défaut. +.TP +\fB\-\-list\fP +Affiche la liste des drapeaux gérés par le distributeur actuel (un par +ligne). Voir la section \fBDRAPEAUX GÉRÉS\fP pour plus d'informations sur +chacun d'eux. +.TP +\fB\-\-status\fP +Affiche toute information utile pour expliquer le comportement de +\fBdpkg\-buildflags\fP (depuis dpkg\ 1.16.5)\ : variables d'environnement, +distributeur actuel, état de tous les drapeaux de fonctionnalités. Affiche +également les drapeaux de compilation résultants ainsi que leur origine. + +Cette option est destinée à être utilisée depuis \fBdebian/rules\fP, afin de +garder dans le journal de construction une trace claire des drapeaux de +compilation utilisés. Cela peut être utile pour diagnostiquer des problèmes +qui y seraient liés. +.TP +\fB\-\-export=\fP\fIformat\fP +Affiche sur la sortie standard les commandes qui permettent d'exporter tous +les drapeaux de compilation pour un outil particulier. Si \fIformat\fP n'est +pas spécifié, sa valeur est \fBsh\fP. Seuls les drapeaux de compilation +commençant par une majuscule sont inclus, les autres étant supposés +inadaptés à l'environnement. Formats pris en charge\ : +.RS +.TP +\fBsh\fP +Commandes shell pour définir et exporter tous les drapeaux de compilation +dans l'environnement. Les valeurs drapeau sont protégées et ainsi la sortie +est prête à être évaluée par un shell. +.TP +\fBcmdline\fP +Arguments à passer à la ligne de commande d'un programme de construction +pour utiliser tous les drapeaux de compilation (depuis dpkg\ 1.17.0). Les +valeurs drapeau sont protégées dans la syntaxe du shell. +.TP +\fBconfigure\fP +C'est un ancien alias pour \fBcmdline\fP. +.TP +\fBmake\fP +Directives de make pour définir et exporter tous les drapeaux de compilation +dans l'environnement. La sortie peut être écrite dans un fragment de +Makefile et évaluée en utilisant une directive \fBinclude\fP. +.RE +.TP +\fB\-\-get\fP\fI drapeau\fP +Affiche la valeur de ce drapeau sur la sortie standard. Retourne un code de +sortie \fB0\fP si le drapeau est connu et \fB1\fP s'il est inconnu. +.TP +\fB\-\-origin\fP\fI drapeau\fP +Affiche l'origine de la valeur renvoyée par \fB\-\-get\fP. Retourne un code de +sortie \fB0\fP si le drapeau est connu et \fB1\fP s'il est inconnu. L'origine est +une des valeurs suivantes\ : +.RS +.TP +\fBvendor\fP +le drapeau défini à l'origine par le distributeur est renvoyé\ ; +.TP +\fBsystem\fP +le drapeau est placé ou modifié par un réglage système\ ; +.TP +\fBuser\fP +le drapeau est placé ou modifié par une configuration spécifique à +l'utilisateur\ ; +.TP +\fBenv\fP +le drapeau est placé ou modifié par une configuration spécifique dans +l'environnement. +.RE +.TP +\fB\-\-query\fP +Affiche toute information utile pour expliquer le comportement du +programme\ : distributeur actuel, variables d'environnement, domaines des +fonctionnalités, état de tous les drapeaux de fonctionnalités. Affiche +également les drapeaux de compilation résultants ainsi que leur origine +(depuis dpkg\ 1.19.0). +.IP +Par exemple\ : +.nf + Vendor: Debian + Environment: + DEB_CFLAGS_SET=\-O0 \-Wall + + Area: qa + Features: + bug=no + canary=no + + Area: reproducible + Features: + timeless=no + + Flag: CFLAGS + Value: \-O0 \-Wall + Origin: env + + Flag: CPPFLAGS + Value: \-D_FORTIFY_SOURCE=2 + Origin: vendor +.fi +.TP +\fB\-\-query\-features\fP\fI domaine\fP +Affiche les fonctionnalités activées pour un domaine donné (depuis +dpkg\ 1.16.2). Les seuls domaines reconnus actuellement sur Debian et ses +dérivés sont \fBfuture\fP, \fBqa\fP, \fBreproducible\fP, \fBsanitize\fP et \fBhardening\fP, +voir la section \fBZONES D'OPTION\fP pour plus de détails. Retourne un code de +sortie \fB0\fP si le domaine est connu et \fB1\fP s'il est inconnu. +.IP +L'affichage est dans le format RFC822, avec une section par +fonctionnalité. Par exemple\ : +.IP +.nf + Feature: pie + Enabled: yes + + Feature: stackprotector + Enabled: yes +.fi +.TP +\fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH "DRAPEAUX GÉRÉS" +.TP +\fBCFLAGS\fP +Options du compilateur\ C. La valeur par défaut définie par le distributeur +comporte \fB\-g\fP et le niveau d'optimisation par défaut (\fB\-O2\fP en général, ou +\fB\-O0\fP si la variable d'environnement \fBDEB_BUILD_OPTIONS\fP contient +\fInoopt\fP). +.TP +\fBCPPFLAGS\fP +Options du préprocesseur\ C. Valeur par défaut\ :\ aucune. +.TP +\fBCXXFLAGS\fP +Options du compilateur\ C++. Analogue à \fBCFLAGS\fP. +.TP +\fBOBJCFLAGS\fP +Options du compilateur Objective\ C. Analogue à \fBCFLAGS\fP. +.TP +\fBOBJCXXFLAGS\fP +Options du compilateur Objective\ C++. Analogue à \fBCXXFLAGS\fP. +.TP +\fBGCJFLAGS\fP +Options du compilateur Java GNU (gcj). Un sous\-ensemble de \fBCFLAGS\fP. +.TP +\fBFFLAGS\fP +Options du compilateur Fortran\ 77. Un sous\-ensemble de \fBCFLAGS\fP. +.TP +\fBFCFLAGS\fP +Options du compilateur Fortran\ 9x. Analogue à \fBFFLAGS\fP. +.TP +\fBLDFLAGS\fP +Options passées au compilateur lors du processus de liaison des exécutables +ou des objets partagés (si le linker est appelé directement, alors \fB\-Wl\fP et +\fB,\fP doivent être retirés de ces options). Valeur par défaut\ :\ aucune. +.PP +De nouveaux drapeaux pourront être ajoutés si besoin est (par exemple pour +la prise en charge de nouveaux langages). +. +.SH "ZONES D'OPTION" +.P +Chaque option de zone peut être activée ou désactivée avec les valeurs +\fBDEB_BUILD_OPTIONS\fP et \fBDEB_BUIL_MAINT_OPTIONS\fP de l'espace de variables +d'environnement grâce aux modificateurs «\ \fB+\fP\ » et «\ \fB\-\fP\ ». Par exemple, +pour activer l'option \fBhardening\fP «\ pie\ » et désactiver l'option +«\ fortify\ », il est possible d'indiquer cela dans \fBdebian/rules\fP\ : +.P + export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,\-fortify +.P +L'option spéciale \fBall\fP (valable dans toutes les zones) peut être utilisée +pour activer ou désactiver toutes les options de la zone à la fois. Ainsi, +tout désactiver dans la zone \fBhardening\fP en n'activant que «\ format\ » et +«\ fortify\ » peut être réalisé avec\ : +.P + export DEB_BUILD_MAINT_OPTIONS=hardening=\-all,+format,+fortify +. +.SS future +Plusieurs options de compilation (détaillées ci\-dessous) peuvent être +utilisées pour activer des fonctionnalités qui devraient être activées par +défaut, mais ne peuvent pas l'être pour des raisons de compatibilité avec +les versions précédentes. +.TP +\fBlfs\fP +Ce paramètre (désactivé par défaut) active la prise en charge des gros +fichiers (LFS) sur les architectures 32\ bits où l'ABI n'inclut pas LFS par +défaut, en ajoutant \fB\-D_LARGEFILE_SOURCE \-D_FILE_OFFSET_BITS=64\fP à +\fBCPPFLAGS\fP. +. +.SS qa +Plusieurs options de compilation (détaillées ci\-dessous) peuvent être +utilisées pour détecter des problèmes dans le code source ou dans le système +de construction. +.TP +\fBbug\fP +Ce paramètre (désactivé par défaut) ajoute toutes les options +d'avertissement détectant de façon fiable du code source problématique. Les +avertissements sont fatals. Les seuls drapeaux actuellement gérés sont +\fBCFLAGS\fP et \fBCXXFLAGS\fP avec des drapeaux définis à +\fB\-Werror=array\-bounds\fP, \fB\-Werror=clobbered\fP, +\fB\-Werror=implicit\-function\-declaration\fP et +\fB\-Werror=volatile\-register\-var\fP. +. +.TP +\fBcanary\fP +Ce paramètre (désactivé par défaut) ajoute des options détectrices +«\ canary\ » factices aux drapeaux de construction de telle sorte que les +rapports de compilation permettront de vérifier la façon dont ces drapeaux +se propagent et de repérer toute omission des paramètres de drapeaux +habituels. Les drapeaux actuellement pris en charge sont \fBCPPFLAGS\fP, +\fBCFLAGS\fP, \fBOBJCFLAGS\fP, \fBCXXFLAGS\fP ainsi que \fBOBJCXXFLAGS\fP, avec les +drapeaux définis à \fB\-D__DEB_CANARY_\fP\fIflag\fP_\fIrandom\-id\fP\fB__\fP, et +\fBLDFLAGS\fP paramétré à \fB\-Wl,\-z,deb\-canary\-\fP\fIrandom\-id\fP. +. +.SS sanitize +Plusieurs options de compilation (détaillées ci\-dessous) peuvent être +utilisées pour aider à nettoyer le binaire compilé face aux corruptions de +la mémoire, aux fuites de mémoire, à l'utilisation de mémoire après +libération et à des bogues au comportement indéfini. \fBNote\fP\ : ces options +ne devraient pas être utilisées pour des constructions en production car +elles peuvent réduire la fiabilité du code, réduire la sécurité ou même les +fonctionnalités. +.TP +\fBaddress\fP +Ce paramètre (désactivé par défaut) ajoute \fB\-fsanitize=address\fP à +\fBLDFLAGS\fP et \fB\-fsanitize=address \-fno\-omit\-frame\-pointer\fP à \fBCFLAGS\fP et +\fBCXXFLAGS\fP. +.TP +\fBthread\fP +Ce paramètre (désactivé par défaut) ajoute \fB\-fsanitize=thread\fP à \fBCFLAGS\fP, +\fBCXXFLAGS\fP et \fBLDFLAGS\fP. +.TP +\fBleak\fP +Ce paramètre (désactivé par défaut) ajoute \fB\-fsanitize=leak\fP à +\fBLDFLAGS\fP. Il est automatiquement désactivé si les fonctions \fBaddress\fP ou +\fBthread\fP sont activées, parce qu'elles l'impliquent. +.TP +\fBundefined\fP +Ce paramètre (désactivé par défaut) ajoute \fB\-fsanitize=undefined\fP à +\fBCFLAGS\fP, \fBCXXFLAGS\fP et \fBLDFLAGS\fP. +.SS "compilation renforcée" +Plusieurs options de compilation (détaillées ci\-dessous) peuvent être +utilisées pour accroître la résistance du binaire compilé face aux attaques +par corruption de la mémoire ou fournir des messages d'avertissement +supplémentaires lors de la compilation. Sauf mention contraire (voir +ci\-dessous), ces options sont activées par défaut pour les architectures qui +les gèrent. +.TP +\fBformat\fP +Ce réglage, activé par défaut, ajoute \fB\-Wformat \-Werror=format\-security\fP à +\fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBOBJCFLAGS\fP et \fBOBJCXXFLAGS\fP. Cela provoquera +l'avertissement en cas d'utilisation de chaînes de formatage incorrectes et +échouera si les fonctions de formatage sont utilisées d'une façon qui +présente des risques pour la sécurité. Actuellement, ce réglage crée des +avertissements pour les appels des fonctions \fBprintf\fP et \fBscanf\fP lorsque +la chaîne de formatage n'est pas une chaîne littérale et qu'aucun paramètre +de formatage n'est utilisé (par exemple dans \fBprintf(foo);\fP au lieu de \fB +printf("%s", foo);\fP. Ce type de syntaxe peut créer un problème de sécurité +si la chaîne de formatage vient d'une source non sûre et contient «\ %n\ ». +. +.TP +\fBfortify\fP +Ce réglage, activé par défaut, ajoute \fB\-D_FORTIFY_SOURCE=2\fP à +\fBCPPFLAGS\fP. Lors de la création du code, le compilateur connaît un nombre +important d'informations relatives aux tailles de tampons (quand c'est +possible) et tente alors de remplacer des appels de fonctions avec une +taille illimitée de tampons, peu sûrs, par des appels avec des tampons de +taille limitée. Cette fonctionnalité est particulièrement utile pour du code +ancien et mal écrit. De plus, les chaînes de formatage dans la mémoire +accessible en écriture qui contiennent «\ %n\ » sont bloquées. Si une +application dépend de telles chaînes de formatage, un contournement devra +être mis en place. + +Veuillez noter que pour que cette option fasse effet, la source devra aussi +être compilée avec \fB\-O1\fP ou plus. Si la variable d'environnement +\fBDEB_BUILD_OPTIONS\fP contient \fInoopt\fP, la prise en charge de \fBfortify\fP +sera désactivée du fait des nouveaux avertissements émis par glibc +version\ 2.16 et ultérieure. +.TP +\fBstackprotector\fP +Ce réglage (activé par défaut si stackprotectorstrong n'est pas employé), +ajoute \fB\-fstack\-protector \-\-param=ssp\-buffer\-size=4\fP à \fBCFLAGS\fP, +\fBCXXFLAGS\fP, \fBOBJCFLAGS\fP, \fBOBJCXXFLAGS\fP, \fBGCJFLAGS\fP, \fBFFLAGS\fP et +\fBFCFLAGS\fP. Il ajoute des contrôles liés aux réécritures de piles. Cela +conduit des tentatives d'attaques par injection de code à terminer en +échec. Dans le meilleur des cas, cette protection transforme une +vulnérabilité d'injection de code en déni de service ou en non\-problème +(selon les applications). + +Cette fonctionnalité impose de lier le code à glibc (ou toute autre +bibliothèque fournissant \fB__stack_chk_fail\fP) et doit donc être désactivée +lorsque le code est construit avec \fB\-nostdlib\fP, \fB\-ffreestanding\fP ou +équivalents. +. +.TP +\fBstackprotectorstrong\fP +Ce réglage, activé par défaut, ajoute \fB\-fstack\-protector\-strong\fP à +\fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBOBJCFLAGS\fP, \fBOBJCXXFLAGS\fP, \fBGCJFLAGS\fP, \fBFFLAGS\fP +et \fBFCFLAGS\fP. Il s'agit d'une version renforcée de \fBstackprotector\fP qui +n'affecte pas les performances de manière importante. + +Désactiver \fBstackprotector\fP désactive également ce paramètre. + +Cette fonctionnalité a les même exigences que \fBstackprotector\fP, en plus de +nécessiter gcc\ 4.9 ou plus récent. +. +.TP +\fBrelro\fP +Ce réglage, activé par défaut, ajoute \fB\-Wl,\-z,relro\fP à \fBLDFLAGS\fP. Lors du +chargement du programme, plusieurs parties de la mémoire ELF doivent être +écrites par l'éditeur de liens. Ce réglage indique au chargeur de mettre ces +sections en lecture seule avant de rendre le contrôle au +programme. L'utilisation habituelle de ce réglage est la protection contre +les attaques par réécriture GOT. Si cette option est désactivée, l'option +\fBbindnow\fP sera également désactivée. +. +.TP +\fBbindnow\fP +Ce réglage, désactivé par défaut, ajoute \fB\-Wl,\-z,now\fP à \fBLDFLAGS\fP. Lors du +chargement du programme, tous les symboles dynamiques sont résolus, ce qui +permet au PLT (Procedure Linkage Table) entier d'être en lecture seule (du +fait du réglage \fBrelro\fP ci\-dessus). Cette option ne peut être activée si +\fBrelro\fP ne l'est pas. +. +.TP +\fBpie\fP +Ce réglage (sans option globale par défaut depuis dpkg\ 1.18.23, parce qu'il +est maintenant activé par défaut par gcc dans les architectures Debian +amd64, arm64, armel, armhf, hurd\-i386, i386, kfreebsd\-amd64, kfreebsd\-i386, +mips, mipsel, mips64el, powerpc, ppc64, ppc64el, riscv64, s390x, sparc et +sparc64) ajoute les options requises pour activer ou désactiver PIE +(exécutable indépendant de l'emplacement) au moyen des fichiers de +spécifications de gcc, si nécessaire, selon que gcc injecte sur cette +architecture les drapeaux par lui\-même ou non. Si le réglage est activé et +que gcc injecte les drapeaux, il n'ajoute rien. Si le réglage est activé et +que gcc n'injecte pas les drapeaux, il ajoute \fB\-fPIE\fP (au moyen de +\fI%PKGDATADIR%/pie\-compiler.specs\fP) à \fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBOBJCFLAGS\fP, +\fBOBJCXXFLAGS\fP, \fBGCJFLAGS\fP, \fBFFLAGS\fP et \fBFCFLAGS\fP, et \fB\-fPIE \-pie\fP (au +moyen de \fI%PKGDATADIR%/pie\-link.specs\fP) à \fBLDFLAGS\fP. Si le réglage est +désactivé et que gcc injecte les drapeaux, il ajoute \fB\-fno\-PIE\fP (au moyen +de \fI%PKGDATADIR%/no\-pie\-compile.specs\fP) à \fBCFLAGS\fP, \fBCXXFLAGS\fP, +\fBOBJCFLAGS\fP, \fBOBJCXXFLAGS\fP, \fBGCJFLAGS\fP, \fBFFLAGS\fP et \fBFCFLAGS\fP, et +\fB\-fno\-PIE \-no\-pie\fP (au moyen de \fI%PKGDATADIR%/no\-pie\-link.specs\fP) à +\fBLDFLAGS\fP. + +Les exécutables à position indépendante («\ Position Independent +Executable\ ») permettent d'utiliser la randomisation de l'organisation de +l'espace d'adressage (ASLR\ :\ «\ Address Space Layout Randomization\ »), qui +est gérée par certaines versions du noyau. Bien que ASLR puisse déjà être +mise en œuvre pour les zones de données dans la pile et le tampon (brk et +mmap), les zones de codes doivent être compilées comme indépendantes de la +position. Les bibliothèques partagées font déjà cela (\fB\-fPIC\fP) ce qui +permet automatiquement d'utiliser ASLR. Par contre les régions .text +binaires doivent être construites en mode PIE pour mettre en œuvre ASLR. Une +fois cela réalisé, les attaques ROP («\ Return Oriented Programming\ ») +deviennent plus difficiles car il n'existe pas d'emplacement statique d'où +rebondir pendant une attaque par corruption de la mémoire. + +PIE n'est pas compatible avec \fBfPIC\fP, aussi, en général, des précautions +doivent être prises lors de la construction d'objets partagés. Mais comme +les drapeaux PIE émis sont injectés par des fichiers de spécifications de +gcc, il devrait toujours être sûr de les définir sans condition +indépendamment du type d'objet en train d'être compilé ou lié. + +Les bibliothèques statiques peuvent être utilisées par des programmes ou +d'autres bibliothèques partagées. Selon les drapeaux utilisés pour compiler +tous les objets d'une bibliothèque statique, ces bibliothèques seront +utilisables par divers ensembles d'objets\ : + +.RS +.TP +\fBnone\fP +Ne peut être lié ni à un programme PIE, ni à une bibliothèque partagée. +.TP +\fB\-fPIE\fP +Peut être lié à tout programme, mais pas à une bibliothèque partagée +(recommandé). +.TP +\fB\-fPIC\fP +Peut être lié à tout programme et toute bibliothèque partagée. +.RE + +.IP +S'il est nécessaire de régler ces drapeaux manuellement, en contournant +l'injonction des spécifications de gcc, il y a plusieurs choses à prendre en +compte. Le passage sans condition et de façon explicite de \fB\-fPIE\fP, +\fB\-fpie\fP ou \fB\-pie\fP à un système de construction en utilisant libtool est +sûr dans la mesure où ces drapeaux seront retirés lors de la construction de +bibliothèques partagées. Sinon, sur les projets qui construisent à la fois +des programmes et des bibliothèques partagées, il faudrait s'assurer que, +lors de la construction des bibliothèques partagées, \fB\-fPIC\fP soit toujours +passé en dernier aux drapeaux de compilation tels que \fBCFLAGS\fP (de sorte +qu'il remplace tout \fB\-PIE\fP antérieur), et que \fB\-shared\fP soit passé en +dernier aux drapeaux de création de lien tels que \fBLDFLAGS\fP (de sorte qu'il +remplace tout \fB\-pie\fP antérieur). \fBNote\fP\ : Cela ne devrait pas être +nécessaire avec les mécanismes de spécification de gcc par défaut. + +.IP +De plus, comme la protection PIE est mise en œuvre à l'aide d'un registre +global, certaines architectures privées de registre (mais plus i386 depuis +les optimisations mises en œuvre dans gcc\ >=\ 5) peuvent souffrir de +pertes de performances allant jusqu'à 15\ % sur des charges d'applications +utilisant largement les segments de texte\ ; le plus souvent, cette perte de +performances n’excédera pas\ 1\ %. Pour des architectures offrant plus de +registres globaux (par exemple amd64), cette pénalisation n'existe +pratiquement pas. +.SS reproductible +Les options de compilation (détaillées ci\-dessous) peuvent aider à améliorer +la reproductibilité de la construction ou fournir des messages +d'avertissement supplémentaires lors de la compilation. Sauf mention +contraire (voir ci\-dessous), ces options sont activées par défaut pour les +architectures qui les gèrent. +.TP +\fBtimeless\fP +Ce paramètre, activé par défaut, ajoute \fB\-Wdate\-time\fP à \fBCPPFLAGS\fP. Cela +provoquera des avertissements quand les macros \fB__TIME__\fP, \fB__DATE__\fP et +\fB__TIMESTAMP__\fP sont utilisées. +. +.TP +\fBfixfilepath\fP +Ce paramètre, désactivé par défaut, ajoute +\fB\-ffile\-prefix\-map=\fP\fIBUILDPATH\fP\fB=.\fP à \fBCFLAGS\fP, \fBCXXFLAGS\fP, +\fBOBJCFLAGS\fP, \fBOBJCXXFLAGS\fP, \fBGCJFLAGS\fP, \fBFFLAGS\fP et \fBFCFLAGS\fP où +\fBBUILDPATH\fP est fixé sur le répertoire de plus haut niveau du paquet en +construction. Cela a pour effet de retirer le chemin de construction de tout +fichier généré. + +Si à la fois \fBfixdebugpath\fP et \fBfixfilepath\fP sont définis, cette option a +la priorité parce c'est un sur\-ensemble du premier. +.TP +\fBfixdebugpath\fP +Ce réglage, activé par défaut, ajoute +\fB\-fdebug\-prefix\-map=\fP\fIBUILDPATH\fP\fB=.\fP à \fBCFLAGS\fP, \fBCXXFLAGS\fP, +\fBOBJCFLAGS\fP, \fBOBJCXXFLAGS\fP, \fBGCJFLAGS\fP, \fBFFLAGS\fP et \fBFCFLAGS\fP où +\fBBUILDPATH\fP est fixé sur le répertoire de plus haut niveau du paquet en +construction. Cela a pour effet de retirer le chemin de construction de tous +les symboles de débogage générés. +. +.SH ENVIRONNEMENT +Deux jeux de variables d'environnement effectuent les mêmes opérations. Le +premier (DEB_\fIdrapeau\fP_\fIopération\fP) ne devrait jamais être utilisé depuis +\fBdebian/rules\fP. Il est destiné aux utilisateurs souhaitant recompiler le +paquet source avec des drapeaux de compilation modifiés. Le second +(DEB_\fIdrapeau\fP_MAINT_\fIopération\fP) ne doit être utilisé que dans +\fBdebian/rules\fP par les responsables de paquets pour modifier les drapeaux +de compilation concernés. +.TP +\fBDEB_\fP\fIdrapeau\fP\fB_SET\fP +.TQ +\fBDEB_\fP\fIdrapeau\fP\fB_MAINT_SET\fP +Cette variable permet de forcer la valeur renvoyée pour le \fIdrapeau\fP +indiqué. +.TP +\fBDEB_\fP\fIdrapeau\fP\fB_STRIP\fP +.TQ +\fBDEB_\fP\fIdrapeau\fP\fB_MAINT_STRIP\fP +Cette variable peut être utilisée pour fournir une liste d'options (séparées +par des espaces) qui seront retirées du jeu de drapeaux renvoyé pour le +\fIdrapeau\fP indiqué. +.TP +\fBDEB_\fP\fIdrapeau\fP\fB_APPEND\fP +.TQ +\fBDEB_\fP\fIdrapeau\fP\fB_MAINT_APPEND\fP +Cette variable permet d'ajouter des options à la valeur renvoyée pour le +\fIdrapeau\fP indiqué. +.TP +\fBDEB_\fP\fIdrapeau\fP\fB_PREPEND\fP +.TQ +\fBDEB_\fP\fIdrapeau\fP\fB_MAINT_PREPEND\fP +Cette variable permet de préfixer la valeur renvoyée pour le \fIdrapeau\fP +indiqué par des options supplémentaires. +.TP +\fBDEB_BUILD_OPTIONS\fP +.TQ +\fBDEB_BUILD_MAINT_OPTIONS\fP +Ces variables peuvent être utilisées par un utilisateur ou un responsable de +paquet pour activer ou désactiver différentes options de zone qui affectent +les drapeaux de construction. La variable \fBDEB_BUILD_MAINT_OPTIONS\fP +outrepasse tous les paramètres de la zone d'options +\fBDEB_BUILD_OPTIONS\fP. Voir la section \fBZONES D'OPTION\fP pour plus de +détails. +.TP +\fBDEB_VENDOR\fP +Ce réglage définit l'éditeur («\ vendor\ ») actuel. Si cette valeur est vide, +le contenu du fichier \fB%PKGCONFDIR%/origins/default\fP est utilisé. +.TP +\fBDEB_BUILD_PATH\fP +Cette variable configure le chemin de construction (depuis dpkg\ 1.18.8) à +utiliser avec des fonctions telles que \fBfixdebugpath\fP de telle sorte +qu'elles soient contrôlées par l'appelant. Cette variable est actuellement +spécifique à Debian et à ses dérivés. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH FICHIERS +.SS "Fichiers de configuration." +.TP +\fB%PKGCONFDIR%/buildflags.conf\fP +Fichier de configuration pour l'ensemble du système. +.TP +\fB$XDG_CONFIG_HOME/dpkg/buildflags.conf\fP ou +.TQ +\fB$HOME/.config/dpkg/buildflags.conf\fP +Fichier de configuration propre à l'utilisateur +.SS "Gestion de l'empaquetage" +.TP +\fB%PKGDATADIR%/buildflags.mk\fP +Fragment de fichier Makefile qui chargera (et facultativement exportera) +dans les variables (depuis dpkg\ 1.16.1) tous les drapeaux pris en charge par +\fBdpkg\-buildflags\fP. +. +.SH EXEMPLES +Pour passer des drapeaux de compilation à une commande de compilation dans +un Makefile\ : +.PP +.RS 4 +.nf +$(MAKE) $(shell dpkg\-buildflags \-\-export=cmdline) + +\&./configure $(shell dpkg\-buildflags \-\-export=cmdline) +.fi +.RE +.PP +Pour définir les drapeaux de compilation dans un script shell ou un fragment +de shell, on peut utiliser \fBeval\fP pour interpréter la sortie et exporter +les drapeaux dans l'environnement\ : +.PP +.RS 4 +.nf +eval "$(dpkg\-buildflags \-\-export=sh)" && make +.fi +.RE +.PP +ou définir les paramètres de position à passer à la commande\ : +.PP +.RS 4 +.nf +eval "set \-\- $(dpkg\-buildflags \-\-export=cmdline)" +for dir in a b c; do (cd $dir && ./configure "$@" && make); done +.fi +.RE +. +.SS "Utilisation dans debian/rules" +Il faut appeler \fBdpkg\-buildflags\fP ou inclure \fBbuildflags.mk\fP à partir du +fichier \fBdebian/rules\fP pour obtenir les drapeaux de compilation nécessaires +à passer au système de construction. Veuillez noter que les anciennes +versions de \fBdpkg\-buildpackage\fP (antérieures à dpkg\ 1.16.1) exportaient ces +drapeaux automatiquement. Néanmoins, il est déconseillé de dépendre de ce +comportement parce qu'il casse l'appel manuel de \fBdebian/rules\fP. +.PP +Pour les paquets avec des systèmes de construction du style autoconf, il est +possible de passer les options appropriées à configure ou \fBmake\fP(1) +directement, comme vu ci\-dessus. +.PP +Pour d'autres systèmes de construction ou si on souhaite un contrôle +extrêmement précis sur le choix et la position où sont passés les drapeaux, +\fB\-\-get\fP peut être utilisé. Autrement, il est possible d'inclure +\fBbuildflags.mk\fP qui s'occupe de l'appel de \fBdpkg\-buildflags\fP et du +placement des drapeaux de compilation dans les variables de make. +.PP +Si vous voulez exporter tous les drapeaux de compilation dans +l'environnement (où le système de construction peut les récupérer)\ : +.PP +.RS 4 +.nf +DPKG_EXPORT_BUILDFLAGS = 1 +include %PKGDATADIR%/buildflags.mk +.fi +.RE +.PP +Pour un contrôle supplémentaire sur ce qui est exporté, vous pouvez exporter +manuellement les variables (puisque aucune n'est exportée par défaut)\ : +.PP +.RS 4 +.nf +include %PKGDATADIR%/buildflags.mk +export CPPFLAGS CFLAGS LDFLAGS +.fi +.RE +.PP +Et enfin, vous pouvez bien sûr passer manuellement les drapeaux aux +commandes\ : +.PP +.RS 4 +.nf +include %PKGDATADIR%/buildflags.mk +build\-arch: +\& $(CC) \-o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) +.fi +.RE +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-buildpackage.man b/man/fr/dpkg-buildpackage.man new file mode 100644 index 0000000..1da153b --- /dev/null +++ b/man/fr/dpkg-buildpackage.man @@ -0,0 +1,575 @@ +.\" dpkg manual page - dpkg-buildpackage(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2007-2008 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2008-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2008-2012 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-buildpackage 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-buildpackage \- Construire depuis les sources des paquets binaires ou +sources +. +.SH SYNOPSIS +\fBdpkg\-buildpackage\fP [\fIoption\fP...] +. +.SH DESCRIPTION +\fBdpkg\-buildpackage\fP est un programme qui permet d'automatiser la +construction d'un paquet Debian. Il comporte les étapes suivantes\ : +.IP \fB1.\fP 3 +Préparation de l'environnement de compilation par positionnement de diverses +variables d'environnement (voir \fBVARIABLES D'ENVIRONNEMENT\fP), exécution du +point d'entrée \fBinit\fP et appel de \fBdpkg\-source \-\-before\-build\fP (sauf si +\fB\-T\fP ou \fB\-\-target\fP ont été utilisés). +.IP \fB2.\fP 3 +Contrôle des dépendances de construction et des conflits de construction +(non effectué si \fB\-d\fP ou \fB\-\-no\-check\-builddeps\fP sont utilisés). +.IP \fB3.\fP 3 +Si une ou plusieurs cibles particulières ont été indiquées avec les options +\fB\-T\fP ou \fB\-\-target\fP, appel de ces cibles et arrêt. Dans le cas contraire, +exécution du point d'entrée \fBpreclean\fP et appel de \fBfakeroot debian/rules +clean\fP pour nettoyage de l'arborescence source (sauf si \fB\-nc\fP ou +\fB\-\-no\-pre\-clean\fP ont été utilisés). +.IP \fB4.\fP 3 +Exécution du point d'entrée \fBsource\fP et appel de \fBdpkg\-source \-b\fP pour +créer le paquet source (si une construction \fBsource\fP a été demandée avec +\fB\-\-build\fP ou des options équivalentes). +.IP \fB5.\fP 3 +Exécution du point d'entrée \fBbuild\fP et appel de \fBdebian/rules\fP +\fIbuild\-target\fP, puis exécution du point d'entrée \fBbinary\fP suivie de +\fBfakeroot debian/rules\fP \fIbinary\-target\fP (sauf si une construction source +seule a été demandée avec \fB\-\-build=source\fP ou des options +équivalentes). Noter que \fIbuild\-target\fP et \fIbinary\-target\fP sont soit +\fBbuild\fP et \fBbinary\fP (cas par défaut, ou si une construction \fBany\fP et +\fBall\fP a été demandée avec \fB\-\-build\fP ou des options équivalentes), soit +\fBbuild\-arch\fP et \fBbinary\-arch\fP (si une construction \fBany\fP et pas \fBall\fP a +été demandée avec \fB\-\-build\fP ou des options équivalentes), soit +\fBbuild\-indep\fP et \fBbinary\-indep\fP (si une construction \fBall\fP et pas \fBany\fP +a été demandée avec \fB\-\-build\fP ou des options équivalentes). +.IP \fB6.\fP 3 +Exécution du point d'entrée \fBbuildinfo\fP et appel de \fBdpkg\-genbuildinfo\fP +pour créer un fichier \fB.buildinfo\fP. De nombreuses options de +\fBdpkg\-buildpackage\fP sont passées à \fBdpkg\-genbuildinfo\fP. +.IP \fB7.\fP 3 +Exécution du point d'entrée \fBchanges\fP et appel de \fBdpkg\-genchanges\fP pour +créer un fichier \fB.changes\fP. Le nom du fichier \fB.changes\fP dépendra du type +de construction et sera aussi spécifique que nécessaire mais pas plus\ ; pour +une construction qui inclut \fBany\fP, le nom sera +\fInom\-de\-source\fP\fB_\fP\fIversion\-binaire\fP\fB_\fP\fIarchitecture\fP\fB.changes\fP, ou +pour une construction qui inclut \fBall\fP, le nom sera +\fInom\-de\-source\fP\fB_\fP\fIversion\-binaire\fP\fB_\fP\fBall.changes\fP, ou pour une +construction qui inclut \fBsource\fP, le nom sera +\fInom\-de\-source\fP\fB_\fP\fIversion\-source\fP\fB_\fP\fBsources.changes\fP. De nombreuses +options de \fBdpkg\-buildpackage\fP sont passées à \fBdpkg\-genchanges\fP. +.IP \fB8.\fP 3 +Exécution du point d'entrée \fBpostclean\fP et si \fB\-tc\fP ou \fB\-\-post\-clean\fP +sont utilisés, appel de \fBfakeroot debian/rules clean\fP à nouveau. +.IP \fB9.\fP 3 +Appel de \fBdpkg\-source \-\-after\-build\fP. +.IP \fB10.\fP 3 +Exécution du point d'entrée \fBcheck\fP et appel d'un contrôleur de paquet pour +le fichier \fB.changes\fP (dans le cas où une commande est spécifiée dans +\fBDEB_CHECK_COMMAND\fP ou avec \fB\-\-check\-command\fP). +.IP \fB11.\fP 3 +Exécution du point d'entrée \fBsign\fP et appel de \fBgpg2\fP ou de \fBgpg\fP (à +condition que ce ne soit pas une construction pour UNRELEASED, ou si +\fB\-\-no\-sign\fP est spécifié), pour signature des fichiers \fB.dsc\fP (sauf si +\fB\-us\fP ou si \fB\-\-unsigned\-source\fP sont spécifiés), \fB.buildinfo\fP (sauf si +\fB\-ui\fP, \fB\-\-unsigned\-buildinfo\fP, \fB\-uc\fP ou \fB\-\-unsigned\-changes\fP sont +spécifiés) et \fB.changes\fP (sauf si \fB\-uc\fP ou \fB\-\-unsigned\-changes\fP sont +spécifiés). +.IP \fB12.\fP 3 +Exécution du point d'entrée \fBdone\fP. +. +.SH OPTIONS +Toutes les options longues peuvent être spécifiées à la fois sur la ligne +de commande et dans les fichiers de configuration utilisateur et de système +\fBdpkg\-buildpackage\fP. Chaque ligne du fichier de configuration est soit une +option (identique à une option en ligne de commande mais sans tiret), soit +un commentaire (si elle commence par «\ \fB#\fP\ »). + +.TP +\fB\-\-build=\fP\fItype\fP +Indique le \fItype\fP de construction à partir d'une liste de composants +séparés par des virgules (depuis dpkg\ 1.18.5). Passé à \fBdpkg\-genchanges\fP. + +Les valeurs autorisées sont\ : +.RS +.TP +\fBsource\fP +Construit le paquet source. Note\ : quand cette valeur est utilisée toute +seule et si ce que vous voulez est seulement (re)construire le paquet source +à partir d'une arborescence des sources propre, l'utilisation directe de +\fBdpkg\-source\fP est toujours une meilleure option dans la mesure où cela ne +demande pas l'installation de dépendances de construction qui sont sinon +nécessaires pour pouvoir appeler la cible \fBclean\fP. +.TP +\fBany\fP +Construit les paquets binaires spécifiques à l'architecture. +.TP +\fBall\fP +Construit les paquets binaires indépendants de l'architecture. +.TP +\fBbinary\fP +Construit les paquets binaires particuliers et indépendants de +l'architecture. C'est un alias de \fBany,all\fP. +.TP +\fBfull\fP +Construction complète. C'est un alias de \fBsource,any,all\fP, et il est +identique au cas par défaut où aucune option de construction n'est indiquée. +.RE +.TP +\fB\-g\fP +Équivalent de \fB\-\-build=source,all\fP (depuis dpkg\ 1.17.11). +.TP +\fB\-G\fP +Équivalent de \fB\-\-build=source,any\fP (depuis dpkg\ 1.17.11). +.TP +\fB\-b\fP +Équivalent de \fB\-\-build=binary\fP ou \fB\-\-build=any,all\fP. +.TP +\fB\-B\fP +Équivalent de \fB\-\-build=any\fP +.TP +\fB\-A\fP +Équivalent de \fB\-\-build=all\fP. +.TP +\fB\-S\fP +Équivalent à \fB\-\-build=source\fP. +.TP +\fB\-F\fP +Équivalent de \fB\-\-build=full\fP, \fB\-\-build=source,binary\fP ou +\fB\-\-build=source,any,all\fP (depuis dpkg\ 1.15.8). +.TP +\fB\-\-target=\fP\fIcible\fP[,...] +.TQ +\fB\-\-target \fP\fIcible\fP[,...] +.TQ +\fB\-T\fP, \fB\-\-rules\-target=\fP\fIcible\fP +Appelle \fBdebian/rules\fP \fIcible\fP une fois par cible spécifiée, après avoir +mis en place l'environnement de construction (sauf pour appeler +\fBdpkg\-source \-\-before\-build\fP), puis interrompt le processus de construction +(depuis dpkg\ 1.15.0, option longue depuis dpkg\ 1.18.8, pris en charge de +multiples cibles depuis dpkg\ 1.18.16). Si \fB\-\-as\-root\fP est également +utilisé, la commande sera exécutée avec les privilèges du superutilisateur +(voir \fB\-\-root\-command\fP). Noter que les cibles connues dont l'exécution par +root est imposée n'ont pas besoin de cette option (c'est\-à\-dire les cibles +\fBclean\fP, \fBbinary\fP, \fBbinary\-arch\fP et \fBbinary\-indep\fP). +.TP +\fB\-\-as\-root\fP +N'est utile qu'avec \fB\-\-target\fP (depuis dpkg\ 1.15.0). Impose d'exécuter la +cible avec les privilèges du superutilisateur. +.TP +\fB\-si\fP +.TQ +\fB\-sa\fP +.TQ +\fB\-sd\fP +.TQ +\fB\-v\fP\fIversion\fP +.TQ +\fB\-C\fP\fIdescription\-des\-changements\fP +.TQ +\fB\-m\fP, \fB\-\-release\-by=\fP\fIadresse\-du\-responsable\fP +.TQ +\fB\-e\fP, \fB\-\-build\-by=\fP\fIadresse\-du\-responsable\fP +Passé tel quel à \fBdpkg\-genchanges\fP. Voir sa page de manuel. +.TP +\fB\-a\fP, \fB\-\-host\-arch\fP \fIarchitecture\fP +Précise l'architecture Debian pour laquelle on construit (option longue +depuis dpkg\ 1.17.17). L'architecture de la machine sur laquelle on construit +est automatiquement déterminée\ ; c'est aussi l'architecture par défaut de la +machine hôte. +.TP +\fB\-t\fP, \fB\-\-host\-type\fP \fItype\-de\-système\-gnu\fP +Précise le type de système GNU pour lequel construire (option longue depuis +dpkg\ 1.17.17). Il peut être utilisé à la place de \fB\-\-host\-arch\fP ou en tant +que complément afin de remplacer le type de système GNU par défaut de +l'architecture Debian hôte. +.TP +\fB\-\-target\-arch\fP \fIarchitecture\fP +Précise l'architecture Debian pour laquelle les binaires compilés vont +construire (depuis dpkg\ 1.17.17). La valeur par défaut est l'architecture de +la machine hôte. +.TP +\fB\-\-target\-type\fP \fItype\-de\-système\-gnu\fP +Précise le type de système GNU pour lequel les binaires compilés vont +construire (depuis dpkg\ 1.17.17). Il peut être utilisé à la place de +\fB\-\-target\-arch\fP ou en tant que complément afin de remplacer le type de +système GNU par défaut de l'architecture Debian cible. +.TP +\fB\-P\fP, \fB\-\-build\-profiles=\fP\fIprofil\fP[\fB,\fP...] +Précise le ou les profils que l'on construit, sous forme d'une liste séparée +par des virgules (depuis dpkg\ 1.17.2, option longue depuis dpkg\ 1.18.8). Le +comportement par défaut est de construire pour un profil non +spécifique. Cela les définit également (sous la forme d'une liste séparée +par des espaces) en tant que variable d'environnement \fBDEB_BUILD_PROFILES\fP, +ce qui permet, par exemple, au fichiers \fBdebian/rules\fP d'utiliser cette +information pour des constructions conditionnelles. +.TP +\fB\-j\fP, \fB\-\-jobs\fP[\fIjobs\fP|\fBauto\fP] +Nombre de processus simultanés qui peuvent être exécutés, nombre de +processus correspondant au nombre de processeurs en ligne si \fBauto\fP est +indiquée (depuis dpkg\ 1.17.10), ou un nombre illimité si \fIjobs\fP n'est pas +indiqué, équivalent à l'option \fBmake\fP(1) du même nom (depuis dpkg\ 1.14.7, +option longue depuis dpkg\ 1.18.8). S'ajoutera tout seul à la variable +d'environnement MAKEFLAGS, afin que les appels suivants de make en héritent, +forçant donc le paramètre parallèle sur l'empaquetage (et éventuellement le +système de construction amont s'il utilise make) indépendamment de leur +prise en charge des constructions parallèle, ce qui pourrait provoquer des +échecs de construction. Ajoute aussi \fBparallel=\fP\fIjobs\fP ou \fBparallel\fP à la +variable d'environnement \fBDEB_BUILD_OPTIONS\fP ce qui permet aux fichiers +debian/rules d'utiliser cette information pour leurs propres besoins. La +valeur de \fBj\fP remplacera les options \fBparallel=\fP\fIjobs\fP ou \fBparallel\fP +dans la variable d'environnement \fBDEB_BUILD_OPTIONS\fP. Notez que la valeur +\fBauto\fP sera remplacée par le nombre réel de processeurs actuellement +actifs, et par conséquent ne sera pas transmise à aucun processus fils. Si +le nombre de processeurs en ligne ne peut pas être déduit, alors le code +utilisera par défaut une exécution sérielle (depuis dpkg\ 1.18.15), même si +cela ne devrait arriver que sur des systèmes exotiques et non pris en +charge. +.TP +\fB\-J\fP, \fB\-\-jobs\-try\fP[=\fItâches\fP|\fBauto\fP] +Cette option (depuis dpkg\ 1.18.2, option longue depuis dpkg\ 1.18.8) est +équivalente à l'option \fB\-j\fP sauf qu'elle ne configure pas la variable +d'environnement \fBMAKEFLAGS\fP et, à ce titre, il est plus sûr de l'utiliser +avec tous les paquets y compris ceux qui ne sont pas sécurisés pour une +construction parallèle. + +Le comportement par défaut est \fBauto\fP (depuis dpkg\ 1.18.11). Fixer le +nombre de tâches à\ 1 rétablira un comportement sériel. +.TP +\fB\-D\fP, \fB\-\-check\-builddeps\fP +Vérification des dépendances de constructions et des conflits\ ; se termine +en cas de problèmes (option longue depuis dpkg\ 1.18.8). C'est le +comportement par défaut. +.TP +\fB\-d\fP, \fB\-\-no\-check\-builddeps\fP +Pas de vérification des dépendances de constructions et des conflits (option +longue depuis dpkg\ 1.18.8). +.TP +\fB\-\-ignore\-builtin\-builddeps\fP +Pas de vérification des dépendances de constructions internes et des +conflits (depuis dpkg\ 1.18.2). Il s'agit des dépendances de construction +implicites spécifiques à la distribution habituellement requises dans un +environnement de construction, c'est l'ensemble de paquets appelé +Build\-Essentiel. +.TP +\fB\-\-rules\-requires\-root\fP +Pas de prise en compte du champ \fBRules\-Requires\-Root\fP, retour à l'ancienne +valeur par défaut (depuis dpkg\ 1.19.1). +.TP +\fB\-nc\fP, \fB\-\-no\-pre\-clean\fP +Pas de nettoyage de l'arborescence des sources avant la construction (option +longue depuis dpkg\ 1.18.8). Implique \fB\-b\fP si aucune des options \fB\-F\fP, +\fB\-g\fP, \fB\-G\fP, \fB\-B\fP, \fB\-A\fP ou \fB\-S\fP n'est utilisée). Implique \fB\-d\fP avec +\fB\-S\fP (depuis dpkg\ 1.18.0). +.TP +\fB\-\-pre\-clean\fP +Nettoyage de l'arborescence des sources avant la construction (depuis +dpkg\ 1.18.8). C'est le comportement par défaut. +.TP +\fB\-tc\fP, \fB\-\-post\-clean\fP +Nettoyage de l'arborescence des sources (en utilisant +\fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP \fBdebian/rules clean\fP) après la +construction du paquet (option longue depuis dpkg\ 1.18.8). +.TP +\fB\-\-no\-post\-clean\fP +Pas de nettoyage de l'arborescence des sources après la construction du +paquet (depuis dpkg\ 1.19.1). C'est le comportement par défaut. +.TP +\fB\-r\fP, \fB\-\-root\-command=\fP\fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP +Quand \fBdpkg\-buildpackage\fP doit exécuter une partie du processus de +construction en tant que root, il préfixe la commande exécutée par +\fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP, si une a été spécifiée (option +longue depuis dpkg\ 1.18.8). Si ce n'est pas le cas alors \fBfakeroot\fP est +utilisé par défaut. \fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP doit débuter +par le nom d'un programme accessible depuis \fBPATH\fP et avoir comme arguments +le nom de la commande réelle avec les arguments qu'elle doit +prendre. \fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP peut recevoir des +paramètres (ils doivent être séparés par des espaces) mais aucun +métacaractère de l'interpréteur de commandes. Classiquement +\fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP devrait être \fBfakeroot\fP, +\fBsudo\fP, \fBsuper\fP ou \fBreally\fP. \fBsu\fP ne va pas, puisque ce programme peut +uniquement utiliser l'interpréteur de commandes de l'utilisateur avec +l'option \fB\-c\fP au lieu de passer directement les arguments à la commande qui +doit être exécutée. +.TP +\fB\-R\fP, \fB\-\-rules\-file=\fP\fIfichier\-rules\fP +Construire un paquet Debian implique généralement l'invocation de +\fBdebian/rules\fP comme une commande avec de nombreux paramètres standard +(depuis dpkg\ 1.14.17, option longue depuis dpkg\ 1.18.8). Avec cette option, +il est possible d'utiliser un autre programme à utiliser pour la +construction de paquet (ainsi que ses paramètres séparés par des +espaces). Une autre utilisation possible est d'exécuter le fichier rules +standard avec un autre programme make (par exemple en utilisant +\fB/usr/local/bin/make \-f debian/rules\fP comme \fIfichier\-rules\fP). +.TP +\fB\-\-check\-command=\fP\fIcommande\-contrôleur\fP +Commande utilisée pour vérifier le fichier \fB.changes\fP lui\-même et tout +objet construit référencé dans le fichier (depuis dpkg\ 1.17.6). La commande +peut recevoir comme argument le nom de chemin de \fB.changes\fP. Cette commande +est en général \fBlintian\fP. +.TP +\fB\-\-check\-option=\fP\fIopt\fP +Passer l'option \fIopt\fP à \fIcommande\-contrôleur\fP indiquée par +\fBDEB_CHECK_COMMAND\fP ou \fB\-\-check\-command\fP (depuis dpkg\ 1.17.6). Peut être +utilisé plusieurs fois. +.TP +\fB\-\-hook\-\fP\fInom\-de\-point\-d'entrée\fP\fB=\fP\fIcommande\-de\-point\-d'entrée\fP +Définir le code spécifié de l'interpréteur de commandes +\fIcommande\-de\-point\-d'entrée\fP comme point d'entrée \fInom\-de\-point\-d'entré\fP +qui sera exécuté aux moments spécifiés par les étapes d'exécution (depuis +dpkg\ 1.17.6). Les points d'entrée seront toujours exécutés même si l'action +suivante n'est pas effectuée (sauf pour le point d'entrée \fBbinary\fP). Tous +les points d'entrée seront exécutés dans le répertoire source dépaqueté. + +Note\ : Les points d'entrée sont susceptibles d'affecter le processus de +construction et provoquer des échecs de construction si leurs commandes +échouent, donc attention aux conséquences inattendues. + +Les \fInom\-de\-point\-d'entrée\fP actuellement pris en charge sont\ : + +\fBinit preclean source build binary buildinfo changes postclean check sign +done\fP + +La \fIcommande\-point\-d'entrée\fP gère les chaînes de formatage de substitution +suivantes, qui lui sont appliquées avant exécution\ : + +.RS +.TP +\fB%%\fP +Un caractère % seul. +.TP +\fB%a\fP +Une valeur booléenne (0\ ou\ 1) qui indique si l'action suivante est +effectuée. +.TP +\fB%p\fP +Nom du paquet source. +.TP +\fB%v\fP +La version du paquet source. +.TP +\fB%s\fP +La version du paquet source (sans l'«\ epoch\ »). +.TP +\fB%u\fP +La version amont. +.RE +.TP +\fB\-\-buildinfo\-option=\fP\fIopt\fP +Passer l'option \fIopt\fP à \fBdpkg\-genbuildinfo\fP (depuis dpkg\ 1.18.11). Peut +être utilisé plusieurs fois. +.TP +\fB\-p\fP, \fB\-\-sign\-command=\fP\fIcommande\-de\-signature\fP +Quand \fBdpkg\-buildpackage\fP doit exécuter GPG pour signer un fichier source +de contrôle (\fB.dsc\fP) ou un fichier \fB.changes\fP, il exécute +\fIcommande\-de\-signature\fP (recherchée dans \fBPATH\fP si nécessaire) au lieu de +\fBgpg2\fP ou \fBgpg\fP (option longue depuis +dpkg\ 1.18.1). \fIcommande\-de\-signature\fP reçoit tous les paramètres +qu'auraient reçu \fBgpg2\fP ou \fBgpg\fP. \fIcommande\-de\-signature\fP ne devra pas +contenir d'espace ni aucun métacaractère de l'interpréteur de commandes. +.TP +\fB\-k\fP, \fB\-\-sign\-key=\fP\fIidentifiant\-clé\fP +Préciser une clé pour la signature des paquets (option longue depuis +dpkg\ 1.18.8). +.TP +\fB\-us\fP, \fB\-\-unsigned\-source\fP +Ne pas signer le paquet source (option longue depuis dpkg\ 1.18.8). +.TP +\fB\-ui\fP, \fB\-\-unsigned\-buildinfo\fP +Ne pas signer le fichier \fB.buildinfo\fP (depuis dpkg\ 1.18.19). +.TP +\fB\-uc\fP, \fB\-\-unsigned\-changes\fP +Ne signer ni le fichier \fB.buildinfo\fP, ni le fichier \fB.changes\fP (option +longue depuis dpkg\ 1.18.8). +.TP +\fB\-\-no\-sign\fP +Aucune signature de fichier, y compris du paquet source, du fichier +\&\fB.buildinfo\fP et du fichier \fB.changes\fP (depuis dpkg\ 1.18.20). +.TP +\fB\-\-force\-sign\fP +Forcer la signature des fichiers produits (depuis dpkg\ 1.17.0) +indépendamment de \fB\-us\fP, \fB\-\-unsigned\-source\fP, \fB\-ui\fP, +\fB\-\-unsigned\-buildinfo\fP, \fB\-uc\fP, \fB\-\-unsigned\-changes\fP ou d'autres +heuristiques internes. +.TP +\fB\-sn\fP +.TQ +\fB\-ss\fP +.TQ +\fB\-sA\fP +.TQ +\fB\-sk\fP +.TQ +\fB\-su\fP +.TQ +\fB\-sr\fP +.TQ +\fB\-sK\fP +.TQ +\fB\-sU\fP +.TQ +\fB\-sR\fP +.TQ +\fB\-i\fP, \fB\-\-diff\-ignore\fP[=\fIexpression\-rationnelle\fP] +.TQ +\fB\-I\fP, \fB\-\-tar\-ignore\fP[=\fImotif\fP] +.TQ +\fB\-z\fP, \fB\-\-compression\-level\fP=\fIniveau\fP +.TQ +\fB\-Z\fP, \fB\-\-compression\fP=\fIcompression\fP +Chaîne passée telle quelle à \fBdpkg\-source\fP. Voir la page de manuel +correspondante. +.TP +\fB\-\-source\-option=\fP\fIopt\fP +Passer l'option \fIopt\fP à \fBdpkg\-source\fP (depuis dpkg\ 1.15.6). Peut être +utilisé plusieurs fois. +.TP +\fB\-\-changes\-option=\fP\fIopt\fP +Passer l'option \fIopt\fP à \fBdpkg\-genchanges\fP (depuis dpkg\ 1.15.6). Peut être +utilisé plusieurs fois. +.TP +\fB\-\-admindir\fP=\fIrépertoire\fP +.TQ +\fB\-\-admindir \fP\fIrép\fP +Changer l'endroit où se trouve la base de données de \fBdpkg\fP (depuis +dpkg\ 1.14.0). Par défaut, c'est \fI%ADMINDIR%\fP. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.SS "Environnement externe" +.TP +\fBDEB_CHECK_COMMAND\fP +Si cette option est utilisée, elle le sera comme commande pour contrôler le +fichier \fB.changes\fP (depuis dpkg\ 1.17.6). Remplacée par l'option +\fB\-\-check\-command\fP. +.TP +\fBDEB_SIGN_KEYID\fP +Si cette option est utilisée, elle le sera pour la signature des fichiers +\&\fB.changes\fP et \fB.dsc\fP (depuis dpkg\ 1.17.2). Remplacée par l'option +\fB\-\-sign\-key\fP. +.TP +\fBDEB_BUILD_OPTIONS\fP +Si cette option est utilisée, elle contiendra une liste séparée par des +espaces d'options qui pourraient affecter le processus de construction dans +\fIdebian/rules\fP et le comportement de certaines commandes de dpkg. + +La variable \fBDEB_CHECK_COMMAND\fP sera ignorée avec \fBnocheck\fP. Avec +\fBparallel=\fP\fIN\fP les tâches parallèles seront fixées à \fIN\fP, remplacée par +l'option \fB\-\-jobs\-try\fP. +.TP +\fBDEB_BUILD_PROFILES\fP +Si cette option est utilisée, elle sera utilisée comme profil(s) de +construction actif(s) pour le paquet à construire (depuis +dpkg\ 1.17.2). C'est une liste séparée par des espaces de noms de +profil. Cette option est outrepassée par l'option \fB\-P\fP. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). + +.SS "Environnement interne" +Même si \fBdpkg\-buildpackage\fP exporte certaines variables, \fBdebian/rules\fP ne +doit pas dépendre de leur présence, mais doit préférablement utiliser +l'interface correspondante pour retrouver les valeurs nécessaires, parce que +ce fichier est le point d'entrée principal pour la construction des paquets +et son exécution autonome devrait être prise en charge. + +.TP +\fBDEB_BUILD_*\fP +.TQ +\fBDEB_HOST_*\fP +.TQ +\fBDEB_TARGET_*\fP +\fBdpkg\-architecture\fP est lancé avec les paramètres de \fB\-a\fP et \fB\-t\fP. Toute +variable retournée par l'option \fB\-s\fP est intégrée dans l'environnement de +construction. +.TP +\fBDEB_RULES_REQUIRES_ROOT\fP +Cette variable est fixée à la valeur obtenue du champ \fBRules\-Requires\-Root\fP +ou de la ligne de commande. Lorsqu'elle est configurée, ce sera une valeur +valable pour le champ \fBRules\-Requires\-Root\fP. Elle est utilisée pour +indiquer à \fBdebian/rules\fP si la spécification \fBrootless\-builds.txt\fP est +prise en charge. +.TP +\fBDEB_GAIN_ROOT_CMD\fP +Cette valeur est fixée à \fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP si le +champ \fBRules\-Requires\-Root\fP est fixé à une valeur différente de \fBno\fP ou +\fBbinary\-targets\fP. +.TP +\fBSOURCE_DATE_EPOCH\fP +Cette valeur est fixée à l'horodatage d'Unix depuis «\ l'epoch\ » de la +dernière entrée de \fIdebian/changelog\fP, si elle n'a pas déjà été définie. +. +.SH FICHIERS +.TP +\fI%PKGCONFDIR%/buildpackage.conf\fP +Fichier de configuration pour l'ensemble du système +.TP +\fI$XDG_CONFIG_HOME/dpkg/buildpackage.conf\fP ou +.TQ +\fI$HOME/.config/dpkg/buildpackage.conf\fP +Fichier de configuration propre à l'utilisateur +. +.SH NOTES +.SS "Les drapeaux de compilation ne sont plus exportés." +Entre les versions\ 1.14.17 et\ 1.16.1, \fBdpkg\-buildpackage\fP exportait les +drapeaux de compilation (\fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBFFLAGS\fP, \fBCPPFLAGS\fP et +\fBLDFLAGS\fP) avec les valeurs que renvoyait \fBdpkg\-buildflags\fP. Cela n'est +plus le cas. +.SS "Cibles construites par défaut" +\fBdpkg\-buildpackage\fP utilise les cibles \fBbuild\-arch\fP et \fBbuild\-indep\fP +depuis dpkg\ 1.16.2. Ces cibles sont donc obligatoires. Cependant, pour +éviter de casser les paquets existants et faciliter la transition, si le +paquet source ne construit pas à la fois les paquets binaires indépendants +et dépendants de l'architecture (depuis dpkg\ 1.18.8), la cible \fBbuild\fP sera +utilisée par défaut si \fBmake \-f debian/rules \-qn\fP \fIbuild\-target\fP renvoie +\fB2\fP comme code de retour. +.SH BOGUES +On devrait pouvoir mettre des espaces et des métacaractères du shell et les +arguments initiaux de \fIcommande\-pour\-obtenir\-privilèges\-de\-root\fP et +\fIcommande\-de\-signature\fP. +. +.SH "VOIR AUSSI" +.ad l +\fBdpkg\-source\fP(1), \fBdpkg\-architecture\fP(1), \fBdpkg\-buildflags\fP(1), +\fBdpkg\-genbuildinfo\fP(1), \fBdpkg\-genchanges\fP(1), \fBfakeroot\fP(1), +\fBlintian\fP(1), \fBgpg2\fP(1), \fBgpg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-checkbuilddeps.man b/man/fr/dpkg-checkbuilddeps.man new file mode 100644 index 0000000..2a52cad --- /dev/null +++ b/man/fr/dpkg-checkbuilddeps.man @@ -0,0 +1,111 @@ +.\" dpkg manual page - dpkg-checkbuilddeps(1) +.\" +.\" Copyright © 2001 Joey Hess <joeyh@debian.org> +.\" Copyright © 2007-2013, 2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2008-2011 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-checkbuilddeps 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-checkbuilddeps \- Vérifier les dépendances et les conflits de +construction +. +.SH SYNOPSIS +\fBdpkg\-checkbuilddeps\fP [\fIoption\fP...] [\fIfichier\-control\fP] +. +.SH DESCRIPTION +Ce programme vérifie si les dépendances et les conflits de construction +listés dans le fichier control existent dans les paquets installés sur le +système. S'il en existe, il les affiche et se termine avec un code de retour +différent de \fB0\fP. +.P +Par défaut, le fichier \fIdebian/control\fP est lu, mais un autre nom de +fichier peut être indiqué sur la ligne de commande. +. +.SH OPTIONS +.TP +\fB\-\-admindir\fP=\fIrépertoire\fP +Changer l'endroit où se trouve la base de données de \fBdpkg\fP (depuis +dpkg\ 1.14.0). Par défaut, c'est \fI%ADMINDIR%\fP. +.TP +\fB\-A\fP +Ignore les lignes \fBBuild\-Depends\-Arch\fP et \fBBuild\-Conflicts\-Arch\fP (depuis +dpkg\ 1.16.4). À utiliser lorsque seuls des paquets indépendants d'une +architecture seront construits ou à combiner avec \fB\-B\fP si seul un paquet +source est construit. +.TP +\fB\-B\fP +Ignore les lignes \fBBuild\-Depends\-Indep\fP et \fBBuild\-Conflicts\-Indep\fP. À +utiliser lorsque seuls des paquets dépendants de l'architecture sont +construits ou à combiner avec \fB\-A\fP si seul un paquet source est construit. +.TP +\fB\-I\fP +Ignore les dépendances et les conflits de construction internes (depuis +dpkg\ 1.18.2). Ce sont les dépendances implicites qui sont habituellement +demandées sur une distribution particulière, c'est l'ensemble de paquets +appelé Build\-Essentiel. +.TP +\fB\-d \fP\fIchaine\-des\-dépendances\-pour\-la\-construction\fP +.TP +\fB\-c \fP\fIchaîne\-des\-conflits\-de\-construction\fP +Utilise les dépendances et conflits de construction donnés au lieu de ceux +indiqués dans le fichier \fIdebian/control\fP (depuis dpkg\ 1.14.17). +.TP +\fB\-a \fP\fIarch\fP +Vérifie les dépendances et conflits de construction en supposant que le +paquet décrit dans le fichier de contrôle doit être construit pour +l'architecture hôte indiquée au lieu de celle du système (depuis +dpkg\ 1.16.2). +.TP +\fB\-P \fP\fIprofil\fP[\fB,\fP...] +Vérifie les dépendances et conflits de construction en supposant que le +paquet décrit dans le fichier de contrôle doit être construit pour le ou les +profils donnés (depuis dpkg\ 1.17.2). L'argument est une liste séparée par +des virgules des noms de profil. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDEB_BUILD_PROFILES\fP +Si cette option est utilisée, elle sera utilisée comme profil(s) de +construction actif(s) pour le paquet à construire. C'est une liste séparée +par des espaces de noms de profil. Cette option est outrepassée par l'option +\fB\-P\fP. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-deb.man b/man/fr/dpkg-deb.man new file mode 100644 index 0000000..ce895b9 --- /dev/null +++ b/man/fr/dpkg-deb.man @@ -0,0 +1,294 @@ +.\" dpkg manual page - dpkg-deb(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 1999 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2007-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-deb 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-deb \- Outil pour la manipulation des archives (.deb) des paquets Debian +. +.SH SYNOPSIS +\fBdpkg\-deb\fP [\fIoptions\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBdpkg\-deb\fP crée un paquet, dépaquette une archive ou donne des +renseignements sur les archives Debian +.PP +\fBdpkg\fP sert à installer ou à supprimer des paquets sur le système. +.PP +Il est possible d'exécuter \fBdpkg\-deb\fP en appelant \fBdpkg\fP avec les options +de \fBdpkg\-deb\fP. \fBdpkg\fP comprend que \fBdpkg\-deb\fP est appelé et le lance. +.PP +Pour la plupart des commandes recevant un argument d'entrée d'archive, +l'archive peut être lue à partir de l'entrée standard si le nom d'archive +est donné sous la forme d'un caractère moins («\fB\-\fP») unique\ ; sinon, +l'absence de prise en charge sera documentée dans leurs descriptions de +commande respectives. +. +.SH COMMANDES +.TP +\fB\-b\fP, \fB\-\-build\fP \fIrépertoire\-binaire\fP [\fIarchive\fP|\fIrépertoire\fP] +Crée une archive Debian avec l'arborescence contenue dans +\fIrépertoire\-binaire\fP. \fIrépertoire\-binaire\fP doit posséder un +sous\-répertoire \fBDEBIAN\fP qui contient les fichiers de contrôle tels que le +fichier «\ control\ » lui\-même. Ce répertoire \fIn'apparaît pas\fP dans l'archive +de l'arborescence du paquet binaire\ ; mais les fichiers qu'il contient sont +mis dans la zone de contrôle du paquet binaire. + +À moins de préciser \fB\-\-nocheck\fP, \fBdpkg\-deb\fP lit \fBDEBIAN/control\fP et +l'analyse. Il cherche dans le fichier les erreurs de syntaxe et d'autres +problèmes existants\ ; puis il affiche le nom du paquet binaire qu'il +construit. \fBdpkg\-deb\fP vérifie aussi les permissions des scripts du +responsable et des autres fichiers qu'il trouve dans le répertoire de +contrôle \fBDEBIAN\fP. + +Quand aucune \fIarchive\fP n'est donnée, \fBdpkg\-deb\fP écrit le paquet +dans\fIrépertoire\-binaire\fP\fB.deb\fP. + +Si l'archive qui doit être créée existe déjà, elle est remplacée. + +Quand le second argument est un répertoire, \fBdpkg\-deb\fP écrira dans le +fichier \fIrépertoire\fP\fB/\fP\fIpaquet\fP\fB_\fP\fIversion\fP\fB_\fP\fIarch\fP\fB.deb\fP. Quand un +répertoire cible est précisé à la place d'un fichier, l'option \fB\-\-nocheck\fP +ne doit pas être utilisée (puisque \fBdpkg\-deb\fP a besoin de lire et +d'analyser le fichier de contrôle du paquet pour connaître le nom de fichier +à utiliser). +.TP +\fB\-I\fP, \fB\-\-info\fP \fIarchive\fP [\fInom\-fichier\-control\fP...] +Donne des renseignements sur une archive de paquet binaire. + +Quand aucun argument \fIfichier\-control\fP n'est précisé, un résumé du contenu +du paquet ainsi que son fichier «\ control\ » sont affichés. + +Quand un argument \fIfichier\-control\fP est précisé, \fBdpkg\-deb\fP affiche les +éléments dans l'ordre d'apparition\ ; quand l'un des éléments n'est pas +présent, il affiche un message d'erreur sur «\ stderr\ » et quitte avec un +code égal à \fB2\fP. +.TP +\fB\-W\fP, \fB\-\-show\fP \fIarchive\fP +Cette option donne des informations sur l'archive d'un paquet binaire selon +le format spécifié par l'argument \fB\-\-showformat\fP. Le format par défaut +affiche le nom et la version du paquet sur une seule ligne, séparés par une +tabulation. +.TP +\fB\-f\fP, \fB\-\-field\fP \fIarchive\fP [\fInom\-du\-champ\-de\-control\fP...] +Extrait les renseignements du fichier «\ control\ » de l'archive du paquet +binaire. + +Quand aucun \fInom\-du\-champ\-de\-control\fP n'est précisé, le fichier «\ control\ » +est affiché en entier. + +Quand il y en a un, \fBdpkg\-deb\fP affiche ses éléments en suivant leur ordre +d'apparition dans le fichier «\ control\ ». Quand il y a plus d'un argument +\fInom\-champ\-control\fP, \fBdpkg\-deb\fP fait précéder chacun par le nom de son +champ (puis par un «\ deux\-points\ » et une espace). + +L'absence des champs demandés ne provoque pas de message d'erreur. +.TP +\fB\-c\fP, \fB\-\-contents\fP \fIarchive\fP +Liste la partie arborescence des fichiers d'une archive de paquet. Elle est +actuellement produite dans le format généré par un listing verbeux de +\fBtar\fP. +.TP +\fB\-x\fP, \fB\-\-extract\fP \fIarchive répertoire\fP +Extrait l'arborescence des fichiers d'un paquet archive dans le répertoire +spécifié. + +Il faut remarquer que l'extraction d'un paquet dans le répertoire root \fIne +produit pas\fP une installation correcte\ ! Utilisez \fBdpkg\fP pour +l'installation des paquets. + +\fIrépertoire\fP est créé si nécessaire (mais pas ses répertoires parents) et +ses permissions sont modifiées pour correspondre au contenu du paquet. +.TP +\fB\-X\fP, \fB\-\-vextract\fP \fIarchive répertoire\fP +Comme \fB\-\-extract\fP (\fB\-x\fP) avec \fB\-\-verbose\fP (\fB\-v\fP), ce qui affiche la +liste des fichiers au fur et à mesure qu'ils sont extraits. +.TP +\fB\-R\fP, \fB\-\-raw\-extract\fP \fIarchive répertoire\fP +Extrait l'arborescence des fichiers d'un paquet archive dans le répertoire +spécifié et les fichiers d'information de contrôle dans un sous\-répertoire +nommé \fBDEBIAN\fP de ce répertoire (depuis dpkg\ 1.16.1). + +Le répertoire cible est créé si nécessaire (mais pas ses répertoires +parents). + +L'archive d'entrée n'est pas actuellement traitée de façon séquentielle, +aussi, sa lecture à partir de l'entrée standard («\ \fB\-\fP\ ») n'est \fBpas\fP +prise en charge. +.TP +\fB\-\-ctrl\-tarfile\fP \fIarchive\fP +Extrait les données de contrôle d'un paquet binaire et les envoie sur la +sortie standard dans le format propre à la commande \fBtar\fP (depuis +dpkg\ 1.17.14). En combinant cette option avec la commande \fBtar\fP(1), on peut +ainsi extraire un fichier de contrôle précis d'une archive de +paquet. L'archive d'entrée sera toujours traitée séquentiellement. +.TP +\fB\-\-fsys\-tarfile\fP \fIarchive\fP +Extrait les données de l'arborescence d'un paquet binaire et les envoie sur +la sortie standard dans le format propre à la commande \fBtar\fP. En combinant +cette option avec la commande \fBtar\fP(1), on peut ainsi extraire un fichier +précis d'une archive de paquet. L'archive d'entrée sera toujours traitée +séquentiellement. +.TP +\fB\-e\fP, \fB\-\-control\fP \fIarchive\fP [\fIrépertoire\fP] +Extrait les fichiers de contrôle d'une archive de paquet dans le répertoire +spécifié. + +Quand aucun répertoire n'est précisé, on utilise un sous\-répertoire +\fBDEBIAN\fP du répertoire actuel. + +Le répertoire cible est créé si nécessaire (mais pas ses répertoires +parents). +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-\-showformat=\fP\fIformat\fP +Cette option sert à spécifier le format de sortie de l'option \fB\-\-show\fP. Ce +format sera utilisé pour chaque paquet listé. + +Cet argument est une chaîne qui peut référencer tout champ avec la forme +«\ ${\fIfield\-name\fP}\ »\ ; une liste des champs valables peut être facilement +produite avec l'option \fB\-I\fP sur le même paquet. Une explication complète +des options de formatage (avec les séquences d'échappement et les espaces +entre les champs) se trouve dans la page \fBdpkg\-query\fP(1), option +\fB\-\-showformat\fP. + +Par défaut, la valeur de ce champ est «\ ${Package}\et${Version}\en\ ». +.TP +\fB\-z\fP\fIniveau_compression\fP +Indique le niveau de compression à fournir au logiciel de compression appelé +en sous\-main lors de la compression du paquet. La valeur par défaut est\ 9 +pour gzip et\ 6 pour xz. Les valeurs possibles sont les entiers compris +entre\ 0 et\ 9\ : 0\ correspond à aucune compression pour gzip. Avant la +version\ 1.16.2, la valeur\ 0 correspondait à «\ aucune compression\ » pour tous +les logiciels de compression. +.TP +\fB\-S\fP\fIstratégie\-compression\fP +Indique la stratégie de compression à fournir au logiciel de compression +appelé en sous\-main lors de la construction du paquet (depuis +dpkg\ 1.16.2). Les valeurs autorisées sont \fBnone\fP (depuis dpkg\ 1.16.4), +\fBfiltered\fP, \fBhuffman\fP, \fBrle\fP et \fBfixed\fP pour gzip (depuis dpkg\ 1.17.0) +et \fBextreme\fP pour xz. +.TP +\fB\-Z\fP\fItype_compression\fP +Indique le type de compression à utiliser lors de la construction d'un +paquet. Les valeurs autorisées sont \fBgzip\fP, \fBxz\fP (depuis dpkg\ 1.15.6) et +\fBnone\fP (\fBxz\fP est la valeur par défaut). +.TP +\fB\-\-[no\-]uniform\-compression\fP +Indique que les mêmes paramètres de compression doivent être utilisés pour +tous les membres de l'archive (c'est\-à\-dire \fBcontrol.tar\fP et \fBdata.tar\fP\ ; +depuis dpkg\ 1.17.6). Sinon, seul le membre \fBdata.tar\fP utilisera ces +paramètres. \fBnone\fP, \fBgzip\fP et \fBxz\fP sont les seuls types de compression +pris en charge pour cette option d'uniformité (depuis dpkg\ 1.19.0). La +compression uniforme est l'option par défaut (depuis dpkg\ 1.19.0). +.TP +\fB\-\-root\-owner\-group\fP +Fixe le propriétaire et le groupe de chaque entrée dans les données de +l'arborescence du système de fichiers à root avec l'identité\ 0 (depuis +dpkg\ 1.19.0). + +\fBNote\fP\ : cette option peut être utile pour les constructions sans root +(voir \fIrootless\-builds.txt\fP) mais ne devrait \fBpas\fP être utilisée si les +entrées ont un propriétaire ou un groupe qui n'est pas root. Leur prise en +charge sera ajoutée plus tard sous la forme d'un méta\-manifeste. +.TP +\fB\-\-deb\-format=\fP\fIformat\fP +Indique la version du format d'archive utilisé lors de la construction +(depuis dpkg\ 1.17.0). Les valeurs autorisées sont \fB2.0\fP pour le nouveau +format et \fB0.939000\fP pour l'ancien (la valeur par défaut est \fB2.0\fP). + +L'ancien format d'archive, moins facilement compris par les outils +non\-Debian, est maintenant dépassé. On l'utilise seulement quand on +construit des paquets qui doivent être analysés par des versions de dpkg +plus anciennes que la version\ 0.93.76 (septembre 1995), qui fut produite +uniquement pour le format «\ i386 a.out\ ». +.TP +\fB\-\-nocheck\fP +Empêche les vérifications normales de \fBdpkg\-deb \-\-build\fP quant au contenu +proposé d'une archive. De cette façon, on peut construire n'importe quelle +archive, aussi défectueuse soit\-elle. +.TP +\fB\-v\fP, \fB\-\-verbose\fP +Active l'affichage bavard (depuis dpkg\ 1.16.1). Cela n'affecte actuellement +que \fB\-\-extract\fP et le rend analogue à \fB\-\-vextract\fP. +.TP +\fB\-D\fP, \fB\-\-debug\fP +Permet les messages de débogage. Ce n'est pas très intéressant. +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +L'action demandée s'est correctement déroulée. +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande +non valable, ou interactions avec le système, telles que des accès à la base +de données, des allocations de mémoire,\ etc. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBTMPDIR\fP +Si cette option est utilisée, \fBdpkg\-deb\fP l'utilisera comme répertoire pour +créer les fichiers et répertoires temporaires. +.TP +\fBSOURCE_DATE_EPOCH\fP +Si cette option est utilisée, elle sera utilisée comme horodatage (en +seconde à partir de «\ l'epoch\ ») dans le conteneur \fBar\fP(5) de \fBdeb\fP(5), et +pour fixer le «\ mtime\ » dans les entrées du fichier \fBtar\fP(5). +. +.SH NOTES +N'essayez pas d'installer un logiciel avec \fBdpkg\-deb\fP\ ! Vous devez utiliser +\fBdpkg\fP pour être sûr que tous ses fichiers sont correctement mis en place, +que les scripts du paquet sont exécutés et que son contenu et son état sont +enregistrés. +. +.SH BOGUES +\fBdpkg\-deb \-I\fP \fIpaquet1\fP\fB.deb\fP \fIpaquet2\fP\fB.deb\fP se trompe. + +Il n'existe pas d'authentification des fichiers \fB.deb\fP. Il n'existe même +pas de système de somme de contrôle immédiat. Les outils de haut niveau +comme APT gèrent l'authentification des paquets \fB.deb\fP récupérés depuis un +dépôt donné et la plupart des paquets fournissent désormais une somme de +contrôle MD5 créée par debian/rules. Cependant, cela n'est pas directement +géré par les outils de plus bas niveau. +. +.SH "VOIR AUSSI" +\fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg\fP(1), \fBdselect\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-distaddfile.man b/man/fr/dpkg-distaddfile.man new file mode 100644 index 0000000..8ec9ee3 --- /dev/null +++ b/man/fr/dpkg-distaddfile.man @@ -0,0 +1,81 @@ +.\" dpkg manual page - dpkg-distaddfile(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-distaddfile 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-distaddfile \- Ajouter une entrée au fichier debian/files. +. +.SH SYNOPSIS +\fBdpkg\-distaddfile\fP [\fIoptions\fP...]\fI fichier section priorité\fP +. +.SH DESCRIPTION +\fBdpkg\-distaddfile\fP ajoute une entrée pour un fichier dans \fBdebian/files\fP. + +Il prend trois arguments sans option, à savoir le nom du fichier, la section +et la priorité, pour le fichier \fB.changes\fP. + +Le nom du fichier sera indiqué relativement au répertoire dans lequel +\fBdpkg\-genchanges\fP s'attend à trouver les fichiers, habituellement \fB..\fP, +plutôt que relativement au répertoire dans lequel est exécuté +\fBdpkg\-distaddfile.\fP +. +.SH OPTIONS +.TP +\fB\-f\fP\fIfichier/liste\-des\-fichiers\fP +Lit ou écrit la liste des fichiers qui doivent être envoyés vers l'archive +dans ce fichier plutôt que dans le fichier \fBdebian/files\fP. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH FICHIERS +.TP +\fBdebian/files\fP +La liste des fichiers créés qui seront installés sur le +serveur. \fBdpkg\-distaddfile\fP peut être utilisé pour ajouter des fichiers +supplémentaires. +. +.SH "VOIR AUSSI" +.ad l +\fBdeb\-src\-files\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-divert.man b/man/fr/dpkg-divert.man new file mode 100644 index 0000000..06ae340 --- /dev/null +++ b/man/fr/dpkg-divert.man @@ -0,0 +1,207 @@ +.\" dpkg manual page - dpkg-divert(1) +.\" +.\" Copyright © 1995 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 1999 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2004 Scott James Remnant <keybuk@debian.org> +.\" Copyright © 2007-2013, 2015-2018 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-divert 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-divert \- Remplacer la version d'un fichier contenu dans un paquet. +. +.SH SYNOPSIS +\fBdpkg\-divert\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBdpkg\-divert\fP sert à créer et à mettre à jour la liste des détournements. +.PP +Le \fIdétournement\fP de fichier est un moyen d'obliger \fBdpkg\fP(1) à installer +un fichier non pas dans l'emplacement prévu mais dans un autre. Les scripts +des paquets Debian se servent du détournement pour déplacer les fichiers qui +créent des conflits. Les administrateurs s'en servent, lors de +l'installation d'une version plus récente d'un paquet, pour remplacer les +fichiers de configuration de certains paquets ou bien à chaque fois que des +fichiers (qui ne sont pas des «\ conffiles\ ») doivent être préservés par +\fBdpkg\fP. +.sp +.SH COMMANDES +.TP +[\fB\-\-add\fP] \fIfichier\fP +Ajoute un détournement pour \fIfichier\fP. Le fichier n'est pas renommé +actuellement, voir \fB\-\-rename\fP. +.TP +\fB\-\-remove\fP\fI fichier\fP +Supprime un détournement pour \fIfichier\fP. Le fichier n'est pas renommé +actuellement, voir \fB\-\-rename\fP. +.TP +\fB\-\-list\fP \fImotif\-global\fP +Liste les détournements qui correspondent à \fImotif\-global\fP. +.TP +\fB\-\-listpackage\fP\fI fichier\fP +Affiche le nom du paquet qui détourne \fIfichier\fP (depuis +dpkg\ 1.15.0). Affiche LOCAL si \fIfichier\fP est détourné localement et +n'affiche rien si \fIfichier\fP n'est pas détourné. +.TP +\fB\-\-truename\fP\fI fichier\fP +Affiche le vrai nom d'un fichier détourné. +. +.SH OPTIONS +.TP +\fB\-\-admindir\fP\fI répertoire\fP +Définit le répertoire d'administration comme \fIrépertoire\fP. Par défaut c'est +«\ \fI%ADMINDIR%\fP\ ». +.TP +\fB\-\-instdir\fP \fIrépertoire\fP +Définit le répertoire d'installation qui désigne le répertoire où les +paquets sont installés (depuis dpkg\ 1.19.2). Par défaut c'est «\ \fI/\fP\ ». +.TP +\fB\-\-root\fP \fIrépertoire\fP +Définit le répertoire root à \fBdirectory\fP, ce qui définit le répertoire +d'installation à «\ \fIrépertoire\fP\ » et le répertoire d'administration à +«\ \fIrépertoire\fP\fB%ADMINDIR%\fP\ » (depuis dpkg\ 1.19.2). +.TP +\fB\-\-divert\fP\fI détourner\-dans\fP +\fIdétourner\-dans\fP est l'emplacement vers lequel les versions de \fIfichier\fP, +tel qu'il est donné par d'autres paquets, seront détournées. +.TP +\fB\-\-local\fP +Indique que toutes les versions de ce fichier sont détournées. Cela signifie +qu'il n'y a pas d'exception et quel que soit le paquet installé, ce fichier +sera détourné. Un administrateur peut par exemple installer une version +modifiée localement. +.TP +\fB\-\-package\fP\fI paquet\fP +\fIpaquet\fP est le nom du paquet dont la copie de \fIfichier\fP ne sera pas +détournée. Autrement dit, \fIfichier\fP sera détourné sauf s'il appartient à +\fIpaquet\fP. +.TP +\fB\-\-quiet\fP +Mode silencieux, pas de bavardage. +.TP +\fB\-\-rename\fP +Met en fait le fichier de côté. Quand le fichier de destination existe, +\fBdpkg\-divert\fP interrompt l'opération. C'est le comportement courant utilisé +pour les détournements de fichiers à partir de l'ensemble de paquets +non\-\fBEssential\fP (voir \fB\-\-no\-rename\fP pour plus de détails). +.TP +\fB\-\-no\-rename\fP +Indique que le fichier ne doit pas être renommé lors de l'ajout ou du +retrait d'un détournement de la base de données (depuis dpkg\ 1.19.1). Cela +est destiné au détournement de fichiers de l'ensemble de paquets +\fBessential\fP, où la disparition temporaire du fichier original n'est pas +acceptable, car il rend non fonctionnel le système. C'est le comportement +par défaut, mais cela changera durant le cycle de dpkg\ 1.20.x. +.TP +\fB\-\-test\fP +Mode de test, ne modifie rien réellement, montre seulement. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +L'action demandée s'est correctement déroulée. +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande +non valable, ou interactions avec le système, telles que des accès à la base +de données, des allocations de mémoire,\ etc. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_ROOT\fP +Si cette variable est positionnée et que les options \fB\-\-admindir\fP ou +\fB\-\-root\fP ne sont pas précisées, ce répertoire sera utilisé comme répertoire +racine du système de fichiers (depuis dpkg\ 1.19.2). +.TP +\fBDPKG_ADMINDIR\fP +Si cette variable est positionnée et que les options \fB\-\-admindir\fP ou +\fB\-\-root\fP ne sont pas précisées, ce répertoire sera utilisé comme répertoire +de données pour \fBdpkg\fP. +.TP +\fBDPKG_MAINTSCRIPT_PACKAGE\fP +Si cette variable est positionnée et que les options \fB\-\-local\fP et +\fB\-\-package\fP ne le sont pas, \fBdpkg\-divert\fP en utilisera la valeur comme nom +de paquet. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +. +.SH FICHIERS +.TP +\fI%ADMINDIR%/diversions\fP +Ce fichier contient la liste des détournements en œuvre sur le système. Il +se trouve dans le répertoire d'administration de \fBdpkg\fP, avec d'autres +fichiers importants comme \fIstatus\fP ou \fIavailable\fP. +.br +Note\ : \fBdpkg\-divert\fP préserve l'ancienne copie de ce fichier, avec +l'extension \fI\-old\fP, avant de la remplacer par la nouvelle. +. +.SH NOTES +Pour l'ajout, le défaut est \fB\-\-local\fP et \fB\-\-divert\fP +\fIoriginal\fP\fB.distrib\fP. Pour la suppression, \fB\-\-package\fP ou \fB\-\-local\fP et +\fB\-\-divert\fP doivent correspondre quand ils sont précisés. + +On ne peut pas détourner des répertoires avec \fBdpkg\-divert\fP. + +Il faut faire attention quand une bibliothèque partagée est +détournée. \fBldconfig\fP(8) crée un lien symbolique à partir du champ +DT_SONAME embarqué dans la bibliothèque. \fBldconfig\fP ne connaît pas les +détournements (seul \fBdpkg\fP le fait), et si une bibliothèque détournée +possède le même SONAME que la bibliothèque non détournée, le lien symbolique +peut pointer en fin de compte sur la bibliothèque détournée. +. +.SH EXEMPLES +Pour détourner toutes les copies de \fI/usr/bin/example\fP vers +\fI/usr/bin/example.foo\fP, c'est\-à\-dire demander aux paquets qui fournissent +\fI/usr/bin/example\fP de l'installer dans \fI/usr/bin/example.foo\fP, en +effectuant le changement de nom si nécessaire\ : +.HP +dpkg\-divert \-\-divert /usr/bin/example.foo \-\-rename /usr/bin/example +.PP +Pour supprimer ce détournement\ : +.HP +dpkg\-divert \-\-rename \-\-remove /usr/bin/example + +.PP +Pour détourner n'importe quel paquet qui veut installer \fI/usr/bin/example\fP +dans \fI/usr/bin/example.foo\fP, sauf votre propre paquet \fIwibble\fP\ : +.HP +dpkg\-divert \-\-package wibble \-\-divert /usr/bin/example.foo \-\-rename +/usr/bin/example +.PP +Pour supprimer ce détournement\ : +.HP +dpkg\-divert \-\-package wibble \-\-rename \-\-remove /usr/bin/example +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-genbuildinfo.man b/man/fr/dpkg-genbuildinfo.man new file mode 100644 index 0000000..cbbb48e --- /dev/null +++ b/man/fr/dpkg-genbuildinfo.man @@ -0,0 +1,170 @@ +.\" dpkg manual page - dpkg-genbuildinfo(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ian@chiark.chu.cam.ac.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2008-2010 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2006-2016 Guillem Jover <guillem@debian.org> +.\" Copyright © 2015 Jérémy Bobbio <lunar@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-genbuildinfo 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-genbuildinfo \- Créer des fichiers .buildinfo Debian. +. +.SH SYNOPSIS +\fBdpkg\-genbuildinfo\fP [\fIoption\fP...] +.br +. +.SH DESCRIPTION +\fBdpkg\-genbuildinfo\fP lit les informations à la fois dans une arborescence +debian dépaquetée et déjà construite et sur les fichiers qui ont été créés\ ; +puis il crée un fichier de contrôle décrivant l'environnement et les objets +de construction (c'est le fichier \fB.buildinfo\fP). +.P +Cette commande a été introduite dans dpkg\ 1.18.11. +. +.SH OPTIONS +.TP +\fB\-\-build=\fP\fItype\fP +Indique un \fItype\fP de construction à partir d'une liste séparée par des +virgules de composants. + +Les valeurs autorisées sont\ : +.RS +.TP +\fBany\fP +Génère les informations de construction comprenant les dépendances de +construction non qualifiées (\fBBuild\-Depends\fP) et les dépendances de +construction spécifiques à l'architecture (\fBBuild\-Depends\-Arch\fP). +.TP +\fBall\fP +Génère les informations de construction comprenant les dépendances de +construction non qualifiées (\fBBuild\-Depends\fP) et les dépendances de +construction indépendantes de l'architecture (\fBBuild\-Depends\-Indep\fP). +.TP +\fBsource\fP +Effectivement ignoré\ : génère les informations de construction avec +seulement les dépendances de construction non qualifiées (\fBBuild\-Depends\fP). +.TP +\fBbinary\fP +Génère les informations de construction avec les trois types de dépendances +de construction. C'est un alias de \fBany,all\fP. +.TP +\fBfull\fP +Génère les informations de construction avec les trois types de dépendances +de construction. C'est un alias de \fBany,all,source\fP. Identique au cas par +défaut où aucune option de construction n'est indiquée. +.RE +.TP +\fB\-c\fP\fIfichier/control\fP +Indique le principal fichier de contrôle des sources où trouver des +renseignements. Par défaut, c'est le fichier \fBdebian/control\fP. +.TP +\fB\-l\fP\fIfichier\-des\-changements\fP +Indique le fichier des changements où trouver des renseignements. Par +défaut, c'est le fichier \fBdebian/changelog\fP. +.TP +\fB\-f\fP\fIfichier/liste\-des\-fichiers\fP +Indique où est la liste des fichiers qui ont été produits par la +construction, au lieu d'utiliser le fichier \fBdebian/files\fP. +.TP +\fB\-F\fP\fIformat\-du\-fichier\-des\-changements\fP +Indique le format du fichier des changements. Voir \fBdpkg\-parsechangelog\fP(1) +pour plus d'informations à propos des formats gérés. +.TP +\fB\-O\fP[\fInom\-de\-fichier\fP] +Affiche le fichier buildinfo sur la sortie standard (ou \fInom\-de\-fichier\fP si +précisé) au lieu de +\fIrépertoire\fP\fB/\fP\fInom\-source\fP\fB_\fP\fIversion\-binaire\fP\fB_\fP\fIarchitecture\fP\fB.buildinfo\fP +(où \fIrépertoire\fP est \fB..\fP par défaut ou +\fIrépertoire\-des\-fichiers\-à\-installer\fP si l'option \fB\-u\fP a été utilisée). +.TP +\fB\-u\fP\fIrépertoire\-des\-fichiers\-à\-installer\fP +Cherche les fichiers à installer dans \fIrépertoire\-des\-fichiers\-à\-installer\fP +plutôt que dans \fB..\fP. (\fBdpkg\-genbuildinfo\fP doit trouver ces fichiers de +manière à mettre leurs tailles et leurs sommes de contrôle dans le fichier +\&\fB.buildinfo\fP). +.TP +\fB\-\-always\-include\-kernel\fP +Par défaut le champ \fBBuild\-Kernel\-Version\fP ne sera pas écrit. + +Il faut préciser cette option (depuis dpkg\ 1.19.0) pour toujours remplir un +champ \fBBuild\-Kernel\-Version\fP lors de la création de \fB.buildinfo\fP. +.TP +\fB\-\-always\-include\-path\fP +Par défaut, le champ \fBBuild\-Path\fP ne sera rempli que si le répertoire +courant débute par un motif inscrit en liste blanche. + +Dans Debian et ses dérivés, le motif correspond à \fB/build/\fP au début du nom +de chemin. + +Il faut préciser cette option pour toujours remplir un champ \fBBuild\-Path\fP +lors de la création de \fB.buildinfo\fP. +.TP +\fB\-\-admindir\fP=\fIrépertoire\fP +Change l'endroit où se trouve la base de données de \fBdpkg\fP. Par défaut, +c'est \fI/var/lib/dpkg\fP. +.TP +\fB\-q\fP +\fBdpkg\-genbuildinfo\fP devrait afficher des messages d'information sur la +sortie d'erreur standard. \fB\-q\fP supprime ces messages. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDEB_BUILD_OPTIONS\fP +Cette variable peut être utilisée pour activer ou désactiver diverses +fonctions qui affectent les informations comprises dans le fichier +\&.buildinfo au moyen de l'option \fBbuildinfo\fP (depuis dpkg\ 1.18.19). Cette +option fournit une liste, séparée par des virgules, de fonctionnalités, +préfixées par les modificateurs «\ \fB+\fP\ » ou «\ \fB\-\fP\ » pour indiquer s'il faut +les activer ou les désactiver. La fonction spéciale «\ \fBall\fP\ » peut être +utilisée pour activer ou désactiver toutes les autres fonctions. La fonction +«\ \fBpath\fP\ » contrôle l'inclusion sans condition du champ \fBBuild\-Path\fP. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH FICHIERS +.TP +\fBdebian/files\fP +La liste des fichiers créés. \fBdpkg\-genbuildinfo\fP lit dans ce fichier les +données nécessaires à la création du fichier \fB.buildinfo\fP. +. +.SH "VOIR AUSSI" +\fBdeb\-buildinfo\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-genchanges.man b/man/fr/dpkg-genchanges.man new file mode 100644 index 0000000..d3a4ab3 --- /dev/null +++ b/man/fr/dpkg-genchanges.man @@ -0,0 +1,208 @@ +.\" dpkg manual page - dpkg-genchanges(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006-2016 Guillem Jover <guillem@debian.org> +.\" Copyright © 2008-2010 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-genchanges 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-genchanges \- Créer des fichiers «\ .changes\ ». +. +.SH SYNOPSIS +\fBdpkg\-genchanges\fP [\fIoption\fP...] +.br +. +.SH DESCRIPTION +\fBdpkg\-genchanges\fP lit les informations à la fois dans une arborescence +debian dépaquetée et déjà construite et à partir des fichiers qui ont été +créés, et il crée un fichier de contrôle pour la mise en place dans +l'archive Debian (c'est le fichier \fB.changes\fP). +. +.SH OPTIONS +.TP +\fB\-\-build=\fP\fItype\fP +Indique le \fItype\fP de construction à partir d'une liste, séparée par des +virgules, de composants (depuis dpkg\ 1.18.5). + +Les valeurs autorisées sont\ : +.RS +.TP +\fBsource\fP +Envoyer le paquet source. +.TP +\fBany\fP +Envoyer les paquets binaires spécifiques à l'architecture. +.TP +\fBall\fP +Envoyer les paquets binaires indépendants de l'architecture. +.TP +\fBbinary\fP +Envoyer les paquets binaires spécifiques et indépendants de +l'architecture. C'est un alias pour \fBany,all\fP. +.TP +\fBfull\fP +Envoyer tout. C'est un alias de \fBsource,any,all\fP et identique au cas par +défaut où aucune option de construction n'est indiquée. +.RE +.TP +\fB\-g\fP +Équivalent de \fB\-\-build=source,all\fP (depuis dpkg\ 1.17.11). +.TP +\fB\-G\fP +Équivalent de \fB\-\-build=source,any\fP (depuis dpkg\ 1.17.11). +.TP +\fB\-b\fP +Équivalent de \fB\-\-build=binary\fP ou \fB\-\-build=any,all\fP. +.TP +\fB\-B\fP +Équivalent de \fB\-\-build=any\fP +.TP +\fB\-A\fP +Équivalent de \fB\-\-build=all\fP. +.TP +\fB\-S\fP +Équivalent à \fB\-\-build=source\fP. +.PP +Les options \fB\-s\fP\fIx\fP contrôlent si l'archive source d'origine est incluse +dans l'installation produite si un paquet source est créé (c'est\-à\-dire que +les options \fB\-b\fP ou \fB\-B\fP n'ont pas été utilisées). +.TP +\fB\-si\fP +Par défaut, ou quand l'option est indiquée, les sources d'origine sont +incluses uniquement si le numéro de version majeur (c'est\-à\-dire la version +sans les parties epoch et «\ révision Debian\ ») diffère de la version +précédente indiquée dans le fichier de changelog. +.TP +\fB\-sa\fP +Force l'inclusion des sources d'origine. +.TP +\fB\-sd\fP +Force l'exclusion des sources d'origine et inclut seulement le «\ diff\ ». +.fi +.TP +\fB\-v\fP\fIversion\fP +Force l'utilisation des informations contenues dans le fichier «\ changelog\ » +et qui concernent toutes les versions strictement plus récentes que +\fIversion\fP. +.TP +\fB\-C\fP\fIdescription\-des\-changements\fP +Lit la description des changements dans le fichier +\fIdescription\-des\-changements\fP plutôt que dans le fichier «\ changelog\ » de +l'arborescence source. +.TP +\fB\-m\fP\fIadresse\-du\-responsable\fP +Utilise \fIadresse\-du\-responsable\fP comme nom et adresse électronique du +responsable de paquet plutôt que d'utiliser les informations contenues dans +le fichier «\ control\ » de l'arborescence source. +.TP +\fB\-e\fP\fIadresse\-du\-responsable\fP +Utilise \fIadresse\-du\-responsable\fP comme nom et adresse électronique du +responsable de paquet pour cette mise en place, plutôt que d'utiliser les +informations contenues dans le fichier «\ changelog\ » de l'arborescence +source. +.TP +\fB\-V\fP\fInom\fP\fB=\fP\fIvaleur\fP +Fixe la valeur d'une variable de substitution. Consultez \fBdeb\-substvars\fP(5) +pour une discussion sur la valeur de substitution. +.TP +\fB\-T\fP\fIfichier\-substvars\fP +Lecture des variables de substitution depuis \fIfichier\-substvars\fP\ ; la +valeur par défaut est \fBdebian/substvars\fP. Aucune substitution de variable +n'est faite sur les champs de sortie, sauf pour les contenus extraits de +chaque champ \fBDescription\fP du paquet binaire (depuis dpkg\ 1.19.0), +cependant la variable spéciale \fIFormat\fP remplacera le champ qui porte le +même nom. Cette option peut être utilisée plusieurs fois pour lire les +variables de substitution depuis plusieurs fichiers (depuis dpkg\ 1.15.6). + +.TP +\fB\-D\fP\fIchamp\fP\fB=\fP\fIvaleur\fP +Remplace ou ajoute en sortie un champ dans le fichier de contrôle. +.TP +\fB\-U\fP\fIchamp\fP +Supprime en sortie un champ dans le fichier de contrôle. +.TP +\fB\-c\fP\fIfichier/control\fP +Indique le principal fichier de contrôle des sources où trouver des +renseignements. Par défaut, c'est le fichier \fBdebian/control\fP. +.TP +\fB\-l\fP\fIfichier\-des\-changements\fP +Indique le fichier des changements où trouver des renseignements. Par +défaut, c'est le fichier \fBdebian/changelog\fP. +.TP +\fB\-f\fP\fIfichier/liste\-des\-fichiers\fP +Lit ou écrit la liste des fichiers qui doivent être envoyés vers l'archive +dans ce fichier plutôt que dans le fichier \fBdebian/files\fP. +.TP +\fB\-F\fP\fIformat\-du\-fichier\-des\-changements\fP +Indique le format du fichier des changements. Voir \fBdpkg\-parsechangelog\fP(1) +pour plus d'informations à propos des formats gérés. +.TP +\fB\-u\fP\fIrépertoire\-des\-fichiers\-à\-installer\fP +Cherche les fichiers à installer dans \fIrépertoire\-des\-fichiers\-à\-installer\fP +plutôt que dans \fB..\fP (\fBdpkg\-genchanges\fP doit trouver ces fichiers de +manière à mettre leurs tailles et leurs sommes de contrôle dans le fichier +\&\fB.changes\fP). +.TP +\fB\-q\fP +\fBdpkg\-genchanges\fP affiche habituellement des messages d'information sur la +sortie d'erreur standard\ ; par exemple, combien de fichiers source du paquet +sont en cours d'installation. \fB\-q\fP supprime ces messages. +.TP +\fB\-O\fP[\fInom\-de\-fichier\fP] +Affiche le fichier des modifications sur la sortie standard (par défaut) ou +dans \fInom\-de\-fichier\fP s'il est indiqué (depuis dpkg\ 1.18.5). +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH FICHIERS +.TP +\fBdebian/files\fP +La liste des fichiers créés qui seront envoyés sur le +serveur. \fBdpkg\-genchanges\fP lit dans ce fichier les données nécessaires à la +création du fichier \fB.changes\fP. +. +.SH "VOIR AUSSI" +.ad l +\fBdeb\-substvars\fP(5), \fBdeb\-src\-control\fP(5), \fBdeb\-src\-files\fP(5), +\fBdeb\-changelog\fP(5), \fBdeb\-changes\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-gencontrol.man b/man/fr/dpkg-gencontrol.man new file mode 100644 index 0000000..c1d22a7 --- /dev/null +++ b/man/fr/dpkg-gencontrol.man @@ -0,0 +1,165 @@ +.\" dpkg manual page - dpkg-gencontrol(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006, 2012-2013, 2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2007-2008 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-gencontrol 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-gencontrol \- Créer des fichiers de contrôle Debian. +. +.SH SYNOPSIS +\fBdpkg\-gencontrol\fP [\fIoption\fP...] +. +.SH DESCRIPTION +\fBdpkg\-gencontrol\fP lit les informations contenues dans une arborescence +Debian dépaquetée et crée le fichier «\ control\ » d'un paquet binaire (par +défaut, c'est le fichier debian/tmp/DEBIAN/control)\ ; durant cette action il +y a simplification des champs de relations. +.sp +\fBPre\-Depends\fP, \fBDepends\fP, \fBRecommends\fP et \fBSuggests\fP sont simplifiés +dans cet ordre pour supprimer les dépendances qui sont connues pour être +vérifiées par la plus forte dépendance déjà traitée. Sont aussi supprimées +toutes les auto\-dépendances (dans les faits, cela supprime les dépendances +qui sont déjà validées par la version du paquet déjà installé). Logiquement, +il conserve les correspondances entre plusieurs dépendances dans le même +paquet. L'ordre des dépendances est conservé du mieux possible\ : si une +dépendance doit être supprimée à cause d'une autre dépendance qui apparaît +plus loin dans le champ, la dépendance remplaçante prendra la place de celle +éliminée. +.sp +Les autres champs (\fBEnhances\fP, \fBConflicts\fP, \fBBreaks\fP, \fBReplaces\fP et +\fBProvides\fP) sont également simplifiés individuellement par l'analyse des +différentes dépendances lorsque un paquet est indiqué plusieurs fois dans le +champ. +.sp +\fBdpkg\-gencontrol\fP ajoute aussi une entrée pour un paquet binaire dans +\fBdebian/files\fP. +. +.SH OPTIONS +.TP +\fB\-v\fP\fIversion\fP +Fixe le numéro de version du paquet binaire qui sera créé. +.TP +\fB\-V\fP\fInom\fP\fB=\fP\fIvaleur\fP +Fixe la valeur d'une variable de substitution. Consultez \fBdeb\-substvars\fP(5) +pour une discussion sur la valeur de substitution. +.TP +\fB\-T\fP\fIfichier\-substvars\fP +Lecture des variables de substitution depuis \fIfichier\-substvars\fP\ ; la +valeur par défaut est \fBdebian/substvars\fP. Cette option peut être utilisée +plusieurs fois pour lire les variables de substitution depuis plusieurs +fichiers (depuis dpkg\ 1.15.6). +.TP +\fB\-D\fP\fIchamp\fP\fB=\fP\fIvaleur\fP +Remplace ou ajoute en sortie un champ dans le fichier de contrôle. +.TP +\fB\-U\fP\fIchamp\fP +Supprime en sortie un champ dans le fichier de contrôle. +.TP +\fB\-c\fP\fIfichier\-de\-contrôle\fP +Indique le principal fichier de contrôle des sources où trouver des +renseignements. Par défaut, c'est le fichier \fBdebian/control\fP. +.TP +\fB\-l\fP\fIfichier\-des\-changements\fP +Indique le fichier des changements où trouver des renseignements. Par +défaut, c'est le fichier \fBdebian/changelog\fP. +.TP +\fB\-f\fP\fIfichier/liste\-des\-fichiers\fP +Lit ou écrit la liste des fichiers qui doivent être envoyés vers l'archive +dans ce fichier plutôt que dans le fichier \fBdebian/files\fP. +.TP +\fB\-F\fP\fIformat\-du\-fichier\-des\-changements\fP +Indique le format du fichier des changements. Voir \fBdpkg\-parsechangelog\fP(1) +pour plus d'informations à propos des formats gérés. +.TP +\fB\-p\fP\fIpaquet\fP +Cette option produit les informations concernant le paquet binaire +\fIpaquet\fP.Si le fichier de contrôle des sources liste un seul paquet +binaire, on peut omettre cette option\ ; sinon il est indispensable +d'indiquer le paquet pour lequel on veut produire les informations. +.TP +\fB\-n\fP\fInom\-de\-fichier\fP +Le nom du paquet est \fInom\-de\-fichier\fP au lieu de l'habituel\ : +paquet_version_arch.deb. +.TP +\fB\-is\fP, \fB\-ip\fP, \fB\-isp\fP +Ces options, conservées pour compatibilité avec les anciennes versions des +scripts de construction de dpkg, sont maintenant déconseillées. Elles +servaient à dire à \fBdpkg\-gencontrol\fP d'inclure les champs «\ Section\ » et +«\ Priority\ » dans le fichier «\ control\ ». C'est maintenant le comportement +par défaut. Si vous voulez l'ancien comportement, vous pouvez utiliser +l'option \fB\-U\fP pour supprimer ces champs du fichier «\ control\ ». +.TP +\fB\-P\fP\fIrépertoire\-construction\-paquet\fP +Cette option indique à \fBdpkg\-source\fP que le répertoire de construction du +paquet est \fIrépertoire\-construction\-paquet\fP au lieu de \fBdebian/tmp\fP. Cette +valeur sert à trouver la valeur par défaut de la variable de substitution +\fBInstalled\-Size\fP et celle du champ correspondant dans le fichier de +contrôle (on utilise la commande \fBdu\fP)\ ; elle donne aussi l'emplacement par +défaut pour le fichier de sortie. +.TP +\fB\-O\fP[\fInom\-de\-fichier\fP] +Affiche le fichier «\ control\ » sur la sortie standard (ou \fInom\-de\-fichier\fP, +depuis dpkg\ 1.17.2), au lieu de \fBdebian/tmp/DEBIAN/control\fP (ou +\fIrépertoire\-construction\-paquet\fP\fB/DEBIAN/control\fP si l'option \fB\-P\fP a été +utilisée). +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH FICHIERS +.TP +\fBdebian/control\fP +Le principal fichier d'information sur les sources\ ; il donne des +renseignements qui ne dépendent pas d'une version concernant le paquet +source et les paquets binaires qui peuvent être créés. +.TP +\fBdebian/files\fP +La liste des fichiers créés qui font partie de ceux qui seront envoyés sur +le serveur. \fBdpkg\-gencontrol\fP ajoute les noms présumés des fichiers des +paquets binaires à partir des fichiers «\ control\ » qu'il crée. +.SH "VOIR AUSSI" +.ad l +\fBdeb\-substvars\fP(5), \fBdeb\-src\-control\fP(5), \fBdeb\-changelog\fP(5), +\fBdeb\-control\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-gensymbols.man b/man/fr/dpkg-gensymbols.man new file mode 100644 index 0000000..e6fc0c9 --- /dev/null +++ b/man/fr/dpkg-gensymbols.man @@ -0,0 +1,591 @@ +.\" dpkg manual page - dpkg-gensymbols(1) +.\" +.\" Copyright © 2007-2011 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2009-2010 Modestas Vainius <modestas@vainius.eu> +.\" Copyright © 2012-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-gensymbols 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-gensymbols \- Création des fichiers de symboles (information de +dépendances de bibliothèques partagées) +. +.SH SYNOPSIS +\fBdpkg\-gensymbols\fP [\fIoption\fP...] +. +.SH DESCRIPTION +\fBdpkg\-gensymbols\fP analyse un répertoire temporaire de construction (par +défaut debian/tmp), y recherche les bibliothèques et crée un fichier +\fIsymbols\fP qui les décrit. Si ce fichier n'est pas vide, il est installé +dans le sous\-répertoire DEBIAN du répertoire de construction afin de pouvoir +être inclus dans les informations de contrôle du paquet. +.P +Lors de la création de ces fichiers, il utilise en entrée certains fichiers +de symboles fournis par le responsable. Il recherche les fichiers suivants +(en utilisant le premier trouvé)\ : +.IP • 4 +debian/\fIpaquet\fP.symbols.\fIarch\fP +.IP • 4 +debian/symbols.\fIarch\fP +.IP • 4 +debian/\fIpaquet\fP.symbols +.IP • 4 +debian/symbols +.P +L'intérêt principal de ces fichiers est de fournir la version minimale +associée à chaque symbole fourni par les bibliothèques. En général, cela +correspond à la première version du paquet qui a fourni ce symbole, mais +cette valeur peut être augmentée manuellement par le responsable si +l'interface binaire applicative (ABI) du symbole est étendue sans casser la +compatibilité avec les versions précédentes. La tenue à jour de ces fichiers +est à la charge du responsable du paquet, avec l'aide de +\fBdpkg\-gensymbols\fP. +.P +Quand les fichiers de symboles créés sont différents de ceux fournis par le +responsable, \fBdpkg\-gensymbols\fP affichera les différences entre les deux +versions. Si ces différences sont trop importantes, le programme peut même +se terminer en échec (le nombre de différences tolérées peut être réglé avec +l'option \fB\-c\fP). +.SH "TENUE À JOUR DES FICHIERS SYMBOLES" +Les fichiers de symboles deviennent réellement utiles lorsqu'ils permettent +de suivre l'évolution du paquet sur plusieurs versions. En conséquence, le +responsable doit les mettre à jour chaque fois qu'un nouveau symbole est +ajouté afin que la version minimale associée corresponde à la réalité. Pour +effectuer cette opération correctement, le fichier de différences indiqué +dans le journal de construction peut être utilisé. Dans la plupart des cas, +ce fichier de différences peut être appliqué tel quel au fichier +debian/\fIpaquet\fP.symbols. Cela étant, quelques adaptations sont généralement +nécessaires\ : il est par exemple recommandé de retirer le numéro de révision +Debian de la version minimale afin que les paquets rétro\-portés, de numéro +de version inférieur mais avec la même version amont continuent à répondre +aux pré\-requis. Si le numéro de révision Debian ne peut vraiment pas être +retiré car le nouveau symbole est la conséquence d'une modification propre à +Debian, il est suggéré d'ajouter un suffixe «\ \fB~\fP\ » au numéro de version. +.P +Avant d'appliquer le correctif au fichier de symboles, le responsable doit +contrôler qu'il est correct. Les symboles publics sont supposés ne jamais +disparaître et le correctif ne devrait donc qu'ajouter des lignes. +.P +Veuillez noter qu'il est possible de placer des commentaires dans les +fichiers de symboles\ :\ toute ligne commençant par «\ #\ » est un commentaire +sauf si elle commence par «\ #include\ » (voir la section \fButilisation des +inclusions\fP). Les lignes commençant par «\ #MISSING:\ » sont des commentaires +spéciaux qui indiquent les symboles qui peuvent avoir disparu. +.P +N'oubliez pas de vérifier si les anciennes versions des symboles ne doivent +pas être incrémentées. Il n'y a pas de moyen pour que \fBdpkg\-gensymbols\fP +prévienne de cela. Appliquer aveuglement le fichier de différences ou +supposer qu'il n'y a rien à changer, s'il n'y a pas de fichier de +différences, sans vérifier s'il y a ces modifications, peut faire que des +paquets, avec des dépendances lâches, prétendent qu'ils peuvent fonctionner +avec des paquets plus anciens avec lesquels ils ne peuvent fonctionner. Cela +introduira des bogues difficiles à trouver avec des mises à niveau +(partielles). +.SS "Utilisation du remplacement de #PACKAGE#" +.P +Dans de rares cas, le nom de la bibliothèque dépend de l'architecture. Afin +d'éviter de coder le nom du paquet en dur dans le fichier de symboles, il +est possible d'utiliser le marqueur \fI#PACKAGE#\fP. Il sera remplacé par le +vrai nom du paquet lors de l'installation des fichiers de symboles. À la +différence du marqueur \fI#MINVER#\fP, \fI#PACKAGE#\fP n'apparaîtra jamais dans le +fichier de symboles d'un paquet binaire. +.SS "Utilisation des étiquettes de symbole" +.P +L'étiquetage des symboles («\ symbol tagging\ ») est utile pour marquer des +symboles qui sont particuliers d'une manière ou d'une autre. Tout symbole +peut avoir un nombre quelconque d'étiquettes associées. Bien que toutes les +étiquettes soient analysées et conservées, seules certaines d'entre elles +sont comprises par \fBdpkg\-gensymbols\fP et déclenchent un traitement +spécifique des symboles. Veuillez consulter la sous\-section \fBÉtiquettes +standard de symbole\fP pour une référence complète à propos de ces étiquettes. +.P +L'indication de l'étiquette vient juste avant le nom du symbole (sans +espace). Elle commence toujours par une parenthèse ouvrante \fB(\fP, se termine +avec une parenthèse fermante \fB)\fP et doit contenir au moins une +étiquette. Les étiquettes multiples doivent être séparées par le caractère +\fB|\fP. Chaque étiquette peut comporter optionnellement une valeur, séparée du +nom de l'étiquette par le caractère \fB=\fP. Les noms et valeurs des étiquettes +sont des chaînes quelconques qui ne doivent pas comporter les caractères +\fB)\fP \fB|\fP et \fB=\fP. Les noms de symbole qui suivent une étiquette peuvent +optionnellement être mis entre guillemets avec les caractères \fB'\fP ou \fB"\fP +afin d'y autoriser la présence d'espaces. Cependant, si aucune étiquette +n'est utilisée, les guillemets sont alors traités comme une partie du nom du +symbole, qui s'arrête alors au premier espace. +.P + (étiq1=je suis marqué|étiquette avec espace)"symbole comportant des espaces"@Base 1.0 + (optional)symbole_non_protégé@Base 1.0 1 + symbole_non_étiqueté@Base 1.0 +.P +Le premier symbole de cet exemple est appelé \fIsymbole comportant des +espaces\fP et utilise deux étiquettes\ :\ \fIétiq1\fP avec la valeur \fIje suis +marqué\fP et \fIétiquette avec espace\fP sans valeur. Le deuxième symbole, appelé +\fIsymbole_non_protégé\fP ne comporte que l'étiquette \fIoptional\fP. Le dernier +symbole est un exemple de symbole normal sans étiquette. +.P +Comme les étiquettes de symbole sont une extension du format de +\fBdeb\-symbols(5)\fP, elles ne peuvent apparaître que dans les fichiers de +symboles des paquets source (ces fichiers peuvent ensuite être vus comme des +modèles permettant de construire les fichiers de symboles inclus dans les +paquets binaires). Lorsque \fBdpkg\-gensymbols\fP est lancé sans l'option \fB\-t\fP, +il affiche les fichiers de symboles compatibles avec le format +\fBdeb\-symbols(5)\fP\ : il traite entièrement les symboles d'après les exigences +des étiquettes standard et supprime les étiquettes dans sa sortie. Au +contraire, dans le mode modèle («\ template\ », option \fB\-t\fP), tous les +symboles et leurs étiquettes (standard et inconnues) sont conservés dans la +sortie et écrits dans leur forme d'origine. +.SS "Étiquettes standard de symbole" +.TP +\fBoptional\fP +Un symbole marqué comme optionnel peut disparaître de la bibliothèque à tout +moment et ne provoquera pas l'échec de \fBdpkg\-gensymbols\fP. Cependant, les +symboles optionnels disparus apparaîtront en permanence comme manquants dans +le fichier de différences, à chaque nouvelle version du paquet. Ce +comportement sert de rappel au responsable qu'un tel symbole doit être +supprimé du fichier de symboles ou bien rajouté à la bibliothèque. Un tel +symbole optionnel, précédemment déclaré comme manquant («\ MISSING\ »), peut +réapparaître soudainement dans la version suivante en étant remis à l'état +existant («\ existing\ »), sans modification de sa version minimale. + +Cette étiquette est utile pour les symboles qui sont privés car leur +disparition ne provoque pas de changement d'interface applicative (ABI). Par +exemple, la plupart des modèles d'instanciation C++ sont dans cette +catégorie. Comme toute autre étiquette, celle\-ci peut comporter une valeur +arbitraire qui peut servir à indiquer pour quelle raison le symbole est +optionnel. +.TP +\fBarch=\fP\fIliste\-d'architectures\fP +.TQ +\fBarch\-bits=\fP\fIoctets\-architecture\fP +.TQ +\fBarch\-endian=\fP\fIboutisme\-d'architecture\fP +Ces étiquettes permettent de restreindre la liste des architectures avec +lesquelles le symbole est censé exister. Les étiquettes \fBarch\-bits\fP et +\fBarch\-endian\fP sont prises en charge depuis dpkg\ 1.18.0. Lorsque la liste +des symboles est mise à jour avec ceux découverts dans la bibliothèque, tous +les symboles spécifiques d'architectures qui ne concernent pas +l'architecture en cours sont ignorés. Si un symbole propre à l'architecture +en cours n'existe pas dans la bibliothèque, les processus normaux pour des +symboles manquants s'appliquent jusqu'à éventuellement provoquer l'échec de +\fBdpkg\-gensymbols\fP. D'un autre côté, si le symbole propre à une architecture +est trouvé alors qu'il n'est pas censé exister (parce que l'architecture +courante n'est pas mentionnée dans l'étiquette ou ne correspond pas au +boutisme et aux octets), il est rendu indépendant de l'architecture +(c'est\-à\-dire que les étiquettes d'architecture, d'octets de l'architecture +et de boutisme d'architecture sont abandonnées et le symbole apparaît dans +le fichier de différences) mais non considéré comme nouveau. (NdT\ : une +aspirine peut être nécessaire après la lecture de ce paragraphe) + +Dans le mode de fonctionnement par défaut (pas en mode «\ modèle\ »), seuls +les symboles spécifiques de certaines architectures qui correspondent à +l'architecture courante sont écrits dans le fichier de symboles. Au +contraire, tous les symboles spécifiques d'architectures (y compris ceux des +architectures différentes) seront écrits dans le fichier de symboles, dans +le mode «\ modèle\ ». + +Le format de \fIliste\-d'architectures\fP est le même que le format utilisé dans +les champs \fBBuild\-Depends\fP des fichiers \fIdebian/control\fP (à l'exception +des crochets d'inclusion []). Par exemple, le premier symbole de la liste +qui suit sera pris en compte sur les architectures alpha, n'importe quelle +amd64 et ia64, le second uniquement sur les architectures linux et le +troisième partout sauf sur armel. + + (arch=alpha any\-amd64 ia64)un_symbole_spécifique_64bit@Base 1.0 + (arch=linux\-any)un_symbole_spécifique_linux@Base 1.0 + (arch=!armel)un_symbole_inexistant_sur_armel@Base 1.0 + +Les \fIoctets\-architecture\fP sont soit \fB32\fP soit \fB64\fP. + + (arch\-bits=32)32bit_specific_symbol@Base 1.0 + (arch\-bits=64)64bit_specific_symbol@Base 1.0 + +Le \fIboutisme\-d'architecture\fP est soit \fBlittle\fP soit \fBbig\fP. + + (arch\-endian=little)little_endian_specific_symbol@Base 1.0 + (arch\-endian=big)big_endian_specific_symbol@Base 1.0 + +Plusieurs restrictions peuvent être chaînées. + + (arch\-bits=32|arch\-endian=little)32bit_le_symbol@Base 1.0 +.TP +\fBignore\-blacklist\fP +\fBdpkg\-gensymbols\fP comporte une liste interne de symboles ignorés qui ne +devraient pas apparaître dans les fichiers de symboles car ils sont en +général uniquement des effets de bord de détails de mise en œuvre de la +chaîne d'outils de construction. Si, pour une raison précise, vous voulez +vraiment inclure un de ces symboles dans le fichier, vous pouvez imposer +qu'il soit ignoré, avec \fBignore\-blacklist\fP. Cela peut être utile pour +certaines bibliothèques de bas niveau telles que libgcc. +.TP +\fBc++\fP +Indique un motif de symbole \fIc++\fP. Voir la sous\-section \fBUtilisation de +motifs de symbole\fP plus loin. +.TP +\fBsymver\fP +Indique un motif de symbole \fIsymver\fP (version de symbole). Voir la +sous\-section \fBUtilisation des motifs de symbole\fP plus loin. +.TP +\fBregex\fP +Indique un motif de symbole basé sur une \fIexpression\-rationnelle\fP. Voir la +sous\-section \fBUtilisation des motifs de symbole\fP plus loin. +.SS "Utilisation de motifs de symbole" +.P +Au contraire d'une indication normale de symbole, un motif permet de couvrir +des symboles multiples de la bibliothèque. \fBdpkg\-gensymbols\fP essaie de +faire correspondre chaque motif à chaque symbole qui n'est pas explicitement +défini dans le fichier de symboles. Dès qu'un motif est trouvé qui +correspond au symbole, l'ensemble de ses étiquettes et propriétés sont +utilisées comme spécification de base du symbole. Si aucun des motifs ne +correspond, le symbole sera considéré comme nouveau. + +Un motif est considéré comme perdu si aucun symbole ne lui correspond dans +la bibliothèque. Par défaut, cela provoquera un échec de \fBdpkg\-gensymbols\fP +s'il est utilisé avec l'option \fB\-c1\fP (ou une valeur plus +élevée). Cependant, si l'échec n'est pas souhaité, le motif peut être marqué +comme optionnel avec l'étiquette \fIoptional\fP. Dans ce cas, si le motif ne +correspond à rien, il sera simplement mentionné dans le fichier de +différences comme \fIMISSING\fP (manquant). De plus, comme pour tout autre +symbole, le motif peut être limité à des architectures données avec +l'étiquette \fIarch\fP. Veuillez consulter la sous\-section \fBÉtiquettes +standard de symbole\fP pour plus d'informations. + +Les motifs sont une extension du format de \fBdeb\-symbols(5)\fP en ce sens +qu'ils ne sont valables que dans les modèles de fichiers de +symboles. Cependant, la partie comportant le nom de symbole est utilisée +comme une expression à faire correspondre à \fIname@version\fP du symbole +réel. Afin de faire la distinction entre les différents types de motifs, un +motif sera usuellement marqué avec une étiquette spéciale. + +Actuellement, \fBdpkg\-gensymbols\fP gère trois types de base de motifs\ : +.TP 3 +\fBc++\fP +Ce motif est repéré par l'étiquette \fIc++\fP. Il ne sera comparé qu'aux +symboles C++ avec leur nom de symbole rétabli (demangled) tel qu'affiché +avec l'utilitaire \fBc++filt\fP. Ce motif est très pratique pour faire +correspondre les symboles dont les noms décorés (mangled) peuvent différer +selon les architectures bien que leurs noms d'origine restent les mêmes. Un +tel groupe de symboles sont les \fInon\-virtual thunks\fP pour lesquels les +décalages (offsets) spécifiques d'architectures sont inclus dans leur nom +décoré. Une manifestation usuelle de ce cas est le destructeur virtuel qui, +dans le contexte d'un «\ problème du diamant\ », a besoin d'un symbole de +transition spécial (ou «\ thunk\ ») non virtuel. Par exemple, même si +_ZThn8_N3NSB6ClassDD1Ev@Base sur une architecture 32\ bits est identique à +_ZThn16_N3NSB6ClassDD1Ev@Base sur une architecture 64\ bits, les deux peuvent +être indiqués avec le même motif \fIc++\fP\ : + +libdummy.so.1 libdummy1 #MINVER# + [...] + (c++)"non\-virtual thunk to NSB::ClassD::~ClassD()@Base" 1.0 + [...] + +Le nom non décoré ci\-dessus peut être obtenu avec la commande suivante\ : + + $ echo '_ZThn8_N3NSB6ClassDD1Ev@Base' | c++filt + +Veuillez noter que, bien que le nom décoré soit unique dans la bibliothèque +par définition, cela n'est pas forcément vrai pour le nom non décoré. Deux +symboles réels différents peuvent avoir le même nom non décoré. C'est par +exemple le cas avec les symboles «\ thunk\ » non virtuels dans des +configurations d'héritage complexes ou avec la plupart des constructeurs et +destructeurs (puisque g++ crée usuellement deux symboles réels pour +eux). Cependant, comme ces collisions se produisent au niveau de l'interface +applicative binaire (ABI), elles ne devraient pas dégrader la qualité du +fichier de symboles. +.TP +\fBsymver\fP +Ce motif est indiqué par l'étiquette \fIsymver\fP. Les bibliothèques bien +gérées utilisent des symboles versionnés où chaque version correspond à la +version amont à laquelle le symbole a été ajouté. Si c'est le cas, il est +possible d'utiliser un motif \fIsymver\fP pour faire correspondre chaque +symbole associé à la version spécifique. Par exemple\ : + +libc.so.6 libc6 #MINVER# + (symver)GLIBC_2.0 2.0 + [...] + (symver)GLIBC_2.7 2.7 + access@GLIBC_2.0 2.2 + +Tous les symboles associés avec les versions GLIBC_2.0 et GLIBC_2.7 +conduiront respectivement à des versions minimales de\ 2.0 et\ 2.7, à +l'exception du symbole access@GLIBC_2.0. Ce dernier amène à une dépendance +minimale sur la version\ 2.2 de libc6 bien qu'il soit dans le scope de +«\ (symvar)GLIBC_2.0\ ». Cela est dû au fait que les symboles spécifiques +prennent le pas sur les motifs. + +Veuillez noter que les anciens motifs avec caractères génériques (indiqués +sous la forme «\ *@version\ ») dans le champ de nom de symbole sont toujours +gérés. La nouvelle syntaxe «\ (symver|optional)version\ » doit toutefois leur +être préférée. Par exemple, «\ *@GLIBC_2.0\ 2.0\ » devrait être écrit sous la +forme «\ (symver|optional)GLIBC_2.0\ 2.0\ » si un comportement analogue est +recherché. +.TP +\fBregex\fP +Les motifs d'expressions rationnelles sont indiqués par l'étiquette +\fIexpression\-rationnelle\fP. La correspondance se fait avec une expression +rationnelle Perl sur le champ de nom de symbole. La correspondance est faite +telle quelle et il ne faut donc pas oublier le caractère \fI^\fP, sinon la +correspondance est faite sur n'importe quelle partie du symbole réel +\fIname@version\fP. Par exemple\ : + +libdummy.so.1 libdummy1 #MINVER# + (regex)"^mystack_.*@Base$" 1.0 + (regex|optional)"private" 1.0 + +Les symboles tels que «\ mystack_new@Base\ », «\ mystack_push@Base\ », +«\ mystack_pop@Base\ », etc., seront en correspondance avec le premier motif +alors que, par exemple, «\ ng_mystack_new@Base\ » ne le sera pas. Le deuxième +motif correspondra pour tous les symboles qui comportent la chaîne +«\ private\ » dans leur nom et les correspondances hériteront de l'étiquette +\fIoptional\fP depuis le motif. +.P +Les motifs de base indiqués précédemment peuvent être combinés au +besoin. Dans ce cas, ils sont traités dans l'ordre où les étiquettes sont +indiquées. Par exemple, les deux motifs + + (c++|regex)"^NSA::ClassA::Private::privmethod\ed\e(int\e)@Base" 1.0 + (regex|c++)N3NSA6ClassA7Private11privmethod\edEi@Base 1.0 + +seront en correspondance avec les symboles +«\ _ZN3NSA6ClassA7Private11privmethod1Ei@Base"\ » et +«\ _ZN3NSA6ClassA7Private11privmethod2Ei@Base\ ». Lors de la correspondance +avec le premier motif, le symbole brut est d'abord rétabli d’origine en tant +que symbole C++, puis comparé à l'expression rationnelle. D'un autre côté, +lors de la correspondance avec le deuxième motif, l'expression rationnelle +est comparée au nom de symbole brut, puis le symbole est testé en tant que +symbole C++ en tentant de le rétablir d’origine. L'échec de n'importe quel +motif basique provoquera l'échec de l'ensemble du motif. Ainsi, par exemple, +«\ __N3NSA6ClassA7Private11privmethod\edEi@Base\ » ne correspondra à aucun des +motifs car ce n'est pas un symbole C++ valable (NdT\ :\ j'ai l'impression de +traduire du Klingon\ !). + +En général, les motifs sont divisés en deux groupes\ :\ les alias (\fIc++\fP et +\fIsymver\fP basique) et les motifs génériques (\fIexpression\-rationnelle\fP et +toutes les combinaisons de motifs basiques multiples). La correspondance de +motifs basés sur des alias est rapide (O(1)) alors que les motifs génériques +sont O(N) (N étant le nombre de motifs génériques) pour chaque symbole. En +conséquence, il est déconseillé d'abuser des motifs génériques. + +Lorsque plusieurs motifs correspondent pour le même symbole réel, les alias +(d'abord \fIc++\fP, puis \fIsymver\fP) sont privilégiés par rapport aux motifs +génériques. Ceux\-ci sont essayés dans l'ordre où ils apparaissent dans le +modèle de fichier de symboles, en s'arrêtant à la première +correspondance. Veuillez noter, cependant, que la modification manuelle de +l'ordre des entrées de fichiers n'est pas recommandée car \fBdpkg\-gensymbols\fP +crée des fichiers de différences d'après l'ordre alphanumérique de leur nom. +.SS "Utilisation des inclusions" +.P +Lorsqu'un jeu de symboles exportés varie selon les architectures, il est +souvent peu efficace d'utiliser un seul fichier de symboles. Pour couvrir +ces cas, une directive d'inclusion peut devenir utile dans certains cas\ : +.IP • 4 +Il est possible de factoriser la partie commune dans un fichier externe +donné et l'inclure dans le fichier \fIpaquet\fP.symbols.\fIarch\fP avec une +directive «\ include\ » utilisée de la manière suivante\ : + +#include "\fIpaquets\fP.symbols.common" +.IP • +La directive d'inclusion peut également être étiquetée comme tout autre +symbole\ : + +(étiquette|...|étiquetteN)#include "fichier_à_inclure" + +Le résultat sera que tous les symboles inclus depuis \fIfichier_à_inclure\fP +seront considérés comme étiquetés par défaut avec \fIetiq\fP ... \fIetiqN\fP. Cela +permet de créer un fichier \fIpaquet\fP.symbols commun qui inclut les fichiers +de symboles spécifiques des architectures\ : + + symbole_commun1@Base 1.0 + (arch=amd64 ia64 alpha)#include "package.symbols.64bit" + (arch=!amd64\ !ia64\ !alpha)#include "package.symbols.32bit" + symbole_commun2@Base 1.0 +.P +Les fichiers de symboles sont lus ligne par ligne et les directives +d'inclusion sont traitées dès qu'elles sont trouvées. En conséquence, le +contenu du fichier d'inclusion peut remplacer une définition qui précède +l'inclusion et ce qui suit l'inclusion peut remplacer une définition qu'elle +ajoutait. Tout symbole (ou même une autre directive d'inclusion) dans le +fichier inclus peut définir des étiquettes supplémentaires ou remplacer les +valeurs d'étiquettes héritées, dans sa définition d'étiquettes. Cependant, +pour un symbole donné, il n'existe pas de méthode permettant de remplacer +une de ses étiquettes héritées. +.P +Un fichier inclus peut reprendre la ligne d'en\-tête qui contient le +«\ SONAME\ » de la bibliothèque. Dans ce cas, cela remplace toute ligne +d'en\-tête précédente. Il est cependant déconseillé de dupliquer les lignes +d'en\-tête. Une façon de le faire est la méthode suivante\ : +.PP +#include "libmachin1.symbols.common" + symboles_specifique_architecture@Base 1.0 +.SS "Bonnes pratiques de gestion des bibliothèques" +.P +Une bibliothèque bien maintenue offre les possibilités suivantes\ : +.IP • 4 +son interface de programmation (API) est stable (les symboles publics ne +sont jamais supprimés et les changements ne concernent que des ajouts de +nouveaux symboles publics) et les modifications provoquant une +incompatibilité doivent être combinés avec un changement de SONAME\ ; +.IP • 4 +idéalement, elle utilise le versionnage des symboles pour garantir la +stabilité de l'interface applicative binaire (ABI) malgré ses modifications +internes et l'extension de son API\ ; +.IP • 4 +elle n'exporte pas les symboles privés (afin de contourner cela, de tels +symboles peuvent être étiquetés comme optionnels). +.P +En maintenant le fichier de symboles, il est facile d'en voir apparaître et +disparaître. Cependant, il est plus difficile de contrôler la présence +d'éventuelles modifications d'API ou ABI. En conséquence, le responsable +doit contrôler soigneusement le journal des modifications amont, à la +recherche de cas où une saine gestion des bibliothèques peut avoir été +omise. Si des problèmes potentiels sont découverts, l'auteur amont doit être +averti(e) car une correction en amont est meilleure qu'un travail spécifique +au paquet Debian. +.SH OPTIONS +.TP +\fB\-P\fP\fIrépertoire\-construction\-paquet\fP +Analyse de \fIrépertoire\-construction\-paquet\fP, plutôt que debian/tmp. +.TP +\fB\-p\fP\fIpaquet\fP +Définit le nom du paquet. Requis si plus d'un paquet binaire est indiqué +dans debian/control (ou s'il n'y a pas de fichier debian/control). +.TP +\fB\-v\fP\fIversion\fP +Définit la version du paquet. La valeur par défaut est la version extraite +de debian/changelog. Ce paramètre est requis si le programme est lancé en +dehors de l'arborescence source d'un paquet. +.TP +\fB\-e\fP\fIfichier\-bibliothèque\fP +N'analyse que les bibliothèques explicitement mentionnées au lieu de +rechercher toutes les bibliothèques publiques. Les motifs du shell peuvent +être utilisés pour l'expansion des chemins d'accès (voir la page de manuel +de \fBFile::Glob\fP(3perl) pour plus d'informations) dans +\fIfichier\-bibliothèque\fP pour établir une correspondance avec plusieurs +bibliothèques avec un seul paramètre (afin d'éviter d'utiliser plusieurs +options \fB\-e\fP). +.TP +\fB\-l\fP\fIrépertoire\fP +Ajoute \fIrépertoire\fP au début de la liste des répertoires où chercher des +bibliothèques partagées privées (depuis dpkg\ 1.19.1). Cette option peut être +utilisée plusieurs fois. + +Note\ : Utilisez cette option plutôt que le réglage de \fBLD_LIBRARY_PATH\fP, +parce que cette variable d'environnement est utilisée pour contrôler +l'éditeur de liens d'exécution et se servir d'elle pour définir les chemins +des bibliothèques partagées au moment de la construction peut être +problématique, par exemple, lors d'une compilation croisée. +.TP +\fB\-I\fP\fInom\-de\-fichier\fP +Utilise \fInom\-de\-fichier\fP comme fichier de référence pour créer le fichier +de symboles à intégrer dans le paquet lui\-même. +.TP +\fB\-O\fP[\fInom\-de\-fichier\fP] +Affiche le fichier de symboles créé sur la sortie standard ou dans le +\fInom\-de\-fichier\fP, si spécifié, plutôt que dans \fBdebian/tmp/DEBIAN/symbols\fP +(ou \fIrépertoire\-construction\-paquet\fP\fB/DEBIAN/symbols\fP si \fB\-P\fP est +présent). Si \fInom\-de\-fichier\fP existe déjà, son contenu sera utilisé comme +base pour le fichier créé. Cette fonctionnalité permet de mettre à jour le +fichier de symboles pour qu'il corresponde à une nouvelle version amont de +la bibliothèque. +.TP +\fB\-t\fP +Écrit le fichier de symboles en mode modèle plutôt que dans un format +compatible avec \fBdeb\-symbols\fP(5). La différence majeure réside dans le fait +que les noms de symboles et les étiquettes sont écrits dans leur forme +d'origine au lieu d'être interprétés, avec réduction des étiquettes en mode +de compatibilité. De plus, certains symboles peuvent être omis lors de +l'écriture d'un fichier \fBdeb\-symbols\fP(5) standard (selon les règles de +traitement des étiquettes) alors que tous les symboles sont écrits lors de +la création d'un modèle de fichier de symboles. +.TP +\fB\-c\fP\fI[0\-4]\fP +Définit les contrôles à effectuer lors de la comparaison du fichier de +symboles créé en utilisant le fichier de modèle comme point de départ. Le +niveau par défaut est\ 1. Plus le niveau est augmenté, plus le nombre de +contrôles effectués est important. Chaque niveau de contrôle comporte les +contrôles effectués pour les niveaux inférieurs. Le niveau\ 0 n'échoue +jamais. Le niveau\ 1 échoue si certains symboles ont disparu. Le niveau\ 2 +échoue si de nouveaux symboles ont été ajoutés. Le niveau\ 3 échoue si +certaines bibliothèques ont disparu. Le niveau\ 4 échoue si des bibliothèques +ont été ajoutées. + +Cette valeur peut être remplacée par la valeur de la variable +d'environnement \fBDPKG_GENSYMBOLS_CHECK_LEVEL\fP. +.TP +\fB\-q\fP +Fonctionne en mode silencieux et ne crée jamais de fichier de différences +entre le fichier de symboles créé et le fichier modèle utilisé comme point +de départ. N'affiche également aucun avertissement à propos de bibliothèques +nouvelles ou disparues ou de symboles nouveaux ou disparus. Cette option ne +désactive que l'affichage informatif, mais pas les contrôles eux\-mêmes (voir +l'option \fB\-c\fP). +.TP +\fB\-a\fP\fIarch\fP +Définit \fIarch\fP comme architecture lors du traitement des fichiers de +symboles. Cette option permet de créer un fichier de symboles ou un fichier +de différences pour n'importe quelle architecture, à condition que les +fichiers binaires correspondants soient déjà disponibles. +.TP +\fB\-d\fP +Active le mode bavard. De nombreux messages sont affichés pour expliquer ce +que \fBdpkg\-gensymbols\fP fait. +.TP +\fB\-V\fP +Active le mode bavard. Le fichier de symboles créé contiendra les symboles +dépréciés sous forme de commentaires. De plus, en mode modèle, les motifs de +symboles seront suivis de commentaires affichant les symboles réels qui +correspondent au motif. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_GENSYMBOLS_CHECK_LEVEL\fP +Remplace le niveau de vérification de commande, même si l'argument en ligne +de commande \fB\-c\fP a été donné (notez que cela va à l'encontre de la +convention générale qui veut que les arguments en ligne de commande ont la +préséance sur les variables d'environnement). +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH "VOIR AUSSI" +\fBhttps://people.redhat.com/drepper/symbol\-versioning\fP +.br +\fBhttps://people.redhat.com/drepper/goodpractice.pdf\fP +.br +\fBhttps://people.redhat.com/drepper/dsohowto.pdf\fP +.br +\fBdeb\-symbols\fP(5), \fBdpkg\-shlibdeps\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-maintscript-helper.man b/man/fr/dpkg-maintscript-helper.man new file mode 100644 index 0000000..938d718 --- /dev/null +++ b/man/fr/dpkg-maintscript-helper.man @@ -0,0 +1,299 @@ +.\" dpkg manual page - dpkg-maintscript-helper(1) +.\" +.\" Copyright © 2010-2012 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2011-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-maintscript\-helper 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-maintscript\-helper \- Contournement des limitations connues de dpkg dans +les scripts du responsable +. +.SH SYNOPSIS +\fBdpkg\-maintscript\-helper\fP \fIcommande\fP [\fIparamètre\fP...] \fB\-\-\fP +\fIparamètre\-script\-responsable\fP... +. +.SH "COMMANDES ET PARAMÈTRES" +.P +\fBsupports\fP \fIcommande\fP +.P +\fBrm_conffile\fP \fIfichier\-de\-configuration\fP [\fIversion\-précédente\fP +[\fIpaquet\fP]] +.P +\fBmv_conffile\fP \fIancien\-fichier\-de\-configuration\fP +\fInouveau\-fichier\-de\-configuration\fP [\fIdernière\-version\fP [\fIpaquet\fP]] +.P +\fBsymlink_to_dir\fP \fInom\-de\-chemin\fP \fIancienne\-cible\fP [\fIversion\-précédente\fP +[\fIpaquet\fP]] +.P +\fBdir_to_symlink\fP \fInom\-de\-chemin\fP \fInouvelle\-cible\fP [\fIversion\-précédente\fP +[\fIpaquet\fP]] +. +.SH DESCRIPTION +.P +Ce programme est prévu pour être exécuté dans les scripts du responsable +afin de réaliser certaines tâches que \fBdpkg\fP ne peut pas (encore) prendre +en charge directement à cause de limites de conception ou de limitations +actuelles. +.P +La plupart de ces tâches nécessitent la coordination de plusieurs scripts du +responsable (\fBpreinst\fP, \fBpostinst\fP, \fBprerm\fP, \fBpostrm\fP). Pour éviter des +erreurs, le même appel a simplement besoin d'être placé dans tous les +scripts. Le programme adaptera alors son comportement en fonction de la +variable d'environnement \fBDPKG_MAINTSCRIPT_NAME\fP et des paramètres des +scripts du responsable qui doivent être passés avec un double tiret. +. +.SH "PARAMÈTRES COMMUNS" +.TP +\fIversion\-précédente\fP +Indique la dernière version du paquet pour laquelle la mise à niveau doit +provoquer l'opération. Il est important de déterminer correctement +\fIversion\-précédente\fP afin que les opérations s'accomplissent correctement +même si l'utilisateur reconstruit le paquet avec une version locale. Si le +paramètre \fIversion\-précédente\fP est vide ou omis, l'opération sera tentée à +chaque mise à niveau (il est toutefois plus sûr d'indiquer la version afin +que l'opération n'ait lieu qu'une fois). + +Si le fichier de configuration n'était pas fourni pour une raison ou une +autre dans plusieurs versions et que vous modifiez les scripts du +responsable pour nettoyer l'ancien fichier, \fIversion\-précédente\fP doit être +basé sur la version actuellement préparée et non la première version qui ne +fournissait plus ce fichier de configuration. Cela s'applique à toutes les +autres actions de la même manière + +Par exemple, pour un fichier de configuration supprimé dans la version +\fB2.0\-1\fP d'un paquet, \fIversion\-précédente\fP doit être \fB2.0\-1~\fP. Cela +provoquera la suppression du fichier même si la version précédente \fB1.0\-1\fP +a été reconstruite avec \fB1.0\-1local1\fP comme numéro de version. Ou bien, si +un paquet substitue un chemin d'un lien symbolique (fourni dans la version +\fB1.0\-1\fP) à un répertoire (fourni dans la version \fB2.0\-1\fP), mais ne réalise +réellement la substitution que dans les scripts du responsable dans la +version \fB3.0\-1\fP, \fIversion\-précédente\fP doit être \fB3.0\-1~\fP. +.TP +\fIpaquet\fP +Le nom du paquet propriétaire du (des) nom(s) de chemin. Si le paquet est +«\ Multi\-Arch: same\ » ce paramètre doit inclure le type d'architecture, +sinon, il ne devrait \fBpas\fP habituellement inclure le type d'architecture +(parce qu'il pourrait interdire les catégories croisées, ou le passage d'une +architecture spécifique à architecture \fBall\fP ou vice\-versa). Si le +paramètre est vide ou omis, les variables d'environnement +\fBDPKG_MAINTSCRIPT_PACKAGE\fP et \fBDPKG_MAINTSCRIPT_ARCH\fP (telles que définies +par \fBdpkg\fP lors de l'exécution des scripts du responsable) seront utilisées +pour créer un nom de paquet avec une qualification d'architecture. +.TP +\fB\-\-\fP +Tous les paramètres des scripts du responsable doivent être passés au +programme après \fB\-\-\fP. +.SH "TÂCHES LIÉES AUX FICHIERS DE CONFIGURATION" +.P +Lors de la mise à niveau d'un paquet, \fBdpkg\fP ne supprime pas un fichier de +configuration automatiquement (comportant des modifications locales à +préserver) s'il n'est pas présent dans la nouvelle version. Il existe deux +raisons principales à cela. En premier lieu, le fichier de configuration +peut avoir été supprimé par accident, être réintégré dans la version +suivante et il peut être nécessaire de retrouver les modifications +locales. Ensuite, l'objectif est également de permettre d'effectuer la +transition depuis des fichiers de configuration gérés par dpkg vers un +fichier géré à l'aide des scripts du responsable, en général à l'aide d'un +outil comme debconf ou ucf. +.P +Cela signifie que si un paquet a besoin de renommer ou supprimer un fichier +de configuration, il doit le faire explicitement. L'objectif de +\fBdpkg\-maintscript\-helper\fP est donc de fournir des méthodes de suppression +ou renommage de fichiers de configuration à l'aide de scripts du +responsable. +. +.SS "Supprimer un fichier de configuration" +.P +Si un fichier de configuration est complètement supprimé, il doit être +effacé du disque sauf si l'administrateur local l'a modifié. Les éventuelles +modifications locales doivent être conservées. Si la mise à jour du paquet +est interrompue, le fichier de configuration rendu obsolète ne doit pas +avoir disparu. +.P +L'ensemble de ces pré\-requis est mis en œuvre en utilisant les commandes +shell suivantes dans les scripts \fBpreinst\fP, \fBpostinst\fP et \fBpostrm\fP\ : +.P + dpkg\-maintscript\-helper rm_conffile \e + \fIfichier\-de\-configuration\fP \fIversion\-précédente\fP \fIpaquet\fP \-\- "$@" +.P +\fIfichier\-de\-configuration\fP est le nom du fichier de configuration à +supprimer. +.P +Détails de la mise en œuvre actuelle\ :\ dans le script \fBpreinst\fP, il est +vérifié si le fichier de configuration a été modifié. Celui\-ci est alors +renommé, soit en \fIfichier\-de\-configuration\fP\fB.dpkg\-remove\fP s'il n'a pas été +modifié, soit en \fIfichier\-de\-configuration\fP\fB.dpkg\-backup\fP s'il l'a +été. Dans le script \fBpostinst\fP, ce dernier fichier est ensuite renommé en +\fIfichier\-de\-configuration\fP\fB.dpkg\-bak\fP et conservé pour référence puisqu'il +contient des modifications locales, mais le premier est supprimé. Si la mise +à jour du paquet est interrompue, le script \fBpostrm\fP remet en place le +fichier de configuration d'origine. À la purge du paquet, le script +\fBpostrm\fP supprimera également le fichier \fB.dpkg\-bak\fP qui avait été +conservé jusque là. +. +.SS "Renommer un fichier de configuration" +.P +Si un fichier de configuration est déplacé à un autre endroit, il est +nécessaire de garantir la préservation des modifications locales. À première +vue, cela peut sembler être une simple modification dans le script +\fBpreinst\fP, mais cela risque de résulter en une demande, par \fBdpkg\fP, +d'approbation de modifications locales qui n'existent pas réellement. +.P +Un renommage élégant peut être mis en œuvre avec les extraits shell qui +suivent, dans les scripts \fBpreinst\fP, \fBpostinst\fP et \fBpostrm\fP\ : +.P + dpkg\-maintscript\-helper mv_conffile \e + \fIancien\-fichier\-configuration\fP \fInouveau\-fichier\-configuration\fP \fIversion\-précédente\fP \fIpaquet\fP \-\- "$@" +.P +\fIancien\-fichier\-configuration\fP et \fInouveau\-fichier\-configuration\fP sont +l'ancien et le nouveau nom du fichier de configuration à renommer. +.P +Détails de la mise en œuvre actuelle\ :\ dans le script \fBpreinst\fP, il est +vérifié si le fichier de configuration a été modifié. Celui\-ci est alors +soit laissé en place s'il a été modifié, soit renommé en +\fIancien\-fichier\-configuration\fP\fB.dpkg\-remove\fP s'il ne l'a pas été. Lors de +la configuration, le script \fBpostinst\fP supprime +\fIancien\-fichier\-configuration\fP\fB.dpkg\-remove\fP et renomme +\fIancien\-fichier\-configuration\fP et \fInouveau\-fichier\-configuration\fP si +\fIancien\-fichier\-configuration\fP existe toujours. Si la mise à jour ou +l'installation sont interrompues, le script \fBpostrm\fP renomme +\fIancien\-fichier\-configuration\fP\fB.dpkg\-remove\fP en +\fIancien\-fichier\-configuration\fP si c'est indispensable. +. +.SH "SUBSTITUTIONS DE LIENS SYMBOLIQUES ET DE RÉPERTOIRES" +. +Lors de la mise à niveau d'un paquet, \fBdpkg\fP ne substitue pas +automatiquement un lien symbolique à un répertoire ou le contraire. Les +retours à une version inférieure ne sont pas pris en charge et le chemin +sera laissé comme il est. +. +.SS "Substituer un lien symbolique à un répertoire" +. +Si un lien symbolique est substitué à un répertoire réel, il est nécessaire +de garantir qu'avant le dépaquetage le lien symbolique est retiré. À +première vue, cela peut sembler être une simple modification dans le script +\fBpreinst\fP, mais cela risque de résulter en problèmes si l'administrateur +local a personnalisé le lien symbolique ou si l'on revient à une version +antérieure du paquet. +.P +Un renommage élégant peut être mis en œuvre avec les extraits shell qui +suivent, dans les scripts \fBpreinst\fP, \fBpostinst\fP et \fBpostrm\fP\ : +.P + dpkg\-maintscript\-helper symlink_to_dir \e + \fInom\-de\-chemin\fP \fIancienne\-cible\fP \fIversion\-précédente\fP \fIpaquet\fP \-\- "$@" +.P +\fInom\-de\-chemin\fP est le nom absolu de l'ancien lien symbolique (le chemin +sera un répertoire à la fin de l'installation) et \fIancienne\-cible\fP la cible +de l'ancien lien symbolique vers \fInom\-de\-chemin\fP. Cela peut être un chemin +absolu ou relatif vers le répertoire contenant \fInom\-de\-chemin\fP. +.P +Détails de la mise en œuvre actuelle\ : dans le script \fBpreinst\fP, il est +vérifié si le lien symbolique existe et pointe vers \fIancienne\-cible\fP. Si ce +n'est pas le cas, il est alors soit laissé en place, soit renommé en +\fInom\-de\-chemin\fP\fB.dpkg\-backup\fP. Lors de la configuration, le script +\fBpostinst\fP supprime \fInom\-de\-chemin\fP\fB.dpkg\-backup\fP si +\fInom\-de\-chemin\fP\fB.dpkg\-backup\fP est encore un lien symbolique. Si la mise à +niveau ou l'installation sont interrompues, le script \fBpostrm\fP renomme +\fInom\-de\-chemin\fP\fB.dpkg\-backup\fP en \fInom\-de\-chemin\fP si c'est indispensable. +. +.SS "Substituer un répertoire à un lien symbolique" +. +Si un répertoire réel est substitué à un lien symbolique, il est nécessaire +de garantir qu'avant le dépaquetage le répertoire est retiré. À première +vue, cela peut sembler être une simple modification dans le script +\fBpreinst\fP, mais cela risque de résulter en problèmes si le répertoire +contient des fichiers de configuration, des noms de chemins qui +appartiennent à d'autres paquets, des noms de chemin créés localement ou si +l'on revient à une version antérieure du paquet. +.P +Une substitution élégante peut être mise en œuvre avec les extraits shell +qui suivent, dans les scripts \fBpreinst\fP, \fBpostinst\fP et \fBpostrm\fP\ : +.P + dpkg\-maintscript\-helper dir_to_symlink \e + \fInom\-de\-chemin\fP \fInouvelle\-cible\fP \fIversion\-précédente\fP \fIpaquet\fP \-\- "$@" +.P +\fInom\-de\-chemin\fP est le nom absolu de l'ancien répertoire (le chemin sera un +lien symbolique à la fin de l'installation) et \fInouvelle\-cible\fP la cible du +nouveau lien symbolique vers \fInom\-de\-chemin\fP. Cela peut être un chemin +absolu ou relatif vers le répertoire contenant \fInom\-de\-chemin\fP. +.P +Détails de la mise en œuvre actuelle\ : dans le script \fBpreinst\fP, il est +vérifié si le répertoire existe et ne contient pas de fichiers de +configuration, de noms de chemin qui appartiennent à d'autres paquets, de +noms de chemin créés localement. Si ce n'est pas le cas, il est alors soit +laissé en place, soit renommé en \fInom\-de\-chemin\fP\fB.dpkg\-backup\fP et un +répertoire vide provisoire nommé \fInom\-de\-chemin\fP est créé, marqué par un +fichier pour que dpkg le suive. Lors de la configuration, le script +\fBpostinst\fP achève la substitution si \fInom\-de\-chemin\fP\fB.dpkg\-backup\fP est +encore un répertoire et si \fInom\-de\-chemin\fP est le répertoire provisoire. Il +supprime le fichier qui marque le fichier provisoire et déplace les fichiers +nouvellement créés dans le répertoire provisoire vers la cible du lien +symbolique \fInouvelle\-cible\fP, remplace le répertoire provisoire +\fInom\-de\-chemin\fP, maintenant vide, par un lien symbolique vers la +\fInouvelle\-cible\fP et, enfin supprime \fInom\-de\-chemin\fP\fB.dpkg\-backup\fP. Si la +mise à niveau ou l'installation sont interrompues, le script \fBpostrm\fP +renomme \fInom\-de\-chemin\fP\fB.dpkg\-backup\fP en \fInom\-de\-chemin\fP si c'est +indispensable. +. +.SH "INTÉGRATION DANS LES PAQUETS" +.P +Lors de l'utilisation d'un assistant d'empaquetage, veuillez vérifier s'il +ne dispose pas d'une intégration native de \fBdpkg\-maintscript\-helper\fP ce qui +vous facilitera la tâche. Voir par exemple \fBdh_installdeb\fP(1). +.P +Comme \fBdpkg\-maintscript\-helper\fP est utilisé dans le script \fBpreinst\fP, +l'utiliser sans conditions impose une pré\-dépendance afin de garantir que la +version minimale nécessaire de \fBdpkg\fP ait bien été préalablement +configurée. La version minimale dépend de la commande utilisée\ : ainsi pour +\fBrm_conffile\fP et \fBmv_conffile\fP, cette version est\ 1.15.7.2, pour +\fBsymlink_to_dir\fP et \fBdir_to_symlink\fP, c'est\ 1.17.14\ : +.P + \fBPre\-Depends:\fP dpkg (>= 1.17.14) +.P +Cependant, dans de nombreux cas, l'opération réalisée par le programme n'est +pas critique pour le paquet et au lieu d'utiliser une pré\-dépendance, il est +possible de ne lancer le programme que si on a la certitude que la commande +nécessaire est gérée par la version actuellement installée de \fBdpkg\fP\ : +.P + if dpkg\-maintscript\-helper supports \fIcommande\fP; then + dpkg\-maintscript\-helper \fIcommande\fP ... + fi +.P +La commande \fBsupports\fP retournera \fB0\fP en cas de réussite, \fB1\fP +autrement. Elle vérifiera si les variables d'environnement telles que +définies par \fBdpkg\fP et requises par le script sont présentes, et +considérera que c'est un échec si l'environnement n'est pas suffisant. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Fixe le mode de couleur (depuis dpkg\ 1.19.1). Les valeurs admises +actuellement sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +. +.SH "VOIR AUSSI" +.ad l +\fBdh_installdeb\fP(1) +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-mergechangelogs.man b/man/fr/dpkg-mergechangelogs.man new file mode 100644 index 0000000..5aacd5c --- /dev/null +++ b/man/fr/dpkg-mergechangelogs.man @@ -0,0 +1,106 @@ +.\" dpkg manual page - dpkg-mergechangelogs(1) +.\" +.\" Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-mergechangelogs 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-mergechangelogs \- Fusion triple de fichiers debian/changelog +. +.SH SYNOPSIS +\fBdpkg\-mergechangelogs\fP [\fIoption\fP...] \fIancien\fP \fInouveau\-a\fP \fInouveau\-b\fP +[\fIsortie\fP] +. +.SH DESCRIPTION +.P +Ce programme utilise les 3 versions fournies de journal des modifications +(«\ changelog\ ») Debian pour créer un fichier de journalisation fusionné. Le +résultat est placé dans le fichier \fIsortie\fP ou affiché sur la sortie +standard si ce paramètre est omis. +.P +Chaque entrée est identifiée par son numéro de version. Les entrées ne sont +pas censées entrer en conflit, mais sont simplement fusionnées dans le bon +ordre (par numéro de version décroissant). Si l'option +\fB\-\-merge\-prereleases\fP est utilisée, la partie de numéro de version qui suit +le dernier caractère tilde est omise\ ; les versions 1.0\-1~exp1 et 1.0\-1~exp5 +sont ainsi considérées comme la même entrée. Quand la même version est +mentionnée dans \fInouveau\-a\fP et \fInouveau\-b\fP, une fusion «\ 3\-way\ » standard +est tentée (sous réserve que le module Algorithm::Merge soit disponible —\ il +est fourni par le paquet libalgorithm\-merge\-perl. Dans le cas contraire, un +conflit global est créé dans le contexte de cette entrée. +. +.SH OPTIONS +.TP +\fB\-m\fP, \fB\-\-merge\-prereleases\fP +Omet la version qui suit le dernier caractère tilde dans les numéros de +versions, lors de la comparaison qui permet d'identifier si deux entrées +sont les mêmes ou pas. +.sp +Cette option est utile lorsqu'on conserve la même entrée de journal mais que +la version est incrémentée régulièrement. Par exemple, cela permet +d'utiliser les numéros 2.3\-1~exp1, 2.3\-1~exp2, etc., jusqu'à une publication +officielle numérotée 2.3\-1, toutes ces versions étant considérées comme +l'évolution dans le temps de la même version. +.TP +\fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH LIMITATIONS +.P +Tout ce qui ne peut pas être analysé par Dpkg::Changelog est perdu lors de +la fusion. Cela peut comprendre des commentaires qui ne sont pas censés se +trouver là,\ etc. +. +.SH "INTÉGRATION AVEC GIT" +.P +Si vous souhaitez utiliser ce programme pour fusionner des journaux de +modifications Debian dans un dépôt git, vous devez tout d'abord enregistrer +un nouveau pilote de fusion dans \fB.git/config\fP ou \fB~/.gitconfig\fP\ : +.P + [merge "dpkg\-mergechangelogs"] + name = debian/changelog merge driver + driver = dpkg\-mergechangelogs \-m %O %A %B %A +.P +Vous devez ensuite configurer l'attribut de fusion pour le fichier +debian/changelog, soit dans \fB.gitattributes\fP du dépôt lui\-même, soit dans +\&\fB.git/info/attributes\fP\ : +.P + debian/changelog merge=dpkg\-mergechangelogs +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-name.man b/man/fr/dpkg-name.man new file mode 100644 index 0000000..149afa4 --- /dev/null +++ b/man/fr/dpkg-name.man @@ -0,0 +1,127 @@ +.\" dpkg manual page - dpkg-name(1) +.\" +.\" Copyright © 1995-1996 Erick Branderhorst +.\" Copyright © 2007-2013, 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-name 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-name \- Redonne aux paquets Debian leur nom complet +. +.SH SYNOPSIS +\fBdpkg\-name\fP [\fIoption\fP...] [\fB\-\-\fP] \fIfichier\fP... +. +.SH DESCRIPTION +.PP +Cette page de manuel documente le programme \fBdpkg\-name\fP qui fournit une +façon simple de redonner aux paquets \fBDebian\fP leur nom complet. Ce nom +consiste en une chaîne +\fIpaquet\fP\fB_\fP\fIversion\fP\fB_\fP\fIarchitecture\fP\fB.\fP\fItype\-de\-paquet\fP telle +qu'elle est indiquée dans le fichier «\ control\ » du paquet. La partie +\fIversion\fP du nom est composée d'informations sur la version originelle qui +peuvent ou non être suivies d'un trait d'union et d'informations sur la +révision. La partie \fItype\-de\-paquet\fP provient de ce champ s'il existe. La +valeur par défaut est \fBdeb\fP. +. +.SH OPTIONS +.TP +\fB\-a\fP, \fB\-\-no\-architecture\fP +Le nom du fichier n'aura pas l'information sur l'architecture. +.TP +\fB\-k\fP, \fB\-\-symlink\fP +Fait un lien symbolique plutôt qu'une transposition. +.TP +\fB\-o\fP, \fB\-\-overwrite\fP +Remplace des fichiers existants s'ils ont le même nom que le fichier de +destination. +.TP +\fB\-s\fP, \fB\-\-subdir\fP [\fIrep\fP] +Met les fichiers dans un sous\-répertoire. Si le répertoire donné en +paramètre existe, les fichiers sont déplacés dans ce répertoire\ ; sinon le +répertoire cible, extrait du champ «\ section\ » que contient la partie +contrôle du paquet, sera +«\ unstable/binary\-\fIarchitecture\fP/\fIsection\fP\ ». Quand aucune information sur +la section n'est trouvée dans le fichier «\ control\ », la section est +supposée être \fBno\-section\fP. Dans ce cas, ainsi que si la section est +\fBnon\-free\fP ou \fBcontrib\fP, le répertoire cible est +«\ \fIsection\fP/binary\-\fIarchitecture\fP\ ». Le champ «\ section\ » est facultatif\ ; +aussi beaucoup de paquets sont dans la zone «\ no\-section\ ». Utilisez cette +option avec précaution\ : elle est compliquée. +.TP +\fB\-c\fP, \fB\-\-create\-dir\fP +On peut utiliser cette option avec l'option \fB\-s\fP. Quand un répertoire cible +n'est pas trouvé, il est créé automatiquement. \fBUtilisez cette option avec +soin.\fP +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-v\fP, \fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH BOGUES +Certains paquets ne respectent pas l'organisation +\fIpaquet\fP\fB_\fP\fIversion\fP\fB_\fP\fIarchitecture\fP\fB.deb\fP. Les paquets traités par +\fBdpkg\-name\fP la respectent. Cela n'a pas de conséquence sur la façon dont +\fBdselect\fP(1) ou \fBdpkg\fP(1) installent les paquets, mais il se peut que +d'autres systèmes d'installation aient besoin de cette organisation. +. +.SH EXEMPLES +.TP +\fBdpkg\-name bar\-foo.deb\fP +Le nom du fichier \fIbar\-foo.deb\fP devient \fIbar\-foo_1.0\-2_i386.deb\fP ou +quelque chose de similaire suivant les renseignements que contient la partie +de contrôle de \fIbar\-foo.deb\fP. +.TP +\fBfind /root/debian/ \-name '*.deb' | xargs \-n 1 dpkg\-name \-a\fP +Cette commande \fBdpkg\-name\fP redonne leur nom complet à tous les fichiers qui +se trouvent dans le répertoire /root/debian et ses sous\-répertoires et qui +possèdent une extension \fBdeb\fP, mais supprime l'information sur +l'architecture. +.TP +\fBfind \-name '*.deb' | xargs \-n 1 dpkg\-name \-a \-o \-s \-c\fP +\fBNe faites pas ça\ !\fP L'archive sera complètement gâchée par des paquets qui +ne possèdent pas d'informations sur la section. \fBNe faites pas ça\ !\fP +.TP +\fBdpkg\-deb \-\-build debian\-tmp && dpkg\-name \-o \-s .. debian\-tmp.deb\fP +On peut se servir de cette commande lors de la construction d'un nouveau +paquet. +. +.SH "VOIR AUSSI" +\fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg\fP(1), \fBdpkg\-deb\fP(1), \fBfind\fP(1), +\fBxargs\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-parsechangelog.man b/man/fr/dpkg-parsechangelog.man new file mode 100644 index 0000000..ab88d34 --- /dev/null +++ b/man/fr/dpkg-parsechangelog.man @@ -0,0 +1,233 @@ +.\" dpkg manual page - dpkg-parsechangelog(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006, 2011-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2007-2008 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2009 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-parsechangelog 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-parsechangelog \- Analyse un fichier changelog Debian. +. +.SH SYNOPSIS +\fBdpkg\-parsechangelog\fP [\fIoption\fP...] +. +.SH DESCRIPTION +\fBdpkg\-parsechangelog\fP lit et fait l'analyse du fichier «\ changelog\ » d'une +arborescence source dépaquetée et affiche les informations qu'il contient +sur la sortie standard et sous une forme lisible par la machine. +. +.SH OPTIONS +.TP +\fB\-l\fP, \fB\-\-file\fP \fIfichier\-des\-changements\fP +Indique le fichier des changements où trouver des renseignements. Un «\ \-\ » +peut être utilisé pour spécifier une lecture à partir de l'entrée +standard. Par défaut, c'est le fichier \fBdebian/changelog\fP. +.TP +\fB\-F\fP \fIformat\-du\-fichier\-des\-changements\fP +Indique le format du fichier changelog. Par défaut, c'est une ligne +spéciale, près de la fin du fichier, qui l'indique\ ; sinon, on utilise le +format classique \fBdebian\fP. Voir aussi \fBFORMATS DES FICHIERS DE +CHANGEMENTS\fP. +.TP +\fB\-L\fP \fIrep_lib\fP +Option obsolète sans effet (depuis dpkg\ 1.18.8). Fixer les variables +d'environnement de Perl \fBPERL5LIB\fP ou \fBPERLLIB\fP a un effet similaire lors +de la recherche des modules d'analyse de Perl. +.TP +\fB\-S\fP, \fB\-\-show\-field\fP \fIchamp\fP +Indique le nom du champ à afficher (depuis dpkg\ 1.17.0). Le nom du champ +n'est pas affiché, mais seulement sa valeur. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +.SS "Options de filtrage" +Les options suivantes peuvent être utilisées pour influencer la sortie de +l'analyseur du journal des modifications («\ changelog\ »), par exemple la +gamme d'entrées ou le format de sortie. +.TP +\fB\-\-format\fP\fI format\-de\-sortie\fP +Règle le format de sortie. Actuellement les valeurs gérées sont \fIdpkg\fP et +\fBrfc822\fP. \fIdpkg\fP est le format classique de sortie (avant que cette option +n'existe) et l'option par défaut. Il se compose d'un paragraphe dans le +format du fichier de contrôle Debian (voir \fBdeb\-control\fP(5)). Si plus d'une +entrée est demandée, alors la plupart des champs sont tirés de la première +entrée (habituellement la plus récente), sauf si c'est indiqué autrement. +.RS +.TP +\fBSource:\fP\fI nom\-du\-paquet\fP +.TP +\fBVersion:\fP\fI version\fP +.TP +\fBDistribution:\fP\fI distribution\-cible\fP +.TP +\fBUrgency:\fP\fI priorité\fP +La priorité la plus élevée de toutes les entrées incluses est utilisée, +suivie par les commentaires concaténés et séparés par des espaces pour +toutes les versions demandées. +.TP +\fBMaintainer:\fP\fI auteur\fP +.TP +\fBDate:\fP\fI date\fP +La date de l'entrée sous forme d'une chaîne, telle qu'elle apparaît dans le +changelog. Avec un format \fBstrptime\fP(3) «\ \fB%a, %d %b %Y %T %z\fP\ » mais où +le nom du jour de la semaine pourrait ne pas vraiment correspondre au jour +réel obtenu à partir du reste de la chaîne de date. Si une représentation +plus précise du jour est nécessaire, utilisez le champ \fBTimestamp\fP, mais il +faut prendre en compte qu'il pourrait ne pas être possible de la faire +correspondre à la valeur exacte de ce champ. +.TP +\fBTimestamp:\fP \fIhorodatage\fP +La date de l'entrée comme horodatage en secondes depuis «\ l'epoch\ » (depuis +dpkg\ 1.18.8). +.TP +\fBCloses:\fP\fI numéro\-bogue\fP +Les champs «\ Closes\ » de toutes les entrées incluses sont fusionnés. +.TP +\fBChanges:\fP\fI entrées\-du\-fichier\-des\-changements\fP +Les textes de toutes les entrées de changelog sont concaténés. Pour faire de +ce champ un champ de contrôle Debian valable, les lignes multiples qui sont +vides sont remplacées par un point \fB«\ .\ »\fP et toutes les lignes sont +indentées par une seule espace. Le contenu exact dépend du format du +changelog. +.RE +.IP +Les champs \fBVersion\fP, \fBDistribution\fP, \fBUrgency\fP, \fBMaintainer\fP et +\fBChanges\fP sont obligatoires. +.IP +Il est possible d'avoir d'autres champs qui sont définis par l'utilisateur. +.IP +Le format \fBrfc822\fP utilise les mêmes champs mais le résultat est un +paragraphe distinct pour chaque entrée du changelog afin que toutes les +métadonnées de chaque entrée soit préservées. +.TP +\fB\-\-reverse\fP +Inclut toutes les modifications en ordre inverse (depuis +dpkg\ 1.19.1). Note\ : pour le format de \fBdpkg\fP, la première entrée sera +l'entrée la plus ancienne. +.TP +\fB\-\-all\fP +Inclut toutes les modifications. Note\ :\ d'autres options deviennent sans +effet lorsque celle\-ci est utilisée. +.TP +\fB\-s\fP, \fB\-\-since\fP \fIversion\fP +.TQ +\fB\-v\fP \fIversion\fP +Inclut tous les changements qui ont suivi la \fIversion\fP. +.TP +\fB\-u\fP, \fB\-\-until\fP \fIversion\fP +Inclut tous les changements qui ont eu lieu avant la \fIversion\fP. +.TP +\fB\-f\fP, \fB\-\-from\fP \fIversion\fP +Inclut tous les changements depuis la \fIversion\fP (incluse). +.TP +\fB\-t\fP, \fB\-\-to\fP \fIversion\fP +Inclut tous les changements apportés jusqu'à la \fIversion\fP comprise. +.TP +\fB\-c\fP, \fB\-\-count\fP \fInombre\fP +.TQ +\fB\-n\fP \fInombre\fP +Inclut ce \fInombre\fP d'entrées depuis le début (ou la fin si le \fInombre\fP est +inférieur à\ 0). +.TP +\fB\-o\fP, \fB\-\-offset\fP \fInombre\fP +Modifie le point de départ pour \fB\-\-count\fP, à compter du début (ou la fin si +le \fInombre\fP est inférieur à\ 0). +. +.SH "FORMATS DE JOURNAUX DE MODIFICATIONS" +Il est possible d'utiliser un format différent de celui utilisé +habituellement, en fournissant un analyseur pour le format alternatif. + +Afin que \fBdpkg\-parsechangelog\fP utilise le nouvel analyseur, il doit exister +une ligne, parmi les 40\ dernières du fichier, qui corresponde à l'expression +régulière Perl “\fB\eschangelog\-format:\es+([0\-9a\-z]+)\eW\fP\ (la partie entre +parenthèses doit être le nom du format). Exemple\ : + + @@@ changelog\-format: \fIautreformat\fP @@@ + +Les noms de formats de journaux de modifications sont des chaînes non vides +de caractères alphanumériques en minuscules («\ a\-z0\-9\ »). + +Si une telle ligne existe, \fBdpkg\-parsechangelog\fP recherchera l'analyseur +sous le nom du module Perl \fBDpkg::Changelog::\fP\fIautreformat\fP\ ; s'il n'est +pas présent, c'est une condition d'erreur. Le nom de l'analyseur dans le +module Perl sera automatiquement mis en capitale. Le format de journaux des +modifications par défaut est \fBdebian\fP et un analyseur pour ce format est +fourni par défaut. + +L'analyseur doit être dérivée de la classe Dpkg::Changelog et implémenter +l'interface documentée requise. + +Si le format du journal des modifications analysé laisse toujours ou presque +une ligne blanche entre chaque changement, ces lignes blanches devraient +être retirées, afin de rendre l'affichage de sortie plus compact. + +Si le journal des modifications ne contient pas d'informations de date ou de +nom de paquet, cette information doit être omise de l'affichage. L'analyseur +ne doit pas essayer de les calculer ou de les retrouver depuis d'autres +sources. + +Si le journal des modifications n'utilise pas le format attendu, l'analyseur +produira une erreur, plutôt que d'essayer de s'en tirer comme il peut et +produire une sortie incorrecte. + +Un analyseur de journal de modifications ne doit pas du tout interagir avec +l'utilisateur. +. +.SH NOTES +Toutes les \fBoptions d'analyse\fP sauf \fB\-v\fP sont gérées par \fBdpkg\fP seulement +depuis la version\ 1.14.16. +.PP +Analyse des options courtes avec des valeurs non\-groupées, disponible +seulement à partir de dpkg 1.18.0. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH FICHIERS +.TP +\fBdebian/changelog\fP +Le journal des modifications\ ; on s'en sert pour connaître les informations +qui dépendent d'une version du paquet source, par exemple l'urgence ou la +distribution d'une installation sur le serveur, les modifications faites +depuis telle édition et le numéro de la version source lui\-même. +. +.SH "VOIR AUSSI" +\fBdeb\-changelog\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-query.man b/man/fr/dpkg-query.man new file mode 100644 index 0000000..0e59bf1 --- /dev/null +++ b/man/fr/dpkg-query.man @@ -0,0 +1,380 @@ +.\" dpkg manual page - dpkg-query(1) +.\" +.\" Copyright © 2001 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006-2007 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2006-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2008-2011 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-query 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-query \- Un outil pour interroger la base de données de dpkg +. +.SH SYNOPSIS +\fBdpkg\-query\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBdpkg\-query\fP est un outil pour afficher des informations sur les paquets +connus par la base de données de \fBdpkg\fP. +. +.SH COMMANDES +.TP +\fB\-l\fP, \fB\-\-list\fP [\fImotif\-de\-nom\-de\-paquet\fP...] +Affiche les paquets correspondant à un ou plusieurs motifs, quelque soit +leur statut, ce qui comprend tout paquet réel ou virtuel référencé dans tout +champ de relation de dépendance (tel que \fBBreaks\fP, \fBEnhances\fP,\ etc.). Si +aucun \fImotif\-de\-nom\-de\-paquet\fP n'est indiqué, affiche tous les paquets de +\fI%ADMINDIR%/status\fP, sauf ceux qui ne sont pas installés (c'est\-à\-dire ceux +qui ont été précédemment purgés). Les métacaractères ordinaires de +l'interpréteur de commandes sont autorisés dans +\fImotif\-de\-nom\-de\-paquet\fP. Il faudra sans doute mettre +\fImotif\-de\-nom\-de\-paquet\fP entre apostrophes pour éviter l'expansion des noms +de fichier par l'interpréteur de commandes. Par exemple, tous les paquets +dont le nom commence par «\ libc6\ » seront affichés par la commande\ : + +.nf +\fBdpkg\-query \-l 'libc6*'\fP +.fi + +Les trois premières colonnes affichées montrent dans l'ordre\ : l'action +souhaitée, l'état du paquet et les erreurs. + +Action souhaitée\ : +.nf + u = Inconnu (Unknown) + i = Installer (Install) + h = Garder (Hold) + r = Supprimer (Remove) + p = Purger (Purge) +.fi + +État du paquet\ : +.nf + n = Non installé (Not\-installed) + c = Fichiers de configuration (Config\-files) + H = Semi\-installé (Half\-installed) + U = Décompressé (Unpacked) + F = Semi\-configuré (Half\-configured) + W = Attente de déclenchements (Triggers\-awaiting) + t = Déclenchements en attente (Triggers\-pending) + i = Installé (Installed) +.fi + +Drapeaux d'erreur\ : +.nf + <empty> = (aucun) + R = Réinstallation requise (Reinst\-required) +.fi + +Un état en majuscules ou une lettre d'erreur indiquent que le paquet peut +provoquer des problèmes graves. Veuillez consulter \fBdpkg\fP(1) à propos des +états et drapeaux ci\-dessus. + +On ne peut pas configurer le format de sortie de cette option. Il s'adapte +automatiquement à la largeur du terminal. Ce format est destiné aux humains +et la machine le lit mal. Voyez \fB\-W\fP (\fB\-\-show\fP) et \fB\-\-showformat\fP pour +une possible configuration de ce format. +.TP +\fB\-W\fP, \fB\-\-show\fP [\fImotif\-de\-nom\-de\-paquet\fP...] +Tout comme l'option \fB\-\-list\fP, cette option affiche la liste des paquets qui +correspondent au motif donné. La sortie peut cependant être formatée en +utilisant l'option \fB\-\-showformat\fP. Le format de sortie par défaut est le +suivant\ : une ligne pour chaque paquet, avec le nom (éventuellement complété +par l'identifiant d'architecture pour les paquets \fBMulti\-Arch\fP \fBsame\fP) et +la version installée, séparés par une tabulation. +.TP +\fB\-s\fP, \fB\-\-status\fP [\fInom\-du\-paquet\fP ...] +Donne l'état du paquet indiqué. C'est simplement l'affichage de l'entrée de +la base de données concernant les états des paquets installés. Si aucun +\fInom\-de\-paquet\fP n'est indiqué, toutes les entrées de paquet dans la base de +données d'état seront affichées (depuis dpkg\ 1.19.1). Lorsque des entrées de +\fInom\-de\-paquet\fP multiples sont indiquées, les entrées d'état demandées sont +séparées par une ligne vide et sont dans l'ordre utilisé pour la liste de +paramètres. +.TP +\fB\-L\fP, \fB\-\-listfiles\fP \fInom\-du\-paquet\fP... +Affiche la liste des fichiers du \fInom\-du\-paquet\fP installés sur le +système. Lorsque plusieurs \fInom\-du\-paquet\fP sont indiqués, les différentes +listes de fichiers sont séparées par une ligne vide et elles sont fournies +dans l'ordre de la liste de paramètres. Il faut remarquer cependant que les +fichiers créés par les scripts d'installation propres aux paquets ne sont +pas affichés. +.TP +\fB\-\-control\-list\fP \fInom\-du\-paquet\fP +Affiche les fichiers de contrôle installés sur le système à partir de +\fInom\-du\-paquet\fP (depuis dpkg\ 1.16.5). Ceux\-ci peuvent être utilisés en +paramètres d'entrée de \fB\-\-control\-show\fP. +.TP +\fB\-\-control\-show\fP \fInom\-du\-paquet\fP \fIfichier\-de\-contrôle\fP +Affiche sur la sortie standard le \fIfichier\-de\-contrôle\fP installé sur le +système pour \fInom\-du\-paquet\fP (depuis dpkg\ 1.16.5). +.TP +\fB\-c\fP, \fB\-\-control\-path\fP \fInom\-du\-paquet\fP [\fIfichier\-contrôle\fP] +Affiche les chemins pour les fichiers de contrôle installés sur votre +système pour \fInom\-du\-paquet\fP (depuis dpkg\ 1.15.4). Si \fIfichier\-contrôle\fP +est indiqué, seul le chemin pour ce fichier de contrôle sera affiché, s'il +est présent. + +\fBAttention\fP\ : cette commande est obsolète parce qu'elle donne un accès +direct à la base de données interne de dpkg, et il est conseillé d'utiliser +\fB\-\-control\-list\fP et \fB\-\-control\-show\fP à la place dans tous les cas où ces +commandes peuvent donner le même résultat. Néanmoins,aussi longtemps qu'il y +a un cas au moins où cette commande est nécessaire (c'est\-à\-dire quand il +faut supprimer le script d'un responsable endommageant postrm), et tant +qu'il n'y aura pas de bonne solution pour cela, cette commande ne sera pas +supprimée. +.TP +\fB\-S\fP, \fB\-\-search\fP \fImotif\-de\-nom\-à\-rechercher\fP... +Recherche les paquets propriétaires de fichiers dont le nom correspond au +motif indiqué. On peut utiliser tous les métacaractères de l'interpréteur de +commandes dans le motif, où l'astérisque (\fB*\fP et le point d'interrogation +(\fB?\fP) correspondront à une barre oblique et la barre oblique inverse sert +de caractère d'échappement. + +Si le premier caractère du \fImotif\-de\-nom\-à\-rechercher\fP est aucun des +caractères «\ \fB*[?/\fP\ », il sera alors considéré comme une sous\-chaîne de +correspondance et sera implicitement entouré de «\ \fB*\fP\ » (comme +\fB*\fP\fImotif\-de\-nom\-à\-rechercher\fP\fB*\fP). Si la chaîne suivante contient un des +caractères «\ \fB*[?\e\fP\ », il sera géré comme un motif global, sinon tout +«\ \fB/\fP\ » ou «\ \fB/.\fP\ » terminal sera supprimé et une recherche littérale de +chemin sera exécutée. + +Cette commande ne donne pas les fichiers supplémentaires créés par les +scripts du responsable de paquet, ni les alternatives. +.TP +\fB\-p\fP, \fB\-\-print\-avail\fP [\fInom\-du\-paquet\fP...] +Affiche les détails relatifs aux paquets, tels que présents dans +\fI%ADMINDIR%/available\fP. Si aucun \fInom\-de\-paquet\fP n'est indiqué, toutes les +entrées de paquet dans la base de données d'état seront affichées (depuis +dpkg\ 1.19.1). Lorsque des entrées de \fInom\-de\-paquet\fP multiples sont +indiquées, les entrées \fIavailable\fP demandées sont séparées par une ligne +vide et sont dans l'ordre utilisé pour la liste de paramètres. + +Les utilisateurs des outils basés sur APT devraient plutôt utiliser la +commande \fBapt\-cache show\fP \fInom\-du\-paquet\fP car le fichier \fIavailable\fP +n'est tenu à jour que lorsque \fBdselect\fP est utilisé. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-\-admindir\fP=\fIrépertoire\fP +Change l'endroit où se trouve la base de données de \fBdpkg\fP. Par défaut, +c'est \fI%ADMINDIR%\fP. +.TP +\fB\-\-load\-avail\fP +Charge également le fichier \fIavailable\fP à l'utilisation des commandes +\fB\-\-show\fP et \fB\-\-list\fP, ce qui désormais revient à n'interroger que le +fichier d'état (depuis dpkg\ 1.16.2). +.TP +\fB\-\-no\-pager\fP +Désactive l'utilisation d'un afficheur pour montrer les informations (depuis +dpkg\ 1.19.2). +.TP +\fB\-f\fP, \fB\-\-showformat=\fP\fIformat\fP +Cette option sert à spécifier le format de sortie de l'option \fB\-\-show\fP +(option courte depuis dpkg\ 1.13.1). Ce format est une chaîne qui sera +utilisée pour chaque paquet listé. + +Dans la chaîne, «\ \fB\e\fP\ » préfixe des caractères de contrôle\ : + +.nf + \fB\en\fP nouvelle ligne + \fB\er\fP retour chariot + \fB\et\fP tabulation +.fi + +“\fB\e\fP” avant n'importe quel caractère supprime la signification spécial du +caractère qui suit. C'est utile pour les caractères «\ \fB\e\fP\ » et «\ \fB$\fP\ ». + +L'information relative à un paquet peut être indiquée en insérant des appels +de variables spécifiant des champs du paquet avec la syntaxe suivante\ : +«\ \fB${\fP\fIchamp\fP[\fB;\fP\fIlargeur\fP]\fB}\fP\ ». Les champs sont alignés à droite, à +moins que la largeur ne soit négative, auquel cas ils sont alignés à +gauche. Les champs suivants sont reconnus, mais pas nécessairement +disponibles dans le fichier d'état (seuls les champs internes ou les champs +conservés avec le paquet binaire le sont)\ : + +.nf + \fBArchitecture\fP + \fBBugs\fP + \fBConffiles\fP (interne) + \fBConfig\-Version\fP (interne) + \fBConflicts\fP + \fBBreaks\fP + \fBDepends\fP + \fBDescription\fP + \fBEnhances\fP + \fBEssential\fP + \fBFilename\fP (interne, lié au programme frontal) + \fBHomepage\fP + \fBInstalled\-Size\fP + \fBMD5sum\fP (interne, lié au programme frontal) + \fBMSDOS\-Filename\fP (interne, lié au programme frontal) + \fBMaintainer\fP + \fBOrigin\fP + \fBPackage\fP + \fBPre\-Depends\fP + \fBPriority\fP + \fBProvides\fP + \fBRecommends\fP + \fBReplaces\fP + \fBRevision\fP (obsolète) + \fBSection\fP + \fBSize\fP (interne, lié au programme frontal) + \fBSource\fP + \fBStatus\fP (interne) + \fBSuggests\fP + \fBTag\fP (en général pas dans le .deb mais dans les fichiers + Packages des dépôts) + \fBTriggers\-Awaited\fP (interne) + \fBTriggers\-Pending\fP (interne) + \fBVersion\fP +.fi + +Les champs suivants sont virtuels, créés par \fBdpkg\-query\fP à partir des +valeurs d'autres champs (veuillez noter qu'ils utilisent des noms qui ne +sont pas valables comme noms de champs dans le fichiers de contrôle)\ : +.RS +.TP +\fBbinary:Package\fP +Contient le nom du paquet binaire avec éventuellement le type d'architecture +tel que «\ libc6:amd64\ » (depuis dpkg\ 1.16.2). Le type d'architecture sera +présent pour rendre le nom de paquet non ambigu, par exemple si le champ +\fBMulti\-Arch\fP du paquet a la valeur \fBsame\fP ou si le paquet appartient à une +architecture différente. +.TP +\fBbinary:Synopsis\fP +Il contient la description courte du paquet (depuis dpkg\ 1.19.1). +.TP +\fBbinary:Summary\fP +C'est un alias de \fBbinary:Synopsis\fP (depuis dpkg\ 1.16.2). +.TP +\fBdb:Status\-Abbrev\fP +Il contient l'état du paquet dans sa forme abrégée en trois caractères, +comme «\ ii\ \ » ou «\ iHR\ » (depuis dpkg\ 1.16.2). Voir la description de la +commande \fB\-\-list\fP pour plus de détails. +.TP +\fBdb:Status\-Want\fP +Il contient l'état désiré du paquet, extrait du champ Status (depuis +dpkg\ 1.17.11). +.TP +\fBdb:Status\-Status\fP +Il contient l'expression d'état du paquet, extrait du champ Status (depuis +dpkg\ 1.17.11). +.TP +\fBdb:Status\-Eflag\fP +Il contient le drapeau d'erreur d'état du paquet, extrait du champ Status +(depuis dpkg\ 1.17.11). +.TP +\fBdb\-fsys:Files\fP +Il contient la liste des entrées de paquets du système de fichiers, séparées +par des sauts de lignes (depuis dpkg\ 1.19.3). +.TP +\fBdb\-fsys:Last\-Modified\fP +Il contient l'horodatage en seconde de la dernière date à laquelle les +entrées de paquets du système de fichiers ont été modifiées (depuis +dpkg\ 1.19.3). +.TP +\fBsource:Package\fP +Il contient le nom du paquet source de ce paquet binaire (depuis +dpkg\ 1.16.2). +.TP +\fBsource:Version\fP +Il contient la version du paquet source de ce paquet binaire (depuis +dpkg\ 1.16.2). +.TP +\fBsource:Upstream\-Version\fP +Il contient la version du paquet source amont de ce paquet binaire (depuis +dpkg\ 1.18.16). +.RE +.IP +Le format par défaut est le suivant\ : +«\ \fB${binary:Package}\et${Version}\en\fP\ ». Tous les autres champs du fichier +d'état, par exemple des champs définis par l'utilisateur, peuvent être +demandés. Ils seront affichés mais sans aucune mise en forme et aucune +conversion ou vérification n'est faite. Pour obtenir le nom du responsable +de \fBdpkg\fP et la version installée, exécutez par exemple\ : + +.nf + \fBdpkg\-query \-W \-f='${binary:Package} ${Version}\et${Maintainer}\en' dpkg\fP +.fi +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +La requête demandée s'est correctement déroulée. +.TP +\fB1\fP +La requête demandée a échoué soit totalement, soit partiellement, du fait +qu'aucun fichier ni paquet n'a été trouvé (sauf pour \fB\-\-control\-path\fP, +\fB\-\-control\-list\fP et \fB\-\-control\-show\fP où de telles erreurs sont fatales). +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande +non valable, ou interactions avec le système, telles que des accès à la base +de données, des allocations de mémoire,\ etc. +. +.SH ENVIRONNEMENT +.SS "Environnement externe" +.TP +\fBSHELL\fP +Définit le programme à exécuter lors du lancement d'une commande avec un +shell (depuis dpkg\ 1.19.2). +.TP +\fBPAGER\fP +.TQ +\fBDPKG_PAGER\fP +Définit la commande d'afficheur à utiliser (depuis dpkg\ 1.19.1) qui sera +exécutée avec «\ \fB$SHELL \-c\fP\ ». Si \fBSHELL\fP n'est pas défini, «\ \fBsh\fP\ » sera +utilisé à la place. \fBDPKG_PAGER\fP remplace la variable d'environnement +\fBPAGER\fP (depuis dpkg\ 1.19.2). +.TP +\fBDPKG_ADMINDIR\fP +Si cette variable est positionnée et que l'option \fB\-\-admindir\fP n'est pas +précisée, ce répertoire sera utilisé comme répertoire de données pour +\fBdpkg\fP. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.SS "Environnement interne" +.TP +\fBLESS\fP +Définie à «\ \fB\-FRSXMQ\fP\ » par \fBdpkg\-query\fP, si elle n'est pas déjà fixée, +lors du lancement d'un afficheur (depuis dpkg\ 1.19.2). Pour modifier le +comportement par défaut, cette variable peut être réglée à une autre valeur +y compris une chaîne vide, ou les variables \fBPAGER\fP ou \fBDPKG_PAGER\fP +peuvent être fixées pour désactiver des options spécifiques avec «\ \fB\-+\fP\ », +par exemple \fBDPKG_PAGER="less \-+F"\fP. +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). + +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-scanpackages.man b/man/fr/dpkg-scanpackages.man new file mode 100644 index 0000000..4e4f7f1 --- /dev/null +++ b/man/fr/dpkg-scanpackages.man @@ -0,0 +1,130 @@ +.\" dpkg manual page - dpkg-scanpackages(1) +.\" +.\" Copyright © 1996 Michael Shields <shields@crosslink.net> +.\" Copyright © 2006 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2007, 2009, 2011-2014 Guillem Jover <guillem@debian.org> +.\" Copyright © 2009 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-scanpackages 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-scanpackages \- Créer des fichiers d'index de paquets. +. +.SH SYNOPSIS +\fBdpkg\-scanpackages\fP [\fIoption\fP...] \fIchemin\-de\-binaires\fP +[\fIfichier\-override\fP [\fIpréfixe\-chemin\fP]] \fB>\fP \fIPaquets\fP +. +.SH DESCRIPTION +\fBdpkg\-scanpackages\fP trie une arborescence contenant des paquets binaires +Debian et crée un fichier «\ Packages\ » qui permettra à \fBapt\fP(8), +\fBdselect\fP(1), ou à un autre programme, de savoir quels sont les paquets +installables. Ces fichiers «\ Packages\ » sont semblables à ceux qu'on peut +trouver sur les sites d'archives Debian ou sur des CD. Quand on crée un +répertoire contenant des paquets qu'on veut installer sur un ensemble de +machines, on peut se servir soi\-même de \fBdpkg\-scanpackages\fP. +.PP +\fBNote\fP\ : Pour pouvoir accéder avec \fBapt\fP au fichier «\ Packages\ » créé, il +faudra sans doute le compresser avec \fBxz\fP(1) (qui crée un fichier +Packages.xz), \fBbzip2\fP(1) (qui crée un fichier Packages.bz2) ou \fBgzip\fP(1) +(qui crée un fichier Packages.gz). \fBapt\fP ignore les fichiers «\ Packages\ » +non compressés, sauf pour des sources locales (c'est\-à\-dire les sources +\fBfile://\fP). +.PP +\fIchemin\-de\-binaires\fP est le nom de l'arborescence des paquets binaires (par +exemple \fBcontrib/binary\-i386)\fP que l'on veut traiter. Il vaut mieux qu'il +soit relatif à la racine de l'archive Debian\ ; ainsi chaque champ +«\ Filename\ » dans le nouveau fichier «\ Packages\ » commencera par cette +chaîne. +.PP +\fIfichier\-override\fP est le nom du fichier qui contient les renseignements +sur la manière dont le paquet s'insère dans la distribution (ce fichier peut +être compressé depuis dpkg\ 1.15.5)\ ; voir \fBdeb\-override\fP(5). +.PP +\fIpréfixe\-chemin\fP est une chaîne facultative qui préfixera les champs +«\ Filename\ ». +.PP +S'il existe plusieurs versions d'un paquet, seule la plus récente est +affichée en sortie. Si les paquets ont la même version mais diffèrent par +l'architecture, seul le premier trouvé est utilisé. +. +.SH OPTIONS +.TP +\fB\-t\fP, \fB\-\-type\fP \fItype\fP +Recherche des fichiers *.\fItype\fP, plutôt que \fI*.deb\fP. +.TP +\fB\-e\fP, \fB\-\-extra\-override\fP \fIfichier\fP +Examine \fIfichier\fP à la recherche d'«\ overrides\ » supplémentaires (ce +fichier peut être compressé depuis dpkg\ 1.15.5). Voir +\fBdeb\-extra\-override\fP(5) pour plus d'information sur le format utilisé. +.TP +\fB\-a\fP, \fB\-\-arch\fP \fIarch\fP +Utilise un motif se composant de \fI*_all.deb\fP et de \fI*_arch.deb\fP, plutôt +que de rechercher tous les fichiers debs. +.TP +\fB\-h\fP, \fB\-\-hash\fP \fIliste\-de\-hachage\fP +Générer uniquement le hachage de fichiers spécifiés (liste séparée par des +virgules \-\ depuis dpkg\ 1.17.14). Par défaut, cela génère tous les hachages +actuellement pris en charge. Valeurs prises en charges\ : \fBmd5\fP, \fBsha1\fP, +\fBsha256\fP. +.TP +\fB\-m\fP, \fB\-\-multiversion\fP +Affiche tous les paquets trouvés en sortie. +.TP +\fB\-M\fP, \fB\-\-medium\fP \fIchaîne\-id\fP +Ajoute un champ \fBX\-Medium\fP qui contient la valeur \fIchaîne\-id\fP (depuis +dpkg\ 1.15.5). Ce champ est obligatoire si vous voulez créer des fichiers +\fBPackages.cd\fP destinés à être utilisés avec la méthode multicd de dselect. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH DIAGNOSTICS +\fBdpkg\-scanpackages\fP affiche les erreurs habituelles qui se comprennent +d'elles\-mêmes. Il affiche aussi des avertissements quand des paquets sont +dans un mauvais sous\-répertoire, existent en double exemplaire, ont des +champs «\ Filename\ » dans leur fichier «\ control\ », sont absents du fichier +«\ override\ » ou bien dont les substitutions de responsable ne peuvent pas +s'appliquer. +. +.SH "VOIR AUSSI" +.ad l +\fBdpkg\fP(1), \fBdselect\fP(1), \fBdeb\-override\fP(5), \fBdeb\-extra\-override\fP(5), +\fBdpkg\-scansources\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-scansources.man b/man/fr/dpkg-scansources.man new file mode 100644 index 0000000..a1025cb --- /dev/null +++ b/man/fr/dpkg-scansources.man @@ -0,0 +1,106 @@ +.\" dpkg manual page - dpkg-scansources(1) +.\" +.\" Copyright © 2005 Roderick Schertler <roderick@argon.org> +.\" Copyright © 2006 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2009 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-scansources 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-scansources \- Crée des fichiers d'index de sources +. +.SH SYNOPSIS +\fBdpkg\-scansources\fP [\fIoption\fP...] \fIrep\-de\-binaires\fP [\fIfichier\-override\fP +[\fIpréfixe\-chemin\fP]] \fB>\fP \fISources\fP +. +.SH DESCRIPTION +\fBdpkg\-scansources\fP recherche des fichiers \fI.dsc\fP dans le répertoire +\fIrep\-de\-binaires\fP indiqué. Ces fichiers sont utilisés pour créer un index +de sources Debian, qui est envoyé sur la sortie standard. +.PP +Le \fIfichier\-override\fP, s'il est indiqué, est utilisé pour fixer les +priorités dans l'index créé et pour modifier le responsable donné par les +fichiers \fI.dsc\fP (depuis dpkg\ 1.15.5). Consultez \fBdeb\-override\fP(5) pour +plus de détails sur le format de ce fichier. Note\ : comme le fichier +override est indexé par paquet binaire et non pas par paquet source, cela +pose un léger problème. L'implémentation actuelle utilise la priorité la +plus élevée des paquets produits par un fichier \fI.dsc\fP comme priorité du +paquet source, et l'entrée du fichier override du premier paquet binaire +listé dans le fichier \fI.dsc\fP pour modifier l'information sur le +responsable. Cela pourra changer. +.PP +Le \fIpréfixe\-chemin\fP, s'il est indiqué, est ajouté au début du champ +Directory («\ répertoire\ ») dans l'index des sources généré. C'est, en règle +générale, utilisé pour que le champ Directory contienne un chemin depuis la +racine de l'archive Debian. +. +.PP +\fBNote\fP\ : Si vous voulez accéder au fichier Sources généré avec \fBapt\fP(8), +vous devrez probablement compresser ce fichier avec \fBgzip\fP(1) (pour créer +un fichier Sources.gz). \fBapt\fP ignore les fichiers Sources non compressés +sauf pour les accès locaux (c'est\-à\-dire les sources \fBfile://\fP). +. +.SH OPTIONS +.IP "\fB\-n\fP, \fB\-\-no\-sort\fP" 4 +Ne trie pas les entrées de l'index. Elles sont d'habitude triées en fonction +du nom du paquet source. +.TP +.IP "\fB\-e\fP, \fB\-\-extra\-override\fP \fIfichier\fP" 4 +Examine \fIfichier\fP à la recherche d'«\ overrides\ » supplémentaires (depuis +dpkg\ 1.15.4\ ; ce fichier peut être compressé depuis dpkg\ 1.15.5). Voir +\fBdeb\-extra\-override\fP(5) pour plus d'information sur le format utilisé. +.IP "\fB\-s\fP, \fB\-\-source\-override\fP \fIfichier\fP" 4 +Utilise \fIfichier\fP comme fichier override des sources (ce fichier peut être +compressé depuis dpkg\ 1.15.5). La valeur par défaut est le nom du fichier +override indiqué auquel est ajoutée l'extension \fI.src\fP. +.sp +Le format des fichiers override des sources est différent des fichiers +override des binaires. Il ne contient que deux champs séparés par des +espaces, le premier indique le paquet source et le second, la section. Les +lignes blanches et les lignes de commentaire sont ignorées comme à +l'habitude. Si un paquet apparaît dans chaque fichier, le fichier des +sources est prioritaire pour fixer la section. +.IP \fB\-\-debug\fP 4 +Active le débogage. +.IP \fB\-\-help\fP 4 +Affiche un message d'aide puis quitte. +.IP \fB\-\-version\fP 4 +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH "VOIR AUSSI" +\fBdeb\-override\fP(5), \fBdeb\-extra\-override\fP(5), \fBdpkg\-scanpackages\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-shlibdeps.man b/man/fr/dpkg-shlibdeps.man new file mode 100644 index 0000000..a6c40ed --- /dev/null +++ b/man/fr/dpkg-shlibdeps.man @@ -0,0 +1,365 @@ +.\" dpkg manual page - dpkg-deb(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2007-2011 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2011-2013, 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-shlibdeps 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-shlibdeps \- Générateur de variables de substitution de dépendances pour +bibliothèques partagées +. +.SH SYNOPSIS +\fBdpkg\-shlibdeps\fP [\fIoption\fP...] [\fB\-e\fP]\fIexécutable\fP [\fIoption\fP...] +. +.SH DESCRIPTION +\fBdpkg\-shlibdeps\fP calcule, pour les exécutables indiqués dans ses +paramètres, les dépendances envers les bibliothèques partagées. Ces +dépendances sont ajoutées au fichier de variables de substitution +\fBdebian/substvars\fP sous la forme \fBshlibs:\fP\fIchamp\-dépendance\fP où +\fIchamp\-dépendance\fP est le nom du champ de dépendance. Toute autre variable +après \fIshlibs:\fP est supprimée du fichier. +.P +\fBdpkg\-shlibdeps\fP a deux sources possibles pour créer les informations +concernant les dépendances, soit les fichiers \fIsymbols\fP, soit les fichiers +\fIshlibs\fP. Pour chaque fichier binaire qu'il analyse, \fBdpkg\-shlibdeps\fP +recherche la liste des bibliothèques partagées qui lui sont liées. Puis, +pour chacune d'elles il analyse soit le fichier \fIsymbols\fP, soit le fichier +\fIshlibs\fP (si le premier n'existe pas ou si debian/shlibs.local contient les +dépendances appropriées). Ces deux fichiers sont censés être fournis par le +paquet de la bibliothèque et disponibles dans +%ADMINDIR%/info/\fIpaquet\fP.\fIsymbols\fP ou +%ADMINDIR%/info/\fIpaquet\fP.\fIshlibs\fP. Le nom du paquet est trouvé en deux +étapes\ : en cherchant le fichier de la bibliothèque sur le système, dans le +répertoire que \fBld.so\fP utiliserait, puis en utilisant \fBdpkg \-S +\fP\fIfichier\-bibliothèque\fP pour trouver le paquet qui fournit cette +bibliothèque. +.SS "Fichiers symboles" +Les fichiers symboles contiennent des informations de dépendances plus fines +en fournissant les dépendances minimales pour chaque symbole de la +bibliothèque exportée. Le script essaie de trouver un fichier de symboles +associé à un paquet de bibliothèque dans les emplacements suivants (le +premier trouvé est utilisé)\ : +.IP debian/*/DEBIAN/symbols +Les informations de bibliothèque partagée générée par l'actuel processus de +construction qui invoque aussi \fBdpkg\-shlibdeps\fP. Elles sont générées par +\fBdpkg\-gensymbols\fP(1) et ne sont utilisées que si la bibliothèque se trouve +dans l'arbre de construction d'un paquet. Le fichier des symboles qui +construit l'arbre s'appuie sur les fichiers de symboles d'autres paquets +binaires. +.IP %PKGCONFDIR%/symbols/\fIpaquet\fP.symbols.\fIarchitecture\fP +.IP %PKGCONFDIR%/symbols/\fIpaquet\fP.symbols +Les informations de dépendance de bibliothèque partagée principales par +système. \fIarch\fP est l'architecture du système actuel (obtenu par +\fBdpkg\-architecture \-qDEB_HOST_ARCH\fP). +.IP "Affichage de “\fBdpkg\-query \-\-control\-path\fP \fIpaquet\fP symbols”" +Les informations de dépendance de bibliothèque partagée fournies par le +paquet. Sauf indication contraire par le biais de \fB\-\-admindir\fP, ces +fichiers sont par défaut dans %ADMINDIR%. +.P +Lors de l'analyse des symboles utilisés par tous les binaires, +\fBdpkg\-shlibdeps\fP retient la (plus grande) version minimale nécessaire pour +chaque bibliothèque. À la fin du processus, il est capable d'écrire la +dépendance minimale pour toutes les bibliothèques utilisées (à condition que +l'information des fichiers \fIsymbols\fP soit exacte). +.P +Comme garde\-fou, un fichier de symboles peut fournir un champ +\fBBuild\-Depends\-Package\fP de méta\-information et \fBdpkg\-shlibdeps\fP en +extraira la version minimale requise par le paquet correspondant depuis ce +champ \fBBuild\-Depends\fP et utilisera cette version si elle est supérieure à +la version minimale calculée par l'examen des symboles. +.SS "Fichiers Shlibs" +Les fichiers Shlibs associent directement une bibliothèque à une dépendance +(sans regarder les symboles). C'est donc souvent plus puissant que les +besoins réels mais cela reste très sûr et facile à manipuler. +.P +Les dépendances d'une bibliothèque sont recherchées à plusieurs endroits. Le +premier fichier d'informations trouvé qui concerne la bibliothèque est +utilisé\ : +.IP debian/shlibs.local +Fichier particulier à un paquet remplaçant les informations qui concernent +les dépendances envers des bibliothèques partagées. +.IP %PKGCONFDIR%/shlibs.override +Fichier système remplaçant les informations qui concernent les dépendances +envers des bibliothèques partagées. +.IP debian/*/DEBIAN/shlibs +Information sur la bibliothèque partagée générée par le processus actuel de +construction qui invoque aussi \fBdpkg\-shlibdeps\fP. Il n'est utilisé que si la +bibliothèque se trouve dans l'arbre de construction du paquet. Le fichier +shlibs qui construit l'arbre a priorité sur les fichiers shlibs des autres +paquets binaires. +.IP "Affichage de «\ \fBdpkg\-query \-\-control\-path\fP \fIpaquet\fP shlibs\ »" +Les informations de dépendance de bibliothèque partagée fournies par le +paquet. Sauf indication contraire par le biais de \fB\-\-admindir\fP, ces +fichiers sont par défaut dans %ADMINDIR%. +.IP %PKGCONFDIR%/shlibs.default +Fichier système par défaut concernant les informations de dépendance envers +des bibliothèques partagées. +.P +Les dépendances trouvées sont ensuite directement utilisées (sauf si elles +sont filtrées parce qu'elles ont été identifiées comme étant en double, ou +d'un niveau plus faible qu'une autre dépendance). +.SH OPTIONS +\fBdpkg\-shlibdeps\fP interprète des arguments sans option comme des commandes +exécutables, comme si on avait simplement donné \fB\-e\fP\fIexécutable\fP. +.TP +\fB\-e\fP\fIexécutable\fP +Cette option inclut les bonnes dépendances envers les bibliothèques +partagées que demande \fIexécutable\fP. Cette option peut être utilisée +plusieurs fois. +.TP +\fB\-l\fP\fIrépertoire\fP +Ajoute \fIrépertoire\fP au début de la liste des répertoires où chercher des +bibliothèques partagées privées (depuis dpkg\ 1.17.0). Cette option peut être +utilisée plusieurs fois. + +Note\ : Utilisez cette option plutôt que le réglage de \fBLD_LIBRARY_PATH\fP, +parce que cette variable d'environnement est utilisée pour contrôler +l'éditeur de liens d'exécution et se servir d'elle pour définir les chemins +des bibliothèques partagées au moment de la construction peut être +problématique, par exemple, lors d'une compilation croisée. +.TP +\fB\-d\fP\fIchamp\-dépendance\fP +Cette option ajoute les dépendances destinées au champ «\ dépendance\ » du +fichier de contrôle \fIchamp\-dépendance.\fP (Les dépendances pour ce champ sont +dans la variable \fBshlibs:\fP\fIchamp\-dépendance\fP.) + +L'option \fB\-d\fP\fIchamp\-dépendance\fP concerne tous les exécutables qui suivent +l'option, jusqu'à la prochaine option \fB\-d\fP\fIchamp\-dépendance\fP. Par défaut, +\fIchamp\-dépendance\fP vaut \fBDepends\fP. + +Quand, dans plusieurs champs reconnus ayant trait aux dépendances comme les +champs \fBPre\-Depends\fP, \fBDepends\fP, \fBRecommends\fP, \fBEnhances\fP ou \fBSuggests\fP +apparaît la même entrée (ou bien un ensemble d'alternatives), +\fBdpkg\-shlibdeps\fP supprime automatiquement les dépendances dans tous les +champs sauf celui qui représente les dépendances les plus importantes. +.TP +\fB\-p\fP\fIpréfixe\-pour\-le\-nom\-des\-variables\fP +Fait commencer les variables de substitution par +\fIpréfixe\-pour\-le\-nom\-des\-variables\fP\fB:\fP au lieu de \fBshlibs:\fP. De même, +toute variable de substitution commençant par +\fIpréfixe\-pour\-le\-nom\-des\-variables\fP\fB:\fP (au lieu de \fBshlibs:\fP) est enlevée +du fichier de substitution des variables. +.TP +\fB\-O\fP[\fInom\-de\-fichier\fP] +Affiche les définitions des variables de substitution sur la sortie standard +(ou \fInom\-de\-fichier\fP si spécifié, depuis dpkg\ 1.17.2), plutôt que de les +ajouter dans le fichier de substitution des variables qui est par défaut +\fBdebian/substvars\fP. +.TP +\fB\-t\fP\fItype\fP +Préférer les informations sur les dépendances des bibliothèques partagées +qui sont étiquetées pour un type de paquet donné. Si aucune information de +type n'est donnée, il n'utilisera pas d'information. Par défaut, le type de +paquet est \fBdeb\fP. On peut créer une étiquette pour ces informations en les +préfixant par le nom du type, un deux\-points et une espace. +.TP +\fB\-L\fP\fIfichier\-local\-shlibs\fP +Lire les informations de remplacement concernant les dépendances envers les +bibliothèques partagées dans \fIfichier\-local\-shlibs\fP au lieu de +\fBdebian/shlibs.local\fP. +.TP +\fB\-T\fP\fIfichier\-substvars\fP +Écrire les variables de substitution dans \fIfichier\-substvars\fP\ ; le fichier +par défaut est \fBdebian/substvars\fP. +.TP +\fB\-v\fP +Active le mode bavard (depuis dpkg\ 1.14.8). De nombreux messages sont +affichés pour expliquer ce que \fBdpkg\-shlibdeps\fP fait. +.TP +\fB\-x\fP\fIpackage\fP +Exclut le paquet des dépendances générées (depuis dpkg\ 1.14.8). Cela évite +les auto\-dépendances pour les paquets fournissant des exécutables ELF +(exécutables ou modules complémentaires de bibliothèque) qui utilisent une +bibliothèque incluse dans ce même paquet. Cette option peut être utilisée +plusieurs fois pour exclure plusieurs paquets. +.TP +\fB\-S\fP\fIrépertoire\-construction\-paquet\fP +Recherche dans \fIrépertoire\-construction\-paquet\fP en premier et essaie de +trouver une bibliothèque (depuis dpkg\ 1.14.15). C'est utile lorsque le +paquet source construit plusieurs saveurs de la même bibliothèque et que +vous voulez vous assurer que vous obtiendrez la dépendance d'un paquet +binaire donné. Cette option peut être utilisée plusieurs fois\ : les +répertoires seront examinés dans le même ordre avant les répertoires +d'autres paquets binaires. +.TP +\fB\-I\fP\fIrépertoire\-construction\-paquet\fP +Ignore \fIrépertoire\-construction\-paquet\fP lors de la recherche des fichiers +shlibs, de symboles et des bibliothèques partagées (depuis +dpkg\ 1.18.5). Cette option peut être utilisée plusieurs fois. +.TP +\fB\-\-ignore\-missing\-info\fP +Pas d'échec si l'information de dépendance ne peut pas être trouvée pour une +bibliothèque partagée (depuis dpkg\ 1.14.8). L'utilisation de cette option +est déconseillée, toutes les bibliothèques devraient fournir leurs +informations de dépendance (que ce soit avec les fichiers shlibs, ou avec +les fichiers symboles), même si elles ne sont pas encore utilisées par +d'autres paquets. +.TP +\fB\-\-warnings=\fP\fIvaleur\fP +\fIvaleur\fP est un champ de «\ bit\ » définissant l'ensemble des avertissements +qui peuvent être émis par \fBdpkg\-shlibdeps\fP (depuis dpkg\ 1.14.17). Le bit +\fB0\fP (valeur\ =\ 1) active l'avertissement «\ symbole \fIsym\fP utilisé par le +\fIbinaire\fP trouvé dans aucune des bibliothèques\ ». Le bit \fB1\fP (valeur\ =\ 2) +active l'avertissement «\ le paquet pourrait éviter une dépendance +inutile\ ». Le bit \fB2\fP (valeur\ =\ 4) active l'avertissement «\ Le \fIbinaire\fP +ne devrait pas être lié à \fIbibliothèque\fP\ ». La \fIvaleur\fP par défaut est +\fB3\fP\ : les deux premières mises en garde sont actives par défaut, la +dernière ne l'est pas. Positionnez la \fIvaleur\fP à\ 7 si vous souhaitez que +tous les avertissements soient actifs. +.TP +\fB\-\-admindir\fP=\fIrépertoire\fP +Changer l'endroit où se trouve la base de données de \fBdpkg\fP (depuis +dpkg\ 1.14.0). Par défaut, c'est \fI%ADMINDIR%\fP. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH DIAGNOSTICS +.SS Avertissements +Depuis que \fBdpkg\-shlibdeps\fP analyse l'ensemble des symboles utilisés par +chaque binaire généré par le paquet, il est en mesure d'émettre des +avertissements dans plusieurs cas. Ils vous informent des choses qui peuvent +être améliorées dans le paquet. Dans la plupart des cas, ces améliorations +concernent directement les sources amont. Dans l'ordre d'importance +décroissant, voici les différents avertissements que vous pouvez +rencontrer\ : +.TP +\fBsymbole\fP\fI sym\fP\fB utilisé par \fP\fIbinaire\fP\fB trouvé dans aucune des bibliothèques.\fP +Le symbole indiqué n'a pas été trouvé dans les bibliothèques liées au +binaire. Le \fIbinaire\fP est probablement plutôt une bibliothèque et il doit +être lié avec une bibliothèque supplémentaire durant le processus de +construction (l'option \fB\-l\fP\fIbibliothèque\fP de l'éditeur de liens). +.TP +\fIbinary\fP\fB contient une référence non résolue au symbole \fP\fIsym\fP\ \fB: il s'agit probablement d'un greffon (plugin)\fP +Le symbole indiqué n'a pas été trouvé dans les bibliothèques liées avec le +fichier binaire. Le \fIbinaire\fP est très probablement un greffon (plugin) et +le symbole est probablement fourni par le programme qui charge ce +greffon. En théorie, un greffon n'a pas de «\ SONAME\ » mais ce binaire en +possède un et n'a pas pu être identifié en tant que tel. Cependant, le fait +que le binaire soit stocké dans un répertoire non public est une indication +forte qu'il ne s'agit pas d'une bibliothèque partagée normale. Si le binaire +est vraiment un greffon, vous pouvez ignorer cet avertissement. Il existe +cependant une possibilité qu'il s'agisse d'un vrai binaire et que les +programmes avec lequel il est lié utilisent un RPATH afin que le chargeur +dynamique le trouve. Dans ce cas, la bibliothèque est incorrecte et doit +être corrigée. +.TP +\fBpaquet pourrait éviter une dépendance inutile si\fP \fIle binaire\fP \fBn'était pas lié avec\fP \fIbibliothèque\fP \fB(il ne fait usage d'aucun de ses symboles)\fP +Aucun des \fIbinaires\fP liés à la \fIbibliothèque\fP utilise les symboles qu'elle +fournit. En corrigeant tous les binaires, vous éviteriez la dépendance +associée à cette bibliothèque (à moins que la même dépendance soit également +liée à une autre bibliothèque qui est elle réellement utilisée). +.TP +\fBpaquet pourrait éviter une dépendance inutile si\fP \fIles binaires\fP \fBn'étaient pas liés avec\fP \fIbibliothèque\fP \fB(ils ne font usage d'aucun de ses symboles)\fP +Identique à l'avertissement précédent, pour des binaires multiples. +.TP +\fIle binaire\fP \fBne devrait pas être lié avec la\fP \fIbibliothèque\fP \fB(il ne fait usage d'aucun de ses symboles)\fP +Le \fIbinaire\fP est lié à une bibliothèque dont il n'a pas besoin. Ce n'est +pas un problème mais de petites améliorations de performance dans le temps +de chargement de celui\-ci peuvent être obtenues en ne le liant pas à cette +bibliothèque. Cet avertissement vérifie la même information que la +précédente mais elle le fait pour tous les binaires au lieu de ne faire le +contrôle qu'au niveau global sur tous les binaires analysés. +.SS Erreurs +\fBdpkg\-shlibdeps\fP échouera s'il ne peut pas trouver de bibliothèque publique +utilisée par un binaire ou si cette bibliothèque n'a pas d'informations sur +les dépendances associées (soit le fichier shlibs, soit le fichier des +symboles). Une bibliothèque publique a un SONAME et un numéro de version +(libsomething.so.\fIX\fP). Une bibliothèque privée (comme un module +additionnel) ne devrait pas avoir de SONAME et n'a pas besoin d'avoir de +version. +.TP +\fBimpossible de trouver la bibliothèque\fP \fIlibrary\-soname\fP \fBdemandée par le\fP \fIbinaire\fP \fB(son RPATH est «\ \fP\fIrpath\fP\fB\ »)\fP +Le \fIbinaire\fP utilise une bibliothèque appelée \fIlibrary\-soname\fP mais +\fBdpkg\-shlibdeps\fP n'a pas été en mesure de trouver cette +bibliothèque. \fBdpkg\-shlibdeps\fP crée une liste de répertoires à vérifier de +la manière suivante\ : les répertoires énumérés dans le RPATH du binaire, les +répertoires ajoutés par l'option \fB\-l\fP, les répertoires listés dans la +variable d'environnement \fBLD_LIBRARY_PATH\fP, les répertoires croisés +multi\-architerctures (par exemple, /lib/arm64\-linux\-gnu, +/usr/lib/arm64\-linux\-gnu), les répertoires publics standard (/lib, +/usr/lib), les répertoires listés dans /etc/ld.so.conf et les répertoires +obsolètes multilib (/lib32, /usr/lib32, /lib64, /usr/lib64). Ensuite, il +vérifie les répertoires qui sont dans l'arbre de construction du paquet +binaire en cours d'analyse, dans l'arbre de construction du paquet indiqué +avec l'option de ligne de commande \fB\-S\fP, dans les autres arbres de paquets +qui contiennent un fichier DEBIAN/shlibs ou DEBIAN/symbols et enfin dans le +répertoire racine. Si la bibliothèque n'est pas trouvée dans l'un de ces +répertoires, alors ce message d'erreur est obtenu. + +Si la bibliothèque non trouvée est cependant disponible dans le répertoire +privé de ce même paquet, alors il vous faut ajouter ce répertoire avec +\fB\-l\fP. S'il est dans un autre paquet binaire en cours de construction, alors +assurez\-vous que le fichier shlibs/symbols de ce paquet a déjà créé et que +\fB\-l\fP contient le répertoire approprié si c'est aussi un répertoire privé. +.TP +\fBaucune information de dépendance trouvée pour\fP \fIla bibliothèque\fP \fB(utilisée par le\fP \fIbinaire\fP\fB).\fP +La bibliothèque nécessaire au \fIbinaire\fP a été trouvée par \fBdpkg\-shlibdeps\fP +dans \fIfichier\-bibliothèque\fP mais \fBdpkg\-shlibdeps\fP n'a pas été en mesure de +trouver d'informations de dépendance pour cette bibliothèque. Pour trouver +la dépendance, il a essayé de lier la bibliothèque à un paquet Debian avec +l'aide de \fBdpkg \-S \fP\fIfichier\-bibliothèque\fP. Puis, il a vérifié les shlibs +correspondants et les fichiers symboles de %ADMINDIR%/info/ et enfin les +différents arbres des paquets construits (debian/*/DEBIAN/). + +Cet échec peut être causé par un shlibs ou un fichier de symboles qui serait +mauvais ou manquant dans le paquet. Une autre cause serait que la +bibliothèque soit construite au sein du même paquet source et que les +fichiers shlibs n'aient pas encore été créés (dans ce cas debian/rules doit +être modifié pour créer le shlibs avant l'appel de \fBdpkg\-shlibdeps\fP). Un +mauvais RPATH peut aussi conduire à ce que la bibliothèque soit trouvée sous +un nom non canonique (comme\ : /usr/lib/openoffice.org/../lib/libssl.so.0.9.8 +au lieu de /usr/lib/libssl.so.0.9.8) qui n'est associé à aucun paquet, +\fBdpkg\-shlibdeps\fP essaie de contourner cela en se repliant vers un nom +canonique (en utilisant \fBrealpath\fP(3)), mais cela ne fonctionne pas +toujours. Il est toujours préférable de bien nettoyer le RPATH du binaire +afin d'éviter ces problèmes. + +L'appel de \fBdpkg\-shlibdeps\fP en mode bavard (\fB\-v\fP) fournira beaucoup plus +d'informations sur l'endroit où il a essayé de trouver l'information sur les +dépendances. Cela peut être utile si vous ne comprenez pas pourquoi vous +obtenez cette erreur. +.SH "VOIR AUSSI" +\fBdeb\-shlibs\fP(5), \fBdeb\-symbols\fP(5), \fBdpkg\-gensymbols\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-source.man b/man/fr/dpkg-source.man new file mode 100644 index 0000000..5b11a4c --- /dev/null +++ b/man/fr/dpkg-source.man @@ -0,0 +1,867 @@ +.\" dpkg manual page - dpkg-source(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2006-2007 Frank Lichtenheld <djpig@debian.org> +.\" Copyright © 2006-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2008-2011 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2010 Joey Hess <joeyh@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-source 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-source \- Outil de manipulation des paquets sources Debian (.dsc). +. +.SH SYNOPSIS +\fBdpkg\-source\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBdpkg\-source\fP empaquette ou dépaquette une archive source Debian. + +Aucune de ces commandes ne permet la combinaison de plusieurs options en une +seule et elles ne permettent pas d'indiquer la valeur d'une option dans un +argument séparé. +. +.SH COMMANDES +.TP +\fB\-x \fP, \fB\-\-extract\fP \fInom\-de\-fichier\fP.dsc [\fIrépertoire\-de\-sortie\fP] +Cette option sert à extraire un paquet source (\fB\-\-extract\fP depuis +dpkg\ 1.17.14). Un seul argument sans option doit être donné\ : le nom du +fichier de contrôle des sources Debian (\fB.dsc\fP). Un deuxième argument sans +option peut également être donné pour indiquer le répertoire où extraire le +paquet source\ : ce répertoire ne doit pas déjà exister. Quand aucun +répertoire n'est indiqué, le paquet source est extrait dans un répertoire +\fIsource\fP\-\fIversion\fP du répertoire courant. + +\fBdpkg\-source\fP lit, dans le fichier de contrôle, les noms des fichiers qui +composent le paquet source\ ; il suppose qu'ils sont dans le même répertoire +que le fichier \fB.dsc\fP. + +Les fichiers extraits du paquet auront leurs propriétaires et permissions +définis à ceux attendus s'ils avaient été simplement créés. Les répertoires +et les fichiers exécutables auront une permission égale à 0777 et les +simples fichiers à 0666, les deux étant modifiées par le masque (umask) de +celui qui fait l'extraction. Si le répertoire parent est «\ setgid\ », les +répertoires extraits le seront aussi et tous les fichiers et répertoires +hériteront de sa propriété de groupe. + +Si le paquet source utilise un format non standard (actuellement, cela +signifie tous les formats sauf le «\ 1.0\ »), son nom sera enregistré dans +\fBdebian/source/format\fP de sorte que la construction du paquet source +utilise le même format par défaut. + +.TP +\fB\-b\fP, \fB\-\-build\fP \fIrépertoire\fP [\fIparamètres\-dans\-un\-format\-spécifique\fP] +Construit un paquet source (\fB\-\-build\fP depuis dpkg\ 1.17.14). Le premier +argument sans option est pris comme nom du répertoire contenant +l'arborescence des sources debianisée (c'est\-à\-dire avec un sous\-répertoire +debian et peut\-être des modifications sur les fichiers d'origine). Selon le +format du paquet source utilisé pour construire le paquet, d'autres +paramètres peuvent être acceptés. + +\fBdpkg\-source\fP va construire le paquet source dans le premier format trouvé +dans la liste suivante\ : le(s) format(s) indiqué(s) avec le paramètre de la +ligne de commande \fI\-\-format\fP, le format indiqué dans +\fBdebian/source/format\fP, «\ 1.0\ ». L'utilisation de «\ 1.0\ » comme dernier +recours est obsolète et sera retirée dans le futur. Le format source devrait +toujours être indiqué dans \fBdebian/source/format\fP. Voir la section +\fBFORMATS DE PAQUET SOURCE\fP pour une description plus détaillée des +différents formats de paquet source. + +.TP +\fB\-\-print\-format\fP \fIrépertoire\fP +Affiche le format source qui serait utilisé pour construire le paquet source +si \fBdpkg\-source \-\-build \fP\fIrépertoire\fP était utilisé (dans les mêmes +conditions et avec les mêmes options\ ; depuis dpkg\ 1.15.5). + +.TP +\fB\-\-before\-build\fP \fIrépertoire\fP +Exécute le point d'entrée correspondant du format de paquet source (depuis +dpkg\ 1.15.8). Ce point d'entrée doit être utilisé avant toute construction +du paquet (\fBdpkg\-buildpackage\fP l'utilise très tôt, avant même +\fBdebian/rules clean\fP). Cette commande est idempotente et peut être lancée +plusieurs fois. Tous les formats source ne mettent pas en œuvre ce +branchement et ceux qui le font préparent l'arborescence source pour la +construction, par exemple en garantissant que les correctifs Debian sont +appliqués. + +.TP +\fB\-\-after\-build\fP \fIrépertoire\fP +Exécute le point d'entrée correspondant du format de paquet source (depuis +dpkg\ 1.15.8). Ce point d'entrée doit être utilisé après toute construction +du paquet (\fBdpkg\-buildpackage\fP l'utilise en dernier). Cette commande est +idempotente et peut être lancée plusieurs fois. Tous les formats source ne +mettent pas en œuvre ce branchement et ceux qui le font s'en servent pour +défaire ce qui a été fait par \fB\-\-before\-build\fP. + +.TP +\fB\-\-commit\fP [\fIrépertoire\fP] ... +Enregistre les modifications dans l'arborescence source décompressée dans +\fIrépertoire\fP (depuis dpkg\ 1.16.1). Cette commande peut accepter des +paramètres supplémentaires selon le format source. Elle provoquera une +erreur pour les formats où cette opération n'a pas de signification. + +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. Les options de construction et +d'extraction spécifiques au format peuvent être montrées avec l'option +\fB\-\-format\fP. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.SS "Options de construction générique" +.TP +\fB\-c\fP\fIfichier\-de\-contrôle\fP +Indique le principal fichier de contrôle des sources où trouver les +renseignements. Par défaut, c'est le fichier \fBdebian/control\fP. Lorsqu'un +chemin relatif est fourni, on considère qu'il est relatif au répertoire le +plus élevé de l'arborescence source. +.TP +\fB\-l\fP\fIfichier\-des\-changements\fP +Indique le journal des modifications où trouver des renseignements. Par +défaut, c'est le fichier \fBdebian/changelog\fP. Lorsqu'un chemin relatif est +fourni, on considère qu'il est relatif au répertoire le plus élevé de +l'arborescence source. +.TP +\fB\-F\fP\fIformat\-du\-fichier\-des\-changements\fP +Indique le format du fichier des changements. Voir \fBdpkg\-parsechangelog\fP(1) +pour plus d'informations à propos des formats gérés. +.TP +\fB\-\-format=\fP\fIvaleur\fP +Utilise le format indiqué pour la construction du paquet source (depuis +dpkg\ 1.14.17). Ce choix remplace le format indiqué dans +\fBdebian/source/format\fP. +.TP +\fB\-V\fP\fInom\fP\fB=\fP\fIvaleur\fP +Fixe la valeur d'une variable de substitution. Consultez \fBdeb\-substvars\fP(5) +pour une discussion sur la valeur de substitution. +.TP +\fB\-T\fP\fIfichier\-substvars\fP +Lit les variables de substitution dans \fIfichier\-substvars\fP\ ; par défaut +aucun fichier n'est lu. Cette option peut être utilisée plusieurs fois pour +lire des variables de substitution depuis plusieurs fichiers (depuis +dpkg\ 1.15.6). +.TP +\fB\-D\fP\fIchamp\fP\fB=\fP\fIvaleur\fP +Remplace ou ajoute en sortie un champ dans le fichier de contrôle. +.TP +\fB\-U\fP\fIchamp\fP +Supprime en sortie un champ dans le fichier de contrôle. +.TP +\fB\-Z\fP\fIcompression\fP, \fB\-\-compression\fP=\fIcompression\fP +Spécifie le niveau de compression à utiliser pour les fichiers archive et +diff créés (\fB\-\-compression\fP depuis dpkg\ 1.15.5). Notez que cette option ne +causera pas la recompression des archives existantes, cela ne concerne que +les nouveaux fichiers. Les valeurs acceptées sont les suivantes\ : \fIgzip\fP, +\fIbzip2\fP, \fIlzma\fP et \fIxz\fP. L'option par défaut est \fIxz\fP pour les +formats\ 2.0 et plus récents, et \fIgzip\fP pour le format\ 1.0. \fIxz\fP n'est géré +que depuis dpkg\ 1.15.5. +.TP +\fB\-z\fP\fIniveau\fP, \fB\-\-compression\-level\fP=\fIniveau\fP +Niveau de compression à utiliser (\fB\-\-compression\-level\fP depuis +dpkg\ 1.15.5). Comme avec \fB\-Z\fP cela ne concerne que les fichiers +nouvellement créés. Les valeurs prises possibles sont les suivantes\ : \fI1\fP à +\fI9\fP, \fIbest\fP et \fIfast\fP. La valeur par défaut est \fI9\fP pour gzip et bzip2, +\fI6\fP pour xz et lzma. +.TP +\fB\-i\fP[\fIexpression\-rationnelle\fP], \fB\-\-diff\-ignore\fP[=\fIexpression\-rationnelle\fP] +Il est possible de donner une expression rationnelle Perl pour filtrer les +fichiers qui doivent être éliminés de la liste des fichiers pour le «\ diff\ » +(\fB\-\-diff\-ignore\fP depuis dpkg\ 1.15.6). Cette liste est créée avec une +commande «\ find\ ». Si le fichier source en construction est un fichier +source de version\ 3 utilisant un système de suivi de versions, cette option +est utile pour ignorer les modifications non envoyées. Utiliser \fB\-i\fP\fI.*\fP +les ignorera toutes. + +L'option \fB\-i\fP active cette fonction avec une expression rationnelle par +défaut (en préservant toutes les modifications faites avec l'expression +rationnelle par défaut par une utilisation précédente de +\fB\-\-extend\-diff\-ignore\fP) qui couvre les fichiers de contrôle des plus usuels +systèmes de gestion de version, les fichiers de sauvegarde, les fichiers +d'échange et les répertoires utilisés par Libtool. Il ne peut y avoir qu'une +seule expression rationnelle active\ ; avec de multiples options \fB\-i\fP, seule +la dernière mentionnée sera prise en compte. + +C'est très utile pour supprimer des fichiers qui sont inclus dans le diff, +par exemple, si vous maintenez un source avec un système de contrôle de +version et que voulez construire un paquet source sans inclure des fichiers +et répertoires additionnels qu'il contient généralement (par exemple CVS/, +\&.cvsignore, .svn/). L'expression rationnelle par défaut est déjà très +exhaustive, mais si avez besoin de la remplacer, veuillez noter que par +défaut, il sait vérifier n'importe quelle partie d'un chemin, donc si vous +voulez trouver le début d'un nom de fichier ou des noms de fichiers +complets, vous devrez fournir les caractères spéciaux vous\-même (par exemple +«\ (^|/)\ », «\ ($|/)\ »). +.TP +\fB\-\-extend\-diff\-ignore\fP=\fIexpression\-rationnelle\fP +L'expression rationnelle Perl indiquée complétera la valeur par défaut +utilisée par \fB\-\-diff\-ignore\fP et sa valeur courante si elle est définie +(depuis dpkg\ 1.15.6). Cela est effectué en concaténant +«\ \fB|\fP\fIexpression\-rationnelle\fP\ » à la valeur existante. Cette option est +pratique dans \fBdebian/source/options\fP pour exclure certains fichiers +auto\-créés de la création automatique de correctifs. +.TP +\fB\-I\fP[\fImotif\-fichier\fP], \fB\-\-tar\-ignore\fP[=\fImotif\-fichier\fP] +Avec cette option, le fichier est passé à l'option \fB\-\-exclude\fP de \fBtar\fP(1) +quand on veut créer un fichier .orig.tar ou .tar (\fB\-\-tar\-ignore\fP depuis +dpkg\ 1.15.6). Par exemple, \fB\-I\fPCVS fera que tar sautera les répertoires du +CVS quand il doit créer un fichier .tar.gz. On peut répéter cette option +pour exclure à partir de plusieurs motifs. + +\fB\-I\fP ajoute par défaut des options \fB\-\-exclude\fP qui élimineront les +fichiers et les répertoires de contrôles des systèmes les plus connus de +contrôle de version, les fichiers d'échange et de sauvegarde et les +répertoires utilisés par Libtool. +.PP +\fBNote\fP\ : même si elles ont des rôles similaires, \fB\-i\fP et \fB\-I\fP ont une +syntaxe et une sémantique très différentes. \fB\-i\fP ne peut être spécifié +qu'une fois et reçoit une expression rationnelle compatible avec le langage +Perl qui est appliquée sur chaque chemin relatif complet de chaque +fichier. \fB\-I\fP peut être spécifié plusieurs fois et prend un motif de nom de +fichier avec les méta\-caractères du shell. Le motif est appliqué au chemin +relatif complet mais aussi à chaque partie du chemin individuellement. La +sémantique exacte de l'option \fB\-\-exclude\fP de tar est un peu compliquée, +voir https://www.gnu.org/software/tar/manuel/tar.html#wildcards pour une +documentation plus complète. + +L'expression rationnelle et le motif par défaut pour les deux options +peuvent être trouvés dans la sortie de la commande \fB\-\-help\fP. +.SS "Options d'extraction génériques" +.TP +\fB\-\-no\-copy\fP +Ne copie pas l'archive d'origine à côté de l'extraction du paquet source +(depuis dpkg\ 1.14.17). +.TP +\fB\-\-no\-check\fP +Ne vérifie pas les signatures et les sommes de contrôle avant de +dépaqueter(depuis dpkg\ 1.14.17). +.TP +\fB\-\-no\-overwrite\-dir\fP +Ne pas remplacer le répertoire d'extraction s'il existe déjà (depuis +dpkg\ 1.18.8) +.TP +\fB\-\-require\-valid\-signature\fP +Refuse de décompresser le paquet source s'il ne contient pas de signature +OpenPGP pouvant être vérifiée (depuis dpkg\ 1.15.0) soit avec le fichier de +clés \fItrustedkeys.gpg\fP de l'utilisateur, un des fichiers de clés propre à +un distributeur ou un des fichiers de clés officiels de Debian +(\fI/usr/share/keyrings/debian\-keyring.gpg\fP et +\fI/usr/share/keyrings/debian\-maintainers.gpg\fP). +.TP +\fB\-\-require\-strong\-checksums\fP +Refuse de décompresser le paquet source s'il ne contient pas de somme de +contrôle robuste (depuis dpkg\ 1.18.7). Actuellement, \fBSHA\-256\fP est le seul +type de somme de contrôle considéré comme robuste. +.TP +\fB\-\-ignore\-bad\-version\fP +Transforme la vérification des mauvaises versions des paquets source en +avertissement non fatal (since dpkg\ 1.17.7). Cette option sera seulement +nécessaire quand on extrait des anciens paquets source avec des versions +cassées, pour préserver la compatibilité avec les versions précédentes. + +.SH "FORMATS DE PAQUET SOURCE" +Si vous ne savez pas quel format source utiliser, il est conseillé de +choisir soit «\ 3.0 (quilt)\ » soit «\ 3.0 (native)\ ». Voir +https://wiki.debian.org/Projects/DebSrc3.0 pour plus d'informations sur la +mise en œuvre de ces formats dans Debian. + +.SS "Format\ : 1.0" +Un paquet source dans ce format se compose soit d'un \fB.orig.tar.gz\fP associé +à un \fB.diff.gz\fP ou un simple \fB.tar.gz\fP (dans ce cas, le paquet est appelé +natif \fInative\fP). L'archive tar originale pourrait être accompagnée de façon +facultative d'une signature amont séparée \fB.orig.tar.gz.asc\fP, extraction +prise en charge depuis dpkg\ 1.18.5. + +\fBExtraction\fP + +Extraire un paquet natif revient à une simple extraction de l'archive tar +dans le répertoire cible. L'extraction d'un paquet non natif consiste au +dépaquetage du \fB.orig.tar.gz\fP puis l'application des correctifs contenus +dans le \fB.diff.gz\fP. La date de tous les fichiers correctifs est réglée à +celle du moment de l'extraction depuis le paquet source (cela évite les +horodatages faux menant à des problèmes lorsque des fichiers générés +automatiquement sont modifiés). Le diff peut créer de nouveaux fichiers +(tout le répertoire debian est créé de cette façon) mais ne peut pas +supprimer de fichiers (les fichiers vides seront laissés là). + +\fBConstruction\fP + +Construire un paquet natif revient simplement à créer une archive tar avec +le répertoire du source. La création d'un paquet non natif consiste à +extraire l'archive d'origine dans un répertoire séparé «\ .orig\ » puis à +régénérer le \fB.diff.gz\fP en comparant le \fIrépertoire\fP du paquet source avec +le répertoire «\ .orig\ ». + +\fBOptions de construction (avec \-\-build)\fP\ : + +Si l'on donne un second argument, ce sera le nom du répertoire source +d'origine ou le nom du fichier tar ou bien une chaîne vide si le paquet est +un «\ Debian pure souche\ » et n'a donc pas de fichiers «\ diffs\ » pour sa +«\ debianisation\ ». S'il n'y a pas de second argument, \fBdpkg\-source\fP cherche +le fichier tar des sources d'origine +\fIpaquet\fP\fB_\fP\fIversion\-amont\fP\fB.orig.tar.gz\fP ou bien le répertoire source +d'origine \fIrépertoire\fP\fB.orig\fP selon les paramètres \fB\-sX\fP. + +Les options \fB\-sa\fP, \fB\-sp\fP, \fB\-sk\fP, \fB\-su\fP et \fB\-sr\fP ne remplacent pas les +fichiers tar ou les répertoires existants. Pour cela, il faut utiliser les +options \fB\-sA\fP, \fB\-sP\fP, \fB\-sK\fP, \fB\-sU\fP et \fB\-sR.\fP +.PP +.TP +\fB\-sk\fP +Spécifie que le source d'origine est attendu sous forme tar\ ; par défaut, +\fIpaquet\fP\fB_\fP\fIversion\-amont\fP\fB.orig.tar\fP\fIextension\fP. Il le laisse en place +en tant que fichier tar ou le copie dans le répertoire en cours s'il n'y est +pas déjà. Le fichier sera dépaqueté dans \fIrépertoire\fP\fB.orig\fP pour la +génération du fichier diff. +.TP +\fB\-sp\fP +Comme \fB\-sk\fP mais supprimera le répertoire à nouveau par la suite. +.TP +\fB\-su\fP +Quand on spécifie que le source d'origine est un répertoire\ ; la valeur par +défaut est le répertoire \fIpaquet\fP\fB\-\fP\fIversion\-amont\fP\fB.orig\fP et +\fBdpkg\-source\fP crée une nouvelle archive du source d'origine. +.TP +\fB\-sr\fP +Comme \fB\-su\fP mais supprimera ce répertoire après utilisation. +.TP +\fB\-ss\fP +Indique que le source d'origine est disponible à la fois comme un répertoire +et comme un fichier tar. \fBdpkg\-source\fP se servira du répertoire pour créer +le «\ diff\ », mais du fichier tar pour créer le fichier \fB.dsc\fP. Aussi, faire +attention avec cette option. Si le répertoire et le fichier tar ne +correspondent pas, il en résulte une mauvaise archive source. +.TP +\fB\-sn\fP +Indique de ne pas chercher de source d'origine et de ne pas créer de +«\ diff\ ». Le second argument, s'il existe, doit être une chaîne vide. Cela +sert pour les paquets Debian pure souche qui n'ont pas un source d'origine +distincte et donc pas de fichier «\ diff\ » de debianisation. +.TP +\fB\-sa\fP or \fB\-sA\fP +Indique comme source d'origine soit un fichier tar, soit un répertoire —\ le +deuxième argument, s'il existe, doit être l'un d'eux ou bien une chaîne vide +(cela revient à utiliser l'option \fB\-sn)\fP. Quand un fichier tar existe, il +est dépaqueté pour créer le fichier «\ diff\ »\ ; ensuite il est supprimé (cela +revient à utiliser l'option \fB\-sp)\fP\ ; quand un répertoire est trouvé, il est +empaqueté et \fBdpkg\-source\fP crée le source d'origine et supprime ensuite ce +répertoire (cela revient à utiliser l'option \fB\-sr)\fP\ ; quand ni l'un ni +l'autre n'est trouvé, \fBdpkg\-source\fP suppose que le paquet ne possède pas de +fichier «\ diff\ » de debianisation, mais seulement une simple archive source +(cela revient à utiliser l'option \fB\-sn\fP). Quand les deux sont trouvés, +\fBdpkg\-source\fP ignore le répertoire et le remplace si l'option \fB\-sA\fP a été +spécifiée (cela revient à utiliser l'option \fB\-sP)\fP ou il provoque une +erreur si l'option \fB\-sa\fP a été spécifiée. L'option par défaut est \fB\-sa\fP. +.TP +\fB\-\-abort\-on\-upstream\-changes\fP +Ce processus échoue si le fichier de différences contient des modifications +apportées à des fichiers en dehors du sous\-répertoire debian (depuis +dpkg\ 1.15.8). Cette option n'est pas autorisée dans \fBdebian/source/options\fP +mais peut être utilisée dans \fBdebian/source/local\-options\fP. +.PP + +\fBoptions d'extraction (avec \-\-extract)\fP\ : + +Dans tous ces cas, l'arborescence existante des sources d'origine est +supprimée. +.TP +\fB\-sp\fP +Quand on extrait le répertoire source d'origine (s'il existe), il est +conservé en tant que fichier tar. S'il n'est pas déjà dans le répertoire +courant ou si ce répertoire contient un fichier différent, le fichier tar +est copié dans ce répertoire. (\fBCela est le comportement par défaut\fP). +.TP +\fB\-su\fP +Dépaquetage de l'arborescence du répertoire source d'origine. +.TP +\fB\-sn\fP +Assure que le répertoire source d'origine ne sera ni copié dans le +répertoire en cours, ni dépaqueté. Si une arborescence source d'origine est +présente dans le répertoire courant, elle est toujours supprimée. +.PP +Toutes les options \fB\-s\fP\fIX\fP s'excluent mutuellement. Si vous en indiquez +plusieurs, seule la dernière sera prise en compte. +.TP +\fB\-\-skip\-debianization\fP +Passe l'étape d'application du fichier de différences Debian aux sources +amont (depuis dpkg\ 1.15.1). +. +.SS "Format\ : 2.0" +Extraction prise en charge depuis dpkg\ 1.13.9, construction depuis +dpkg\ 1.14.8. Aussi connu sous le nom de «\ wig&pen\ ». Ce format n'est pas +recommandé pour une utilisation massive, le format «\ 3.0 (quilt)\ » le +remplace. Wig&pen a été la première spécification d'une nouvelle génération +de format de paquet source. + +Le comportement de ce format est le même que pour le format «\ 3.0 (quilt)\ » +sauf qu'il n'utilise pas de liste explicite de correctifs. Tous les fichiers +dans \fBdebian/patches/\fP correspondant à l'expression rationnelle Perl +\fB[\ew\-]+\fP doivent être des correctifs valables\ : ils sont appliqués au +moment de l'extraction. + +Lors de la construction d'un nouveau paquet source, toute modification +apportée au source amont est enregistrée dans un correctif nommé +\fBzz_debian\-diff\-auto\fP. +. +.SS "Format\ : 3.0 (native)" +Pris en charge depuis dpkg\ 1.14.17. Ce format est une extension du format de +paquet natif tel que défini dans le format\ 1.0. Il gère toutes les méthodes +de compression et ignore par défaut tout fichier et répertoire spécifique à +VCS ainsi que de nombreux fichiers temporaires (voir la valeur par défaut +associée à l'option \fB\-I\fP dans la sortie de \fB\-\-help\fP). +. +.SS "Format\ : 3.0 (quilt)" +Pris en charge depuis\ 1.14.17. Un paquet source dans ce format contient au +moins une archive tar d'origine (\fB.orig.tar.\fP\fIext\fP où \fIext\fP peut être +\fBgz\fP, \fBbz2\fP \fBlzma\fP et \fBxz\fP) et une archive tar debian +(\fB.debian.tar.\fP\fIext\fP). Il peut également contenir d'autres archives tar +d'origine (\fB.orig\-\fP\fIcomposant\fP\fB.tar.\fP\fIext\fP). \fIcomposant\fP ne peut être +constitué que de caractères alphanumériques («\ a\-zA\-Z0\-9\ ») et de tirets +(«\ \-\ »). Chaque archive tar originale peut être accompagnée de façon +facultative d'une signature amont séparée (\fB.orig.tar.\fP\fIext\fP\fB.asc\fP et +\&\fB.orig\-\fP\fIcomposant\fP\fB.tar.\fP\fIext\fP\fB.asc\fP), extraction prise en charge +depuis dpkg\ 1.17.20, construction depuis dpkg\ 1.18.5. + +.PP +\fBExtraction\fP +.PP +L'archive principale tar d'origine est extraite tout d'abord, puis toutes +les autres archives tar d'origine sont extraites dans des sous\-répertoires +dont le nom est formé à partir de la partie \fIcomposant\fP de leur +nom. L'archive tar Debian est extraite du répertoire source, après la +suppression de tout répertoire \fBdebian\fP existant. Notez que l'archive tar +Debian doit contenir un sous\-répertoire \fBdebian\fP, mais elle peut également +contenir des fichiers binaires en dehors de ce répertoire (voir l'option +\fB\-\-include\-binaries\fP). +.PP +Toutes les modifications figurant dans +\fBdebian/patches/\fP\fIdistributeur\fP\fB.series\fP ou \fBdebian/patches/series\fP sont +alors appliquées, où \fIdistributeur\fP sera le nom en minuscules du +distributeur actuel, ou Debian s'il n'y a pas de distributeur défini. Si +l'ancien fichier est utilisé et qu'il n'y en a pas de plus récent (ou si +c'est un lien symbolique), alors celui\-ci est remplacé par un lien +symbolique vers l'ancien. Cette disposition vise à simplifier l'utilisation +de \fBquilt\fP pour gérer l'ensemble des correctifs. Les fichiers de séries +propres au distributeur sont destinés à permettre de sérialiser plusieurs +branches de développement en se basant sur le distributeur, d'une manière +déclarative, de préférence au codage ouvert de cette gestion dans +\fBdebian/rules\fP. Cela est particulièrement utile quand le source à besoin de +correctifs de manière conditionnelle car les fichiers affectés n’ont pas de +gestion interne d’inclusion conditionnelle. Notez toutefois que si +\fBdpkg\-source\fP analyse correctement les fichiers de séries avec les options +utilisées pour l'application du correctif (stockées sur chaque ligne après +le nom du correctif et une ou plusieurs espaces), il n'ignore pas ces +options et s'attendra toujours à ce que les correctifs puissent être +appliqués avec l'option \fB\-p1\fP de \fBpatch\fP. Il va donc émettre un +avertissement lorsqu'il rencontrera ces options, et la construction est +susceptible d'échouer. +.PP +Notez que \fBlintian\fP(1) émettra des avertissements sans condition lors de +l'utilisation de séries de distributeur du fait d'une règle controversée +particulière de Debian qui ne devrait pas affecter une utilisation externe\ ; +pour les faire taire, le profil lintian de dpkg peut être utilisé en passant +l'option «\fB\-\-profile dpkg\fP» à \fBlintian\fP(1). +.PP +La date de tous les fichiers correctifs est celle du moment où se déroule +l'extraction du paquet source (cela évite les horodatages faux menant à des +problèmes lorsque des fichiers générés automatiquement sont modifiés). +.PP +Au contraire du comportement par défaut de \fBquilt\fP, les correctifs doivent +s'appliquer sans décalage («\ fuzz\ »). Quand cela n'est pas le cas, il est +suggéré de les rafraîchir avec \fBquilt\fP sinon \fBdpkg\-source\fP se terminera +avec une erreur en tentant de les appliquer. +.PP +Similaire au comportement par défaut de \fBquilt\fP, les modifications peuvent +aussi supprimer des fichiers. +.PP +Le fichier \fB.pc/applied\-patches\fP est créé si certains correctifs ont été +appliqués au cours de l'extraction. +.PP +\fBConstruction\fP +.PP +Les originaux de toutes les archives tar trouvées dans le répertoire courant +sont extraits dans un répertoire temporaire en suivant la même logique que +pour le dépaquetage, le répertoire debian est copié dans le répertoire +temporaire, et tous les correctifs excepté le correctif automatique +\fBdebian\-changes\-\fP\fIversion\fP ou \fBdebian\-changes\fP, selon +\fB\-\-single\-debian\-patch\fP) sont appliquées. Le répertoire temporaire est +comparé à celui du paquet source. Si le fichier de différences n'est pas +vide, la construction échoue à moins que \fB\-\-single\-debian\-patch\fP ou +\fB\-\-auto\-commit\fP aient été utilisés, et dans ce cas le diff est stocké dans +le correctif automatique. Si le correctif automatique est créé ou supprimé, +il est ajouté ou supprimé dans le fichier «\ series\ » et les métadonnées de +\fBquilt\fP. + +Tout changement dans un fichier binaire ne peut être indiqué dans le diff et +va déboucher sur un échec à moins que le responsable ne décide délibérément +d'inclure cette modification binaire dans l'archive tar Debian (en le +listant dans \fBdebian/source/include\-binaries\fP). La construction pourra +également échouer si des fichiers binaires sont trouvés dans le +sous\-répertoire debian sans être indiqué dans la liste blanche de +\fBdebian/source/include\-binaries\fP. + +Le répertoire debian mis à jour et la liste des binaires modifiés sont +ensuite utilisés pour recréer l'archive tar debian. + +Le diff généré automatiquement n'inclut pas les changements spécifiques sur +les fichiers VCS ainsi sur que de nombreux fichiers temporaires (pour la +valeur par défaut associée à l'option \fB\-i\fP, voir la sortie de +\fB\-\-help\fP). En particulier, le répertoire \fB.pc\fP utilisé par \fBquilt\fP est +ignoré lors de la génération automatique du correctif. + +Note\ : \fBdpkg\-source\fP \fB\-\-before\-build\fP (et \fB\-\-build\fP) prendront soin +d'appliquer les correctifs indiqués dans le fichier series afin qu'un paquet +soit toujours construit avec toutes les corrections appliquées. Pour +effectuer cette détection, il recherche la liste des correctifs non +appliqués (ils sont mentionnés dans le fichier \fBseries\fP mais pas dans +\&\fB.pc/applied\-patches\fP) et si le premier de cette liste peut être appliqué +sans erreur, il les applique tous. L'option \fB\-\-no\-preparation\fP peut être +utilisée pour désactiver ce comportement. + +.PP +\fBEnregistrement des modifications\fP +.TP +\fB\-\-commit\fP [\fIrépertoire\fP] [\fInom\-du\-correctif\fP] [\fIfichier\-de\-correctif\fP] +Crée un correctif correspondant aux modifications locales non gérées par le +système de gestion de correctifs \fBquilt\fP et les intègre dans la liste des +correctifs sous le nom \fInom\-du\-correctif\fP. Si le nom est omis, il sera +demandé interactivement. Si \fIfichier\-de\-correctifs\fP est indiqué, il est +utilisé comme fichier de modifications locales à intégrer. Une fois intégré, +un éditeur est lancé afin de permettre d'ajouter des méta\-informations dans +l'en\-tête du correctif. + +Le fait de passer \fIfichier\-de\-correctifs\fP est essentiellement utile après +un échec de construction qui prégénère ce fichier. Sur ces bases, le fichier +est supprimé après intégration. Veuillez également noter que les +modifications contenues dans le fichier de correctifs doivent déjà être +appliquées dans l'arborescence et que les fichiers modifiés par le correctif +ne doivent pas comporter de modifications supplémentaires. + +Si la création de correctif détecte des fichiers binaires modifiés, ils +seront ajoutés automatiquement à \fBdebian/source/include\-binaries\fP afin de +pouvoir être inclus dans l'archive debian (de façon analogue à ce que ferait +\fBdpkg\-source \-\-include\-binaries \-\-build\fP). +.PP +\fBOptions de construction\fP +.TP +\fB\-\-allow\-version\-of\-quilt\-db=\fP\fIversion\fP +Autorise \fBdpkg\-source\fP à construire le fichier si la version des +métadonnées de \fBquilt\fP est celle indiquée, même si \fBdpkg\-source\fP n'en n'a +pas connaissance (depuis dpkg\ 1.15.5.4). En fait, cela indique que la +version indiquée des métadonnées de \fBquilt\fP est compatible avec la +version\ 2 que \fBdpkg\-source\fP gère. La version des métadonnées de \fBquilt\fP +est conservée dans \fB.pc/.version\fP. +.TP +\fB\-\-include\-removal\fP +N'ignore pas les fichiers supprimés et les inclut dans le fichier de +modifications généré automatiquement. +.TP +\fB\-\-include\-timestamp\fP +Inclut la date dans le correctif généré automatiquement. +.TP +\fB\-\-include\-binaries\fP +Ajoute tous les binaires modifiés dans l'archive tar debian. Les ajoute +aussi à \fBdebian/source/include\-binaries\fP\ : elles seront ajoutées par défaut +dans les constructions suivantes aussi cette option n'est donc plus +nécessaire. +.TP +\fB\-\-no\-preparation\fP +N'essaye pas de préparer l'arbre de la construction en appliquant les +correctifs qui ne sont apparemment pas appliqués (depuis dpkg\ 1.14.8). +.TP +\fB\-\-single\-debian\-patch\fP +Utilise \fBdebian/patches/debian\-changes\fP au lieu de +\fBdebian/patches/debian\-changes\-\fP\fIversion\fP comme nom du correctif +automatique créé au cours de la construction (depuis dpkg\ 1.15.5.4). Cette +option est particulièrement pratique lorsque le paquet est géré avec un +outil de gestion de versions et qu'un jeu de correctifs ne peut être créé de +façon fiable. Dans ce cas, les différences avec la version amont doivent +être conservées dans un correctif unique. Cette option serait indiquée dans +\fBdebian/source/local\-options\fP et accompagnée par un fichier +\fBdebian/source/local\-patch\-header\fP qui explique la meilleure méthode pour +revoir les corrections spécifiques à Debian, par exemple dans le +gestionnaire de versions utilisé. +.TP +\fB\-\-create\-empty\-orig\fP +Crée automatiquement l'archive principale tar d'origine vide si elle est +manquante et qu'il existe des archives tar d'origine additionnelles (depuis +dpkg\ 1.15.6). Cette option peut être utilisée lorsque le paquet source est +une collection de différents sources amont et qu'il n'existe pas de logiciel +«\ principal\ ». +.TP +\fB\-\-no\-unapply\-patches, \-\-unapply\-patches\fP +Par défaut, \fBdpkg\-source\fP retire automatiquement les correctifs dans le +point d'entrée \fB\-\-after\-build\fP s'ils ont été appliqués pendant +\fB\-\-before\-build\fP (\fB\-\-unapply\-patches\fP depuis dpkg\ 1.15.8, +\fB\-\-no\-unapply\-patches\fP depuis dpkg\ 1.16.5). Ces options permettent de +désactiver ou activer unilatéralement ce retrait des correctifs. Elles ne +sont permises que dans \fBdebian/source/local\-options\fP afin que tous les +paquets source créés aient le même comportement par défaut. +.TP +\fB\-\-abort\-on\-upstream\-changes\fP +Ce processus échouera si un correctif automatique a été créé (depuis +dpkg\ 1.15.8). Cette option peut servir à vérifier que toutes les +modifications ont été enregistrées correctement dans des correctifs \fBquilt\fP +distincts avant la construction du paquet source. Elle n'est pas autorisée +dans \fBdebian/source/options\fP mais peut prendre place dans +\fBdebian/source/local\-options\fP. +.TP +\fB\-\-auto\-commit\fP +Pas d'échec du processus de construction si un correctif automatique a été +créé\ : il est enregistré automatiquement dans le fichier series de \fBquilt\fP. + +.PP +\fBOptions d'extraction\fP +.TP +\fB\-\-skip\-debianization\fP +Passe l'étape d'extraction de l'archive tar debian des sources amont (depuis +dpkg\ 1.15.1). +.TP +\fB\-\-skip\-patches\fP +Ne pas appliquer des correctifs à la fin de l'extraction (depuis +dpkg\ 1.14.18). +. +.SS "Format\ : 3.0 (custom)" +Pris en charge depuis dpkg\ 1.14.17. Ce format est particulier. Il ne +représente pas un réel format de paquet source mais peut être utilisé pour +créer des paquets sources avec des fichiers arbitraires. +.PP +\fBOptions de construction\fP +.PP +Tous les arguments qui ne sont pas des options sont pris pour des fichiers à +intégrer dans le paquet source généré. Ils doivent exister et être de +préférence dans le répertoire courant. Au moins un fichier doit être donné. +.TP +\fB\-\-target\-format=\fP\fIvaleur\fP +\fBRequired\fP. Définit le format réel du paquet source généré. Le fichier +généré .dsc contiendra cette valeur dans son champ \fBformat\fP et non «\ 3.0 +(custom)\ ». +. +.SS "Format\ : 3.0 (git)" +Pris en charge depuis dpkg\ 1.14.17. Ce format est expérimental. +.PP +Un paquet source qui utilise ce format est constitué d'un seul ensemble d'un +dépôt git \fB.git\fP qui contient les sources du paquet. Il peut également +exister un fichier \fI.gitshallow\fP qui donne les révisions d'un clone git +«\ shallow\ ». +.PP +\fBExtraction\fP +.PP +Cet ensemble est cloné sous forme d'un dépôt git dans le répertoire +cible. S'il existe un fichier \fI.gitshallow\fP, il est installé en tant que +\&\fI.git/shallow\fP dans le dépôt git cloné. +.PP +Veuillez noter que, par défaut, le nouveau dépôt aura la même branche +récupérée que celle qui était récupérée dans les sources d'origine (souvent +«\ master\ » mais cela peut être tout à fait autre chose). Toutes les autres +branches seront disponibles sous \fIremotes/origin\fP. +.PP +\fBConstruction\fP +.PP +Avant d'aller plus loin, quelques vérifications sont effectuées afin de +s'assurer qu'il n'existe aucun changement non ignoré non soumis. +.PP +\fBgit\-bundle\fP(1) permet de créer un ensemble à partir du dépôt git. Par +défaut, toutes les branches et étiquettes du dépôt sont incluses dans cet +ensemble. +.PP +\fBOptions de construction\fP +.TP +\fB\-\-git\-ref=\fP\fIréf\fP +Permet d'indiquer une référence git à inclure dans l'ensemble +git. L'utilisation de cette option désactive le comportement par défaut qui +est d'inclure toutes les branches et étiquettes. Cette option peut être +utilisée plusieurs fois. Le paramètre \fIréf\fP peut être le nom d'une branche +ou une étiquette à inclure. Il peut également être tout paramètre que l'on +peut passer à \fBgit\-rev\-list\fP(1). Par exemple, pour n'inclure que la branche +«\ master\ », on peut utiliser \fB\-\-git\-ref=\fPmaster. Pour inclure toutes les +étiquettes et toutes les branches, sauf la branche privée, on peut utiliser +\-\fBgit\-ref=\fP\-\-all \fB\-\- git\-ref=\fP^private. +.TP +\fB\-\-git\-depth=\fP\fInombre\fP +Crée un clone «\ shallow\ » dont l'historique est tronqué au nombre indiqué de +révisions. +.SS "Format\ : 3.0 (bzr)" +Pris en charge depuis dpkg\ 1.14.17. Ce format est expérimental. Il crée une +archive tar contenant le dépôt bzr correspondant. +.PP +\fBExtraction\fP +.PP +L'archive tar est décompressée puis bzr est utilisé afin de récupérer la +branche courante. +.PP +\fBConstruction\fP +.PP +Avant d'aller plus loin, quelques vérifications sont effectuées afin de +s'assurer qu'il n'existe aucun changement non ignoré non soumis. +.PP +Ensuite, la partie spécifique du répertoire source du gestionnaire de +versions est copiée dans un répertoire temporaire. Avant que ce répertoire +temporaire ne soit empaqueté dans une archive tar, divers nettoyages sont +effectués pour économiser de l'espace. +.SH DIAGNOSTICS +.SS "aucun format source indiqué dans debian/source/format" +Le fichier \fBdebian/source/format\fP devrait toujours exister et indiquer le +format source souhaité. Pour préserver la compatibilité avec d'anciennes +versions, le format «\ 1.0\ » est implicite quand le fichier n'existe pas. Il +est déconseillé de dépendre de ce comportement qui pourrait être modifié +dans de futures versions de \fBdpkg\-source\fP, qui échoueront alors en +l'absence d'une mention explicite de format. + +Cela est dû au fait que le format «\ 1.0\ » n'est plus le format recommandé, +qu'il est conseillé de choisir un des formats les plus récents («\ 3.0 +(quilt)\ » ou «\ 3.0 (native)\ ») mais que dpkg\-source ne le fera pas +automatiquement. Si vous souhaitez continuer à utiliser l'ancien format, il +est nécessaire d'être explicite et indiquer «\ 1.0\ » dans +\fBdebian/source/format\fP. +.SS "le fichier de différences modifie les fichiers amont suivants" +Lors de l'utilisation du format source «\ 1.0\ », il est déconseillé de +modifier directement les fichiers amont car les modifications restent alors +cachées et souvent non documentées dans le fichier diff.gz. Au contraire, il +est conseillé de conserver les modifications sous forme de correctifs dans +le répertoire debian et de les appliquer au moment de la construction. Pour +éviter ces opérations plus complexes, vous pouvez également choisir le +format «\ 3.0 (quilt)\ » qui permet ces opérations de manière native. +.SS "impossible d'identifier les changements de \fIfichier\fP" +Les modifications des sources amont sont en général conservées dans des +fichiers de correctifs mais certaines modifications ne peuvent être +représentées sous forme de tels fichiers qui ne peuvent modifier que des +fichiers texte. Si vous essayez de remplacer un fichier avec un objet d'un +type différent (par exemple remplacer un fichier par un lien ou un +répertoire), ce message d'erreur s'affichera. +.SS "le fichier \fIfichier\fP, nouvellement créé, ne sera pas représenté dans le fichier de différences" +Les fichiers vides ne peuvent pas être créés avec des correctifs. En +conséquence, la modification n'est pas enregistrée dans le paquet source, ce +qui provoque cet avertissement. +.SS "le mode exécutable \fIpermissions\fP de \fIfichier\fP ne sera pas représenté dans le fichier de différences" +Les fichiers de correctifs n'enregistrent pas les permissions de fichiers +et, en conséquence, les permissions des exécutables ne sont pas enregistrées +dans le paquet source, ce qui provoque cet avertissement. +.SS "le mode spécial \fIpermissions\fP de \fIfichier\fP ne sera pas représenté dans le fichier de différences" +Les fichiers correctifs n'enregistrent pas les permissions de fichiers et, +en conséquence, les permissions modifiées ne sont pas enregistrées dans le +paquet source, ce qui provoque cet avertissement. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +.TP +\fBSOURCE_DATE_EPOCH\fP +Si cette option est utilisée, elle sera utilisée comme horodatage (en +seconde à partir de «\ l'epoch\ ») pour fixer le «\ mtime\ » dans les entrées du +fichier \fBtar\fP(5). +.TP +\fBVISUAL\fP +.TQ +\fBEDITOR\fP +Utilisé par les modules de format source «\ 2.0\ » et «\ 3.0 (quilt)\ ». +.TP +\fBGIT_DIR\fP +.TQ +\fBGIT_INDEX_FILE\fP +.TQ +\fBGIT_OBJECT_DIRECTORY\fP +.TQ +\fBGIT_ALTERNATE_OBJECT_DIRECTORIES\fP +.TQ +\fBGIT_WORK_TREE\fP +Utilisés par les modules de format source «\ 3.0 (git)\ ». +. +.SH FICHIERS +.SS debian/source/format +Ce fichier contient sur une seule ligne le format à utiliser pour construire +le paquet source (les formats acceptés sont décrits plus haut). Il ne doit +pas contenir d'espace avant ou après l'indication du format. +.SS debian/source/include\-binaries +Ce fichier contient une liste de fichiers binaires (un par ligne) qui +doivent être inclus dans l'archive tar debian. Les espaces placées avant ou +après ces noms sont supprimées. Les lignes commençant par «\ \fB#\fP\ » sont des +commentaires et sont ignorées, ainsi que les lignes vides. +.SS debian/source/options +Ce fichier contient la liste des options qui seront automatiquement ajoutées +au jeu d'options de ligne de commande lors de l'appel à \fBdpkg\-source +\-\-build\fP ou \fBdpkg\-source \-\-print\-format\fP. Des options comme +\fB\-\-compression\fP et \fB\-\-compression\-level\fP conviennent bien pour ce fichier. +.P +Chaque option doit être placée sur une ligne distincte. Les lignes vides et +les lignes commençant par le caractère «\ \fB#\fP\ » sont ignorées. Les +caractères initiaux «\ \fB\-\-\fP\ » doivent être retirés et les options courtes ne +peuvent pas être utilisées. Des espaces optionnelles sont autorisées autour +du symbole «\ \fB=\fP\ », ainsi que des guillemets optionnels autour de la valeur +d'une option donnée. Voici un exemple d'un tel fichier\ : +.P + # autoriser dpkg\-source à créer un fichier debian.tar.bz2 avec la + #compression maximale + compression = "bzip2" + compression\-level = 9 + # utiliser debian/patches/debian\-changes comme correctif automatique + single\-debian\-patch + # ignorer les modifications dans config.{sub,guess} + extend\-diff\-ignore = "(^|/)(config.sub|config.guess)$" +.P +Note\ : les options de \fBformat\fP ne sont pas acceptées dans ce fichier. Vous +devriez utiliser \fBdebian/source/format\fP à la place. +.SS debian/source/local\-options +Identique à \fBdebian/source/options\fP mais n'est pas enregistré dans le +paquet source créé. Ce fichier peut être utile pour conserver une préférence +propre au responsable ou au dépôt de gestionnaire de versions où le paquet +source est géré. +.SS "debian/source/local\-patch\-header \fRet\fP debian/source/patch\-header" +Texte en format libre qui sera ajouté au début du correctif automatique créé +dans les formats «\ 2.0\ » et «\ 3.0 (quilt)\ ». \fBlocal\-patch\-header\fP n'est pas +inclus dans le paquet source créé alors que \fBpatch\-header\fP l'est. +.SS debian/patches/\fIdistributeur\fP.series +.SS debian/patches/series +Ce fichier comporte la liste de toutes les correctifs qui ont été appliqués +(dans l'ordre indiqué) aux sources amont. Les espaces situées avant et après +les noms sont ignorées. L'argument \fIdistributeur\fP sera le nom en minuscules +du distributeur ou \fBdebian\fP si aucun distributeur n'est défini. Si le +fichier de séries propre au distributeur n'existe pas, le fichier de séries +sans distributeur sera utilisé. Les lignes commençant par «\ \fB#\fP\ » sont des +commentaires et sont ignorées, ainsi que les lignes vides. Les autres lignes +débutent par le nom du fichier de correctifs (relatif au répertoire +\fBdebian/patches/\fP) et se terminent à la première espace ou à la fin de la +ligne. Des options facultatives de \fBquilt\fP peuvent être ajoutées jusqu'à la +fin de la ligne ou jusqu'au premier caractère «\ \fB#\fP\ » précédé par une ou +plusieurs espaces (ce qui indique le début d'un commentaire se terminant à +la fin de la ligne). +.SH BOGUES +Le moment où se déroule le remplacement d'un champ par rapport à certaines +déterminations de champ affichées sur la sortie standard est plutôt +embrouillé. +.SH "VOIR AUSSI" +.ad l +\fBdeb\-src\-control\fP(5), \fBdeb\-changelog\fP(5), \fBdsc\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-split.man b/man/fr/dpkg-split.man new file mode 100644 index 0000000..f78c76d --- /dev/null +++ b/man/fr/dpkg-split.man @@ -0,0 +1,220 @@ +.\" dpkg manual page - dpkg-split(1) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2011 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-split 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-split \- Outil de décomposition/recomposition des paquets Debian +. +.SH SYNOPSIS +\fBdpkg\-split\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBdpkg\-split\fP décompose les fichiers d'un paquet binaire Debian en parties +plus petites (et les recompose), pour permettre l'enregistrement des +fichiers d'un paquet volumineux sur des média de faible capacité tels que +les disquettes. + +On peut s'en servir «\ à la main\ » avec les options \fB\-\-split\fP, \fB\-\-join\fP et +\fB\-\-info\fP. + +Il possède aussi un mode automatique, appelé avec l'option \fB\-\-auto\fP, dans +lequel il conserve séparément dans une file les parties connues ou recompose +le fichier d'un paquet quand il connaît toutes ses parties. Les options +\fB\-\-listq\fP et \fB\-\-discard\fP permettent la gestion de cette file. + +Toutes les opérations de décomposition, recomposition ou de mise en file +produisent des messages sur la sortie standard\ ; ils peuvent être +tranquillement ignorés. +. +.SH COMMANDES +.TP +\fB\-s\fP, \fB\-\-split\fP \fIarchive\-complète\fP [\fIpréfixe\fP] +Décompose en plusieurs parties un paquet binaire Debian. + +Le nom d'une partie est\ : \fIpréfixe\fP\fB.\fP\fIN\fP\fBde\fP\fIM\fP\fB.deb\fP où \fIN\fP le +numéro de partie, commençant à 1, et \fIM\fP est le nombre total de parties +(les deux sont des décimaux). + +Quand on ne donne pas de \fIpréfixe\fP, le nom du fichier \fIarchive\-complète\fP +est utilisé, en incluant le répertoire et en supprimant tout \fB.deb\fP +restant. +.TP +\fB\-j\fP, \fB\-\-join\fP \fIpartie\fP... +Rassemble les parties d'un fichier, recomposant ainsi le fichier d'origine +tel qu'il était avant la décomposition. + +Ces parties, données comme arguments, doivent appartenir toutes au même +fichier binaire d'origine. Chaque partie ne doit apparaître qu'une seule +fois dans la liste des arguments\ ; mais il est inutile de les ordonner. + +Les parties doivent bien sûr avoir été créées selon le même modèle (taille +maximum des parties), qui est déclaré au moment de la décomposition\ ; ce qui +signifie en fait qu'elles doivent avoir été créées par le même appel à +\fBdpkg\-split \-\-split\fP. + +Les parties des noms ne sont pas significatives pour le processus de +recomposition. + +Par défaut, le fichier produit s'appelle +\fIpaquet\fP\fB_\fP\fIversion\fP\fB_\fP\fIarch\fP\fB.deb\fP. + +.TP +\fB\-I\fP, \fB\-\-info\fP \fIpartie\fP... +Affiche les renseignements concernant telle partie dans un format lisible +par tous. Les arguments ne représentant pas la partie d'un fichier binaire +le disent aussi sur la sortie standard. +.TP +\fB\-a\fP, \fB\-\-auto \-o\fP \fIfichier\-complet partie\fP +Met en file automatiquement les parties en vue de la recomposition d'un +paquet. + +La \fIpartie\fP déclarée est examinée et comparée avec les autres parties du +même paquet qui se trouvent (si elles existent) dans la file. + +Quand toutes les parties d'un fichier (auquel appartient la partie +\fIpartie\fP) sont présentes, le fichier est recomposé et créé en tant que +\fIfichier\-complet\fP (ce fichier ne devrait pas déjà exister, mais ce n'est +pas une erreur). + +Quand ce n'est pas le cas, la partie \fIpartie\fP est mise dans la file et le +fichier \fIfichier\-complet\fP n'est pas créé. + +Quand la \fIpartie\fP n'appartient pas à un paquet binaire décomposé, +\fBdpkg\-split\fP se termine avec un code de sortie égal à \fB1\fP\ ; s'il y a une +autre erreur, c'est un code de sortie égal à \fB2\fP. + +L'option \fB\-\-output\fP ou \fB\-o\fP doit être fournie avec l'action \fB\-\-auto\fP. Si +cela n'était pas obligatoire, le programme appelant ne saurait pas quel +fichier attendre. +.TP +\fB\-l\fP, \fB\-\-listq\fP +Liste le contenu d'une file de paquets à recomposer. + +Pour chaque fichier possédant des parties dans la file, cette action donne +le nom du fichier, les parties présentes dans la file et le nombre total +d'octets conservés. +.TP +\fB\-d\fP, \fB\-\-discard\fP [\fIpaquet\fP...] +Cette action laisse de côté certaines parties dans la file, celles qui sont +en attente des autres parties composant le paquet. + +Quand aucun \fIpaquet\fP n'est donné, la file est vidée\ ; si un paquet est +donné, seules les parties de ce paquet sont détruites. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-\-depotdir\fP\fI répertoire\fP +Indique un répertoire différent pour la file comprenant les parties en +attente d'une recomposition automatique. Par défaut, c'est le répertoire +\fB%ADMINDIR%\fP. +.TP +\fB\-S\fP, \fB\-\-partsize\fP \fIkibioctets\fP +Indique, en kibioctet (1024 octets), la taille maximum d'une partie lors +d'une décomposition. Par défaut, la taille maximum est de 450\ Kio. +.TP +\fB\-o\fP, \fB\-\-output\fP \fIfichier\-complet\fP +Indique le nom du fichier à produire pour une recomposition. + +Cela annule le fichier par défaut lors d'une recomposition «\ à la main\ » +(\fB\-\-join\fP) et c'est obligatoire pour une recomposition ou une mise en file +automatiques (\fB\-\-auto\fP). +.TP +\fB\-Q\fP, \fB\-\-npquiet\fP +Pour une recomposition ou une mise en file automatiques, \fBdpkg\-split\fP +affiche habituellement un message si on lui donne une \fIpartie\fP qui n'est +pas une partie d'un paquet binaire. Cette option supprime ce message\ ; cela +permet à des programmes comme \fBdpkg\fP de ne pas afficher de faux messages +quand il est confronté à des paquets décomposés et des paquets non +décomposés. +.TP +\fB\-\-msdos\fP +Oblige le nom des fichiers produits par \fB\-\-split\fP à se conformer à MS\-DOS. + +Cela supprime le préfixe, soit celui par défaut dérivé du nom du fichier +d'entrée, soit celui donné comme argument\ : les caractères alphanumériques +sont en minuscules, les signes plus sont remplacés par des \fBx\fP et tous les +autres caractères sont abandonnés. + +Le résultat est alors tronqué autant que nécessaire et des fichiers de la +forme\ : \fIprefixN\fP\fBof\fP\fIM\fP\fB.deb\fP sont créés. +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +La recomposition ou bien toute autre commande a réussi. Les commandes +\fB\-\-info\fP réussissent toujours même si les fichiers ne sont pas des parties +d'un paquet binaire. +.TP +\fB1\fP +Ne peut apparaître qu'avec l'action \fB\-\-auto\fP et signale que le fichier +\fIpartie\fP n'est pas une partie d'un paquet binaire. +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à une utilisation non valable de la ligne +de commande, à un fichier qui ressemble à fichier appartenant à un paquet +mais qui est corrompu, ou à des interactions avec le système, telles que des +accès à la base de données, des allocations mémoires,\ etc. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBSOURCE_DATE_EPOCH\fP +Si cette option est utilisée, elle sera utilisée comme horodatage (en +seconde à partir de «\ l'epoch\ ») dans le conteneur \fBar\fP(5) de +\fBdeb\-split\fP(5). +. +.SH FICHIERS +.TP +\fI%ADMINDIR%/parts\fP +Le répertoire par défaut de la file contenant les fichiers qui attendent une +recomposition automatique. + +Les noms de fichiers utilisés dans ce répertoire sont dans un format +particulier à \fBdpkg\-split\fP et ne sont sans doute pas utiles pour d'autres +programmes\ ; en tous cas on ne peut pas compter sur ce format de nom de +fichier. +. +.SH BOGUES +On ne peut pas obtenir tous les détails voulus sur les paquets présents dans +la file à moins d'aller voir soi\-même dans le répertoire de la file. + +On ne peut pas facilement savoir si un fichier est vraiment la partie d'un +paquet binaire ou non. +. +.SH "VOIR AUSSI" +\fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg\-deb\fP(1), \fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-statoverride.man b/man/fr/dpkg-statoverride.man new file mode 100644 index 0000000..a263a36 --- /dev/null +++ b/man/fr/dpkg-statoverride.man @@ -0,0 +1,181 @@ +.\" dpkg manual page - dpkg-statoverride(1) +.\" +.\" Copyright © 2000-2001 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2009-2011, 2013, 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-statoverride 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-statoverride \- Annuler la propriété et le mode des fichiers +. +.SH SYNOPSIS +\fBdpkg\-statoverride\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +Les «\ \fBdérogations d'état\fP\ » sont une façon de demander à \fBdpkg\fP(1) de +changer le propriétaire ou le mode d'un chemin lors de l'installation d'un +paquet (cela s'applique à tout objet de système de fichiers que \fBdpkg\fP +gère, notamment les répertoires, les périphériques,\ etc.). On peut s'en +servir pour forcer l'installation de programmes qui sont normalement +«\ setuid\ » sans ce drapeau «\ setuid\ », ou pour les rendre exécutables +seulement par un groupe donné. +.P +\fBdpkg\-statoverride\fP est un utilitaire pour gérer la liste des +dérogations. Il possède trois fonctions élémentaires\ : l'ajout, la +suppression et le listage des dérogations. +. +.SH COMMANDES +.TP +\fB\-\-add\fP\fI utilisateur groupe mode chemin\fP +Ajoute une dérogation («\ override\ ») pour \fIchemin\fP. \fIchemin\fP n'a pas +besoin d'exister quand cette commande est utilisée\ ; la dérogation est +stockée et utilisée par la suite. Les utilisateurs ou les groupes peuvent +être indiqués par leur nom (par exemple \fBroot\fP ou \fBnobody\fP) ou bien par +leur numéro, en préfixant ce numéro par le caractère «\ \fB#\fP\ » (par exemple, +\fB#0\fP ou \fB#65534\fP). Le \fImode\fP doit être indiqué en numérotation octale. + +Si \fB\-\-update\fP est utilisée et si \fIchemin\fP existe, le fichier change +immédiatement de propriétaire et de mode. +.TP +\fB\-\-remove\fP \fI chemin\fP +Supprime une dérogation («\ override\ ») pour \fIchemin\fP, l'état de \fIchemin\fP +est inchangé. +.TP +\fB\-\-list\fP [\fImotif\-global\fP] +Liste toutes les dérogations. Quand on donne une expression rationnelle +(«\ glob\ »), la sortie est limitée aux dérogations qui correspondent au +motif. +.TP +\fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-force\-help\fP +Donne des renseignements sur les options \fB\-\-force\-\fP\fIquelque\-chose\fP (depuis +dpkg\ 1.19.5). +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-\-admindir\fP\fI répertoire\fP +Fixe le répertoire d'administration à \fIrépertoire\fP, où se trouve aussi le +fichier \fIstatoverride\fP. La valeur par défaut est \fI%ADMINDIR%\fP. +.TP +\fB\-\-instdir\fP \fIrépertoire\fP +Définit le répertoire d'installation qui désigne le répertoire où les +paquets sont installés (depuis dpkg\ 1.19.2). Par défaut c'est «\ \fI/\fP\ ». +.TP +\fB\-\-root\fP \fIrépertoire\fP +Définit le répertoire root à \fBdirectory\fP, ce qui définit le répertoire +d'installation à «\ \fIrépertoire\fP\ » et le répertoire d'administration à +«\ \fIrépertoire\fP\fB%ADMINDIR%\fP\ » (depuis dpkg\ 1.19.2). +.TP +\fB\-\-force\-\fP\fIquelque\-chose\fP +.TQ +\fB\-\-no\-force\-\fP\fIquelque\-chose\fP, \fB\-\-refuse\-\fP\fIquelque\-chose\fP +Force ou refuse (\fBno\-force\fP et \fBrefuse\fP signifient la même chose) de faire +quelque chose (depuis dpkg\ 1.19.5). \fIquelque\-chose\fP est une liste d'actions +séparées par des virgules, décrites ci\-après. \fB\-\-force\-help\fP affiche un +message qui les décrit. Les actions marquées d'un (*) sont forcées par +défaut. + +\fIAvertissement\ : ces options sont principalement destinées aux experts. Un +usage auquel manque la pleine compréhension de leurs effets peut casser le +système entier.\fP + +\fBall\fP\ : Met en œuvre (ou pas) toutes les options de forçage. + +\fBstatoverride\-add\fP\ : remplacer une dérogation d'état existante lors de son +ajout (depuis dpkg\ 1.19.5) + +\fBstatoverride\-remove\fP\ : ignorer l'absence de dérogation d'état lors de sa +suppression (depuis dpkg\ 1.19.5). + +\fBsecurity\-mac\fP(*)\ : utiliser une sécurité basée sur le contrôle d'accès +obligatoire (Mandatory Access Controls –\ MAC) spécifique à la plateforme +lors de l'installation de fichiers dans le systèmes de fichiers (depuis +dpkg\ 1.19.5). Sur les systèmes Linux, la mise en œuvre utilise SELinux. +.TP +\fB\-\-force\fP +Force une opération, même si un test de validité l'interdirait. C'est +nécessaire pour annuler une précédente dérogation. Cette option est obsolète +(depuis dpkg\ 1.19.5), elle est remplacée par \fB\-\-force\-all\fP. +.TP +\fB\-\-update\fP +Essaye de changer immédiatement le \fIchemin\fP vers les nouveaux propriétaire +et mode s'il existe. +.TP +\fB\-\-quiet\fP +Moins de bavardage sur ce qui est fait. +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +L'action demandée s'est correctement déroulée. +.TP +\fB1\fP +Pour \fB\-\-list\fP, s'il n'y a pas de dérogation ou si aucune ne correspond au +«\ glob\ » fourni. +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande +non valable, ou interactions avec le système, telles que des accès à la base +de données, des allocations de mémoire,\ etc. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_ROOT\fP +Si cette variable est positionnée et que les options \fB\-\-admindir\fP ou +\fB\-\-root\fP ne sont pas précisées, ce répertoire sera utilisé comme répertoire +racine du système de fichiers (depuis dpkg\ 1.19.2). +.TP +\fBDPKG_ADMINDIR\fP +Si cette variable est positionnée et que les options \fB\-\-admindir\fP ou +\fB\-\-root\fP ne sont pas précisées, ce répertoire sera utilisé comme répertoire +de données pour \fBdpkg\fP. +.TP +\fBDPKG_FORCE\fP +Si cette variable est positionnée et qu'aucune des options \fB\-\-force\-\fP\fI...\fP +n'est précisée, elle sera considérée comme l'option de forçage à utiliser +(depuis dpkg\ 1.19.5). +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +. +.SH FICHIERS +.TP +\fI%ADMINDIR%/statoverride\fP +Ce fichier contient la liste actuelle des dérogations concernant le +système. Il se trouve dans le répertoire d'administration de \fBdpkg\fP, avec +les autres fichiers importants comme \fIstatus\fP ou \fIavailable\fP. +.br +Note\ : \fBdpkg\-statoverride\fP garde une copie de ce fichier, avec une +extension «\ \-old\ », avant de le remplacer par un nouveau. +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-trigger.man b/man/fr/dpkg-trigger.man new file mode 100644 index 0000000..af1bf4c --- /dev/null +++ b/man/fr/dpkg-trigger.man @@ -0,0 +1,122 @@ +.\" dpkg manual page - dpkg-trigger(1) +.\" +.\" Copyright © 2008-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-trigger 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-trigger \- Un utilitaire pour activer les actions différées de paquets +. +.SH SYNOPSIS +\fBdpkg\-trigger\fP [\fIoption\fP...] \fInom\-action\-différée\fP +.br +\fBdpkg\-trigger\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBdpkg\-trigger\fP est un outil pour activer explicitement les actions +différées et pour vérifier leur gestion dans le fonctionnement de \fBdpkg\fP. +.PP +Utilisable par les scripts du responsable dans certaines situations +complexes où un fichier d'actions différées («\ triggers\ ») ou la directive +\fBactivate\fP du fichier de contrôle des actions différées ne sont pas +suffisants. Peut également être utilisé pour des essais ou par les +administrateurs système (noter que les actions différées ne seront alors pas +exécutées par \fBdpkg\-trigger\fP). +.PP +Les syntaxes non reconnues pour le nom des actions différées constituent une +erreur pour \fBdpkg\-trigger\fP. +. +.SH COMMANDES +.TP +\fB\-\-check\-supported\fP +Vérifie si \fBdpkg\fP sait gérer les actions différées (généralement appelées +depuis un script de post\-installation). Retourne en sortie \fB0\fP si c'est le +cas, ou \fB1\fP avec un message d'erreur sur stderr si ce n'est pas le +cas. Toutefois, en règle générale, il est préférable de simplement activer +l'action différée désirée à l'aide de \fBdpkg\-trigger\fP. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-\-admindir\fP=\fIrépertoire\fP +Change l'endroit où se trouve la base de données de \fBdpkg\fP. Par défaut, +c'est \fI%ADMINDIR%\fP. +.TP +\fB\-\-by\-package=\fP\fIpaquet\fP +Indique le paquet qui sera marqué en attente de l'exécution de l'action +différée (normalement défini par la variable d'environnement +\fBDPKG_MAINTSCRIPT_PACKAGE\fP dans les scripts du responsable, qui nomme le +paquet auquel le script appartient, et qui constitue la valeur par défaut). +.TP +\fB\-\-no\-await\fP +Cette option fait en sorte que le paquet appelant T (s'il existe) n'a pas +besoin d'attendre l'exécution de cette action différée\ ; I, le(s) paquet(s) +associé(s) à l'action différée, ne sera pas ajouté à liste des paquets dont +le traitement des actions différées est attendu par T et l'état de T reste +inchangé. T peut être considéré installé même si les actions différées de I +n'ont pas encore été exécutées. +.TP +\fB\-\-await\fP +Cette option a l'effet inverse de \fB\-\-no\-await\fP (depuis dpkg\ 1.17.21). Si le +paquet intéressé a déclaré une directive «noawait\ », cette option ne sera +pas effective. C'est actuellement le comportement par défaut. +.TP +\fB\-\-no\-act\fP +Teste uniquement, n'apporte aucun changement. +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +L'action demandée s'est correctement déroulée. Ou bien une commande de +vérification ou de déclaration renvoie «\ true\ ». +.TP +\fB1\fP +Une commande de vérification ou de déclaration renvoie «\ false\ ». +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande +non valable, ou interactions avec le système, telles que des accès à la base +de données, des allocations de mémoire,\ etc. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_ADMINDIR\fP +Si cette variable est positionnée et que l'option \fB\-\-admindir\fP n'est pas +précisée, ce répertoire sera utilisé comme répertoire de données pour +\fBdpkg\fP. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +. +.SH "VOIR AUSSI" +.\" FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev. +\fBdpkg\fP(1), \fBdeb\-triggers\fP(5), \fB/usr/share/doc/dpkg\-dev/triggers.txt.gz\fP. +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg-vendor.man b/man/fr/dpkg-vendor.man new file mode 100644 index 0000000..a73bbf3 --- /dev/null +++ b/man/fr/dpkg-vendor.man @@ -0,0 +1,86 @@ +.\" dpkg manual page - dpkg-vendor(1) +.\" +.\" Copyright © 2009 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-vendor 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg\-vendor \- Récupère les informations sur les éditeurs de distribution +. +.SH SYNOPSIS +\fBdpkg\-vendor\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBdpkg\-vendor\fP est un outil qui permet de récupérer des informations sur les +éditeurs («\ vendors\ ») de distributions référencés dans +\fB%PKGCONFDIR%/origins\fP. \fB%PKGCONFDIR%/origins/default\fP contient +l'information relative à l'éditeur actuellement utilisé. +. +.SH COMMANDES +.TP +\fB\-\-is\fP\fI éditeur\fP +Retourne \fB0\fP si l'éditeur est \fIéditeur\fP. Retourne \fB1\fP dans le cas +contraire. +.TP +\fB\-\-derives\-from\fP\fI éditeur\fP +Retourne \fB0\fP si la distribution de l'éditeur actuel est une distribution +dérivée de \fIéditeur\fP, autrement, retourne \fB1\fP. Le champ \fBParent\fP est +utilisé pour parcourir tous les ancêtres de l'éditeur actuel. +.TP +\fB\-\-query\fP\fI champ\fP +Affiche sur la sortie standard la valeur du champ spécifique \fIchamp\fP de +l'éditeur actuel. +.TP +\fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-\-vendor\fP\fI éditeur\fP +Suppose que l'éditeur actuel est \fIéditeur\fP au lieu d'utiliser la variable +\fBDEB_VENDOR\fP ou \fB%PKGCONFDIR%/origins/default\fP. +. +.SH ENVIRONNEMENT +.TP +\fBDEB_VENDOR\fP +Ce réglage définit l'éditeur («\ vendor\ ») actuel. Si cette valeur est vide, +le contenu du fichier \fB%PKGCONFDIR%/origins/default\fP est utilisé. +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_NLS\fP +Si cette variable est définie, elle sera utilisée pour décider l'activation +de la prise en charge des langues (NLS –\ Native Language Support), connu +aussi comme la gestion de l'internationalisation (ou i18n) (depuis +dpkg\ 1.19.0). Les valeurs permises sont\ : \fB0\fP et \fB1\fP (par défaut). +. +.SH "VOIR AUSSI" +\fBdeb\-origin\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg.cfg.man b/man/fr/dpkg.cfg.man new file mode 100644 index 0000000..12cebf9 --- /dev/null +++ b/man/fr/dpkg.cfg.man @@ -0,0 +1,49 @@ +.\" dpkg manual page - dpkg.cfg(5) +.\" +.\" Copyright © 2002 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2009, 2013, 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg.cfg 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg.cfg \- Fichier de configuration de dpkg +. +.SH DESCRIPTION +Ce fichier liste les options appliquées par défaut à dpkg. Chaque ligne +contient une seule option, écrite exactement comme sur la ligne de commande +mais sans les tirets initiaux, inutilisés. Les guillemets autour des valeurs +d'options sont supprimés. Les commentaires sont autorisés en faisant +commencer la ligne par un caractère («\ \fB#\fP\ »). +. +.SH FICHIERS +\fI%PKGCONFDIR%/dpkg.cfg.d/[0\-9a\-zA\-Z_\-]*\fP +.br +\fI%PKGCONFDIR%/dpkg.cfg\fP +.br +\fI~/.dpkg.cfg\fP +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dpkg.man b/man/fr/dpkg.man new file mode 100644 index 0000000..4b200de --- /dev/null +++ b/man/fr/dpkg.man @@ -0,0 +1,1154 @@ +.\" dpkg manual page - dpkg(1) +.\" +.\" Copyright © 1996 Juho Vuori <javuori@cc.helsinki.fi> +.\" Copyright © 1999 Jim Van Zandt <jrv@vanzandt.mv.com> +.\" Copyright © 1999-2003 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2000-2003 Adam Heath <doogie@debian.org> +.\" Copyright © 2002 Josip Rodin +.\" Copyright © 2004-2005 Scott James Remnant <keybuk@debian.org> +.\" Copyright © 2006-2016 Guillem Jover <guillem@debian.org> +.\" Copyright © 2007-2008 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2008-2011 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dpkg \- Gestionnaire de paquet pour Debian +. +.SH SYNOPSIS +\fBdpkg\fP [\fIoption\fP...] \fIaction\fP +. +.SH AVERTISSEMENT +Ce manuel est destiné aux utilisateurs qui souhaitent aller au\-delà de la +commande \fBdpkg \-\-help\fP pour la compréhension des options de la ligne de +commande et des états des paquets. + +Les responsables de paquet qui veulent comprendre comment \fBdpkg\fP installe +leur paquet \fIne doivent pas\fP l'utiliser. Les descriptions concernant +l'installation ou la désinstallation des paquets sont très insuffisantes. +. +.SH DESCRIPTION +\fBdpkg\fP est un outil pour l'installation, la création, la suppression et la +gestion des paquets Debian. \fBaptitude\fP(1) est la principale interface à +\fBdpkg\fP et la plus agréable pour l'utilisateur. \fBdpkg\fP lui\-même est +entièrement contrôlé par des paramètres sur la ligne de commande. Une +commande comporte exactement une action et zéro ou plusieurs options. Le +paramètre «\ action\ » dit ce que \fBdpkg\fP doit faire et les options modifient +l'action d'une manière ou d'une autre. + +\fBdpkg\fP peut également être utilisé comme interface pour \fBdpkg\-deb\fP(1) et +\fBdpkg\-query\fP(1). La liste des actions gérées est indiquée dans la section +\fBACTIONS\fP. Si cette section est présente, \fBdpkg\fP n'exécute que \fBdpkg\-deb\fP +ou \fBdpkg\-query\fP avec les paramètres qui lui sont passés, mais aucune action +spécifique ne leur est communiquée. Pour utiliser cela, il est nécessaire +d'appeler le programme directement. +. +.SH "RENSEIGNEMENTS SUR LES PAQUETS" +\fBdpkg\fP conserve des renseignements utiles sur les paquets +disponibles. Cette information est divisée en trois classes\ : les états, les +états de la sélection et les drapeaux. La modification de ces valeurs est +principalement dévolue à \fBdselect\fP. +.SS "États du paquet\ :" +.TP +\fBnot\-installed\fP +Le paquet n'est pas installé sur le système. +.TP +\fBconfig\-files\fP +Seuls les fichiers de configuration du paquet existent sur le système. +.TP +\fBhalf\-installed\fP +L'installation du paquet a commencé mais, pour une raison quelconque, ne +s'est pas terminée. +.TP +\fBunpacked\fP +Le paquet est dépaqueté mais n'est pas configuré. +.TP +\fBhalf\-configured\fP +Le paquet est dépaqueté et la configuration a commencé mais, pour une +quelconque raison, ne s'est pas terminée. +.TP +\fBtriggers\-awaited\fP +Le paquet attend l'exécution d'une action différée qui est à la charge d'un +autre paquet. +.TP +\fBtriggers\-pending\fP +Une action différée de ce paquet a été activée, il reste à l'exécuter. +.TP +\fBinstalled\fP +Le paquet est correctement dépaqueté et configuré. +.SS "États de sélection des paquets" +.TP +\fBinstall\fP +Le paquet est sélectionné pour être installé. +.TP +\fBhold\fP +\fBdpkg\fP laisse de côté un paquet marqué \fBhold\fP, à moins qu'il ne soit lancé +avec l'option de forçage \fB\-\-force\-hold\fP. +.TP +\fBdeinstall\fP +Le paquet est sélectionné pour être désinstallé (c'est\-à\-dire qu'on veut +supprimer tous les fichiers à l'exception des fichiers de configuration). +.TP +\fBpurge\fP +Le paquet est sélectionné pour être purgé (c'est\-à\-dire qu'on veut tout +supprimer dans les répertoires du système, même les fichiers de +configuration). +.TP +\fBunknown\fP +La sélection de paquets est inconnue. Un paquet qui est aussi dans un état +\fBnot\-installed\fP et avec un drapeau \fBok\fP sera oublié dans le prochain +enregistrement de la base de données. +.SS "Drapeaux du paquet\ :" +.TP +\fBok\fP +Un paquet marqué \fBok\fP est dans un état connu, mais pourrait nécessiter un +traitement supplémentaire. +.TP +\fBreinstreq\fP +Un paquet marqué \fBreinstreq\fP est défectueux et demande une +réinstallation. \fBdpkg\fP ne peut supprimer ces paquets, à moins qu'il ne soit +lancé avec l'option de forçage \fB\-\-force\-remove\-reinstreq\fP. +. +.SH ACTIONS +.TP +\fB\-i\fP, \fB\-\-install\fP \fIfichier\-paquet\fP... +Installe le paquet. Si l'option \fB\-\-recursive\fP ou \fB\-R\fP est utilisée, +\fIfichier\-paquet\fP doit alors être un répertoire. + +L'installation comporte les étapes suivantes\ : +.br + +\fB1.\fP Extraction des fichiers de contrôle du nouveau paquet. +.br + +\fB2.\fP Quand une ancienne version du même paquet est déjà installée, +exécution du script \fIprerm\fP de l'ancien paquet. +.br + +\fB3.\fP Lancement du script \fIpreinst\fP, s'il est fourni par le paquet. +.br + +\fB4.\fP Dépaquetage des nouveaux fichiers et, en même temps, sauvegarde des +anciens de manière à pouvoir les restaurer si quelque chose tourne mal. +.br + +\fB5.\fP Quand une ancienne version du même paquet est déjà installée, +exécution du script \fIpostrm\fP de l'ancien paquet. Il faut remarquer que ce +script est exécuté après le script \fIpreinst\fP du nouveau paquet, parce que +les nouveaux fichiers sont écrits dans le même temps que les anciens sont +supprimés. +.br + +\fB6.\fP Configuration du paquet. Voyez l'action \fB\-\-configure\fP pour savoir +comment cela se passe. +.TP +\fB\-\-unpack \fP\fIfichier\-paquet\fP... +Dépaquète le paquet mais ne configure rien. Si l'option \fB\-\-recursive\fP ou +\fB\-R\fP est utilisée, \fIfichier\-paquet\fP doit alors indiquer un répertoire. +.TP +\fB\-\-configure \fP\fIpaquet\fP...|\fB\-a\fP|\fB\-\-pending\fP +Configuration d'un paquet dépaqueté mais non encore configuré. Si l'option +\fB\-a\fP ou \fB\-\-pending\fP est utilisée au lieu de \fIpaquet\fP, tous les paquets +dépaquetés mais non configurés sont configurés. + +Pour reconfigurer un paquet qui l'a déjà été, vous devriez plutôt utiliser +la commande \fBdpkg\-reconfigure\fP(8). + +La configuration comporte les étapes suivantes\ : +.br + +\fB1.\fP Dépaquetage des fichiers de configuration, et dans le même temps +sauvegarde des anciens fichiers de configuration, de manière à pouvoir les +restaurer si quelque chose se passe mal. +.br + +\fB2.\fP Exécution du script \fBpostinst\fP, s'il est fourni par le paquet. +.TP +\fB\-\-triggers\-only\fP \fIpaquet\fP ...|\fB\-a\fP | \fB\-\-pending\fP +N'exécute que les actions différées (depuis dpkg\ 1.14.17). Toutes les +actions différées en attente seront traitées. Si des noms de paquets sont +fournis, les actions différées de ces paquets seront traitées, une fois +chacune lorsque nécessaire. L'utilisation de cette option peut laisser des +paquets dans les états incorrects de \fBtriggers\-awaited\fP et de +\fBtriggers\-pending\fP. Cela peut être corrigé plus tard en exécutant\ : \fBdpkg +\-\-configure \-\-pending\fP. +.TP +\fB\-r\fP, \fB\-\-remove\fP \fIpaquet\fP...|\fB\-a\fP|\fB\-\-pending\fP +Supprimer un paquet installé. Cela supprime tout à l'exception des fichiers +de configuration et les autres données nettoyées par le script \fIpostrm\fP, ce +qui évite d'avoir à reconfigurer le paquet s'il était réinstallé par la +suite (ces fichiers sont les fichiers de configuration listés dans le +fichier de contrôle \fIDEBIAN/conffiles\fP). S'il n'y a pas de fichier de +contrôle \fIDEBIAN/conffiles\fP ni script \fIDEBIAN/postrm\fP, cette commande est, +équivalente à l'appel de \fB\-\-purge\fP. Si \fB\-a\fP ou \fB\-\-pending\fP est indiqué à +la place d'un nom de paquet, alors tous les paquets dépaquetés mais marqués +pour suppression dans le fichier \fI%ADMINDIR%/status\fP seront supprimés. + +La suppression d'un paquet comporte les étapes suivantes\ : +.br + +\fB1.\fP Lancement du script \fIprerm\fP +.br + +\fB2.\fP Suppression des fichiers installés +.br + +\fB3.\fP Lancement du script \fIpostrm\fP +.br + +.TP +\fB\-P\fP, \fB\-\-purge\fP \fIpaquet\fP...|\fB\-a\fP|\fB\-\-pending\fP +Purger un paquet installé ou déjà supprimé. L'action supprime tout, y +compris les fichiers de configuration et tout le reste nettoyé de +\fIpostrm\fP. Si \fB\-a\fP ou \fB\-\-pending\fP est indiqué à la place d'un nom de +paquet, tous les paquets dépaquetés ou supprimés mais marqués dans le +fichier \fI%ADMINDIR%/status\fP comme devant être purgés seront purgés. + +Note\ : certains fichiers de configuration peuvent être inconnus de \fBdpkg\fP +car ils sont créés et gérés séparément par le biais de scripts de +configuration. En ce cas, \fBdpkg\fP ne les supprimera pas lui\-même et le +script \fIpostrm\fP du paquet devra s'en charger durant l'opération de +purge. Cela ne s'applique bien entendu qu'aux fichiers situés dans les +répertoires systèmes et non aux fichiers de configuration créés dans les +répertoires «\ home\ » des utilisateurs. + +La suppression d'un paquet comporte les étapes suivantes\ : +.br + +\fB1.\fP Supprime le paquet s'il n'est pas déjà supprimé. Voir \fB\-\-remove\fP pour +plus de détails sur la façon dont cela est fait. +.br + +\fB2.\fP Exécuter le script \fIpostrm\fP. +.br +.TP +\fB\-V\fP, \fB\-\-verify\fP \fInom\-du\-paquet\fP... +Vérifie l'intégrité du \fInom\-du\-paquet\fP ou de tous les paquets, si omis, en +comparant l'information des fichiers installés par un paquet avec +l'information des métadonnées des fichiers stockée dans la base de données +de \fBdpkg\fP (depuis dpkg\ 1.17.2). L'origine de l'information des métadonnées +des fichiers dans la base de données, ce sont les paquets binaires +eux\-mêmes. Ces métadonnées sont collectées au moment du dépaquetage des +paquets durant le processus d'installation. + +Actuellement la seule vérification fonctionnelle effectuée est une +comparaison des sommes de contrôle MD5 du contenu des fichier par rapport +aux valeurs stockées dans la base de données des fichiers. La vérification +n'a lieu que si la base de données contient les informations +nécessaires. Pour vérifier si des métadonnées manquent dans la base de +données, la commande \fB\-\-audit\fP peut être employée. + +On peut choisir le format de sortie avec l'option \fB\-\-verify\-format\fP, par +défaut c'est le format \fBrpm\fP, mais cela pourrait changer dans le futur, et +selon le format que les programmes analysant cette sortie de commande +pourraient explicitement attendre. +.TP +\fB\-C\fP, \fB\-\-audit\fP \fInom\-du\-paquet\fP... +Effectue une vérification du bon état et de consistance de la base de +données sur le \fInom\-du\-paquet\fP ou sur tous les paquets si omis +(vérification par paquet depuis dpkg\ 1.17.10). Par exemple, recherche les +paquets qui n'ont été que partiellement installés sur le système ou qui ont +des données de contrôle ou des fichiers manquants, incorrects ou +obsolètes. \fBdpkg\fP suggère une manière de les corriger. +.TP +\fB\-\-update\-avail\fP [\fIfichier\-Paquets\fP] +.TQ +\fB\-\-merge\-avail\fP [\fIfichier\-Paquets\fP] +Met à jour l'information de \fBdpkg\fP et de \fBdselect\fP sur les paquets +disponibles. L'action \fB\-\-merge\-avail\fP combine les informations anciennes +avec celles qui proviennent du fichier \fIfichier\-Packages\fP. L'action +\fB\-\-update\-avail\fP remplace les informations anciennes par celles qui +proviennent du fichier \fIfichier\-Packages\fP. Le fichier \fIfichier\-Packages\fP +distribué avec Debian est appelé simplement «\ \fIPackages\fP\ ». Si le paramètre +\fIfichier\-Packages\fP est manquant ou est nommé «\ \fB\-\fP\ », alors, il sera lu à +partir de l'entrée standard (depuis dpkg\ 1.17.7). \fBdpkg\fP garde son propre +enregistrement des paquets disponibles dans \fI%ADMINDIR%/available\fP. + +Une simple commande permettant de récupérer et mettre à jour le fichier +\fIavailable\fP est \fBdselect update\fP. Veuillez noter que ce fichier est à peu +près inutile si vous n'utilisez pas \fBdselect\fP mais une interface basée sur +APT. APT contient en effet son propre mécanisme pour suivre les paquets +disponibles. +.TP +\fB\-A\fP, \fB\-\-record\-avail\fP \fIfichier\-paquet\fP... +Met à jour l'information de \fBdpkg\fP et de \fBdselect\fP sur les paquets +disponibles avec les informations qui proviennent de \fIfichier\-paquet\fP. Si +l'option \fB\-\-recursive\fP ou \fB\-R\fP est utilisée, \fIfichier\-paquet\fP doit +indiquer un répertoire. +.TP +\fB\-\-forget\-old\-unavail\fP +Désormais \fBobsolète\fP et sans effet car \fBdpkg\fP oublie automatiquement les +paquets désinstallés qui ne sont pas disponibles depuis (dpkg\ 1.15.4), mais +seulement ceux qui ne contiennent pas d'informations pour l'utilisateur +comme les sélections de paquets. +.TP +\fB\-\-clear\-avail\fP +Efface les renseignements existants sur les paquets disponibles. +.TP +\fB\-\-get\-selections\fP [\fImotif\-de\-nom\-de\-paquet\fP...] +Obtient la liste des sélections de paquets et l'envoie sur la sortie +standard. Sans un motif, les paquets non installés (c'est\-à\-dire ceux qui +ont été précédemment purgés) ne seront pas affichés. +.TP +\fB\-\-set\-selections\fP +Modifie la liste des sélections des paquets en lisant un fichier sur +l'entrée standard. Le format de ce fichier doit être de la forme «\ \fIpaquet\fP +\fIétat\fP\ », où état vaut \fBinstall\fP, \fBhold\fP, \fBdeinstall\fP ou \fBpurge\fP. Les +lignes vides ou les lignes de commentaires débutant par «\ \fB#\fP\ » sont +autorisées. + +Le fichier \fIavailable\fP doit être à jour pour que cette commande soit utile, +autrement des paquets inconnus seront ignorés avec un +avertissement. Veuillez consultez les commandes \fB\-\-update\-avail\fP et +\fB\-\-merge\-avail\fP pour plus d'informations. +.TP +\fB\-\-clear\-selections\fP +Met l'état de chaque paquet non essentiel à «\ deinstall\ » (depuis +dpkg\ 1.13.18). Il faut utiliser cette option juste avant +\fB\-\-set\-selections\fP, pour désinstaller les paquets qui ne sont pas affichés +par \fB\-\-set\-selections\fP. +.TP +\fB\-\-yet\-to\-unpack\fP +Recherche les paquets qui ont été sélectionnés pour l'installation, mais +qui, pour une raison quelconque, ne sont pas encore installés. +.IP +Note\ : cette commande utilise à la fois le fichier disponible et les +sélections de paquets. +.TP +\fB\-\-predep\-package\fP +Affiche un fichier unique qui est la cible d'une ou plusieurs +pré\-dépendances correspondantes et n'a lui\-même pas de pré\-dépendances +insatisfaites. +.IP +Si un tel paquet est présent, l'affiche comme entrée du fichier Packages, et +il peut être manipulé comme il se doit. +.IP +Note\ : cette commande utilise à la fois le fichier disponible et les +sélections de paquets. +.IP +Renvoie \fB0\fP si un paquet est affiché, \fB1\fP quand il n'y a pas de paquet +adéquat disponible et \fB2\fP en cas d'erreur. +.TP +\fB\-\-add\-architecture \fP\fIarchitecture\fP +Ajoute \fIarchitecture\fP à la liste d'architectures pour lesquelles les +paquets peuvent être installés sans utiliser \fB\-\-force\-architecture\fP (depuis +dpkg\ 1.16.2). L'architecture pour laquelle \fBdpkg\fP est compilé (c'est\-à\-dire +ce qu'affiche \fB\-\-print\-architecture\fP) est toujours incluse dans cette +liste. +.TP +\fB\-\-remove\-architecture \fP\fIarchitecture\fP +Retire \fIarchitecture\fP de la liste d'architectures pour lesquelles les +paquets peuvent être installés sans utiliser \fB\-\-force\-architecture\fP (depuis +dpkg\ 1.16.2). Si cette architecture est actuellement utilisée dans la base +de données, cette opération sera rejetée, sauf si \fB\-\-force\-architecture\fP +est utilisé. L'architecture pour laquelle \fBdpkg\fP est compilé (c'est\-à\-dire +ce qu'affiche \fB\-\-print\-architecture\fP) ne peut jamais être retirée de cette +liste. +.TP +\fB\-\-print\-architecture\fP +Affiche l'architecture des paquets installés (par exemple, «\ i386\ »). +.TP +\fB\-\-print\-foreign\-architectures\fP +Affiche la liste, à raison d'une par ligne, des architectures +supplémentaires pour lesquelles \fBdpkg\fP est autorisé à installer des paquets +(depuis dpkg\ 1.16.2). +.TP +\fB\-\-assert=\fP\fIfonction\fP +Déclare que \fBdpkg\fP prend en charge la fonction requise. Renvoie \fB0\fP si la +fonction est complètement prise en charge, \fB1\fP si la fonction est reconnue +mais que \fBdpkg\fP ne peut pas encore fournir sa prise en charge, et \fB2\fP si +la fonction est inconnue. La liste actuelle des fonctions déclarables est\ : +.RS +.TP +\fBsupport\-predepends\fP +Gère le champ \fBPre\-Depends\fP (depuis\ dpkg\ 1.1.0). +.TP +\fBworking\-epoch\fP +Gère les «\ epochs\ » dans les chaînes de version (depuis dpkg\ 1.4.0.7). +.TP +\fBlongs\-noms\-de\-fichier\fP +Gère les longs noms de fichier dans les archives \fBdeb\fP(5) (depuis +dpkg\ 1.4.1.17). +.TP +\fBmulti\-conrep\fP +Gère plusieurs \fBConflicts\fP et \fBReplaces\fP (depuis dpkg\ 1.4.1.19). +.TP +\fBmulti\-arch\fP +Gère les champs et les sémantiques multi\-architectures (depuis dpkg\ 1.16.2). +.TP +\fBversioned\-provides\fP +Gère les \fBProvides\fP versionnés (depuis dpkg\ 1.17.11). +.RE +.TP +\fB\-\-validate\-\fP\fIchaîne\-quelque\-chose\fP +Valide que la \fIchaîne\fP \fIquelque\-chose\fP a une syntaxe correcte (depuis +dpkg\ 1.18.16). Renvoie \fB0\fP si la \fIchaîne\fP est valable, \fB1\fP si la +\fIchaîne\fP n'est pas valable mais pourrait être accepté dans des contextes +tolérants, et \fB2\fP si la chaîne n'est pas valable. La liste actuelle des +\fIquelque\-chose\fPs acceptables est\ : +.RS +.TP +\fBpkgname\fP +Valide le nom de paquet donné (depuis dpkg\ 1.18.16). +.TP +\fBtrigname\fP +Valide le nom d'action différée donné (depuis dpkg\ 1.18.16). +.TP +\fBarchname\fP +Valide le nom d'architecture donné (depuis dpkg\ 1.18.16). +.TP +\fBversion\fP +Valide la version donnée (depuis dpkg\ 1.18.16). +.RE +.TP +\fB\-\-compare\-versions \fP\fIver1 op ver2\fP +.\" .TP +.\" .B \-\-command\-fd \fIn\fP +.\" Accept a series of commands on input file descriptor \fIn\fP. Note: +.\" additional options set on the command line, and through this file descriptor, +.\" are not reset for subsequent commands executed during the same run. +Compare des numéros de version, où \fIop\fP est un opérateur binaire. \fBdpkg\fP +renvoie «\ true\ » (\fB0\fP) si la condition spécifiée est vérifiée, et renvoie +«\ false\ » (\fB1\fP) dans le cas contraire. Il y a deux groupes d'opérateurs\ ; +ils diffèrent par leur façon de traiter l'absence de \fIver1\fP ou de +\fIver2\fP. Pour les opérateurs suivants, \fBlt le eq ne ge gt\fP, l'absence d'une +version est considérée comme inférieure à toute version\ ; pour les +opérateurs \fBlt\-nl le\-nl ge\-nl gt\-nl\fP, l'absence d'une version est +considérée comme supérieure à toute version. Les opérateurs \fB< +<< <= = >= >> >\fP ne sont fournis que pour la +compatibilité avec la syntaxe du fichier de contrôle. Les opérateurs +\fB<\fP et \fB>\fP sont obsolètes et ne devraient \fBpas\fP être utilisés du +fait d'une sémantique pas claire. Comme illustration, \fB0.1< 0.1\fP est +évaluée à vrai. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche un court message d'aide. +.TP +\fB\-\-force\-help\fP +Donne des renseignements sur les options \fB\-\-force\-\fP\fIquelque\-chose\fP. +.TP +\fB\-Dh\fP, \fB\-\-debug=help\fP +Donne des renseignements sur les options de débogage. +.TP +\fB\-\-version\fP +Affiche la version de \fBdpkg\fP. +.TP +\fBdpkg\-deb actions\fP +Voyez \fBdpkg\-deb\fP(1) pour des renseignements supplémentaires sur les actions +suivantes. + +.nf +\fB\-b\fP, \fB\-\-build\fP \fIrépertoire\fP [\fIarchive\fP|\fIrépertoire\fP] + Construit un paquet deb. +\fB\-c\fP, \fB\-\-contents\fP \fIarchive\fP + Liste le contenu d'un paquet deb. +\fB\-e\fP, \fB\-\-control\fP \fIarchive\fP [\fIrépertoire\fP] + Extrait les informations de contrôle d'un paquet. +\fB\-x\fP, \fB\-\-extract\fP \fIarchive répertoire\fP + Extrait et affiche les fichiers contenus dans un paquet. +\fB\-X\fP, \fB\-\-vextract\fP \fIarchive répertoire\fP + Extrait et affiche les noms de fichiers contenus dans un + paquet. +\fB\-f\fP, \fB\-\-field\fP \fIarchive\fP [\fIchamp de contrôle\fP] ... + Affiche le(s) champ(s) de contrôle d'un paquet. +\fB\-\-ctrl\-tarfile\fP \fIarchive\fP + Produit le contenu du fichier tar de contrôle d'un paquet Debian. +\fB\-\-fsys\-tarfile\fP \fIarchive\fP + Produit le contenu du fichier tar du système de fichiers d'un + paquet Debian. +\fB\-I\fP, \fB\-\-info\fP \fIarchive\fP [\fIfichier de contrôle\fP] + Affiche des renseignements sur un paquet. +.fi + +.TP +\fBdpkg\-query actions\fP +Voyez \fBdpkg\-query\fP(1) pour davantage d'explications sur les actions +suivantes. + +.nf + +\fB\-l\fP, \fB\-\-list\fP \fImotif\-du\-nom\-de\-paquet\fP ... + Affiche la liste des paquets qui correspondent au motif. +\fB\-s\fP, \fB\-\-status\fP \fInom\-du\-paquet\fP ... + Donne l'état du paquet indiqué. +\fB\-L\fP, \fB\-\-listfiles\fP \fInom\-du\-paquet\fP ... + Affiche la liste des fichiers installés qui appartiennent + à \fIpaquet\fP. +\fB\-S\fP, \fB\-\-search\fP \fImotif\-du\-fichier\-à\-rechercher\fP ... + Recherche un fichier dans les paquets installés. +\fB\-p\fP, \fB\-\-print\-avail\fP \fInom\-du\-paquet\fP + Affiche les informations trouvées dans \fI%ADMINDIR%/available\fP + à propos de \fIpaquet\fP. Les utilisateurs des interfaces à APT + devraient plutôt utiliser \fBapt\-cache show\fP \fInom\-du\-paquet\fP. +.fi +. +.SH OPTIONS +On peut spécifier toutes les options à la fois sur la ligne de commande, +dans le fichier de configuration de \fBdpkg\fP, \fI%PKGCONFDIR%/dpkg.cfg\fP ou +dans les fragments de fichiers du répertoire de configuration +\fI%PKGCONFDIR%/dpkg.cfg.d/\fP (avec un nom qui respecte le motif +«\ [0\-9a\-zA\-Z_\-]*\ »). Chaque ligne de ce fichier est soit une option +(identique à une option en ligne de commande mais sans tirets initiaux), +soit un commentaire, commençant par «\ \fB#\fP\ ». +.br +.TP +\fB\-\-abort\-after=\fP\fInombre\fP +Modifie le nombre d'erreurs au delà duquel \fBdpkg\fP s'arrête. Il est par +défaut égal à 50. +.TP +\fB\-B\fP, \fB\-\-auto\-deconfigure\fP +Quand un paquet est supprimé, il peut arriver qu'un paquet installé +dépendait du paquet supprimé. En spécifiant cette option, on obtient la +déconfiguration automatique du paquet qui dépendait du paquet supprimé. +.TP +\fB\-D\fP\fIoctal\fP\fB, \-\-debug=\fP\fIoctal\fP +Demande de débogage. \fIoctal\fP est formé en faisant un «\ ou\ » logique entre +des valeurs souhaitées appartenant à la liste ci\-dessous (notez que ces +valeurs pourront changer dans les prochaines versions). \fB\-Dh\fP ou +\fB\-\-debug=help\fP affiche ces valeurs de débogage. + + nombre description + 1 Informations de progression + en général utiles + 2 Appel et état des scripts du responsable + 10 Affichage pour chaque fichier traité + 100 De nombreux affichages pour chaque fichier + traité + 20 Affichage pour chaque fichier de configuration + 200 De nombreux affichages pour chaque fichier + de configuration + 40 Dépendances et conflits + 400 De nombreuses sorties pour les dépendances + et les conflits +10000 Sortie sur l'activation et le traitement des actions différées +20000 De nombreuses sorties sur les actions différées +40000 Quantité stupide de sorties sur les actions différées + 1000 Beaucoup de radotage à propos, par exemple, du répertoire + dpkg/info + 2000 Quantité stupide de radotage +.TP +\fB\-\-force\-\fP\fIquelque\-chose\fP +.TQ +\fB\-\-no\-force\-\fP\fIquelque\-chose\fP, \fB\-\-refuse\-\fP\fIquelque\-chose\fP +Forcer ou refuser (\fBno\-force\fP et \fBrefuse\fP signifient la même chose) de +faire quelque chose. \fIquelque\-chose\fP est une liste d'actions séparées par +des virgules, décrites ci\-après. \fB\-\-force\-help\fP affiche un message qui les +décrit. Les actions marquées d'un (*) sont forcées par défaut. + +\fIAvertissement\ : ces options sont principalement destinées aux experts. Un +usage auquel manque la pleine compréhension de leurs effets peut casser le +système entier.\fP + +\fBall\fP\ : Met en œuvre (ou pas) toutes les options de forçage. + +\fBdowngrade\fP(*)\ : Installe un paquet, même si une version plus récente du +paquet est déjà installée. + +\fIAvertissement\ : pour l'instant,\fP \fBdpkg\fP \fIne recherche pas les +dépendances lors d'un retour à une version inférieure d'un paquet\ ; il ne +vous préviendra pas si la version choisie casse les dépendances d'un autre +paquet. Cela peut avoir de sérieuses conséquences\ ;\ et si l'on revient à des +versions antérieures des programmes essentiels du système, cela peut rendre +votre système inutilisable. N'utiliser qu'avec précaution.\fP + +\fBconfigure\-any\fP\ : configurer aussi les paquets dépaquetés mais non +configurés dont dépend le paquet en question. + +\fBhold\fP\ : traiter même les paquets marqués «\ à garder\ » («\ hold\ »). + +\fBremove\-reinstreq\fP\ : supprimer un paquet, même défectueux et marqué comme +demandant une réinstallation. Il se peut, dès lors, que des éléments du +paquet restent dans le système et soient oubliés par \fBdpkg\fP. + +\fBremove\-essential\fP\ : supprimer un paquet même s'il est considéré comme +indispensable. Les paquets «\ Essential\ » comportent les commandes Unix les +plus fondamentales et les enlever peut casser le système entier. Il faut +utiliser cette option avec prudence. + +\fBdepends\fP\ : changer tous les problèmes de dépendance en +avertissements. Cela affecte les champs \fBPre\-Depends\fP et \fBDepends\fP. + +\fBdepends\-version\fP\ : ignorer les versions dans les questions de +dépendance.Cela affecte les champs \fBPre\-Depends\fP et \fBDepends\fP. + +\fBbreaks\fP\ : forcer l'installation, même si cela risque de casser un autre +paquet (depuis dpkg\ 1.14.6). Cela affecte le champ \fBBreaks\fP. + +\fBconflicts\fP\ : installer un paquet, même s'il est en conflit avec un autre +paquet. C'est dangereux car habituellement cela produit le remplacement de +certains fichiers. Cela affecte le champ \fBConflicts\fP. + +\fBconfmiss\fP\ : toujours installer le fichier de configuration manquant sans +rien demander. Cette opération est dangereuse, puisque les changements +apportés au fichier ne seront pas préservés (suppression). + +\fBconfnew\fP\ : quand un fichier de configuration a été modifié et que la +version dans le paquet a changé, toujours installer la nouvelle version sans +rien demander, sauf si l'option \fB\-\-force\-confdef\fP est aussi présente, +auquel cas l'action par défaut est choisie. + +\fBconfold\fP\ : quand un fichier de configuration a été modifié et que la +version du paquet a changé, garder l'ancienne version sans rien demander, +sauf si l'option \fB\-\-force\-confdef\fP est aussi présente, auquel cas l'action +par défaut est choisie. + +\fBconfdef\fP\ : quand un fichier de configuration a été modifié et que la +version du paquet a changé, utilise toujours l'action par défaut, de manière +non interactive. Quand il n'y a pas d'action par défaut, la commande +s'arrête et interroge l'utilisateur, à moins que l'option \fB\-\-force\-confnew\fP +ou l'option \fB\-\-force\-confold\fP n'ait été donnée, auquel cas elle se sert de +ces options pour déterminer ce qu'il faut faire. + +\fBconfask\fP\ : si un fichier de configuration a été modifié, propose de le +remplacer avec la version du paquet, même si celle\-ci n'a pas changé (depuis +dpkg\ 1.15.8). Si l'une des options \fB\-\-force\-confmiss\fP, \fB\-\-force\-confnew\fP, +\fB\-\-force\-confold\fP, ou \fB\-\-force\-confdef\fP est également mentionnée, elle +déterminera l'action finalement utilisée. + +\fBoverwrite\fP\ : remplacer un fichier par un fichier d'un autre paquet. + +\fBoverwrite\-dir\fP\ : remplacer un répertoire d'un paquet par le fichier d'un +autre paquet. + +\fBoverwrite\-diverted\fP\ : remplacer un fichier détourné avec une version non +détournée. + +\fBstatoverride\-add\fP\ : remplacer une dérogation d'état existante lors de son +ajout (depuis dpkg\ 1.19.5) + +\fBstatoverride\-remove\fP\ : ignorer l'absence de dérogation d'état lors de sa +suppression (depuis dpkg\ 1.19.5). + +\fBsecurity\-mac\fP(*)\ : utiliser une sécurité basée sur le contrôle d'accès +obligatoire (Mandatory Access Controls –\ MAC) spécifique à la plateforme +lors de l'installation de fichiers dans le systèmes de fichiers (depuis +dpkg\ 1.19.5). Sur les systèmes Linux, la mise en œuvre utilise SELinux. + +\fBunsafe\-io\fP\ : ne pas effectuer d'action d'entrée/sortie non sûre lors de la +décompression (depuis dpkg\ 1.15.8.6). Cela implique actuellement de ne pas +synchroniser le système de fichiers avant le renommage de fichiers, ce qui +est une cause connue de dégradation des performances sur certains systèmes, +en général ceux qui, peu fiables, ont besoin d'actions sûres pour éviter de +terminer avec des fichiers de taille vide en cas d'interruption inopinée. + +\fINote\fP\ : pour ext4, le principal concerné, il est suggéré de plutôt +utiliser l'option de montage \fBnodelalloc\fP, qui corrigera à la fois la +dégradation des performances et les problèmes de sécurité des données. Elle +permet notamment d'éviter de terminer avec des fichiers vides lors des +arrêts brutaux pour tout logiciel qui ne synchronise pas le système de +fichiers avant chaque renommage. + +\fIAvertissement\ : l'utilisation de cette option peut améliorer la +performance mais augmente le risque de perte de données. Elle est donc à +utiliser avec précautions.\fP + +\fBscript\-chrootless\fP\ : exécuter les scripts du responsable sans créer de +\fBchroot\fP(2) dans \fBinstdir\fP même si le paquet ne gère pas ce mode +d'opération (depuis dpkg\ 1.18.5). + +\fIAvertissement\ : cela peut détruire le système hôte, utilisez avec des +précautions extrêmes.\fP + +\fBarchitecture\fP\ : traiter même les paquets sans architecture ou avec une +architecture incorrecte. + +\fBbad\-version\fP\ : traiter même les paquets dont la version est incorrecte +(depuis dpkg\ 1.16.1). + +\fBbad\-path\fP\ : programmes importants non visibles par la variable \fBPATH\fP, ce +qui va poser des problèmes. + +\fBnot\-root\fP\ : tenter de (dés)installer même sans être root. + +\fBbad\-verify\fP\ : installer un paquet même si la vérification de son +authenticité a échoué. + +.TP +\fB\-\-ignore\-depends\fP=\fIpaquet\fP,... +Ne tient pas compte de la vérification des dépendances pour les paquets +spécifiés (en fait, la vérification est faite mais on ne donne rien d'autre +que des avertissements). Cela affecte les champs \fBPre\-Depends\fP, \fBDepends\fP +et \fBBreaks\fP. +.TP +\fB\-\-no\-act\fP, \fB\-\-dry\-run\fP, \fB\-\-simulate\fP +Faire tout ce qui doit être fait, mais n'écrire aucune modification. On +utilise cette option pour voir ce qui se passe sans modifier quoi que ce +soit. + +Assurez\-vous de donner l'option \fB\-\-no\-act\fP avant le paramètre action, sinon +des résultats fâcheux sont probables. Par exemple, la commande \fBdpkg +\-\-purge foo \-\-no\-act\fP purge d'abord le paquet foo et essaie ensuite de +purger le paquet \-\-no\-act, même si vous comptiez qu'elle ne ferait rien du +tout. +.TP +\fB\-R\fP, \fB\-\-recursive\fP +Traite récursivement tous les simples fichiers qui correspondent au motif +\fB*.deb\fP et qui se trouvent dans les répertoires et sous\-répertoires +spécifiés. On peut utiliser cette option avec les actions \fB\-i\fP, \fB\-A\fP, +\fB\-\-install\fP, \fB\-\-unpack\fP et \fB\-\-record\-avail\fP. +.TP +\fB\-G\fP +Ne pas installer un paquet si une version plus récente de ce paquet est déjà +installée. C'est un alias pour \fB\-\-refuse\-downgrade\fP. +.TP +\fB\-\-admindir\fP=\fIrépertoire\fP +Fixe le répertoire d'administration à \fIrépertoire\fP. Ce répertoire contient +de nombreux fichiers donnant des informations au sujet de l'état des paquets +installés ou non,\ etc. (Le répertoire par défaut est \fI%ADMINDIR%\fP) +.TP +\fB\-\-instdir=\fP\fIrépertoire\fP +Fixe le répertoire d'installation qui indique où les paquets vont être +installés. \fBinstdir\fP est aussi le nom du répertoire indiqué à \fBchroot\fP(2) +avant que ne soient lancés les scripts d'installation, ce qui signifie que +ces scripts voient \fBinstdir\fP comme répertoire racine. Le répertoire par +défaut est «\ \fI/\fP\ ». +.TP +\fB\-\-root=\fP\fIrépertoire\fP +Fixe le répertoire racine à \fIrépertoire\fP ce qui fixe le répertoire +d'installation à «\ \fIrépertoire\fP\ » et le répertoire d'administration à +«\ \fIrépertoire\fP\fB%ADMINDIR%\fP\ ». +.TP +\fB\-O\fP, \fB\-\-selected\-only\fP +Traiter seulement les paquets qui sont sélectionnés pour l'installation. La +sélection est réellement faite par \fBdselect\fP ou par \fBdpkg\fP quand ils +manipulent les paquets. Par exemple, quand un paquet est supprimé, il est +marqué comme ayant été sélectionné pour une désinstallation. +.TP +\fB\-E\fP, \fB\-\-skip\-same\-version\fP +Ne pas installer le paquet si la même version du paquet est déjà installée. +.TP +\fB\-\-pre\-invoke=\fP\fIcommande\fP +.TQ +\fB\-\-post\-invoke=\fP\fIcommande\fP +Programme l'exécution de \fIcommande\fP à l'aide «\ sh \-c\ » avant ou après +l'exécution de \fBdpkg\fP pour les actions \fIunpack\fP, \fIconfigure\fP, \fIinstall\fP, +\fItriggers\-only\fP, \fIremove\fP, \fIpurge\fP, \fIadd\-architecture\fP et +\fIremove\-architecture\fP (depuis dpkg\ 1.15.4\ ; les actions \fIadd\-architecture\fP +et \fIremove\-architecture\fP depuis dpkg\ 1.17.19). Cette option peut être +utilisée plusieurs fois. L'ordre dans lequel les options multiples sont +indiquées sera préservé et celles indiquées dans le fichier de configuration +auront la priorité. La variable d'environnement \fBDPKG_HOOK_ACTION\fP est +utilisée pour indiquer aux scripts utilisés quelle est l'action actuelle de +\fBdpkg\fP. Note\ :\ les interfaces de \fBdpkg\fP peuvent l'appeler plusieurs fois à +chaque invocation, ce qui peut provoquer l'exécution des «\ hooks\ » plus +souvent que prévu. +.TP +\fB\-\-path\-exclude=\fP\fImotif\-global\fP +.TQ +\fB\-\-path\-include=\fP\fImotif\-global\fP +Utilise \fImotif\-global\fP comme filtre de chemins, soit en excluant, soit en +ré\-incluant des chemins précédemment exclus, correspondant au motif indiqué, +pendant l'installation (depuis dpkg\ 1.15.8). + +\fIAttention\ :\ dépendre des chemins exclus peut entièrement casser le +système. Ce réglage doit donc être utilisé avec précautions.\fP + +Les motifs globaux utilisent les mêmes caractères joker que le +shell\ où\ «\ *\ » correspond à une séquence quelconque de caractères, y compris +une chaîne vide ou le caractère «\ /\ ». Ainsi, «\ \fI/usr/*/READ*\fP\ » comportera +«\ \fI/usr/share/doc/package/README\fP\ ». Comme toujours, le caractère «\ ?\ » +correspond à un caractère quelconque (y compris «\ /\ »). Le caractère «\ [\ » +marque le début d'une classe de caractères, qui contient une liste de +caractères, séries de caractères ou compléments de séries. Veuillez +consulter \fBglob\fP(7) pour plus d'informations à propos des correspondances +globales. Note\ :\ l'implémentation actuelle pourrait ré\-inclure plus de +répertoires et liens symboliques que nécessaire, par souci de sécurité et +pour éviter des échecs possibles de décompression. Des modifications à venir +pourraient changer cela. + +Cela peut servir à exclure tous les chemins sauf certains spécifiques. Un +cas classique d'utilisation est\ : + +.nf +\fB\-\-path\-exclude=/usr/share/doc/*\fP +\fB\-\-path\-include=/usr/share/doc/*/copyright\fP +.fi + +qui permet de supprimer tous les fichiers de documentation sauf les fichiers +de «\ copyright\ ». + +Ces deux options peuvent être utilisées plusieurs fois et éventuellement +être alternées entre elles. Les deux sont traitées dans l'ordre indiqué\ :\ la +dernière règle correspondant à un fichier donné est alors celle qui sera +utilisée. + +Les filtres sont appliqués lors du dépaquetage des paquets binaires et, en +tant que tel, ont seulement connaissance du type des objets qui sont en +cours de filtrage (par exemple un fichier ordinaire ou un répertoire) et +n'ont pas de visibilité des objets à venir. Comme ces filtres ont des effets +secondaires (à la différence des filtres de \fBfind\fP(1)), l'exclusion d'un +chemin précis qui se trouve être un objet répertoire, comme +\fI/usr/share/doc\fP, n'aura pas le résultat désiré, et seul ce chemin sera +exclu (et qui pourrait être réintégré automatiquement si le code en voit la +nécessité).Le dépaquetage de tous les fichiers suivants renfermés par ce +répertoire échouera. + +Astuce\ : Assurez\-vous que les «\ globs\ » ne sont pas développés par le shell. +.TP +\fB\-\-verify\-format\fP\fI nom\-de\-format\fP +Définit le format de sortie de la commande \fB\-\-verify\fP (depuis dpkg\ 1.17.2). + +Le seul format de sortie géré actuellement est \fBrpm\fP, qui consiste en une +ligne par chemin dont la vérification a échoué. Les lignes débutent par +9\ caractères pour signaler les résultats d'une vérification spécifique, un +«\ \fB?\fP\ » implique que la vérification ne peut être réalisée (absence de +prise en charge, droit d'accès de fichier,\ etc), «\ \fB.\fP\ » implique que la +vérification est passée et un caractère alphanumérique implique qu'une +vérification spécifique a échoué\ ; l'échec de vérification md5sum est +identifiée par un «\ \fB5\fP\ » en troisième caractère. La ligne continue par une +espace et un caractère d'attribut (comme «\ \fBc\fP\ » pour conffiles –\ fichiers +de configuration), une autre espace et le nom de chemin. +.TP +\fB\-\-status\-fd \fP\fIn\fP +Envoie un état du paquet compréhensible par la machine et met à jour cette +information dans le descripteur de fichier \fIn\fP. Cette option peut être +spécifiée plusieurs fois. L'information est généralement constituée d'un +enregistrement par ligne, dans l'une des formes suivantes\ : +.RS +.TP +\fBstatus: \fP\fIpaquet\fP\fB: \fP\fIétat\fP +L'état du paquet a changé\ ; l'\fIétat\fP est tel que dans le fichier d'état +(\ «status file\ »). +.TP +\fBstatus: \fP\fIpaquet\fP\fB : error : \fP\fImessage\-d'erreur\-complet\fP +Une erreur s'est produite. Toutes les lignes supplémentaires éventuelles +dans \fImessage\-d'erreur\-complet\fP seront converties en espaces avant +affichage. +.TP +\fBstatus: \fP\fIfichier\fP\fB : conffile\-prompt : '\fP\fIreal\-old\fP\fB' '\fP\fIreal\-new\fP\fB' \fP\fIuseredited\fP\fB \fP\fIdistedited\fP +Une question pour un fichier de configuration va être posée à l'utilisateur. +.TP +\fBprocessing: \fP\fIphase\fP\fB: \fP\fIpaquet\fP +Envoyé juste avant le début du traitement d'une phase. Les \fIphases\fP sont +\fBupgrade\fP, \fBinstall\fP (les deux sont envoyés avant le dépaquetage), +\fBconfigure\fP, \fBtrigproc\fP, \fBdisappear\fP, \fBremove\fP, \fBpurge\fP. +.RE +.TP +\fB\-\-status\-logger\fP=\fIcommande\fP +Envoie un état du paquet compréhensible par la machine et met à jour +l'information de progression sur l'entrée standard du processeur de +commandes \fIcommand\fP, à exécuter avec «\ sh \-c\ » (depuis dpkg\ 1.16.0). Cette +option peut être spécifiée plusieurs fois. Le format d'affichage utilisé est +le même que celui de \fB\-\-status\-fd.\fP +.TP +\fB\-\-log=\fP\fIfichier\fP +Enregistre les mises à jour et actions des changements d'état dans +\fIfichier\fP plutôt que dans le \fI%LOGDIR%/dpkg.log\fP par défaut. Si l'option +est passée plusieurs fois, le dernier nom de fichier est utilisé. Les +messages du journal ont cette forme\ : +.RS +.TP +AAAA\-MM\-JJ HH:MM:SS \fBstartup\fP \fItype\fP \fIcommande\fP +Pour chaque invocation de dpkg où \fItype\fP est \fBarchives\fP (avec une +\fIcommande\fP \fBunpack\fP ou \fBinstall\fP) ou \fBpackages\fP (avec une \fIcommande\fP +\fBconfigure\fP, \fBtriggers\-only\fP, \fBremove\fP ou \fBpurge\fP). +.TP +AAAA\-MM\-JJ HH:MM:SS \fBstatus\fP \fIétat\fP \fIpaquet\fP \fIversion\-installée\fP +Pour les mises à jour des changements d'état. +.TP +AAAA\-MM\-JJ HH:MM:SS \fBaction\fP \fIpaquet\fP \fIversion\-installée\fP \fIversion\-disponible\fP +Pour les actions où \fIaction\fP est \fBinstall\fP, \fBupgrade\fP, \fBconfigure\fP, +\fBtrigproc\fP, \fBdisappear\fP, \fBremove\fP ou \fBpurge\fP. +.TP +AAAA\-MM\-JJ HH:MM:SS \fBconffile\fP \fIfichier\fP \fIdécision\fP +Pour les changements du fichier de configuration où \fIdécision\fP est +\fBinstall\fP ou \fBkeep\fP. +.RE +.TP +\fB\-\-no\-pager\fP +Désactive l'utilisation d'un afficheur pour montrer les informations (depuis +dpkg\ 1.19.2). +.TP +\fB\-\-no\-debsig\fP +Ne pas tenter de vérifier la signature des paquets. +.TP +\fB\-\-no\-triggers\fP +Durant ce traitement, ne pas lancer d'actions différées (depuis +dpkg\ 1.14.17), mais les activations seront toujours enregistrées. S'il est +utilisé avec \fB\-\-configure\fP \fIpaquet\fP ou \fB\-\-triggers\-only\fP \fIpaquet\fP alors +le postinst du paquet sera toujours exécuté même si seule l'exécution d'une +action différée est nécessaire. L'utilisation de cette option peut laisser +des paquets dans les mauvais états \fBtriggers\-awaited\fP et +\fBtriggers\-pending\fP. Cela peut être corrigé plus tard en exécutant \fBdpkg +\-\-configure \-\-pending\fP. +.TP +\fB\-\-triggers\fP +Annule un précédent \fB\-\-no\-triggers\fP (depuis dpkg\ 1.14.17). +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +L'action demandée s'est correctement déroulée. Ou bien une commande de +vérification ou de déclaration renvoie «\ true\ ». +.TP +\fB1\fP +Une commande de vérification ou de déclaration renvoie «\ false\ ». +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande +non valable, ou interactions avec le système, telles que des accès à la base +de données, des allocations de mémoire,\ etc. +. +.SH ENVIRONNEMENT +.SS "Environnement externe" +.TP +\fBPATH\fP +Cette variable devrait être définie dans l'environnement et pointer vers les +chemins du système où plusieurs programmes requis devraient se trouver. Si +la variable n'est pas définie ou si les programmes ne sont pas trouvés, +\fBdpkg\fP s'arrête. +.TP +\fBHOME\fP +Si cette option est utilisée, \fBdpkg\fP utilisera le répertoire indiqué pour +lire le fichier de configuration propre à l'utilisateur. +.TP +\fBTMPDIR\fP +Si cette option est utilisée, \fBdpkg\fP utilisera le répertoire indiqué pour +créer les fichiers et répertoires temporaires. +.TP +\fBSHELL\fP +Le programme exécuté par \fBdpkg\fP quand il lance un nouvel interpréteur de +commandes interactif ou lance une commande avec le shell. +.TP +\fBPAGER\fP +.TQ +\fBDPKG_PAGER\fP +Le programme exécuté par \fBdpkg\fP quand il utilise un afficheur, par exemple +lorsqu'il affiche des différences de fichiers de configuration. Si \fBSHELL\fP +n'est pas défini, \fBsh\fP sera utilisé à la place. Le \fBDPKG_PAGER\fP se +substitue à la variable d'environnement \fBPAGER\fP (depuis dpkg\ 1.19.2). +.TP +\fBDPKG_COLORS\fP +Définit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement +acceptées sont \fBauto\fP (par défaut), \fBalways\fP et \fBnever\fP. +.TP +\fBDPKG_FORCE\fP +Définit les drapeaux de forçage (depuis dpkg\ 1.19.5). Quand cette variable +est présente, aucune des options internes de forçage par défaut ne sera +appliquée. Si la variable est présente mais vide, tous les drapeaux de +forçage seront désactivés. +.TP +\fBDPKG_FRONTEND_LOCKED\fP +Définie par une interface de gestion de paquets pour notifier à dpkg qu'il +ne devrait pas obtenir le verrou d'interface (dpkg\ 1.19.1). +.SS "Environnement interne" +.TP +\fBLESS\fP +Définie par \fBdpkg\fP à «\ \fB\-FRSXMQ\fP\ », si ce n'est pas déjà configuré, lors +du lancement d'un afficheur (depuis dpkg\ 1.19.2). Pour modifier le +comportement par défaut, cette variable peut être configurée à une autre +valeur y compris une chaîne vide\ ; alternativement, les variables \fBPAGER\fP +ou \fBDPKG_PAGER\fP peuvent être réglées pour désactiver des options +particulières avec «\fB\-+\fP», par exemple \fBDPKG_PAGER="less \-+F"\fP. +.TP +\fBDPKG_ROOT\fP +Définie par \fBdpkg\fP dans l'environnement du script du responsable pour +indiquer quelle installation activer (depuis dpkg\ 1.18.5). La valeur est +destinée à être ajoutée avant n'importe quel chemin sur lequel les scripts +du responsable agissent. Pendant une opération normale, cette variable est +vide. Lors de l'installation de paquets dans un \fBinstdir\fP différent, +\fBdpkg\fP invoque normalement les scripts du responsable avec \fBchroot\fP(2) et +laisse cette variable vide, mais si \fB\-\-force\-script\-chrootless\fP est +indiqué, alors, l'appel de \fBchroot\fP(2) est ignoré et \fBinstdir\fP n'est pas +vide. +.TP +\fBDPKG_ADMINDIR\fP +Définie par \fBdpkg\fP dans l'environnement du script du responsable, pour +indiquer le répertoire d'administration à utiliser (depuis +dpkg\ 1.16.0). Cette variable est toujours fixée à la valeur actuelle de +\fB\-\-admindir\fP. +.TP +\fBDPKG_FORCE\fP +Définie par \fBdpkg\fP dans l'environnement du sous\-processus pour tous les +noms d'options de forçage actuellement activées séparés par des virgules +(depuis\ dpkg\ 1.19.5). +.TP +\fBDPKG_SHELL_REASON\fP +Cette variable est définie pour le shell lancé par \fBdpkg\fP lorsqu'il lui est +demandé d'analyser la situation lors du traitement des fichiers de +configuration (depuis dpkg\ 1.15.6). La valeur actuellement valable est\ : +\fBconffile\-prompt\fP. +.TP +\fBDPKG_CONFFILE_OLD\fP +Cette variable est définie pour le shell lancé par \fBdpkg\fP lorsqu'il lui est +demandé d'analyser la situation lors du traitement des fichiers de +configuration (depuis dpkg\ 1.15.6). Elle contient le nom de l'ancien fichier +de configuration. +.TP +\fBDPKG_CONFFILE_NEW\fP +Cette variable est définie pour le shell lancé par \fBdpkg\fP lorsqu'il lui est +demandé d'analyser la situation lors du traitement des fichiers de +configuration (depuis dpkg\ 1.15.6). Elle contient le nom du nouveau fichier +de configuration. +.TP +\fBDPKG_HOOK_ACTION\fP +Cette variable est définie par \fBdpkg\fP pour le shell lancé lors de +l'exécution d'une action de point d'entrée (depuis dpkg\ 1.15.4). Elle +contient l'action actuelle de \fBdpkg\fP. +.TP +\fBDPKG_RUNNING_VERSION\fP +Cette variable est définie par \fBdpkg\fP dans l'environnement du script du +responsable. Elle contient la version de l'instance de \fBdpkg\fP en cours +d'exécution (depuis dpkg\ 1.14.17). +.TP +\fBDPKG_MAINTSCRIPT_PACKAGE\fP +Définie par \fBdpkg\fP dans l'environnement du script du responsable, cette +variable contient le nom du paquet (sans qualification d'architecture) en +cours de traitement (depuis dpkg\ 1.14.17). +.TP +\fBDPKG_MAINTSCRIPT_PACKAGE_REFCOUNT\fP +Définie par \fBdpkg\fP dans l'environnement du script du responsable, cette +variable contient le compte de référence du paquet, c'est\-à\-dire le nombre +d'instances de paquet avec un état plus élevé que \fBnot\-installed\fP (depuis +dpkg\ 1.17.2). +.TP +\fBDPKG_MAINTSCRIPT_ARCH\fP +Définie par \fBdpkg\fP dans l'environnement du script du responsable, cette +variable contient l'architecture pour laquelle le paquet a été construit +(depuis dpkg\ 1.15.4). +.TP +\fBDPKG_MAINTSCRIPT_NAME\fP +Définie par \fBdpkg\fP dans l'environnement du script du responsable, cette +variable contient le nom du script en cours d'exécution, \fBpreinst\fP, +\fBpostinst\fP, \fBprerm\fP ou \fBpostrm\fP (depuis dpkg\ 1.15.7). +.TP +\fBDPKG_MAINTSCRIPT_DEBUG\fP +Cette variable est définie par \fBdpkg\fP dans l'environnement du script du +responsable à une valeur («\ \fB0\fP\ » ou «\ \fB1\fP\ » notant si le débogage a été +demandé (avec l'option \fB\-\-debug\fP) pour les scripts du responsable (depuis +dpkg\ 1.18.4). +. +.SH FICHIERS +.TP +\fI%PKGCONFDIR%/dpkg.cfg.d/[0\-9a\-zA\-Z_\-]*\fP +Fragments de fichiers de configuration (depuis dpkg\ 1.15.4). +.TP +\fI%PKGCONFDIR%/dpkg.cfg\fP +Fichier de configuration contenant les options par défaut. +.TP +\fI%LOGDIR%/dpkg.log\fP +Fichier journal standard. Voyez \fI%PKGCONFDIR%/dpkg.cfg\fP et l'option +\fB\-\-log\fP. +.P +Les autres fichiers répertoriés ici sont dans leur répertoire par défaut, +voyez l'option \fB\-\-admindir\fP pour savoir comment changer l'emplacement de +ces fichiers. +.TP +\fI%ADMINDIR%/available\fP +Liste des paquets disponibles. +.TP +\fI%ADMINDIR%/status\fP +États des paquets disponibles. Ce fichier contient des informations qui +permettent de savoir si un paquet est marqué comme devant être supprimé ou +pas, devant être installé ou pas,\ etc. Voyez la section \fBRENSEIGNEMENTS SUR +LES PAQUETS\fP pour des informations supplémentaires. + +Le fichier d'état est sauvegardé quotidiennement dans \fI/var/backups\fP. Cela +peut être utile en cas de perte ou de corruption due à des problèmes de +système de fichiers. +.P +Le format et le contenu d'un paquet binaire sont décrits dans \fBdeb\fP(5). +. +.SH BOGUES +L'option \fB\-\-no\-act\fP ne donne pas assez d'informations utiles. +. +.SH EXEMPLES +Affichage des paquets installés liés à l'éditeur \fBvi\fP(1) (noter que +\fBdpkg\-query\fP ne charge plus le fichier \fIavailable\fP par défaut, sauf si +l'option \fBdpkg\-query\fP \fB\-\-load\-avail\fP est utilisée)\ : +.br + \fBdpkg \-l '*vi*'\fP +.br + +Pour voir les entrées de \fI%ADMINDIR%/available\fP concernant deux paquets\ : +.br + \fBdpkg \-\-print\-avail elvis vim | less\fP +.br + +Pour rechercher vous\-même dans la liste des paquets\ : +.br + \fBless %ADMINDIR%/available\fP +.br + +Pour supprimer le paquet installé elvis\ : +.br + \fBdpkg \-r elvis\fP +.br + +Pour installer un paquet, vous devez d'abord le trouver dans une archive ou +sur un CD. Le fichier \fIavailable\fP montre que le paquet vim se trouve dans +la section «\ \fBeditors\fP\ »\ : +.br + \fBcd /media/cdrom/pool/main/v/vim\fP + \fBdpkg \-i vim_4.5\-3.deb\fP +.br + +Pour faire une copie locale des états de sélection des paquets\ : +.br + \fBdpkg \-\-get\-selections >mes\-sélections\fP +.br + +Vous pourriez transférer ce fichier sur un autre ordinateur, et après avoir +mis à jour le fichier \fIavailable\fP avec l'interface de gestion de paquets de +votre choix (voir https://wiki.debian.org/Teams/Dpkg/FAQ pour plus de +détails), par exemple\ : +.br + \fBapt\-cache dumpavail | dpkg \-\-merge\-avail\fP +.br +ou avec dpkg\ 1.17.6 et les versions antérieures\ : +.br + \fBavail=`mktemp`\fP + \fBapt\-cache dumpavail >"$avail"\fP + \fBdpkg \-\-merge\-avail "$avail"\fP + \fBrm "$avail"\fP +.br +vous pouvez l'installer de cette manière\ : +.br + \fBdpkg \-\-clear\-selections\fP + \fBdpkg \-\-set\-selections <mes\-sélections\fP +.br + +On remarquera que cela n'installe ou ne supprime rien du tout\ ; cela ne fait +qu'enregistrer l'état souhaité des paquets. Vous aurez besoin d'autres +applications pour récupérer et installer réellement les paquets requis. Par +exemple, exécuter \fBapt\-get dselect\-upgrade\fP. + +Habituellement, vous trouverez que \fBdselect\fP(1) fournit une façon plus +aisée de modifier les états de sélection des paquets. +.br +. +.SH "FONCTIONNALITÉS SUPPLÉMENTAIRES" +D'autres possibilités sont offertes en installant les paquets suivants\ : +\fBapt\fP, \fBaptitude\fP et \fBdebsums\fP. +. +.SH "VOIR AUSSI" +.ad l +\fBaptitude\fP(1), \fBapt\fP(1), \fBdselect\fP(1), \fBdpkg\-deb\fP(1), \fBdpkg\-query\fP(1), +\fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg.cfg\fP(5) et \fBdpkg\-reconfigure\fP(8). +. +.SH AUTEURS +Consultez \fI%PKGDOCDIR%/THANKS\fP pour la liste de ceux qui ont contribué à +\fBdpkg\fP. +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dsc.man b/man/fr/dsc.man new file mode 100644 index 0000000..2262990 --- /dev/null +++ b/man/fr/dsc.man @@ -0,0 +1,254 @@ +.\" dpkg manual page - dsc(5) +.\" +.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> +.\" Copyright © 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dsc 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dsc \- Format du fichier de contrôle dans les paquets source Debian +. +.SH SYNOPSIS +\fInom\-du\-fichier\fP\fB.dsc\fP +. +.SH DESCRIPTION +Chaque paquet Debian possède un fichier de contrôle .dsc qui contient un +certain nombre de champs. Chaque champ commence par une étiquette, telle que +\fBSource\fP ou \fBBinary\fP (la casse n'importe pas), suivie d'un «\ :\ », et du +contenu du champ. Les champs sont séparés seulement par des étiquettes de +champ. En d'autres termes, le contenu d'un champ peut s'étendre sur +plusieurs lignes, mais les outils d'installation joindront en général les +lignes pendant le traitement du contenu du champ (sauf pour les champs à +lignes multiples \fBPackage\-List\fP, \fBFiles\fP, \fBChecksums\-Sha1\fP et +\fBChecksums\-Sha256\fP, voir ci\-dessous). +.PP +Les données de contrôle pourraient être incluses dans une signature OpenPGP +«\ ASCII Armored\ », comme spécifié dans RFC4880. +. +.SH "LES CHAMPS" +.TP +\fBFormat:\fP \fIversion\-format\fP (requis) +La valeur de ce champ déclare la version du format du paquet source. La +valeur du champ est utilisée par les programmes qui agissent sur un paquet +source pour interpréter la liste des fichiers du paquet source et déterminer +comment le dépaqueter. La syntaxe de la valeur du champ est un numéro de +révision majeure («\ 0\-9\ »), un point («\ .\ »), un numéro de révision mineure, +puis un sous\-type facultatif après une espace («\ \ \ ») qui, lorsqu'il est +présent, est un mot en caractères alphanumériques («\ a\-z0\-9\ »), en +minuscules entre parenthèses («\ ()\ ». Le sous\-type est facultatif dans la +syntaxe, mais peut être obligatoire pour certaines révisions particulières +du format source. + +Les formats source actuellement pris en charge par \fBdpkg\fP sont \fB1.0\fP, +\fB2.0\fP, \fB3.0 (native)\fP, \fB3.0 (quilt)\fP, \fB3.0 (git)\fP, \fB3.0 (bzr)\fP et \fB3.0 +(custom)\fP. Voir \fBdpkg\-source\fP(1) pour leur description. +.TP +\fBSource:\fP \fInom\-source\fP (requis) +La valeur de ce champ donne le nom du paquet, et la plupart des outils +d'installation s'en servent pour produire les noms des paquets. +.TP +\fBBinary:\fP \fIliste\-de\-paquets\-binaires\fP +Ce champ coupé liste des paquets binaires que ce paquet source peut produire +séparés par des virgules. + +Ce champ a maintenant été remplacé par le champ \fBPackage\-List\fP qui donne +suffisamment d'informations sur quels paquets binaires sont produits sur +quelle architecture, quel profil de construction et autres restrictions +actives. +.TP +\fBArchitecture:\fP \fIliste\-architectures\fP (recommandé) +Une liste d'architectures et de jokers d'architecture séparés par des +espaces qui précisent le type de matériel pour lequel ce paquet peut être +compilé. Les noms et les jokers d'architecture courants sont \fBamd64\fP, +\fBarmel\fP, \fBi386\fP, \fBlinux\-any\fP, \fBany\-amd64\fP,\ etc. + +Notez que la valeur \fBall\fP est destinée aux paquets indépendants de +l'architecture et \fBany\fP à ceux qui sont dépendants d'une architecture. La +liste peut comprendre (ou consister uniquement de) la valeur spéciale +\fBall\fP. Quand la liste comprend le joker d'architecture \fBany\fP, la seule +autre valeur permise dans la liste est \fBall\fP. + +La valeur du champ est en général générée par les champs \fBArchitecture\fP du +fichier \fIdebian/control\fP du paquet source. +.TP +\fBVersion:\fP \fIchaîne\-de\-la\-version\fP (requis) +C'est classiquement le numéro de version du paquet d'origine dans la forme +choisie par l'auteur du programme. Il peut y avoir aussi un numéro de +révision Debian (pour les paquets non natifs). Le format exact et +l'algorithme de tri sont décrits dans \fBdeb\-version\fP(7). +.TP +\fBOrigin:\fP\fI nom\fP +Nom de la distribution dont ce paquet provient. +.TP +\fBMaintainer:\fP \fInom\-complet\-et\-adresse\-électronique\fP (recommandé) +Le format de ce champ sera «\ Jean Dupont <jdupont@foo.com>\ »\ ; et +c'est bien sûr le créateur du paquet, par opposition à l'auteur du programme +mis en paquet. +.TP +\fBUploaders:\fP \fIliste\-de\-noms\-complets\-et\-adresses\-électroniques\fP +Affiche les noms et les adresses électroniques des co\-responsables du +paquet, au même format que le champ \fBMaintainer\fP. Des co\-responsables +multiples peuvent être séparés par des virgules. +.TP +\fBDescription\fP \fIdescription\-courte\fP +.TQ +\fB \fP\fIdescription\-longue\fP +Le format de la description du paquet est un résumé bref sur la première +ligne (après le champ \fBDescription\fP). Les lignes suivantes peuvent servir à +une description plus longue et plus détaillée. Chaque ligne de cette +description longue doit être précédée d'une espace\ ; quand c'est une ligne +blanche, elle doit contenir un seul «\ \fB.\fP\ » après cette espace. +.TP +\fBHomepage:\fP\fI URL\fP +\fIURL\fP de la page d'accueil du projet amont. +.TP +\fBStandards\-Version:\fP \fIchaîne\-de\-la\-version\fP (recommandé) +Ce champ indique la version la plus récente des normes de la charte de la +distribution auxquelles ce paquet se conforme. +.TP +\fBVcs\-Browser:\fP\fI URL\fP +Indique l'\fIURL\fP de l'interface web permettant de parcourir le dépôt du +système de gestion de versions. +.TP +\fBVcs\-Arch:\fP\fI URL\fP +.TQ +\fBVcs\-Bzr:\fP\fI URL\fP +.TQ +\fBVcs\-Cvs:\fP\fI URL\fP +.TQ +\fBVcs\-Darcs:\fP\fI URL\fP +.TQ +\fBVcs\-Git:\fP\fI URL\fP +.TQ +\fBVcs\-Hg:\fP\fI URL\fP +.TQ +\fBVcs\-Mtn:\fP\fI URL\fP +.TQ +\fBVcs\-Svn:\fP\fI URL\fP +Ces champs indiquent l'\fIURL\fP du dépôt du système de gestion de versions +utilisé pour la gestion du paquet. Voir \fBdeb\-src\-control\fP(5) pour plus de +détails. +.TP +\fBTestsuite:\fP\fI liste\-de\-noms\fP +Ce champ indique que le paquet source contient les suites de tests +spécifiées. La valeur est une liste des suites de tests séparées par des +virgules. Si la valeur \fBautopkgtest\fP est présente, un fichier +\fIdebian/tests/control\fP devrait être présent, et si la fichier est présent +mais pas la valeur, alors \fBdpkg\-source\fP l'ajoutera automatiquement, en +conservant les valeurs précédentes. +.TP +\fBTestsuite\-Triggers:\fP\fI liste\-de\-paquets\fP +Ce champ indique l'union de toutes les dépendances de test, séparées par des +virgules (champs \fBDepends\fP du fichier \fIdebian/tests/control\fP), toutes +restrictions supprimées, et les dépendances OR mises à plat (c'est\-à\-dire +convertie en relations AND distinctes), sauf pour les binaires générés par +ce paquet source et son équivalent de méta\-dépendance \fB@\fP. + +Raison\ : ce champ est nécessaire parce qu'autrement chaque paquet source +devrait être dépaqueté pour pouvoir obtenir les dépendances de test. +.TP +\fBBuild\-Depends:\fP\fI liste\-de\-paquets\fP +.TQ +\fBBuild\-Depends\-Arch:\fP\fIliste\-de\-paquets\fP +.TQ +\fBBuild\-Depends\-Indep:\fP\fI liste\-de\-paquets\fP +.TQ +\fBBuild\-Conflicts:\fP\fI liste de paquets\fP +.TQ +\fBBuild\-Conflicts\-Arch:\fP\fI liste\-de\-paquets\fP +.TQ +\fBBuild\-Conflicts\-Indep:\fP\fI liste\-de\-paquets\fP +Ces champs indiquent les relations entre le paquet source et les paquets +utilisés pour le construire. Ils sont détaillés dans la page de manuel +\fBdeb\-src\-control\fP(5). +.TP +\fBPackage\-List:\fP +.TQ +\fIpaquet\fP \fItype\-de\-paquet\fP \fIsection\fP \fIpriorité\fP \fIliste\-clés\-valeurs\fP +Ce champ à lignes multiples contient une liste des paquets binaires générés +par le paquet source. + +Le \fIpaquet\fP est le nom du paquet binaire. + +Le \fItype\-de\-paquet\fP est le type du paquet binaire, habituellement \fBdeb\fP\ ; +une autre valeur commune est \fBudeb\fP. + +La \fIsection\fP et la \fIpriorité\fP correspondent aux champs du même nom du +paquet binaire. + +La \fIliste\-clés\-valeurs\fP est une liste de \fIclés\fP\fB=\fP\fIvaleurs\fP séparées par +des valeurs et les clés optionnelles actuellement reconnues sont\ : + +.RS +.TP +\fBarch\fP +Les restrictions d'architecture à partir du champ \fBArchitecture\fP du paquet +binaire avec les espaces converties en «\ ,\ ». +.TP +\fBprofile\fP +La formule normalisée de restrictions de profil de construction à partir du +champ \fBBuild\-Profile\fP du paquet binaire avec les OR convertis en «\ +\ » et +les «\ AND\ » en «\ ,\ ». +.TP +\fBessential\fP +Si le paquet binaire est essentiel, cette clé contiendra la valeur du champ +\fBEssential\fP, qui est la valeur \fByes\fP. +.RE +.TP +\fBFiles:\fP (requis) +.TQ +\fBChecksums\-Sha1:\fP (requis) +.TQ +\fBChecksums\-Sha256:\fP (requis) +.TQ +\fIsomme\-de\-contrôle\fP \fItaille\fP \fInom\-du\-fichier\fP +Ces champs à lignes multiples contiennent une liste de fichiers avec une +somme de contrôle et une taille pour chacun. Ces champs ont la même syntaxe +et diffèrent seulement par l'algorithme de somme de contrôle employé\ : MD5 +pour \fBFiles\fP, SHA\-1 pour \fBChecksums\-Sha1\fP et SHA\-256 pour +\fBChecksums\-Sha256\fP. + +La première ligne de la valeur du champ (la partie sur la même ligne que le +nom du champ suivi par deux\-points) est toujours vide. Le contenu du champ +est exprimé sous la forme de lignes de continuation, un ligne par +fichier. Chaque ligne consiste en la somme de contrôle, une espace, la +taille du fichier, une espace et le nom du fichier. + +Ces champs listent tous les fichiers qui composent le paquet source. La +liste de fichiers de ces champs doit correspondre à celle présente dans les +autres champs relatifs. +. +.\" .SH EXAMPLE +.\" .RS +.\" .nf +.\" .fi +.\" .RE +. +.SH BOGUES +Le champ \fBFormat\fP combine le format pour le fichier \fB.dsc\fP lui\-même et le +format du paquet source extrait. +.SH "VOIR AUSSI" +\fBdeb\-src\-control\fP(5), \fBdeb\-version\fP(7), \fBdpkg\-source\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dselect.cfg.man b/man/fr/dselect.cfg.man new file mode 100644 index 0000000..4b529b3 --- /dev/null +++ b/man/fr/dselect.cfg.man @@ -0,0 +1,49 @@ +.\" dselect manual page - dselect.cfg(5) +.\" +.\" Copyright © 2002 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2009-2011, 2013, 2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dselect.cfg 5 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dselect.cfg \- Fichier de configuration de dselect +. +.SH DESCRIPTION +Ce fichier liste les options appliquées par défaut à dselect. Chaque ligne +contient une seule option, écrite exactement comme sur la ligne de commande +mais sans les tirets initiaux, inutilisés. Les guillemets placés autour des +options sont supprimés. Les commentaires sont autorisés en faisant commencer +la ligne par un caractère croisillon \fB#\fP. +. +.SH FICHIERS +\fI%PKGCONFDIR%/dselect.cfg.d/[0\-9a\-zA\-Z_\-]*\fP +.br +\fI%PKGCONFDIR%/dselect.cfg\fP +.br +\fI~/.dselect.cfg\fP +. +.SH "VOIR AUSSI" +\fBdselect\fP(1). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/dselect.man b/man/fr/dselect.man new file mode 100644 index 0000000..3591def --- /dev/null +++ b/man/fr/dselect.man @@ -0,0 +1,483 @@ +.\" dselect manual page - dselect(1) +.\" +.\" Copyright © 1995 Juho Vuori <javuori@cc.helsinki.fi> +.\" Copyright © 2000 Josip Rodin +.\" Copyright © 2001 Joost Kooij +.\" Copyright © 2001 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2010-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dselect 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +dselect \- Interface de gestion de paquets Debian. +. +.SH SYNOPSIS +\fBdselect\fP [\fIoption\fP...] [\fIcommande\fP...] +. +.SH DESCRIPTION +\fBdselect\fP est une des principales interfaces de gestion des paquets sur un système Debian. À partir du menu principal de \fBdselect\fP, l'administrateur système peut\ : + \- Mettre à jour la liste des versions des paquets disponibles, + \- Voir l'état des paquets installés ou disponibles, + \- Modifier les sélections de paquets et gérer les dépendances, + \- Installer de nouveaux paquets ou mettre à niveau vers de nouvelles versions. +.PP +\fBdselect\fP est une interface au dessus de \fBdpkg\fP(1), l'outil bas niveau de +gestion des paquets Debian. Il propose à l'écran un gestionnaire de +sélections de paquets avec la possibilité de résoudre les conflits et +dépendances. Exécuté avec les droits administrateur, il permet d'installer +des paquets, les mettre à jour ou les retirer. Plusieurs méthodes d'accès +peuvent être configurées pour récupérer les informations sur les versions +des paquets disponibles et les paquets eux\-mêmes dans les dépôts de +paquets. Suivant la méthode d'accès utilisée, ces dépôts peuvent être des +serveurs d'archives publics sur Internet, des serveurs locaux ou des +CDROM. La méthode d'accès recommandée est \fIapt\fP, qui est fournie par le +paquet \fBapt\fP. +.PP +Normalement, \fBdselect\fP est appelé sans paramètre. Un menu interactif est +présenté, offrant à l'utilisateur une liste de commandes. Si une commande +est donnée en paramètre, alors cette commande est démarrée +immédiatement. Plusieurs paramètres en ligne de commande sont disponibles +pour modifier le comportement de \fBdselect\fP ou pour montrer des informations +supplémentaires sur le programme. +. +.SH OPTIONS +On peut spécifier une option à la fois sur la ligne de commande et dans le +fichier de configuration de \fBdselect\fP, \fI%PKGCONFDIR%/dselect.cfg\fP ou dans +les fichiers du répertoire de configuration +\fI%PKGCONFDIR%/dselect.cfg.d/\fP. Chaque ligne de ce fichier est soit une +option (identique à une option en ligne de commande mais sans tiret), soit +un commentaire (si il commence par «\ \fB#\fP\ »). +.br +.TP +\fB\-\-admindir\fP\fI répertoire\fP +Change le répertoire où les fichiers «\ \fIstatus\fP\ », «\ \fIavailable\fP\ » et +autres sont situés. Le répertoire par défaut est \fI%ADMINDIR%\fP et il ne +devrait pas y avoir besoin de le modifier. +.TP +\fB\-D\fP\fIfichier\fP, \fB\-\-debug\fP \fIfichier\fP +Activer le débogage. Les informations de débogage sont envoyées dans +\fIfichier\fP. +.TP +\fB\-\-expert\fP +Activer le mode expert, c'est\-à\-dire ne pas afficher les messages d'aide +ennuyeux. +.TP +\fB\-\-colour\fP|\fB\-\-color\fP \fIpartie_écran:\fP[\fIpremier_plan\fP],[\fIarrière_plan\fP][\fI:attr\fP[\fI+attr\fP]...] +Configure les couleurs des écrans. Cela ne fonctionne que si votre terminal +gère les couleurs. Cette option peut\-être utilisée plusieurs fois (et il est +préférable de l'utiliser dans \fIdselect.cfg\fP). Chaque utilisation change la +couleur (et, en option, d'autres attributs) d'une partie de l'écran. Les +parties de l'écran (de haut en bas) sont\ : +.RS +.TP +\fBtitle\fP +Le titre de l'écran. +.TP +\fBlisthead\fP +La ligne d'en\-tête au dessus de la liste de paquets. +.TP +\fBlist\fP +La liste déroulante de paquets (et de textes explicatifs). +.TP +\fBlistsel\fP +L'élément sélectionné dans la liste. +.TP +\fBpkgstate\fP +Dans la liste des paquets, le texte qui indique l'état actuel de chaque +paquet. +.TP +\fBpkgstatesel\fP +Dans la liste des paquets, le texte qui indique l'état actuel du paquet +sélectionné. +.TP +\fBinfohead\fP +La ligne d'en\-tête qui affiche l'état du paquet sélectionné. +.TP +\fBinfodesc\fP +La description courte du paquet. +.TP +\fBinfo\fP +Utilisé pour afficher les informations sur le paquet, comme par exemple la +description du paquet. +.TP +\fBinfofoot\fP +La dernière ligne de l'écran lors de la sélection des paquets. +.TP +\fBquery\fP +Utilisé pour les lignes des recherches. +.TP +\fBhelpscreen\fP +La couleur des écrans d'aide. +.RE +.IP +Après la partie de l'écran concernée, vient un signe deux\-points et la +spécification des couleurs. Pour surcharger les valeurs des couleurs +compilées, vous pouvez indiquer la couleur du premier plan, de +l'arrière\-plan, ou les deux. Utilisez les noms standard de couleurs curses. +.IP +En option, les spécifications des couleurs peuvent être suivies d'un signe +deux\-points et de la spécification d'un attribut. Il s'agit d'une liste +d'attributs, séparés par des caractères plus («\ +\ »). Parmi les attributs +disponibles, on trouve (tous ne fonctionnent pas sur tous les terminaux)\ : +\fBnormal\fP, \fBstandout\fP, \fBunderline\fP, \fBreverse\fP, \fBblink\fP, \fBbright\fP, +\fBdim\fP, \fBbold\fP. +.TP +\fB\-?\fP, \fB\-\-help\fP +Affiche une aide rapide et se termine normalement. +.TP +\fB\-\-version\fP +Affiche la version et se termine normalement. +. +.SH COMMANDES +Quand \fBdselect\fP est démarré, il peut effectuer les actions suivantes, soit +directement si elles sont indiquées dans la ligne de commande, soit +interactivement avec un menu de commandes possibles\ : +.SS "Accéder (access)" +Choisir et configurer une méthode d'accès aux dépôts de paquets. +.sp +Par défaut, \fBdselect\fP fournit plusieurs méthodes telles que \fIcdrom\fP, +\fImulti_cd\fP, \fInfs\fP, \fImulti_nfs\fP, \fIharddisk\fP, \fImounted\fP, \fImulti_mount\fP +ou \fIftp\fP, mais d'autres paquets peuvent fournir des méthodes +supplémentaires, comme la méthode d'accès \fIapt\fP fournie par le paquet +\fBapt\fP. +.sp +L'utilisation de la méthode d'accès \fIapt\fP est fortement conseillée. +.sp +.SS "Mise à jour (update)" +Rafraîchir la liste des paquets disponibles. +.sp +Récupère une liste de versions de paquets disponibles depuis un dépôt de +paquets, qui a été configuré pour la méthode d'accès actuelle, puis met à +jour la base de données de dpkg. Les listes de paquets sont d'habitude +fournies par les dépôts sous la forme de fichiers \fIPackages\fP ou +\fIPackages.gz\fP. Ces fichiers peuvent être générés par les responsables des +dépôts grâce au programme \fBdpkg\-scanpackages\fP(1). +.sp +Le fonctionnement détaillé de la commande de mise à jour dépend de +l'implémentation de la méthode d'accès. Normalement le processus se passe +tout seul, sans intervention de l'utilisateur. +.sp +.SS "Sélectionner (select)" +Voir ou gérer les paquets sélectionnés et les dépendances. +.sp +Il s'agit de la fonction principale de \fBdselect\fP. Dans l'écran de +sélection, l'utilisateur peut consulter la liste de tous les paquets +disponibles ou installés. Exécuté avec les privilèges administrateur, il +permet également de changer de façon interactive l'état de paquets +sélectionnés. \fBdselect\fP vérifie les implications de ces changements +vis\-à\-vis des dépendances et des conflits entre paquets. +.sp +Lorsqu'un conflit ou une dépendance manquante est détecté, un sous\-écran de +résolution des dépendances est proposé à l'utilisateur. Dans cet écran, une +liste de paquets avec des conflits ou avec des dépendances manquantes est +affichée et pour chaque paquet listé, la raison de sa présence dans cette +liste est indiquée. L'utilisateur peut ensuite appliquer les suggestion de +\fBdselect\fP, les modifier ou supprimer toutes les modifications, dont celles +qui ont créé les conflits ou dépendances non résolues. +.sp +L'utilisation de l'écran interactif des sélections de paquets est expliquée +de façon plus détaillée ci\-dessous. +.sp +.SS "Installer (install)" +Installer les paquets sélectionnés. +.sp +La méthode d'accès récupérera dans les dépôts les paquets qui peuvent être +installés ou mis à jour, puis les installe avec \fBdpkg\fP. En fonction de la +méthode d'accès, les paquets peuvent être tous récupérés avant installation, +ou récupérés à la demande. Certaines méthodes d'accès retirent également les +paquets qui ont été marqués pour être retirés. +.sp +Si une erreur apparaît lors de l'installation, il est recommandé de +redémarrer une installation. La plupart des fois, les problèmes +disparaissent ou sont résolus. Si les problèmes persistent ou si +l'installation n'est pas correcte, veuillez examiner les causes et +circonstances puis soumettez un rapport de bogue au système de suivi des +bogues Debian. Les instructions pour soumettre ces rapports de bogues se +trouvent sur https://bugs.debian.org/ ou dans la page de manuel de \fBbug\fP(1) +ou de \fBreportbug\fP(1), si ce paquet est installé. +.sp +Les détails de la commande d'installation dépendent de l'implémentation de +la méthode d'accès. L'attention et la contribution de l'utilisateur peuvent +être nécessaires lors de l'installation, de la configuration ou du retrait +des paquets. Cela dépend des scripts des responsables des paquets. Certains +paquets utilisent la bibliothèque \fBdebconf\fP(1), ce qui permet la mise en +place d'installations plus flexibles ou même automatisées. +.sp +.SS "Configurer (config)" +Configure les paquets déjà installés mais n'étant pas complètement +installés. +.sp +.SS "Retirer (remove)" +Retirer ou purger les paquets installés qui sont marqués comme étant à +retirer. +.sp +.SS "Quitter (quit)" +Quitter \fBdselect\fP. +.sp +Quitte le programme avec un code d'erreur de \fB0\fP (succès). +.sp +. +.SH "GESTION DE LA SÉLECTION DES PAQUETS" +.sp +.SS Introduction +.sp +\fBdselect\fP expose directement l'administrateur à une partie de la complexité +liée à la gestion d'un grand nombre de paquets ayant beaucoup de liens entre +eux. Pour un utilisateur qui n'est pas habitué aux concepts et au système de +gestion des paquets Debian, cela peut être perturbant. Mais \fBdselect\fP est +conçu pour aider la gestion et l'administration des paquets. Ce n'est qu'un +outil, et ne doit pas remplacer la compréhension et les aptitudes d'un +administrateur. L'utilisateur doit être familier des concepts sous\-jacents +au système de gestion des paquets Debian. En cas de doute, consultez la page +de manuel \fBdpkg\fP(1) et la Charte Debian. +.sp +À moins que \fBdselect\fP ne soit lancé en mode expert ou intermédiaire, un +message d'aide est d'abord affiché lorsque cette action est choisie dans le +menu. Il est \fBfortement\fP conseillé à l'utilisateur d'étudier toutes les +informations dans ces écrans d'aide lorsqu'ils apparaissent. Les écrans +d'aide peuvent être affichés à tout moment à l'aide de la touche «\ \fB?\fP\ ». +.sp +.SS "Disposition de l'écran" +.sp +L'écran de sélection est découpé par défaut en une moitié supérieure et une +moitié inférieure. La moitié supérieure affiche une liste de paquets. Un +curseur permet de sélectionner un paquet, ou un groupe de paquets en +sélectionnant le titre du groupe, si ça s'applique. La moitié inférieure de +l'écran affiche les détails du paquet sélectionné dans la moitié +supérieure. Le type de détail affiché peut varier. +.sp +Appuyez sur la touche «\ \fBI\fP\ » pour passer d'un affichage de la liste des +paquets en mode plein\-écran, à un affichage plus important des détails des +paquets ou à un mode partagé équitablement. +.sp +.SS "Vue des détails d'un paquet" +.sp +La vue des détails d'un paquet affiche par défaut la description longue du paquet sélectionné dans la liste des paquets. Le type de détail peut être modifié en pressant la touche «\ \fBi\fP\ ». Cela permet d'alterner entre\ : + \- la description longue + \- les informations de contrôle de la version installée + \- les informations de contrôle de la version disponible +.sp +Dans un écran de résolution des dépendances, on peut également voir les +dépendances et conflits spécifiques au paquet qui expliquent la présence du +paquet dans la liste. +.sp +.SS "Liste des états des paquets" +.sp +L'écran principal de sélection affiche une liste de tous les paquets connus +par le système de gestion des paquets Debian. Cela inclut les paquets +installés sur le système et les paquets connus par la base de données des +paquets disponibles. +.sp +Pour tous les paquets, la liste affiche sur une ligne l'état du paquet, sa +priorité, sa section, les architectures installée et disponible, les +versions installée et disponible, le nom du paquet et sa description +courte. En appuyant sur la touche «\ \fBA\fP\ », on peut activer ou désactiver +l'affichage des architectures installée et disponible. En appuyant sur la +touche «\ \fBV\fP\ », on peut activer ou désactiver l'affichage des versions +installée et disponible. En appuyant sur la touche «\ \fBv\fP\ », l'affichage de +l'état passe d'un mode bavard à un mode raccourci. Par défaut, l'état +raccourci est utilisé. +.sp +L'état raccourci consiste en 4 parties\ : un drapeau d'erreur, qui est +habituellement vide, l'état courant, l'état de sélection précédent et l'état +de sélection actuel. Les deux premiers donnent des indications sur l'état +courant du paquet, les deux suivants concernent les sélections définies par +l'utilisateur. +.sp +Voici la signification des codes d'indication des états\ : + Drapeau d'erreur\ : + \fIvide\fP aucune erreur\ ; + \fBR\fP erreur sérieuse, réinstallation nécessaire. + État d'installation\ : + \fIvide\fP pas installé\ ; + \fB*\fP complètement installé et configuré\ ; + \fB\-\fP pas installé, mais des fichiers de configuration existent toujours\ ; + \fBU\fP dépaqueté, mais toujours pas configuré\ ; + \fBC\fP à moitié configuré (il y a eu une erreur)\ ; + \fBI\fP à moitié installé (il y a eu une erreur). + Sélection actuelle et demandée\ : + \fB*\fP marqué comme étant à installer ou à mettre à jour\ ; + \fB\-\fP marqué comme étant à retirer, en conservant la configuration\ ; + \fB=\fP marqué comme étant à conserver\ : le paquet ne sera pas traité\ ; + \fB_\fP marqué comme étant à nettoyer, la configuration sera retirée également\ ; + \fBn\fP nouveau paquet, n'a toujours pas été marqué. +.sp +.SS "Déplacement du curseur et de l'écran" +.sp +Vous pouvez naviguer dans la liste de sélection des paquets et dans l'écran +de résolution des dépendances et des conflits à l'aide des touches +suivantes\ : +.br + \fBp, Haut, k\fP déplace le curseur vers le haut + \fBn, Bas, j\fP déplace le curseur vers le bas + \fBP, Page\-préc., Effacer\fP fait défiler la liste d'une page vers le haut + \fBN, Page\-suiv., Espace\fP fait défiler la liste d'une page vers le bas + \fB^p\fP fait défiler la liste d'une ligne vers le haut + \fB^n\fP fait défiler la liste d'une ligne vers le bas + \fBt, Home\fP saute au début de la liste + \fBe, Fin\fP saute à la fin de la liste + \fBu\fP fait défiler les informations d'une page vers le haut + \fBd\fP fait défiler les informations d'une page vers le bas + \fB^u\fP fait défiler les informations d'une ligne vers le haut + \fB^d\fP fait défiler les informations d'une ligne vers le bas + \fBB, gauche\fP déplace l'affichage de 1/3 vers la gauche + \fBF, droite\fP déplace l'affichage de 1/3 vers la droite + \fB^b\fP déplace l'affichage d'un caractère vers la gauche + \fB^f\fP déplace l'affichage d'un caractère vers la droite +.sp +.SS "Recherches et tris" +.sp +On peut rechercher un paquet par son nom dans la liste des paquets. Pour +cela, il faut presser la touche «\ \fB/\fP\ », puis taper le texte à +rechercher. Ce texte est interprété comme une expression rationnelle (voir +\fBregex\fP(7)). Si vous ajoutez «\ \fB/d\fP\ » à la recherche, dselect recherchera +également dans les descriptions. Si vous ajoutez «\ \fB/i\fP\ », la recherche ne +prend pas en compte la casse. Les deux suffixes peuvent être combinés comme +ceci\ : «\ \fB/id\fP\ ». La recherche peut être répétée en appuyant sur la touche +«\ \fBn\fP\ » ou «\ \fB\e\fP\ », jusqu'à ce que le paquet soit trouvé. Lorsque la +recherche atteint la fin de la liste, elle recommence au début. +.sp +On peut changer l'ordre du tri en appuyant sur la touche «\ \fBo\fP\ » ou «\ \fBO\fP\ ». Les neuf systèmes de tris suivants existent\ : + alphabétique disponible état + priorité+section disponible+priorité état+priorité + section+priorité disponible+section état+section +.br +Lorsqu'il n'est pas indiqué, l'ordre alphabétique est utilisé comme dernier +critère de tri. +.sp +.SS "Modifier les sélections" +.sp +Le type de sélection demandé d'un paquet peut être changé à l'aide des commandes suivantes\ : + \fB+, Inser\fP installer ou mettre à jour + \fB=, H\fP à garder dans l'état et la version actuels + \fB:, G\fP ne plus garder\ : mettre à niveau ou laisser non installé + \fB\-, Suppr\fP retirer, en gardant la configuration + \fB_\fP retirer et supprimer la configuration +.sp +Lorsque la demande de modification entraîne des dépendances non satisfaites +ou des conflits, \fBdselect\fP fournit à l'utilisateur un écran de résolution +des dépendances. Cela sera décrit plus tard. +.sp +Il est également possible d'appliquer ces commandes à des groupes de +sélections de paquets en plaçant le curseur sur le titre d'un groupe. Le +regroupement des paquets dépend de la façon dont les paquets sont triés dans +la liste. +.sp +Une attention particulière doit être prise lors de la modification de grands +groupes de sélections, parce qu'ils peuvent créer rapidement un nombre +important de dépendances non résolues ou de conflits, qui seraient tous +listés dans un écran de résolution de dépendances, le rendant difficile à +utiliser. En pratique, seules les opérations «\ à garder\ » et «\ ne plus +garder\ » sont utiles pour les groupes. +.sp +.SS "Résoudre les dépendances et les conflits" +.sp +Lorsque la demande de modification entraîne des dépendances non satisfaites +ou des conflits, \fBdselect\fP fournit à l'utilisateur un écran de résolution +des dépendances. Mais un écran d'information est affiché dans un premier +temps. +.sp +La moitié supérieure de cet écran liste tous les paquets ayant des +dépendances non résolues ou des conflits dus aux modifications demandées, +ainsi que les paquets dont l'installation permettrait de résoudre une +dépendance ou dont le retrait permettrait de résoudre un conflit. La moitié +inférieure affiche par défaut les dépendances ou conflits pour lesquels le +paquet sélectionné se trouve présent dans la liste. +.sp +Quand la sous\-liste de paquets est affichée pour la première fois, +\fBdselect\fP peut avoir déjà fixé les états demandés pour certains des paquets +listés, cela afin de résoudre les dépendances ou les conflits qui ont causé +l'apparition de l'écran de résolution des dépendances. Il est habituellement +recommandé de suivre les suggestions de \fBdselect\fP. +.sp +L'état de sélection des paquets listés peut être remis dans son état +précédent, avant que le problème de dépendance ou le conflit ne soit créé, +en appuyant sur la touche «\ \fBR\fP\ ». La touche «\ \fBD\fP\ » permet de remettre à +zéro les suggestions automatiques, tout en conservant les modifications qui +ont causé l'apparition de l'écran de résolution des dépendances. Enfin, la +touche «\ \fBU\fP\ » permet de rétablir les suggestions automatiques. +.sp +.SS "Établir les sélections demandées" +.sp +En appuyant sur \fBEntrée\fP, les sélections affichées sont acceptées. Si +\fBdselect\fP ne détecte pas de dépendances non résolues du fait de ces +sélections, les nouvelles sélections sont établies. Cependant, si des +dépendances non résolues sont trouvées, \fBdselect\fP affichera de nouveau un +écran de résolution des dépendances. +.sp +Pour modifier un jeu de sélections qui causent des dépendances non résolues +ou des conflits, et forcer \fBdselect\fP à l'accepter, appuyez sur la touche +«\ \fBQ\fP\ ». Cela fixe les sélections telles qu'elles sont définies par +l'utilisateur, sans condition. En général, ne faites pas cela, sauf si vous +avez bien lu ce qu'il y a d'écrit. +.sp +L'effet inverse, qui consiste à oublier les demandes de modification des +sélections et revenir à la liste précédente de sélections, peut être obtenu +en appuyant sur la touche «\ \fBX\fP\ » ou «\ \fBEchap\fP\ ». En répétant l'opération, +on peut complètement revenir à la dernière configuration établie. +.sp +Si vous avez fixé certains paramètres de façon erronée et que vous souhaitez +revenir en arrière sur ce qui est actuellement installé sur le système, +appuyez sur la touche «\ \fBC\fP\ ». C'est un peu comme utiliser la commande de +déblocage sur tous les paquets, mais cela offre un bouton panique plus +évident pour les cas où l'utilisateur a appuyé sur \fBentrée\fP +accidentellement. +.sp +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +La commande demandée s'est correctement déroulée. +.TP +\fB2\fP +Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande +non valable, ou interactions avec le système, telles que des accès à la base +de données, des allocations de mémoire,\ etc. +. +.SH ENVIRONNEMENT +.TP +\fBHOME\fP +Si positionné, sera utilisé par \fBdselect\fP comme le répertoire d'où sera lu +le fichier de configuration propre à l'utilisateur. +. +.SH BOGUES +L'interface \fBdselect\fP de sélection de paquets est déroutante pour les +nouveaux utilisateurs. On rapporte même qu'elle fait pleurer certains +développeurs chevronnés du noyau. +.sp +La documentation manque. +.sp +Il n'existe pas d'option d'aide dans le menu. +.sp +La liste visible des paquets disponibles ne peut pas être réduite. +.sp +La méthode d'accès intégrée ne satisfait pas les normes de qualité +actuelles. Utilisez plutôt la méthode fournie par APT. Non seulement elle +n'est pas cassée, mais en plus elle est plus souple que la méthode d'accès +intégrée. +. +.SH "VOIR AUSSI" +\fBdpkg\fP(1), \fBapt\-get\fP(8), \fBsources.list\fP(5), \fBdeb\fP(5). +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/start-stop-daemon.man b/man/fr/start-stop-daemon.man new file mode 100644 index 0000000..70546b7 --- /dev/null +++ b/man/fr/start-stop-daemon.man @@ -0,0 +1,357 @@ +.\" dpkg manual page - start-stop-daemon(8) +.\" +.\" Copyright © 1999 Klee Dienes <klee@mit.edu> +.\" Copyright © 1999 Ben Collins <bcollins@debian.org> +.\" Copyright © 2000-2001 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2002-2003 Adam Heath <doogie@debian.org> +.\" Copyright © 2004 Scott James Remnant <keybuk@debian.org> +.\" Copyright © 2008-2016, 2018 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH start\-stop\-daemon 8 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +start\-stop\-daemon \- Lance ou arrête des démons système +. +.SH SYNOPSIS +\fBstart\-stop\-daemon\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +On se sert de \fBstart\-stop\-daemon\fP pour contrôler la création ou l'arrêt de +processus système. En utilisant les options correspondantes, +\fBstart\-stop\-daemon\fP peut être configuré pour trouver les exemplaires +présents d'un processus en fonctionnement. +.PP +Veuillez noter qu'à moins d'utiliser \fB\-\-pid\fP ou \fB\-\-pidfile\fP, le programme +\fBstart\-stop\-daemon\fP se comporte comme \fBkillall\fP(1). \fBstart\-stop\-daemon\fP +recherche dans le tableau des processus tout processus qui correspond au +nom, pid parent, uid et/ou gid du processus (si indiqué). Toute +correspondance empêchera \fB\-\-start\fP de démarrer le démon. Tous les processus +qui correspondent recevront le signal TERM (ou le signal indiqué par +\fB\-\-signal\fP ou \fB\-\-retry\fP) si \fB\-\-stop\fP est indiqué. Pour les démons avec +des processus enfant qui doivent survivre à un \fB\-\-stop\fP, il est nécessaire +d'indiquer un fichier pid («\ pidfile\ »). +. +.SH COMMANDES +.TP +\fB\-S\fP, \fB\-\-start\fP [\fB\-\-\fP] \fIparamètres\fP +Vérifier l'existence d'un processus particulier. Quand il existe un tel +processus, \fBstart\-stop\-daemon\fP ne fait rien et se termine avec un code +d'erreur égal à \fB1\fP (\fB0\fP si \fB\-\-oknodo\fP est précisé). Quand un tel +processus n'existe pas, un exemplaire de l'exécutable est lancé, en +utilisant le paramètre de \fB\-\-exec\fP ou celui de \fB\-\-startas\fP si cette option +est précisée. Tout argument donné après \fB\-\-\fP sur la ligne de commande est +passé tel quel au programme qui doit être lancé. +.TP +\fB\-K\fP, \fB\-\-stop\fP +Vérifier aussi l'existence d'un processus particulier. Quand un tel +processus existe, \fBstart\-stop\-daemon\fP lui envoie le signal précisé avec +\fB\-\-signal\fP et se termine avec un code d'erreur égal à \fB0\fP. Quand un tel +processus n'existe pas, \fBstart\-stop\-daemon\fP se termine avec un code +d'erreur égal à \fB1\fP (\fB0\fP si \fB\-\-oknodo\fP est précisé). Si \fB\-\-retry\fP est +indiquée, \fBstart\-stop\-daemon\fP recherche si le processus ou les processus se +sont bien terminés. +.TP +\fB\-T\fP, \fB\-\-status\fP +Contrôle l'existence du processus indiqué et sort avec un code de sortie +défini par les actions des scripts d'initialisation de la LSB («\ LSB Init +Script Actions\ » –\ depuis la version\ 1.16.1). +.TP +\fB\-H\fP, \fB\-\-help\fP +Affiche un message d'aide, puis quitte. +.TP +\fB\-V\fP, \fB\-\-version\fP +Affiche la version du programme, puis quitte. +. +.SH OPTIONS +.SS "Options de correspondance" +.TP +[\fB\-\-pid\fP] \fIpid\fP +Vérifie l'existence d'un processus avec le \fIpid\fP spécifié (depuis la +version\ 1.17.6). Le \fIpid\fP doit avoir un numéro supérieur à\ 0. +.TP +[\fB\-\-ppid\fP] \fIpid parent\fP +Vérifie l'existence d'un processus avec le pid parent \fIpid\-parent\fP spécifié +(depuis la version\ 1.17.7). Le \fIpid\-parent\fP doit avoir un numéro supérieur +à\ 0. +.TP +\fB\-p\fP, \fB\-\-pidfile\fP \fIfichier\-pid\fP +Cherche les processus dont les identifiants sont précisés dans +\fIfichier\-pid\fP. +.IP +Note\ : l'utilisation de l'option de correspondance seule peut provoquer des +actions sur des processus non prévus, si l'ancien processus s'est terminé +sans savoir retiré le \fIfichier\-pid\fP. +.IP +\fBAttention\fP\ : L'utilisation de cette option de correspondance avec un +fichier pid accessible à tous en écriture ou seule avec un démon qui écrit +le fichier pid comme utilisateur non privilégié (pas root) sera refusée avec +une erreur (depuis la version\ 1.19.3) car c'est un risque de sécurité, parce +que, si le démon se trouve compromis, le contenu du fichier pid ne peut plus +être sûr, et ainsi, un exécutant privilégié (comme un script init exécuté en +tant que root) pourrait en fin de compte agir sur n'importe quel processus +du système. L'utilisation de \fI/dev/null\fP est exclue de ces vérifications. +.TP +\fB\-x\fP, \fB\-\-exec\fP \fIexécutable\fP +Contrôle l'existence de processus qui soient des exemplaires de cet +\fIexécutable\fP. Le paramètre \fIexécutable\fP doit être un chemin absolu. Note\ : +cela peut ne pas fonctionner avec des scripts interprétés, car l'exécutable +sera alors l'interpréteur. Des processus en exécution au sein d'un +environnement fermé d'exécution («\ chroot\ ») seront également trouvés et il +peut donc être nécessaire d'ajouter d'autres restrictions de correspondance. +.TP +\fB\-n\fP, \fB\-\-name\fP \fInom\-de\-processus\fP +Contrôle l'existence de processus avec \fInom\-de\-processus\fP comme nom. Le +\fInom\-de\-processus\fP est en général le nom du fichier du processus, mais peut +avoir été modifié par le processus lui\-même. Note\ : sur la plupart des +systèmes, cette information est récupérée par le nom de communication du +noyau, ce qui induit une limite de longueur assez courte (la portabilité +impose de ne pas supposer plus de 15\ caractères). +.TP +\fB\-u\fP, \fB\-\-user\fP \fIidentifiant\fP|\fIuid\fP +Contrôle l'existence de processus dont le propriétaire est \fIidentifiant\fP ou +\fIuid\fP. Note\ : si cette option est utilisée seule, tous les processus de cet +utilisateur seront concernés par l'action. +. +.SS "Options génériques" +.TP +\fB\-g\fP, \fB\-\-group\fP \fIgroupe\fP|\fIgid\fP +Modifie le \fIgroupe\fP ou le \fIgid\fP au début du processus. +.TP +\fB\-s\fP, \fB\-\-signal\fP \fIsignal\fP +L'action \fB\-\-stop\fP définit le signal à envoyer au processus qui doit être +arrêté (par défaut\ : TERM). +.TP +\fB\-R\fP, \fB\-\-retry\fP \fIdurée\fP|\fIaction\-prévue\fP +Avec l'action \fB\-\-stop\fP, \fBstart\-stop\-daemon\fP doit vérifier que les +processus se sont terminés. Il le fait pour tous les processus +correspondants qui tournent, jusqu'à ce qu'il n'y en ait plus. Quand le +processus ne se termine pas, il prend d'autres mesures déterminées par +l'\fIaction\-prévue\fP. + +Si \fIdurée\fP est indiquée plutôt que \fIaction\-prévue\fP, l'action\-prévue +\fIsignal\fP\fB/\fP\fIdurée\fP\fB/KILL/\fP\fIdurée\fP est utilisée, où \fIsignal\fP est le +signal indiqué par \fB\-\-signal\fP. + +\fIaction\-prévue\fP est une liste d'au moins deux items séparés par des barres +obliques (\fB/\fP)\ ; chaque item peut être de la forme \fB\-\fP\fInuméro\-signal\fP ou +de la forme [\fB\-\fP]\fInom\-signal\fP, ce qui demande d'envoyer ce signal\ ; ou +bien de la forme \fIdurée,\fP ce qui demande d'attendre tant de secondes avant +de terminer les processus, ou bien de la forme \fBforever\fP, ce qui demande de +répéter constamment le reste de action\-prévue, si nécessaire. + +Quand la fin de l'action\-prévue est atteinte et que \fBforever\fP n'a pas été +précisé, \fBstart\-stop\-daemon\fP se termine avec un code d'erreur égal à +\fB2\fP. Quand une action\-prévue est indiquée, tout signal donné par +\fB\-\-signal\fP est ignoré. +.TP +\fI\-a\fP, \fB\-\-startas\fP \fInom\-de\-chemin\fP +Avec l'action \fB\-\-start\fP, lance le processus spécifié par +\fInom\-de\-chemin\fP. Si rien n'est précisé, c'est par défaut l'argument donné à +\fB\-\-exec\fP. +.TP +\fB\-t\fP, \fB\-\-test\fP +Affiche les actions qui seraient entreprises et détermine la bonne valeur de +retour, mais ne fait rien. +.TP +\fB\-o\fP, \fB\-\-oknodo\fP +Retourne un code de sortie égal à \fB0\fP au lieu de \fB1\fP si rien n'est ou ne +sera fait. +.TP +\fB\-q\fP, \fB\-\-quiet\fP +N'affiche pas de messages d'information\ ; affiche seulement les messages +d'erreur. +.TP +\fB\-c\fP, \fB\-\-chuid\fP \fIidentifiant\fP|\fIuid\fP[\fB:\fP\fIgroupe\fP|\fIgid\fP] +Change pour cet utilisateur ou «\ uid\ » avant de lancer le processus. On peut +aussi préciser un groupe en ajoutant un \fB:\fP, puis le groupe ou un «\ gid\ » +de la même façon qu'avec la commande \fBchown\fP(1) +(\fIutilisateur\fP\fB:\fP\fIgroupe\fP). Lorsqu'un utilisateur est indiqué mais pas de +groupe alors le groupe primaire de celui\-ci est utilisé. Quand on utilise +cette option, on doit veiller à ce que les groupes primaires ainsi que les +groupes secondaires existent bien, même si l'option \fB\-\-group\fP n'est pas +spécifiée. L'option \fB\-\-group\fP sert seulement pour les groupes dont +l'utilisateur n'est pas membre (c'est comme rendre membre d'un +groupe\-pour\-processus des utilisateurs génériques comme \fBnobody\fP). +.TP +\fB\-r\fP, \fB\-\-chroot\fP \fIroot\fP +Change de répertoire racine pour \fBroot\fP avant de lancer le +processus. Remarquez que le «\ pidfile\ » est aussi écrit après le changement +de racine. +.TP +\fB\-d\fP, \fB\-\-chdir\fP \fIchemin\fP +Change de répertoire pour \fIchemin\fP avant de commencer le processus. Cela +est fait après le changement de répertoire racine si l'option +\fB\-r\fP|\fB\-\-chroot\fP est demandée. Si rien n'est demandé, \fBstart\-stop\-daemon\fP +changera de répertoire pour le répertoire racine avant de commencer le +processus. +.TP +\fB\-b\fP, \fB\-\-background\fP +Utilisé généralement pour les programmes qui ne «\ se détachent\ » pas +d'eux\-mêmes. Cette option oblige \fBstart\-stop\-daemon\fP à se dupliquer (fork) +avant de lancer le processus, et l'oblige à passer en +arrière\-plan. \fBAVERTISSEMENT\ : start\-stop\-daemon\fP ne peut pas vérifier le +code de sortie quand, pour \fBune raison ou une autre\fP, le processus +échoue. C'est un expédient dont on se servira seulement pour des programmes +dont la duplication n'a pas de sens ou bien des programmes dont le code +n'est pas adaptable pour leur ajouter cette fonctionnalité. +.TP +\fB\-\-notify\-await\fP +Attend que le processus en arrière\-plan envoie une notification de +disponibilité avant de considérer que le service est démarré (depuis la +version\ 1.19.3). Cela met en œuvre des éléments du protocole de +disponibilité de systemd, comme spécifié dans la page de manuel de +\fBsd_notify\fP(3). Les variables suivantes sont prises en charge\ : +.RS +.TP +\fBREADY=1\fP +Le programme est prêt à offrir son service, il est possible de quitter sans +risque. +.TP +\fBEXTEND_TIMEOUT_USEC=\fP\fInombre\fP +Le programme demande l'extension de la durée de \fInombre\fP +microsecondes. Cela fixera la durée en cours à la valeur spécifiée. +.TP +\fBERRNO=\fP \fInombre\fP +Le programme s'est terminé avec une erreur. Fait la même chose et affiche +une chaîne conviviale pour la valeur de \fBerrno\fP. +.RE +. +.TP +\fB\-\-notify\-timeout\fP\fIdurée\fP +Définit une durée pour l'option \fB\-\-notify\-await\fP (depuis la +version\ 1.19.3). Quand la durée est atteinte, \fBstart\-stop\-daemon\fP s'arrête +avec un code d'erreur et aucune notification de disponibilité n'est +attendue. La durée par défaut est de \fB60\fP\ secondes. +.TP +\fB\-C\fP, \fB\-\-no\-close\fP +Ne fermer aucun descripteur de fichiers en forçant le démon à s'exécuter en +arrière\-plan (depuis la version\ 1.16.5). Utilisé à des fins de débogage afin +de voir ce qu'affiche le processus ou pour rediriger les descripteurs de +fichiers pour journaliser l'affichage du processus. N'est pertinent que lors +de l'utilisation de \fB\-\-background\fP. +.TP +\fB\-N\fP, \fB\-\-nicelevel\fP \fIint\fP +Cela modifie la priorité du processus avant qu'il ne soit lancé. +.TP +\fB\-P\fP, \fB\-\-procsched\fP \fIpolitique\fP\fB:\fP\fIpriorité\fP +Modifie la politique du programmateur de processus («\ process scheduler +policy\ ») et la priorité du processus avant de le démarrer (depuis la +version\ 1.15.0). La priorité peut être indiquée de manière facultative avec +\fB:\fP suivi de la valeur souhaitée. La \fIpriorité\fP par défaut est\ 0. Les +valeurs de politiques actuellement gérées sont \fBother\fP, \fBfifo\fP et \fBrr\fP. +.TP +\fB\-I\fP, \fB\-\-iosched\fP \fIclasse\fP\fB:\fP\fIpriorité\fP +Modifie la classe du programmateur d'entrée/sortie («\ IO scheduler\ ») et la +priorité du processus avant de le démarrer (depuis la version\ 1.15.0). La +priorité peut être indiquée de manière facultative avec \fB:\fP suivi de la +valeur souhaitée. La \fIpriorité\fP par défaut est\ 4, sauf si \fIclasse\fP est +\fBidle\fP, auquel cas \fIpriorité\fP sera toujours égale à\ 7. Les valeurs de +\fIclasse\fP actuellement gérées sont \fBidle\fP, \fBbest\-effort\fP et \fBreal\-time\fP. +.TP +\fB\-k\fP, \fB\-\-umask\fP \fImasque\fP +Cela modifie le masque utilisateur du processus avant qu'il ne soit lancé +(depuis la version\ 1.13.22). +.TP +\fB\-m\fP, \fB\-\-make\-pidfile\fP +Utilisé lors du lancement d'un programme qui ne crée pas son propre fichier +identificateur «\ pid\ ». Cette option indique à \fBstart\-stop\-daemon\fP de créer +le fichier référencé par \fB\-\-pidfile\fP et placer le «\ pid\ » dans ce fichier +juste avant d'exécuter le processus. Il faut remarquer que ce fichier ne +sera supprimé quand le programme s'arrête que si \fB\-\-remove\-pidfile\fP est +utilisé. \fBNOTE\ :\fP il se peut que cette caractéristique ne marche pas dans +tous les cas. Notamment quand le programme qui est exécuté se duplique. À +cause de cela, cette option n'est habituellement utile que combinée avec +l'option \fB\-\-background\fP. +.TP +\fB\-\-remove\-pidfile\fP +Utilisé lors de l'arrêt d'un programme qui ne supprime pas lui\-même son +fichier identificateur «\ pid\ » (depuis la version\ 1.17.19). Cette option +indique à \fBstart\-stop\-daemon\fP de supprimer le fichier référencé par +\fB\-\-pid\-file\fP après l'arrêt du processus. +.TP +\fB\-v\fP, \fB\-\-verbose\fP +Affiche des messages prolixes en renseignements. +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +L'action demandée a été effectuée. Si \fB\-\-oknodo\fP était indiqué, il est +également possible que rien ne se soit passé. Cela peut se produire si +\fB\-\-start\fP était indiqué et qu'un processus correspondant était déjà en +train de s'exécuter ou si \fB\-\-stop\fP était indiqué et qu'aucun processus ne +correspondait. +.TP +\fB1\fP +Si \fB\-\-oknodo\fP n'était pas indiqué et que rien ne s'est passé. +.TP +\fB2\fP +Si \fB\-\-stop\fP et \fB\-\-retry\fP étaient indiqués mais que la fin de la +planification a été atteinte et que les processus étaient toujours en cours +d'exécution. +.TP +\fB3\fP +Toute autre erreur. +.PP +Lorsque la commande \fB\-\-status\fP est utilisée, les codes d'état suivants sont +renvoyés\ : +.TP +\fB0\fP +Le programme est en cours d'exécution. +.TP +\fB1\fP +Le programme n'est pas en cours d'exécution et le fichier PID existe. +.TP +\fB3\fP +Le programme n'est pas en cours d'exécution. +.TP +\fB4\fP +Impossible de déterminer l'état du programme. +. +.SH EXEMPLE +Démarre le démon \fBfood\fP, à moins qu'il soit déjà en cours d'exécution (un +processus nommé \fBfood\fP, tournant sous le nom d'utilisateur \fBfood\fP, avec un +pid dans food.pid)\ : +.IP +.nf +start\-stop\-daemon \-\-start \-\-oknodo \-\-user food \-\-name food \e + \-\-pidfile /run/food.pid \-\-startas /usr/sbin/food \e + \-\-chuid food \-\- \-\-daemon +.fi +.PP +Envoie le signal \fBSIGTERM\fP à \fBfood\fP et attend durant 5\ secondes son +arrêt\ : +.IP +.nf +start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e + \-\-pidfile /run/food.pid \-\-retry 5 +.fi +.PP +Démonstration d'un ordonnanceur personnalisé pour l'arrêt de \fBfood\fP\ : +.IP +.nf +start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e + \-\-pidfile /run/food.pid \-\-retry=TERM/30/KILL/5 +.fi +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. diff --git a/man/fr/update-alternatives.man b/man/fr/update-alternatives.man new file mode 100644 index 0000000..2e77347 --- /dev/null +++ b/man/fr/update-alternatives.man @@ -0,0 +1,443 @@ +.\" dpkg manual page - update-alternatives(1) +.\" +.\" Copyright © 1997-1998 Charles Briscoe-Smith +.\" Copyright © 1999 Ben Collins <bcollins@debian.org> +.\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> +.\" Copyright © 2003 Adam Heath <doogie@debian.org> +.\" Copyright © 2005 Scott James Remnant <scott@netsplit.com> +.\" Copyright © 2006-2015 Guillem Jover <guillem@debian.org> +.\" Copyright © 2008 Pierre Habouzit <madcoder@debian.org> +.\" Copyright © 2009-2011 Raphaël Hertzog <hertzog@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH update\-alternatives 1 %RELEASE_DATE% %VERSION% "suite dpkg" +.nh +.SH NOM +update\-alternatives \- Maintenance des liens symboliques déterminant les noms +par défaut de certaines commandes +. +.SH SYNOPSIS +\fBupdate\-alternatives\fP [\fIoption\fP...] \fIcommande\fP +. +.SH DESCRIPTION +\fBupdate\-alternatives\fP crée, enlève, conserve et affiche des informations +concernant les liens symboliques qui forment le système Debian des +«\ alternatives\ ». +.PP +Il est possible d'installer, sur un même système et en même temps, des +programmes qui remplissent des fonctions identiques ou semblables. Par +exemple, beaucoup de systèmes installent plusieurs éditeurs de texte en même +temps. Cela permet à chaque utilisateur d'un système de choisir, s'il le +désire, un éditeur de texte différent\ ; mais cela rend les choses difficiles +pour le programme qui doit choisir un bon éditeur de texte quand +l'utilisateur n'a pas fait de choix précis. +.PP +Le système Debian des «\ alternatives\ » essaie de résoudre ce problème. Tous +les fichiers qui proposent des fonctions interchangeables se servent d'un +nom générique qui se trouve dans l'arborescence. Le système des +«\ alternatives\ » et l'administrateur système font connaître ensemble le +fichier qui est réellement visé par ce nom générique. Par exemple, si les +éditeurs de texte \fBed\fP(1) et \fBnvi\fP(1) sont tous les deux installés, le +système des «\ alternatives\ » fait que le nom générique \fI/usr/bin/editor\fP +renvoie par défaut à \fI/usr/bin/nvi\fP. L'administrateur système peut +remplacer cette assignation par \fI/usr/bin/ed\fP et le système des +«\ alternatives\ » ne la changera pas tant qu'on ne lui aura pas demandé +explicitement de le faire. +.PP +Le nom générique n'est pas un lien symbolique direct vers l'alternative +choisie. C'est en fait un lien symbolique vers un nom situé dans le +\fIrépertoire\fP \fIdes «\ alternatives\ »\fP, lequel nom est à son tour un lien +symbolique vers le fichier réellement visé. Les modifications faites par +l'administrateur système sont ainsi confinées dans le répertoire +\fI%CONFDIR%\fP\ ; le FHS (lisez\-le) donne de Bonnes Raisons de faire ainsi. +.PP +Chaque fois qu'un paquet, proposant un fichier pour une fonction déterminée, +est installé, modifié ou désinstallé, \fBupdate\-alternatives\fP est appelé pour +mettre à jour les informations concernant ce fichier dans le système des +«\ alternatives\ ». En général, \fBupdate\-alternatives\fP est appelé dans les +scripts \fBpostinst\fP (configure) et \fBprerm\fP (remove and deconfigure) des +paquets Debian. +.PP +Il est souvent utile de synchroniser certaines alternatives, de manière à +pouvoir les manipuler globalement\ ; par exemple, quand plusieurs versions de +\fBvi\fP(1) sont installées, la page de manuel qui est visée par +\fI/usr/share/man/man1/vi.1\fP devrait correspondre à +\fI/usr/bin/vi\fP. \fBupdate\-alternatives\fP gère ce problème avec les liens +\fIprincipaux («\ master\ »)\fP et les liens \fIsecondaires («\ slave\ »)\fP. Quand le +lien principal est changé, tous les liens secondaires associés sont +changés. Un lien principal et ses liens secondaires associés composent un +\fIgroupe\fP de \fIliens\fP. +.PP +À tout moment, un groupe de liens est dans l'un des deux modes suivants\ : +automatique ou manuel. Quand un groupe est dans le mode automatique et que +des paquets sont installés ou désinstallés, le système des «\ alternatives\ » +décide automatiquement s'il doit mettre à jour les liens et comment le +faire. Dans le mode manuel, le système des «\ alternatives\ » ne change pas +les liens et laisse l'administrateur système prendre toutes les décisions +(sauf si quelque chose est cassé). +.PP +Un groupe de liens est en mode automatique quand il est créé sur un système +pour la première fois. Quand l'administrateur système modifie le paramétrage +automatique du système, \fBupdate\-alternatives\fP le remarquera la prochaine +fois qu'il sera lancé pour ce groupe aux liens modifiés et il fera passer ce +groupe en mode manuel. +.PP +À chaque alternative est associée une \fIpriorité\fP. Quand un groupe de liens +est en mode automatique, l'alternative visée par les éléments du groupe est +celle qui possède la priorité la plus élevée. +.PP +Quand l'option \fB\-\-config\fP est utilisée, \fBupdate\-alternatives\fP affiche +toutes les possibilités du groupe pour lequel \fInom\fP est le lien +principal. Le choix actuel est noté par un «\ *\ ». Il sera alors demandé quel +choix doit être fait pour ce groupe. Suivant le choix effectué, le groupe de +liens peut ne plus être en mode \fIauto\fP. Il vous faudra utiliser l'option +\fB\-\-auto\fP pour revenir au mode automatique (ou réutiliser \fB\-\-config\fP et +choisir l'entrée marquée comme automatique). +.PP +Si vous voulez configurer de manière non interactive, vous pouvez utiliser +l'option \fB\-\-set\fP (voir ci\-dessous). +.PP +Les différents paquets qui fournissent un même fichier doivent le faire en +\fBcollaborant\fP. En d'autres termes, l'utilisation de \fBupdate\-alternatives\fP +est \fBobligatoire\fP pour tous les paquets qui sont dans ce cas et il n'est +pas possible de remplacer un fichier d'un paquet qui n'utilise pas le +mécanisme offert par \fBupdate\-alternatives\fP. +. +.SH TERMINOLOGIE +Comme les opérations de \fBupdate\-alternatives\fP sont très compliquées, voici +quelques termes qui faciliteront l'explication. +.TP +nom générique (ou lien alternatif) +C'est un nom, par exemple \fI/usr/bin/editor\fP, qui renvoie, à travers le +système des «\ alternatives\ », à l'un des fichiers qui remplissent des +fonctions similaires. +.TP +nom alternatif +Nom d'un lien symbolique dans le répertoire des alternatives. +.TP +alternative (ou chemin alternatif) +C'est le nom d'un fichier particulier dans l'arborescence\ ; il peut être +accessible avec un nom générique grâce au système d'alternatives. +.TP +répertoire des alternatives +C'est le répertoire qui contient les liens symboliques\ ; il s'agit par +défaut de \fI%CONFDIR%/alternatives\fP. +.TP +répertoire administratif +C'est le répertoire qui contient des renseignements sur l'état de +\fBupdate\-alternatives.\fP Il s'agit par défaut de \fI%ADMINDIR%/alternatives\fP. +.TP +groupe de liens +C'est un ensemble de liens symboliques corrélés, de manière qu'on puisse les +mettre à jour en une seule fois. +.TP +lien principal +Dans un groupe de liens, c'est le lien alternatif qui détermine comment sont +configurés les autres liens du groupe. +.TP +lien secondaire («\ slave\ ») +Dans un groupe de liens, c'est un lien alternatif contrôlé par la +configuration du lien principal. +.TP +mode automatique +Quand un groupe de liens est en mode automatique, le système des +«\ alternatives\ » assure que les liens dans le groupe pointent vers +l'alternative possédant la priorité la plus élevée dans ce groupe. +.TP +mode manuel +Quand un groupe de liens est en mode manuel, le système des «\ alternatives\ » +ne modifie pas le paramétrage de l'administrateur système. +. +.SH COMMANDES +.TP +\fB\-\-install\fP \fIlien nom chemin priorité\fP [\fB\-\-slave\fP \fIlien nom chemin\fP]... +Ajoute un groupe d'alternatives au système. \fIlien\fP est le nom générique du +lien principal, \fInom\fP est le nom de son lien symbolique, et \fIchemin\fP est +l'alternative présentée pour le lien principal. Les paramètres qui suivent +\fB\-\-slave\fP sont le nom générique, le lien symbolique dans le répertoire des +alternatives et l'alternative pour un lien secondaire. On peut indiquer zéro +ou plusieurs options \fB\-\-slave\fP, chacune suivie par trois +paramètres. L'alternative principale doit exister, sinon la commande +échouera. Cependant, si une alternative secondaire n'existe pas, le lien +secondaire ne sera simplement pas installé (mais un avertissement sera +affiché). Si un fichier existe à l'emplacement où l'alternative doit être +installée, il est conservé sauf si \fB\-\-force\fP est utilisé. +.IP +Quand le lien principal spécifié existe déjà dans les enregistrements du +système des «\ alternatives\ », les renseignements fournis sont ajoutés dans +un nouvel ensemble d'alternatives pour le groupe. Sinon, un nouveau groupe +contenant ces informations est ajouté et mis en mode automatique. Quand un +groupe est en mode automatique, et que la priorité des alternatives +nouvellement ajoutées est supérieure à celle de toutes les alternatives +installées dans ce groupe, les liens symboliques sont mis à jour et pointent +vers les alternatives nouvellement ajoutées. +.TP +\fB\-\-set\fP \fInom chemin\fP +Ajoute le programme \fIchemin\fP comme alternative pour \fInom\fP. C'est +équivalent à \fB\-\-config\fP mais ce n'est pas interactif et on peut donc écrire +un script. +.TP +\fB\-\-remove\fP \fInom chemin\fP +Enlève une alternative et tous les liens secondaires associés. \fInom\fP est un +nom dans le répertoire des «\ alternatives\ », et \fIchemin\fP est un nom de +fichier auquel \fInom\fP peut être lié. Quand \fInom\fP est en effet lié à +\fIchemin\fP, \fInom\fP est mis à jour et pointe vers une autre alternative +adéquate ou bien est enlevé s'il n'y en a pas d'autre. De même, les liens +secondaires associés sont mis à jour ou enlevés. Quand le lien ne pointe pas +déjà sur \fIchemin\fP, aucun lien n'est modifié\ ; seules les informations sur +l'alternative sont supprimées. +.TP +\fB\-\-remove\-all\fP \fInom\fP +Supprime toutes les alternatives et tous les liens secondaires +associés. \fInom\fP est un nom dans le répertoire des alternatives. +.TP +\fB\-\-all\fP +Utilise \fB\-\-config\fP sur toutes les alternatives. Cette option peut être +combinée avec \fB\-\-skip\-auto\fP pour revoir et configurer toutes les +alternatives qui ne sont pas en mode automatique. Les alternatives erronées +sont aussi affichées. Ainsi, une méthode simple pour corriger les +alternatives cassées est d'utiliser \fByes \*(rq | update\-alternatives \-\-force +\-\-all\fP. +.TP +\fB\-\-auto\fP \fInom\fP +Passe le groupe de liens suivant l'alternative de \fInom\fP en mode +automatique. En même temps, le lien symbolique principal et ses liens +secondaires sont mis à jour et pointent vers les alternatives avec les +priorités les plus élevées. +.TP +\fB\-\-display\fP \fInom\fP +Affiche des renseignements sur le groupe de liens. L'information affichée +comprend le mode du groupe (auto ou manuel), les liens principal et +secondaires, vers quelle alternative le lien principal pointe actuellement, +quelles autres alternatives sont disponibles (et les liens secondaires +associés), et l'alternative actuellement installée qui possède la priorité +la plus élevée. +.TP +\fB\-\-get\-selections\fP +Affiche tous les noms principaux d'alternatives (ceux qui contrôlent un +groupe de liens) ainsi que leur état (depuis la version\ 1.15.0). Chaque +ligne comporte jusqu'à trois champs (séparés par une ou plusieurs +espaces). Le premier est le nom de l'alternative, le second est son état +(\fBauto\fP ou \fBmanual\fP) et le dernier montre le choix actuel pour +l'alternative (il s'agit d'un nom de fichier et donc peut contenir des +espaces). +.TP +\fB\-\-set\-selections\fP +Lit la configuration des alternatives sur l'entrée standard, dans le format +utilisé par \fB\-\-get\-selections\fP et les configure en conséquence (depuis la +version\ 1.15.0). +.TP +\fB\-\-query\fP \fInom\fP +Affiche des informations sur le groupe de liens de manière analogue à +\fB\-\-display\fP, mais sous une forme qui peut être analysée automatiquement +(depuis la version\ 1.15.0, voir la section \fBFORMAT DE REQUÊTE\fP ci\-dessous). +.TP +\fB\-\-list\fP \fInom\fP +Affiche toutes les cibles du groupe de liens. +.TP +\fB\-\-config\fP \fInom\fP +Affiche les alternatives disponibles pour un groupe de liens et permet de +choisir interactivement laquelle doit être utilisée. Le groupe de liens est +mis à jour. +.TP +\fB\-\-help\fP +Affiche un message d'aide puis quitte. +.TP +\fB\-\-version\fP +Affiche le numéro de version puis quitte. +. +.SH OPTIONS +.TP +\fB\-\-altdir\fP\fI répertoire\fP +Donne le répertoire des alternatives, quand il est différent de celui par +défaut. +.TP +\fB\-\-admindir\fP\fI répertoire\fP +Donne le répertoire administratif, quand il est différent de celui par +défaut. +.TP +\fB\-\-log\fP\fI fichier\fP +Indique le fichier journal (depuis la version\ 1.15.0), pour utiliser un +fichier différent du fichier par défaut (%LOGDIR%/alternatives.log). +.TP +\fB\-\-force\fP +Autorise le remplacement ou la suppression de tout fichier installé à la +place d'un lien d'alternative qui doit être créé ou supprimé. +.TP +\fB\-\-skip\-auto\fP +Passe l'invite de configuration pour les alternatives qui sont correctement +configurées en mode automatique. Cette option n'est pertinente qu'avec +\fB\-\-config\fP ou \fB\-\-all\fP. +.TP +\fB\-\-quiet\fP +Ne crée pas de commentaire à moins qu'une erreur ne survienne. +.TP +\fB\-\-verbose\fP +Produit plus de commentaires sur ce qui est fait. +.TP +\fB\-\-debug\fP +Produit plus de commentaires, utiles pour le débogage, sur ce qui est fait +(depuis la version\ 1.19.3). +. +.SH "CODE DE SORTIE" +.TP +\fB0\fP +L'action demandée s'est correctement déroulée. +.TP +\fB2\fP +Des problèmes sont survenus lors de l'analyse de la ligne de commande ou +bien pendant l'exécution de l'action. +. +.SH ENVIRONNEMENT +.TP +\fBDPKG_ADMINDIR\fP +Si cette variable est positionnée et que l'option \fB\-\-admindir\fP n'est pas +précisée, ce répertoire sera utilisé comme répertoire de base pour +l'administration. +. +.SH FICHIERS +.TP +\fI%CONFDIR%/alternatives/\fP +Le répertoire des «\ alternatives\ » par défaut. Peut être remplacé avec +l'option \fB\-\-altdir\fP. +.TP +\fI%ADMINDIR%/alternatives/\fP +Le répertoire administratif par défaut. Peut être remplacé avec l'option +\fB\-\-admindir\fP +. +.SH "FORMAT DE REQUÊTE" +Le format de \fB\-\-query\fP est un format à plat de type RFC822. Il est +constitué de \fIn\fP\ +\ 1 blocs où \fIn\fP est le nombre d'alternatives disponibles +dans le groupe de liens interrogé. Le premier bloc contient les champs +suivants\ : +.TP +\fBName:\fP\fI nom\fP +Nom de l'alternative dans le répertoire des alternatives. +.TP +\fBLink:\fP\fI lien\fP +Nom générique de l'alternative. +.TP +\fBSlaves:\fP \fI liste\-des\-liens\-secondaires\fP +Lorsque cet en\-tête est présent, les lignes \fBsuivantes\fP contiennent tous +les liens secondaires associés au lien principal de cette alternative, à +raison d'un lien secondaire par ligne. Chaque ligne comporte une espace, le +nom de l'alternative secondaire, une espace et le chemin vers le lien +secondaire. +.TP +\fBStatus:\fP\fI état\fP +État de l'alternative (\fBauto\fP ou \fBmanual\fP). +.TP +\fBBest:\fP\fI meilleur\-choix\fP +Chemin de la meilleure alternative pour ce groupe de liens. N'est pas +présent si aucune alternative n'est disponible. +.TP +\fBValue:\fP \fI alternative\-actuellement\-choisie\fP +Chemin de l'alternative actuellement choisie. Peut aussi prendre la valeur +spéciale \fBnone\fP, utilisée si le lien n'existe pas. +.PP +Les autres blocs décrivent les alternatives disponibles dans le groupe de +liens interrogé. +.TP +\fBAlternative:\fP \fI chemin\-de\-cette\-alternative\fP +Chemin vers l'alternative de ce bloc +.TP +\fBPriority:\fP \fI valeur\-de\-la\-priorité\fP +Valeur de la priorité de cette alternative. +.TP +\fBSlaves:\fP \fI liste\-des\-liens\-secondaires\fP +Lorsque ce champ est présent, les lignes \fBsuivantes\fP contiennent toutes les +alternatives secondaires associées au lien principal de cette alternative, à +raison d'une alternative secondaire par ligne. Chaque ligne comporte une +espace, le nom de l'alternative secondaire, une espace et le chemin vers +l'alternative secondaire. +. +.SS Exemple +.nf +$ update\-alternatives \-\-query editor +Name: editor +Link: /usr/bin/editor +Slaves: + editor.1.gz /usr/share/man/man1/editor.1.gz + editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz + editor.it.1.gz /usr/share/man/it/man1/editor.1.gz + editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz + editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz +Status: auto +Best: /usr/bin/vim.basic +Value: /usr/bin/vim.basic + +Alternative: /bin/ed +Priority: \-100 +Slaves: + editor.1.gz /usr/share/man/man1/ed.1.gz + +Alternative: /usr/bin/vim.basic +Priority: 50 +Slaves: + editor.1.gz /usr/share/man/man1/vim.1.gz + editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz + editor.it.1.gz /usr/share/man/it/man1/vim.1.gz + editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz + editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz +.fi +. +.SH DIAGNOSTICS +Avec l'option \fB\-\-verbose\fP, \fBupdate\-alternatives\fP affiche de très +nombreuses informations sur la sortie standard. Quand un problème survient, +\fBupdate\-alternatives\fP envoie des messages d'erreur sur la sortie d'erreur +standard et retourne un état de sortie égal à \fB2\fP. Ces diagnostics +devraient être simples à comprendre\ ; si ce n'est pas le cas, veuillez +envoyer un rapport de bogue. +. +.SH EXEMPLES +Plusieurs paquets fournissent un éditeur de texte compatible avec \fBvi\fP, par +exemple \fBnvi\fP et \fBvim\fP. Celui qui sera utilisé est déterminé par le groupe +de liens \fBvi\fP, qui comprend des liens pour le programme lui\-même et sa page +de manuel. +.PP +Pour afficher les paquets disponibles qui fournissent \fBvi\fP et son +paramétrage actuel, on peut utiliser l'action \fB\-\-display\fP\ : +.PP +.RS +\fBupdate\-alternatives \-\-display vi\fP +.RE +.PP +Pour choisir une implémentation particulière de \fBvi\fP, on peut utiliser +cette commande en tant que superutilisateur et choisir un nombre dans la +liste\ : +.PP +.RS +\fBupdate\-alternatives \-\-config vi\fP +.RE +.PP +Pour retrouver l'implémentation par défaut de \fBvi\fP, on peut utiliser cette +commande en tant que superutilisateur\ : +.PP +.RS +\fBupdate\-alternatives \-\-auto vi\fP +.RE +. +.SH "VOIR AUSSI" +\fBln\fP(1), FHS, le standard pour l'organisation du système de fichiers. +.SH TRADUCTION +Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. +Philippe Batailler, 2006. +Nicolas François, 2006. +Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>. |