path: root/man/fr/dpkg-deb.pod

        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOM

dpkg-deb - Outil pour la manipulation des archives (.deb) des paquets Debian

=head1 SYNOPSIS

B<dpkg-deb> [I<options>...] I<commande>

=head1 DESCRIPTION

B<dpkg-deb> crée un paquet, dépaquette une archive ou donne des
renseignements sur les archives Debian

B<dpkg> sert à installer ou à supprimer des paquets sur le système.

Il est possible d'exécuter B<dpkg-deb> en appelant B<dpkg> avec les options
de B<dpkg-deb>. B<dpkg> comprend que B<dpkg-deb> est appelé et le lance.

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 S<(« B<-> »)> S<unique ;> sinon,
l'absence de prise en charge sera documentée dans leurs descriptions de
commande respectives.

=head1 COMMANDES

=over 

=item B<-b>, B<--build> I<répertoire-binaire> [I<archive>|I<répertoire>]

Crée une archive Debian avec l'arborescence contenue dans
I<répertoire-binaire>. I<répertoire-binaire> doit posséder un
sous-répertoire B<DEBIAN> qui contient les fichiers de contrôle tels que le
fichier S<« control »> lui-même. Ce répertoire I<n'apparaît pas> dans l'archive
de l'arborescence du paquet S<binaire ;> mais les fichiers qu'il contient sont
mis dans la zone de contrôle du paquet binaire.

À moins de préciser B<--nocheck>, B<dpkg-deb> lit B<DEBIAN/control> et
l'analyse. Il cherche dans le fichier les erreurs de syntaxe et d'autres
problèmes S<existants ;> puis il affiche le nom du paquet binaire qu'il
construit. B<dpkg-deb> 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>.

Quand aucune I<archive> n'est donnée, B<dpkg-deb> écrit le paquet
dansI<répertoire-binaire>B<.deb>.

Si l'archive qui doit être créée existe déjà, elle est remplacée.

Quand le second argument est un répertoire, B<dpkg-deb> écrira dans le
fichier I<répertoire>B</>I<paquet>B<_>I<version>B<_>I<arch>B<.deb>. Quand un
répertoire cible est précisé à la place d'un fichier, l'option B<--nocheck>
ne doit pas être utilisée (puisque B<dpkg-deb> a besoin de lire et
d'analyser le fichier de contrôle du paquet pour connaître le nom de fichier
à utiliser).

=item B<-I>, B<--info> I<archive> [I<nom-fichier-control>...]

Donne des renseignements sur une archive de paquet binaire.

Quand aucun argument I<fichier-control> n'est précisé, un résumé du contenu
du paquet ainsi que son fichier S<« control »> sont affichés.

Quand un argument I<fichier-control> est précisé, B<dpkg-deb> affiche les
éléments dans l'ordre S<d'apparition ;> quand l'un des éléments n'est pas
présent, il affiche un message d'erreur sur S<« stderr »> et quitte avec un
code égal à B<2>.

=item B<-W>, B<--show> I<archive>

Cette option donne des informations sur l'archive d'un paquet binaire selon
le format spécifié par l'argument B<--showformat>. Le format par défaut
affiche le nom et la version du paquet sur une seule ligne, séparés par une
tabulation.

=item B<-f>, B<--field> I<archive> [I<nom-du-champ-de-control>...]

Extrait les renseignements du fichier S<« control »> de l'archive du paquet
binaire.

Quand aucun I<nom-du-champ-de-control> n'est précisé, le fichier S<« control »>
est affiché en entier.

Quand il y en a un, B<dpkg-deb> affiche ses éléments en suivant leur ordre
d'apparition dans le fichier S<« control ».> Quand il y a plus d'un argument
I<nom-champ-control>, B<dpkg-deb> fait précéder chacun par le nom de son
champ (puis par un S<« deux-points »> et une espace).

L'absence des champs demandés ne provoque pas de message d'erreur.

=item B<-c>, B<--contents> I<archive>

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>.

=item B<-x>, B<--extract> I<archive répertoire>

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 I<ne
produit pas> une installation S<correcte !> Utilisez B<dpkg> pour
l'installation des paquets.

I<répertoire> est créé si nécessaire (mais pas ses répertoires parents) et
ses permissions sont modifiées pour correspondre au contenu du paquet.

=item B<-X>, B<--vextract> I<archive répertoire>

Comme B<--extract> (B<-x>) avec B<--verbose> (B<-v>), ce qui affiche la
liste des fichiers au fur et à mesure qu'ils sont extraits.

=item B<-R>, B<--raw-extract> I<archive répertoire>

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> de ce répertoire (depuis S<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 S<(« B<-> »)> n'est B<pas>
prise en charge.

=item B<--ctrl-tarfile> I<archive>

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> (depuis
S<dpkg 1.17.14).> En combinant cette option avec la commande B<tar>(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.

=item B<--fsys-tarfile> I<archive>

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>. En combinant
cette option avec la commande B<tar>(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.

=item B<-e>, B<--control> I<archive> [I<répertoire>]

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
B<DEBIAN> du répertoire actuel.

Le répertoire cible est créé si nécessaire (mais pas ses répertoires
parents).

=item B<-?>, B<--help>

Affiche un message d'aide puis quitte.

=item B<--version>

Affiche le numéro de version puis quitte.

=back

=head1 OPTIONS

=over 

=item B<--showformat=>I<format>

Cette option sert à spécifier le format de sortie de l'option B<--show>. Ce
format sera utilisé pour chaque paquet listé.

Cet argument est une chaîne qui peut référencer tout champ avec la forme
S<« ${I<field-name>} » ;> une liste des champs valables peut être facilement
produite avec l'option B<-I> 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<dpkg-query>(1), option
B<--showformat>.

Par défaut, la valeur de ce champ est S<« ${Package}\t${Version}\n ».>

=item B<-z>I<niveau_compression>

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 S<est 9>
pour gzip S<et 6> pour xz. Les valeurs possibles sont les entiers compris
S<entre 0> S<et 9 :> S<0 correspond> à aucune compression pour gzip. Avant la
S<version 1.16.2,> la S<valeur 0> correspondait à S<« aucune> S<compression »> pour tous
les logiciels de compression.

=item B<-S>I<stratégie-compression>

Indique la stratégie de compression à fournir au logiciel de compression
appelé en sous-main lors de la construction du paquet (depuis
S<dpkg 1.16.2).> Les valeurs autorisées sont B<none> (depuis S<dpkg 1.16.4),>
B<filtered>, B<huffman>, B<rle> et B<fixed> pour gzip (depuis S<dpkg 1.17.0)>
et B<extreme> pour xz.

=item B<-Z>I<type_compression>

Indique le type de compression à utiliser lors de la construction d'un
paquet. Les valeurs autorisées sont B<gzip>, B<xz> (depuis S<dpkg 1.15.6)> et
B<none> (B<xz> est la valeur par défaut).

=item B<--[no-]uniform-compression>

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> et S<B<data.tar> ;>
depuis S<dpkg 1.17.6).> Sinon, seul le membre B<data.tar> utilisera ces
paramètres. B<none>, B<gzip> et B<xz> sont les seuls types de compression
pris en charge pour cette option d'uniformité (depuis S<dpkg 1.19.0).> La
compression uniforme est l'option par défaut (depuis S<dpkg 1.19.0).>

=item B<--root-owner-group>

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 S<l'identité 0> (depuis
S<dpkg 1.19.0).>

S<B<Note> :> cette option peut être utile pour les constructions sans root
(voir I<rootless-builds.txt>) mais ne devrait B<pas> ê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.

=item B<--deb-format=>I<format>

Indique la version du format d'archive utilisé lors de la construction
(depuis S<dpkg 1.17.0).> Les valeurs autorisées sont B<2.0> pour le nouveau
format et B<0.939000> pour l'ancien (la valeur par défaut est B<2.0>).

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 S<version 0.93.76> (septembre 1995), qui fut produite
uniquement pour le format S<« i386> S<a.out ».>

=item B<--nocheck>

Empêche les vérifications normales de B<dpkg-deb --build> quant au contenu
proposé d'une archive. De cette façon, on peut construire n'importe quelle
archive, aussi défectueuse soit-elle.

=item B<-v>, B<--verbose>

Active l'affichage bavard (depuis S<dpkg 1.16.1).> Cela n'affecte actuellement
que B<--extract> et le rend analogue à B<--vextract>.

=item B<-D>, B<--debug>

Permet les messages de débogage. Ce n'est pas très intéressant.

=back

=head1 CODE DE SORTIE

=over 

=item B<0>

L'action demandée s'est correctement déroulée.

=item B<2>

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 S<mémoire, etc.>

=back

=head1 ENVIRONNEMENT

=over 

=item B<DPKG_COLORS>

Définit le mode de couleur (depuis S<dpkg 1.18.5).> Les valeurs actuellement
acceptées sont B<auto> (par défaut), B<always> et B<never>.

=item B<TMPDIR>

Si cette option est utilisée, B<dpkg-deb> l'utilisera comme répertoire pour
créer les fichiers et répertoires temporaires.

=item B<SOURCE_DATE_EPOCH>

Si cette option est utilisée, elle sera utilisée comme horodatage (en
seconde à partir de S<« l'epoch »)> dans le conteneur B<ar>(5) de B<deb>(5), et
pour fixer le S<« mtime »> dans les entrées du fichier B<tar>(5).

=back

=head1 NOTES

N'essayez pas d'installer un logiciel avec S<B<dpkg-deb> !> Vous devez utiliser
B<dpkg> 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.

=head1 BOGUES

B<dpkg-deb -I> I<paquet1>B<.deb> I<paquet2>B<.deb> se trompe.

Il n'existe pas d'authentification des fichiers B<.deb>. 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> 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.

=head1 VOIR AUSSI

B<deb>(5), B<deb-control>(5), B<dpkg>(1), B<dselect>(1).


=head1 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>.