5.3. Структура исходного пакета

5.3.1. Формат

Исходный пакет, как правило, состоит из трех файлов: .dsc, .orig.tar.gz и debian.tar.xz (или .diff.gz). С их помощью можно создавать двоичные пакеты (файлы .deb, описанные выше) из файлов исходного кода программы на том или ином языке программирования.

Файл .dsc (Debian Source Control) представлят собой текстовый файл с заголовком в формате RFC 2822 (точно так же, как файл control, рассмотренный в Раздел 5.2.1, «Описание: файл control»), где описывается исходный пакет и указываются другие файлы, входящие в него. Он подписан сопровождающим, что гарантирует его подлинность. См. Раздел 6.6, «Проверка подлинности пакета» для получения дополнительной информации по этому вопросу.

Пример 5.1. Файл .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-----

Обратите внимание, что исходный пакет тоже имеет зависимости (Build-Depends), кардинально отличающиеся от зависимостей для двоичных пакетов, поскольку они включают в себя инструменты, необходимые для компиляции программного обеспечения и сборки двоичного пакета.

ВНИМАНИЕ Разные пространства имён

Важно отметить, что имена исходного пакета и создаваемого из него двоичного пакета не обязательно должны совпадать. Это нетрудно понять, если вы знаете, что из каждого исходного пакета может быть создано несколько двоичных пакетов. Вот почему в файле .dsc есть поля Source и Binary, где явно указываются имя исходного пакета и список создаваемых из него двоичных пакетов.

КУЛЬТУРА Зачем разделять на несколько пакетов

Довольно часто из исходного пакета (того или иного программного обеспечения) может создаваться несколько двоичных пакетов. Смысл разделения заключается в возможности использовать части программного обеспечения в различных контекстах. В случае динамической библиотеки целью установки может быть обеспечение работы того или иного приложения (например libc6) или разработка новой программы (тогда понадобится libc6-dev). Та же логика используется и для клиент-серверных приложений, для которых может возникнуть желание установить серверную часть на одной машине, а клиентскую на нескольких других (типичным примером являются openssh-server и openssh-client).

Довольно часто документация предоставляется в отдельном пакете: пользователь может установить её независимо от программного обеспечения, и может в любое время удалить её для экономии места на диске. Кроме того, это также помогает сэкономить дисковое пространство на зеркалах Debian, так как пакет с документацией будет общим для всех архитектур (вместо того, чтобы дублировать документацию в пакетах для каждой архитектуры).

ПЕРСПЕКТИВА Различные форматы исходных пакетов

Первоначально был только один формат исходных пакетов. Это формат 1.0, который связывает архив .orig.tar.gz с «дебианизирующей» заплатой .diff.gz (есть также вариант, включающий единственный архив .tar.gz, который используется автоматически, если .orig.tar.gz отсутствует).

Начиная с Debian 6 Squeeze, разработчики Debian имеют возможность использовать новые форматы, которые исправляют многие проблемы исторического формата. Формат 3.0 (quilt) может объединить несколько архивов в одном и том же исходном пакете: в дополнение к обычному .orig.tar.gz можно включить дополнительные .orig-component.tar.gz. Это полезно с программным обеспечением, которое распространяется в нескольких компонентах в апстриме, но для которого требуется один исходный пакет. Эти архивы также могут быть сжаты с помощью xz, а не gzip, который сохраняет дисковое пространство и сетевые ресурсы. Наконец, монолитный патч, .diff.gz заменяется архивом .debian.tar.xz, содержащим компилирующие инструкции и набор патчей в апстрим, внесенных мейнтейнером пакета. Эти последние записываются в формате, совместимом с quilt — инструмент, который облегчает управление серией патчей.

Файл .orig.tar.gz — это архив, содержащий исходный код в том виде, в каком он предоставляется оригинальным разработчиком. Сопровождающим пакетов Debian не рекомендовано изменять этот архив, чтобы иметь возможность легко проверить подлинность и целостность файла (путём простого сравнения контрольной суммы), а также в угоду пожеланиям некоторых авторов.

Архив .debian.tar.xz содержит все изменения, произведённые сопровождающим пакета, в частности добавление каталога debian, содержащего инструкции для выполнения сборки одного или нескольких бинарных пакетов Debian.

ИНСТРУМЕНТ Распаковка пакетов c исходным кодом

При наличии исходного пакета его можно распаковать с помощью dpkg-source (из пакета dpkg-dev):

$ 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

Вы можете также использовать apt-get для загрузки пакета с исходными кодами и последующей распаковки. Для этого необходимо, чтобы были раскомментированы строки deb-src, представленные в файле /etc/apt/sources.list, подробнее (для других деталей, смотри Раздел 6.1, «Содержимое файла sources.list»). В него включён перечень хранилищ “source”, на которых находятся пакеты с исходными кодами (подразумеваются серверы, на которых расположены хранилища).

$ 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. Использование в Debian

Пакеты с исходными кодами являются основой всего в системе Debian. При помощи них собраны все остальные пакеты Debian, и любое изменение в двоичных пакетах — следствие изменений, внесенных в исходный пакет. Сопровождающие Debian работают только с исходными пакетами, однако знают, какими окажутся последствия их действий для двоичных пакетов. Так что плоды их трудов находятся в исходных пакетах: к ним можно легко вернуться, и они есть начало всего. Глава 15, Создание пакета Debian содержит несколько примеров.

Когда новая версия исходного пакета поступает на сервер Debian, она затем будет использоваться сетью машин разных архитектур для компиляции на различных архитектурах, поддерживаемых Debian.

→ https://buildd.debian.org/

УГЛУБЛЯЕМСЯ Только исходный код загружает мейнтейнер

Сразу после выпуска Debian 10 Buster команда Release Team объявила, что бинарные загрузки сопровождающего больше не будут приниматься для main и все бинарные пакеты в этом компоненте должны создаваться автоматически на основе обязательной загрузки только исходного кода. Хотя двоичная загрузка по-прежнему разрешена для компонентов contrib и non-free, мы не будем акцентировать внимание на этой возможности, поскольку это должно быть только исключением.