dpkg-source - Online în cloud

PROGRAM:

NUME

dpkg-source - Instrument de manipulare a pachetului sursă Debian (.dsc).

REZUMAT

dpkg-source [opțiune...] comandă

DESCRIERE

dpkg-source împachetează și despachetează arhivele sursă Debian.

Niciuna dintre aceste comenzi nu permite combinarea mai multor opțiuni într-una singură și nu o fac
permite ca valoarea unei opțiuni să fie specificată într-un argument separat.

COMANDE

-x, --extrage nume de fișier.dsc [directorul de ieșire]
Extrageți un pachet sursă (--extrage din dpkg 1.17.14). Un argument fără opțiune
trebuie furnizat, numele fișierului de control sursă Debian (.dsc). Un optional
al doilea argument non-opțiune poate fi furnizat pentru a specifica directorul de extragere
pachetul sursă la, acesta nu trebuie să existe. Dacă nu este specificat niciun director de ieșire, fișierul
pachetul sursă este extras într-un director numit sursă-versiune sub curent
directorul de lucru.

dpkg-source va citi numele celorlalte fișiere care alcătuiesc pachetul sursă
din dosarul de control; se presupune că se află în același director ca și .dsc.

Fișierele din pachetul extras vor avea permisiunile și proprietățile setate
la cele care ar fi fost de așteptat dacă fișierele și directoarele ar fi fost pur și simplu
au fost create - directoarele și fișierele executabile vor fi 0777 și fișierele simple
fie 0666, ambele modificate de umasca extractoarelor; dacă directorul părinte este setgid
atunci directoarele extrase vor fi și ele și toate fișierele și directoarele vor fi
moștenește proprietatea asupra grupului său.

Dacă pachetul sursă folosește un format non-standard (în prezent, aceasta înseamnă toate formatele
cu excepția „1.0”), numele său va fi stocat în debian/sursă/format astfel încât
următoarele versiuni ale pachetului sursă folosesc în mod implicit același format.

-b, --construi director [parametri specifici formatului]
Construiți un pachet sursă (--construi din dpkg 1.17.14). Primul argument fără opțiune
este luat ca nume al directorului care conține arborele sursă debianizat (de ex
cu un subdirector debian și poate modificări la fișierele originale). Depinde de
formatul pachetului sursă utilizat pentru a construi pachetul, ar putea fi parametri suplimentari
admis.

dpkg-source va construi pachetul sursă cu primul format găsit în acesta
listă ordonată: formatul indicat cu --format opțiunea de linie de comandă,
formatul indicat în debian/sursă/format, „1.0”. Reducerea la „1.0” este
depreciat și va fi eliminat la un moment dat în viitor, ar trebui să fie întotdeauna
documentați formatul sursă dorit în debian/sursă/format. Vezi secțiunea SOURCE
PACHET FORMATE pentru o descriere extinsă a diferitelor formate de pachete sursă.

--format-imprimare director
Tipăriți formatul sursă care ar fi folosit pentru a construi pachetul sursă dacă
dpkg-source --construi director a fost chemat (în aceleași condiții și cu aceleași
parametrii; din dpkg 1.15.5).

--inainte de a construi director
Rulați hook-ul corespunzător formatului pachetului sursă (de la dpkg 1.15.8). Acest
hook este apelat înainte de orice construcție a pachetului (dpkg-buildpackage îl numește foarte
devreme chiar înainte debian/rules curat). Această comandă este idempotentă și poate fi apelată
de mai multe ori. Nu toate formatele sursă implementează ceva în acest cârlig și acelea
care de obicei pregătesc arborele sursă pentru construcție, de exemplu, asigurându-se că
sunt aplicate corecțiile Debian.

--după-construire director
Rulați hook-ul corespunzător formatului pachetului sursă (de la dpkg 1.15.8). Acest
hook este apelat după orice construcție a pachetului (dpkg-buildpackage îl numește ultimul).
Această comandă este idempotentă și poate fi apelată de mai multe ori. Nu toate formatele sursă
implementează ceva în acest cârlig, iar cei care îl folosesc de obicei pentru a anula ce
--inainte de a construi a făcut.

--comite [director] ...
Înregistrați modificările în arborele sursă dezambalat director (de la dpkg 1.16.1). Acest
comanda poate prelua parametri suplimentari în funcție de formatul sursei. Se va
eroare pentru formatele în care această operațiune nu înseamnă nimic.

-?, --Ajutor
Afișați mesajul de utilizare și ieșiți.

--versiune
Afișați versiunea și ieșiți.

OPŢIUNI

General construi Opțiuni
-cfişier de control
Specifică fișierul principal de control sursă din care să citească informațiile. Valoarea implicită este
debian / control. Dacă este dat cu o cale relativă, aceasta este interpretată începând cu
directorul de nivel superior al arborelui sursă.

-lfişier-registrul modificărilor
Specifică fișierul jurnal de modificări din care se citește informațiile. Valoarea implicită este
debian/changelog. Dacă este dat cu o cale relativă, aceasta este interpretată începând cu
directorul de nivel superior al arborelui sursă.

-Fformat de jurnal de modificări
Specifică formatul jurnalului de modificări. Vedea dpkg-parsechangelog(1) pentru informare
despre formate alternative.

--format=valoare
Utilizați formatul dat pentru construirea pachetului sursă (de la dpkg 1.14.17). Da
suprascrie orice format dat în debian/sursă/format.

-Vnume=valoare
Setați o variabilă de substituție a ieșirii. Vedea deb-substvars(5) pentru o discuție despre
substituție de ieșire.

-Tsubstvars-file
Citiți variabilele de substituție în substvars-file; implicit este să nu citești niciun fișier.
Această opțiune poate fi utilizată de mai multe ori pentru a citi variabilele de substituție din mai multe
fișiere (începând cu dpkg 1.15.6).

-Dcamp=valoare
Suprascrieți sau adăugați un câmp de fișier de control de ieșire.

-Ucamp
Eliminați un câmp de fișier de control de ieșire.

-Zcomprimare, --comprimare=comprimare
Specificați compresia de utilizat pentru fișierele tarball și fișierele diff create (--comprimare
din dpkg 1.15.5). Rețineți că această opțiune nu va determina apariția tarball-urilor existente
recomprimat, afectează doar fișierele noi. Valorile acceptate sunt: gzip, bzip2, lzma
și xz. Implicit este xz pentru formatele 2.0 și mai noi și gzip pentru formatul 1.0. xz
este acceptat numai de la dpkg 1.15.5.

-znivel, --nivel-compresie=nivel
Nivel de compresie de utilizat (--nivel-compresie din dpkg 1.15.5). Ca și în cazul -Z it
afectează numai fișierele nou create. Valorile acceptate sunt: 1 la 9, Cel mai bun, și rapid.
Valoarea implicită este 9 pentru gzip și bzip2, 6 pentru xz și lzma.

-i[regex], --dif-ignora[=regex]
Puteți specifica o expresie regulată perl pentru a se potrivi cu fișierele din care doriți să fie filtrate
lista de fișiere pentru diferența (--dif-ignora din dpkg 1.15.6). (Această listă este
generat de o comandă find.) (Dacă pachetul sursă este construit ca versiune 3
pachet sursă folosind un VCS, acesta poate fi folosit pentru a ignora modificările necommitate pe
fisiere specifice. Folosirea -i.* le va ignora pe toate.)

-i opțiunea de la sine activează această setare cu o expresie regex implicită (păstrând orice
modificarea expresiei regex implicite efectuată printr-o utilizare anterioară a --extinde-dif-ignora)
care va filtra fișierele de control și directoarele celei mai comune versiuni
sisteme de control, fișiere de backup și schimb și Libtool construiește directoare de ieșire. Acolo
poate fi doar un regex activ, din mai multe -i opțiuni doar ultima va lua
efect.

Acest lucru este foarte util pentru a elimina fișierele străine care sunt incluse în diferență,
de exemplu, dacă vă mențineți sursa într-un sistem de control al reviziilor și doriți să utilizați a
checkout pentru a construi un pachet sursă fără a include fișierele suplimentare și
directoarele pe care le va conține de obicei (de ex. CVS/, .cvsignore, .svn/). The
expresia regex implicită este deja foarte exhaustivă, dar dacă trebuie să o înlocuiți, vă rugăm
rețineți că în mod implicit se poate potrivi cu orice parte a unei căi, deci dacă doriți să se potrivească cu
începutul unui nume de fișier sau numai nume de fișiere complete, va trebui să furnizați cele necesare
ancore (de exemplu, „(^|/)”, „($|/)”) însuți.

--extinde-dif-ignora=regex
Expresia regulată perl specificată va extinde valoarea implicită folosită de
--dif-ignora și valoarea sa curentă, dacă este setată (de la dpkg 1.15.6). Face asta prin
concatenare „|regex” la valoarea existentă. Această opțiune este convenabilă de utilizat
debian/source/options pentru a exclude unele fișiere generate automat din corecția automată
generaţie.

-I[fisier-model], --tar-ignora[=fisier-model]
Dacă se specifică această opțiune, modelul va fi transmis gudron(1). --exclude
opțiunea când este apelată pentru a genera un fișier .orig.tar sau .tar (--tar-ignora întrucât
dpkg 1.15.6). De exemplu, -ICVS va face ca tar să sari peste directoarele CVS când
generând un fișier .tar.gz. Opțiunea poate fi repetată de mai multe ori pentru a lista
modele multiple de exclus.

-I de la sine adaugă implicit --exclude opțiuni care vor filtra fișierele de control și
directoare ale celor mai comune sisteme de control al reviziilor, fișiere de rezervă și swap și
Libtool construiește directoare de ieșire.

Notă: Deși au scopuri similare, -i și -I au sintaxă foarte diferită și
semantică. -i poate fi specificat o singură dată și ia o expresie regulată compatibilă cu Perl
care se potrivește cu calea relativă completă a fiecărui fișier. -I poate specifica mai multe
ori și ia un model de nume de fișier cu caractere wildcards shell. Modelul este aplicat
cale relativă completă, dar și către fiecare parte a căii în mod individual. Semantica exactă a
gudronului --exclude opțiunea este oarecum complicată, vezi
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Regex și modelele implicite pentru ambele opțiuni pot fi văzute în rezultatul --Ajutor
comanda.

General extrage Opțiuni
--fără-copie
Nu copiați tarball-urile originale lângă pachetul sursă extras (din moment ce dpkg
1.14.17).

--nu-verifica
Nu verificați semnăturile și sumele de verificare înainte de a despacheta (de la dpkg 1.14.17).

--require-valid-signature
Refuzați despachetarea pachetului sursă dacă nu conține o semnătură OpenPGP care
poate fi verificat (din dpkg 1.15.0) fie cu cel al utilizatorului trustedkeys.gpg breloc,
unul dintre brelourile specifice furnizorului sau unul dintre brelourile oficiale Debian
(/usr/share/keyrings/debian-keyring.gpg și
/usr/share/keyrings/debian-maintainers.gpg).

--ignora-versiunea-rea
Transformă verificarea proastă a versiunii pachetului sursă într-o avertizare nefatală (din moment ce dpkg
1.17.7). Această opțiune ar trebui să fie necesară numai atunci când extrageți sursa antică
pachete cu versiuni rupte, doar pentru compatibilitate inversă.

SOURCE PACHET FORMATE

Dacă nu știți ce format sursă să utilizați, probabil că ar trebui să alegeți fie „3.0 (quilt)”
sau „3.0 (nativ)”. Consultați https://wiki.debian.org/Projects/DebSrc3.0 pentru informații despre
implementarea acelor formate în Debian.

Format: 1.0
Un pachet sursă în acest format constă fie din a .orig.tar.gz asociat cu a .dif.gz
sau un singur .tar.gz (în acest caz se spune că pachetul este nativ).

Extragerea

Extragerea unui pachet nativ este o simplă extragere a singurului tarball din țintă
director. Extragerea unui pachet non-nativ se face prin despachetarea mai întâi a .orig.tar.gz și
apoi aplicand plasturele continut in .dif.gz fişier. Marca temporală a tuturor fișierelor corectate
este resetat la timpul de extragere a pachetului sursă (acest lucru evită distorsiunile marcajului de timp).
la problemele când fișierele generate automat sunt corectate). Diferența poate crea fișiere noi (
întregul director debian este creat în acest fel), dar nu pot elimina fișiere (fișierele goale vor fi
resturi).

Clădire

Construirea unui pachet nativ înseamnă doar crearea unui singur tarball cu directorul sursă.
Construirea unui pachet non-nativ implică extragerea tarball-ului original într-o formă separată
Directorul „.orig” și regenerarea fișierului .dif.gz prin compararea pachetului sursă director
cu directorul .orig.

Construi Opțiuni (cu --construi):

Dacă este furnizat un al doilea argument fără opțiune, acesta ar trebui să fie numele sursei originale
director sau tarfile sau șirul gol dacă pachetul este unul specific Debian și așadar
nu are diferențe de debianizare. Dacă nu este furnizat un al doilea argument, atunci dpkg-source va arata
pentru fișierul tar sursă original package_upstream-version.orig.tar.gz sau original
directorul sursă director.orig depinzând de -s x argumente.

-sa, -sp, -SK, -su și -sr nu va suprascrie fișierele tar sau directoare existente. Dacă aceasta este
dorit atunci -sA, -sP, -sK, -a lui și -sR ar trebui folosit în schimb.

-SK Specifică să așteptați sursa originală ca fișier tar, în mod implicit pachet_în amonte-
versiune.orig.tar.extensie. Aceasta va lăsa această sursă originală în loc ca a
tarfile sau copiați-l în directorul curent dacă nu este deja acolo. Tarballul
va fi despachetat în director.orig pentru generarea dif.

-sp Aprecieri -SK dar va elimina directorul din nou ulterior.

-su Specifică faptul că sursa originală este așteptată ca director, în mod implicit pachet-
versiunea în amonte.orig și dpkg-source va crea o nouă arhivă sursă originală
din ea.

-sr Aprecieri -su dar va elimina acel director după ce a fost folosit.

-ss Specifică faptul că sursa originală este disponibilă atât ca director, cât și ca
tarfile. dpkg-source va folosi directorul pentru a crea diferența, dar fișierul tar pentru
creați .dsc. Această opțiune trebuie utilizată cu grijă - dacă directorul și fișierul tar
nu se potrivesc cu o arhivă sursă proastă va fi generată.

-sn Specifică să nu se caute nicio sursă originală și să nu genereze o diferență. The
al doilea argument, dacă este furnizat, trebuie să fie șirul gol. Acesta este folosit pentru Debian-
pachete specifice care nu au o sursă separată în amonte și, prin urmare, au
nu există diferențe de debianizare.

-sa or -sA
Specifică să căutați arhiva sursă originală ca fișier tar sau ca director -
al doilea argument, dacă există, poate fi fie sau șirul gol (acesta este echivalent
la utilizarea -sn). Dacă se găsește un fișier tar, îl va despacheta pentru a crea diferența și
îndepărtați-l după aceea (acest lucru este echivalent cu -sp); dacă se găsește un director, va fi
împachetați-l pentru a crea sursa originală și eliminați-o ulterior (acest lucru este echivalent
la -sr); dacă niciunul nu este găsit, se va presupune că pachetul nu are debianizare
diffs, doar o arhivă sursă simplă (aceasta este echivalentă cu -sn). Dacă ambele
sunt găsite atunci dpkg-source va ignora directorul, suprascriindu-l, dacă -sA a fost
specificat (acest lucru este echivalent cu -sP) sau ridică o eroare dacă -sa a fost specificat. -sA
este implicit.

--abort-on-upstream-changes
Procesul eșuează dacă diferența generată conține modificări ale fișierelor din afara
subdirectorul debian (de la dpkg 1.15.8). Această opțiune nu este permisă
debian/source/options dar poate fi folosit în debian/source/local-options.

Extrage Opțiuni (cu --extrage):

În toate cazurile, orice arbore sursă original existent va fi eliminat.

-sp Folosit la extragere, atunci sursa originală (dacă există) va fi lăsată ca fișier tar.
Dacă nu se află deja în directorul curent sau dacă există un dar
alt fișier este acolo, va fi copiat acolo. (Acest is il lipsă).

-su Dezambalează arborele sursă original.

-sn Se asigură că sursa originală nu este nici copiată în directorul curent, nici
despachetat. Orice arbore sursă original care a fost în directorul curent este încă
îndepărtat.

Toate -sX opțiunile se exclud reciproc. Dacă specificați mai mult de unul doar ultimul
va fi folosit.

--skip-debianization
Omite aplicarea debian diff peste sursele din amonte (din moment ce dpkg
1.15.1).

Format: 2.0
Extragerea acceptată începând cu dpkg 1.13.9, clădire acceptată începând cu dpkg 1.14.8. De asemenea stiut
ca perucă și pix. Acest format nu este recomandat pentru utilizare pe scară largă, formatul „3.0 (pilotă)”
îl înlocuiește. Wig&pen a fost prima specificație a unui pachet sursă de nouă generație
format.

Comportamentul acestui format este același cu formatul „3.0 (quilt)”, cu excepția faptului că acesta
nu folosește o listă explicită de patch-uri. Toate fișierele în debian/patch-uri/ potrivindu-se cu perl
expresie uzuala [\w-]+ trebuie să fie plasturi validi: se aplică în momentul extracției.

La construirea unui nou pachet sursă, orice modificare a sursei din amonte este stocată într-un patch
numit zz_debian-diff-auto.

Format: 3.0 (nativ)
Suportat începând cu dpkg 1.14.17. Acest format este o extensie a formatului de pachet nativ ca
definit în formatul 1.0. Acceptă toate metodele de compresie și va ignora în mod implicit
orice fișiere și directoare specifice VCS, precum și multe fișiere temporare (consultați valoarea implicită
asociat cu -I opțiune în --Ajutor ieșire).

Format: 3.0 (pilota)
Suportat începând cu dpkg 1.14.17. Un pachet sursă în acest format conține cel puțin un
tarball original (.orig.tar.ext Unde ext poate fi gz, bz2, lzma și xz) și un debian
tarball (.debian.tar.ext). De asemenea, poate conține tarball-uri originale suplimentare
(.orig-component.gudron.ext). component poate conține doar caractere alfanumerice și cratime
('-').

Extragerea

Mai întâi se extrage tarball-ul original principal, apoi se extrage toate tarball-urile originale suplimentare
extrase în subdirectoare numite după component parte a numelui fișierului lor (orice pre-
directorul existent este înlocuit). Debian tarball este extras deasupra sursei
director după eliminarea prealabilă a oricărui director preexistent Debian director. Rețineți că debian
tarball trebuie să conțină a Debian sub-director, dar poate conține și fișiere binare în exterior
din acel director (vezi --include-binare opțiune).

Toate patch-urile enumerate în debian/patches/debian.series or debian/patch-uri/serie sunt atunci
aplicat. Dacă se folosește primul fișier și cel din urmă nu există (sau este un link simbolic),
apoi cel din urmă este înlocuit cu o legătură simbolică către primul. Acest lucru este menit să simplifice utilizarea
of cuvertură pentru a gestiona setul de patch-uri. Rețineți totuși că în timp ce dpkg-source analizează
fișierele seriale corecte cu opțiuni explicite utilizate pentru aplicarea corecțiilor (stocate pe fiecare
după numele fișierului patch-ului și unul sau mai multe spații), ignoră acele opțiuni și
așteptați întotdeauna plasturi care pot fi aplicați cu -p1 opțiunea de a plasture. Va emite astfel
un avertisment atunci când întâlnește astfel de opțiuni și este probabil ca construcția să eșueze.

Marca temporală a tuturor fișierelor corectate este resetată la ora de extragere a pachetului sursă
(acest lucru evită distorsiunile marcajului de timp care duc la probleme atunci când fișierele generate automat sunt corecţionate).

Contrar la cuverturăComportamentul implicit al lui, se așteaptă ca patch-urile să se aplice fără niciun fel de fuzz.
Când nu este cazul, ar trebui să reîmprospătați astfel de patch-uri cuvertură, Sau dpkg-source voi
eroare în timp ce încercați să le aplicați.

În mod similar cu cuverturăComportamentul implicit al lui, patch-urile pot elimina și fișiere.

Fișierul .pc/patch-uri aplicate este creat dacă unele patch-uri au fost aplicate în timpul
extracţie.

Clădire

Toate tarball-urile originale găsite în directorul curent sunt extrase temporar
directorul urmând aceeași logică ca și pentru dezambalare, directorul debian este copiat
peste în directorul temporar și toate patch-urile, cu excepția patch-ului automat
(Debian-schimbări-versiune or debian-schimbări, în funcție de --single-debian-patch) sunteți
aplicat. Directorul temporar este comparat cu directorul pachetului sursă. Cand
diff nu este gol, compilarea eșuează dacă nu --single-debian-patch or --auto-commit a fost
utilizat, caz în care diferența este stocată în patch-ul automat. Dacă patch-ul automat este
creat/șters, este adăugat/șters din fișierul serie și din fișierul cuvertură metadate.

Orice modificare a unui fișier binar nu este reprezentabilă într-un difer și va duce astfel la un eșec
cu excepția cazului în care întreținătorul a decis în mod deliberat să includă acel fișier binar modificat în fișierul
debian tarball (prin listarea acestuia în debian/source/include-binaries). De asemenea, construcția va eșua
dacă găsește fișiere binare în subdirectorul debian, cu excepția cazului în care acestea au fost incluse în lista albă
prin debian/source/include-binaries.

Directorul Debian actualizat și lista de binare modificate sunt apoi folosite pentru a genera
tarball-ul Debian.

Diferența generată automat nu include și modificări ale fișierelor specifice VCS
multe fișiere temporare (vezi valoarea implicită asociată cu -i opțiune în --Ajutor ieșire). În
în special, cel .buc director folosit de cuvertură este ignorat în timpul generării automatului
plasture.

Notă: dpkg-source --inainte de a construi (Și --construi) se va asigura că toate patch-urile enumerate în
serie sunt aplicate astfel încât o construcție de pachet să aibă întotdeauna aplicate toate patch-urile. Da
aceasta prin găsirea de plasturi neaplicați (acestea sunt listate în serie fișier dar nu în
.pc/patch-uri aplicate), iar dacă primul patch din acel set poate fi aplicat fără erori, acesta
le va aplica pe toate. Optiunea --fără pregătire poate fi folosit pentru a dezactiva acest comportament.

Înregistrare schimbari

--comite [director] [nume-patch] [fisier-patch]
Generează un patch corespunzător modificărilor locale care nu sunt gestionate de
cuvertură patch system și îl integrează în sistemul de patch-uri sub numele nume-patch.
Dacă numele lipsește, acesta va fi întrebat interactiv. Dacă fisier-patch este dat, ea
este folosit ca patch-ul corespunzător modificărilor locale de integrat. O singura data
integrat, se lansează un editor, astfel încât să puteți edita metainformațiile din
antetul patch-ului.

Care trece fisier-patch este util în principal după o eroare de construcție care a generat acest lucru în prealabil
fișier, iar pe acest motiv fișierul dat este eliminat după integrare. De asemenea, rețineți
că modificările conținute în fișierul de corecție trebuie deja aplicate pe arbore
și că fișierele modificate de patch nu trebuie să aibă neînregistrate suplimentare
schimbări.

Dacă generarea de corecții detectează fișiere binare modificate, acestea vor fi automate
adăugate debian/source/include-binaries astfel încât să ajungă în tarball-ul debian
(exact ca dpkg-source --include-binare --construi ar face).

Construi Opțiuni

--allow-version-of-quilt-db=versiune
Permite dpkg-source pentru a construi pachetul sursă dacă versiunea cuvertură metadate
este cea specificată, chiar dacă dpkg-source nu știe despre asta (din moment ce dpkg
1.15.5.4). De fapt, acest lucru spune că versiunea dată a cuvertură metadatele este
compatibil cu versiunea 2 care dpkg-source suportă în prezent. Versiunea lui
il cuvertură metadatele sunt stocate în versiunea .pc/.

--include-eliminare
Nu ignorați fișierele eliminate și includeți-le în patch-ul generat automat.

--include-timestamp
Includeți marcajul de timp în patch-ul generat automat.

--include-binare
Adăugați toate binarele modificate în tarball debian. De asemenea, adăugați-le la
debian/source/include-binaries: vor fi adăugate implicit în versiunile ulterioare
și, prin urmare, această opțiune nu mai este necesară.

--fără pregătire
Nu încercați să pregătiți arborele de construcție aplicând petice care aparent sunt
neaplicat (din dpkg 1.14.18).

--single-debian-patch
Utilizare debian/patches/debian-changes în loc de debian/patches/debian-changes-versiune
pentru numele patch-ului automat generat în timpul construirii (de la dpkg 1.15.5.4).
Această opțiune este deosebit de utilă atunci când pachetul este menținut într-un VCS și a
setul de corecții nu poate fi generat în mod fiabil. În schimb, diferența actuală cu amonte
trebuie păstrat într-un singur plasture. Opțiunea ar fi introdusă
debian/source/local-options și ar fi însoțit de a
debian/source/local-patch-header fișier care explică cum pot fi cele mai bune modificările Debian
revizuit, de exemplu în VCS care este utilizat.

--creează-gol-orig
Creați automat tarball-ul original principal ca gol dacă lipsește și dacă
există tarball-uri originale suplimentare (de la dpkg 1.15.6). Această opțiune este
menit să fie folosit atunci când pachetul sursă este doar un pachet de mai multe în amonte
software și unde nu există software „principal”.

--no-unapply-patchs, --unapply-patch-uri
În mod implicit, dpkg-source va anula automat patch-urile din --după-construire
cârlig dacă le-a aplicat în timpul --inainte de a construi (--unapply-patch-uri din moment ce dpkg
1.15.8, --no-unapply-patchs din dpkg 1.16.5). Aceste opțiuni vă permit
dezactivați sau activați forțat procesul de dezactivare a corecțiilor. Aceste opțiuni sunt
permis doar să intre debian/source/local-options astfel încât toate pachetele sursă generate
au același comportament în mod implicit.

--abort-on-upstream-changes
Procesul eșuează dacă a fost generat un patch automat (de la dpkg 1.15.8).
Această opțiune poate fi utilizată pentru a vă asigura că toate modificările au fost înregistrate corect în
distinct cuvertură patch-uri înainte de construirea pachetului sursă. Această opțiune nu este
permis in debian/source/options dar poate fi folosit în debian/source/local-options.

--auto-commit
Procesul nu eșuează dacă a fost generat un patch automat, ci este
înregistrat imediat în cuvertură serie.

Extrage Opțiuni

--skip-debianization
Omite extragerea tarball-ului debian peste sursele din amonte (din moment ce dpkg
1.15.1).

--skip-patch-uri
Nu aplicați plasturi la sfârșitul extracției (de la dpkg 1.14.18).

Format: 3.0 (personalizat)
Suportat începând cu dpkg 1.14.17. Acest format este special. Nu reprezintă o sursă reală
format de pachet, dar poate fi folosit pentru a crea pachete sursă cu fișiere arbitrare.

Construi Opțiuni

Toate argumentele non-opțiuni sunt luate ca fișiere pentru a fi integrate în pachetul sursă generat.
Ele trebuie să existe și să fie de preferință în directorul curent. Trebuie să existe cel puțin un fișier
dat.

--target-format=valoare
Necesar. Definește formatul real al pachetului sursă generat. Cel generat
Fișierul .dsc va conține această valoare Format câmp și nu „3.0 (personalizat)”.

Format: 3.0 (git)
Suportat începând cu dpkg 1.14.17. Acest format este experimental.

Un pachet sursă în acest format constă dintr-un singur pachet dintr-un depozit git .git la
ține sursa unui pachet. Poate exista și o .gitshallow revizuirile listei de fișiere pentru
o clonă git superficială.

Extragerea

Pachetul este clonat ca depozit git în directorul țintă. Daca este o
gitshallow, este instalat ca .git/shallow în interiorul depozitului git clonat.

Rețineți că, în mod implicit, noul depozit va avea aceeași ramură verificată
verificat în sursa originală. (De obicei, „stăpân”, dar ar putea fi orice.) Oricare
alte sucursale vor fi disponibile sub telecomenzi/origine/.

Clădire

Înainte de a merge mai departe, se fac unele verificări pentru a ne asigura că nu avem niciun
a ignorat modificările neangajate.

git-bundle(1) este folosit pentru a genera un pachet din depozitul git. Implicit, toate
ramurile și etichetele din depozit sunt incluse în pachet.

Construi Opțiuni

--git-ref=ref
Permite specificarea unui ref git care să fie inclus în pachetul git. Utilizare dezactivează valoarea implicită
comportament de includere a tuturor ramurilor și etichetelor. Poate fi specificat de mai multe ori. The
ref poate fi numele unei ramuri sau etichete de inclus. Poate fi, de asemenea, orice parametru
care poate fi transmis git-rev-list(1). De exemplu, pentru a include doar masterul
ramură, folosire --git-ref=maestru. Pentru a include toate etichetele și ramurile, cu excepția
sucursală privată, folosire --git-ref=--toate --git-ref=^privat

--git-depth=număr
Creează o clonă superficială cu un istoric trunchiat la numărul specificat de
revizuiri.

Format: 3.0 (bzr)
Suportat începând cu dpkg 1.14.17. Acest format este experimental. Acesta generează un singur tarball
care conține depozitul bzr.

Extragerea

Tarball-ul este despachetat și apoi bzr este folosit pentru a verifica ramura curentă.

Clădire

Înainte de a merge mai departe, se fac unele verificări pentru a ne asigura că nu avem niciun
a ignorat modificările neangajate.

Apoi, partea specifică VCS a directorului sursă este copiată într-un fișier temporar
director. Înainte ca acest director temporar să fie împachetat într-un tarball, sunt diferite curățări
făcut pentru a economisi spațiu.

DIAGNOSTIC

Nu. sursă format specificată in debian/sursă/format
Fișierul debian/sursă/format ar trebui să existe întotdeauna și să indice formatul sursă dorit.
Pentru compatibilitate inversă, formatul „1.0” este asumat atunci când fișierul nu există decât dvs
nu ar trebui să se bazeze pe asta: la un moment dat în viitor dpkg-source va fi modificat pentru a eșua
când acel fișier nu există.

Motivul este că formatul „1.0” nu mai este formatul recomandat, ar trebui de obicei
alegeți unul dintre formatele mai noi (“3.0 (pilotă)”, „3.0 (nativ)”), dar dpkg-source nu va face
asta automat pentru tine. Dacă doriți să continuați să utilizați vechiul format, ar trebui să fie
explicit despre asta și introduceți „1.0”. debian/sursă/format.

il dif modifică il următor amonte fișiere
Când utilizați formatul sursă „1.0”, este de obicei o idee proastă să modificați direct fișierele din amonte
deoarece modificările ajung ascunse și în mare parte nedocumentate în fișierul .diff.gz. În schimb tu
ar trebui să vă stocheze modificările ca patch-uri în directorul debian și să le aplice în timpul construirii.
Pentru a evita această complexitate, puteți utiliza și formatul „3.0 (quilt)” care oferă acest lucru
nativ.

nu poti reprezenta Schimbare la fişier
Modificările la sursele din amonte sunt de obicei stocate cu fișiere de corecție, dar nu toate modificările pot
să fie reprezentate cu patch-uri: pot modifica doar conținutul fișierelor text simplu. daca tu
încercați să înlocuiți un fișier cu ceva de alt tip (de exemplu, înlocuiți un fișier simplu
fișier cu un link simbolic sau un director), veți primi acest mesaj de eroare.

recent a creat gol fişier fişier voi nu be reprezentate in dif
Fișierele goale nu pot fi create cu fișiere de corecție. Astfel, această modificare nu este înregistrată în
pachet sursă și sunteți avertizat despre asta.

executabil mod perm of fişier voi nu be reprezentate in dif
Fișierele de corecție nu înregistrează permisiunile fișierelor și, prin urmare, permisiunile executabile nu sunt
stocate în pachetul sursă. Acest avertisment vă amintește de acest fapt.

special mod perm of fişier voi nu be reprezentate in dif
Fișierele de corecție nu înregistrează permisiunile fișierelor și, prin urmare, permisiunile modificate nu sunt
stocate în pachetul sursă. Acest avertisment vă amintește de acest fapt.

FILE FORMATE

debian/sursă/format
Acest fișier conține pe o singură linie formatul care ar trebui folosit pentru a construi sursa
pachet (formatele posibile sunt descrise mai sus). Nu sunt permise spații de început sau de final.

debian/source/include-binaries
Acest fișier conține o listă de fișiere binare (unul pe linie) care ar trebui incluse în fișierul
debian tarball. Spațiile de conducere și de sfârșit sunt dezbrăcate. Linii care încep cu „#' sunt
comentarii și sunt omise. Liniile goale sunt ignorate.

debian/source/options
Acest fișier conține o listă de opțiuni lungi care ar trebui să fie adăugate automat înaintea fișierului
set de opțiuni de linie de comandă ale a dpkg-source --construi or dpkg-source --format-imprimare apel.
Opțiuni de genul --comprimare și --nivel-compresie sunt potrivite pentru acest fișier.

Fiecare opțiune ar trebui pusă pe o linie separată. Linii goale și linii care încep cu „#' sunt
ignorat. liderul'--' ar trebui eliminate și opțiunile scurte nu sunt permise. Opțional
sunt permise spații în jurul „=simbolul și ghilimele opționale sunt permise în jurul valorii.
Iată un exemplu de astfel de fișier:

# lăsați dpkg-source să creeze un debian.tar.bz2 cu compresie maximă
compresie = "bzip2"
nivel de compresie = 9
# utilizați debian/patches/debian-changes ca corecție automată
single-debian-patch
# ignora modificările la config.{sub,guess}
extend-diff-ignore = „(^|/)(config.sub|config.guess)$”

Notă: format opțiunile nu sunt acceptate în acest fișier, ar trebui să utilizați debian/sursă/format
in schimb.

debian/source/local-options
Exact ca debian/source/options cu excepția faptului că fișierul nu este inclus în fișierul generat
pachet sursă. Poate fi util să stocați o preferință legată de întreținător sau de
Depozitul VCS unde este menținut pachetul sursă.

debian/source/local-patch-header și debian/source/patch-header
Text în formă liberă care este pus peste patch-ul automat generat în formatele „2.0” sau
„3.0 (pilotă)”. local-patch-header nu este inclus în pachetul sursă generat în timp ce
patch-header este.

debian/patch-uri/serie
Acest fișier listează toate corecțiile care trebuie aplicate (în ordinea dată) deasupra fișierului
pachet sursă în amonte. Spațiile de conducere și de sfârșit sunt dezbrăcate. Rânduri care încep cu
"#' sunt comentarii și sunt omise. Liniile goale sunt ignorate. Rândurile rămase încep cu a
numele fișierului patch (relativ cu debian/patch-uri/ director) până la primul caracter spațiu
sau sfârșitul rândului. Opțional cuvertură opțiunile pot urma până la sfârșitul rândului sau primul
"#' precedat de unul sau mai multe spații (care marchează începutul unui comentariu până la sfârșitul lui
linia).

Utilizați dpkg-source online folosind serviciile onworks.net