NOM¶
debc - Visualiser le contenu d'un paquet Debian généré
SYNOPSIS¶
debc [
options] [
fichier_changes] [
paquet ...]
DESCRIPTION¶
debc détermine la version d'un paquet et affiche des informations
concernant les fichiers .deb et .udeb générés. Si un fichier
.changes est indiqué en ligne de commande, le nom du fichier doit
se terminer par
.changes, puisque c'est comme cela que le programme le
différencie d'un nom de paquet. Sinon,
debc doit être
appelé depuis le répertoire du code source. Dans ce cas, il
recherchera un fichier
.changes correspondant à la version du
paquet ; pour cela, il détermine le nom et la version grâce au
fichier changelog, et l'architecture est cherchée comme
dpkg-buildpackage(1) le ferait. Il exécute ensuite
dpkg-deb
-I et
dpkg-deb -c pour toutes les archives
.deb listées
dans le fichier
.changes pour afficher des informations sur le contenu
des fichiers
.deb et
.udeb. Il place devant tous les fichiers
.deb ou
.udeb le nom du fichier. Il suppose que toutes ces
archives
.deb /
.udeb se trouvent dans le même
répertoire que le fichier
.changes. C'est utile pour s'assurer que
tous les fichiers attendus se trouvent dans le paquet Debian.
Si une liste de paquets est fournie en ligne de commande, alors seuls les
paquets Debian (
.deb ou
.udeb) dont les noms sont dans la liste
seront considérés.
Vérification du nom du répertoire¶
Comme plusieurs autres scripts du paquet
devscripts,
debc parcourt
une arborescence de répertoires jusqu'à trouver un fichier
debian/changelog. Pour éviter les problèmes posés par
les fichiers égarés, il examine le nom du répertoire parent une
fois qu'il a trouvé le fichier
debian/changelog, et vérifie
que le nom du répertoire correspond au nom du paquet. La méthode
précise utilisée est contrôlée par les deux variables du
fichier de configuration
DEVSCRIPTS_CHECK_DIRNAME_LEVEL et
DEVSCRIPTS_CHECK_DIRNAME_REGEX, et les options en ligne de commande
associées
--check-dirname-level et
--check-dirname-regex.
DEVSCRIPTS_CHECK_DIRNAME_LEVEL peut prendre les valeurs suivantes :
- 0
- Ne jamais vérifier le nom du répertoire.
- 1
- Ne vérifier le nom du répertoire que s'il a fallu
changer de répertoire pour trouver le fichier
debian/changelog. C'est le comportement par défaut.
- 2
- Toujours vérifier le nom du répertoire.
Le nom du répertoire est vérifié en testant si le nom du
répertoire courant (donné par
pwd(1)) correspond à
l'expression rationnelle donnée par la variable
DEVSCRIPTS_CHECK_DIRNAME_REGEX du fichier de configuration ou par
l'option
--check-dirname-regex regex. Il s'agit d'une expression
rationnelle Perl (voir
perlre(1)), qui sera ancrée à son
début et à sa fin. Si elle contient un « / »,
alors elle doit correspondre au chemin complet. Si elle contient la
chaîne « PACKAGE », cette chaîne sera
remplacée par le nom du paquet source déterminé par le journal
de modifications. La valeur par défaut de cette expression rationnelle
est « PACKAGE(-.+)? », ce qui correspond aux
répertoires nommés PACKAGE ou PACKAGE-version.
OPTIONS¶
- -aarchitecture-debian,
-ttype-de-système-GNU
- Veuillez consulter dpkg-architecture(1) pour une
description de ces options. Ces options affectent la recherche du fichier
.changes. Elles consistent à imiter le comportement de
dpkg-buildpackage lors de la détermination du nom du fichier
.changes.
- --debs-dir répertoire
- Chercher les fichiers .changes, .deb et
.udeb dans le répertoire au lieu du répertoire
parent du répertoire source. Cela doit être soit un chemin
absolu, soit un chemin relatif à la racine du répertoire
source.
- --check-dirname-level N
- Veuillez consulter la section Vérification du nom
du répertoire ci-dessus pour une explication de cette
option.
- --check-dirname-regex regex
- Veuillez consulter la section Vérification du nom
du répertoire ci-dessus pour une explication de cette
option.
- --no-conf, --noconf
- Ne lire aucun fichier de configuration. L'option ne peut
être utilisée qu'en première position de la ligne de
commande.
- --help, --version
- Afficher respectivement le message d'aide et la
version.
VARIABLES DE CONFIGURATION¶
Les deux fichiers de configuration
/etc/devscripts.conf et
~/.devscripts sont évalués dans cet ordre pour régler
les variables de configuration. Des options de ligne de commande peuvent
être utilisées pour écraser les paramètres des fichiers de
configuration. Les variables d'environnement sont ignorées à cette
fin. Les variables actuellement identifiées sont :
- DEBRELEASE_DEBS_DIR
- Indique le répertoire dans lequel chercher les
fichiers .changes, .deb et .udeb, et est soit un
chemin absolu, soit un chemin relatif à la racine du répertoire
racine. Cela correspond à l'option en ligne de commande
--debs-dir. Cette directive peut être utilisée par
exemple si vous utilisez systématiquement pbuilder ou
svn-buildpackage pour construire vos paquets. Notez que cela
concerne également debrelease(1), ce qui explique le nom
étrange de l'option.
- DEVSCRIPTS_CHECK_DIRNAME_LEVEL,
DEVSCRIPTS_CHECK_DIRNAME_REGEX
- Veuillez consulter la section Vérification du nom
du répertoire ci-dessus pour une explication de ces variables.
Notez que ce sont des variables de configuration pour tous les outils du
paquet devscripts ; elles impacteront tous les scripts qui les
utilisent, comme indiqué dans leurs pages de manuel respectives et
dans devscripts.conf(5).
VOIR AUSSI¶
dpkg-deb(1),
debdiff(1) et
devscripts.conf(5).
AUTEUR¶
Julian Gilbey <jdg@debian.org>, basé sur un script de Christoph
Lameter <clameter@debian.org>.
TRADUCTION¶
Ce document est une traduction, maintenue à l'aide de l'outil po4a <URL:
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone du projet Debian.
Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux et
David Prévot ont réalisé cette traduction.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. Veuillez signaler toute erreur de traduction
en écrivant à <
debian-l10n-french@lists.debian.org> ou
par un rapport de bogue sur le paquet devscripts.
La version anglaise la plus à jour de ce document est toujours consultable
en ajoutant l'option «
-L C » à la
commande
man.