DEBDIFF(1) General Commands Manual DEBDIFF(1)
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 De-
bian, l’outil diffoscope 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 rempla-
cer les paramètres des fichiers de configuration.
Si deux paquets source (fichiers .dsc) sont fournis à debdiff, il com-
parera le contenu des paquets source. Si les paquets source ne dif-
fèrent que par leur numéro de version Debian (c'est-à-dire que les fi-
chiers .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éper-
toire 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 uti-
lisant cette option. Les deux arguments représentent les empla-
cements 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'argu-
ments --move : ils sont interprétés dans l'ordre d'apparition.
Cela affecte seulement les paquets binaires, pas les paquets
source.
--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 fonction-
nalité.
--control
Comparer les fichiers control respectifs, ce qui est le compor-
tement 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'ex-
ception de md5sums. Cette option peut être utilisée pour rempla-
cer 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 wdiff. C'est le comportement par défaut.
--wp, --wl, --wt
Passe respectivement les options -p, -l ou -t à wdiff (cela af-
fiche le wdiff complet, plutôt que juste les lignes modifiées).
--show-moved
Si plusieurs fichiers .deb sont fournis sur la ligne de com-
mande, 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 pa-
quets. 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é re-
nommé 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
Exclure les fichiers dont le nom de base correspond à l'expres-
sion. La pluralité d'emploi de cette option est possible. Noter
que cette option est passée à diff et a le même comportement,
ainsi seul le nom de base est considéré : en particulier, --ex-
clude='*.patch' fonctionnera mais --exclude='debian/patches/*'
n'aura pas d'effet en pratique.
--diffstat
Inclure le résultat de diffstat avant de produire le différen-
tiel.
--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.
--apply-patches
Si l'ancien et/ou le nouveau paquet est au format 3.0 (quilt),
applique les patchs quilt (et supprime .pc/) avant la comparai-
son.
--no-apply-patches, --noapply-patches
Si l'ancien et/ou le nouveau paquet est au format 3.0 (quilt),
n'applique les patchs quilt avant la comparaison. C'est le com-
portement par défaut.
--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.
--debs-dir répertoire
Chercher les fichiers .dsc dans le répertoire au lieu du réper-
toire parent du répertoire source. Cela doit être soit un chemin
absolu, soit un chemin relatif à la racine du répertoire source.
--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 ~/.devs-
cripts 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 pa-
ramè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 éva-
lué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 --nocon-
trol. La valeur par défaut est yes.
DEBDIFF_CONTROLFILES
Définit les fichiers control à comparer, correspondant à l'op-
tion 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 --diff-
stat 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-un-
pack-tarballs de la ligne de commande.
DEBDIFF_APPLY_PATCHES
Lui attribuer la valeur yes équivaut à utiliser le paramètre
--apply-patches de la ligne de commande. La valeur par défaut
est no.
DEBRELEASE_DEBS_DIR
Indiquer le répertoire dans lequel chercher les fichiers .dsc,
et est soit un chemin absolu ou un chemin relatif à la racine du
répertoire racine. Cela correspond à l'option en ligne de com-
mande --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 égale-
ment debrelease(1), ce qui explique le nom étrange de l'option.
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
debdiff-apply(1), diffstat(1), dpkg-deb(1), interdiff(1), wdiff(1),
devscripts.conf(5), diffoscope(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 logi-
ciel 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.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 consul-
table en ajoutant l'option « -L C » à la commande man.
DEBIAN Utilitaires Debian DEBDIFF(1)
Generated by dwww version 1.15 on Sat Jun 29 01:39:14 CEST 2024.