297 lines
16 KiB
HTML
297 lines
16 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dpkg-deb</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dpkg-deb</H1>
|
|
Section: suite dpkg (1)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOM</H2>
|
|
|
|
dpkg-deb - Outil pour la manipulation des archives (.deb) des paquets Debian
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>dpkg-deb</B> [<I>options</I>...] <I>commande</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>dpkg-deb</B> crée un paquet, dépaquette une archive ou donne des
|
|
renseignements sur les archives Debian
|
|
<P>
|
|
|
|
<B>dpkg</B> sert à installer ou à supprimer des paquets sur le système.
|
|
<P>
|
|
|
|
Il est possible d'exécuter <B>dpkg-deb</B> en appelant <B>dpkg</B> avec les options
|
|
de <B>dpkg-deb</B>. <B>dpkg</B> comprend que <B>dpkg-deb</B> est appelé et le lance.
|
|
<P>
|
|
|
|
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 («<B>-</B>») unique ; sinon,
|
|
l'absence de prise en charge sera documentée dans leurs descriptions de
|
|
commande respectives.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMANDES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-b</B>, <B>--build</B> <I>répertoire-binaire</I> [<I>archive</I>|<I>répertoire</I>]<DD>
|
|
Crée une archive Debian avec l'arborescence contenue dans
|
|
<I>répertoire-binaire</I>. <I>répertoire-binaire</I> doit posséder un
|
|
sous-répertoire <B>DEBIAN</B> qui contient les fichiers de contrôle tels que le
|
|
fichier « control » lui-même. Ce répertoire <I>n'apparaît pas</I> 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.
|
|
<P>
|
|
À moins de préciser <B>--nocheck</B>, <B>dpkg-deb</B> lit <B>DEBIAN/control</B> 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. <B>dpkg-deb</B> vérifie aussi les permissions des scripts du
|
|
responsable et des autres fichiers qu'il trouve dans le répertoire de
|
|
contrôle <B>DEBIAN</B>.
|
|
<P>
|
|
Quand aucune <I>archive</I> n'est donnée, <B>dpkg-deb</B> écrit le paquet
|
|
dans<I>répertoire-binaire</I><B>.deb</B>.
|
|
<P>
|
|
Si l'archive qui doit être créée existe déjà, elle est remplacée.
|
|
<P>
|
|
Quand le second argument est un répertoire, <B>dpkg-deb</B> écrira dans le
|
|
fichier <I>répertoire</I><B>/</B><I>paquet</I><B>_</B><I>version</I><B>_</B><I>arch</I><B>.deb</B>. Quand un
|
|
répertoire cible est précisé à la place d'un fichier, l'option <B>--nocheck</B>
|
|
ne doit pas être utilisée (puisque <B>dpkg-deb</B> a besoin de lire et
|
|
d'analyser le fichier de contrôle du paquet pour connaître le nom de fichier
|
|
à utiliser).
|
|
<DT id="2"><B>-I</B>, <B>--info</B> <I>archive</I> [<I>nom-fichier-control</I>...]<DD>
|
|
Donne des renseignements sur une archive de paquet binaire.
|
|
<P>
|
|
Quand aucun argument <I>fichier-control</I> n'est précisé, un résumé du contenu
|
|
du paquet ainsi que son fichier « control » sont affichés.
|
|
<P>
|
|
Quand un argument <I>fichier-control</I> est précisé, <B>dpkg-deb</B> 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 à <B>2</B>.
|
|
<DT id="3"><B>-W</B>, <B>--show</B> <I>archive</I><DD>
|
|
Cette option donne des informations sur l'archive d'un paquet binaire selon
|
|
le format spécifié par l'argument <B>--showformat</B>. Le format par défaut
|
|
affiche le nom et la version du paquet sur une seule ligne, séparés par une
|
|
tabulation.
|
|
<DT id="4"><B>-f</B>, <B>--field</B> <I>archive</I> [<I>nom-du-champ-de-control</I>...]<DD>
|
|
Extrait les renseignements du fichier « control » de l'archive du paquet
|
|
binaire.
|
|
<P>
|
|
Quand aucun <I>nom-du-champ-de-control</I> n'est précisé, le fichier « control »
|
|
est affiché en entier.
|
|
<P>
|
|
Quand il y en a un, <B>dpkg-deb</B> affiche ses éléments en suivant leur ordre
|
|
d'apparition dans le fichier « control ». Quand il y a plus d'un argument
|
|
<I>nom-champ-control</I>, <B>dpkg-deb</B> fait précéder chacun par le nom de son
|
|
champ (puis par un « deux-points » et une espace).
|
|
<P>
|
|
L'absence des champs demandés ne provoque pas de message d'erreur.
|
|
<DT id="5"><B>-c</B>, <B>--contents</B> <I>archive</I><DD>
|
|
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
|
|
<B>tar</B>.
|
|
<DT id="6"><B>-x</B>, <B>--extract</B> <I>archive répertoire</I><DD>
|
|
Extrait l'arborescence des fichiers d'un paquet archive dans le répertoire
|
|
spécifié.
|
|
<P>
|
|
Il faut remarquer que l'extraction d'un paquet dans le répertoire root <I>ne
|
|
produit pas</I> une installation correcte ! Utilisez <B>dpkg</B> pour
|
|
l'installation des paquets.
|
|
<P>
|
|
<I>répertoire</I> est créé si nécessaire (mais pas ses répertoires parents) et
|
|
ses permissions sont modifiées pour correspondre au contenu du paquet.
|
|
<DT id="7"><B>-X</B>, <B>--vextract</B> <I>archive répertoire</I><DD>
|
|
Comme <B>--extract</B> (<B>-x</B>) avec <B>--verbose</B> (<B>-v</B>), ce qui affiche la
|
|
liste des fichiers au fur et à mesure qu'ils sont extraits.
|
|
<DT id="8"><B>-R</B>, <B>--raw-extract</B> <I>archive répertoire</I><DD>
|
|
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é <B>DEBIAN</B> de ce répertoire (depuis dpkg 1.16.1).
|
|
<P>
|
|
Le répertoire cible est créé si nécessaire (mais pas ses répertoires
|
|
parents).
|
|
<P>
|
|
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 (« <B>-</B> ») n'est <B>pas</B>
|
|
prise en charge.
|
|
<DT id="9"><B>--ctrl-tarfile</B> <I>archive</I><DD>
|
|
Extrait les données de contrôle d'un paquet binaire et les envoie sur la
|
|
sortie standard dans le format propre à la commande <B>tar</B> (depuis
|
|
dpkg 1.17.14). En combinant cette option avec la commande <B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(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.
|
|
<DT id="10"><B>--fsys-tarfile</B> <I>archive</I><DD>
|
|
Extrait les données de l'arborescence d'un paquet binaire et les envoie sur
|
|
la sortie standard dans le format propre à la commande <B>tar</B>. En combinant
|
|
cette option avec la commande <B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(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.
|
|
<DT id="11"><B>-e</B>, <B>--control</B> <I>archive</I> [<I>répertoire</I>]<DD>
|
|
Extrait les fichiers de contrôle d'une archive de paquet dans le répertoire
|
|
spécifié.
|
|
<P>
|
|
Quand aucun répertoire n'est précisé, on utilise un sous-répertoire
|
|
<B>DEBIAN</B> du répertoire actuel.
|
|
<P>
|
|
Le répertoire cible est créé si nécessaire (mais pas ses répertoires
|
|
parents).
|
|
<DT id="12"><B>-?</B>, <B>--help</B><DD>
|
|
Affiche un message d'aide puis quitte.
|
|
<DT id="13"><B>--version</B><DD>
|
|
Affiche le numéro de version puis quitte.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14"><B>--showformat=</B><I>format</I><DD>
|
|
Cette option sert à spécifier le format de sortie de l'option <B>--show</B>. Ce
|
|
format sera utilisé pour chaque paquet listé.
|
|
<P>
|
|
Cet argument est une chaîne qui peut référencer tout champ avec la forme
|
|
« ${<I>field-name</I>} » ; une liste des champs valables peut être facilement
|
|
produite avec l'option <B>-I</B> 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 <B><A HREF="/cgi-bin/man/man2html?1+dpkg-query">dpkg-query</A></B>(1), option
|
|
<B>--showformat</B>.
|
|
<P>
|
|
Par défaut, la valeur de ce champ est « ${Package}\t${Version}\n ».
|
|
<DT id="15"><B>-z</B><I>niveau_compression</I><DD>
|
|
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.
|
|
<DT id="16"><B>-S</B><I>stratégie-compression</I><DD>
|
|
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 <B>none</B> (depuis dpkg 1.16.4),
|
|
<B>filtered</B>, <B>huffman</B>, <B>rle</B> et <B>fixed</B> pour gzip (depuis dpkg 1.17.0)
|
|
et <B>extreme</B> pour xz.
|
|
<DT id="17"><B>-Z</B><I>type_compression</I><DD>
|
|
Indique le type de compression à utiliser lors de la construction d'un
|
|
paquet. Les valeurs autorisées sont <B>gzip</B>, <B>xz</B> (depuis dpkg 1.15.6) et
|
|
<B>none</B> (<B>xz</B> est la valeur par défaut).
|
|
<DT id="18"><B>--[no-]uniform-compression</B><DD>
|
|
Indique que les mêmes paramètres de compression doivent être utilisés pour
|
|
tous les membres de l'archive (c'est-à-dire <B>control.tar</B> et <B>data.tar</B> ;
|
|
depuis dpkg 1.17.6). Sinon, seul le membre <B>data.tar</B> utilisera ces
|
|
paramètres. <B>none</B>, <B>gzip</B> et <B>xz</B> 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).
|
|
<DT id="19"><B>--root-owner-group</B><DD>
|
|
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).
|
|
<P>
|
|
<B>Note</B> : cette option peut être utile pour les constructions sans root
|
|
(voir <I>rootless-builds.txt</I>) mais ne devrait <B>pas</B> ê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.
|
|
<DT id="20"><B>--deb-format=</B><I>format</I><DD>
|
|
Indique la version du format d'archive utilisé lors de la construction
|
|
(depuis dpkg 1.17.0). Les valeurs autorisées sont <B>2.0</B> pour le nouveau
|
|
format et <B>0.939000</B> pour l'ancien (la valeur par défaut est <B>2.0</B>).
|
|
<P>
|
|
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 ».
|
|
<DT id="21"><B>--nocheck</B><DD>
|
|
Empêche les vérifications normales de <B>dpkg-deb --build</B> quant au contenu
|
|
proposé d'une archive. De cette façon, on peut construire n'importe quelle
|
|
archive, aussi défectueuse soit-elle.
|
|
<DT id="22"><B>-v</B>, <B>--verbose</B><DD>
|
|
Active l'affichage bavard (depuis dpkg 1.16.1). Cela n'affecte actuellement
|
|
que <B>--extract</B> et le rend analogue à <B>--vextract</B>.
|
|
<DT id="23"><B>-D</B>, <B>--debug</B><DD>
|
|
Permet les messages de débogage. Ce n'est pas très intéressant.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>CODE DE SORTIE</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="24"><B>0</B><DD>
|
|
L'action demandée s'est correctement déroulée.
|
|
<DT id="25"><B>2</B><DD>
|
|
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.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONNEMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="26"><B>DPKG_COLORS</B><DD>
|
|
Définit le mode de couleur (depuis dpkg 1.18.5). Les valeurs actuellement
|
|
acceptées sont <B>auto</B> (par défaut), <B>always</B> et <B>never</B>.
|
|
<DT id="27"><B>TMPDIR</B><DD>
|
|
Si cette option est utilisée, <B>dpkg-deb</B> l'utilisera comme répertoire pour
|
|
créer les fichiers et répertoires temporaires.
|
|
<DT id="28"><B>SOURCE_DATE_EPOCH</B><DD>
|
|
Si cette option est utilisée, elle sera utilisée comme horodatage (en
|
|
seconde à partir de « l'epoch ») dans le conteneur <B><A HREF="/cgi-bin/man/man2html?5+ar">ar</A></B>(5) de <B><A HREF="/cgi-bin/man/man2html?5+deb">deb</A></B>(5), et
|
|
pour fixer le « mtime » dans les entrées du fichier <B><A HREF="/cgi-bin/man/man2html?5+tar">tar</A></B>(5).
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
N'essayez pas d'installer un logiciel avec <B>dpkg-deb</B> ! Vous devez utiliser
|
|
<B>dpkg</B> 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.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BOGUES</H2>
|
|
|
|
<B>dpkg-deb -I</B> <I>paquet1</I><B>.deb</B> <I>paquet2</I><B>.deb</B> se trompe.
|
|
<P>
|
|
Il n'existe pas d'authentification des fichiers <B>.deb</B>. 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 <B>.deb</B> 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.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>VOIR AUSSI</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb">deb</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?5+deb-control">deb-control</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dselect">dselect</A></B>(1).
|
|
<A NAME="lbAL"> </A>
|
|
<H2>TRADUCTION</H2>
|
|
|
|
Ariel VARDI <<A HREF="mailto:ariel.vardi@freesbee.fr">ariel.vardi@freesbee.fr</A>>, 2002.
|
|
Philippe Batailler, 2006.
|
|
Nicolas François, 2006.
|
|
Veuillez signaler toute erreur à <<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="29"><A HREF="#lbAB">NOM</A><DD>
|
|
<DT id="30"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="31"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="32"><A HREF="#lbAE">COMMANDES</A><DD>
|
|
<DT id="33"><A HREF="#lbAF">OPTIONS</A><DD>
|
|
<DT id="34"><A HREF="#lbAG">CODE DE SORTIE</A><DD>
|
|
<DT id="35"><A HREF="#lbAH">ENVIRONNEMENT</A><DD>
|
|
<DT id="36"><A HREF="#lbAI">NOTES</A><DD>
|
|
<DT id="37"><A HREF="#lbAJ">BOGUES</A><DD>
|
|
<DT id="38"><A HREF="#lbAK">VOIR AUSSI</A><DD>
|
|
<DT id="39"><A HREF="#lbAL">TRADUCTION</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:01 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|