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.

The directory name is checked by testing whether the current directory name (as determined by pwd(1)) matches the regex given by the configuration file option DEVSCRIPTS_CHECK_DIRNAME_REGEX or by the command line option --check-dirname-regex regex. Here regex is a Perl regex (see perlre(3perl)), which will be anchored at the beginning and the end. If regex contains a '/', then it must match the full directory path. If not, then it must match the full directory name. If regex contains the string 'PACKAGE', this will be replaced by the source package name, as determined from the changelog. The default value for the regex is: 'PACKAGE(-.+)?', thus matching directory names such as PACKAGE and 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.

Plusieurs traducteurs dont Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux, David Prévot et Xavier Guimard ont contribué aux traductions.

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.