Provided by: dpkg-dev_1.21.1ubuntu2.3_all 
NOM
dsc - Format du fichier de contrôle dans les paquets source Debian
SYNOPSIS
nom-du-fichier.dsc
DESCRIPTION
Each Debian source package is composed of a .dsc control file, which contains a number of fields, in
deb822(5) format.
Each field begins with a tag, such as Source or Binary (case insensitive), followed by a colon, and the
body of the field (case sensitive unless stated otherwise). Fields are delimited only by field tags. In
other words, field text may be multiple lines in length, but the installation tools will generally join
lines when processing the body of the field (except in case of the multiline fields Package-List, Files,
Checksums-Sha1 and Checksums-Sha256, see below).
Les données de contrôle pourraient être incluses dans une signature OpenPGP « ASCII Armored », comme
spécifié dans RFC4880.
LES CHAMPS
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 le 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 converties 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:
package package-type section priority key-value-list
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 espaces 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 « , ».
protected
If the binary package is protected, this key will contain the value of the Protected field, that
is a yes value.
Supported since dpkg 1.20.1.
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)
checksum size filename
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 un
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.
BOGUES
Le champ Format combine le format pour le fichier .dsc lui-même et le format du paquet source extrait.
VOIR AUSSI
deb822(5), deb-src-control(5), deb-version(7), dpkg-source(1).
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez
signaler toute erreur à <debian-l10n-french@lists.debian.org>.
1.21.1 2024-02-23 dsc(5)