DEBC
Section: User Commands (1)
Updated: Utilitaires Debian
Index
Return to Main Contents
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-changes
-
Lister le nom du fichier .changes et ne pas afficher autre chose. Cette
option n'a de sens que si aucun fichier .changes n'est fourni explicitement
sur la ligne de commande. Cela peut être utilisé par exemple dans un script
qui a besoin de référencer le fichier .changes, sans avoir à dupliquer les
heuristiques pour le trouver, ce que debc implémente déjà.
- --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.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.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- Vérification du nom du répertoire
-
- OPTIONS
-
- VARIABLES DE CONFIGURATION
-
- VOIR AUSSI
-
- AUTEUR
-
- TRADUCTION
-
This document was created by
man2html,
using the manual pages.
Time: 05:37:24 GMT, May 18, 2024