summaryrefslogtreecommitdiffstats
path: root/man/fr/dpkg-architecture.pod
blob: f82c9970289bbe95597661895ef2b5d3a900a281 (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
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
        *****************************************************
        *           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

dpkg-architecture - Fixer et déterminer l'architecture pour la construction d'un paquet

=head1 SYNOPSIS

B<dpkg-architecture> [I<option>...] [I<commande>]

=head1 DESCRIPTION

B<dpkg-architecture> aide à déterminer et à fixer l'architecture de construction et l'architecture hôte pour la création d'un paquet.

The build architecture is always determined by either the B<DEB_BUILD_ARCH> variable if set (and B<--force> not being specified) or by an external call to L<dpkg(1)>, and cannot be set at the command line.

You can specify the host architecture by providing one or both of the options B<--host-arch> and B<--host-type>, otherwise the B<DEB_HOST_ARCH> variable is used if set (and B<--force> not being specified).  The default is determined by an external call to L<gcc(1)>, or the same as the build architecture if B<CC> or gcc are both not available.  One out of B<--host-arch> and B<--host-type> is sufficient, the value of the other will be set to a usable default.  Indeed, it is often better to only specify one, because B<dpkg-architecture> will warn you if your choice does not match the default.

=head1 COMMANDES

=over 

=item B<-l>, B<--list>

Afficher les variables d'environnement, une par ligne, en utilisant le format I<VARIABLE=valeur>. C'est l'action par défaut.

=item B<-e>, B<--equal> I<architecture>

Vérifier l'égalité d'architectures (depuis S<dpkg 1.13.13).> Cela compare l'architecture Debian en cours (ou celle spécifiée) à I<architecture> afin de vérifier leur égalité. Cette action ne gère pas les architectures joker. La commande quitte avec un code de retour de B<0> si l'architecture correspond et de B<1> dans le cas contraire.

=item B<-i>, B<--is> I<architecture-joker>

Vérifier l'identité des architectures (depuis S<dpkg 1.13.13).> Cela compare l'architecture Debian en cours (ou celle spécifiée) à I<architecture-joker> (après expansion de celle-ci) afin de vérifier leur correspondance. La commande quitte avec un code de retour de B<0> si l'architecture correspond et de B<1> dans le cas contraire.

=item B<-q>, B<--query> I<nom-de-variable>

Afficher la valeur d'une seule variable.

=item B<-s>, B<--print-set>

Produire une commande d'exportation, qui peut être utilisée pour positionner les variables d'environnement utilisant le B<shell> POSIX ou S<« make> S<B<eval> »,> selon le format de sortie.

=item B<-u>, B<--print-unset>

Afficher une commande similaire à celle produite par B<--print-set>, mais pour supprimer toutes les variables.

=item B<-c>, B<--command> I<chaîne-de-commande>

Exécuter une I<chaîne-de-commande> dans un environnement où toutes les variables sont positionnées aux valeurs spécifiées.

If the I<command-string> contains shell metacharacters, then it will be invoked through the system bourne shell.

=item B<-L>, B<--list-known>

Afficher une liste des architectures valables. Elle peut être restreinte par une ou plusieurs des options correspondantes B<--match-wildcard>, B<--match-bits> ou B<--match-endian> (depuis S<dpkg 1.17.14).>

=item B<-?>, B<--help>

Afficher un message d'aide puis quitter.

=item B<--version>

Afficher le numéro de version puis quitter.

=back

=head1 OPTIONS

=over 

=item B<-a>, B<--host-arch> I<architecture>

Définir l'architecture Debian en cours.

=item B<-t>, B<--host-type> I<type-de-système-gnu>

Définir le type de système GNU en cours.

=item B<-A>, B<--target-arch> I<architecture>

Définir l'architecture Debian de la cible (depuis S<dpkg 1.17.14).>

=item B<-T>, B<--target-type> I<type-de-système-gnu>

Définir le type de système GNU de la cible (depuis S<dpkg 1.17.14).>

=item B<-W>, B<--match-wildcard> I<architecture-joker>

Restreindre les architectures listées par B<--list-known> à celles correspondant à l'architecture-joker (depuis S<dpkg 1.17.14).>

=item B<-B>, B<--match-bits> I<bits-de-l'architecture>

Restreindre les architectures listées par B<--list-known> à celles employant un CPU disposant du nombre de bits indiqués (depuis S<dpkg 1.17.14).> Soit B<32>, soit B<64>.

=item B<-E>, B<--match-endian> I<boutisme-d'architecture>

Restreindre les architectures listées par B<--list-known> à celles correspondant au boutisme spécifié (depuis S<dpkg 1.17.14).> Soit B<little>, soit B<big>.

=item B<--print-format> I<format>

Configurer le format de sortie de B<--print-set> et B<--print-unset> (depuis S<dpkg 1.20.6),> pour B<shell> (par défaut) ou B<make>.

=item B<-f>, B<--force>

Values set by existing environment variables with the same name as used by the scripts are honored (i.e. used by B<dpkg-architecture>), except if this force flag is present.  This allows the user to override a value even when the call to B<dpkg-architecture> is buried in some other script (for example L<dpkg-buildpackage(1)>).

=back

=head1 TERMINOLOGIE

=over 

=item Machine de construction

Machine sur laquelle le paquet est construit.

=item Machine hôte

Machine pour laquelle le paquet est construit.

=item Machine cible

La machine pour laquelle le compilateur construit ou pour laquelle l'émulateur exécutera le code. Cela est nécessaire uniquement lors de la construction d'une chaîne d'outils de compilation croisée qui sera construite sur l'architecture de construction, pour être exécutée sur l'architecture hôte, afin de construire du code (ou d'exécuter du code émulé) pour l'architecture cible.

=item Architecture Debian

Chaîne de caractères de l'architecture Debian qui spécifie l'emplacement dans l'archive FTP. Par S<exemple :> i386, sparc, hurd-i386.

=item N-uplet d'architecture Debian

Un n-uplet d'architecture Debian est l'architecture pleinement qualifiée avec tous ses composants énoncés. C'est différent des architectures Debian en ce que le composant I<processeur> n'intègre pas l'I<ABI>. Le n-uplet actuel a la forme I<ABI>-I<libc>-I<os>-I<processeur>. S<Exemples :> base-gnu-linux-amd64, eabihf-musl-linux-arm.

=item Architecture Debian joker

Une architecture Debian joker est une architecture spéciale qui correspond à toutes les architectures réelles qui en font partie. Il est en général de la forme d'un n-uplet d'architecture Debian avec quatre éléments ou moins dont au moins l'un d'eux est B<any>. Les éléments manquants du n-uplet sont préfixés implicitement par B<any>, et donc les paires suivantes sont équivalentes.

=over 

=item B<any>-B<any>-B<any>-B<any> = B<any>

=item B<any>-B<any>-I<os>-B<any> = I<os>-B<any>

=item B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>

=back

S<Exemples :> linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any.

=item Type de système GNU

Chaîne de caractères définissant l'architecture et constituée de deux parties séparées par un S<tiret :> processeur et système. Par S<exemple :> i586-linux-gnu, sparc-linux-gnu, i386-gnu, x86_64-netbsd.

=item n-uplet multiarchitecture

Type en clair de système GNU, utilisé pour les chemins du système de fichiers. Ce n-uplet ne change pas même quand l'ISA de base est incrémentée, de sorte que les chemins résultants sont stables dans la durée. La seule différence actuelle avec le type du système GNU est que la partie processeur pour les systèmes basés sur l'i386 est toujours i386. S<Exemples :> i386-linux-gnu, x86_64-linux-gnu. Exemple de S<chemins :> /lib/powerpc64le-linux-gnu/, /usr/lib/i386-kfreebsd-gnu/.

=back

=head1 VARIABLES D'ENVIRONNEMENT

Les variables suivantes sont lues à partir de l'environnement (à moins que B<--force> n'ait été spécifié) et sont positionnées par B<dpkg-architecture> (voir la section B<TERMS> pour une description du schéma de S<nommage) :>

=over 

=item B<DEB_BUILD_ARCH>

Architecture Debian de la machine de construction.

=item B<DEB_BUILD_ARCH_ABI>

Nom de l'ABI Debian de la machine de construction (depuis S<dpkg 1.18.11).>

=item B<DEB_BUILD_ARCH_LIBC>

Nom de la libc Debian de la machine de construction (depuis S<dpkg 1.18.11).>

=item B<DEB_BUILD_ARCH_OS>

Nom du système Debian de la machine de construction (depuis S<dpkg 1.13.2).>

=item B<DEB_BUILD_ARCH_CPU>

Nom de processeur Debian de la machine de construction (depuis S<dpkg 1.13.2).>

=item B<DEB_BUILD_ARCH_BITS>

Taille de pointeur de la machine de construction (en bits, depuis S<dpkg 1.15.4).>

=item B<DEB_BUILD_ARCH_ENDIAN>

Boutisme de la machine de construction (petit ou gros, depuis S<dpkg 1.15.4).>

=item B<DEB_BUILD_GNU_CPU>

Partie CPU GNU de B<DEB_BUILD_GNU_TYPE>.

=item B<DEB_BUILD_GNU_SYSTEM>

Partie système GNU de B<DEB_BUILD_GNU_TYPE>.

=item B<DEB_BUILD_GNU_TYPE>

Type de système GNU de la machine de construction.

=item B<DEB_BUILD_MULTIARCH>

Le type en clair de système GNU de la machine de construction, utilisé pour les chemins du système de fichiers (depuis S<dpkg 1.16.0).>

=item B<DEB_HOST_ARCH>

Architecture Debian de la machine hôte.

=item B<DEB_HOST_ARCH_ABI>

Nom de l'ABI Debian de la machine hôte (depuis S<dpkg 1.18.11).>

=item B<DEB_HOST_ARCH_LIBC>

Nom de la libc Debian de la machine hôte (depuis S<dpkg 1.18.11).>

=item B<DEB_HOST_ARCH_OS>

Nom du système Debian de la machine hôte (depuis S<dpkg 1.13.2).>

=item B<DEB_HOST_ARCH_CPU>

Nom du processeur Debian de la machine hôte (depuis S<dpkg 1.13.2).>

=item B<DEB_HOST_ARCH_BITS>

Taille de pointeur de la machine hôte (en bits, depuis S<dpkg 1.15.4).>

=item B<DEB_HOST_ARCH_ENDIAN>

Boutisme de la machine hôte (petit ou gros, depuis S<dpkg 1.15.4).>

=item B<DEB_HOST_GNU_CPU>

Partie CPU GNU de B<DEB_HOST_GNU_TYPE>.

=item B<DEB_HOST_GNU_SYSTEM>

Partie système GNU de B<DEB_HOST_GNU_TYPE>.

=item B<DEB_HOST_GNU_TYPE>

Type de système GNU de la machine hôte.

=item B<DEB_HOST_MULTIARCH>

Le type en clair de système GNU de la machine hôte, utilisé pour les chemins du système de fichiers (depuis S<dpkg 1.16.0).>

=item B<DEB_TARGET_ARCH>

L'architecture Debian de la machine cible (depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_ARCH_ABI>

Nom de l'ABI Debian de la machine cible (depuis S<dpkg 1.18.11).>

=item B<DEB_TARGET_ARCH_LIBC>

Nom de la libc Debian de la machine cible (depuis S<dpkg 1.18.11).>

=item B<DEB_TARGET_ARCH_OS>

Nom du système Debian de la machine cible (depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_ARCH_CPU>

Nom du processeur Debian de la machine cible (depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_ARCH_BITS>

Taille de pointeur de la machine cible (en bits, depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_ARCH_ENDIAN>

Boutisme de la machine cible (petit ou gros, depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_GNU_CPU>

Partie CPU GNU de B<DEB_TARGET_GNU_TYPE> (depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_GNU_SYSTEM>

Partie S<système GNU> de B<DEB_TARGET_GNU_TYPE> (depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_GNU_TYPE>

Type du système GNU de la machine cible (depuis S<dpkg 1.17.14).>

=item B<DEB_TARGET_MULTIARCH>

Le type en clair du système GNU de la machine cible, utilisé pour les chemins du système de fichiers (depuis S<dpkg 1.17.14).>

=back

=head1 FICHIERS

=head2 Tables d'architectures

Tous ces fichiers sont nécessaires afin que B<dpkg-architecture> puisse fonctionner. Leurs emplacements peuvent être modifiés lors du traitement à l'aide de la variable d'environnement B<DPKG_DATADIR>. Ces tables contiennent en première ligne un pseudo-champ de B<Version> de format pour indiquer leur format de sorte que les analyseurs peuvent vérifier s'ils les comprennent, tel que S<« #> S<Version=1.0 ».>

=over 

=item I<%PKGDATADIR%/table-processeur>

Table des noms de processeurs connus et liaison avec leur nom GNU. Version 1.0 de format (depuis S<dpkg 1.13.2).>

=item I<%PKGDATADIR%/table-système-exploitation>

Table des noms des systèmes d'exploitation connus et liaison avec leurs noms GNU. Version 2.0 de format (depuis S<dpkg 1.18.11).>

=item I<%PKGDATADIR%/table-n-uplet>

Correspondances entre les n-uplets de l'architecture Debian et les noms des architectures Debian. Format version 1.0 (depuis S<dpkg 1.18.11).>

=item I<%PKGDATADIR%/table-ABI>

Table des substituts d'attributs d'ABI d'architecture Debian. Format version 2.0 (depuis S<dpkg 1.18.11).>

=back

=head2 Gestion de l'empaquetage

=over 

=item I<%PKGDATADIR%/architecture.mk>

Un fragment de fichier Makefile qui définit correctement et exporte toutes les variables que B<dpkg-architecture> peut fournir (depuis S<dpkg 1.16.1).>

=back

=head1 EXEMPLES

B<dpkg-buildpackage> accepte l'option B<-a>, et la passe à B<dpkg-architecture>. Voici d'autres S<exemples :>

=over 

 CC=i386-gnu-gcc dpkg-architecture -c debian/rules build

 eval $(dpkg-architecture -u)

=back

Vérifier si l'architecture en cours (ou celle spécifiée) est identique à une S<architecture :>

=over 

 dpkg-architecture -elinux-alpha

 dpkg-architecture -amips -elinux-mips

=back

Vérifier si l'architecture en cours (ou celle spécifiée) est un système S<Linux :>

=over 

 dpkg-architecture -ilinux-any

 dpkg-architecture -ai386 -ilinux-any

=back

=head2 Utilisation dans debian/rules

Les variables d'environnement définies par B<dpkg-architecture> sont fournies à I<debian/rules> comme variables pour make (consultez la documentation de make). Cependant, vous ne devez pas compter là-dessus puisque cela empêche les appels manuels à ce script. À la place, vous devez toujours les initialiser en utilisant B<dpkg-architecture> avec l'option B<-q>. Voici quelques exemples, qui indiquent aussi comment améliorer la gestion des compilations croisées de votre S<paquet :>

Récupération du type de système GNU et passage à S<./configure :>

=over 

 DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
 DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
 [...]
 ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))
   confflags += --build=$(DEB_HOST_GNU_TYPE)
 else
   confflags += --build=$(DEB_BUILD_GNU_TYPE) \
                --host=$(DEB_HOST_GNU_TYPE)
 endif
 [...]
 ./configure $(confflags)

=back

Effectuer une action pour une architecture S<spécifique :>

=over 

 DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)

 ifeq ($(DEB_HOST_ARCH),alpha)
   [...]
 endif

=back

Ou, si vous n'avez besoin que de vérifier le type du processeur et du système, utilisez les variables B<DEB_HOST_ARCH_CPU> ou B<DEB_HOST_ARCH_OS>.

Veuillez noter qu'il est également possible d'utiliser un fragment externe de fichier Makefile pour définir correctement toutes les variables que B<dpkg-architecture> peut S<fournir :>

=over 

 include %PKGDATADIR%/architecture.mk

 ifeq ($(DEB_HOST_ARCH),alpha)
   [...]
 endif

=back

Dans tous les cas, il ne faut jamais utiliser B<dpkg --print-architecture> pour récupérer les informations relatives à l'architecture pendant la construction d'un paquet.

=head1 ENVIRONNEMENT

=over 

=item B<DPKG_DATADIR>

Si cette variable est définie, elle sera utilisée comme répertoire de données de B<dpkg> où sont placées les tables d'architecture (depuis S<dpkg 1.14.17).> Par défaut «%PKGDATADIR%».

=item B<DPKG_COLORS>

Définit le mode de couleur (depuis S<dpkg 1.18.5).> Les valeurs actuellement acceptées sont B<auto> (par défaut), B<always> et B<never>.

=item B<DPKG_NLS>

Si cette variable est définie, elle sera utilisée pour décider l'activation de la prise en charge des langues (NLS – Native Language Support), connu aussi comme la gestion de l'internationalisation (ou i18n) (depuis S<dpkg 1.19.0).> Les valeurs permises S<sont :> B<0> et B<1> (par défaut).

=back

=head1 NOTES

Tous les noms de commandes et d'options longs ne sont disponibles qu'à partir de S<dpkg 1.17.17.>

=head1 VOIR AUSSI

L<dpkg-buildpackage(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>.