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.75.1-1
Maintainer: Zim Package Maintainers <zim@packages.debian.org>
Uploaders: Raphaël Hertzog <hertzog@debian.org>
Homepage: https://zim-wiki.org
Standards-Version: 4.6.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:
 b4baa294ebc28b07393739875d94fab9557a2e5e 2510821 zim_0.75.1.orig.tar.gz
 e592c9ab8b12276283c6a7bed2246f2e9a843093 10416 zim_0.75.1-1.debian.tar.xz
Checksums-Sha256:
 88e175d7f7e141896f9e958989d252d722556af17bc4bc6f065e7d54287d0385 2510821 zim_0.75.1.orig.tar.gz
 30847b58bb2503b707f1d5c5c356eead31e61db09e677348f07383fcdda3bcb3 10416 zim_0.75.1-1.debian.tar.xz
Files:
 cc73838c1312b5e161d15a51ae4247c4 2510821 zim_0.75.1.orig.tar.gz
 ad84c5ac373071e4957490caf03f3a8b 10416 zim_0.75.1-1.debian.tar.xz

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

iQEzBAEBCgAdFiEE1823g1EQnhJ1LsbSA4gdq+vCmrkFAmO15esACgkQA4gdq+vC
mrkB4AgAj2tYiDW4aQdZfJHr/GGU9rHL99+lTL1VmrXr/I6Z8ggig0JGbTH4Z3lg
QNRu1PbFDJgdO1ho+c0b474iOsT4QTIUu9vHX/enwJ1MiQw8wGDNlsJIS+S33j5n
745p9Y782LTyKaaKPnilHst7pTIGNjmFRlqJr9E8K3gRjZjpTg6HE420epZ6haf1
+gk2npbsy2Psu1LsrbDUCa415COsogar6fpU3Kui3/p8ijT1ED1y9CqoNxATequp
nHkwpnwmi24Y5+RV79SXKW3ECOHTHGKCRWGFtSwCFg0LcAq69cTwnyphXt0gW/+Z
RtG81/jI+mMeRUGsdzdjAVlLK7K75w==
=0po3
-----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).

Sama seringnya, dokumentasi disediakan dalam paket khusus: pengguna dapat memasangnya secara independen dari perangkat lunak, dan dapat menghapusnya kapan saja untuk menghemat ruang disk. Selain itu, ini juga menghemat ruang disk pada mirror Debian, karena paket dokumentasi akan dibagi antara seluruh arsitektur (ketimbang dokumentasi dibuat duplikat pada paket untuk setiap arsitektur).

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.

.debian.tar.xz bersisi seluruh modifikasi yang dibuat oleh pengelola Debian, khususnya tambahan direktori debian berisi instruksi untuk eksekusi pembangunan satu atau lebih paket Debian biner.

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.75.1-1.dsc
dpkg-source: info: extracting zim in zim-0.75.1
dpkg-source: info: unpacking zim_0.75.1.orig.tar.gz
dpkg-source: info: unpacking zim_0.75.1-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 zim

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,523 kB of source archives.
Get:1 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (dsc) [1,580 B]
Get:2 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (tar) [2,511 kB]
Get:3 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (diff) [10.4 kB]
Fetched 2,523 kB in 0s (12.4 MB/s)
dpkg-source: info: extracting zim in zim-0.75.1
dpkg-source: info: unpacking zim_0.75.1.orig.tar.gz
dpkg-source: info: unpacking zim_0.75.1-1.debian.tar.xz

5.3.2. Penggunaannya dalam Debian

Paket sumber adalah dasar dari segalanya di Debian. Seluruh paket Debian datang dari paket sumber, dan setiap perubahan dalam paket Debian ialah konsekuensi dari modifikasi yang dibuat untuk paket sumber. Pengelola Debian bekerja dengan paket sumber, mengatahui, bagaimanapun, konsekuensi aksi mereka pada paket binernya. Buah dari pekerjaan mereka ialah yang ditemukan di paket sumber yang tersedia dari Debian: Anda dapat dengan mudah kembali ke mereka dan apapun berasal dari mereka. Bab 15, Membuat paket Debian berisi beberapa contoh.

Ketika versi baru dari paket sumber tiba di server Debian, itu akan digunakan oleh jaringan mesin dengan arsitektur yang berbeda untuk kompilasi pada berbagai arsitektur yang didukung oleh Debian.

→ https://buildd.debian.org/