Les données de contrôle pourraient être incluses dans une signature OpenPGP
« ASCII Armored », comme spécifié dans RFC4880.
- Format: version-format (requis)
-
La valeur de ce champ déclare la version du format du paquet source. La
valeur du champ est utilisée par les programmes qui agissent sur un paquet
source pour interpréter la liste des fichiers du paquet source et déterminer
comment le dépaqueter. La syntaxe de la valeur du champ est un numéro de
révision majeure (« 0-9 »), un point (« . »), un numéro de révision mineure,
puis un sous-type facultatif après une espace (« ») qui, lorsqu'il est
présent, est un mot en caractères alphanumériques (« a-z0-9 »), en
minuscules entre parenthèses (« () ». Le sous-type est facultatif dans la
syntaxe, mais peut être obligatoire pour certaines révisions particulières
du format source.
Les formats source actuellement pris en charge par dpkg sont 1.0,
2.0, 3.0 (native), 3.0 (quilt), 3.0 (git), 3.0 (bzr) et 3.0
(custom). Voir dpkg-source(1) pour leur description.
- Source: nom-source (requis)
-
La valeur de ce champ donne le nom du paquet, et la plupart des outils
d'installation s'en servent pour produire les noms des paquets.
- Binary: liste-de-paquets-binaires
-
Ce champ coupé liste des paquets binaires que ce paquet source peut produire
séparés par des virgules.
Ce champ a maintenant été remplacé par le champ Package-List qui donne
suffisamment d'informations sur quels paquets binaires sont produits sur
quelle architecture, quel profil de construction et autres restrictions
actives.
- Architecture: liste-architectures (recommandé)
-
Une liste d'architectures et de jokers d'architecture séparés par des
espaces qui précisent le type de matériel pour lequel ce paquet peut être
compilé. Les noms et les jokers d'architecture courants sont amd64,
armel, i386, linux-any, any-amd64, etc.
Notez que la valeur all est destinée aux paquets indépendants de
l'architecture et any à ceux qui sont dépendants d'une architecture. La
liste peut comprendre (ou consister uniquement de) la valeur spéciale
all. Quand la liste comprend le joker d'architecture any, la seule
autre valeur permise dans la liste est all.
La valeur du champ est en général générée par les champs Architecture du
fichier debian/control du paquet source.
- Version: chaîne-de-la-version (requis)
-
C'est classiquement le numéro de version du paquet d'origine dans la forme
choisie par l'auteur du programme. Il peut y avoir aussi un numéro de
révision Debian (pour les paquets non natifs). Le format exact et
l'algorithme de tri sont décrits dans deb-version(7).
- Origin: nom
-
Nom de la distribution dont ce paquet provient.
- Maintainer: nom-complet-et-adresse-électronique (recommandé)
-
Le format de ce champ sera « Jean Dupont <jdupont@foo.com> » ; et
c'est bien sûr le créateur du paquet, par opposition à l'auteur du programme
mis en paquet.
- Uploaders: liste-de-noms-complets-et-adresses-électroniques
-
Affiche les noms et les adresses électroniques des co-responsables du
paquet, au même format que le champ Maintainer. Des co-responsables
multiples peuvent être séparés par des virgules.
- Description description-courte
-
description-longue
Le format de la description du paquet est un résumé bref sur la première
ligne (après le champ Description). Les lignes suivantes peuvent servir à
une description plus longue et plus détaillée. Chaque ligne de cette
description longue doit être précédée d'une espace ; quand c'est une ligne
blanche, elle doit contenir un seul « . » après cette espace.
- Homepage: URL
-
URL de la page d'accueil du projet amont.
- Standards-Version: chaîne-de-la-version (recommandé)
-
Ce champ indique la version la plus récente des normes de la charte de la
distribution auxquelles ce paquet se conforme.
- Vcs-Browser: URL
-
Indique l'URL de l'interface web permettant de parcourir le dépôt du
système de gestion de versions.
- Vcs-Arch: URL
-
Vcs-Bzr: URL
Vcs-Cvs: URL
Vcs-Darcs: URL
Vcs-Git: URL
Vcs-Hg: URL
Vcs-Mtn: URL
Vcs-Svn: URL
Ces champs indiquent l'URL du dépôt du système de gestion de versions
utilisé pour la gestion du paquet. Voir deb-src-control(5) pour plus de
détails.
- Testsuite: liste-de-noms
-
Ce champ indique que le paquet source contient les suites de tests
spécifiées. La valeur est une liste des suites de tests séparées par des
virgules. Si la valeur autopkgtest est présente, un fichier
debian/tests/control devrait être présent, et si la fichier est présent
mais pas la valeur, alors dpkg-source l'ajoutera automatiquement, en
conservant les valeurs précédentes.
- Testsuite-Triggers: liste-de-paquets
-
Ce champ indique l'union de toutes les dépendances de test, séparées par des
virgules (champs Depends du fichier debian/tests/control), toutes
restrictions supprimées, et les dépendances OR mises à plat (c'est-à-dire
convertie en relations AND distinctes), sauf pour les binaires générés par
ce paquet source et son équivalent de méta-dépendance @.
Raison : ce champ est nécessaire parce qu'autrement chaque paquet source
devrait être dépaqueté pour pouvoir obtenir les dépendances de test.
- Build-Depends: liste-de-paquets
-
Build-Depends-Arch:liste-de-paquets
Build-Depends-Indep: liste-de-paquets
Build-Conflicts: liste de paquets
Build-Conflicts-Arch: liste-de-paquets
Build-Conflicts-Indep: liste-de-paquets
Ces champs indiquent les relations entre le paquet source et les paquets
utilisés pour le construire. Ils sont détaillés dans la page de manuel
deb-src-control(5).
- Package-List:
-
paquet type-de-paquet section priorité liste-clés-valeurs
Ce champ à lignes multiples contient une liste des paquets binaires générés
par le paquet source.
Le paquet est le nom du paquet binaire.
Le type-de-paquet est le type du paquet binaire, habituellement deb ;
une autre valeur commune est udeb.
La section et la priorité correspondent aux champs du même nom du
paquet binaire.
La liste-clés-valeurs est une liste de clés=valeurs séparées par
des valeurs et les clés optionnelles actuellement reconnues sont :
-
- arch
-
Les restrictions d'architecture à partir du champ Architecture du paquet
binaire avec les espaces converties en « , ».
- profile
-
La formule normalisée de restrictions de profil de construction à partir du
champ Build-Profile du paquet binaire avec les OR convertis en « + » et
les « AND » en « , ».
- essential
-
Si le paquet binaire est essentiel, cette clé contiendra la valeur du champ
Essential, qui est la valeur yes.
- Files: (requis)
-
Checksums-Sha1: (requis)
Checksums-Sha256: (requis)
somme-de-contrôle taille nom-du-fichier
Ces champs à lignes multiples contiennent une liste de fichiers avec une
somme de contrôle et une taille pour chacun. Ces champs ont la même syntaxe
et diffèrent seulement par l'algorithme de somme de contrôle employé : MD5
pour Files, SHA-1 pour Checksums-Sha1 et SHA-256 pour
Checksums-Sha256.
La première ligne de la valeur du champ (la partie sur la même ligne que le
nom du champ suivi par deux-points) est toujours vide. Le contenu du champ
est exprimé sous la forme de lignes de continuation, un ligne par
fichier. Chaque ligne consiste en la somme de contrôle, une espace, la
taille du fichier, une espace et le nom du fichier.
Ces champs listent tous les fichiers qui composent le paquet source. La
liste de fichiers de ces champs doit correspondre à celle présente dans les
autres champs relatifs.