dpkg-source(1) dpkg suite dpkg-source(1)
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
Afficher le numéro de version puis quitter.
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,
/usr/share/keyrings/debian-nonupload.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.
Options générales génériques
--threads-max=threads
Fixe le nombre maximal de processus permis pour les compresseurs
qui gèrent les opérations multi-threadées (depuis dpkg 1.21.14).
-q Définit le mode silencieux pour supprimer les avertissements.
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à) et ne peut ni créer ni modifier des liens
symboliques.
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 ignore 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 à moins qu'ils aient été
autorisés au moyen 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 « main » 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 « main », on peut utiliser
--git-ref=main. 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 chemin de fichiers binaires (un par
ligne) relatifs au répertoire racine source 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
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), deb-substvars(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>.
1.21.22 2023-05-11 dpkg-source(1)
Generated by dwww version 1.15 on Sat Jun 29 01:33:37 CEST 2024.