5.3. Struktur sebuah Paket Sumber

5.3.1. Format

Sebuah paket sumber biasanya berisi tiga berkas, .dsc, .orig.tar.gz, dan .debian.tar.xz (atau .diff.gz). Mereka memungkinkan pembuatan paket biner (berkas .deb dijelaskan di atas) dari berkas kode sumber program, yang ditulis dengan sebuah bahasa pemrograman.

Berkas .dsc (Debian Source Control) ialah berkas teks pendek berisi header RFC 2822 (seperti berkas control yang dipelajari di Bagian 5.2.1, “Penjelasan: Berkas control”) yang menjelaskan paket sumber dan menunjukkan berkas mana yang merupakan bagiannya. Ditanda tangani oleh maintainernya, yang menjamin otentitasnya. Lihat Bagian 6.6, “Pemeriksaan Otentikasi Paket” untuk detail lebih jauh pada hal tersebut.

Contoh 5.1. Berkas .dsc

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 3.0 (quilt)
Source: zim
Binary: zim
Architecture: all
Version: 0.73.5-1
Maintainer: Zim Package Maintainers <[email protected]>
Uploaders: Raphaël Hertzog <[email protected]>
Homepage: https://zim-wiki.org
Standards-Version: 4.5.1
Vcs-Browser: https://salsa.debian.org/debian/zim
Vcs-Git: https://salsa.debian.org/debian/zim.git
Build-Depends: debhelper-compat (= 13), python3, python3-gi, python3-xdg, gir1.2-gtk-3.0, dh-python
Package-List:
 zim deb x11 optional arch=all
Checksums-Sha1:
 80d43d5c1c6a47c695079eb02bc8ad36b84d6e57 2159901 zim_0.73.5.orig.tar.gz
 b1cd86dc4819a80126efbf6ee6eba17a33f451d3 10124 zim_0.73.5-1.debian.tar.xz
Checksums-Sha256:
 a36f15d92c3994c0d55b07f83253b3d8b826beb3714865edbabc14f1cc91d63a 2159901 zim_0.73.5.orig.tar.gz
 6c2db642d9ac1c2440ed08e0cd584006045b342b255f37ffe42bd5459fb5cb76 10124 zim_0.73.5-1.debian.tar.xz
Files:
 fa76ceb8ac7d7354fb0e2bc5607e9faa 2159901 zim_0.73.5.orig.tar.gz
 a0c824d979efb196cde0176d3cb9c719 10124 zim_0.73.5-1.debian.tar.xz

-----BEGIN PGP SIGNATURE-----
Comment: Signed by Raphael Hertzog

iQEzBAEBCgAdFiEE1823g1EQnhJ1LsbSA4gdq+vCmrkFAmAa3ooACgkQA4gdq+vC
mrkq1gf/cs7irmbCSDrADVqsqYBrFJ1FyprE3jiHLNs0OQLryhFj9tzDuilX35VE
HkCfxSaKkzgvQLYtpuw1VBfhOdngTdHO39U6eljkaScnfLWU8Z5n/q+YeedxItoY
X3TtzMexFmb4WJqlylfjbXeqbLdYvsILQ3NVnE48AzkaBQlCC2d9bqecZhWiKfzq
gNxIDVDDhqCXMPe7QCErCBiFPUVpGN7b+6QWN0RxOTLZdj/slRD73rT++VmY+xN1
L8BSLcjXie+ES11MhQNYaLpCv2vqImlZaxkFWvsKBo9ndRFSbE3/RNK479a4KGve
KrdpGUJXy9uLPuAMyn5WphwXJ7OZXQ==
=YFDk
-----END PGP SIGNATURE-----

Catat bahwa paket sumber juga memiliki ketergantungan (Build-Depends) sangat berbeda dari paket binernya, karena mereka menunjukkan alat yang diperlukan untuk mengompilasi perangkat lunak yang diminta dan membangun paket binernya.

KULTUR Mengapa dibagi ke beberapa paket

Cukup sering, sebuah paket sumber (untuk perangkat lunak tertentu) dapat menghasilkan beberapa paket biner. Pembagian ini dibenarkan oleh kemungkinan untuk menggunakan (bagian dari) perangkat lunak dalam konteks yang berbeda. Misalnya suatu pustaka bersama (shared library), mungkin diinstall agar aplikasi dapat berjalan (contohnya, libc6), atau dapat diinstall untuk mengembangkan sebuah program (libc6-dev adalah paket yang benar). Kami menemukan logika yang sama untuk layanan klien/server dimana kita ingin menginstall bagian server pada satu mesin dan bagian klien di yang lainnya (ini adalah keadaan, sebagai contoh, dari openssh-server dan openssh-client).

Just as frequently, the documentation is provided in a dedicated package: the user may install it independently from the software, and may at any time choose to remove it to save disk space. Additionally, this also saves disk space on the Debian mirrors, since the documentation package will be shared among all of the architectures (instead of having the documentation duplicated in the packages for each architecture).

PERSPECTIVE Berbeda format paket sumber

Aslinya hanya ada satu format paket sumber. Inilah format 1.0, yang menghubungkan arsip .orig.tar.gz ke .diff.gz patch “debianisasi” (ada juga varian, berisi sebuah arsip .tar.gz, yang secara otomatis digunakan jika tidak ada arsip .orig.tar.gz).

Sejak Debian 6 Squeeze, developer Debian memiliki pilihan untuk menggunakan format baru yang memerbaiki banyak masalah pada sejarah formatnya. Format 3.0 (quilt) dapat menggabungkan beberapa arsip upstream dalam paket sumber yang sama: sebagai tambahan ke arsip biasa .orig.tar.gz, tambahannya arsip .orig-component.tar.gz dapat juga disertakan. Hal ini berguna dengan perangkat lunak yang didistribusikan pada beberapa komponen upstream namun untuk paket sumber tunggal yang diminta. Arsip ini juga dapat dikompres xz daripada gzip, yang menghemat ruang disk dan sumber daya jaringan. Akhirnya, patch monolitik, .diff.gz diganti dengan arsip .debian.tar.xz berisi instruksi kompilasi dan beberapa patch upstream yang disumbangkan oleh maintainer paket. Yang terakhir ini direkam dalam format yang cocok dengan quilt - sebuah alat yang memfasilitasi pengelolaan beberapa seri patch.

Berkas .orig.tar.gz adalah sebuah arsip berisi kode sumber yang disediakan oleh pengembang aslinya. Maintainer paket Debian diminta untuk tidak memodifikasi arsip ini agar mudah memeriksa keaslian dan integritas berkas (pembandingan dengan checksum) dan menghormati keinginan beberapa penulis.

The .debian.tar.xz contains all of the modifications made by the Debian maintainer, especially the addition of a debian directory containing the instructions to execute to construct one or more Debian binary packages.

ALAT Mendekompress sebuah paket sumber

Jika Anda memiliki sebuah paket sumber, Anda dapat menggunakan perintah dpkg-source (dari paket dpkg-dev) untuk mendekompresinya:

$ dpkg-source -x zim_0.73.5-1.dsc
dpkg-source: info: extracting zim in zim-0.73.5
dpkg-source: info: unpacking zim_0.73.5.orig.tar.gz
dpkg-source: info: unpacking zim_0.73.5-1.debian.tar.xz

Anda juga dapat menggunakan apt untuk mengunduh paket sumber dan membuka kemasannya saat itu juga. Hal ini memerlukan baris deb-src yang sesuai di berkas /etc/apt/sources.list, akan tetapi (untuk detail lebih jauh, lihat Bagian 6.1, “Mengisi Berkas sources.list”). Hal ini diperlukan untuk mendaftar “sumber” paket sumber (maksudnya server di mana kelompok paket sumber di simpan).

$ apt source package

Reading package lists... Done
NOTICE: 'zim' packaging is maintained in the 'Git' version control system at:
https://salsa.debian.org/debian/zim.git
Please use:
git clone https://salsa.debian.org/debian/zim.git
to retrieve the latest (possibly unreleased) updates to the package.
Need to get 2,172 kB of source archives.
Get:1 https://deb.debian.org/debian bullseye/main zim 0.73.5-1 (dsc) [1,580 B]
Get:2 https://deb.debian.org/debian bullseye/main zim 0.73.5-1 (tar) [2,160 kB]
Get:3 https://deb.debian.org/debian bullseye/main zim 0.73.5-1 (diff) [10.1 kB]
Fetched 2,172 kB in 0s (7,176 kB/s)
dpkg-source: info: extracting zim in zim-0.73.5
dpkg-source: info: unpacking zim_0.73.5.orig.tar.gz
dpkg-source: info: unpacking zim_0.73.5-1.debian.tar.xz

5.3.2. Penggunaannya dalam Debian

The source package is the foundation of everything in Debian. All Debian packages come from a source package, and each modification in a Debian package is the consequence of a modification made to the source package. The Debian maintainers work with the source package, knowing, however, the consequences of their actions on the binary packages. The fruits of their labors are thus found in the source packages available from Debian: you can easily go back to them and everything stems from them. Bab 15, Membuat paket Debian contains some examples.

When a new version of a source package arrives on the Debian server, it will then be used by a network of machines of different architectures for compilation on the various architectures supported by Debian.

→ https://buildd.debian.org/