NOM
deb-control - Format du fichier principal de contrle dans les paquets
Debian
SYNOPSIS
contrle
Chaque paquet Debian possde un fichier principal de contrle qui
contient un certain nombre de champs ou de commentaires pour les lignes
commenant par un caractre # . Chaque champ commence par une tiquette,
telle que Package ou Version (la casse n'importe pas), suivie d'un : ,
et du contenu du champ. Les champs sont spars seulement par des
tiquettes de champ. En d'autres termes, le contenu d'un champ peut
s'tendre sur plusieurs lignes, mais les outils d'installation joindront
en gnral les lignes pendant le traitement du contenu du champ (sauf
pour le champ Description, voyez ci-dessous).
LES CHAMPS EXIGS
Package: <nom du paquet>
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.
Version: <chane pour la version>
C'est classiquement le numro de version du paquet d'origine dans
la forme choisie par l'auteur du programme. Il peut y avoir
aussi un numro de rvision Debian (pour les paquets non natifs).
Le format exact et l'algorithme de tri sont dcrits dans
deb-version(5).
Maintainer: <nom adresse>
Le format de ce champ sera Jean Dupont <jdupont@foo.com> ; et
c'est bien sr le crateur du paquet, par opposition l'auteur du
programme mis en paquet.
Description: <description courte>
<description longue>
Le format de la description du paquet est un rsum bref sur la
premire ligne (aprs le champ Description ). Les lignes
suivantes peuvent servir
une description plus longue et plus dtaille. Chaque ligne de
cette description longue doit tre prcde d'une espace ; quand
c'est une ligne blanche, elle doit contenir un seul . aprs cet
espace.
CHAMPS OPTIONNELS
Section: <section>
C'est un champ gnral qui indique la catgorie d'un paquet ; cette
catgorie est fonde sur le programme que ce paquet installe.
Utils , net , mail , text , x11 , etc. reprsentent quelques
catgories habituelles.
Priority: <priorit>
Dfinit l'importance du paquet l'intrieur du systme gnral.
Required , standard , optional , extra , etc. reprsentent
des priorits habituelles.
Les champs Section et Priority possdent un ensemble dfini de valeurs
acceptes, tir de la Charte Debian ( Debian Policy ). On peut en trouver
une liste dans la version la plus rcente du paquet debian-policy.
Essential: <yes|no>
On se sert habituellement de ce champ uniquement si la rponse
est yes . Il signifie que ce paquet est exig pour un
fonctionnement correct du systme. Dpkg et les autres outils
d'installation interdisent la suppression d'un paquet Essential
(du moins tant qu'une des options de forage n'est pas utilise).
Architecture: <arch|all>
L'architecture prcise pour quel type de matriel le paquet a t
compil. Voici quelques architectures habituelles : i386 ,
m68k , sparc , alpha , powerpc , etc. Remarquez que l'option
all signifie que le paquet est indpendant de toute architecture.
Les scripts shell ou Perl, ainsi que la documentation sont dans
ce cas.
Origin: <nom>
Nom de la distribution dont ce paquet provient.
Bugs: <URL>
URL du systme de suivi de bogues (BTS) de ce paquet. Le format
utilis est <type_de_bts>://<adresse_du_bts>, par exemple
debbugs://bugs.debian.org.
Homepage: <URL>
URL de la page d'accueil du projet amont.
Tag: <liste d'tiquettes>
Liste d'tiquettes dcrivant les qualits du paquet. La description
et la liste des tiquettes ( tags ) gres peut tre trouve dans le
paquet debtags.
Source: <nom du source>
Le nom du paquet source d'o provient le paquet binaire, s'il y a
une diffrence entre les deux noms.
Depends: <liste de paquet>
C'est la liste des paquets exigs pour que ce paquet arrive
fonctionner de manire non triviale. Le programme de maintenance
des paquets interdit l'installation d'un paquet quand les
paquets rpertoris dans le champ Depends ne sont pas installs (du
moins tant qu'une option de forage n'est pas utilise) ; il lance
les scripts postinst des paquets rpertoris dans les champs
Depends: avant les scripts postinst des paquets qui dpendent
d'eux. l'inverse, lors d'une suppression les scripts prerm
des paquets sont lancs avant ceux de leurs dpendances.
Pre-Depends: <liste de paquet>
C'est la liste des paquets qui doivent tre installs et configurs
avant que ce paquet puisse tre install. Habituellement, on
utilise ce champ quand un paquet a besoin d'un autre paquet pour
lancer son script preinst .
Recommends: <liste de paquet>
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 rpertoris dans le champ Recommends.
Suggests: <liste de paquet>
C'est la liste des paquets qui, associs avec ce paquet, peuvent
amliorer son utilit ; nanmoins, une installation sans ces
paquets est parfaitement raisonnable.
La syntaxe des champs Depends, Pre-Depends, Recommends, et Suggests est
une liste de groupes contenant des paquets successifs. Chaque groupe
est une liste de paquets spars par une barre verticale (le symbole du
tube) | . Les groupes sont spars par des virgules. Une virgule
reprsente un ET logique et une barre verticale reprsente un OU
logique ; le tube reprsente un lien plus fort. Chaque lment est le nom
d'un paquet suivi de faon optionnelle par un numro de version entre
parenthses.
Un numro de version peut commencer par >> , et dans ce cas toute
version suprieure correspondra, et il peut indiquer (ou pas) le numro
de rvision pour le paquet debian (les deux numros tant spars par un
trait d'union). Voici les relations acceptes pour les versions : >>
pour suprieur , << pour infrieur , >= pour suprieur ou gal, <=
pour infrieur ou gal, et = pour gal .
Breaks: <liste de paquets>
C'est une liste de paquets que ce paquet casse , par exemple en
rvlant des bogues quand les paquets concerns dpendent de
celui-ci. Le programme de maintenance des paquets interdit la
configuration de paquets casss ; une mthode usuelle de rsolution
est la mise jour des paquets mentionns dans le champ Breaks.
Conflicts: <liste de paquets>
C'est une liste de paquets qui sont en conflit avec ce paquet ;
ils contiennent par exemple des fichiers qui ont le mme nom. Le
programme de maintenance des paquets interdit l'installation
simultane de paquets en conflit. Deux paquets en conflit
renseigneront une ligne Conflicts avec le nom de l'autre paquet.
Replaces: <liste de paquets>
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 Conflicts pour forcer la suppression des autres
paquets, si celui-l possde aussi les mmes fichiers que le paquet
en conflit.
Provides: <liste de paquets>
C'est une liste de paquets virtuels que ce paquet remplit . On
s'en sert habituellement pour des paquets qui offrent le mme
service. Par exemple, sendmail et exim sont des serveurs de
courrier, et donc ils remplissent chacun le paquet
mail-transport-agent ; ainsi les autres paquets peuvent
dpendre de ce paquet virtuel. Sendmail et exim peuvent ainsi
chacun satisfaire la dpendance. Les paquets qui dpendent d'un
serveur de courrier n'ont pas connatre les noms de tous les
serveurs de courrier et n'ont pas
utiliser | comme sparateur de liste.
The syntax of Breaks, Conflicts, Replaces and Provides is a list of
package names, separated by commas (and optional whitespace). In the
Breaks and Conflicts fields, the comma should be read as `OR'. An
optional version can also be given with the same syntax as above for
the Breaks, Conflicts and Replaces fields.
EXEMPLE
# Commentaire
Package: grep
Essential: yes
Priority: required
Section: base
Maintainer: Wichert Akkerman <wakkerma@debian.org>
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 sur un mcanisme
rapide de mise en correspondance dterministe d'tats simples (environ
deux fois plus rapide que le egrep standard d'Unix), modifi par une
recherche de type Boyer-Moore-Gosper qui cherche une chane donne en
empchant que les textes impossibles soient analyss par le mcanisme de
mise en correspondance d'expressions rgulires et sans avoir
ncessairement besoin de voir chaque caractre. C'est beaucoup plus
rapide que les grep ou egrep d'Unix.
(Des expressions rgulires contenant des rfrences circulaires
ralentissent cependant le programme.)
VOIR AUSSI
deb(5), deb-version(5), debtags(1), dpkg(1), dpkg-deb(1).
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006.
Nicolas Franois, 2006. Veuillez signaler toute erreur
<debian-l10n-french@lists.debian.org>.