dpkg-source - Online sa Cloud

PROGRAMA:

NAME

dpkg-source - tool sa pagmamanipula ng Debian source package (.dsc).

SINOPSIS

dpkg-source [opsyon...] utos

DESCRIPTION

dpkg-source i-pack at i-unpack ang mga archive ng pinagmulan ng Debian.

Wala sa mga utos na ito ang nagpapahintulot sa maraming opsyon na pagsamahin sa isa, at hindi
payagan ang halaga para sa isang opsyon na matukoy sa isang hiwalay na argumento.

UTOS

-x, --extract filename.dsc [output-directory]
Mag-extract ng source package (--extract mula noong dpkg 1.17.14). Isang hindi opsyon na argumento
dapat ibigay, ang pangalan ng Debian source control file (.dsc). Isang opsyonal
pangalawang argumento na hindi opsyon ay maaaring ibigay upang tukuyin ang direktoryo upang kunin ang
source package to, hindi ito dapat umiral. Kung walang tinukoy na direktoryo ng output, ang
source package ay nakuha sa isang direktoryo na pinangalanan pinagmulan-bersyon sa ilalim ng agos
gumaganang direktoryo.

dpkg-source babasahin ang mga pangalan ng iba pang (mga) file na bumubuo sa source package
mula sa control file; sila ay ipinapalagay na nasa parehong direktoryo ng .dsc.

Magkakaroon ng mga pahintulot at pagmamay-ari ang mga file sa na-extract na package
sa mga inaasahan kung ang mga file at direktoryo ay simple
nalikha - ang mga direktoryo at mga executable na file ay magiging 0777 at ang mga payak na file ay magiging
maging 0666, parehong binago ng umask ng mga extractor; kung ang parent directory ay setgid
pagkatapos ay ang mga na-extract na mga direktoryo ay magiging masyadong, at ang lahat ng mga file at mga direktoryo ay gagawin
magmana ng pagmamay-ari ng grupo nito.

Kung ang source package ay gumagamit ng hindi karaniwang format (kasalukuyang nangangahulugan ito ng lahat ng mga format
maliban sa "1.0"), ang pangalan nito ay maiimbak sa debian/source/format upang ang
Ang mga sumusunod na build ng source package ay gumagamit ng parehong format bilang default.

-b, --build direktoryo [format-specific-parameter]
Bumuo ng source package (--build mula noong dpkg 1.17.14). Ang unang argumentong hindi opsyon
ay kinuha bilang pangalan ng direktoryo na naglalaman ng debianized source tree (hal
na may debian sub-directory at maaaring magbago sa orihinal na mga file). Depende sa
ang format ng source package na ginamit upang buuin ang package, maaaring ang mga karagdagang parameter
tinanggap.

dpkg-source bubuo ng source package na may unang format na makikita dito
ordered list: ang format na nakasaad sa --format opsyon sa command line, ang
format na ipinahiwatig sa debian/source/format, "1.0". Ang fallback sa "1.0" ay
hindi na ginagamit at aalisin sa isang punto sa hinaharap, dapat palagi
idokumento ang gustong source format sa debian/source/format. Tingnan ang seksyon SOURCE
PACKAGE FORMATS para sa isang malawak na paglalarawan ng iba't ibang mga format ng source package.

--print-format direktoryo
I-print ang source format na gagamitin para buuin ang source package kung
dpkg-source --build direktoryo ay tinawag (sa parehong mga kondisyon at may pareho
mga parameter; mula noong dpkg 1.15.5).

--bago-buo direktoryo
Patakbuhin ang kaukulang hook ng source package format (mula noong dpkg 1.15.8). Ito
Ang hook ay tinatawag bago ang anumang build ng package (dpkg-buildpackage sobrang tawag nito
maaga pa man debian/mga panuntunan linisin). Ang utos na ito ay idempotent at maaaring tawagin
maraming beses. Hindi lahat ng source format ay nagpapatupad ng isang bagay sa hook na ito, at mga iyon
na kadalasang naghahanda sa pinagmulang puno para sa pagbuo halimbawa sa pamamagitan ng pagtiyak na iyon
inilapat ang mga patch ng Debian.

--pagkatapos-buo direktoryo
Patakbuhin ang kaukulang hook ng source package format (mula noong dpkg 1.15.8). Ito
hook ay tinatawag pagkatapos ng anumang build ng package (dpkg-buildpackage huling tawag dito).
Ang utos na ito ay idempotent at maaaring tawaging maraming beses. Hindi lahat ng source format
magpatupad ng isang bagay sa hook na ito, at ang mga karaniwang gumagamit nito upang i-undo kung ano
--bago-buo nagawa na.

--gumawa [direktoryo] ...
Itala ang mga pagbabago sa pinagmulang puno na na-unpack direktoryo (mula noong dpkg 1.16.1). Ito
Ang command ay maaaring kumuha ng mga karagdagang parameter depende sa source format. Ito ay
error out para sa mga format kung saan ang operasyong ito ay walang ibig sabihin.

-?, - Tumulong
Ipakita ang mensahe ng paggamit at lumabas.

--bersyon
Ipakita ang bersyon at lumabas.

Opsyon

Panlahat magtayo pagpipilian
-ccontrol-file
Tinutukoy ang pangunahing source control file kung saan magbabasa ng impormasyon. Ang default ay
debian / control. Kung ibinigay na may kamag-anak na pangalan ng path, ito ay binibigyang kahulugan simula sa
pinakamataas na antas ng direktoryo ng punong pinagmulan.

-lchangelog-file
Tinutukoy ang changelog file kung saan magbabasa ng impormasyon. Ang default ay
debian/changelog. Kung ibinigay na may kamag-anak na pangalan ng path, ito ay binibigyang kahulugan simula sa
pinakamataas na antas ng direktoryo ng punong pinagmulan.

-Fchangelog-format
Tinutukoy ang format ng changelog. Tingnan mo dpkg-parsechangelog(1) para sa impormasyon
tungkol sa mga alternatibong format.

--format=halaga
Gamitin ang ibinigay na format para sa pagbuo ng source package (mula noong dpkg 1.14.17). ginagawa nito
i-override ang anumang format na ibinigay debian/source/format.

-Vpangalan=halaga
Magtakda ng variable na pagpapalit ng output. Tingnan mo deb-substvars(5) para sa talakayan ng
pagpapalit ng output.

-Tsubstvars-file
Basahin ang mga variable ng pagpapalit sa substvars-file; ang default ay hindi magbasa ng anumang file.
Maaaring gamitin ang opsyong ito nang maraming beses upang basahin ang mga variable ng pagpapalit mula sa maramihang
mga file (mula noong dpkg 1.15.6).

-Dparang=halaga
I-override o magdagdag ng field ng output control file.

-Uparang
Mag-alis ng field ng output control file.

-Zpagpiga, --compression=pagpiga
Tukuyin ang compression na gagamitin para sa mga nilikhang tarball at diff file (--compression
mula noong dpkg 1.15.5). Tandaan na ang pagpipiliang ito ay hindi magiging sanhi ng mga umiiral na tarball
recompressed, ito ay nakakaapekto lamang sa mga bagong file. Ang mga sinusuportahang halaga ay: gzip, bzip2, lzma
at xz. Ang default ay xz para sa mga format na 2.0 at mas bago, at gzip para sa format na 1.0. xz
ay sinusuportahan lamang mula noong dpkg 1.15.5.

-zantas, --compression-level=antas
Antas ng compression na gagamitin (--compression-level mula noong dpkg 1.15.5). Tulad ng sa -Z it
nakakaapekto lamang sa mga bagong likhang file. Ang mga sinusuportahang halaga ay: 1 sa 9, pinakamahusay, at mabilis.
Ang default ay 9 para sa gzip at bzip2, 6 para sa xz at lzma.

-i[regex], --diff-ignore[=regex]
Maaari kang tumukoy ng perl na regular na expression upang tumugma sa mga file na gusto mong i-filter
ang listahan ng mga file para sa diff (--diff-ignore mula noong dpkg 1.15.6). (Ang listahang ito ay
nabuo sa pamamagitan ng isang find command.) (Kung ang source package ay binuo bilang isang bersyon 3
source package gamit ang isang VCS, maaari itong gamitin upang huwag pansinin ang mga hindi nakatalagang pagbabago sa
tiyak na mga file. Ang paggamit ng -i.* ay hindi papansinin ang lahat ng mga ito.)

Ang -i Ang opsyon mismo ay nagbibigay-daan sa setting na ito na may default na regex (pinapanatili ang anumang
pagbabago sa default na regex na ginawa ng nakaraang paggamit ng --extend-diff-ignore)
na magpi-filter ng mga control file at mga direktoryo ng pinakakaraniwang rebisyon
control system, backup at swap file at Libtool ay bumuo ng mga direktoryo ng output. doon
maaari lamang maging isang aktibong regex, ng maramihan -i mga pagpipilian lamang ang huling kukuha
epekto.

Malaking tulong ito sa pagputol ng mga extraneous na file na kasama sa diff,
hal kung pinananatili mo ang iyong source sa isang revision control system at gustong gumamit ng a
checkout upang bumuo ng source package nang hindi kasama ang mga karagdagang file at
mga direktoryo na kadalasang naglalaman nito (hal. CVS/, .cvsignore, .svn/). Ang
Ang default na regex ay kumpleto na, ngunit kung kailangan mo itong palitan, mangyaring
tandaan na bilang default maaari itong tumugma sa anumang bahagi ng isang landas, kaya kung gusto mong itugma ang
simula ng isang filename o mga buong filename lamang, kakailanganin mong ibigay ang kinakailangan
mga anchor (hal. '(^|/)', '($|/)') sa iyong sarili.

--extend-diff-ignore=regex
Ang perl regular na expression na tinukoy ay magpapalawak sa default na halaga na ginamit ni
--diff-ignore at ang kasalukuyang halaga nito, kung itinakda (mula noong dpkg 1.15.6). Ginagawa ito sa pamamagitan ng
pagsasama-sama "|regex” sa kasalukuyang halaga. Ang pagpipiliang ito ay maginhawang gamitin sa
debian/source/opsyon upang ibukod ang ilang mga awtomatikong nabuong file mula sa awtomatikong patch
henerasyon.

-I[file-pattern], --tar-wag pansinin[=file-pattern]
Kung tinukoy ang opsyong ito, ipapasa ang pattern sa alkitran(1)'s --ibukod
opsyon kapag tinawag ito upang bumuo ng .orig.tar o .tar file (--tar-wag pansinin mula noon
dpkg 1.15.6). Halimbawa, -IGagawin ng CVS ang tar skip sa mga direktoryo ng CVS kapag
pagbuo ng .tar.gz file. Ang opsyon ay maaaring ulitin nang maraming beses upang ilista
maraming pattern na ibubukod.

-I sa pamamagitan ng kanyang sarili ay nagdaragdag ng default --ibukod mga opsyon na magsasala ng mga control file at
mga direktoryo ng pinakakaraniwang revision control system, backup at swap file at
Libtool bumuo ng mga direktoryo ng output.

tandaan: Bagama't mayroon silang magkatulad na layunin, -i at -I may ibang iba't ibang syntax at
semantika. -i maaari lang tukuyin nang isang beses at kumukuha ng perl compatible na regular na expression
na itinugma laban sa buong kamag-anak na landas ng bawat file. -I maaaring tukuyin ang maramihang
beses at kumukuha ng pattern ng filename na may mga wildcard ng shell. Ang pattern ay inilapat sa
buong kamag-anak na landas ngunit gayundin sa bawat bahagi ng landas nang paisa-isa. Ang eksaktong semantiko ng
ng tar --ibukod ang pagpipilian ay medyo kumplikado, tingnan
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Ang default na regex at mga pattern para sa parehong mga opsyon ay makikita sa output ng - Tumulong
utos.

Panlahat kunin pagpipilian
--walang-kopya
Huwag kopyahin ang mga orihinal na tarball malapit sa kinuhang source package (dahil dpkg
1.14.17).

--walang-check
Huwag suriin ang mga lagda at checksum bago i-unpack (mula noong dpkg 1.14.17).

--require-valid-signature
Tumangging i-unpack ang source package kung wala itong OpenPGP signature na iyon
maaaring ma-verify (mula noong dpkg 1.15.0) alinman sa user trustedkeys.gpg susi,
isa sa mga keyring na partikular sa vendor, o isa sa mga opisyal na keyring ng Debian
(/usr/share/keyrings/debian-keyring.gpg at
/usr/share/keyrings/debian-maintainers.gpg).

--ignore-bad-version
Ginagawang hindi nakamamatay na babala ang masamang source package na pagsusuri (dahil dpkg
1.17.7). Ang pagpipiliang ito ay dapat lamang na kailangan kapag kumukuha ng sinaunang pinagmulan
mga pakete na may mga sirang bersyon, para lamang sa pabalik na pagkakatugma.

SOURCE PACKAGE FORMATS

Kung hindi mo alam kung anong source format ang gagamitin, malamang na pumili ka ng alinman sa “3.0 (quilt)”
o “3.0 (katutubo)”. Tingnan ang https://wiki.debian.org/Projects/DebSrc3.0 para sa impormasyon sa
deployment ng mga format na iyon sa loob ng Debian.

Format: 1.0
Ang isang source package sa format na ito ay binubuo ng alinman sa a .orig.tar.gz nauugnay sa a .diff.gz
o isang solong .tar.gz (sa kasong iyon, ang pakete ay sinasabing katutubo).

Extracting

Ang pagkuha ng katutubong pakete ay isang simpleng pagkuha ng nag-iisang tarball sa target
direktoryo. Ang pagkuha ng isang hindi katutubong pakete ay ginagawa sa pamamagitan ng unang pag-unpack ng .orig.tar.gz at
pagkatapos ay ilapat ang patch na nakapaloob sa .diff.gz file. Ang timestamp ng lahat ng naka-patch na file
ay ni-reset sa oras ng pagkuha ng source package (iniiwas nito ang mga skew ng timestamp na humahantong
sa mga problema kapag na-patch ang mga awtomatikong nabuong file). Ang diff ay maaaring lumikha ng mga bagong file (ang
buong direktoryo ng debian ay ginawa sa ganoong paraan) ngunit hindi maalis ang mga file (walang laman ang mga file
natira).

gusali

Ang pagbuo ng isang katutubong pakete ay paglikha lamang ng isang solong tarball na may direktoryo ng pinagmulan.
Ang pagbuo ng isang hindi katutubong pakete ay nagsasangkot ng pagkuha ng orihinal na tarball sa isang hiwalay
".orig" na direktoryo at muling pagbuo ng .diff.gz sa pamamagitan ng paghahambing ng source package direktoryo
gamit ang .orig na direktoryo.

Magtayo pagpipilian (may --build):

Kung ang pangalawang argumento na hindi opsyon ay ibinibigay ito dapat ang pangalan ng orihinal na pinagmulan
direktoryo o tarfile o ang walang laman na string kung ang package ay partikular sa Debian at iba pa
walang Debianization diffs. Kung walang ibinigay na pangalawang argumento dpkg-source magiging hitsura
para sa orihinal na source tarfile package_upstream-version.orig.tar.gz o ang orihinal
direktoryo ng pinagmulan direktoryo.orig depende sa -sX argumento.

-sa, -sp, -sk, -su at -sr hindi papatungan ang mga kasalukuyang tarfile o direktoryo. Kung ito ay
ninanais noon -sA, -sP, -sK, -sa kanya at -sR sa halip ay dapat gamitin.

-sk Tinutukoy na asahan ang orihinal na pinagmulan bilang isang tarfile, bilang default package_upstream-
bersyon.orig.tar.karugtong. Iiwan nito ang orihinal na pinagmulang ito bilang isang
tarfile, o kopyahin ito sa kasalukuyang direktoryo kung wala pa ito. Ang tarball
ay i-unpack sa direktoryo.orig para sa henerasyon ng diff.

-sp katulad -sk ngunit aalisin muli ang direktoryo pagkatapos.

-su Tinutukoy na ang orihinal na pinagmulan ay inaasahan bilang isang direktoryo, bilang default pakete-
upstream-version.orig at dpkg-source gagawa ng bagong orihinal na source archive
mula dito.

-sr katulad -su ngunit aalisin ang direktoryo na iyon pagkatapos itong magamit.

-ss Tinutukoy na ang orihinal na pinagmulan ay magagamit bilang isang direktoryo at bilang isang
tarfile. dpkg-source ay gagamitin ang direktoryo upang lumikha ng diff, ngunit ang tarfile sa
likhain ang .dsc. Ang pagpipiliang ito ay dapat gamitin nang may pag-iingat - kung ang direktoryo at tarfile
hindi tumutugma sa isang masamang source archive ay bubuo.

-sn Tinutukoy na huwag maghanap ng anumang orihinal na pinagmulan, at hindi makabuo ng diff. Ang
Ang pangalawang argumento, kung ibibigay, ay dapat ang walang laman na string. Ito ay ginagamit para sa Debian-
mga partikular na pakete na walang hiwalay na upstream source at samakatuwid ay mayroon
walang debianization diffs.

-sa or -sA
Tinutukoy upang hanapin ang orihinal na source archive bilang isang tarfile o bilang isang direktoryo -
ang pangalawang argumento, kung mayroon man, ay maaaring alinman, o ang walang laman na string (ito ay katumbas
na gamit -sn). Kung ang isang tarfile ay matatagpuan, ito ay i-unpack ito upang lumikha ng diff at
alisin ito pagkatapos (ito ay katumbas ng -sp); kung ang isang direktoryo ay natagpuan ito ay
i-pack ito upang lumikha ng orihinal na pinagmulan at alisin ito pagkatapos (ito ay katumbas
sa -sr); kung wala sa alinman ay natagpuan ito ay ipagpalagay na ang pakete ay walang debianization
diffs, isang tuwirang source archive lamang (ito ay katumbas ng -sn). Kung pareho
ay matatagpuan pagkatapos dpkg-source ay papansinin ang direktoryo, o-overwrite ito, kung -sA ay
tinukoy (ito ay katumbas ng -sP) o magtaas ng error kung -sa ay tinukoy. -sA
ay ang default.

--i-abort-sa-upstream-mga pagbabago
Nabigo ang proseso kung ang nabuong diff ay naglalaman ng mga pagbabago sa mga file sa labas ng
debian sub-directory (mula noong dpkg 1.15.8). Hindi pinapayagan ang opsyong ito
debian/source/opsyon ngunit maaaring gamitin sa debian/source/local-options.

Kunin pagpipilian (may --extract):

Sa lahat ng kaso, aalisin ang anumang umiiral na orihinal na puno ng pinagmulan.

-sp Ginamit kapag nag-extract pagkatapos ay ang orihinal na pinagmulan (kung mayroon man) ay maiiwan bilang isang tarfile.
Kung hindi pa ito matatagpuan sa kasalukuyang direktoryo o kung mayroon nang ngunit
ibang file ay doon ito ay makokopya doon. (ito is ang default).

-su I-unpack ang orihinal na puno ng pinagmulan.

-sn Tinitiyak na ang orihinal na pinagmulan ay hindi kinokopya sa kasalukuyang direktoryo o
na-unpack. Anumang orihinal na puno ng pinagmulan na nasa kasalukuyang direktoryo ay nananatili pa rin
inalis.

Ang lahat ng mga -sX ang mga pagpipilian ay kapwa eksklusibo. Kung tumukoy ka ng higit sa isa lamang ang huli
gagamitin.

--laktawan-debianization
Nilaktawan ang paggamit ng debian diff sa itaas ng mga upstream na pinagmumulan (dahil dpkg
1.15.1).

Format: 2.0
Sinusuportahan ang pagkuha mula noong dpkg 1.13.9, sinusuportahan ang gusali mula noong dpkg 1.14.8. Kilala rin
bilang wig&pen. Ang format na ito ay hindi inirerekomenda para sa malawakang paggamit, ang format na "3.0 (quilt)"
pinapalitan ito. Ang Wig&pen ay ang unang detalye ng isang bagong henerasyong source package
format.

Ang pag-uugali ng format na ito ay pareho sa format na "3.0 (quilt)" maliban dito
ay hindi gumagamit ng tahasang listahan ng mga patch. Lahat ng mga file sa debian/patches/ tumutugma sa perl
regular na expression [\w-]+ dapat na wastong mga patch: inilalapat ang mga ito sa oras ng pagkuha.

Kapag gumagawa ng bagong source package, ang anumang pagbabago sa upstream na pinagmulan ay iniimbak sa isang patch
pinangalanan zz_debian-diff-auto.

Format: 3.0 (katutubo)
Sinusuportahan mula noong dpkg 1.14.17. Ang format na ito ay isang extension ng native na format ng package bilang
tinukoy sa 1.0 na format. Sinusuportahan nito ang lahat ng mga paraan ng compression at hindi papansinin bilang default
anumang partikular na file at direktoryo ng VCS pati na rin ang maraming pansamantalang file (tingnan ang default na halaga
nauugnay sa -I na opsyon sa - Tumulong output).

Format: 3.0 (kubrekama)
Sinusuportahan mula noong dpkg 1.14.17. Ang isang source package sa format na ito ay naglalaman ng hindi bababa sa isang
orihinal na tarball (.orig.tar.ext saan ext ay maaaring maging gz, bz2, lzma at xz) at isang debian
tarball (.debian.tar.ext). Maaari rin itong maglaman ng mga karagdagang orihinal na tarball
(.orig-bahagi.tar.ext). bahagi maaari lamang maglaman ng mga alphanumeric na character at gitling
('-').

Extracting

Ang pangunahing orihinal na tarball ay kinukuha muna, pagkatapos ay ang lahat ng karagdagang orihinal na tarball ay
kinuha sa mga subdirectory na pinangalanan pagkatapos ng bahagi bahagi ng kanilang filename (anumang pre-
ang umiiral na direktoryo ay pinalitan). Ang debian tarball ay kinukuha sa ibabaw ng pinagmulan
direktoryo pagkatapos ng paunang pag-alis ng anumang dati nang umiiral Debian direktoryo. Tandaan na ang debian
Ang tarball ay dapat maglaman ng a Debian sub-directory ngunit maaari rin itong maglaman ng mga binary file sa labas
ng direktoryong iyon (tingnan --include-binaries pagpipilian).

Lahat ng mga patch ay nakalista sa debian/patches/debian.series or debian/patches/serye ay pagkatapos
inilapat. Kung ang dating file ay ginamit at ang huli ay hindi umiiral (o ay isang symlink),
pagkatapos ay ang huli ay papalitan ng isang symlink sa dating. Ito ay sinadya upang pasimplehin ang paggamit
of kubrekama upang pamahalaan ang hanay ng mga patch. Tandaan gayunpaman na habang dpkg-source nag-parse
wastong mga serye ng mga file na may tahasang mga opsyon na ginagamit para sa patch application (naka-imbak sa bawat isa
linya pagkatapos ng patch filename at isa o higit pang mga puwang), binabalewala nito ang mga opsyon at
laging asahan ang mga patch na maaaring ilapat sa -p1 opsyon ng magtagpi. Ito ay kaya naglalabas
isang babala kapag nakatagpo ito ng mga ganitong opsyon, at malamang na mabigo ang build.

Ang timestamp ng lahat ng naka-patch na file ay ni-reset sa oras ng pagkuha ng source package
(Iniiwasan nito ang mga skew ng timestamp na humahantong sa mga problema kapag na-patch ang mga awtomatikong nabuong file).

Labag sa kubrekamaAng default na pag-uugali ni, ang mga patch ay inaasahang malalapat nang walang anumang malabo.
Kapag hindi iyon ang kaso, dapat mong i-refresh ang mga naturang patch kubrekama, O dpkg-source habilin
error out habang sinusubukang ilapat ang mga ito.

Katulad din sa kubrekamaAng default na pag-uugali, ang mga patch ay maaaring mag-alis din ng mga file.

Ang file .pc/applied-patches ay nilikha kung ang ilang mga patch ay inilapat sa panahon ng
pagkuha.

gusali

Ang lahat ng orihinal na tarball na matatagpuan sa kasalukuyang direktoryo ay kinukuha nang pansamantala
direktoryo sa pamamagitan ng pagsunod sa parehong lohika tulad ng para sa pag-unpack, ang direktoryo ng debian ay kinokopya
sa pansamantalang direktoryo, at lahat ng mga patch maliban sa awtomatikong patch
(debian-pagbabago-bersyon or debian-pagbabago, depende sa --single-debian-patch) ay
inilapat. Inihambing ang pansamantalang direktoryo sa direktoryo ng source package. Kapag ang
diff ay walang laman, ang build ay nabigo maliban kung --single-debian-patch or --auto-commit ay naging
ginamit, kung saan ang diff ay naka-imbak sa awtomatikong patch. Kung ang awtomatikong patch ay
nilikha/tinanggal, ito ay idinagdag/inalis mula sa seryeng file at mula sa kubrekama metadata

Ang anumang pagbabago sa isang binary file ay hindi kinakatawan sa isang diff at sa gayon ay hahantong sa isang pagkabigo
maliban kung sadyang nagpasya ang tagapangasiwa na isama ang binary na binary file na iyon sa
debian tarball (sa pamamagitan ng paglilista nito sa debian/source/include-binaries). Mabibigo din ang build
kung nakahanap ito ng mga binary file sa sub-directory ng debian maliban kung na-whitelist ang mga ito
sa pamamagitan ng debian/source/include-binaries.

Ang na-update na direktoryo ng debian at ang listahan ng binagong mga binary ay gagamitin upang makabuo
ang debian tarball.

Ang awtomatikong nabuong pagkakaiba ay hindi kasama ang mga pagbabago sa mga partikular na file ng VCS pati na rin
maraming pansamantalang file (tingnan ang default na halaga na nauugnay sa -i na opsyon sa - Tumulong output). Sa
partikular, ang .pc direktoryo na ginamit ng kubrekama ay binabalewala sa panahon ng pagbuo ng awtomatikong
tambalan

tandaan: dpkg-source --bago-buo (At --build) ay titiyakin na ang lahat ng mga patch na nakalista sa
series file ay inilapat upang ang isang package build ay palaging may lahat ng mga patch na inilapat. ginagawa nito
ito sa pamamagitan ng paghahanap ng hindi nailapat na mga patch (nakalista sila sa serye file ngunit hindi sa
.pc/applied-patches), at kung ang unang patch sa set na iyon ay maaaring mailapat nang walang mga error, ito
ilalapat silang lahat. Ang pagpipilian --walang-paghahanda ay maaaring gamitin upang huwag paganahin ang gawi na ito.

Pagtatala mga pagbabago

--gumawa [direktoryo] [patch-name] [patch-file]
Bumubuo ng patch na tumutugma sa mga lokal na pagbabago na hindi pinamamahalaan ng
kubrekama patch system at isinasama ito sa patch system sa ilalim ng pangalan patch-name.
Kung nawawala ang pangalan, tatanungin ito nang interactive. Kung patch-file ay ibinigay, ito
ay ginagamit bilang patch na naaayon sa mga lokal na pagbabago upang isama. minsan
isinama, inilunsad ang isang editor upang ma-edit mo ang meta-impormasyon sa
patch header.

Pagdaan patch-file higit sa lahat ay kapaki-pakinabang pagkatapos ng isang pagkabigo sa pagbuo na paunang nabuo nito
file, at sa lupang ito ang ibinigay na file ay tinanggal pagkatapos ng pagsasama. Tandaan din
na ang mga pagbabagong nakapaloob sa patch file ay dapat na mailapat na sa puno
at na ang mga file na binago ng patch ay dapat na walang karagdagang hindi naitala
mga pagbabago.

Kung ang pagbuo ng patch ay nakakita ng binagong mga binary file, awtomatiko silang magiging
Idinagdag sa debian/source/include-binaries para mapunta sila sa debian tarball
(parang eksakto dpkg-source --include-binaries --build gagawin).

Magtayo pagpipilian

--allow-version-of-quilt-db=bersyon
Payagan dpkg-source upang bumuo ng source package kung ang bersyon ng kubrekama metadata
ay ang tinukoy, kahit na dpkg-source ay hindi alam ang tungkol dito (mula noong dpkg
1.15.5.4). Epektibong sinasabi nito na ang ibinigay na bersyon ng kubrekama ang metadata ay
tugma sa bersyon 2 na dpkg-source kasalukuyang sumusuporta. Ang bersyon ng
ang kubrekama metadata ay naka-imbak sa .pc/.bersyon.

--isama-pag-alis
Huwag balewalain ang mga tinanggal na file at isama ang mga ito sa awtomatikong nabuong patch.

--include-timestamp
Isama ang timestamp sa awtomatikong nabuong patch.

--include-binaries
Idagdag ang lahat ng binagong binary sa debian tarball. Idagdag din sila sa
debian/source/include-binaries: idadagdag sila bilang default sa mga susunod na build
at ang pagpipiliang ito ay hindi na kailangan.

--walang-paghahanda
Huwag subukang ihanda ang build tree sa pamamagitan ng paglalagay ng mga patch na tila
hindi nailapat (mula noong dpkg 1.14.18).

--single-debian-patch
paggamit debian/patches/debian-changes sa halip ng debian/patches/debian-changes-bersyon
para sa pangalan ng awtomatikong patch na nabuo sa panahon ng pagbuo (mula noong dpkg 1.15.5.4).
Ang opsyon na ito ay partikular na kapaki-pakinabang kapag ang package ay pinananatili sa isang VCS at a
hindi maaasahang mabuo ang set ng patch. Sa halip ang kasalukuyang pagkakaiba sa upstream
ay dapat na naka-imbak sa isang solong patch. Ang opsyon ay ilalagay
debian/source/local-options at sasamahan ng a
debian/source/local-patch-header file na nagpapaliwanag kung paano magiging pinakamahusay ang mga pagbabago sa Debian
nirepaso, halimbawa sa VCS na ginagamit.

--create-empty-orig
Awtomatikong gawin ang pangunahing orihinal na tarball bilang walang laman kung ito ay nawawala at kung
may mga pandagdag na orihinal na tarball (mula noong dpkg 1.15.6). Ang pagpipiliang ito ay
nilalayong gamitin kapag ang source package ay isang bundle lang ng maramihang upstream
software at kung saan walang "pangunahing" software.

--no-unapply-patches, --unapply-patches
Sa pamamagitan ng default, dpkg-source ay awtomatikong aalisin ang pagkakalapat ng mga patch sa --pagkatapos-buo
hook kung ito ay inilapat ang mga ito sa panahon --bago-buo (--unapply-patches mula noong dpkg
1.15.8, --no-unapply-patches mula noong dpkg 1.16.5). Pinapayagan ka ng mga pagpipiliang iyon
pilit na huwag paganahin o paganahin ang proseso ng hindi paglalapat ng patch. Ang mga pagpipilian na iyon ay
pinapasok lang debian/source/local-options upang ang lahat ng nabuong source packages
magkaroon ng parehong pag-uugali bilang default.

--i-abort-sa-upstream-mga pagbabago
Nabigo ang proseso kung ang isang awtomatikong patch ay nabuo (mula noong dpkg 1.15.8).
Maaaring gamitin ang opsyong ito upang matiyak na ang lahat ng mga pagbabago ay maayos na naitala sa
hiwalay kubrekama mga patch bago ang pagbuo ng source package. Ang pagpipiliang ito ay hindi
pinapasok debian/source/opsyon ngunit maaaring gamitin sa debian/source/local-options.

--auto-commit
Ang proseso ay hindi nabigo kung ang isang awtomatikong patch ay nabuo, sa halip ito ay
agad na naitala sa kubrekama serye.

Kunin pagpipilian

--laktawan-debianization
Nilaktawan ang pagkuha ng debian tarball sa itaas ng mga upstream na pinagmumulan (mula noong dpkg
1.15.1).

--laktawan ang mga patch
Huwag maglagay ng mga patch sa dulo ng pagkuha (mula noong dpkg 1.14.18).

Format: 3.0 (pasadya)
Sinusuportahan mula noong dpkg 1.14.17. Espesyal ang format na ito. Hindi ito kumakatawan sa isang tunay na pinagmulan
format ng package ngunit maaaring gamitin upang lumikha ng mga source package na may mga arbitrary na file.

Magtayo pagpipilian

Ang lahat ng mga argumentong hindi opsyon ay kinuha bilang mga file upang isama sa nabuong source package.
Dapat silang umiiral at mas mabuti na nasa kasalukuyang direktoryo. Hindi bababa sa isang file ang dapat
binigay

--target-format=halaga
Kailangan. Tinutukoy ang totoong format ng nabuong source package. Ang nabuo
Ang .dsc file ay maglalaman ng halagang ito format field at hindi “3.0 (custom)”.

Format: 3.0 (git)
Sinusuportahan mula noong dpkg 1.14.17. Ang format na ito ay pang-eksperimento.

Ang isang source package sa format na ito ay binubuo ng isang bundle ng isang git repository .git sa
hawakan ang pinagmulan ng isang pakete. Maaaring mayroon ding a .gitshallow mga pagbabago sa listahan ng file para sa
isang mababaw na git clone.

Extracting

Ang bundle ay na-clone bilang isang git repository sa target na direktoryo. Kung mayroong a
gitshallow file, naka-install ito bilang .git/shallow sa loob ng cloned git repository.

Tandaan na bilang default ang bagong repositoryo ay magkakaroon ng parehong branch na nasuri noon
na-check out sa orihinal na pinagmulan. (Karaniwang "master", ngunit maaari itong maging anuman.) Anuman
iba pang mga sangay ay magagamit sa ilalim remotes/pinagmulan/.

gusali

Bago magpatuloy, ang ilang pagsusuri ay ginagawa upang matiyak na wala kaming anumang hindi-
binalewala ang mga hindi nakatalagang pagbabago.

git-bundle(1) ay ginagamit upang makabuo ng isang bundle ng git repository. Bilang default, lahat
ang mga sangay at tag sa repositoryo ay kasama sa bundle.

Magtayo pagpipilian

--git-ref=Ref
Nagbibigay-daan sa pagtukoy ng git ref na isama sa git bundle. Ang paggamit ay hindi pinapagana ang default
gawi ng pagsasama ng lahat ng sangay at tag. Maaaring tukuyin ng maraming beses. Ang
Ref maaaring pangalan ng isang sangay o tag na isasama. Maaari rin itong maging anumang parameter
na maaaring ipasa sa git-rev-list(1). Halimbawa, upang isama lamang ang master
sangay, gamitin --git-ref=master. Upang isama ang lahat ng mga tag at sangay, maliban sa
pribadong sangay, gamitin --git-ref=--lahat --git-ref=^pribado

--git-depth=numero
Lumilikha ng mababaw na clone na may kasaysayang pinutol sa tinukoy na bilang ng
mga rebisyon.

Format: 3.0 (bzr)
Sinusuportahan mula noong dpkg 1.14.17. Ang format na ito ay pang-eksperimento. Ito ay bumubuo ng isang solong tarball
naglalaman ng bzr repository.

Extracting

Ang tarball ay na-unpack at pagkatapos ay ginagamit ang bzr upang i-checkout ang kasalukuyang sangay.

gusali

Bago magpatuloy, ang ilang pagsusuri ay ginagawa upang matiyak na wala kaming anumang hindi-
binalewala ang mga hindi nakatalagang pagbabago.

Pagkatapos ang partikular na bahagi ng VCS ng direktoryo ng pinagmulan ay kinokopya sa isang pansamantalang
direktoryo. Bago ang pansamantalang direktoryo na ito ay nakaimpake sa isang tarball, may iba't ibang paglilinis
ginawa upang makatipid ng espasyo.

DIAGNOSTICS

hindi pinagmulan format tinukoy in debian/source/format
Ang file debian/source/format dapat palaging umiiral at ipahiwatig ang nais na format ng pinagmulan.
Para sa backwards compatibility, ang format na "1.0" ay ipinapalagay kapag ang file ay wala kundi ikaw
hindi dapat umasa dito: sa isang punto sa hinaharap dpkg-source ay babaguhin upang mabigo
kapag wala ang file na iyon.

Ang katwiran ay ang format na "1.0" ay hindi na ang inirerekomendang format, dapat ay karaniwan
pumili ng isa sa mga mas bagong format (“3.0 (quilt)”, “3.0 (native)”) ngunit dpkg-source hindi gagawin
ito ay awtomatikong para sa iyo. Kung gusto mong ipagpatuloy ang paggamit ng lumang format, dapat
tahasan ang tungkol dito at ilagay ang "1.0". debian/source/format.

ang Diff Binabago ang sumusunod salungat sa agos file
Kapag gumagamit ng source format na "1.0" kadalasan ay isang masamang ideya na direktang baguhin ang mga upstream na file
dahil nakatago ang mga pagbabago at karamihan ay hindi dokumentado sa .diff.gz file. Sa halip ikaw
dapat iimbak ang iyong mga pagbabago bilang mga patch sa direktoryo ng debian at ilapat ang mga ito sa oras ng pagbuo.
Upang maiwasan ang pagiging kumplikadong ito maaari mo ring gamitin ang format na "3.0 (quilt)" na nag-aalok nito
katutubong.

hindi maaari kumatawan baguhin sa file
Ang mga pagbabago sa upstream na pinagmumulan ay karaniwang iniimbak na may mga patch file, ngunit hindi lahat ng mga pagbabago ay magagawa
ay kinakatawan ng mga patch: maaari lamang nilang baguhin ang nilalaman ng mga plain text file. kung ikaw
subukang palitan ang isang file ng ibang uri (halimbawa, pagpapalit ng plain
file na may symlink o isang direktoryo), makukuha mo ang mensahe ng error na ito.

bagong nilikha walang laman file file habilin hindi be kinakatawan in Diff
Ang mga walang laman na file ay hindi maaaring gawin gamit ang mga patch file. Kaya ang pagbabagong ito ay hindi naitala sa
source package at binalaan ka tungkol dito.

pinatutupad paraan mga perms of file habilin hindi be kinakatawan in Diff
Ang mga patch file ay hindi nagtatala ng mga pahintulot ng mga file at sa gayon ang mga executable na pahintulot ay hindi
nakaimbak sa source package. Ang babalang ito ay nagpapaalala sa iyo ng katotohanang iyon.

espesyal paraan mga perms of file habilin hindi be kinakatawan in Diff
Ang mga patch na file ay hindi nagtatala ng mga pahintulot ng mga file at sa gayon ang mga binagong pahintulot ay hindi
nakaimbak sa source package. Ang babalang ito ay nagpapaalala sa iyo ng katotohanang iyon.

FILE FORMATS

debian/source/format
Ang file na ito ay naglalaman sa isang linya ng format na dapat gamitin upang buuin ang pinagmulan
package (mga posibleng format ay inilarawan sa itaas). Hindi pinahihintulutan ang mga puwang sa unahan o trailing.

debian/source/include-binaries
Ang file na ito ay naglalaman ng isang listahan ng mga binary file (isa sa bawat linya) na dapat isama sa
debian tarball. Hinubaran ang mga puwang sa unahan at trailing. Mga linyang nagsisimula sa '#' ay
mga komento at nilaktawan. Ang mga walang laman na linya ay hindi pinapansin.

debian/source/opsyon
Ang file na ito ay naglalaman ng isang listahan ng mga mahahabang opsyon na dapat ay awtomatikong i-prepend sa
set ng mga opsyon sa command line ng a dpkg-source --build or dpkg-source --print-format tawagan
Mga pagpipilian tulad ng --compression at --compression-level ay angkop para sa file na ito.

Ang bawat pagpipilian ay dapat ilagay sa isang hiwalay na linya. Mga walang laman na linya at linya na nagsisimula sa '#' ay
hindi pinansin. Ang nangunguna '--' ay dapat na hubarin at ang mga maikling opsyon ay hindi pinapayagan. Opsyonal
pinapayagan ang mga puwang sa paligid ng '=' ang simbolo at opsyonal na mga quote ay pinapayagan sa paligid ng halaga.
Narito ang isang halimbawa ng naturang file:

# hayaan ang dpkg-source na lumikha ng debian.tar.bz2 na may pinakamataas na compression
compression = "bzip2"
antas ng compression = 9
# gumamit ng debian/patches/debian-changes bilang awtomatikong patch
single-debian-patch
# huwag pansinin ang mga pagbabago sa config.{sub,guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

tandaan: format ang mga opsyon ay hindi tinatanggap sa file na ito, dapat mong gamitin debian/source/format
sa halip.

debian/source/local-options
Eksakto tulad ng debian/source/opsyon maliban na ang file ay hindi kasama sa nabuo
source package. Maaari itong maging kapaki-pakinabang upang mag-imbak ng isang kagustuhan na nakatali sa maintainer o sa
VCS repository kung saan pinananatili ang source package.

debian/source/local-patch-header at debian/source/patch-header
Libreng form na text na inilalagay sa ibabaw ng awtomatikong patch na nabuo sa mga format na "2.0" o
"3.0 (kubrekama)". local-patch-header ay hindi kasama sa nabuong source package habang
patch-header ay.

debian/patches/serye
Inililista ng file na ito ang lahat ng mga patch na kailangang ilapat (sa ibinigay na pagkakasunud-sunod) sa itaas ng
upstream source package. Hinubaran ang mga puwang sa unahan at trailing. Mga linyang nagsisimula sa
'#' ay mga komento at nilaktawan. Ang mga walang laman na linya ay hindi pinapansin. Ang mga natitirang linya ay nagsisimula sa a
patch filename (na may kaugnayan sa debian/patches/ direktoryo) hanggang sa unang karakter ng espasyo
o ang dulo ng linya. Opsyonal kubrekama ang mga opsyon ay maaaring sumunod hanggang sa dulo ng linya o sa una
'#' na sinusundan ng isa o higit pang mga puwang (na nagmamarka ng simula ng isang komento hanggang sa katapusan ng
linya).

Gumamit ng dpkg-source online gamit ang mga serbisyo ng onworks.net