.\" dpkg manual page - deb-control(5) .\" .\" Copyright © 1995 Raul Miller, Ian Jackson, Ian Murdock .\" Copyright © 1999 Ben Collins .\" Copyright © 2000 Wichert Akkerman .\" Copyright © 2007-2011, 2013-2015 Guillem Jover .\" Copyright © 2008-2012 Rapha\(:el Hertzog .\" .\" This is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH deb\-control 5 2019-06-03 1.19.7 "suite dpkg" .nh .SH NOM deb\-control \- Format du fichier principal de contr\(^ole dans les paquets binaires Debian . .SH SYNOPSIS contr\(^ole . .SH DESCRIPTION Chaque paquet Debian poss\(`ede un fichier \fIcontrol\fP principal qui contient un certain nombre de champs. Chaque champ commence par une \('etiquette, telle que \fBPackage\fP ou \fBVersion\fP (la casse n'importe pas), suivie d'un \(Fo\ :\ \(Fc, et du contenu du champ. Les champs sont s\('epar\('es seulement par des \('etiquettes de champ. En d'autres termes, le contenu d'un champ peut s'\('etendre sur plusieurs lignes, mais les outils d'installation joindront en g\('en\('eral les lignes pendant le traitement du contenu du champ (sauf pour le champ \fBDescription\fP, voir ci\-dessous). . .SH "LES CHAMPS" .TP \fBPackage:\fP \fInom\-du\-paquet\fP (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. .TP \fBPackage\-Type:\fP \fBdeb\fP|\fBudeb\fP|\fItype\fP Ce champ indique le type de paquet. La valeur \fBudeb\fP est \(`a utiliser pour les paquets \(`a taille contr\(^ol\('ee utilis\('es par l'installateur Debian. La valeur \fBdeb\fP est la valeur par d\('efaut qui est utilis\('ee si le champ n'est pas pr\('esent. De nouveaux types pourraient \(^etre ajout\('es au fil du temps. .TP \fBVersion:\fP \fIcha\(^ine\-de\-la\-version\fP (requis) C'est classiquement le num\('ero de version du paquet d'origine dans la forme choisie par l'auteur du programme. Il peut y avoir aussi un num\('ero de r\('evision Debian (pour les paquets non natifs). Le format exact et l'algorithme de tri sont d\('ecrits dans \fBdeb\-version\fP(7). .TP \fBMaintainer:\fP \fInom\-complet\-et\-adresse\-\('electronique\fP (recommand\('e) Le format de ce champ sera \(Fo\ Jean Dupont \ \(Fc\ ; et c'est bien s\(^ur le cr\('eateur du paquet, par opposition \(`a l'auteur du programme mis en paquet. .TP \fBDescription:\fP \fIdescription\-courte\fP (recommand\('e) .TQ \fB \fP\fIdescription\-longue\fP .br Le format de la description du paquet est un r\('esum\('e bref sur la premi\(`ere ligne (apr\(`es le champ \fBDescription\fP). Les lignes suivantes peuvent servir \(`a une description plus longue et plus d\('etaill\('ee. Chaque ligne de cette description longue doit \(^etre pr\('ec\('ed\('ee d'une espace\ ; quand c'est une ligne blanche, elle doit contenir un seul \(Fo\ \fB.\fP\ \(Fc apr\(`es cette espace. .TP \fBSection:\fP \fIsection\fP Champ g\('en\('eral qui indique la cat\('egorie d'un paquet\ ; cette cat\('egorie est fond\('ee sur le programme que ce paquet installe. \fButils\fP, \fBnet\fP, \fBmail\fP, \fBtext\fP, \fBx11\fP,\ etc., repr\('esentent quelques cat\('egories habituelles. .TP \fBPriority:\fP\fI priorit\('e\fP D\('efinit l'importance du paquet \(`a l'int\('erieur du syst\(`eme g\('en\('eral. \fBrequired\fP, \fBstandard\fP, \fBoptional\fP, \fBextra\fP,\ etc., repr\('esentent des priorit\('es habituelles. .LP Les champs \fBSection\fP et \fBPriority\fP poss\(`edent un ensemble d\('efini de valeurs accept\('ees, tir\('e de la Charte particuli\(`ere de la distribution. . .TP \fBInstalled\-Size:\fP \fItaille\fP La taille approximative totale des fichiers install\('es du paquet, en Kio⋅ . .TP \fBEssential:\fP \fByes\fP|\fBno\fP On se sert habituellement de ce champ uniquement si la r\('eponse est \fByes\fP. Cela signifie que ce paquet est exig\('e pour un fonctionnement correct du syst\(`eme. Dpkg et les autres outils d'installation interdisent la suppression d'un paquet \fBEssential\fP (du moins tant qu'une des options de for\(,cage n'est pas utilis\('ee). .TP \fBBuild\-Essential:\fP \fByes\fP|\fBno\fP Ce champ est habituellement n\('ecessaire seulement si la r\('eponse est \fByes\fP, et il est g\('en\('eralement inject\('e par le logiciel d'archive. Il d\('esigne un paquet qui est requis lors de la construction d'autres paquets. .TP \fBArchitecture:\fP \fIarch\fP|\fBall\fP (recommand\('e) L'architecture pr\('ecise pour quel type de mat\('eriel le paquet a \('et\('e compil\('e. Voici quelques architectures habituelles\ : \fBamd64\fP, \fBarmel\fP, \fBi386\fP, \fBpowerpc\fP,\ etc. Remarquez que l'option \fBall\fP signifie que le paquet est ind\('ependant de toute architecture. C'est le cas, par exemple, des scripts d'interpr\('eteur de commandes (shell) ou Perl, ainsi que de la documentation. .TP \fBOrigin:\fP\fI nom\fP Nom de la distribution dont ce paquet provient. .TP \fBBugs:\fP\fI URL\fP L'\fIURL\fP du syst\(`eme de suivi de bogues (BTS) de ce paquet. Le format utilis\('e est \fItype_de_bts\fP\fB://\fP\fIadresse\-du\-bts\fP, par exemple \fBdebbugs://bugs.debian.org\fP. .TP \fBHomepage:\fP\fI URL\fP \fIURL\fP de la page d'accueil du projet amont. .TP \fBTag:\fP\fI liste\-d'\('etiquettes\fP Liste d'\('etiquettes d\('ecrivant les qualit\('es du paquet. La description et la liste des \('etiquettes (\(Fo\ tags\ \(Fc) g\('er\('ees peuvent \(^etre trouv\('ees dans le paquet \fBdebtags\fP. .TP \fBMulti\-Arch:\fP \fBno\fP|\fBsame\fP|\fBforeign\fP|\fBallowed\fP Ce champ est utilis\('e pour indiquer comment ce paquet se comportera sur les installations multi\-architectures. .RS .TP \fBno\fP C'est la valeur par d\('efaut quand le champ est omis\ ; dans ce cas, ajouter le champ avec une valeur \fBno\fP explicite est g\('en\('eralement inutile. .TP \fBsame\fP Ce paquet est co\-installable avec lui\-m\(^eme, mais il ne doit pas \(^etre utilis\('e pour satisfaire la d\('ependance d'un paquet d'une autre architecture que la sienne. .TP \fBforeign\fP Ce paquet n'est pas co\-installable avec lui\-m\(^eme, mais il pourra \(^etre autoris\('e pour permettre de satisfaire les d\('ependances sans qualification d'architecture d'un paquet d'une architecture diff\('erente de la sienne (si une d\('ependance a une qualification d'architecture explicite, alors la valeur \fBforeign\fP est ignor\('ee). .TP \fBallowed\fP Cela permet aux d\('ependances inverses d'indiquer dans leur champ \fBDepends\fPqu'elles acceptent ce paquet d'une autre architecture en qualifiant le nom du paquet avec \fB:any\fP, mais n'a pas d'autres effets. .RE .TP \fBSource:\fP \fInom\-du\-paquet\-source\fP [\fB(\fP\fIversion\-source\fP\fB)\fP] Le nom du paquet source d'o\(`u est issu ce paquet binaire, s'il est diff\('erent du nom du paquet lui\-m\(^eme. Si la version des sources diff\(`ere de la version du binaire, alors le \fInom\-du\-paquet\-source\fP sera suivi par la \fIversion\-source\fP entre parenth\(`eses. Cela peut arriver par exemple sur un envoi seulement binaire NMU (\(Fo\ non\-maintainer upload\ \(Fc), ou lorsqu'une version diff\('erente de binaire est fix\('ee avec \(Fo\ \fBdpkg\-gencontrol \-v\fP\ \(Fc. .TP \fBSubarchitecture:\fP\fI valeur\fP .TQ \fBKernel\-Version:\fP\fI valeur\fP .TQ \fBInstaller\-Menu\-Item:\fP\fI valeur\fP Ces champs sont utilis\('es par l'installateur et ne sont en g\('en\('eral pas n\('ecessaires. Veuillez consulter /usr/share/doc/debian\-installer/devel/modules.txt fourni avec le paquet \fBdebian\-installer\fP pour plus de d\('etails. .TP \fBDepends:\fP\fI liste\-de\-paquets\fP C'est la liste des paquets exig\('es pour que ce paquet procure un nombre important de fonctionnalit\('es. Le programme de maintenance des paquets interdit l'installation d'un paquet quand les paquets r\('epertori\('es dans le champ \fBDepends\fP ne sont pas install\('es (du moins tant qu'une option de for\(,cage n'est pas utilis\('ee). Lors d'une installation, il lance les scripts \(Fo\ postinst\ \(Fc des paquets r\('epertori\('es dans les champs \fBDepends\fP avant les scripts \(Fo\ postinst\ \(Fc des paquets qui d\('ependent d'eux. \(`A l'inverse, lors d'une suppression, le script \(Fo\ prerm\ \(Fc d'un paquet est lanc\('e avant ceux des paquets list\('es dans son champ \fBDepends\fP. .TP \fBPre\-Depends:\fP\fI liste\-de\-paquets\fP C'est la liste des paquets qui doivent \(^etre install\('es \fBet\fP configur\('es avant que ce paquet puisse \(^etre install\('e. Habituellement, on utilise ce champ quand un paquet a besoin d'un autre paquet pour lancer son script \(Fo\ preinst\ \(Fc. .TP \fBRecommends:\fP\fI liste\-de\-paquets\fP C'est la liste des paquets qu'on trouverait avec ce paquet dans toute installation standard. Le programme de maintenance des paquets avertit l'utilisateur quand il installe un paquet sans installer les paquets r\('epertori\('es dans le champ \fBRecommends\fP. .TP \fBSuggests:\fP\fI liste\-de\-paquets\fP C'est la liste des paquets qui, associ\('es avec ce paquet, peuvent am\('eliorer son utilit\('e\ ; n\('eanmoins, une installation sans ces paquets est parfaitement raisonnable. .LP La syntaxe des champs \fBDepends\fP, \fBPre\-Depends\fP, \fBRecommends\fP et \fBSuggests\fP est une liste d'ensembles de paquets alternatifs. Chaque ensemble est une liste de paquets s\('epar\('es par des barres verticales (le symbole du tube) \(Fo\ \fB|\fP\ \(Fc. Les ensembles sont s\('epar\('es par des virgules. Une virgule repr\('esente un \(Fo\ ET\ \(Fc logique et une barre verticale repr\('esente un \(Fo\ OU\ \(Fc logique\ ; le tube a la pr\('ec\('edence dans l'\('evaluation de l'expression. Chaque nom de paquet est suivi \('eventuellement par un type d'architecture apr\(`es deux\-points \(Fo\ \fB:\fP\ \(Fc, et par une contrainte sur le num\('ero de version mise entre parenth\(`eses. .LP Un nom de type d'architecture peut \(^etre un nom d'architecture r\('eelle de Debian (depuis dpkg\ 1.16.5) ou \fBany\fP (depuis dpkg\ 1.16.2). S'il est omis, la valeur par d\('efaut est l'architecture du paquet binaire actuel. Un nom d'architecture r\('eelle de Debian correspondra exactement \(`a l'architecture pour ce nom de paquet, \fBany\fP correspondra \(`a toute architecture pour ce nom de paquet si le paquet a \('et\('e marqu\('e \fBMulti\-Arch: allowed\fP. .LP Une contrainte sur le num\('ero de version peut commencer par \(Fo\ \fB>>\fP\ \(Fc, et dans ce cas toute version sup\('erieure correspondra, et il peut indiquer (ou pas) le num\('ero de r\('evision pour le paquet Debian (les deux num\('eros \('etant s\('epar\('es par un trait d'union). Voici les relations accept\('ees pour les versions\ : \(Fo\ \fB>>\fP\ \(Fc pour sup\('erieur \(`a, \(Fo\ \fB<<\fP\ \(Fc pour inf\('erieur \(`a, \(Fo\ \fB>=\fP\ \(Fc pour sup\('erieur ou \('egal, \(Fo\ \fB<=\fP\ \(Fc pour inf\('erieur ou \('egal, et \(Fo\ \fB=\fP\ \(Fc pour \('egal \(`a. .TP \fBBreaks:\fP\fI liste\-de\-paquets\fP C'est une liste de paquets que ce paquet \(Fo\ casse\ \(Fc, par exemple en r\('ev\('elant des bogues quand les paquets concern\('es d\('ependent de celui\-ci. Le programme de maintenance des paquets interdit la configuration de paquets cass\('es\ ; une m\('ethode usuelle de r\('esolution est la mise \(`a niveau des paquets mentionn\('es dans le champ \fBBreaks\fP. .TP \fBConflicts:\fP\fI liste\-de\-paquets\fP C'est une liste de paquets qui sont en conflit avec ce paquet\ ; ils contiennent par exemple des fichiers qui ont le m\(^eme nom. Le programme de maintenance des paquets interdit l'installation simultan\('ee de paquets en conflit. Deux paquets en conflit renseigneront une ligne \fBConflicts\fP avec le nom de l'autre paquet. .TP \fBReplaces:\fP\fI liste\-de\-paquets\fP C'est une liste de paquets que ce paquet remplace. Il peut ainsi remplacer les fichiers de ces autres paquets\ ; on se sert pour cela du champ \fBConflicts\fP pour forcer la suppression des autres paquets, si celui\-l\(`a poss\(`ede aussi les m\(^emes fichiers que le paquet en conflit. .LP La syntaxe des champs \fBBreaks\fP, \fBConflicts\fP et \fBReplaces\fP est une liste de noms de paquets, s\('epar\('es par des virgules (et des espaces facultatives). Dans les champs \fBBreaks\fP et \fBConflicts\fP, la virgule sera lue comme un \(Fo\ OU\ \(Fc. Un type d'architecture optionnel peut \(^etre aussi ajout\('e au nom de paquet avec la m\(^eme syntaxe que ci\-dessus, mais par d\('efaut la valeur est \fBany\fP plut\(^ot que l'architecture du paquet binaire. On peut donner une version optionnelle de la m\(^eme fa\(,con que ci\-dessus dans les champs \fBBreaks\fP, \fBConflicts\fP et \fBReplaces\fP. . .TP \fBEnhances:\fP\fI liste\-de\-paquets\fP C'est une liste de paquets que ce paquet am\('eliore. C'est similaire \(`a \fBSuggests\fP mais en sens inverse. .TP \fBProvides:\fP\fI liste\-de\-paquets\fP C'est une liste de paquets virtuels que ce paquet procure. On s'en sert habituellement pour des paquets qui offrent le m\(^eme service. Par exemple, sendmail et exim sont des serveurs de courrier, et donc ils procurent chacun un paquet commun (\(Fo\ mail\-transport\-agent\ \(Fc) duquel d'autres paquets peuvent d\('ependre. Sendmail et exim peuvent ainsi servir d'option valable pour satisfaire la d\('ependance. Cela permet aux paquets qui d\('ependent d'un serveur de courrier de ne pas avoir \(`a conna\(^itre les noms de paquet de tous les serveurs de courrier, en utilisant \(Fo\ \fB|\fP\ \(Fc comme s\('eparateur de liste. .LP La syntaxe du champ \fBProvides\fP est une liste de noms de paquets, s\('epar\('es par des virgules (et des espaces facultatives). Un type d'architecture facultatif peut \('egalement \(^etre ajout\('e au nom de paquet de la m\(^eme fa\(,con que ci\-dessus. S'il est omis l'architecture par d\('efaut est celle du paquet binaire actuel. Un num\('ero de version pr\('ecis (\('egal \(`a) optionnel peut \(^etre donn\('e de la m\(^eme fa\(,con que ci\-dessus (pris en compte depuis dpkg\ 1.17.11). . .TP \fBBuilt\-Using:\fP\fI liste\-de\-paquets\fP Ce champ affiche les paquets source suppl\('ementaires utilis\('es lors de la construction du paquet binaire. Il permet d'indiquer au logiciel de gestion de l'archive que des paquets source suppl\('ementaires doivent \(^etre conserv\('es tant que le paquet binaire est maintenu. Ce champ doit \(^etre une liste de paquets source avec des r\('ef\('erences strictes de version \(Fo\ \fB=\fP\ \(Fc. Veuillez noter que le logiciel de gestion de l'archive risque de ne pas accepter un envoi qui d\('eclare une relation \fBBuilt\-Using\fP qui ne peut pas \(^etre satisfaite dans l'archive. . .TP \fBBuilt\-For\-Profiles:\fP\fI liste\-de\-profils\fP (obsol\(`ete) Ce champ sert \(`a sp\('ecifier une liste, s\('epar\('ee par des espaces, de profils de construction avec lesquels ce paquet binaire a \('et\('e construit (depuis dpkg\ 1.17.2 et jusqu'\(`a la version\ 1.18.18). Les informations pr\('ec\('edemment trouv\('ees dans ce champ sont maintenant dans le champ \fB.buildinfo\fP qui l'a remplac\('e. . .TP \fBAuto\-Built\-Package:\fP\fI liste\-de\-raisons\fP Ce champ d\('efinit une liste, s\('epar\('ee par des espaces, des raisons pour lesquelles ce paquet a \('et\('e g\('en\('er\('e automatiquement. Les paquets binaires marqu\('es avec ce champ n'appara\(^itront pas dans le fichier principal de contr\(^ole des sources \fIdebian/control\fP. \fBdebug\-symbols\fP est la seule raison utilis\('ee actuellement. . .TP \fBBuild\-Ids:\fP\fI liste\-identifiants\-de\-construction\-elf\fP Ce champ d\('efinit une liste, s\('epar\('ee par des espaces, des identifiants de construction ELF. Il s'agit des identifiants uniques d'objets ELF s\('emantiquement identiques, pour chacun de ces objets pr\('esents dans le paquet. . Le format ou la mani\(`ere de calculer chaque identifiant de construction n'est pas d\('efini par nature. . .SH EXEMPLE .\" .RS .nf Package: grep Essential: yes Priority: required Section: base Maintainer: Wichert Akkerman Architecture: sparc Version: 2.4\-1 Pre\-Depends: libc6 (>= 2.0.105) Provides: rgrep Conflicts: rgrep Description: GNU grep, egrep and fgrep. Il se peut que le grep de la famille GNU des utilitaires grep soit le plus rapide de l'ouest\ ! Le grep de GNU est fond\('e sur un m\('ecanisme rapide de mise en correspondance d\('eterministe d'\('etats simples (environ deux fois plus rapide que le \(Fo\ egrep\ \(Fc standard d'Unix), modifi\('e par une recherche de type Boyer\-Moore\-Gosper qui cherche une cha\(^ine donn\('ee en emp\(^echant que les textes impossibles soient analys\('es par le m\('ecanisme de mise en correspondance d'expressions rationnelles et sans avoir n\('ecessairement besoin de voir chaque caract\(`ere. C'est beaucoup plus rapide que les \(Fo\ grep\ \(Fc ou \(Fo\ egrep\ \(Fc d'Unix. (Des expressions rationnelles contenant des r\('ef\('erences circulaires ralentissent cependant le programme.) .fi .\" .RE . .SH BOGUES Le champ \fBBuild\-Ids\fP utilise un nom plut\(^ot g\('en\('erique \(`a partir de son contexte original dans l'objet ELF qui sert un objectif tr\(`es sp\('ecifique et a un format ex\('ecutable. . .SH "VOIR AUSSI" \fBdeb\-src\-control\fP(5), \fBdeb\fP(5), \fBdeb\-version\fP(7), \fBdebtags\fP(1), \fBdpkg\fP(1), \fBdpkg\-deb\fP(1). .SH TRADUCTION Ariel VARDI , 2002. Philippe Batailler, 2006. Nicolas Fran\(,cois, 2006. Veuillez signaler toute erreur \(`a .