dpkg-source - Online in de cloud

PROGRAMMA:

NAAM

dpkg-source - Debian bronpakket (.dsc) manipulatietool

KORTE INHOUD

dpkg-bron [optie​ commando

PRODUCTBESCHRIJVING

dpkg-bron pakt en pakt Debian-bronarchieven in.

Geen van deze commando's staat toe dat meerdere opties in één worden gecombineerd, en dat doen ze ook niet
toestaan ​​dat de waarde voor een optie in een afzonderlijk argument wordt opgegeven.

COMMANDO'S

-x, --extract bestandsnaam.dsc [output-map]
Pak een broncodepakket uit (--extract sinds dpkg 1.17.14). Eén niet-optieargument
moet worden opgegeven, moet de naam van het Debian-broncontrolebestand (.dsc). een optionele
een tweede niet-optie-argument kan worden opgegeven om de map op te geven waarin de moet worden uitgepakt
source-pakket toe, dit mag niet bestaan. Als er geen uitvoermap is opgegeven, wordt de
broncodepakket wordt uitgepakt in een map met de naam (bron)-versie onder de stroom
werkmap.

dpkg-bron leest de namen van de andere bestanden waaruit het bronpakket bestaat
uit het controlebestand; ze worden verondersteld zich in dezelfde map te bevinden als de .dsc.

De rechten en eigendommen van de bestanden in het uitgepakte pakket zijn ingesteld
aan degenen die zouden zijn verwacht als de bestanden en mappen gewoon hadden
aangemaakt - mappen en uitvoerbare bestanden zullen 0777 zijn en gewone bestanden zullen
be 0666, beide gewijzigd door de umask van de extractors; als de bovenliggende map setgid is
dan zullen de uitgepakte mappen dat ook zijn, en alle bestanden en mappen zullen
zijn groepseigendom erven.

Als het bronpakket een niet-standaard formaat gebruikt (momenteel betekent dit alle formaten)
behalve “1.0”), wordt de naam opgeslagen in debian/bron/formaat zodat de
volgende builds van het broncodepakket gebruiken standaard hetzelfde formaat.

-b, --bouwen directory [formaat-specifieke-parameters]
Bouw een broncodepakket (--bouwen sinds dpkg 1.17.14). Het eerste niet-optie-argument
wordt genomen als de naam van de map die de gedebianiseerde broncodeboom bevat (bijv
met een debian-submap en misschien wijzigingen in de originele bestanden). Afhankelijk van
het formaat van het bronpakket dat is gebruikt om het pakket te bouwen, aanvullende parameters kunnen zijn:
geaccepteerd.

dpkg-bron zal het bronpakket bouwen met het eerste formaat dat hierin wordt gevonden
geordende lijst: het formaat aangegeven met de --formaat opdrachtregeloptie, de
formaat aangegeven in debian/bron/formaat, “1.0”. De fallback naar “1.0” is
verouderd en zal op een bepaald moment in de toekomst worden verwijderd, moet u altijd
documenteer het gewenste bronformaat in debian/bron/formaat. Zie sectie BRON
PAKKET FORMATS voor een uitgebreide beschrijving van de verschillende formaten van bronpakketten.

--afdrukformaat directory
Druk het bronformaat af dat zou worden gebruikt om het bronpakket te bouwen als:
dpkg-bron --bouwen directory werd genoemd (in dezelfde omstandigheden en met dezelfde)
parameters; sinds dpkg 1.15.5).

--voor-bouwen directory
Voer de overeenkomstige hook van het bronpakketformaat uit (sinds dpkg 1.15.8). Dit
hook wordt aangeroepen vóór elke build van het pakket (dpkg-buildpakket noemt het erg
vroeg zelfs eerder debian/regels schoon). Dit commando is idempotent en kan worden aangeroepen
meerdere keren. Niet alle bronformaten implementeren iets in deze hook, en die
die meestal de bronstructuur voorbereiden op de build, bijvoorbeeld door ervoor te zorgen dat:
de Debian-patches worden toegepast.

--na-bouwen directory
Voer de overeenkomstige hook van het bronpakketformaat uit (sinds dpkg 1.15.8). Dit
hook wordt aangeroepen na elke build van het pakket (dpkg-buildpakket noemt het als laatste).
Dit commando is idempotent en kan meerdere keren worden aangeroepen. Niet alle bronformaten
iets in deze hook implementeren, en degenen die dat wel doen, gebruiken het meestal om wat ongedaan te maken
--voor-bouwen heeft gedaan.

--verbinden [directory​
Noteer wijzigingen in de source tree uitgepakt in directory (sinds dpkg 1.16.1). Dit
commando kan aanvullende parameters aannemen, afhankelijk van het bronformaat. Het zal
error out voor formaten waar deze operatie niets betekent.

-?, --help
Toon het gebruiksbericht en sluit af.

--versie
Toon de versie en sluit af.

OPTIES

Algemeen bouw opties
-ccontrole-bestand
Specificeert het hoofdbronbeheerbestand waaruit informatie kan worden gelezen. De standaard is
debian / control. Indien gegeven met relatieve padnaam wordt dit geïnterpreteerd vanaf
de map op het hoogste niveau van de bronstructuur.

-lchangelog-bestand
Specificeert het changelog-bestand waaruit de informatie moet worden gelezen. De standaard is
debian/changelog. Indien gegeven met relatieve padnaam wordt dit geïnterpreteerd vanaf
de map op het hoogste niveau van de bronstructuur.

-Fchangelog-formaat
Specificeert het formaat van de changelog. Zien dpkg-parsechangelog(1) voor informatie
over alternatieve formaten.

--formaat=waarde
Gebruik het opgegeven formaat voor het samenstellen van het broncodepakket (sinds dpkg 1.14.17). Het doet
overschrijf elk formaat dat is opgegeven in debian/bron/formaat.

-Vnaam=waarde
Stel een uitvoervervangingsvariabele in. Zien deb-substvars(5) voor een bespreking van
uitvoer substitutie.

-Tsubstvars-bestand
Lees substitutievariabelen in substvars-bestand; de standaard is om geen enkel bestand te lezen.
Deze optie kan meerdere keren worden gebruikt om substitutievariabelen van meerdere
bestanden (sinds dpkg 1.15.6).

-Dveld-=waarde
Overschrijf of voeg een uitvoerbesturingsbestandsveld toe.

-Uveld-
Een uitvoercontrolebestandsveld verwijderen.

-Zsamendrukking, --compressie=samendrukking
Specificeer de compressie die moet worden gebruikt voor gemaakte tarballs en diff-bestanden (--compressie
sinds dpkg 1.15.5). Merk op dat deze optie er niet voor zal zorgen dat bestaande tarballs
opnieuw gecomprimeerd, heeft dit alleen invloed op nieuwe bestanden. Ondersteunde waarden zijn: gzip, bzip2, lzma
en xz. De standaardwaarde is xz voor formaten 2.0 en nieuwer, en gzip voor formaat 1.0. xz
wordt alleen ondersteund sinds dpkg 1.15.5.

-zniveau, --compressie-niveau=niveau
Te gebruiken compressieniveau (--compressie-niveau sinds dpkg 1.15.5). zoals bij -Z it
heeft alleen invloed op nieuw gemaakte bestanden. Ondersteunde waarden zijn: 1 naar 9, beste en snel.
De standaard is 9 voor gzip en bzip2, 6 voor xz en lzma.

-i[regex], --diff-negeren[=regex]
U kunt een perl reguliere expressie specificeren om overeen te komen met bestanden waaruit u wilt filteren
de lijst met bestanden voor de diff (--diff-negeren sinds dpkg 1.15.6). (Deze lijst is
gegenereerd door een find-opdracht.) (Als het bronpakket wordt gebouwd als een versie 3
bronpakket met behulp van een VCS, dit kan worden gebruikt om niet-vastgelegde wijzigingen op . te negeren
specifieke bestanden. Als u -i.* gebruikt, worden ze allemaal genegeerd.)

De -i optie op zichzelf schakelt deze instelling in met een standaard regex (met behoud van eventuele
wijziging van de standaard regex gedaan door een eerder gebruik van --uitbreiden-diff-negeren)
die controlebestanden en mappen van de meest voorkomende revisie uitfiltert
besturingssystemen, back-up en swap-bestanden en Libtool build-uitvoerdirectory's. Daar
kan maar één actieve regex zijn, of meerdere -i opties alleen de laatste zal nemen
effect.

Dit is erg handig bij het verwijderen van externe bestanden die in de diff worden opgenomen,
bijv. als u uw broncode in een revisiecontrolesysteem onderhoudt en een
checkout om een ​​bronpakket te bouwen zonder de extra bestanden op te nemen en
directory's die het gewoonlijk zal bevatten (bijv. CVS/, .cvsignore, .svn/). De
standaard regex is al zeer volledig, maar als je het moet vervangen, alsjeblieft
merk op dat het standaard kan overeenkomen met elk deel van een pad, dus als je wilt overeenkomen met de
begin van een bestandsnaam of alleen volledige bestandsnamen, moet u de benodigde
ankers (bijv. '(^|/)', '($|/)') zelf.

--uitbreiden-diff-negeren=regex
De opgegeven reguliere expressie perl zal de standaardwaarde uitbreiden die wordt gebruikt door
--diff-negeren en zijn huidige waarde, indien ingesteld (sinds dpkg 1.15.6). Het doet dit door
aaneenschakelen "|regex” naar de bestaande waarde. Deze optie is handig om te gebruiken in
debian/bron/opties om sommige automatisch gegenereerde bestanden uit te sluiten van de automatische patch
generatie.

-I[bestandspatroon], --tar-negeren[=bestandspatroon]
Als deze optie is opgegeven, wordt het patroon doorgegeven aan: teer(1) die van --uitsluiten
optie wanneer het wordt aangeroepen om een ​​.orig.tar- of .tar-bestand te genereren (--tar-negeren sinds
dpkg 1.15.6). Bijvoorbeeld, -ICVS zorgt ervoor dat tar CVS-directories overslaat wanneer:
het genereren van een .tar.gz-bestand. De optie kan meerdere keren worden herhaald om de lijst weer te geven
meerdere patronen om uit te sluiten.

-I voegt op zichzelf standaard toe --uitsluiten opties die controlebestanden uitfilteren en
mappen van de meest voorkomende revisiecontrolesystemen, back-up- en wisselbestanden en
Libtool bouwt uitvoermappen.

Opmerking: Hoewel ze vergelijkbare doelen hebben, -i en -I hebben een heel andere syntaxis en
semantiek. -i kan slechts één keer worden opgegeven en heeft een perl-compatibele reguliere expressie
die overeenkomt met het volledige relatieve pad van elk bestand. -I kan meerdere opgeven
times en neemt een bestandsnaampatroon met shell-jokertekens. Het patroon wordt toegepast op de
volledige relatieve pad, maar ook voor elk deel van het pad afzonderlijk. De exacte semantiek van
teer --uitsluiten optie is enigszins ingewikkeld, zie
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

De standaard regex en patronen voor beide opties zijn te zien in de uitvoer van de --help
opdracht.

Algemeen extract opties
--geen-kopie
Kopieer geen originele tarballs in de buurt van het uitgepakte broncodepakket (aangezien dpkg
1.14.17).

--geen controle
Controleer handtekeningen en controlesommen niet voor het uitpakken (sinds dpkg 1.14.17).

--vereis-geldige-handtekening
Weiger het bronpakket uit te pakken als het geen OpenPGP-handtekening bevat die:
kan worden geverifieerd (sinds dpkg 1.15.0) ofwel met de vertrouwdekeys.gpg sleutelhanger,
een van de leverancierspecifieke sleutelhangers, of een van de officiële sleutelhangers van Debian
(/usr/share/keyrings/debian-keyring.gpg en
/usr/share/keyrings/debian-maintainers.gpg).

--negeer-slechte-versie
Verandert de controle van de versie van het slechte broncodepakket in een niet-fatale waarschuwing (sinds dpkg
1.17.7). Deze optie zou alleen nodig moeten zijn bij het extraheren van oude bronnen
pakketten met kapotte versies, alleen voor achterwaartse compatibiliteit.

BRON PAKKET FORMATS

Als u niet weet welk bronformaat u moet gebruiken, moet u waarschijnlijk "3.0 (quilt)" kiezen
of "3.0 (native)". Zie https://wiki.debian.org/Projects/DebSrc3.0 voor informatie over de
implementatie van die formaten binnen Debian.

Formaat: 1.0
Een bronpakket in dit formaat bestaat ofwel uit een .orig.tar.gz geassocieerd met een .diff.gz
of een single .tar.gz (in dat geval heet het pakket inheemse).

Het extraheren

Het extraheren van een native pakket is een eenvoudige extractie van de enkele tarball in het doel
map. Het extraheren van een niet-native pakket doe je door eerst de .orig.tar.gz en
breng vervolgens de pleister aan die zich in de bevindt .diff.gz het dossier. Het tijdstempel van alle gepatchte bestanden
wordt teruggezet naar de extractietijd van het bronpakket (dit vermijdt scheve tijdstempels)
tot problemen wanneer automatisch gegenereerde bestanden worden gepatcht). De diff kan nieuwe bestanden maken (de
hele debian-directory wordt op die manier gemaakt), maar kan geen bestanden verwijderen (lege bestanden worden wel
overgebleven).

Gebouw

Het bouwen van een native pakket is gewoon het maken van een enkele tarball met de brondirectory.
Het bouwen van een niet-native pakket omvat het extraheren van de originele tarball in een aparte
map ".orig" en het opnieuw genereren van de .diff.gz door het bronpakket te vergelijken directory
met de .orig-map.

Bouw opties (met --bouwen):

Als een tweede niet-optie-argument wordt opgegeven, moet dit de naam van de oorspronkelijke bron zijn
directory of tarfile of de lege string als het pakket specifiek voor Debian is, enzovoort
heeft geen debianiseringsverschillen. Als er geen tweede argument wordt opgegeven, dpkg-bron eruit zal zien
voor het originele bronbestand pakket_upstream-versie.orig.tar.gz of de oorspronkelijke
bronmap directory.oorsprong afhankelijk van -sX argumenten.

-za, -sp, -SK, -zijn en -sr zal bestaande tarfiles of directories niet overschrijven. Als dit is
gewenst dan -sA, -sp, -sk, -zijn en -sR moet in plaats daarvan worden gebruikt.

-SK Specificeert dat de originele bron standaard als een tar-bestand wordt verwacht pakket_upstream-
versie.orig.teer.uitbreiding. Het zal deze originele bron op zijn plaats laten als een
tarfile, of kopieer het naar de huidige map als het er nog niet is. de tarball
zal worden uitgepakt in directory.oorsprong voor het genereren van de diff.

-sp Like -SK maar zal de map daarna weer verwijderen.

-zijn Specificeert dat de originele bron standaard wordt verwacht als een map pakket-
upstream-versie.oorsprong en dpkg-bron zal een nieuw origineel bronarchief maken
ervan.

-sr Like -zijn maar zal die map verwijderen nadat deze is gebruikt.

-SS Specificeert dat de originele bron zowel als directory als als a . beschikbaar is
tarbestand. dpkg-bron zal de map gebruiken om de diff te maken, maar het tar-bestand om
maak de .dsc. Deze optie moet met zorg worden gebruikt - als de directory en tarfile
niet overeenkomen, wordt een slecht bronarchief gegenereerd.

-sn Specificeert om niet te zoeken naar een originele bron, en om geen diff te genereren. De
tweede argument, indien opgegeven, moet de lege tekenreeks zijn. Dit wordt gebruikt voor Debian-
specifieke pakketten die geen aparte upstream-bron hebben en daarom:
geen debianisatie diffs.

-za or -sA
Specificeert om te zoeken naar het originele bronarchief als een tarfile of als een directory -
het tweede argument, indien aanwezig, kan een van beide zijn, of de lege tekenreeks (dit is equivalent
het gebruik -sn). Als er een tarfile wordt gevonden, wordt deze uitgepakt om de diff te maken en
verwijder het daarna (dit is gelijk aan -sp); als er een map wordt gevonden, zal het:
pak het in om de originele bron te maken en verwijder het daarna (dit is equivalent
naar -sr); als geen van beide wordt gevonden, gaat het ervan uit dat het pakket geen debianisatie heeft
diffs, alleen een eenvoudig bronarchief (dit is gelijk aan -sn). Als beide
zijn dan gevonden dpkg-bron zal de map negeren, overschrijven, als -sA was
gespecificeerd (dit komt overeen met -sp) of maak een fout als -za werd opgegeven. -sA
is de standaard.

--afbreken-op-upstream-wijzigingen
Het proces mislukt als de gegenereerde diff wijzigingen bevat in bestanden buiten de
debian submap (sinds dpkg 1.15.8). Deze optie is niet toegestaan ​​in
debian/bron/opties maar kan worden gebruikt in debian/source/local-opties.

Extract opties (met --extract):

In alle gevallen zal elke bestaande originele bronboom worden verwijderd.

-sp Gebruikt bij het uitpakken, dan wordt de originele bron (indien aanwezig) als een tar-bestand achtergelaten.
Als het nog niet in de huidige map staat of als een bestaande maar
er een ander bestand is, zal het daar worden gekopieerd. (Deze is de verzuim).

-zijn Pakt de originele source tree uit.

-sn Zorgt ervoor dat de originele bron niet wordt gekopieerd naar de huidige map, noch
uitgepakt. Elke originele bronstructuur die in de huidige map stond, is nog steeds
verwijderd.

Alle -sX opties sluiten elkaar uit. Als u meer dan één specificeert, alleen de laatste
gebruikt.

--overslaan-debianisatie
Slaat toepassing van de debian diff bovenop de upstream-bronnen (sinds dpkg
1.15.1).

Formaat: 2.0
Extractie ondersteund sinds dpkg 1.13.9, bouwen ondersteund sinds dpkg 1.14.8. Ook bekend
als pruik&pen. Dit formaat wordt niet aanbevolen voor wijdverbreid gebruik, het formaat "3.0 (quilt)"
vervangt het. Wig&pen was de eerste specificatie van een bronpakket van de nieuwe generatie
formaat.

Het gedrag van dit formaat is hetzelfde als het “3.0 (quilt)” formaat, behalve dat het
gebruikt geen expliciete lijst met patches. Alle bestanden in debian/patches/ overeenkomen met de perl
reguliere expressie [\w-]+ moeten geldige patches zijn: ze worden toegepast op het moment van extractie.

Bij het bouwen van een nieuw broncodepakket wordt elke wijziging aan de stroomopwaartse bron opgeslagen in een patch
genoemd zz_debian-diff-auto.

Formaat: 3.0 (oorspronkelijk)
Ondersteund sinds dpkg 1.14.17. Dit formaat is een uitbreiding van het oorspronkelijke pakketformaat als
gedefinieerd in het 1.0-formaat. Het ondersteunt alle compressiemethoden en wordt standaard genegeerd
alle VCS-specifieke bestanden en mappen, evenals veel tijdelijke bestanden (zie standaardwaarde
geassocieerd met -I optie in het --help uitgang).

Formaat: 3.0 (dekbed)
Ondersteund sinds dpkg 1.14.17. Een bronpakket in dit formaat bevat minimaal een
originele tarball (.orig.teer.ext WAAR ext kan zijn gz, bz2, lzma en xz) en een debian
tarbal (.debian.tar.ext). Het kan ook extra originele tarballs bevatten
(.orig-bestanddeel.teer.ext). bestanddeel mag alleen alfanumerieke tekens en koppeltekens bevatten
('-').

Het extraheren

De belangrijkste originele tarball wordt eerst geëxtraheerd, daarna worden alle aanvullende originele tarballs
geëxtraheerd in submappen vernoemd naar de bestanddeel een deel van hun bestandsnaam (eventuele voor-
bestaande directory wordt vervangen). De debian tarball wordt bovenop de bron geëxtraheerd
directory na voorafgaande verwijdering van reeds bestaande debian map. Merk op dat de debian
tarball moet een bevatten debian submap, maar het kan ook binaire bestanden daarbuiten bevatten
van die map (zie --include-binaire bestanden keuze).

Alle patches vermeld in debian/patches/debian.series or debian/patches/series zijn dan
toegepast. Als het eerste bestand wordt gebruikt en het laatste niet bestaat (of een symbolische link is),
dan wordt de laatste vervangen door een symbolische link naar de eerste. Dit is bedoeld om het gebruik te vereenvoudigen
of quilt om de reeks patches te beheren. Merk echter op dat terwijl dpkg-bron ontleedt
correct series-bestanden met expliciete opties die worden gebruikt voor patch-applicatie (opgeslagen op elke
regel na de patch-bestandsnaam en een of meer spaties), negeert het die opties en
verwacht altijd patches die kunnen worden aangebracht met de -p1 optie van stuk. Het zal dus uitzenden
een waarschuwing wanneer het dergelijke opties tegenkomt, en de build zal waarschijnlijk mislukken.

Het tijdstempel van alle gepatchte bestanden wordt teruggezet naar de extractietijd van het bronpakket
(dit voorkomt scheve tijdstempels die tot problemen leiden wanneer automatisch gegenereerde bestanden worden gepatcht).

In tegenstelling tot quilt's standaardgedrag, wordt verwacht dat patches zonder fuzz worden toegepast.
Als dat niet het geval is, moet u dergelijke patches verversen met quiltof dpkg-bron wil
fout uit terwijl u ze probeert toe te passen.

gelijk aan quilt's standaardgedrag, kunnen de patches ook bestanden verwijderen.

Het bestand .pc/toegepaste-patches wordt gemaakt als sommige patches zijn toegepast tijdens de
extractie.

Gebouw

Alle originele tarballs die in de huidige map worden gevonden, worden geëxtraheerd in een tijdelijke
directory door dezelfde logica te volgen als voor het uitpakken, wordt de debian-directory gekopieerd
over in de tijdelijke map, en alle patches behalve de automatische patch
(debian-veranderingen-versie or debian-wijzigingen, afhankelijk van --enkele-debian-patch) zijn
toegepast. De tijdelijke map wordt vergeleken met de bronpakketmap. Wanneer de
diff is niet leeg, het bouwen mislukt tenzij --enkele-debian-patch or --automatisch vastleggen is
gebruikt, in welk geval de diff wordt opgeslagen in de automatische patch. Als de automatische patch is:
gemaakt/verwijderd, wordt het toegevoegd aan/verwijderd uit het seriebestand en uit de quilt metagegevens.

Elke wijziging in een binair bestand is niet representatief in een diff en zal dus leiden tot een fout
tenzij de beheerder er bewust voor heeft gekozen om dat gewijzigde binaire bestand op te nemen in de
debian tarball (door het op te sommen in debian/source/include-binaries). De build zal ook mislukken
als het binaire bestanden vindt in de debian-submap, tenzij ze op de witte lijst zijn gezet
door debian/source/include-binaries.

De bijgewerkte debian-directory en de lijst met gewijzigde binaire bestanden worden vervolgens gebruikt om
de debian-tarball.

De automatisch gegenereerde diff bevat geen wijzigingen in VCS-specifieke bestanden en ook niet:
veel tijdelijke bestanden (zie standaardwaarde gekoppeld aan -i optie in het --help uitgang). In
in het bijzonder, de .pc directory gebruikt door quilt wordt genegeerd tijdens het genereren van de automatische
patch.

Opmerking: dpkg-bron --voor-bouwen (En --bouwen) zorgt ervoor dat alle patches die in de
series-bestand worden toegepast, zodat op een pakketbuild altijd alle patches zijn toegepast. Het doet
dit door niet-toegepaste patches te vinden (ze staan ​​vermeld in de serie bestand maar niet in
.pc/toegepaste-patches), en als de eerste patch in die set zonder fouten kan worden toegepast, is het
zal ze allemaal toepassen. De optie --geen-voorbereiding kan worden gebruikt om dit gedrag uit te schakelen.

Opnemen veranderingen

--verbinden [directory] [patch-naam] [patch-bestand]
Genereert een patch die overeenkomt met de lokale wijzigingen die niet worden beheerd door de
quilt patchsysteem en integreert het in het patchsysteem onder de naam patch-naam.
Als de naam ontbreekt, wordt deze interactief gevraagd. Indien patch-bestand wordt gegeven, het is
wordt gebruikt als de patch die overeenkomt met de lokale wijzigingen die moeten worden geïntegreerd. Een keer
geïntegreerd, wordt een editor gestart zodat u de meta-informatie in de
patch-header.

Voorbijgaand patch-bestand is vooral handig na een mislukte build die dit vooraf heeft gegenereerd
bestand, en op grond hiervan wordt het gegeven bestand na integratie verwijderd. Let ook op
dat de wijzigingen in het patchbestand al op de boom moeten zijn toegepast
en dat de bestanden die door de patch zijn gewijzigd, geen aanvullende niet-opgenomen mogen hebben
veranderingen.

Als de patch-generatie gewijzigde binaire bestanden detecteert, worden ze automatisch
toegevoegd debian/source/include-binaries zodat ze in de debian tarball terechtkomen
(precies zoals dpkg-bron --include-binaire bestanden --bouwen zou doen).

Bouw opties

--allow-versie-van-quilt-db=versie
Allow dpkg-bron om het broncodepakket te bouwen als de versie van de quilt metadata
is de gespecificeerde, zelfs als dpkg-bron weet er niets van (sinds dpkg
1.15.5.4). In feite zegt dit dat de gegeven versie van de quilt metagegevens zijn
compatibel met de versie 2 die: dpkg-bron momenteel ondersteunt. de versie van
de quilt metagegevens worden opgeslagen in .pc/.versie.

--inclusief-verwijdering
Negeer verwijderde bestanden niet en neem ze op in de automatisch gegenereerde patch.

--inclusief-tijdstempel
Voeg tijdstempel toe aan de automatisch gegenereerde patch.

--include-binaire bestanden
Voeg alle gewijzigde binaire bestanden toe aan de debian tarball. Voeg ze ook toe aan
debian/source/include-binaries: ze worden standaard toegevoegd in volgende builds
en deze optie is dus niet meer nodig.

--geen-voorbereiding
Probeer de bouwstructuur niet voor te bereiden door patches toe te passen die blijkbaar
niet toegepast (sinds dpkg 1.14.18).

--enkele-debian-patch
Te gebruiken debian/patches/debian-wijzigingen in plaats van debian/patches/debian-wijzigingen-versie
voor de naam van de automatische patch gegenereerd tijdens het bouwen (sinds dpkg 1.15.5.4).
Deze optie is vooral handig wanneer het pakket wordt onderhouden in een VCS en een
patchset kan niet op betrouwbare wijze worden gegenereerd. In plaats daarvan de huidige diff met upstream
moet in een enkele pleister worden bewaard. De optie zou worden ingevoerd
debian/source/local-opties en zou vergezeld gaan van een
debian/source/local-patch-header bestand waarin wordt uitgelegd hoe de wijzigingen in Debian het beste kunnen worden
beoordeeld, bijvoorbeeld in de VCS die wordt gebruikt.

--create-lege-orig
Maak automatisch de originele hoofdtarball als leeg als deze ontbreekt en als
er zijn aanvullende originele tarballs (sinds dpkg 1.15.6). Deze optie is
bedoeld om te worden gebruikt wanneer het bronpakket slechts een bundel van meerdere upstream is
software en waar er geen "hoofd" software is.

--geen-apply-patches, --apply-patches
Standaard dpkg-bron zal automatisch de patches in de --na-bouwen
haak als het ze heeft toegepast tijdens --voor-bouwen (--apply-patches sinds dpkg
1.15.8, --geen-apply-patches sinds dpkg 1.16.5). Met die opties kunt u:
het proces voor het ongedaan maken van de patch krachtig uitschakelen of inschakelen. Die opties zijn:
alleen toegestaan ​​in debian/source/local-opties zodat alle gegenereerde bronpakketten
hebben standaard hetzelfde gedrag.

--afbreken-op-upstream-wijzigingen
Het proces mislukt als er een automatische patch is gegenereerd (sinds dpkg 1.15.8).
Deze optie kan worden gebruikt om ervoor te zorgen dat alle wijzigingen correct zijn vastgelegd in
apart quilt patches voorafgaand aan de build van het bronpakket. Deze optie is niet
toegestaan ​​in debian/bron/opties maar kan worden gebruikt in debian/source/local-opties.

--automatisch vastleggen
Het proces mislukt niet als er een automatische patch is gegenereerd, in plaats daarvan is het:
onmiddellijk opgenomen in de quilt series.

Extract opties

--overslaan-debianisatie
Slaat extractie van de debian tarball bovenop de stroomopwaartse bronnen (sinds dpkg
1.15.1).

--overslaan-patches
Breng geen pleisters aan aan het einde van de extractie (sinds dpkg 1.14.18).

Formaat: 3.0 (Op maat)
Ondersteund sinds dpkg 1.14.17. Dit formaat is bijzonder. Het vertegenwoordigt geen echte bron
pakketformaat, maar kan worden gebruikt om bronpakketten met willekeurige bestanden te maken.

Bouw opties

Alle niet-optie-argumenten worden als bestanden genomen om te integreren in het gegenereerde broncodepakket.
Ze moeten bestaan ​​en staan ​​bij voorkeur in de huidige directory. Ten minste één bestand moet zijn
gegeven.

--doelformaat=waarde
Nodig. Definieert het werkelijke formaat van het gegenereerde broncodepakket. de gegenereerde
.dsc-bestand bevat deze waarde in zijn Formaat veld en niet "3.0 (aangepast)".

Formaat: 3.0 (git)
Ondersteund sinds dpkg 1.14.17. Dit formaat is experimenteel.

Een broncodepakket in dit formaat bestaat uit een enkele bundel van een git-repository .git naar
de bron van een pakket bevatten. Er kan ook een .gitondiep revisies van bestandslijsten voor
een ondiepe git-kloon.

Het extraheren

De bundel wordt gekloond als een git-repository naar de doelmap. Als er een is
gitshallow-bestand, het is geïnstalleerd als .git/ondiep in de gekloonde git-repository.

Merk op dat de nieuwe repository standaard dezelfde branch heeft uitgecheckt die was
uitgecheckt in de originele bron. (Meestal "meester", maar het kan van alles zijn.)
andere vestigingen zijn beschikbaar onder: afstandsbedieningen/oorsprong/.

Gebouw

Voordat we verder gaan, worden er enkele controles uitgevoerd om er zeker van te zijn dat we geen niet-
niet-vastgelegde wijzigingen genegeerd.

git-bundel(1) wordt gebruikt om een ​​bundel van de git-repository te genereren. Standaard zijn alle
branches en tags in de repository zijn opgenomen in de bundel.

Bouw opties

--git-ref=ref
Staat toe een git-ref te specificeren om op te nemen in de git-bundel. Gebruik schakelt de standaard uit
gedrag van het opnemen van alle branches en tags. Mag meerdere keren opgegeven worden. De
ref kan de naam zijn van een tak of tag die moet worden opgenomen. Het kan ook elke parameter zijn
dat kan worden doorgegeven aan git-rev-lijst(1). Om bijvoorbeeld alleen de master op te nemen
tak, gebruik --git-ref=meester. Om alle tags en branches op te nemen, behalve de
privétak, gebruik --git-ref=--alle --git-ref=^privé

--git-diepte=aantal
Creëert een ondiepe kloon met een geschiedenis die is afgekapt tot het opgegeven aantal
revisies.

Formaat: 3.0 (bzr)
Ondersteund sinds dpkg 1.14.17. Dit formaat is experimenteel. Het genereert een enkele tarball
met daarin de bzr-repository.

Het extraheren

De tarball wordt uitgepakt en vervolgens wordt bzr gebruikt om de huidige branch af te rekenen.

Gebouw

Voordat we verder gaan, worden er enkele controles uitgevoerd om er zeker van te zijn dat we geen niet-
niet-vastgelegde wijzigingen genegeerd.

Vervolgens wordt het VCS-specifieke deel van de bronmap gekopieerd naar een tijdelijke
map. Voordat deze tijdelijke map in een tarball wordt verpakt, zijn verschillende opruimacties:
gedaan om ruimte te besparen.

DIAGNOSE

geen (bron) formaat gespecificeerd in debian/bron/formaat
Het bestand debian/bron/formaat moet altijd bestaan ​​en het gewenste bronformaat aangeven.
Voor achterwaartse compatibiliteit wordt het formaat "1.0" aangenomen wanneer het bestand niet bestaat, maar u
mag hier niet op vertrouwen: op een bepaald moment in de toekomst dpkg-bron zal worden gewijzigd om te mislukken
wanneer dat bestand niet bestaat.

De grondgedachte is dat het formaat "1.0" niet langer het aanbevolen formaat is, dat zou u normaal gesproken moeten doen:
kies een van de nieuwere formaten (“3.0 (quilt)”, “3.0 (native)”) maar dpkg-bron zal niet doen
dit automatisch voor u. Als u het oude formaat wilt blijven gebruiken, moet u:
expliciet over en zet "1.0" in debian/bron/formaat.

de diff wijzigt de volgend stroomopwaarts bestanden
Bij gebruik van het bronformaat "1.0" is het meestal een slecht idee om upstream-bestanden rechtstreeks te wijzigen
omdat de wijzigingen verborgen en meestal ongedocumenteerd in het .diff.gz-bestand terechtkomen. In plaats daarvan jij
moet uw wijzigingen opslaan als patches in de debian-directory en ze toepassen tijdens het bouwen.
Om deze complexiteit te voorkomen, kunt u ook het formaat "3.0 (quilt)" gebruiken dat dit biedt
native.

kan niet vertegenwoordigen verandering naar filet
Wijzigingen in upstream-bronnen worden meestal opgeslagen met patchbestanden, maar niet alle wijzigingen kunnen
worden weergegeven met patches: ze kunnen alleen de inhoud van platte tekstbestanden wijzigen. als jij
probeer een bestand te vervangen door iets van een ander type (bijvoorbeeld het vervangen van een gewoon
bestand met een symbolische link of een map), krijgt u deze foutmelding.

onlangs aangemaakt leeg filet filet wil niet be vertegenwoordigd in diff
Lege bestanden kunnen niet worden gemaakt met patchbestanden. Deze wijziging wordt dus niet geregistreerd in de
source-pakket en u wordt ervoor gewaarschuwd.

uitvoerbaar mode permanenten of filet wil niet be vertegenwoordigd in diff
Patchbestanden registreren geen machtigingen van bestanden en dus zijn uitvoerrechten dat ook niet
opgeslagen in het bronpakket. Deze waarschuwing herinnert u daaraan.

special mode permanenten of filet wil niet be vertegenwoordigd in diff
Patchbestanden registreren geen machtigingen van bestanden en dus zijn gewijzigde machtigingen niet
opgeslagen in het bronpakket. Deze waarschuwing herinnert u daaraan.

FILE FORMATS

debian/bron/formaat
Dit bestand bevat op een enkele regel het formaat dat moet worden gebruikt om de broncode te bouwen
pakket (mogelijke formaten zijn hierboven beschreven). Er zijn geen voorloop- of volgspaties toegestaan.

debian/source/include-binaries
Dit bestand bevat een lijst met binaire bestanden (één per regel) die moeten worden opgenomen in de
debian tarball. Voorloop- en volgspaties worden verwijderd. Regels die beginnen met '#' zijn
opmerkingen en worden overgeslagen. Lege regels worden genegeerd.

debian/bron/opties
Dit bestand bevat een lijst met lange opties die automatisch moeten worden toegevoegd aan de
set opdrachtregelopties van a dpkg-bron --bouwen or dpkg-bron --afdrukformaat noemen.
Opties zoals --compressie en --compressie-niveau zijn goed geschikt voor dit bestand.

Elke optie moet op een aparte regel worden geplaatst. Lege regels en regels die beginnen met '#' zijn
buiten beschouwing gelaten. de leidende '--' moeten worden gestript en korte opties zijn niet toegestaan. Optioneel
spaties zijn toegestaan ​​rond de '=' symbool en optionele aanhalingstekens zijn toegestaan ​​rond de waarde.
Hier is een voorbeeld van zo'n bestand:

# laat dpkg-source een debian.tar.bz2 maken met maximale compressie
compressie = "bzip2"
compressieniveau = 9
# gebruik debian/patches/debian-changes als automatische patch
enkele-debian-patch
# negeer wijzigingen in config.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

Opmerking: formaat opties worden niet geaccepteerd in dit bestand, gebruik debian/bron/formaat
gebruiken.

debian/source/local-opties
Precies zoals debian/bron/opties behalve dat het bestand niet is opgenomen in de gegenereerde
source pakket. Het kan handig zijn om een ​​voorkeur op te slaan die is gekoppeld aan de beheerder of aan de
VCS-repository waar het bronpakket wordt onderhouden.

debian/source/local-patch-header en debian/source/patch-header
Vrije tekst die bovenop de automatische patch wordt geplaatst die is gegenereerd in de indelingen "2.0" of
“3.0 (dekbed)”. lokale-patch-header is niet opgenomen in het gegenereerde broncodepakket terwijl
patch-header hij precies is.

debian/patches/series
Dit bestand bevat alle patches die moeten worden toegepast (in de opgegeven volgorde) bovenop de
stroomopwaarts bronpakket. Voorloop- en volgspaties worden verwijderd. Regels die beginnen met
'#' zijn opmerkingen en worden overgeslagen. Lege regels worden genegeerd. Overige regels beginnen met a
patch bestandsnaam (ten opzichte van de debian/patches/ directory) tot het eerste spatieteken
of het einde van de lijn. Optioneel quilt opties kunnen volgen tot het einde van de regel of de eerste
'#' voorafgegaan door een of meer spaties (die het begin van een opmerking markeren tot het einde van
lijn).

Gebruik dpkg-source online met onworks.net-services