Provided by: dpkg-dev_1.19.7ubuntu3.2_all 
NOM
dpkg-source - Outil de manipulation des paquets sources Debian (.dsc).
SYNOPSIS
dpkg-source [option...] commande
DESCRIPTION
dpkg-source empaquette ou dépaquette une archive source Debian.
Aucune de ces commandes ne permet la combinaison de plusieurs options en une seule et
elles ne permettent pas d'indiquer la valeur d'une option dans un argument séparé.
COMMANDES
-x , --extract nom-de-fichier.dsc [répertoire-de-sortie]
Cette option sert à extraire un paquet source (--extract depuis dpkg 1.17.14). Un
seul argument sans option doit être donné : le nom du fichier de contrôle des
sources Debian (.dsc). Un deuxième argument sans option peut également être donné
pour indiquer le répertoire où extraire le paquet source : ce répertoire ne doit
pas déjà exister. Quand aucun répertoire n'est indiqué, le paquet source est
extrait dans un répertoire source-version du répertoire courant.
dpkg-source lit, dans le fichier de contrôle, les noms des fichiers qui composent
le paquet source ; il suppose qu'ils sont dans le même répertoire que le fichier
.dsc.
Les fichiers extraits du paquet auront leurs propriétaires et permissions définis à
ceux attendus s'ils avaient été simplement créés. Les répertoires et les fichiers
exécutables auront une permission égale à 0777 et les simples fichiers à 0666, les
deux étant modifiées par le masque (umask) de celui qui fait l'extraction. Si le
répertoire parent est « setgid », les répertoires extraits le seront aussi et tous
les fichiers et répertoires hériteront de sa propriété de groupe.
Si le paquet source utilise un format non standard (actuellement, cela signifie
tous les formats sauf le « 1.0 »), son nom sera enregistré dans
debian/source/format de sorte que la construction du paquet source utilise le même
format par défaut.
-b, --build répertoire [paramètres-dans-un-format-spécifique]
Construit un paquet source (--build depuis dpkg 1.17.14). Le premier argument sans
option est pris comme nom du répertoire contenant l'arborescence des sources
debianisée (c'est-à-dire avec un sous-répertoire debian et peut-être des
modifications sur les fichiers d'origine). Selon le format du paquet source utilisé
pour construire le paquet, d'autres paramètres peuvent être acceptés.
dpkg-source va construire le paquet source dans le premier format trouvé dans la
liste suivante : le(s) format(s) indiqué(s) avec le paramètre de la ligne de
commande --format, le format indiqué dans debian/source/format, « 1.0 ».
L'utilisation de « 1.0 » comme dernier recours est obsolète et sera retirée dans le
futur. Le format source devrait toujours être indiqué dans debian/source/format.
Voir la section FORMATS DE PAQUET SOURCE pour une description plus détaillée des
différents formats de paquet source.
--print-format répertoire
Affiche le format source qui serait utilisé pour construire le paquet source si
dpkg-source --build répertoire était utilisé (dans les mêmes conditions et avec les
mêmes options ; depuis dpkg 1.15.5).
--before-build répertoire
Exécute le point d'entrée correspondant du format de paquet source (depuis
dpkg 1.15.8). Ce point d'entrée doit être utilisé avant toute construction du
paquet (dpkg-buildpackage l'utilise très tôt, avant même debian/rules clean). Cette
commande est idempotente et peut être lancée plusieurs fois. Tous les formats
source ne mettent pas en œuvre ce branchement et ceux qui le font préparent
l'arborescence source pour la construction, par exemple en garantissant que les
correctifs Debian sont appliqués.
--after-build répertoire
Exécute le point d'entrée correspondant du format de paquet source (depuis
dpkg 1.15.8). Ce point d'entrée doit être utilisé après toute construction du
paquet (dpkg-buildpackage l'utilise en dernier). Cette commande est idempotente et
peut être lancée plusieurs fois. Tous les formats source ne mettent pas en œuvre ce
branchement et ceux qui le font s'en servent pour défaire ce qui a été fait par
--before-build.
--commit [répertoire] ...
Enregistre les modifications dans l'arborescence source décompressée dans
répertoire (depuis dpkg 1.16.1). Cette commande peut accepter des paramètres
supplémentaires selon le format source. Elle provoquera une erreur pour les formats
où cette opération n'a pas de signification.
-?, --help
Affiche un message d'aide puis quitte. Les options de construction et d'extraction
spécifiques au format peuvent être montrées avec l'option --format.
--version
Affiche le numéro de version puis quitte.
OPTIONS
Options de construction générique
-cfichier-de-contrôle
Indique le principal fichier de contrôle des sources où trouver les renseignements.
Par défaut, c'est le fichier debian/control. Lorsqu'un chemin relatif est fourni,
on considère qu'il est relatif au répertoire le plus élevé de l'arborescence
source.
-lfichier-des-changements
Indique le journal des modifications où trouver des renseignements. Par défaut,
c'est le fichier debian/changelog. Lorsqu'un chemin relatif est fourni, on
considère qu'il est relatif au répertoire le plus élevé de l'arborescence source.
-Fformat-du-fichier-des-changements
Indique le format du fichier des changements. Voir dpkg-parsechangelog(1) pour plus
d'informations à propos des formats gérés.
--format=valeur
Utilise le format indiqué pour la construction du paquet source (depuis
dpkg 1.14.17). Ce choix remplace le format indiqué dans debian/source/format.
-Vnom=valeur
Fixe la valeur d'une variable de substitution. Consultez deb-substvars(5) pour une
discussion sur la valeur de substitution.
-Tfichier-substvars
Lit les variables de substitution dans fichier-substvars ; par défaut aucun fichier
n'est lu. Cette option peut être utilisée plusieurs fois pour lire des variables de
substitution depuis plusieurs fichiers (depuis dpkg 1.15.6).
-Dchamp=valeur
Remplace ou ajoute en sortie un champ dans le fichier de contrôle.
-Uchamp
Supprime en sortie un champ dans le fichier de contrôle.
-Zcompression, --compression=compression
Spécifie le niveau de compression à utiliser pour les fichiers archive et diff
créés (--compression depuis dpkg 1.15.5). Notez que cette option ne causera pas la
recompression des archives existantes, cela ne concerne que les nouveaux fichiers.
Les valeurs acceptées sont les suivantes : gzip, bzip2, lzma et xz. L'option par
défaut est xz pour les formats 2.0 et plus récents, et gzip pour le format 1.0. xz
n'est géré que depuis dpkg 1.15.5.
-zniveau, --compression-level=niveau
Niveau de compression à utiliser (--compression-level depuis dpkg 1.15.5). Comme
avec -Z cela ne concerne que les fichiers nouvellement créés. Les valeurs prises
possibles sont les suivantes : 1 à 9, best et fast. La valeur par défaut est 9 pour
gzip et bzip2, 6 pour xz et lzma.
-i[expression-rationnelle], --diff-ignore[=expression-rationnelle]
Il est possible de donner une expression rationnelle Perl pour filtrer les fichiers
qui doivent être éliminés de la liste des fichiers pour le « diff » (--diff-ignore
depuis dpkg 1.15.6). Cette liste est créée avec une commande « find ». Si le
fichier source en construction est un fichier source de version 3 utilisant un
système de suivi de versions, cette option est utile pour ignorer les modifications
non envoyées. Utiliser -i.* les ignorera toutes.
L'option -i active cette fonction avec une expression rationnelle par défaut (en
préservant toutes les modifications faites avec l'expression rationnelle par défaut
par une utilisation précédente de --extend-diff-ignore) qui couvre les fichiers de
contrôle des plus usuels systèmes de gestion de version, les fichiers de
sauvegarde, les fichiers d'échange et les répertoires utilisés par Libtool. Il ne
peut y avoir qu'une seule expression rationnelle active ; avec de multiples options
-i, seule la dernière mentionnée sera prise en compte.
C'est très utile pour supprimer des fichiers qui sont inclus dans le diff, par
exemple, si vous maintenez un source avec un système de contrôle de version et que
voulez construire un paquet source sans inclure des fichiers et répertoires
additionnels qu'il contient généralement (par exemple CVS/, .cvsignore, .svn/).
L'expression rationnelle par défaut est déjà très exhaustive, mais si avez besoin
de la remplacer, veuillez noter que par défaut, il sait vérifier n'importe quelle
partie d'un chemin, donc si vous voulez trouver le début d'un nom de fichier ou des
noms de fichiers complets, vous devrez fournir les caractères spéciaux vous-même
(par exemple « (^|/) », « ($|/) »).
--extend-diff-ignore=expression-rationnelle
L'expression rationnelle Perl indiquée complétera la valeur par défaut utilisée par
--diff-ignore et sa valeur courante si elle est définie (depuis dpkg 1.15.6). Cela
est effectué en concaténant « |expression-rationnelle » à la valeur existante.
Cette option est pratique dans debian/source/options pour exclure certains fichiers
auto-créés de la création automatique de correctifs.
-I[motif-fichier], --tar-ignore[=motif-fichier]
Avec cette option, le fichier est passé à l'option --exclude de tar(1) quand on
veut créer un fichier .orig.tar ou .tar (--tar-ignore depuis dpkg 1.15.6). Par
exemple, -ICVS fera que tar sautera les répertoires du CVS quand il doit créer un
fichier .tar.gz. On peut répéter cette option pour exclure à partir de plusieurs
motifs.
-I ajoute par défaut des options --exclude qui élimineront les fichiers et les
répertoires de contrôles des systèmes les plus connus de contrôle de version, les
fichiers d'échange et de sauvegarde et les répertoires utilisés par Libtool.
Note : même si elles ont des rôles similaires, -i et -I ont une syntaxe et une sémantique
très différentes. -i ne peut être spécifié qu'une fois et reçoit une expression
rationnelle compatible avec le langage Perl qui est appliquée sur chaque chemin relatif
complet de chaque fichier. -I peut être spécifié plusieurs fois et prend un motif de nom
de fichier avec les méta-caractères du shell. Le motif est appliqué au chemin relatif
complet mais aussi à chaque partie du chemin individuellement. La sémantique exacte de
l'option --exclude de tar est un peu compliquée, voir
https://www.gnu.org/software/tar/manuel/tar.html#wildcards pour une documentation plus
complète.
L'expression rationnelle et le motif par défaut pour les deux options peuvent être trouvés
dans la sortie de la commande --help.
Options d'extraction génériques
--no-copy
Ne copie pas l'archive d'origine à côté de l'extraction du paquet source (depuis
dpkg 1.14.17).
--no-check
Ne vérifie pas les signatures et les sommes de contrôle avant de dépaqueter(depuis
dpkg 1.14.17).
--no-overwrite-dir
Ne pas remplacer le répertoire d'extraction s'il existe déjà (depuis dpkg 1.18.8)
--require-valid-signature
Refuse de décompresser le paquet source s'il ne contient pas de signature OpenPGP
pouvant être vérifiée (depuis dpkg 1.15.0) soit avec le fichier de clés
trustedkeys.gpg de l'utilisateur, un des fichiers de clés propre à un distributeur
ou un des fichiers de clés officiels de Debian
(/usr/share/keyrings/debian-keyring.gpg et
/usr/share/keyrings/debian-maintainers.gpg).
--require-strong-checksums
Refuse de décompresser le paquet source s'il ne contient pas de somme de contrôle
robuste (depuis dpkg 1.18.7). Actuellement, SHA-256 est le seul type de somme de
contrôle considéré comme robuste.
--ignore-bad-version
Transforme la vérification des mauvaises versions des paquets source en
avertissement non fatal (since dpkg 1.17.7). Cette option sera seulement nécessaire
quand on extrait des anciens paquets source avec des versions cassées, pour
préserver la compatibilité avec les versions précédentes.
FORMATS DE PAQUET SOURCE
Si vous ne savez pas quel format source utiliser, il est conseillé de choisir soit « 3.0
(quilt) » soit « 3.0 (native) ». Voir https://wiki.debian.org/Projects/DebSrc3.0 pour plus
d'informations sur la mise en œuvre de ces formats dans Debian.
Format : 1.0
Un paquet source dans ce format se compose soit d'un .orig.tar.gz associé à un .diff.gz ou
un simple .tar.gz (dans ce cas, le paquet est appelé natif native). L'archive tar
originale pourrait être accompagnée de façon facultative d'une signature amont séparée
.orig.tar.gz.asc, extraction prise en charge depuis dpkg 1.18.5.
Extraction
Extraire un paquet natif revient à une simple extraction de l'archive tar dans le
répertoire cible. L'extraction d'un paquet non natif consiste au dépaquetage du
.orig.tar.gz puis l'application des correctifs contenus dans le .diff.gz. La date de tous
les fichiers correctifs est réglée à celle du moment de l'extraction depuis le paquet
source (cela évite les horodatages faux menant à des problèmes lorsque des fichiers
générés automatiquement sont modifiés). Le diff peut créer de nouveaux fichiers (tout le
répertoire debian est créé de cette façon) mais ne peut pas supprimer de fichiers (les
fichiers vides seront laissés là).
Construction
Construire un paquet natif revient simplement à créer une archive tar avec le répertoire
du source. La création d'un paquet non natif consiste à extraire l'archive d'origine dans
un répertoire séparé « .orig » puis à régénérer le .diff.gz en comparant le répertoire du
paquet source avec le répertoire « .orig ».
Options de construction (avec --build) :
Si l'on donne un second argument, ce sera le nom du répertoire source d'origine ou le nom
du fichier tar ou bien une chaîne vide si le paquet est un « Debian pure souche » et n'a
donc pas de fichiers « diffs » pour sa « debianisation ». S'il n'y a pas de second
argument, dpkg-source cherche le fichier tar des sources d'origine
paquet_version-amont.orig.tar.gz ou bien le répertoire source d'origine répertoire.orig
selon les paramètres -sX.
Les options -sa, -sp, -sk, -su et -sr ne remplacent pas les fichiers tar ou les
répertoires existants. Pour cela, il faut utiliser les options -sA, -sP, -sK, -sU et -sR.
-sk Spécifie que le source d'origine est attendu sous forme tar ; par défaut,
paquet_version-amont.orig.tarextension. Il le laisse en place en tant que fichier
tar ou le copie dans le répertoire en cours s'il n'y est pas déjà. Le fichier sera
dépaqueté dans répertoire.orig pour la génération du fichier diff.
-sp Comme -sk mais supprimera le répertoire à nouveau par la suite.
-su Quand on spécifie que le source d'origine est un répertoire ; la valeur par défaut
est le répertoire paquet-version-amont.orig et dpkg-source crée une nouvelle
archive du source d'origine.
-sr Comme -su mais supprimera ce répertoire après utilisation.
-ss Indique que le source d'origine est disponible à la fois comme un répertoire et
comme un fichier tar. dpkg-source se servira du répertoire pour créer le « diff »,
mais du fichier tar pour créer le fichier .dsc. Aussi, faire attention avec cette
option. Si le répertoire et le fichier tar ne correspondent pas, il en résulte une
mauvaise archive source.
-sn Indique de ne pas chercher de source d'origine et de ne pas créer de « diff ». Le
second argument, s'il existe, doit être une chaîne vide. Cela sert pour les paquets
Debian pure souche qui n'ont pas un source d'origine distincte et donc pas de
fichier « diff » de debianisation.
-sa or -sA
Indique comme source d'origine soit un fichier tar, soit un répertoire — le
deuxième argument, s'il existe, doit être l'un d'eux ou bien une chaîne vide (cela
revient à utiliser l'option -sn). Quand un fichier tar existe, il est dépaqueté
pour créer le fichier « diff » ; ensuite il est supprimé (cela revient à utiliser
l'option -sp) ; quand un répertoire est trouvé, il est empaqueté et dpkg-source
crée le source d'origine et supprime ensuite ce répertoire (cela revient à utiliser
l'option -sr) ; quand ni l'un ni l'autre n'est trouvé, dpkg-source suppose que le
paquet ne possède pas de fichier « diff » de debianisation, mais seulement une
simple archive source (cela revient à utiliser l'option -sn). Quand les deux sont
trouvés, dpkg-source ignore le répertoire et le remplace si l'option -sA a été
spécifiée (cela revient à utiliser l'option -sP) ou il provoque une erreur si
l'option -sa a été spécifiée. L'option par défaut est -sa.
--abort-on-upstream-changes
Ce processus échoue si le fichier de différences contient des modifications
apportées à des fichiers en dehors du sous-répertoire debian (depuis dpkg 1.15.8).
Cette option n'est pas autorisée dans debian/source/options mais peut être utilisée
dans debian/source/local-options.
options d'extraction (avec --extract) :
Dans tous ces cas, l'arborescence existante des sources d'origine est supprimée.
-sp Quand on extrait le répertoire source d'origine (s'il existe), il est conservé en
tant que fichier tar. S'il n'est pas déjà dans le répertoire courant ou si ce
répertoire contient un fichier différent, le fichier tar est copié dans ce
répertoire. (Cela est le comportement par défaut).
-su Dépaquetage de l'arborescence du répertoire source d'origine.
-sn Assure que le répertoire source d'origine ne sera ni copié dans le répertoire en
cours, ni dépaqueté. Si une arborescence source d'origine est présente dans le
répertoire courant, elle est toujours supprimée.
Toutes les options -sX s'excluent mutuellement. Si vous en indiquez plusieurs, seule la
dernière sera prise en compte.
--skip-debianization
Passe l'étape d'application du fichier de différences Debian aux sources amont
(depuis dpkg 1.15.1).
Format : 2.0
Extraction prise en charge depuis dpkg 1.13.9, construction depuis dpkg 1.14.8. Aussi
connu sous le nom de « wig&pen ». Ce format n'est pas recommandé pour une utilisation
massive, le format « 3.0 (quilt) » le remplace. Wig&pen a été la première spécification
d'une nouvelle génération de format de paquet source.
Le comportement de ce format est le même que pour le format « 3.0 (quilt) » sauf qu'il
n'utilise pas de liste explicite de correctifs. Tous les fichiers dans debian/patches/
correspondant à l'expression rationnelle Perl [\w-]+ doivent être des correctifs
valables : ils sont appliqués au moment de l'extraction.
Lors de la construction d'un nouveau paquet source, toute modification apportée au source
amont est enregistrée dans un correctif nommé zz_debian-diff-auto.
Format : 3.0 (native)
Pris en charge depuis dpkg 1.14.17. Ce format est une extension du format de paquet natif
tel que défini dans le format 1.0. Il gère toutes les méthodes de compression et ignore
par défaut tout fichier et répertoire spécifique à VCS ainsi que de nombreux fichiers
temporaires (voir la valeur par défaut associée à l'option -I dans la sortie de --help).
Format : 3.0 (quilt)
Pris en charge depuis 1.14.17. Un paquet source dans ce format contient au moins une
archive tar d'origine (.orig.tar.ext où ext peut être gz, bz2 lzma et xz) et une archive
tar debian (.debian.tar.ext). Il peut également contenir d'autres archives tar d'origine
(.orig-composant.tar.ext). composant ne peut être constitué que de caractères
alphanumériques (« a-zA-Z0-9 ») et de tirets (« - »). Chaque archive tar originale peut
être accompagnée de façon facultative d'une signature amont séparée (.orig.tar.ext.asc et
.orig-composant.tar.ext.asc), extraction prise en charge depuis dpkg 1.17.20, construction
depuis dpkg 1.18.5.
Extraction
L'archive principale tar d'origine est extraite tout d'abord, puis toutes les autres
archives tar d'origine sont extraites dans des sous-répertoires dont le nom est formé à
partir de la partie composant de leur nom. L'archive tar Debian est extraite du répertoire
source, après la suppression de tout répertoire debian existant. Notez que l'archive tar
Debian doit contenir un sous-répertoire debian, mais elle peut également contenir des
fichiers binaires en dehors de ce répertoire (voir l'option --include-binaries).
Toutes les modifications figurant dans debian/patches/distributeur.series ou
debian/patches/series sont alors appliquées, où distributeur sera le nom en minuscules du
distributeur actuel, ou Debian s'il n'y a pas de distributeur défini. Si l'ancien fichier
est utilisé et qu'il n'y en a pas de plus récent (ou si c'est un lien symbolique), alors
celui-ci est remplacé par un lien symbolique vers l'ancien. Cette disposition vise à
simplifier l'utilisation de quilt pour gérer l'ensemble des correctifs. Les fichiers de
séries propres au distributeur sont destinés à permettre de sérialiser plusieurs branches
de développement en se basant sur le distributeur, d'une manière déclarative, de
préférence au codage ouvert de cette gestion dans debian/rules. Cela est particulièrement
utile quand le source à besoin de correctifs de manière conditionnelle car les fichiers
affectés n’ont pas de gestion interne d’inclusion conditionnelle. Notez toutefois que si
dpkg-source analyse correctement les fichiers de séries avec les options utilisées pour
l'application du correctif (stockées sur chaque ligne après le nom du correctif et une ou
plusieurs espaces), il n'ignore pas ces options et s'attendra toujours à ce que les
correctifs puissent être appliqués avec l'option -p1 de patch. Il va donc émettre un
avertissement lorsqu'il rencontrera ces options, et la construction est susceptible
d'échouer.
Notez que lintian(1) émettra des avertissements sans condition lors de l'utilisation de
séries de distributeur du fait d'une règle controversée particulière de Debian qui ne
devrait pas affecter une utilisation externe ; pour les faire taire, le profil lintian de
dpkg peut être utilisé en passant l'option «--profile dpkg» à lintian(1).
La date de tous les fichiers correctifs est celle du moment où se déroule l'extraction du
paquet source (cela évite les horodatages faux menant à des problèmes lorsque des fichiers
générés automatiquement sont modifiés).
Au contraire du comportement par défaut de quilt, les correctifs doivent s'appliquer sans
décalage (« fuzz »). Quand cela n'est pas le cas, il est suggéré de les rafraîchir avec
quilt sinon dpkg-source se terminera avec une erreur en tentant de les appliquer.
Similaire au comportement par défaut de quilt, les modifications peuvent aussi supprimer
des fichiers.
Le fichier .pc/applied-patches est créé si certains correctifs ont été appliqués au cours
de l'extraction.
Construction
Les originaux de toutes les archives tar trouvées dans le répertoire courant sont extraits
dans un répertoire temporaire en suivant la même logique que pour le dépaquetage, le
répertoire debian est copié dans le répertoire temporaire, et tous les correctifs excepté
le correctif automatique debian-changes-version ou debian-changes, selon
--single-debian-patch) sont appliquées. Le répertoire temporaire est comparé à celui du
paquet source. Si le fichier de différences n'est pas vide, la construction échoue à moins
que --single-debian-patch ou --auto-commit aient été utilisés, et dans ce cas le diff est
stocké dans le correctif automatique. Si le correctif automatique est créé ou supprimé, il
est ajouté ou supprimé dans le fichier « series » et les métadonnées de quilt.
Tout changement dans un fichier binaire ne peut être indiqué dans le diff et va déboucher
sur un échec à moins que le responsable ne décide délibérément d'inclure cette
modification binaire dans l'archive tar Debian (en le listant dans
debian/source/include-binaries). La construction pourra également échouer si des fichiers
binaires sont trouvés dans le sous-répertoire debian sans être indiqué dans la liste
blanche de debian/source/include-binaries.
Le répertoire debian mis à jour et la liste des binaires modifiés sont ensuite utilisés
pour recréer l'archive tar debian.
Le diff généré automatiquement n'inclut pas les changements spécifiques sur les fichiers
VCS ainsi sur que de nombreux fichiers temporaires (pour la valeur par défaut associée à
l'option -i, voir la sortie de --help). En particulier, le répertoire .pc utilisé par
quilt est ignoré lors de la génération automatique du correctif.
Note : dpkg-source --before-build (et --build) prendront soin d'appliquer les correctifs
indiqués dans le fichier series afin qu'un paquet soit toujours construit avec toutes les
corrections appliquées. Pour effectuer cette détection, il recherche la liste des
correctifs non appliqués (ils sont mentionnés dans le fichier series mais pas dans
.pc/applied-patches) et si le premier de cette liste peut être appliqué sans erreur, il
les applique tous. L'option --no-preparation peut être utilisée pour désactiver ce
comportement.
Enregistrement des modifications
--commit [répertoire] [nom-du-correctif] [fichier-de-correctif]
Crée un correctif correspondant aux modifications locales non gérées par le système
de gestion de correctifs quilt et les intègre dans la liste des correctifs sous le
nom nom-du-correctif. Si le nom est omis, il sera demandé interactivement. Si
fichier-de-correctifs est indiqué, il est utilisé comme fichier de modifications
locales à intégrer. Une fois intégré, un éditeur est lancé afin de permettre
d'ajouter des méta-informations dans l'en-tête du correctif.
Le fait de passer fichier-de-correctifs est essentiellement utile après un échec de
construction qui prégénère ce fichier. Sur ces bases, le fichier est supprimé après
intégration. Veuillez également noter que les modifications contenues dans le
fichier de correctifs doivent déjà être appliquées dans l'arborescence et que les
fichiers modifiés par le correctif ne doivent pas comporter de modifications
supplémentaires.
Si la création de correctif détecte des fichiers binaires modifiés, ils seront
ajoutés automatiquement à debian/source/include-binaries afin de pouvoir être
inclus dans l'archive debian (de façon analogue à ce que ferait dpkg-source
--include-binaries --build).
Options de construction
--allow-version-of-quilt-db=version
Autorise dpkg-source à construire le fichier si la version des métadonnées de quilt
est celle indiquée, même si dpkg-source n'en n'a pas connaissance (depuis
dpkg 1.15.5.4). En fait, cela indique que la version indiquée des métadonnées de
quilt est compatible avec la version 2 que dpkg-source gère. La version des
métadonnées de quilt est conservée dans .pc/.version.
--include-removal
N'ignore pas les fichiers supprimés et les inclut dans le fichier de modifications
généré automatiquement.
--include-timestamp
Inclut la date dans le correctif généré automatiquement.
--include-binaries
Ajoute tous les binaires modifiés dans l'archive tar debian. Les ajoute aussi à
debian/source/include-binaries : elles seront ajoutées par défaut dans les
constructions suivantes aussi cette option n'est donc plus nécessaire.
--no-preparation
N'essaye pas de préparer l'arbre de la construction en appliquant les correctifs
qui ne sont apparemment pas appliqués (depuis dpkg 1.14.8).
--single-debian-patch
Utilise debian/patches/debian-changes au lieu de
debian/patches/debian-changes-version comme nom du correctif automatique créé au
cours de la construction (depuis dpkg 1.15.5.4). Cette option est particulièrement
pratique lorsque le paquet est géré avec un outil de gestion de versions et qu'un
jeu de correctifs ne peut être créé de façon fiable. Dans ce cas, les différences
avec la version amont doivent être conservées dans un correctif unique. Cette
option serait indiquée dans debian/source/local-options et accompagnée par un
fichier debian/source/local-patch-header qui explique la meilleure méthode pour
revoir les corrections spécifiques à Debian, par exemple dans le gestionnaire de
versions utilisé.
--create-empty-orig
Crée automatiquement l'archive principale tar d'origine vide si elle est manquante
et qu'il existe des archives tar d'origine additionnelles (depuis dpkg 1.15.6).
Cette option peut être utilisée lorsque le paquet source est une collection de
différents sources amont et qu'il n'existe pas de logiciel « principal ».
--no-unapply-patches, --unapply-patches
Par défaut, dpkg-source retire automatiquement les correctifs dans le point
d'entrée --after-build s'ils ont été appliqués pendant --before-build
(--unapply-patches depuis dpkg 1.15.8, --no-unapply-patches depuis dpkg 1.16.5).
Ces options permettent de désactiver ou activer unilatéralement ce retrait des
correctifs. Elles ne sont permises que dans debian/source/local-options afin que
tous les paquets source créés aient le même comportement par défaut.
--abort-on-upstream-changes
Ce processus échouera si un correctif automatique a été créé (depuis dpkg 1.15.8).
Cette option peut servir à vérifier que toutes les modifications ont été
enregistrées correctement dans des correctifs quilt distincts avant la construction
du paquet source. Elle n'est pas autorisée dans debian/source/options mais peut
prendre place dans debian/source/local-options.
--auto-commit
Pas d'échec du processus de construction si un correctif automatique a été créé :
il est enregistré automatiquement dans le fichier series de quilt.
Options d'extraction
--skip-debianization
Passe l'étape d'extraction de l'archive tar debian des sources amont (depuis
dpkg 1.15.1).
--skip-patches
Ne pas appliquer des correctifs à la fin de l'extraction (depuis dpkg 1.14.18).
Format : 3.0 (custom)
Pris en charge depuis dpkg 1.14.17. Ce format est particulier. Il ne représente pas un
réel format de paquet source mais peut être utilisé pour créer des paquets sources avec
des fichiers arbitraires.
Options de construction
Tous les arguments qui ne sont pas des options sont pris pour des fichiers à intégrer dans
le paquet source généré. Ils doivent exister et être de préférence dans le répertoire
courant. Au moins un fichier doit être donné.
--target-format=valeur
Required. Définit le format réel du paquet source généré. Le fichier généré .dsc
contiendra cette valeur dans son champ format et non « 3.0 (custom) ».
Format : 3.0 (git)
Pris en charge depuis dpkg 1.14.17. Ce format est expérimental.
Un paquet source qui utilise ce format est constitué d'un seul ensemble d'un dépôt git
.git qui contient les sources du paquet. Il peut également exister un fichier .gitshallow
qui donne les révisions d'un clone git « shallow ».
Extraction
Cet ensemble est cloné sous forme d'un dépôt git dans le répertoire cible. S'il existe un
fichier .gitshallow, il est installé en tant que .git/shallow dans le dépôt git cloné.
Veuillez noter que, par défaut, le nouveau dépôt aura la même branche récupérée que celle
qui était récupérée dans les sources d'origine (souvent « master » mais cela peut être
tout à fait autre chose). Toutes les autres branches seront disponibles sous
remotes/origin.
Construction
Avant d'aller plus loin, quelques vérifications sont effectuées afin de s'assurer qu'il
n'existe aucun changement non ignoré non soumis.
git-bundle(1) permet de créer un ensemble à partir du dépôt git. Par défaut, toutes les
branches et étiquettes du dépôt sont incluses dans cet ensemble.
Options de construction
--git-ref=réf
Permet d'indiquer une référence git à inclure dans l'ensemble git. L'utilisation de
cette option désactive le comportement par défaut qui est d'inclure toutes les
branches et étiquettes. Cette option peut être utilisée plusieurs fois. Le
paramètre réf peut être le nom d'une branche ou une étiquette à inclure. Il peut
également être tout paramètre que l'on peut passer à git-rev-list(1). Par exemple,
pour n'inclure que la branche « master », on peut utiliser --git-ref=master. Pour
inclure toutes les étiquettes et toutes les branches, sauf la branche privée, on
peut utiliser -git-ref=--all -- git-ref=^private.
--git-depth=nombre
Crée un clone « shallow » dont l'historique est tronqué au nombre indiqué de
révisions.
Format : 3.0 (bzr)
Pris en charge depuis dpkg 1.14.17. Ce format est expérimental. Il crée une archive tar
contenant le dépôt bzr correspondant.
Extraction
L'archive tar est décompressée puis bzr est utilisé afin de récupérer la branche courante.
Construction
Avant d'aller plus loin, quelques vérifications sont effectuées afin de s'assurer qu'il
n'existe aucun changement non ignoré non soumis.
Ensuite, la partie spécifique du répertoire source du gestionnaire de versions est copiée
dans un répertoire temporaire. Avant que ce répertoire temporaire ne soit empaqueté dans
une archive tar, divers nettoyages sont effectués pour économiser de l'espace.
DIAGNOSTICS
aucun format source indiqué dans debian/source/format
Le fichier debian/source/format devrait toujours exister et indiquer le format source
souhaité. Pour préserver la compatibilité avec d'anciennes versions, le format « 1.0 » est
implicite quand le fichier n'existe pas. Il est déconseillé de dépendre de ce comportement
qui pourrait être modifié dans de futures versions de dpkg-source, qui échoueront alors en
l'absence d'une mention explicite de format.
Cela est dû au fait que le format « 1.0 » n'est plus le format recommandé, qu'il est
conseillé de choisir un des formats les plus récents (« 3.0 (quilt) » ou « 3.0 (native) »)
mais que dpkg-source ne le fera pas automatiquement. Si vous souhaitez continuer à
utiliser l'ancien format, il est nécessaire d'être explicite et indiquer « 1.0 » dans
debian/source/format.
le fichier de différences modifie les fichiers amont suivants
Lors de l'utilisation du format source « 1.0 », il est déconseillé de modifier directement
les fichiers amont car les modifications restent alors cachées et souvent non documentées
dans le fichier diff.gz. Au contraire, il est conseillé de conserver les modifications
sous forme de correctifs dans le répertoire debian et de les appliquer au moment de la
construction. Pour éviter ces opérations plus complexes, vous pouvez également choisir le
format « 3.0 (quilt) » qui permet ces opérations de manière native.
impossible d'identifier les changements de fichier
Les modifications des sources amont sont en général conservées dans des fichiers de
correctifs mais certaines modifications ne peuvent être représentées sous forme de tels
fichiers qui ne peuvent modifier que des fichiers texte. Si vous essayez de remplacer un
fichier avec un objet d'un type différent (par exemple remplacer un fichier par un lien ou
un répertoire), ce message d'erreur s'affichera.
le fichier fichier, nouvellement créé, ne sera pas représenté dans le fichier de différences
Les fichiers vides ne peuvent pas être créés avec des correctifs. En conséquence, la
modification n'est pas enregistrée dans le paquet source, ce qui provoque cet
avertissement.
le mode exécutable permissions de fichier ne sera pas représenté dans le fichier de
différences
Les fichiers de correctifs n'enregistrent pas les permissions de fichiers et, en
conséquence, les permissions des exécutables ne sont pas enregistrées dans le paquet
source, ce qui provoque cet avertissement.
le mode spécial permissions de fichier ne sera pas représenté dans le fichier de différences
Les fichiers correctifs n'enregistrent pas les permissions de fichiers et, en conséquence,
les permissions modifiées ne sont pas enregistrées dans le paquet source, ce qui provoque
cet avertissement.
ENVIRONNEMENT
DPKG_COLORS
Définit le mode de couleur (depuis dpkg 1.18.5). Les valeurs actuellement acceptées
sont auto (par défaut), always et never.
DPKG_NLS
Si cette variable est définie, elle sera utilisée pour décider l'activation de la
prise en charge des langues (NLS – Native Language Support), connu aussi comme la
gestion de l'internationalisation (ou i18n) (depuis dpkg 1.19.0). Les valeurs
permises sont : 0 et 1 (par défaut).
SOURCE_DATE_EPOCH
Si cette option est utilisée, elle sera utilisée comme horodatage (en seconde à
partir de « l'epoch ») pour fixer le « mtime » dans les entrées du fichier tar(5).
VISUAL
EDITOR Utilisé par les modules de format source « 2.0 » et « 3.0 (quilt) ».
GIT_DIR
GIT_INDEX_FILE
GIT_OBJECT_DIRECTORY
GIT_ALTERNATE_OBJECT_DIRECTORIES
GIT_WORK_TREE
Utilisés par les modules de format source « 3.0 (git) ».
FICHIERS
debian/source/format
Ce fichier contient sur une seule ligne le format à utiliser pour construire le paquet
source (les formats acceptés sont décrits plus haut). Il ne doit pas contenir d'espace
avant ou après l'indication du format.
debian/source/include-binaries
Ce fichier contient une liste de fichiers binaires (un par ligne) qui doivent être inclus
dans l'archive tar debian. Les espaces placées avant ou après ces noms sont supprimées.
Les lignes commençant par « # » sont des commentaires et sont ignorées, ainsi que les
lignes vides.
debian/source/options
Ce fichier contient la liste des options qui seront automatiquement ajoutées au jeu
d'options de ligne de commande lors de l'appel à dpkg-source --build ou dpkg-source
--print-format. Des options comme --compression et --compression-level conviennent bien
pour ce fichier.
Chaque option doit être placée sur une ligne distincte. Les lignes vides et les lignes
commençant par le caractère « # » sont ignorées. Les caractères initiaux « -- » doivent
être retirés et les options courtes ne peuvent pas être utilisées. Des espaces
optionnelles sont autorisées autour du symbole « = », ainsi que des guillemets optionnels
autour de la valeur d'une option donnée. Voici un exemple d'un tel fichier :
# autoriser dpkg-source à créer un fichier debian.tar.bz2 avec la
#compression maximale
compression = "bzip2"
compression-level = 9
# utiliser debian/patches/debian-changes comme correctif automatique
single-debian-patch
# ignorer les modifications dans config.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"
Note : les options de format ne sont pas acceptées dans ce fichier. Vous devriez utiliser
debian/source/format à la place.
debian/source/local-options
Identique à debian/source/options mais n'est pas enregistré dans le paquet source créé. Ce
fichier peut être utile pour conserver une préférence propre au responsable ou au dépôt de
gestionnaire de versions où le paquet source est géré.
debian/source/local-patch-header et debian/source/patch-header
Texte en format libre qui sera ajouté au début du correctif automatique créé dans les
formats « 2.0 » et « 3.0 (quilt) ». local-patch-header n'est pas inclus dans le paquet
source créé alors que patch-header l'est.
debian/patches/distributeur.series
debian/patches/series
Ce fichier comporte la liste de toutes les correctifs qui ont été appliqués (dans l'ordre
indiqué) aux sources amont. Les espaces situées avant et après les noms sont ignorées.
L'argument distributeur sera le nom en minuscules du distributeur ou debian si aucun
distributeur n'est défini. Si le fichier de séries propre au distributeur n'existe pas, le
fichier de séries sans distributeur sera utilisé. Les lignes commençant par « # » sont des
commentaires et sont ignorées, ainsi que les lignes vides. Les autres lignes débutent par
le nom du fichier de correctifs (relatif au répertoire debian/patches/) et se terminent à
la première espace ou à la fin de la ligne. Des options facultatives de quilt peuvent être
ajoutées jusqu'à la fin de la ligne ou jusqu'au premier caractère « # » précédé par une ou
plusieurs espaces (ce qui indique le début d'un commentaire se terminant à la fin de la
ligne).
BOGUES
Le moment où se déroule le remplacement d'un champ par rapport à certaines déterminations
de champ affichées sur la sortie standard est plutôt embrouillé.
VOIR AUSSI
deb-src-control(5), deb-changelog(5), dsc(5).
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006. Nicolas François,
2006. Veuillez signaler toute erreur à <debian-l10n-french@lists.debian.org>.