summaryrefslogtreecommitdiffstats
path: root/man/fr/deb-buildinfo.pod
blob: e45f9fa89c36cc44a9b93d5a054b91f203dd2610 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOM

deb-buildinfo - Format des fichiers d'information de construction de Debian

=head1 SYNOPSIS

I<nom-du-fichier>B<.buildinfo>

=head1 DESCRIPTION

Each Debian source package build can record the build information in a
B<.buildinfo> control file, which contains a number of fields in
L<deb822(5)> format.

Each field begins with a tag, such as B<Source> or B<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 B<Binary-Only-Changes>,
B<Installed-Build-Depends>, B<Environment>, B<Checksums-Md5>,
B<Checksums-Sha1> and B<Checksums-Sha256>, see below).

Les données de contrôle pourraient être incluses dans une signature OpenPGP
S<« ASCII> S<Armored »,> comme spécifié dans RFC4880.

Le nom du fichier B<.buildinfo> dépendra du type de construction et sera
aussi spécifique que nécessaire mais pas S<plus ;> lorsque la construction
inclut B<any>, le nom sera
I<nom-source>B<_>I<version-binaire>B<_>I<arch>B<.buildinfo>, ou sinon pour
une construction B<all> le nom sera
I<nom-source>B<_>I<binary-version>B<_>B<all.buildinfo> ou encore pour une
construction qui inclut B<source> le nom sera
I<nom-source>B<_>I<version-source>B<_>B<source.buildinfo>.

=head1 LES CHAMPS

=over 

=item B<Format:> I<version-format> (requis)

La valeur de ce champ déclare la version du format du fichier. La syntaxe de
la valeur du champ est un numéro de version avec un composant majeur et
mineur. Les modifications incompatibles avec les versions précédentes du
format incrémenteront la version majeure, tandis que les modifications
compatibles (telles que les ajouts de champ) incrémenteront la version
mineure. La version de format actuelle est B<1.0>.

=item B<Source:> I<nom-source> [B<(>I<version-source>B<)>] (requis)

Le nom du paquet source. Si la version du source diffère de la version
binaire, alors le I<nom-source> sera suivi par une I<version-source> entre
parenthèses. Cela peut arriver quand la construction concerne un envoi
seulement binaire NMU S<(« non-maintainer> S<upload »).>

=item B<Binary:> I<liste-paquets-binaires> (requis selon le contexte)

This folded field is a space-separated list of binary packages built.  If
the build is source-only, then the field is omitted (since dpkg 1.20.0).

=item B<Architecture:> I<liste-architectures> (requis)

Ce champ, séparé par des espaces, liste les architectures des fichiers
actuellement en construction. Voici quelques architectures S<habituelles :>
B<amd64>, B<armel>, S<B<i386>, etc.> Remarquez que l'option B<all> signifie que
le paquet est indépendant de toute architecture. Si le source du paquet est
aussi en construction, l'entrée spéciale B<source> est aussi présente. Les
architectures joker ne doivent jamais être présentes dans la liste.

=item B<Version:> I<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 B<deb-version>(7).

=item B<Binary-Only-Changes:>

=item S< >I<changelog-entry>

Ce champ à lignes multiples contient le texte concaténé des entrées de
changelog pour un envoi seulement binaire (binNMU), si c'est le cas. Pour
faire de ce champ un champ à lignes multiples valable, les lignes vides sont
remplacées par un point S<« B<.> »> et toutes les lignes sont indentées par une
seule espace. Le contenu exact dépend du format du changelog.

=item B<Checksums-Md5:> (requis)

=item B<Checksums-Sha1:> (requis)

=item B<Checksums-Sha256:> (requis)

=item S< >I<checksum> I<size> I<filename>

Ces champs à lignes multiples contiennent la liste des fichiers avec la
somme de contrôle et la taille de chacun. Ces champs ont la même syntaxe et
ne diffèrent que par l'algorithme de somme de contrôle S<utilisé :> MD5 pour
B<Checksums-Md5>, SHA-1 pour B<Checksums-Sha1> et SHA-256 pour
B<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é par des lignes de continuation, une ligne par fichier. Chaque
ligne consiste en des entrées séparées par des espaces décrivant le
S<fichier :la> somme de contrôle, la taille du fichier et le nom du fichier.

Ces champs listent tous les fichiers qui composent la construction.

=item B<Build-Origin:> I<nom>

Nom de la distribution dont ce paquet provient.

=item B<Build-Architecture:> I<arch> (requis)

L'architecture Debian pour l'installation des paquets en construction. Les
architectures habituelles sont B<amd64>, B<armel>, S<B<i386>, etc.>

=item B<Build-Date:> I<date-construction>

La date à laquelle le paquet a été construit. Elle peut être au même format
que la date dans les entrées dans B<deb-changelog>(5).

=item B<Build-Kernel-Version:> I<version-du-noyau-de-construction>

La publication et la version (dans un format non spécifié) du noyau exécuté
dans le système de construction. Ce champ va seulement être présent si le
constructeur l'a demandé explicitement, pour éviter de révéler des
informations potentiellement sensibles.

=item B<Build-Path:> I<chemin-de-construction>

The absolute build path, which correspond to the unpacked source tree.  This
field is only going to be present if the vendor has allowed it via some
pattern match to avoid leaking possibly sensitive information.

Dans Debian et ses dérivés, seuls les chemins de construction débutant par
I</build/> émettront ce champ.

=item B<Build-Tainted-By:>

=item S< >I<taint-reason-list>

Ce champ coupé est une liste, séparée par des espaces, non exhaustive des
étiquettes de raison (formées de caractères alphanumériques et de tirets)
qui définissent pourquoi la construction actuelle a été souillée (depuis
S<dpkg 1.19.5).>

Dans Debian et ses dérivées, les étiquettes de raisons suivantes peuvent
être émises.

=over 

=item B<merged-usr-via-aliased-dirs>

The system has a merged I</usr> via aliased directories (previously known as
B<merged-usr-via-symlinks>).  This will confuse B<dpkg-query>,
B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> and any other
tool using pathnames as keys into their databases, as it creates filesystem
aliasing problems, and messes with the understanding of the filesystem that
B<dpkg> has recorded in its database.  For build systems that hardcode
pathnames to specific binaries or libraries on the resulting artifacts, it
can also produce packages that will be incompatible with non-/usr-merged
filesystems.

=item B<usr-local-has-configs>

Le système a des fichiers de configuration dans I</usr/local/etc>.

=item B<usr-local-has-includes>

Le système a des fichiers d'en-tête dans I</usr/local/include>.

=item B<usr-local-has-programs>

Le système a des programmes dans I</usr/local/bin> ou I</usr/local/sbin>.

=item B<usr-local-has-libraries>

Le système a des bibliothèques statiques ou partagées dans
I</usr/local/lib>.

=back

=item B<Installed-Build-Depends:> (requis)

=item S< >I<package-list>

La liste des paquets installés et configurés que pourrait affecter le
processus de construction du paquet.

La liste contient le nom de chaque paquet, éventuellement avec une
qualification d'architecture pour celles différentes, avec une restriction
de version précise, séparés par des virgules.

La liste inclut tous les paquets essentiels, les paquets listés dans les
champs de contrôle des sources B<Build-Depends>, B<Build-Depends-Arch>,
B<Build-Depends-Indep>, chaque dépendance interne spécifique au
distributeur, et toutes leurs dépendances récursives. Dans Debian et ses
dérivés, une dépendance interne est B<build-essential>.

Pour les dépendances provenant des champs de contrôle des sources, toutes
les alternatives de dépendance et tous les fournisseurs de paquets virtuels
dépendants seront inclus.

=item B<Environment:>

=item S< >I<variable-list>

La liste des variables d'environnement qui sont connues pour affecter le
processus de construction du paquet. Chaque variable d'environnement est
suivie d'un signe égal S<(« = »)> et de la valeur de la variable protégée avec
des guillemets doubles S<(« " »)> et des barres obliques inverses S<(« \\ »).>

=back

=head1 VOIR AUSSI

L<deb822(5)>, B<deb-changes>(5), B<deb-version>(7), B<dpkg-genbuildinfo>(1).


=head1 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>.