dpkg-source - Online di Cloud

PROGRAM:

NAMA

dpkg-source - Alat manipulasi paket sumber Debian (.dsc)

RINGKASAN

dpkg-sumber [Option...] Command

DESKRIPSI

dpkg-sumber mengemas dan membongkar arsip sumber Debian.

Tak satu pun dari perintah ini memungkinkan beberapa opsi untuk digabungkan menjadi satu, dan mereka tidak
izinkan nilai untuk opsi ditentukan dalam argumen terpisah.

PERINTAH

-x, --ekstrak nama file.dsc [keluaran-direktori]
Ekstrak paket sumber (--ekstrak sejak dpkg 1.17.14). Satu argumen non-opsi
harus diberikan, nama file kontrol sumber Debian (.dsc). Sebuah opsional
argumen non-opsi kedua dapat diberikan untuk menentukan direktori untuk mengekstrak
paket sumber ke, ini tidak boleh ada. Jika tidak ada direktori keluaran yang ditentukan,
paket sumber diekstraksi ke dalam direktori bernama sumber-versi di bawah arus
direktori kerja.

dpkg-sumber akan membaca nama file lain yang menyusun paket sumber
dari file kontrol; mereka diasumsikan berada di direktori yang sama dengan .dsc.

File dalam paket yang diekstraksi akan memiliki izin dan kepemilikan yang ditetapkan
dengan yang diharapkan jika file dan direktori hanya
telah dibuat - direktori dan file yang dapat dieksekusi akan menjadi 0777 dan file biasa akan
menjadi 0666, keduanya dimodifikasi oleh umask pengekstrak; jika direktori induk adalah setgid
maka direktori yang diekstraksi akan juga, dan semua file dan direktori akan
mewarisi kepemilikan kelompoknya.

Jika paket sumber menggunakan format non-standar (saat ini berarti semua format
kecuali “1.0”), namanya akan disimpan di debian/sumber/format sehingga
build berikut dari paket sumber menggunakan format yang sama secara default.

-b, --membangun direktori [format-spesifik-parameter]
Buat paket sumber (--membangun sejak dpkg 1.17.14). Argumen non-opsi pertama
diambil sebagai nama direktori yang berisi pohon sumber debianized (mis
dengan sub-direktori debian dan mungkin berubah ke file asli). Bergantung kepada
format paket sumber yang digunakan untuk membangun paket, parameter tambahan mungkin
diterima.

dpkg-sumber akan membangun paket sumber dengan format pertama yang ditemukan dalam ini
daftar pesanan: format yang ditunjukkan dengan --format opsi baris perintah, the
format yang ditunjukkan dalam debian/sumber/format, "1.0". Pengunduran ke "1.0" adalah
usang dan akan dihapus di beberapa titik di masa mendatang, Anda harus selalu
mendokumentasikan format sumber yang diinginkan di debian/sumber/format. Lihat bagian SOURCE
PAKET FORMAT untuk deskripsi ekstensif tentang berbagai format paket sumber.

--format-cetak direktori
Cetak format sumber yang akan digunakan untuk membangun paket sumber jika
dpkg-sumber --membangun direktori dipanggil (dalam kondisi yang sama dan dengan yang sama
parameter; sejak dpkg 1.15.5).

--sebelum-membangun direktori
Jalankan kait yang sesuai dari format paket sumber (sejak dpkg 1.15.8). Ini
hook dipanggil sebelum build paket apa pun (dpkg-buildpackage menyebutnya sangat
lebih awal bahkan sebelumnya debian/aturan membersihkan). Perintah ini idempoten dan dapat disebut
beberapa kali. Tidak semua format sumber menerapkan sesuatu di kait ini, dan itu
yang biasanya menyiapkan pohon sumber untuk pembangunan misalnya dengan memastikan bahwa
patch Debian diterapkan.

--setelah-membangun direktori
Jalankan kait yang sesuai dari format paket sumber (sejak dpkg 1.15.8). Ini
hook dipanggil setelah build apa pun dari paket (dpkg-buildpackage menyebutnya terakhir).
Perintah ini idempoten dan dapat dipanggil beberapa kali. Tidak semua format sumber
mengimplementasikan sesuatu di hook ini, dan mereka yang melakukannya biasanya menggunakannya untuk membatalkan apa
--sebelum-membangun telah selesai.

--melakukan [direktori] ...
Rekam perubahan di pohon sumber yang dibongkar di direktori (sejak dpkg 1.16.1). Ini
perintah dapat mengambil parameter tambahan tergantung pada format sumber. Itu akan
kesalahan untuk format di mana operasi ini tidak berarti apa-apa.

-?, --membantu
Tampilkan pesan penggunaan dan keluar.

--Versi: kapan
Tampilkan versi dan keluar.

PILIHAN

Umum membangun Pilihan
-cfile kontrol
Menentukan file kontrol sumber utama untuk membaca informasi. Standarnya adalah
debian / kontrol. Jika diberikan dengan nama path relatif ini ditafsirkan mulai dari
direktori tingkat atas pohon sumber.

-lfile log perubahan
Menentukan file changelog untuk membaca informasi. Standarnya adalah
debian/changelog. Jika diberikan dengan nama path relatif ini ditafsirkan mulai dari
direktori tingkat atas pohon sumber.

-Fformat log perubahan
Menentukan format changelog. Lihat dpkg-parsechangelog(1) untuk informasi
tentang format alternatif.

--format=nilai
Gunakan format yang diberikan untuk membangun paket sumber (sejak dpkg 1.14.17). memang
menimpa format apa pun yang diberikan dalam debian/sumber/format.

-Vnama=nilai
Tetapkan variabel substitusi keluaran. Lihat hutang-substvars(5) untuk diskusi tentang
substitusi keluaran.

-Tfile substvars
Baca variabel substitusi di file substvars; defaultnya adalah tidak membaca file apa pun.
Opsi ini dapat digunakan beberapa kali untuk membaca variabel substitusi dari beberapa
file (sejak dpkg 1.15.6).

-Dbidang=nilai
Ganti atau tambahkan bidang file kontrol keluaran.

-Ubidang
Hapus bidang file kontrol keluaran.

-Zkompresi, --kompresi=kompresi
Tentukan kompresi yang akan digunakan untuk tarball dan file diff yang dibuat (--kompresi
sejak dpkg 1.15.5). Perhatikan bahwa opsi ini tidak akan menyebabkan tarball yang ada menjadi
dikompresi, itu hanya mempengaruhi file baru. Nilai yang didukung adalah: gzip, bzip2, lzma
dan xz. Standarnya adalah xz untuk format 2.0 dan yang lebih baru, dan gzip untuk format 1.0. xz
hanya didukung sejak dpkg 1.15.5.

-ztingkat, --tingkat kompresi=tingkat
Tingkat kompresi yang digunakan (--tingkat kompresi sejak dpkg 1.15.5). Seperti -Z it
hanya mempengaruhi file yang baru dibuat. Nilai yang didukung adalah: 1 untuk 9, terbaik, dan cepat.
Standarnya adalah 9 untuk gzip dan bzip2, 6 untuk xz dan lzma.

-i[regex], --diff-abaikan[=regex]
Anda dapat menentukan ekspresi reguler Perl untuk mencocokkan file yang ingin Anda filter
daftar file untuk diff (--diff-abaikan sejak dpkg 1.15.6). (Daftar ini adalah
dihasilkan oleh perintah find.) (Jika paket sumber sedang dibangun sebagai versi 3
paket sumber menggunakan VCS, ini dapat digunakan untuk mengabaikan perubahan yang tidak dikomit pada
file tertentu. Menggunakan -i.* akan mengabaikan semuanya.)

Grafik -i opsi dengan sendirinya mengaktifkan pengaturan ini dengan regex default (mempertahankan semua
modifikasi ke regex default dilakukan oleh penggunaan sebelumnya --extend-diff-abaikan)
yang akan menyaring file kontrol dan direktori dari revisi yang paling umum
sistem kontrol, backup dan swap file dan Libtool membangun direktori output. Di sana
hanya dapat menjadi satu regex aktif, dari beberapa -i pilihan hanya yang terakhir akan diambil
efek.

Ini sangat membantu dalam memotong file asing yang disertakan dalam diff,
misalnya jika Anda memelihara sumber Anda dalam sistem kontrol revisi dan ingin menggunakan a
checkout untuk membuat paket sumber tanpa menyertakan file tambahan dan
direktori yang biasanya berisi (misalnya CVS/, .cvsignore, .svn/). Itu
regex default sudah sangat lengkap, tetapi jika Anda perlu menggantinya, silakan
perhatikan bahwa secara default ini dapat mencocokkan bagian mana pun dari jalur, jadi jika Anda ingin mencocokkan
mulai dari nama file atau hanya nama file lengkap, Anda harus memberikan yang diperlukan
jangkar (misalnya '(^|/)', '($|/)') sendiri.

--extend-diff-abaikan=regex
Ekspresi reguler Perl yang ditentukan akan memperluas nilai default yang digunakan oleh
--diff-abaikan dan nilai saat ini, jika disetel (sejak dpkg 1.15.6). Ini dilakukan dengan
menggabungkan “|regex” dengan nilai yang ada. Opsi ini nyaman digunakan di
debian/sumber/opsi untuk mengecualikan beberapa file yang dibuat secara otomatis dari tambalan otomatis
generasi.

-I[file-pola], --tar-abaikan[=file-pola]
Jika opsi ini ditentukan, pola akan diteruskan ke ter(1) --mengecualikan
opsi ketika dipanggil untuk menghasilkan file .orig.tar atau .tar (--tar-abaikan sejak
dpkg 1.15.6). Sebagai contoh, -ICVS akan membuat tar melewati direktori CVS ketika
menghasilkan file .tar.gz. Opsi dapat diulang beberapa kali untuk mendaftar
beberapa pola untuk dikecualikan.

-I dengan sendirinya menambahkan default --mengecualikan opsi yang akan menyaring file kontrol dan
direktori sistem kontrol revisi yang paling umum, file cadangan dan swap, dan
Libtool membangun direktori keluaran.

Catatan: Meskipun mereka memiliki tujuan yang sama, -i dan -I memiliki sintaks yang sangat berbeda dan
semantik. -i hanya dapat ditentukan sekali dan menggunakan ekspresi reguler yang kompatibel dengan Perl
yang dicocokkan dengan path relatif lengkap dari setiap file. -I dapat ditentukan beberapa
kali dan mengambil pola nama file dengan wildcard shell. Pola tersebut diterapkan pada
jalur relatif penuh tetapi juga ke setiap bagian jalur secara individual. Semantik yang tepat dari
tar --mengecualikan pilihannya agak rumit, lihat
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Regex dan pola default untuk kedua opsi dapat dilihat pada output dari --membantu
perintah.

Umum ekstrak Pilihan
--tidak ada salinan
Jangan menyalin tarball asli di dekat paket sumber yang diekstrak (karena dpkg
1.14.17).

--tidak memeriksa
Jangan memeriksa tanda tangan dan checksum sebelum membongkar (sejak dpkg 1.14.17).

--memerlukan-valid-tanda tangan
Menolak untuk membongkar paket sumber jika tidak berisi tanda tangan OpenPGP yang
dapat diverifikasi (sejak dpkg 1.15.0) baik dengan pengguna Trustedkeys.gpg gantungan kunci,
salah satu gantungan kunci khusus vendor, atau salah satu gantungan kunci resmi Debian
(/usr/share/keyrings/debian-keyring.gpg dan
/usr/share/keyrings/debian-maintainers.gpg).

--abaikan-versi-buruk
Mengubah pemeriksaan versi paket sumber yang buruk menjadi peringatan yang tidak fatal (sejak dpkg
1.17.7). Opsi ini seharusnya hanya diperlukan saat mengekstraksi sumber kuno
paket dengan versi rusak, hanya untuk kompatibilitas mundur.

SOURCE PAKET FORMAT

Jika Anda tidak tahu format sumber apa yang digunakan, Anda mungkin harus memilih "3.0 (quilt)"
atau “3.0 (asli)”. Lihat https://wiki.debian.org/Projects/DebSrc3.0 untuk informasi tentang
penyebaran format tersebut dalam Debian.

Format: 1.0
Paket sumber dalam format ini terdiri dari: .orig.tar.gz terkait dengan .diff.gz
atau satu .tar.gz (dalam hal ini paket dikatakan asli).

Ekstraksi

Mengekstrak paket asli adalah ekstraksi sederhana dari satu tarball di target
direktori. Mengekstrak paket non-asli dilakukan dengan terlebih dahulu membongkar paket .orig.tar.gz dan
kemudian menerapkan tambalan yang terkandung dalam .diff.gz mengajukan. Stempel waktu semua file yang ditambal
disetel ulang ke waktu ekstraksi paket sumber (ini menghindari kemiringan stempel waktu yang mengarah
untuk masalah ketika file yang dibuat secara otomatis ditambal). Diff dapat membuat file baru (the
seluruh direktori debian dibuat seperti itu) tetapi tidak dapat menghapus file (file kosong akan menjadi
tersisa).

Bangunan

Membangun paket asli hanya membuat satu tarball dengan direktori sumber.
Membangun paket non-asli melibatkan ekstraksi tarbal asli secara terpisah
direktori ".orig" dan membuat ulang .diff.gz dengan membandingkan paket sumber direktori
dengan direktori .orig.

Membangun Pilihan (dengan --membangun):

Jika argumen non-opsi kedua diberikan, itu harus nama sumber aslinya
direktori atau tarfile atau string kosong jika paket tersebut khusus untuk Debian dan sebagainya
tidak memiliki perbedaan Debianisasi. Jika tidak ada argumen kedua yang diberikan maka dpkg-sumber akan terlihat
untuk tarfile sumber asli package_upstream-versi.orig.tar.gz atau asli
direktori sumber direktori.asal tergantung pada -sX argumen.

-sa, -sp, -sk, -su dan -sr tidak akan menimpa tarfile atau direktori yang ada. Jika ini adalah
diinginkan maka -sA, -sp, -sk, -miliknya dan -sR harus digunakan sebagai gantinya.

-sk Menentukan untuk mengharapkan sumber asli sebagai tarfile, secara default paket_hulu-
versi.orig.tar.perpanjangan. Ini akan meninggalkan sumber asli ini sebagai
tarfile, atau salin ke direktori saat ini jika belum ada. Tarbal
akan dibongkar menjadi direktori.asal untuk generasi diff.

-sp Seperti -sk tetapi akan menghapus direktori lagi setelahnya.

-su Menentukan bahwa sumber asli diharapkan sebagai direktori, secara default paket-
versi upstream.asal dan dpkg-sumber akan membuat arsip sumber asli baru
dari situ.

-sr Seperti -su tetapi akan menghapus direktori itu setelah digunakan.

-ss Menentukan bahwa sumber asli tersedia baik sebagai direktori maupun sebagai
tarfile. dpkg-sumber akan menggunakan direktori untuk membuat diff, tetapi tarfile untuk
buat .dsc. Opsi ini harus digunakan dengan hati-hati - jika direktori dan tarfile
tidak cocok arsip sumber yang buruk akan dihasilkan.

-sn Menentukan untuk tidak mencari sumber asli apa pun, dan untuk tidak menghasilkan diff. Itu
argumen kedua, jika diberikan, harus berupa string kosong. Ini digunakan untuk Debian-
paket-paket khusus yang tidak memiliki sumber upstream terpisah dan oleh karena itu memiliki
tidak ada perbedaan debianisasi.

-sa or -sA
Menentukan untuk mencari arsip sumber asli sebagai tarfile atau sebagai direktori -
argumen kedua, jika ada, dapat berupa, atau string kosong (ini setara
untuk menggunakan -sn). Jika tarfile ditemukan, ia akan membongkarnya untuk membuat diff dan
hapus setelahnya (ini setara dengan -sp); jika direktori ditemukan, itu akan
kemas untuk membuat sumber asli dan hapus setelahnya (ini setara
untuk -sr); jika keduanya tidak ditemukan, maka paket tersebut akan dianggap tidak memiliki debianisasi
diffs, hanya arsip sumber langsung (ini setara dengan -sn). Jika keduanya
ditemukan maka dpkg-sumber akan mengabaikan direktori, menimpanya, jika -sA adalah
ditentukan (ini setara dengan -sp) atau memunculkan kesalahan jika -sa telah ditentukan. -sA
adalah defaultnya.

--batalkan-pada-upstream-perubahan
Proses gagal jika perbedaan yang dihasilkan berisi perubahan pada file di luar
sub-direktori debian (sejak dpkg 1.15.8). Opsi ini tidak diperbolehkan di
debian/sumber/opsi tetapi dapat digunakan dalam debian/sumber/pilihan lokal.

Ekstrak Pilihan (dengan --ekstrak):

Dalam semua kasus, semua pohon sumber asli yang ada akan dihapus.

-sp Digunakan saat mengekstrak maka sumber asli (jika ada) akan dibiarkan sebagai tarfile.
Jika belum berada di direktori saat ini atau jika sudah ada tetapi
file yang berbeda yang ada akan disalin di sana. (Kredensial mikro is itu kegagalan).

-su Membongkar pohon sumber asli.

-sn Memastikan bahwa sumber asli tidak disalin ke direktori saat ini atau
dibongkar. Setiap pohon sumber asli yang ada di direktori saat ini masih
dihapus.

Semua -sX pilihan yang saling eksklusif. Jika Anda menentukan lebih dari satu hanya yang terakhir
akan digunakan.

--lewati-debianisasi
Melewati penerapan diff debian di atas sumber upstream (sejak dpkg
1.15.1).

Format: 2.0
Ekstraksi didukung sejak dpkg 1.13.9, bangunan didukung sejak dpkg 1.14.8. Juga dikenal
sebagai wig & pena. Format ini tidak direkomendasikan untuk penggunaan yang meluas, format “3.0 (quilt)”
menggantikannya. Wig&pen adalah spesifikasi pertama dari paket sumber generasi baru
Format.

Perilaku format ini sama dengan format “3.0 (quilt)” kecuali bahwa itu
tidak menggunakan daftar patch yang eksplisit. Semua file di debian/patch/ cocok dengan perl
ekspresi reguler [\w-]+ harus patch yang valid: mereka diterapkan pada waktu ekstraksi.

Saat membangun paket sumber baru, setiap perubahan pada sumber upstream disimpan dalam tambalan
bernama zz_debian-diff-auto.

Format: 3.0 (warga asli)
Didukung sejak dpkg 1.14.17. Format ini merupakan perpanjangan dari format paket asli sebagai
didefinisikan dalam format 1.0. Ini mendukung semua metode kompresi dan akan diabaikan secara default
semua file dan direktori khusus VCS serta banyak file sementara (lihat nilai default
terkait dengan -I pilihan dalam --membantu keluaran).

Format: 3.0 (selimut)
Didukung sejak dpkg 1.14.17. Paket sumber dalam format ini berisi setidaknya satu
tarbal asli (.orig.tar.ext dimana ext dapat gz, bz2, lzma dan xz) dan debian
tarbal (.debian.tar.ext). Itu juga dapat berisi tarball asli tambahan
(.asal-komponen.ter.ext). komponen hanya boleh berisi karakter alfanumerik dan tanda hubung
('-').

Ekstraksi

Tarbal asli utama diekstrak dulu, baru semua tarbal asli tambahan
diekstraksi di subdirektori yang dinamai menurut nama komponen bagian dari nama file mereka (pra-
direktori yang ada diganti). Tarbal debian diekstraksi di atas sumbernya
direktori setelah penghapusan sebelumnya dari yang sudah ada sebelumnya debian direktori. Perhatikan bahwa debian
tarbal harus mengandung a debian sub-direktori tetapi juga dapat berisi file biner di luar
dari direktori itu (lihat --termasuk-binari pilihan).

Semua tambalan terdaftar di debian/patch/debian.series or debian/patch/seri kemudian
terapan. Jika file sebelumnya digunakan dan yang terakhir tidak ada (atau merupakan symlink),
kemudian yang terakhir diganti dengan symlink ke yang pertama. Ini dimaksudkan untuk menyederhanakan penggunaan
of selimut untuk mengelola set tambalan. Namun perhatikan bahwa sementara dpkg-sumber mengurai
seri file dengan benar dengan opsi eksplisit yang digunakan untuk aplikasi tambalan (disimpan di masing-masing
baris setelah nama file tambalan dan satu atau lebih spasi), itu mengabaikan opsi itu dan
selalu mengharapkan tambalan yang dapat diterapkan dengan -hal1 pilihan dari tambalan. Dengan demikian akan memancarkan
peringatan ketika menemukan opsi seperti itu, dan build kemungkinan akan gagal.

Stempel waktu semua file yang ditambal diatur ulang ke waktu ekstraksi paket sumber
(ini menghindari kemiringan stempel waktu yang menyebabkan masalah saat file yang dibuat secara otomatis ditambal).

Berbeda dengan selimutperilaku default, tambalan diharapkan berlaku tanpa fuzz.
Ketika bukan itu masalahnya, Anda harus menyegarkan tambalan seperti itu dengan selimut, atau dpkg-sumber akan
error saat mencoba menerapkannya.

Demikian pula untuk selimutperilaku default, tambalan juga dapat menghapus file.

File .pc/applied-patches dibuat jika beberapa tambalan telah diterapkan selama
ekstraksi.

Bangunan

Semua tarball asli yang ditemukan di direktori saat ini diekstraksi untuk sementara
direktori dengan mengikuti logika yang sama seperti untuk membongkar, direktori debian disalin
di direktori sementara, dan semua tambalan kecuali tambalan otomatis
(debian-perubahan-versi or debian-perubahan, bergantung kepada --patch-debian-tunggal) adalah
terapan. Direktori sementara dibandingkan dengan direktori paket sumber. Ketika
diff tidak kosong, build gagal kecuali --patch-debian-tunggal or --komit otomatis telah
digunakan, dalam hal ini perbedaan disimpan dalam tambalan otomatis. Jika tambalan otomatis adalah
dibuat/dihapus, ditambahkan/dihapus dari file seri dan dari selimut metadata.

Setiap perubahan pada file biner tidak dapat direpresentasikan dalam diff dan dengan demikian akan menyebabkan kegagalan
kecuali jika pengelola sengaja memutuskan untuk memasukkan file biner yang dimodifikasi itu ke dalam
tarball debian (dengan mencantumkannya di debian/source/include-binary). Build juga akan gagal
jika menemukan file biner di sub-direktori debian kecuali jika mereka telah masuk daftar putih
melalui debian/source/include-binary.

Direktori debian yang diperbarui dan daftar binari yang dimodifikasi kemudian digunakan untuk menghasilkan
tarbal debian.

Perbedaan yang dibuat secara otomatis tidak termasuk perubahan pada file tertentu VCS serta
banyak file sementara (lihat nilai default yang terkait dengan -i pilihan dalam --membantu keluaran). Di
tertentu, .pc direktori yang digunakan oleh selimut diabaikan selama pembuatan otomatis
tambalan.

Catatan: dpkg-sumber --sebelum-membangun (Dan --membangun) akan memastikan bahwa semua tambalan terdaftar di
file seri diterapkan sehingga pembuatan paket selalu menerapkan semua tambalan. memang
ini dengan menemukan tambalan yang belum diterapkan (terdaftar di seri file tapi tidak di
.pc/applied-patches), dan jika tambalan pertama di set itu dapat diterapkan tanpa kesalahan, itu
akan menerapkan semuanya. Pilihan --tanpa persiapan dapat digunakan untuk menonaktifkan perilaku ini.

Rekaman perubahan

--melakukan [direktori] [nama tambalan] [file tambalan]
Menghasilkan tambalan yang sesuai dengan perubahan lokal yang tidak dikelola oleh
selimut sistem tambalan dan mengintegrasikannya ke dalam sistem tambalan dengan nama nama tambalan.
Jika nama tidak ada, itu akan ditanyakan secara interaktif. Jika file tambalan diberikan, itu
digunakan sebagai tambalan yang sesuai dengan perubahan lokal untuk diintegrasikan. Sekali
terintegrasi, editor diluncurkan sehingga Anda dapat mengedit meta-informasi di
tambalan kepala.

Lewat file tambalan terutama berguna setelah kegagalan build yang menghasilkan ini sebelumnya
file, dan atas dasar ini file yang diberikan dihapus setelah integrasi. Perhatikan juga
bahwa perubahan yang terkandung dalam file tambalan harus sudah diterapkan di pohon
dan bahwa file yang dimodifikasi oleh tambalan tidak boleh memiliki tambahan yang belum direkam
perubahan.

Jika generasi tambalan mendeteksi file biner yang dimodifikasi, mereka akan secara otomatis
ditambahkan ke debian/source/include-binary sehingga mereka berakhir di tarball debian
(tepat seperti dpkg-sumber --termasuk-binari --membangun akan melakukan).

Membangun Pilihan

--izinkan-versi-dari-quilt-db=versi
mengizinkan dpkg-sumber untuk membangun paket sumber jika versi selimut metadata
adalah yang ditentukan, bahkan jika dpkg-sumber tidak tahu tentang itu (karena dpkg
1.15.5.4). Secara efektif ini mengatakan bahwa versi yang diberikan dari selimut metadata adalah
kompatibel dengan versi 2 yang dpkg-sumber saat ini mendukung. Versi dari
itu selimut metadata disimpan di .pc/.versi.

--termasuk-penghapusan
Jangan abaikan file yang dihapus dan sertakan dalam patch yang dibuat secara otomatis.

--termasuk-stempel waktu
Sertakan stempel waktu di tambalan yang dibuat secara otomatis.

--termasuk-binari
Tambahkan semua binari yang dimodifikasi di tarball debian. Tambahkan juga ke
debian/source/include-binary: mereka akan ditambahkan secara default di build berikutnya
dan opsi ini tidak lagi diperlukan.

--tanpa persiapan
Jangan mencoba menyiapkan pohon build dengan menerapkan tambalan yang tampaknya
belum diterapkan (sejak dpkg 1.14.18).

--patch-debian-tunggal
penggunaan debian/patch/debian-perubahan alih-alih debian/patch/debian-perubahan-versi
untuk nama patch otomatis yang dihasilkan selama build (sejak dpkg 1.15.5.4).
Opsi ini sangat berguna ketika paket dipertahankan dalam VCS dan a
set tambalan tidak dapat dibuat dengan andal. Alih-alih perbedaan arus dengan hulu
harus disimpan dalam satu tambalan. Pilihan akan dimasukkan ke dalam
debian/sumber/pilihan lokal dan akan disertai dengan
debian/source/local-patch-header file yang menjelaskan bagaimana perubahan Debian bisa menjadi yang terbaik
ditinjau, misalnya pada VCS yang digunakan.

--buat-kosong-asal
Secara otomatis membuat tarbal asli utama kosong jika hilang dan jika
ada tarbal asli tambahan (sejak dpkg 1.15.6). Pilihan ini adalah
dimaksudkan untuk digunakan ketika paket sumber hanyalah bundel dari beberapa hulu
perangkat lunak dan di mana tidak ada perangkat lunak "utama".

--no-unapply-patch, --unapply-patch
Secara default, dpkg-sumber akan secara otomatis menghapus tambalan di --setelah-membangun
kait jika itu menerapkannya selama --sebelum-membangun (--unapply-patch sejak dpkg
1.15.8, --no-unapply-patch sejak dpkg 1.16.5). Opsi tersebut memungkinkan Anda untuk
paksa menonaktifkan atau mengaktifkan proses patch unapplication. Pilihan itu adalah
hanya diperbolehkan masuk debian/sumber/pilihan lokal sehingga semua paket sumber yang dihasilkan
memiliki perilaku yang sama secara default.

--batalkan-pada-upstream-perubahan
Proses gagal jika patch otomatis telah dibuat (sejak dpkg 1.15.8).
Opsi ini dapat digunakan untuk memastikan bahwa semua perubahan dicatat dengan benar di
terpisah selimut patch sebelum paket sumber dibuat. Pilihan ini tidak
diperbolehkan masuk debian/sumber/opsi tetapi dapat digunakan dalam debian/sumber/pilihan lokal.

--komit otomatis
Prosesnya tidak gagal jika tambalan otomatis telah dibuat, melainkan
langsung terekam di selimut series.

Ekstrak Pilihan

--lewati-debianisasi
Melewati ekstraksi tarbal debian di atas sumber upstream (sejak dpkg
1.15.1).

--lewati-tambalan
Jangan menerapkan tambalan di akhir ekstraksi (sejak dpkg 1.14.18).

Format: 3.0 (kebiasaan)
Didukung sejak dpkg 1.14.17. Format ini istimewa. Itu tidak mewakili sumber nyata
format paket tetapi dapat digunakan untuk membuat paket sumber dengan file arbitrer.

Membangun Pilihan

Semua argumen non-opsi diambil sebagai file untuk diintegrasikan dalam paket sumber yang dihasilkan.
Mereka harus ada dan lebih disukai di direktori saat ini. Setidaknya satu file harus
diberikan.

--format-target=nilai
Wajib. Mendefinisikan format sebenarnya dari paket sumber yang dihasilkan. yang dihasilkan
File .dsc akan berisi nilai ini di dalamnya dibentuk bidang dan bukan "3.0 (kustom)".

Format: 3.0 (git)
Didukung sejak dpkg 1.14.17. Format ini bersifat eksperimental.

Paket sumber dalam format ini terdiri dari satu bundel repositori git .git untuk
memegang sumber paket. Mungkin juga ada .gitdangkal revisi daftar file untuk
klon git yang dangkal.

Ekstraksi

Bundel dikloning sebagai repositori git ke direktori target. Jika ada
gitshallow file, itu diinstal sebagai .git/dangkal di dalam repositori git yang dikloning.

Perhatikan bahwa secara default repositori baru akan memiliki cabang yang sama yang diperiksa sebelumnya
diperiksa di sumber aslinya. (Biasanya “master”, tapi bisa apa saja.)
cabang lain akan tersedia di bawah jarak jauh/asal/.

Bangunan

Sebelum melangkah lebih jauh, beberapa pemeriksaan dilakukan untuk memastikan bahwa kami tidak memiliki non-
mengabaikan perubahan yang tidak dikomit.

git-bundel(1) digunakan untuk menghasilkan bundel repositori git. Secara default, semua
cabang dan tag dalam repositori disertakan dalam bundel.

Membangun Pilihan

--git-ref=ref
Memungkinkan menentukan git ref untuk disertakan dalam bundel git. Gunakan menonaktifkan default
perilaku termasuk semua cabang dan tag. Dapat ditentukan beberapa kali. Itu
ref dapat berupa nama cabang atau tag untuk disertakan. Mungkin juga parameter apa saja
yang dapat diteruskan ke git-rev-list(1). Misalnya, untuk memasukkan hanya master
cabang, gunakan --git-ref=menguasai. Untuk memasukkan semua tag dan cabang, kecuali untuk
cabang pribadi, gunakan --git-ref=--semua --git-ref=^pribadi

--git-kedalaman=jumlah
Membuat klon dangkal dengan riwayat terpotong ke jumlah yang ditentukan
revisi.

Format: 3.0 (bzr)
Didukung sejak dpkg 1.14.17. Format ini bersifat eksperimental. Ini menghasilkan satu tarball
berisi repositori bzr.

Ekstraksi

Tarball dibongkar dan kemudian bzr digunakan untuk checkout cabang saat ini.

Bangunan

Sebelum melangkah lebih jauh, beberapa pemeriksaan dilakukan untuk memastikan bahwa kami tidak memiliki non-
mengabaikan perubahan yang tidak dikomit.

Kemudian bagian khusus VCS dari direktori sumber disalin ke direktori sementara
direktori. Sebelum direktori sementara ini dikemas dalam tarball, berbagai pembersihan dilakukan
dilakukan untuk menghemat ruang.

DIAGNOSTIK

tidak sumber format ditentukan in debian/sumber/format
File debian/sumber/format harus selalu ada dan menunjukkan format sumber yang diinginkan.
Untuk kompatibilitas mundur, format "1.0" diasumsikan ketika file tidak ada tetapi Anda
seharusnya tidak bergantung pada ini: di beberapa titik di masa depan dpkg-sumber akan dimodifikasi untuk gagal
ketika file itu tidak ada.

Alasannya adalah bahwa format "1.0" bukan lagi format yang disarankan, Anda biasanya harus
pilih salah satu format yang lebih baru (“3.0 (quilt)”, “3.0 (native)”) tapi dpkg-sumber tidak akan melakukan
ini secara otomatis untuk Anda. Jika Anda ingin terus menggunakan format lama, Anda harus
eksplisit tentang itu dan masukkan "1.0" ke dalam debian/sumber/format.

itu diff memodifikasi itu berikut ke hulu arsip
Saat menggunakan format sumber "1.0" biasanya merupakan ide yang buruk untuk memodifikasi file upstream secara langsung
karena perubahan akhirnya tersembunyi dan sebagian besar tidak didokumentasikan dalam file .diff.gz. Sebagai gantinya kamu
harus menyimpan perubahan Anda sebagai tambalan di direktori debian dan menerapkannya pada waktu pembuatan.
Untuk menghindari kerumitan ini, Anda juga dapat menggunakan format "3.0 (quilt)" yang menawarkan ini
secara asli.

tidak bisa mewakili perubahan untuk fillet
Perubahan pada sumber upstream biasanya disimpan dengan file patch, tetapi tidak semua perubahan dapat
direpresentasikan dengan tambalan: mereka hanya dapat mengubah konten file teks biasa. Jika kamu
coba ganti file dengan jenis yang berbeda (misalnya mengganti file biasa
file dengan symlink atau direktori), Anda akan mendapatkan pesan kesalahan ini.

baru saja dibuat kosong fillet fillet akan tidak be diwakili in diff
File kosong tidak dapat dibuat dengan file patch. Dengan demikian perubahan ini tidak dicatat dalam
paket sumber dan Anda diperingatkan tentang hal itu.

executable mode perm of fillet akan tidak be diwakili in diff
File tambalan tidak merekam izin file dan dengan demikian izin yang dapat dieksekusi tidak
disimpan dalam paket sumber. Peringatan ini mengingatkan Anda akan fakta itu.

khusus mode perm of fillet akan tidak be diwakili in diff
File tambalan tidak merekam izin file dan dengan demikian izin yang dimodifikasi tidak
disimpan dalam paket sumber. Peringatan ini mengingatkan Anda akan fakta itu.

FILE FORMAT

debian/sumber/format
File ini berisi satu baris format yang harus digunakan untuk membangun sumber
paket (kemungkinan format dijelaskan di atas). Tidak ada spasi awal atau akhir yang diperbolehkan.

debian/source/include-binary
File ini berisi daftar file biner (satu per baris) yang harus disertakan dalam
tarbal debian. Leading dan trailing space dilucuti. Baris dimulai dengan '#' adalah
komentar dan dilewati. Baris kosong diabaikan.

debian/sumber/opsi
File ini berisi daftar opsi panjang yang harus secara otomatis ditambahkan ke
set opsi baris perintah dari a dpkg-sumber --membangun or dpkg-sumber --format-cetak panggilan.
Pilihan suka --kompresi dan --tingkat kompresi sangat cocok untuk file ini.

Setiap opsi harus diletakkan pada baris terpisah. Baris kosong dan baris yang dimulai dengan '#' adalah
diabaikan. terkemuka'--' harus dilucuti dan opsi pendek tidak diperbolehkan. Pilihan
spasi diperbolehkan di sekitar '=' simbol dan kutipan opsional diperbolehkan di sekitar nilai.
Berikut ini contoh file semacam itu:

# biarkan dpkg-source membuat debian.tar.bz2 dengan kompresi maksimal
kompresi = "bzip2"
tingkat kompresi = 9
# gunakan debian/patches/debian-changes sebagai tambalan otomatis
tambalan debian tunggal
# abaikan perubahan pada konfigurasi.{sub,tebak}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

Catatan: format opsi tidak diterima dalam file ini, Anda harus menggunakan debian/sumber/format
sebagai gantinya.

debian/sumber/pilihan lokal
Tepat seperti debian/sumber/opsi kecuali bahwa file tersebut tidak termasuk dalam file yang dihasilkan
paket sumber. Ini dapat berguna untuk menyimpan preferensi yang terkait dengan pengelola atau ke
Repositori VCS tempat paket sumber dipertahankan.

debian/source/local-patch-header dan debian/sumber/tajuk tambalan
Teks bentuk bebas yang diletakkan di atas tambalan otomatis yang dihasilkan dalam format "2.0" atau
“3.0 (selimut)”. lokal-patch-header tidak termasuk dalam paket sumber yang dihasilkan sementara
tajuk tambalan adalah.

debian/patch/seri
File ini mencantumkan semua tambalan yang harus diterapkan (dalam urutan yang diberikan) di atas
paket sumber hulu. Leading dan trailing space dilucuti. Garis dimulai dengan
'#' adalah komentar dan dilewati. Baris kosong diabaikan. Baris yang tersisa dimulai dengan a
nama file tambalan (relatif terhadap debian/patch/ direktori) hingga karakter spasi pertama
atau akhir baris. Pilihan selimut opsi dapat mengikuti hingga akhir baris atau yang pertama
'#' didahului oleh satu spasi atau lebih (yang menandai awal komentar hingga akhir
garis).

Gunakan dpkg-source online menggunakan layanan onworks.net