NOM¶
debc - Visualiser le contenu d'un paquet Debian créé
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 produits. 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 ou
.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 actuel (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 expression_rationnelle. 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, sinon elle doit correspondre au nom de répertoire 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.
- --list-debs
- Lister les noms de fichier des paquets .deb et ne pas afficher leur
contenu.
- --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. Remarquez 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.
Remarquez 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¶
debdiff(1),
dpkg-deb(1),
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 <
https://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.