blob: dd4c660f8515359eb64e6e9ff161dccda5253613 [file] [log] [blame]
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-deb 1 2011\-08\-14 "Projet Debian" "suite dpkg"
.SH NOM
dpkg\-deb \- outil pour la manipulation des archives (.deb) des paquets Debian
.
.SH SYNOPSIS
\fBdpkg\-deb\fP [\fIoption\fP...] \fIcommand\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
Is like \fB\-\-extract\fP (\fB\-x\fP) with \fB\-\-verbose\fP (\fB\-v\fP) which prints a
listing of the files extracted as it goes.
.TP
\fB\-R\fP, \fB\-\-raw\-extract\fP \fIarchive directory\fP
Extracts the filesystem tree from a package archive into a specified
directory, and the control information files into a DEBIAN subdirectory of
the specified directory.
Le répertoire cible est créé si nécessaire (mais pas ses répertoires
parents).
.TP
\fB\-\-fsys\-tarfile\fP \fIarchive\fP
Extracts the filesystem tree data from a binary package and sends it to
standard output in \fBtar\fP format. Together with \fBtar\fP(1) this can be used
to extract a particular file from a package archive. The input archive will
always be processed sequentially.
.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\fIcompress\-level\fP
Specify which compression level to use on the compressor backend, when
building a package (default is 9 for gzip and bzip2, 6 for xz and lzma).
.TP
\fB\-Z\fP\fIcompress\-type\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\-v\fP, \fB\-\-verbose\fP
Enables verbose output. This currently only affects \fB\-\-extract\fP making it
behave like \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 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>.