blob: 7100a4bfebfc8de386c06ff011c726ff90e6b9d3 [file] [log] [blame]
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-query 1 2011\-08\-14 "Projet Debian" "suite dpkg"
.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 [\fIpackage\-name\-pattern\fP...]
Affiche les paquets correspondants au motif donné. Si aucun
\fInom\-paquet\-motif\fP n'est indiqué, affiche tous les paquets de
\fI/var/lib/dpkg/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 \fInom\-paquet\-motif\fP. Il
faudra sans doute mettre \fInom\-paquet\-motif\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 \(aqlibc6*\(aq\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> = (none)
R = 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 [\fIpackage\-name\-pattern\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 et la version installée,
séparé par une tabulation.
.TP
\fB\-s\fP, \fB\-\-status\fP \fInom\-paquet\fP ...
Report status of specified package. This just displays the entry in the
installed package status database. When multiple \fIpackage\-name\fP are listed,
the requested status entries are separated by an empty line.
.TP
\fB\-L\fP, \fB\-\-listfiles\fP \fInom\-paquet\fP...
List files installed to your system from \fIpackage\-name\fP. When multiple
\fIpackage\-name\fP are listed, the requested lists of files are separated by an
empty line. However, note that files created by package\-specific
installation\-scripts are not listed.
.TP
\fB\-c\fP, \fB\-\-control\-path\fP \fInom\-paquet\fP [\fIfichier\-contrôle\fP]
Affiche les chemins pour les fichiers de contrôle installés sur votre
système pour \fInom\-paquet\fP. 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 semi\-publique et ne devrait être
utilisée qu'en dernier ressort et si aucune autre interface n'est
disponible. Elle pourrait devenir obsolète dans le futur si de meilleures
interfaces sont mises en place ou si les défauts actuels d'architecture sont
résolus.
.TP
\fB\-S\fP, \fB\-\-search\fP \fImotif\-de\-nom\-a\-rechercher\fP...
Search for packages that own files corresponding to the given pattern.
Standard shell wildchars can be used in the pattern. This command will not
list extra files created by maintainer scripts, nor will it list
alternatives.
.TP
\fB\-p\fP, \fB\-\-print\-avail\fP \fInom\-paquet\fP...
Display details about \fIpackage\-name\fP, as found in
\fI/var/lib/dpkg/available\fP. When multiple \fIpackage\-name\fP are listed, the
requested \fIavailable\fP entries are separated by an empty line.
Users of APT\-based frontends should use \fBapt\-cache show\fP \fIpackage\-name\fP
instead as the \fIavailable\fP file is only kept up\-to\-date when using
\fBdselect\fP.
.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\-\-admindir\fP=\fIdir\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\-f\fP, \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é.
Dans la chaîne, \(lq\fB\e\fP\(rq déspécifie le caractère
.nf
\fB\en\fP nouvelle ligne
\fB\er\fP retour chariot
\fB\et\fP tabulation
.fi
\(lq\fB\e\fP\(rq avant un caractère supprime la signification du caractère qui
suit. C'est utile pour les caractères \(lq\fB\e\fP\(rq and \(lq\fB$\fP\(rq.
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\ :
\(lq\fB${\fP\fIfield\fP[\fB;\fP\fIwidth\fP]\fB}\fP\(rq. 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 (internal)
\fBConfig\-Version\fP (internal)
\fBConflicts\fP
\fBBreaks\fP
\fBDepends\fP
\fBDescription\fP
\fBEnhances\fP
\fBEssential\fP
\fBFilename\fP (internal, front\-end related)
\fBHomepage\fP
\fBInstalled\-Size\fP
\fBMD5sum\fP (internal, front\-end related)
\fBMSDOS\-Filename\fP (internal, front\-end related)
\fBMaintainer\fP
\fBOrigin\fP
\fBPackage\fP
\fBPre\-Depends\fP
\fBPriority\fP
\fBProvides\fP
\fBRecommends\fP
\fBReplaces\fP
\fBRevision\fP (obsolete)
\fBSection\fP
\fBSize\fP (internal, front\-end related)
\fBSource\fP
\fBStatus\fP (internal)
\fBSuggests\fP
\fBTag\fP (usually not in the .deb but in the repository Packages files)
\fBTriggers\-Awaited\fP (internal)
\fBTriggers\-Pending\fP (internal)
\fBVersion\fP
.fi
Le format par défaut est le suivant\ :
\(lq\fB${Package}\et${Version}\en\fP\(rq. Tous les autres champs du fichier
status, 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
vérification n'est faite. Pour obtenir le nom du responsable de dpkg et la
version installée, exécutez par exemple\ :
.nf
\fBdpkg\-query \-W \-f=\(aq${Package} ${Version}\et${Maintainer}\en\(aq dpkg\fP
.fi
.
.SH "CODE DE SORTIE"
.TP
\fB0\fP
La requête demandée s'est correctement déroulée.
.TP
\fB1\fP
Des problèmes sont survenus lors de l'analyse de la ligne de commande ou
bien pendant l'exécution de la requête. Cela peut être une absence de
fichier ou de paquet (sauf pour \-\-control\-path).
.
.SH ENVIRONNEMENT
.TP
\fBDPKG_ADMINDIR\fP
If set and the \fB\-\-admindir\fP option has not been specified, it will be used
as the dpkg data directory.
.TP
\fBCOLUMNS\fP
Ce réglage influence la sortie de l'option \fB\-\-list\fP en modifiant la largeur
d'affichage.
.
.SH AUTEUR
Copyright \(co 2001 Wichert Akkerman
.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 "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>.