NOM¶
debdiff - Comparer la liste des fichiers de deux paquets Debian
SYNOPSIS¶
debdiff [
options]
debdiff [
options] ...
deb1 deb2
debdiff [
options] ...
changes1 changes2
debdiff [
options] ...
--from deb1a deb1b ...
--to deb2a deb2b ...
debdiff [
options] ...
dsc1 dsc2
DESCRIPTION¶
debdiff prend en argument le nom de deux paquets Debian (fichiers
.deb ou
.udeb) et compare leur contenu (en comparant uniquement
les fichiers principaux, sans les scripts de maintenance). Il affiche quels
fichiers ont été ajoutés ou retirés entre deux
paquets. Il est de ce fait utile pour pointer les fichiers perdus par
inadvertance entre deux versions d'un paquet. Il vérifie
également les permissions et propriétaires des fichiers et
compare le fichier control des deux paquets à l'aide du programme
wdiff. Pour une comparaison plus précise de deux paquets Debian,
l’outil
debbindiff peut être utilisé.
Si aucun paramètre n'est donné,
debdiff essaie de comparer
le contenu du répertoire source actuel avec la dernière version
du paquet.
debdiff peut aussi gérer les changements entre des groupes de
fichiers
.deb de deux façons. La première consiste
à indiquer deux fichiers
.changes. Dans ce cas, les fichiers
.deb listés dans les fichiers
.changes seront
comparés, en considérant ensemble le contenu de tous les
fichiers
.deb. Il est supposé que les fichiers
.deb se
trouvent dans le même répertoire que le fichier
.changes.
La deuxième façon consiste à indiquer la liste de
fichiers
.deb avec la syntaxe
--from ... (depuis) et
--to
... (vers). On peut ainsi vérifier que, lorsqu'un paquet est
découpé en paquets plus petits, rien n'est perdu au passage.
debdiff examine les fichiers de configuration de
devscripts comme
décrit ci-dessous. Les options en ligne de commande permettent de
remplacer les paramètres des fichiers de configuration.
Si deux paquets source (fichiers
.dsc) sont fournis à
debdiff, il comparera le contenu des paquets source. Si les paquets
source ne diffèrent que par leur numéro de version Debian
(c'est-à-dire que les fichiers
.orig.tar.gz sont identiques dans
les deux fichiers
.dsc), alors
interdiff(1) sera utilisé
pour comparer les deux fichiers de rustine si ce programme est disponible sur
le système, sinon,
diff sera utilisé sur les deux
arborescences des sources.
OPTIONS¶
- --dirs, -d
- Le mode opératoire par défaut est d'ignorer les noms de
répertoire qui apparaissent dans la liste de fichiers ; mais
avec cette option, ils seront pris en compte.
- --nodirs
- Ignorer les répertoires dont le nom apparaît dans la liste
de fichiers. C'est le comportement par défaut. Cette option permet
de remplacer un paramètre d'un fichier de configuration.
- --move DEPUIS VERS, -m DEPUIS VERS
- Il arrive parfois que différents fichiers ou répertoires
soient déplacés entre deux versions. On peut régler
le problème en utilisant cette option. Les deux arguments
représentent les emplacements du répertoire ou du fichier
dans le premier et dans le second paquet. Quand les listes de fichiers
sont comparées, tous les fichiers de la première liste dont
le nom commence par le premier argument sont traités comme s'ils
commençaient par le second argument. Vous pouvez donner un nombre
arbitraire d'arguments --move : ils sont
interprétés dans l'ordre d'apparition.
- --move-regex DEPUIS VERS
- Identique à --move, mais DEPUIS est traité
comme une expression rationnelle et la commande de substitution
perl s/^DEPUIS/VERS/ est appliquée aux fichiers. En
particulier, VERS peut avoir des références arrières
telles que $1.
- --nocontrol
- debdiff compare normalement les deux fichiers control respectifs
avec wdiff(1). Cette option permet de désactiver cette
fonctionnalité.
- --control
- Comparer les fichiers control respectifs, ce qui est le
comportement par défaut. Cette option permet de remplacer un
paramètre d'un fichier de configuration.
- --controlfiles FICHIER[,FICHIER ...]
- Indiquer quels fichiers de contrôle comparer. Par défaut, il
s'agit juste de control, mais peut inclure postinst,
config, etc. Les fichiers ne seront comparés que s'ils sont
présents dans les deux fichiers .deb. La valeur
spéciale ALL compare tous les fichiers de contrôle
présents dans les deux paquets, à l'exception de md5sums.
Cette option peut être utilisée pour remplacer les
paramètres du fichier de configuration.
- --wdiff-source-control
- Lors du traitement des paquets source, comparer les fichiers de
contrôle avec wdiff. C'est équivalent à
l'option --control pour les paquets binaires.
- --no-wdiff-source-control
- Ne pas comparer les fichiers de contrôle des paquets source en
utilisant wdfiff. C'est le comportement par défaut.
- --wp, --wl, --wt
- Passe respectivement les options -p, -l ou -t
à wdiff (cela affiche le wdiff complet, plutôt
que juste les lignes modifiées).
- --show-moved
- Si plusieurs fichiers .deb sont fournis sur la ligne de commande,
que la syntaxe utilisée soit des fichiers .changes soit la
syntaxe --from/--to, alors cette option affichera
également les fichiers (s'il y en a) qui ont été
déplacés entre deux paquets. Les noms des paquets sont
simplement déterminés par les noms des fichiers
.deb.
- --noshow-moved
- Le comportement par défaut ; cette option permet de
remplacer les paramètres d'un fichier de configuration.
- --renamed DEPUIS VERS
- Si l'option --show-moved est utilisée et qu'un paquet a
été renommé au cours du processus, cette commande
indique à debdiff de traiter le paquet de la première
liste appelé DEPUIS comme s'il s'appelait VERS. Cette
option peut être utilisée plusieurs fois.
- --exclude MOTIF
- Exclut les fichiers correspondant au MOTIF. Une utilisation
multiple de cette option est possible.
- --diffstat
- Inclure le résultat de diffstat avant de produire le
différentiel.
- --no-diffstat
- Le comportement par défaut ; cette option permet de
remplacer les paramètres d'un fichier de configuration.
- --auto-ver-sort
- Lors de la comparaison de paquets source, comparer dans l'ordre des
versions.
- --no-auto-ver-sort
- Comparer les paquets source dans l'ordre où ils ont
été fournis sur la ligne de commande, même si cela
force la comparaison entre un paquet avec une version supérieure et
un paquet avec une version inférieure. C'est le comportement par
défaut.
- --unpack-tarballs
- Lors de la comparaison des paquets source, ouvrir également les
archives tar trouvées dans la racine des sources pour comparer
leurs contenus en même temps que les autres fichiers. Il s'agit du
comportement par défaut.
- --no-unpack-tarballs
- Ne pas ouvrir les archives tar se trouvant dans les paquets source.
- --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, -h
- Afficher un résumé des options.
- --version, -v
- Affiche la version et le copyright.
- --quiet, -q
- Rester silencieux si aucune différence n'est trouvée.
- --ignore-space, -w
- Ignorer les blancs dans les diffs.
VARIABLES DE CONFIGURATION¶
Les deux fichiers de configuration
/etc/devscripts.conf et
~/.devscripts sont évalués dans cet ordre par un
interpréteur de commandes (« shell ») pour
placer les variables de configuration. Des options de ligne de commande
peuvent être utilisées pour neutraliser les paramètres
des fichiers de configuration. Les paramètres des variables
d'environnement sont ignorés à cette fin. Si la première
option donnée en ligne de commande est
--noconf, alors ces
fichiers ne sont pas évalués. Les variables actuellement
identifiées sont :
- DEBDIFF_DIRS
- Lui attribuer la valeur yes équivaut à utiliser
l'option --dirs.
- DEBDIFF_CONTROL
- Lui attribuer la valeur no équivaut à utiliser
l'option --nocontrol. La valeur par défaut est
yes.
- DEBDIFF_CONTROLFILES
- Définit les fichiers control à comparer, correspondant
à l'option en ligne de commande --controlfiles. La valeur
par défaut est control.
- DEBDIFF_SHOW_MOVED
- Lui attribuer la valeur yes équivaut à utiliser
l'option --show-moved.
- DEBDIFF_WDIFF_OPT
- Cette option est passée à wdiff ; les valeurs
possibles sont -p, -l ou -t.
- DEBDIFF_SHOW_DIFFSTAT
- Lui attribuer la valeur yes équivaut à utiliser
l'option --diffstat de la ligne de commande.
- DEBDIFF_WDIFF_SOURCE_CONTROL
- Lui attribuer la valeur yes équivaut à utiliser
l'option --wdiff-source-control de la ligne de commande.
- DEBDIFF_AUTO_VER_SORT
- Lui attribuer la valeur yes équivaut à utiliser
l'option --auto-ver-sort de la ligne de commande.
- DEBDIFF_UNPACK_TARBALLS
- Lui attribuer la valeur no équivaut à utiliser
l'option --no-unpack-tarballs de la ligne de commande.
VALEURS DE RETOUR¶
Normalement, la valeur de retour est 0 si aucune différence n'a
été trouvée et 1 en cas de différence. Dans le cas
d'une erreur fatale, la valeur de retour sera 255.
VOIR AUSSI¶
diffstat(1),
dpkg-deb(1),
interdiff(1),
wdiff(1),
devscripts.conf(5),
debbindiff(1)
AUTEUR¶
debdiff a été initialement écrit sous forme de
script shell par Yann Dirson <dirson@debian.org> et a été
réécrit en Perl avec beaucoup plus de fonctionnalités par
Julian Gilbey <jdg@debian.org>. C'est un logiciel libre qui peut
être redistribué suivant les termes de la licence publique
générale GNU, version 2.
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.