Ubuntu Manpage: debdiff - Comparer la liste des fichiers de deux paquets Debian

Provided by: devscripts_2.14.1ubuntu0.1_amd64

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.

Si aucun paramètre n'est donné, debdiff essaie de comparer le contenu du répertoire source
courant 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)

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
       <http://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.