dpkg-source - En ligne dans le Cloud

PROGRAMME:

Nom

dpkg-source - Outil de manipulation du paquet source Debian (.dsc)

SYNOPSIS

dpkg-source [option...] commander

DESCRIPTION

dpkg-source compresse et décompresse les archives sources Debian.

Aucune de ces commandes ne permet de combiner plusieurs options en une seule, et elles ne
permet à la valeur d'une option d'être spécifiée dans un argument séparé.

COMMANDES

-x, --extrait nom de fichier.dsc [répertoire de sortie]
Extraire un paquet source (--extrait depuis dpkg 1.17.14). Un argument non optionnel
doit être fourni, le nom du fichier de contrôle de source Debian (.dsc). Un facultatif
un deuxième argument non optionnel peut être fourni pour spécifier le répertoire pour extraire le
package source vers, cela ne doit pas exister. Si aucun répertoire de sortie n'est spécifié, le
le paquet source est extrait dans un répertoire nommé la source-version sous le courant
directeur de travail.

dpkg-source lira les noms des autres fichiers constituant le paquet source
du fichier de contrôle ; ils sont supposés être dans le même répertoire que le .dsc.

Les fichiers du package extrait auront leurs autorisations et leurs propriétés définies
à ceux auxquels on aurait pu s'attendre si les fichiers et répertoires avaient simplement
été créé - les répertoires et les fichiers exécutables seront 0777 et les fichiers simples seront
être 0666, tous deux modifiés par l'umask des extracteurs ; si le répertoire parent est setgid
alors les répertoires extraits le seront aussi, et tous les fichiers et répertoires seront
hériter de sa propriété de groupe.

Si le package source utilise un format non standard (actuellement, cela signifie que tous les formats
à l'exception de « 1.0 »), son nom sera stocké dans debian/source/format de sorte que la
les versions suivantes du package source utilisent le même format par défaut.

-b, --construire annuaire [paramètres-spécifiques au format]
Construire un paquet source (--construire depuis dpkg 1.17.14). Le premier argument non optionnel
est pris comme nom du répertoire contenant l'arborescence des sources débianisée (c'est-à-dire
avec un sous-répertoire debian et peut-être des modifications des fichiers d'origine). Cela dépend de
le format du package source utilisé pour créer le package, des paramètres supplémentaires peuvent être
accepté.

dpkg-source va construire le paquet source avec le premier format trouvé dans ce
liste ordonnée : le format indiqué par le --format option de ligne de commande, le
format indiqué dans debian/source/format, "1.0". Le retour à « 1.0 » est
obsolète et sera supprimé à un moment donné dans le futur, vous devez toujours
documenter le format source souhaité dans debian/source/format. Voir section SOURCE
RANGEMENT FORMATS pour une description détaillée des différents formats de paquet source.

--format d'impression annuaire
Imprimer le format source qui serait utilisé pour construire le package source si
dpkg-source --construire annuaire a été appelé (dans les mêmes conditions et avec les mêmes
paramètres; depuis dpkg 1.15.5).

--avant-construire annuaire
Exécutez le hook correspondant du format du package source (depuis dpkg 1.15.8). Cette
hook est appelé avant toute compilation du package (dpkg-buildpackage l'appelle très
tôt avant même debian/règles espace extérieur plus propre,). Cette commande est idempotente et peut être appelée
plusieurs fois. Tous les formats source n'implémentent pas quelque chose dans ce hook, et ceux
qui préparent généralement l'arborescence des sources pour la construction, par exemple en s'assurant que
les correctifs Debian sont appliqués.

--après-construction annuaire
Exécutez le hook correspondant du format du package source (depuis dpkg 1.15.8). Cette
hook est appelé après toute construction du package (dpkg-buildpackage l'appelle en dernier).
Cette commande est idempotente et peut être appelée plusieurs fois. Pas tous les formats sources
implémenter quelque chose dans ce crochet, et ceux qui l'utilisent généralement pour annuler ce
--avant-construire a fait.

--s'engager [annuaire]...
Enregistrer les modifications dans l'arborescence source décompressée dans annuaire (depuis dpkg 1.16.1). Cette
La commande peut prendre des paramètres supplémentaires selon le format source. Ce sera
erreur pour les formats où cette opération ne veut rien dire.

-?, --Aidez-moi
Affichez le message d'utilisation et quittez.

--version
Affichez la version et quittez.

OPTIONS

Générique construire Options
-cfichier-contrôle
Spécifie le fichier de contrôle de source principal à partir duquel lire les informations. La valeur par défaut est
debian / contrôle. S'il est donné avec un chemin d'accès relatif, il est interprété à partir de
le répertoire de niveau supérieur de l'arborescence des sources.

-lchangelog-fichier
Spécifie le fichier journal des modifications à partir duquel lire les informations. La valeur par défaut est
debian/journal des modifications. S'il est donné avec un chemin d'accès relatif, il est interprété à partir de
le répertoire de niveau supérieur de l'arborescence des sources.

-Fformat journal des modifications
Spécifie le format du journal des modifications. Voir dpkg-parsechangelog(1) pour information
sur les formats alternatifs.

--format=Plus-value
Utilisez le format donné pour construire le paquet source (depuis dpkg 1.14.17). Cela fait
remplacer tout format donné dans debian/source/format.

-Vprénom=Plus-value
Définissez une variable de substitution de sortie. Voir deb-substvars(5) pour une discussion sur
substitution de sortie.

-Tfichier-substvars
Lire les variables de substitution dans fichier-substvars; la valeur par défaut est de ne lire aucun fichier.
Cette option peut être utilisée plusieurs fois pour lire les variables de substitution de plusieurs
fichiers (depuis dpkg 1.15.6).

-Dchamp=Plus-value
Remplacer ou ajouter un champ de fichier de contrôle de sortie.

-Uchamp
Supprimez un champ de fichier de contrôle de sortie.

-Zcompression, --compression=compression
Spécifiez la compression à utiliser pour les archives tar et les fichiers diff créés (--compression
depuis dpkg 1.15.5). Notez que cette option n'entraînera pas la création d'archives tar existantes.
recompressé, cela n'affecte que les nouveaux fichiers. Les valeurs prises en charge sont : gzip, bzip2, lzma
ainsi que xz. La valeur par défaut est xz pour les formats 2.0 et plus récents, et gzip pour le format 1.0. xz
n'est pris en charge que depuis dpkg 1.15.5.

-zniveau, --niveau de compression=niveau
Niveau de compression à utiliser (--niveau de compression depuis dpkg 1.15.5). Comme avec -Z it
n'affecte que les fichiers nouvellement créés. Les valeurs prises en charge sont : 1 à 9, les meilleurset vite.
La valeur par défaut est 9 pour gzip et bzip2, 6 pour xz et lzma.

-i[regex], --diff-ignorer[=regex]
Vous pouvez spécifier une expression régulière perl pour faire correspondre les fichiers dont vous souhaitez filtrer
la liste des fichiers pour le diff (--diff-ignorer depuis dpkg 1.15.6). (Cette liste est
généré par une commande find.) (Si le package source est construit en tant que version 3
package source utilisant un VCS, cela peut être utilisé pour ignorer les modifications non validées sur
fichiers spécifiques. L'utilisation de -i.* les ignorera toutes.)

La -i seule l'option active ce paramètre avec une expression régulière par défaut (en préservant tout
modification de la regex par défaut effectuée par une utilisation précédente de --extend-diff-ignorer)
qui filtrera les fichiers de contrôle et les répertoires de la révision la plus courante
les systèmes de contrôle, les fichiers de sauvegarde et d'échange et les répertoires de sortie de création de Libtool. Là
ne peut être qu'une regex active, de plusieurs -i options que seul le dernier prendra
effet.

Ceci est très utile pour supprimer les fichiers superflus qui sont inclus dans le diff,
par exemple, si vous maintenez votre source dans un système de contrôle de révision et souhaitez utiliser un
checkout pour créer un package source sans inclure les fichiers supplémentaires et
répertoires qu'il contiendra habituellement (par exemple CVS/, .cvsignore, .svn/). Les
l'expression régulière par défaut est déjà très exhaustive, mais si vous devez la remplacer, veuillez
notez que par défaut, il peut correspondre à n'importe quelle partie d'un chemin, donc si vous voulez faire correspondre le
début d'un nom de fichier ou uniquement des noms de fichiers complets, vous devrez fournir les
ancres (par exemple '(^|/)', '($|/)') vous-même.

--extend-diff-ignorer=regex
L'expression régulière perl spécifiée étendra la valeur par défaut utilisée par
--diff-ignorer et sa valeur actuelle, si elle est définie (depuis dpkg 1.15.6). Il le fait par
concaténer "|regex" à la valeur existante. Cette option est pratique à utiliser dans
debian/sources/options pour exclure certains fichiers générés automatiquement du correctif automatique
génération.

-I[modèle de fichier], --tar-ignorer[=modèle de fichier]
Si cette option est spécifiée, le modèle sera transmis à goudron(1) --exclure
lorsqu'elle est appelée pour générer un fichier .orig.tar ou .tar (--tar-ignorer depuis
dpkg 1.15.6). Par exemple, -ICVS fera sauter les répertoires CVS par tar lorsque
générer un fichier .tar.gz. L'option peut être répétée plusieurs fois pour lister
plusieurs modèles à exclure.

-I par lui-même ajoute par défaut --exclure options qui filtreront les fichiers de contrôle et
répertoires des systèmes de contrôle de révision les plus courants, des fichiers de sauvegarde et d'échange et
Libtool crée des répertoires de sortie.

Remarque: Bien qu'ils aient des objectifs similaires, -i ainsi que -I ont une syntaxe très différente et
sémantique. -i ne peut être spécifié qu'une seule fois et prend une expression régulière compatible perl
qui est comparé au chemin relatif complet de chaque fichier. -I peut spécifier plusieurs
fois et prend un modèle de nom de fichier avec des caractères génériques shell. Le motif est appliqué au
chemin relatif complet mais aussi à chaque partie du chemin individuellement. La sémantique exacte de
le goudron --exclure l'option est un peu compliquée, voir
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

La regex et les modèles par défaut pour les deux options peuvent être vus dans la sortie du --Aidez-moi
commander.

Générique extrait Options
--pas de copie
Ne copiez pas les archives tar d'origine à proximité du paquet source extrait (puisque dpkg
1.14.17).

--pas de vérification
Ne vérifiez pas les signatures et les sommes de contrôle avant le déballage (depuis dpkg 1.14.17).

--require-valid-signature
Refuser de décompresser le paquet source s'il ne contient pas de signature OpenPGP qui
peut être vérifié (depuis dpkg 1.15.0) soit avec le clésdeconfiance.gpg porte-clés,
l'un des porte-clés spécifiques au fournisseur ou l'un des porte-clés officiels de Debian
(/usr/share/keyrings/debian-keyring.gpg ainsi que
/usr/share/keyrings/debian-maintainers.gpg).

--ignore-mauvaise-version
Transforme la mauvaise vérification de la version du package source en un avertissement non fatal (puisque dpkg
1.17.7). Cette option ne devrait être nécessaire que lors de l'extraction d'une source ancienne
packages avec des versions cassées, juste pour la compatibilité descendante.

SOURCE RANGEMENT FORMATS

Si vous ne savez pas quel format source utiliser, vous devriez probablement choisir soit "3.0 (quilt)"
ou « 3.0 (natif) ». Voir https://wiki.debian.org/Projects/DebSrc3.0 pour des informations sur le
déploiement de ces formats dans Debian.

Format: 1.0
Un package source dans ce format se compose soit d'un .orig.tar.gz associé à un .diff.gz
ou un seul .tar.gz (dans ce cas, le paquet est dit indigène).

Extraire

L'extraction d'un package natif est une simple extraction de l'unique archive tar dans la cible
annuaire. L'extraction d'un package non natif se fait en décompressant d'abord le .orig.tar.gz ainsi que
puis appliquer le patch contenu dans le .diff.gz déposer. L'horodatage de tous les fichiers corrigés
est réinitialisé à l'heure d'extraction du paquet source (cela évite les décalages d'horodatage menant
aux problèmes lorsque les fichiers générés automatiquement sont corrigés). Le diff peut créer de nouveaux fichiers (le
tout le répertoire debian est créé de cette façon) mais ne peut pas supprimer les fichiers (les fichiers vides seront
laissé pour compte).

Développement

Construire un package natif consiste simplement à créer une seule archive tar avec le répertoire source.
Construire un package non natif implique d'extraire l'archive d'origine dans un fichier séparé
répertoire « .orig » et en régénérant le .diff.gz en comparant le package source annuaire
avec le répertoire .orig.

Développer Options (avec --construire):

Si un deuxième argument non optionnel est fourni, il doit être le nom de la source d'origine
répertoire ou fichier tar ou la chaîne vide si le paquet est spécifique à Debian et ainsi
n'a pas de différences de débianisation. Si aucun deuxième argument n'est fourni, alors dpkg-source jettera un coup d'oeil
pour le fichier tar source d'origine package_upstream-version.orig.tar.gz ou l'original
répertoire source annuaire.orig en fonction de la -sX arguments.

-sa, -sp, -sk, -le sien ainsi que -sr n'écrasera pas les fichiers tar ou répertoires existants. Si c'est
souhaité alors -sA, -sp, -sK, -su ainsi que -Monsieur devrait être utilisé à la place.

-sk Spécifie d'attendre la source d'origine en tant que fichier tar, par défaut package_upstream-
version.orig.tar.extension. Il laissera cette source d'origine en place comme un
tarfile, ou copiez-le dans le répertoire courant s'il n'y est pas déjà. Le tarball
sera déballé dans annuaire.orig pour la génération des diff.

-sp Comme -sk mais supprimera à nouveau le répertoire par la suite.

-le sien Spécifie que la source d'origine est attendue en tant que répertoire, par défaut paquet-
version-amont.orig ainsi que dpkg-source va créer une nouvelle archive source originale
à partir de cela.

-sr Comme -le sien mais supprimera ce répertoire après son utilisation.

-ss Spécifie que la source d'origine est disponible à la fois en tant que répertoire et en tant que
fichier tar. dpkg-source utilisera le répertoire pour créer le diff, mais le fichier tar à
créer le .dsc. Cette option doit être utilisée avec précaution - si le répertoire et le fichier tar
ne correspondent pas, une mauvaise archive source sera générée.

- sn Spécifie de ne rechercher aucune source d'origine et de ne pas générer de diff. Les
le deuxième argument, s'il est fourni, doit être la chaîne vide. Ceci est utilisé pour Debian-
packages spécifiques qui n'ont pas de source amont distincte et ont donc
pas de différences de débianisation.

-sa or -sA
Spécifie de rechercher l'archive source d'origine sous forme de fichier tar ou de répertoire -
le deuxième argument, le cas échéant, peut être soit, soit la chaîne vide (c'est l'équivalent
à l'aide de - sn). Si un fichier tar est trouvé, il le décompresse pour créer le diff et
l'enlever par la suite (cela équivaut à -sp); si un répertoire est trouvé, il sera
compressez-le pour créer la source d'origine et supprimez-le par la suite (c'est l'équivalent
à -sr); si ni l'un ni l'autre n'est trouvé, il supposera que le paquet n'a pas de débianisation
diffs, seulement une archive source simple (cela équivaut à - sn). Si les deux
se trouvent alors dpkg-source ignorera le répertoire, en l'écrasant, si -sA était
spécifié (cela équivaut à -sp) ou générer une erreur si -sa a été précisé. -sA
est la valeur par défaut.

--abandon-sur-les-changements-en-amont
Le processus échoue si le diff généré 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/sources/options mais peut être utilisé dans debian/source/options-locales.

Extraction Options (avec --extrait):

Dans tous les cas, toute arborescence source originale existante sera supprimée.

-sp Utilisé lors de l'extraction, la source d'origine (le cas échéant) sera laissée en tant que fichier tar.
S'il n'est pas déjà situé dans le répertoire courant ou si un répertoire existant mais
un fichier différent s'y trouve, il y sera copié. (Ce is le défaut).

-le sien Décompresse l'arborescence source d'origine.

- sn Assure que la source d'origine n'est ni copiée dans le répertoire courant ni
déballé. Toute arborescence source d'origine qui se trouvait dans le répertoire actuel est toujours
enlevé.

Tous les -sX les options sont mutuellement exclusives. Si vous en spécifiez plusieurs, seul le dernier
sera utilisé.

--skip-debianisation
Ignore l'application du diff de Debian au-dessus des sources en amont (puisque dpkg
1.15.1).

Format: 2.0
Extraction prise en charge depuis dpkg 1.13.9, construction prise en charge depuis dpkg 1.14.8. Également connu
comme perruque et stylo. Ce format n'est pas recommandé pour une utilisation généralisée, le format « 3.0 (quilt) »
le remplace. Wig&pen a été la première spécification d'un package source de nouvelle génération
le format.

Le comportement de ce format est le même que le format « 3.0 (quilt) » sauf qu'il
n'utilise pas de liste explicite de correctifs. Tous les fichiers dans debian/correctifs/ correspondant au perl
expression régulière [\w-]+ doivent être des patchs valides : ils sont appliqués au moment de l'extraction.

Lors de la construction d'un nouveau package source, toute modification apportée à la source en amont est stockée dans un correctif
nommé zz_debian-diff-auto.

Format: 3.0 (originaire de)
Pris en charge depuis dpkg 1.14.17. Ce format est une extension du format de package natif tel que
défini dans le format 1.0. Il prend en charge toutes les méthodes de compression et ignorera par défaut
tous les fichiers et répertoires spécifiques à VCS ainsi que de nombreux fichiers temporaires (voir la valeur par défaut
associé à -I option dans la --Aidez-moi production).

Format: 3.0 (courtepointe)
Pris en charge depuis dpkg 1.14.17. Un package source dans ce format contient au moins un
tarball d'origine (.orig.tar.poste De poste peuvent être gz, bz2, lzma ainsi que xz) et une debian
archive (.debian.tar.poste). Il peut également contenir des tarballs originaux supplémentaires
(.origine-composant.le goudron.poste). composant ne peut contenir que des caractères alphanumériques et des tirets
('-').

Extraire

L'archive d'origine principale est extraite en premier, puis toutes les archives d'origine supplémentaires sont
extrait dans des sous-répertoires nommés d'après le composant partie de leur nom de fichier (tout pré-
répertoire existant est remplacé). L'archive tar de Debian est extraite au-dessus de la source
répertoire après suppression préalable de tout fichier préexistant debian annuaire. Notez que le debian
tarball doit contenir un debian sous-répertoire mais il peut aussi contenir des fichiers binaires en dehors
de ce répertoire (voir --include-binaires option).

Tous les correctifs répertoriés dans debian/correctifs/debian.series or debian/patchs/séries Sont alors
appliqué. Si le premier fichier est utilisé et que le dernier n'existe pas (ou est un lien symbolique),
puis ce dernier est remplacé par un lien symbolique vers le premier. Ceci est destiné à simplifier l'utilisation
of courtepointe pour gérer l'ensemble des patchs. Notez cependant que tandis que dpkg-source analyse
correctement les fichiers de série avec des options explicites utilisées pour l'application du correctif (stocké sur chaque
ligne après le nom du fichier de correctif et un ou plusieurs espaces), il ignore ces options et
attendez-vous toujours à des correctifs pouvant être appliqués avec le -p1 option de pièce. Il émettra ainsi
un avertissement lorsqu'il rencontre de telles options, et la construction est susceptible d'échouer.

L'horodatage de tous les fichiers corrigés est réinitialisé à l'heure d'extraction du package source
(cela évite les décalages d'horodatage entraînant des problèmes lorsque les fichiers générés automatiquement sont corrigés).

Contrairement à courtepointecomportement par défaut de , les correctifs sont censés s'appliquer sans aucune fuzz.
Lorsque ce n'est pas le cas, vous devez actualiser ces correctifs avec courtepointeou dpkg-source sera
erreur en essayant de les appliquer.

Similaire à courtepointecomportement par défaut de , les correctifs peuvent également supprimer des fichiers.

Le fichier .pc/patches-appliqués est créé si des patchs ont été appliqués lors de la
extraction.

Développement

Toutes les archives tar originales trouvées dans le répertoire courant sont extraites dans un fichier temporaire
répertoire en suivant la même logique que pour le déballage, le répertoire debian est copié
dans le répertoire temporaire, et tous les correctifs sauf le correctif automatique
(debian-changements-version or debian-changements, cela dépend de --single-patch-debian) sont
appliqué. Le répertoire temporaire est comparé au répertoire du package source. Quand le
diff n'est pas vide, la construction échoue à moins que --single-patch-debian or --auto-commit a été
utilisé, auquel cas le diff est stocké dans le patch automatique. Si le patch automatique est
créé/supprimé, il est ajouté/supprimé du fichier de série et du courtepointe métadonnées.

Tout changement sur un fichier binaire n'est pas représentable dans un diff et conduira donc à un échec
à moins que le responsable n'ait délibérément décidé d'inclure ce fichier binaire modifié dans le
tarball debian (en le listant dans debian/source/include-binaires). La construction échouera également
s'il trouve des fichiers binaires dans le sous-répertoire debian à moins qu'ils n'aient été ajoutés à la liste blanche
à travers debian/source/include-binaires.

Le répertoire debian mis à jour et la liste des binaires modifiés sont ensuite utilisés pour générer
l'archive tar de Debian.

Le diff généré automatiquement n'inclut pas les modifications sur les fichiers spécifiques à VCS ainsi que
de nombreux fichiers temporaires (voir la valeur par défaut associée à -i option dans la --Aidez-moi sortir). Dans
particulier, le .pc répertoire utilisé par courtepointe est ignoré lors de la génération de l'automatique
pièce.

Remarque: dpkg-source --avant-construire (Et --construire) garantira que tous les correctifs répertoriés dans le
series sont appliqués de sorte qu'une construction de package ait toujours tous les correctifs appliqués. Cela fait
ceci en trouvant les correctifs non appliqués (ils sont répertoriés dans le Series fichier mais pas dans
.pc/patches-appliqués), et si le premier patch de cet ensemble peut être appliqué sans erreur, il
les appliquera tous. L'option --pas de préparation peut être utilisé pour désactiver ce comportement.

enregistrement change

--s'engager [annuaire] [nom-patch] [fichier-patch]
Génère un patch correspondant aux changements locaux qui ne sont pas gérés par le
courtepointe système de patch et l'intègre dans le système de patch sous le nom nom-patch.
Si le nom est manquant, il sera demandé de manière interactive. Si fichier-patch est donné, il
est utilisé comme patch correspondant aux changements locaux à intégrer. Une fois que
intégré, un éditeur est lancé pour que vous puissiez éditer les méta-informations dans le
en-tête de patch.

En passant fichier-patch est principalement utile après un échec de build qui a pré-généré ce
fichier, et pour cette raison le fichier donné est supprimé après intégration. Notez également
que les changements contenus dans le fichier patch doivent déjà être appliqués sur l'arborescence
et que les fichiers modifiés par le patch ne doivent pas avoir de données supplémentaires non enregistrées
changements.

Si la génération de patch détecte des fichiers binaires modifiés, ils seront automatiquement
ajouté à debian/source/include-binaires pour qu'ils finissent dans l'archive debian
(exactement comme dpkg-source --include-binaires --construire ferait).

Développer Options

--allow-version-of-quilt-db=version
Autoriser dpkg-source pour construire le paquet source si la version du courtepointe métadonnées
est celui spécifié, même si dpkg-source ne le sait pas (puisque dpkg
1.15.5.4). En fait, cela dit que la version donnée du courtepointe les métadonnées sont
compatible avec la version 2 qui dpkg-source prend actuellement en charge. La version de
le courtepointe les métadonnées sont stockées dans .pc/.version.

--include-retrait
N'ignorez pas les fichiers supprimés et incluez-les dans le correctif généré automatiquement.

--include-horodatage
Incluez l'horodatage dans le correctif généré automatiquement.

--include-binaires
Ajoutez tous les binaires modifiés dans l'archive tar de Debian. Ajoutez-les également à
debian/source/include-binaires: ils seront ajoutés par défaut dans les builds suivants
et cette option n'est donc plus nécessaire.

--pas de préparation
N'essayez pas de préparer l'arbre de construction en appliquant des correctifs qui sont apparemment
non appliqué (depuis dpkg 1.14.18).

--single-patch-debian
Utilisez debian/patches/debian-changements au lieu de debian/correctifs/debian-changes-version
pour le nom du patch automatique généré lors de la compilation (depuis dpkg 1.15.5.4).
Cette option est particulièrement utile lorsque le package est maintenu dans un VCS et un
l'ensemble de correctifs ne peut pas être généré de manière fiable. Au lieu de cela, la différence actuelle avec l'amont
doit être stocké dans un seul patch. L'option serait mise en
debian/source/options-locales et serait accompagné d'un
debian/source/local-patch-header fichier expliquant comment les changements Debian peuvent être les meilleurs
revue, par exemple dans le VCS qui est utilisé.

--create-empty-orig
Créer automatiquement l'archive principale d'origine comme vide s'il est manquant et si
il existe des archives tar originales supplémentaires (depuis dpkg 1.15.6). Cette option est
destiné à être utilisé lorsque le package source n'est qu'un ensemble de plusieurs
logiciel et où il n'y a pas de logiciel « principal ».

--no-unapply-patches, --unapply-correctifs
Par défaut, dpkg-source désappliquera automatiquement les correctifs dans le --après-construction
crochet s'il les a appliqués pendant --avant-construire (--unapply-correctifs depuis dpkg
1.15.8 --no-unapply-correctifs depuis dpkg 1.16.5). Ces options vous permettent de
désactiver ou activer de force le processus de désapplication du correctif. Ces options sont
autorisé uniquement dans debian/source/options-locales afin que tous les packages sources générés
ont le même comportement par défaut.

--abandon-sur-les-changements-en-amont
Le processus échoue si un patch automatique a été généré (depuis dpkg 1.15.8).
Cette option peut être utilisée pour s'assurer que toutes les modifications ont été correctement enregistrées dans
séparé courtepointe correctifs avant la compilation du paquet source. Cette option n'est pas
Autorisé dans debian/sources/options mais peut être utilisé dans debian/source/options-locales.

--auto-commit
Le processus n'échoue pas si un correctif automatique a été généré, à la place il est
immédiatement enregistré dans le courtepointe série.

Extraction Options

--skip-debianisation
Ignore l'extraction de l'archive tar de Debian au-dessus des sources en amont (puisque dpkg
1.15.1).

--skip-patchs
Ne pas appliquer de patchs à la fin de l'extraction (depuis dpkg 1.14.18).

Format: 3.0 (Douane)
Pris en charge depuis dpkg 1.14.17. Ce format est particulier. Cela ne représente pas une vraie source
format de package mais peut être utilisé pour créer des packages source avec des fichiers arbitraires.

Développer Options

Tous les arguments non optionnels sont considérés comme des fichiers à intégrer dans le package source généré.
Ils doivent exister et sont de préférence dans le répertoire courant. Au moins un fichier doit être
donné.

--format-cible=Plus-value
Requis. Définit le format réel du package source généré. Le généré
Le fichier .dsc contiendra cette valeur dans son Format champ et non « 3.0 (personnalisé) ».

Format: 3.0 (git)
Pris en charge depuis dpkg 1.14.17. Ce format est expérimental.

Un package source dans ce format se compose d'un seul paquet d'un référentiel git .va à
contenir la source d'un paquet. Il peut aussi y avoir un .gitshallow révisions de la liste des fichiers pour
un clone git peu profond.

Extraire

Le bundle est cloné en tant que référentiel git dans le répertoire cible. S'il y a un
gitshallow, il est installé en tant que .git/peu profond dans le référentiel git cloné.

Notez que par défaut, le nouveau référentiel aura la même branche extraite qui était
extrait dans la source d'origine. (Généralement « maître », mais cela peut être n'importe quoi.)
d'autres succursales seront disponibles sous télécommandes/origine/.

Développement

Avant d'aller plus loin, des vérifications sont effectuées pour s'assurer que nous n'avons pas de non-
ignoré les modifications non validées.

git-bundle(1) est utilisé pour générer un bundle du référentiel git. Par défaut, tout
les branches et les balises du référentiel sont incluses dans le bundle.

Développer Options

--git-ref=ref
Permet de spécifier une référence git à inclure dans le bundle git. Utiliser désactive la valeur par défaut
comportement d'inclusion de toutes les branches et balises. Peut être spécifié plusieurs fois. Les
ref peut être le nom d'une branche ou d'une balise à inclure. Il peut aussi s'agir de n'importe quel paramètre
qui peut être transmis à git-rev-liste(1). Par exemple, pour n'inclure que le maître
branche, utiliser --git-ref=Maître. Pour inclure toutes les balises et branches, à l'exception du
branche privée, utiliser --git-ref=--tout --git-ref=^privé

--git-profondeur=nombre
Crée un clone superficiel avec un historique tronqué au nombre spécifié de
révisions.

Format: 3.0 (bzr)
Pris en charge depuis dpkg 1.14.17. Ce format est expérimental. Il génère un seul tarball
contenant le référentiel bzr.

Extraire

L'archive tar est décompressée, puis bzr est utilisé pour extraire la branche actuelle.

Développement

Avant d'aller plus loin, des vérifications sont effectuées pour s'assurer que nous n'avons pas de non-
ignoré les modifications non validées.

Ensuite, la partie spécifique au VCS du répertoire source est copiée dans un fichier temporaire
annuaire. Avant que ce répertoire temporaire ne soit compressé dans une archive tar, divers nettoyages sont
fait pour économiser de l'espace.

DIAGNOSTIC

aucune la source le format spécifié in debian/source/format
Le fichier debian/source/format doit toujours exister et indiquer le format source souhaité.
Pour une compatibilité descendante, le format "1.0" est supposé lorsque le fichier n'existe pas mais que vous
ne devrait pas se fier à cela: à un moment donné dans le futur dpkg-source sera modifié pour échouer
quand ce fichier n'existe pas.

La raison en est que le format « 1.0 » n'est plus le format recommandé, vous devriez généralement
choisissez l'un des formats les plus récents ("3.0 (quilt)", "3.0 (native)") mais dpkg-source ne fera pas
ceci automatiquement pour vous. Si vous souhaitez continuer à utiliser l'ancien format, vous devez être
explicite à ce sujet et mettez "1.0" dans debian/source/format.

le diff modifie le Abonnement en amont fichiers
Lorsque vous utilisez le format source « 1.0 », c'est généralement une mauvaise idée de modifier directement les fichiers en amont
car les modifications finissent par être masquées et pour la plupart non documentées dans le fichier .diff.gz. A la place tu
devrait stocker vos modifications sous forme de correctifs dans le répertoire debian et les appliquer au moment de la construction.
Pour éviter cette complexité vous pouvez également utiliser le format « 3.0 (quilt) » qui propose cette
nativement.

ne peut pas représentent Change à filet
Les modifications apportées aux sources en amont sont généralement stockées avec les fichiers de correctifs, mais toutes les modifications ne peuvent pas être
être représentés par des patchs : ils ne peuvent altérer que le contenu des fichiers texte brut. Si tu
essayez de remplacer un fichier par quelque chose d'un type différent (par exemple en remplaçant un simple
fichier avec un lien symbolique ou un répertoire), vous obtiendrez ce message d'erreur.

nouvellement créée vide filet filet sera ne sauraient be représenté in diff
Les fichiers vides ne peuvent pas être créés avec des fichiers de correctifs. Ainsi, ce changement n'est pas enregistré dans le
package source et vous en êtes averti.

exécutable mode permanentes of filet sera ne sauraient be représenté in diff
Les fichiers de correctif n'enregistrent pas les autorisations des fichiers et, par conséquent, les autorisations exécutables ne sont pas
stocké dans le package source. Cet avertissement vous le rappelle.

spécial mode permanentes of filet sera ne sauraient be représenté in diff
Les fichiers de correctif n'enregistrent pas les autorisations des fichiers et, par conséquent, les autorisations modifiées ne sont pas
stocké dans le package source. Cet avertissement vous le rappelle.

DOSSIER FORMATS

debian/source/format
Ce fichier contient sur une seule ligne le format qui doit être utilisé pour construire le source
package (les formats possibles sont décrits ci-dessus). Aucun espace de début ou de fin n'est autorisé.

debian/source/include-binaires
Ce fichier contient une liste de fichiers binaires (un par ligne) qui doivent être inclus dans le
tarball de Debian. Les espaces de début et de fin sont supprimés. Lignes commençant par '#' sommes
commentaires et sont ignorés. Les lignes vides sont ignorées.

debian/sources/options
Ce fichier contient une liste d'options longues qui doivent être automatiquement ajoutées au
ensemble d'options de ligne de commande d'un dpkg-source --construire or dpkg-source --format d'impression appel.
Des options comme --compression ainsi que --niveau de compression sont bien adaptés à ce fichier.

Chaque option doit être mise sur une ligne distincte. Lignes vides et lignes commençant par '#' sommes
ignoré. Le premier '--' doit être supprimé et les options courtes ne sont pas autorisées. Optionnel
les espaces sont autorisés autour du '=Le symbole ' et les guillemets facultatifs sont autorisés autour de la valeur.
Voici un exemple d'un tel fichier :

# laisser dpkg-source créer un debian.tar.bz2 avec une compression maximale
compression = "bzip2"
niveau de compression = 9
# utiliser debian/patches/debian-changes comme correctif automatique
patch-debian-unique
# ignore les changements sur la configuration.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

Remarque: le format les options ne sont pas acceptées dans ce fichier, vous devez utiliser debian/source/format
à la place.

debian/source/options-locales
Exactement comme debian/sources/options sauf que le fichier n'est pas inclus dans le fichier généré
paquet source. Il peut être utile de stocker une préférence liée au mainteneur ou au
Référentiel VCS où le package source est conservé.

debian/source/local-patch-header ainsi que debian/source/patch-header
Texte de forme libre placé au-dessus du correctif automatique généré aux formats « 2.0 » ou
"3.0 (couette)". en-tête de correctif local n'est pas inclus dans le package source généré alors que
en-tête de patch est.

debian/patchs/séries
Ce fichier répertorie tous les correctifs qui doivent être appliqués (dans l'ordre donné) en plus du
paquet source en amont. Les espaces de début et de fin sont supprimés. Lignes commençant par
»#' sont des commentaires et sont ignorés. Les lignes vides sont ignorées. Les lignes restantes commencent par un
nom du fichier de correctif (par rapport au debian/correctifs/ répertoire) jusqu'au premier caractère espace
ou la fin de la ligne. Optionnel courtepointe les options peuvent suivre jusqu'à la fin de la ligne ou le premier
»#' précédé d'un ou plusieurs espaces (qui marque le début d'un commentaire jusqu'à la fin de
ligne).

Utiliser dpkg-source en ligne en utilisant les services onworks.net