~ubuntu-branches/ubuntu/oneiric/dpkg/oneiric

.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-deb 1 07\-03\-2010 "Projet Debian" "suite dpkg"
.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.
.
.SH COMMANDES
.TP 
\fB\-b\fP, \fB\-\-build\fP \fIrépertoire\fP [\fIarchive\fP|\fIrépertoire\fP]
Crée une archive Debian avec l'arborescence contenue dans
\fIrépertoire\fP. \fIrépertoire\fP doit posséder un sous\-répertoire \fBDEBIAN\fP qui
contient les fichiers de contrôle tel 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 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 appelle le paquet
\fIrépertoire\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 appelle le paquet
\fIpaquet\fP\fB_\fP\fIversion\fP\fB_\fP\fIarch\fP\fB.deb\fP,\fB ou bien
\fP\fIpaquet\fP\fB_\fP\fIversion\fP\fB.deb\fP si aucun champ \fBArchitecture\fP n'est présent
dans le fichier de contrôle du paquet. 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 à 2.
.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 argument \fBcontrol\-fichier\-champ\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
\fBcontrol\-fichier\-field,\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 seulement l'arborescence des fichiers d'une archive de paquet. C'est
en fait le résultat produit par la commande \fBtar\fP et une option
d'énumération verbeuse.
.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 cnotenu du paquet.
.TP 
\fB\-X\fP, \fB\-\-vextract\fP \fIarchive répertoire\fP
Comme \fB\-\-extract\fP (\fB\-x\fP), mais affiche la liste des fichiers au fur et à
mesure qu'ils sont extraits.
.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.
.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\-h\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.
.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 \fIgzip\fP (la valeur par défaut), \fIxz\fP,
\fIbzip2\fP, \fIlzma\fP et \fInone\fP (aucune compression).
.TP 
\fB\-\-new\fP
S'assure que \fBdpkg\-deb\fP construit une archive avec le «\ nouveau\ »
format. C'est le comportement par défaut.
.TP 
\fB\-\-old\fP
Oblige \fBdpkg\-deb\fP à construire une archive avec l'«\ ancien\ » format. Ce
format, 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\-D\fP, \fB\-\-debug\fP
Permet les messages de débogage. Ce n'est pas très intéressant.
.
.SH ENVIRONNEMENT
.TP 
\fBTMPDIR\fP
Si cette option est utilisée, \fBdpkg\fP l'utilisera comme répertoire pour
créer les fichiers et répertoire temporaires.
.
.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 comme de
contrôle MD5 créée par debian/rules. Cependant, ceci n'est pas directement
géré par les outils de plus bas niveau.

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 "VOIR AUSSI"
\fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg\fP(1), \fBdselect\fP(1).
.
.SH AUTEUR
Copyright \(co 1995\-1996 Ian Jackson
.sp
Ce programme est un logiciel libre\ ; voyez la «\ GNU General Public Licence\ »
version 2 ou supérieure pour le copyright. Il n'y a PAS de garantie.
.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>.