mdw@git.distorted.org.uk Git - dpkg/blob - man/fr/dpkg-architecture.man

   1 .\" dpkg manual page - dpkg-architecture(1)
   2 .\"
   3 .\" Copyright © 2005 Marcus Brinkmann <brinkmd@debian.org>
   4 .\" Copyright © 2005 Scott James Remnant <scott@netsplit.com>
   5 .\" Copyright © 2006-2015 Guillem Jover <guillem@debian.org>
   6 .\" Copyright © 2009-2012 Raphaël Hertzog <hertzog@debian.org>
   7 .\"
   8 .\" This is free software; you can redistribute it and/or modify
   9 .\" it under the terms of the GNU General Public License as published by
  10 .\" the Free Software Foundation; either version 2 of the License, or
  11 .\" (at your option) any later version.
  12 .\"
  13 .\" This is distributed in the hope that it will be useful,
  14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 .\" GNU General Public License for more details.
  17 .\"
  18 .\" You should have received a copy of the GNU General Public License
  19 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  20 .
  21 .\"*******************************************************************
  22 .\"
  23 .\" This file was generated with po4a. Translate the source file.
  24 .\"
  25 .\"*******************************************************************
  26 .TH dpkg\-architecture 1 %RELEASE_DATE% %VERSION% "suite dpkg"
  27 .nh
  28 .SH NOM
  29 dpkg\-architecture \- Fixer et déterminer l'architecture pour la construction
  30 d'un paquet
  31 .
  32 .SH SYNOPSIS
  33 \fBdpkg\-architecture\fP [\fIoption\fP...] [\fIcommande\fP]
  34 .PP
  35 .
  36 .SH DESCRIPTION
  37 \fBdpkg\-architecture\fP aide à déterminer et à fixer l'architecture de
  38 construction et l'architecture hôte pour la création d'un paquet.
  39 .PP
  40 L'architecture de construction est toujours déterminée par un appel externe
  41 à \fBdpkg\fP(1). Elle ne peut pas être spécifiée en ligne de commande.
  42 .PP
  43 Vous pouvez spécifier une architecture hôte en utilisant une des options
  44 \fB\-\-host\-arch\fP et \fB\-\-host\-type\fP (ou les deux). Par défaut, la valeur est
  45 déterminée par un appel à \fBgcc\fP(1), ou en utilisant l'architecture de
  46 construction si \fBCC\fP ou gcc ne sont pas disponibles. Utiliser une seule des
  47 options \fB\-\-host\-arch\fP et \fB\-\-host\-type\fP est suffisant, la valeur de l'une
  48 est utilisée comme valeur par défaut de l'autre. Bien sûr, il est préférable
  49 de n'en préciser qu'une seule, puisque \fBdpkg\-architecture\fP affichera un
  50 avertissement si le choix ne correspond pas à la valeur par défaut.
  51 .
  52 .SH COMMANDES
  53 .TP
  54 \fB\-l\fP, \fB\-\-list\fP
  55 Affiche les variables d'environnement, une par ligne, en utilisant le format
  56 \fIVARIABLE=valeur\fP. C'est l'action par défaut.
  57 .TP
  58 \fB\-e\fP, \fB\-\-equal\fP \fIarchitecture\fP
  59 Vérifie l'égalité d'architectures (depuis dpkg 1.13.13). Cela compare
  60 l'architecture Debian en cours (ou celle spécifiée) à \fIarchitecture\fP afin
  61 de vérifier leur égalité. Cette action ne gère pas les architectures
  62 joker. La commande quitte avec un code de retour de 0 si l'architecture
  63 correspond et de 1 dans le cas contraire.
  64
  65 .TP
  66 \fB\-i\fP, \fB\-\-is\fP \fIarchitecture\-joker\fP
  67 Vérifie l'identité des architectures (depuis dpkg 1.13.13). Cela compare
  68 l'architecture Debian en cours (ou celle spécifiée) à \fIarchitecture\-joker\fP
  69 (après expansion de celle\-ci) afin de vérifier leur correspondance. La
  70 commande quitte avec un code de retour de 0 si l'architecture correspond et
  71 de 1 dans le cas contraire.
  72 .TP
  73 \fB\-q\fP, \fB\-\-query\fP \fInom\-de\-variable\fP
  74 Affiche la valeur d'une seule variable.
  75 .TP
  76 \fB\-s\fP, \fB\-\-print\-set\fP
  77 Produit une commande, qui peut être utilisée pour positionner les variables
  78 d'environnement avec «\ eval\ ».
  79 .TP
  80 \fB\-u\fP, \fB\-\-print\-unset\fP
  81 Affiche une commande similaire à celle produite par \fB\-\-print\-unset\fP, mais
  82 pour supprimer toutes les variables.
  83 .TP
  84 \fB\-c\fP, \fB\-\-command\fP \fIcommande\fP
  85 Exécute une \fIcommande\fP dans un environnement où toutes les variables sont
  86 positionnées aux valeurs spécifiées.
  87 .TP
  88 \fB\-L\fP, \fB\-\-list\-known\fP
  89 Affiche une liste des architectures valables. Elle peut être restreinte par
  90 une ou plusieurs des options correspondantes \fB\-\-match\-wildcard\fP,
  91 \fB\-\-match\-bits\fP ou \fB\-\-match\-endian\fP (depuis dpkg 1.17.14).
  92 .TP
  93 \fB\-?\fP, \fB\-\-help\fP
  94 Affiche un message d'aide puis quitte.
  95 .TP
  96 \fB\-\-version\fP
  97 Affiche le numéro de version puis quitte.
  98 .
  99 .SH OPTIONS
 100 .TP
 101 \fB\-a\fP, \fB\-\-host\-arch\fP \fIarchitecture\fP
 102 Définit l'architecture Debian en cours.
 103 .TP
 104 \fB\-t\fP, \fB\-\-host\-type\fP \fItype\-de\-système\-gnu\fP
 105 Définit le type de système GNU en cours.
 106 .TP
 107 \fB\-A\fP, \fB\-\-target\-arch\fP \fIarchitecture\fP
 108 Set the target Debian architecture (since dpkg 1.17.14).
 109 .TP
 110 \fB\-T\fP, \fB\-\-target\-type\fP \fItype\-de\-système\-gnu\fP
 111 Set the target GNU system type (since dpkg 1.17.14).
 112 .TP
 113 \fB\-W\fP, \fB\-\-match\-wildcard\fP \fIarchitecture\-joker\fP
 114 Restreindre les architectures listées par \fB\-\-list\-known\fP à celles
 115 correspondant à l'architecture\-joker (depuis dpkg 1.17.14).
 116 .TP
 117 \fB\-B\fP, \fB\-\-match\-bits\fP \fIbits\-de\-l'architecture\fP
 118 Restreindre les architectures listées par \fB\-\-list\-known\fP à celles employant
 119 un CPU disposant du nombre de bits indiqués (depuis dpkg 1.17.14). Soit
 120 \fB32\fP, soit \fB64\fP.
 121 .TP
 122 \fB\-E\fP, \fB\-\-match\-endian\fP \fIboutisme\-d'architecture\fP
 123 Restreindre les architectures listées par \fB\-\-list\-known\fP à celles
 124 correspondant au boutisme spécifié (depuis dpkg 1.17.14). Soit \fBlittle\fP,
 125 soit \fBbig\fP.
 126 .TP
 127 \fB\-f\fP, \fB\-\-force\fP
 128 Les valeurs positionnées par les variables d'environnement ayant le même nom
 129 que celles utilisées par les scripts sont prises en compte (c'est\-à\-dire
 130 utilisée par \fBdpkg\-architecture\fP), sauf si cette option est présente. Cela
 131 permet à un utilisateur de surcharger une valeur même lorsque l'appel à
 132 \fBdpkg\-architecture\fP est inclus dans un autre script (par exemple
 133 \fBdpkg\-buildpackage\fP(1)).
 134 .
 135 .SH TERMINOLOGIE
 136 .IP "Machine de construction" 4
 137 Machine sur laquelle le paquet est construit.
 138 .IP "Machine hôte" 4
 139 Machine pour laquelle le paquet est construit.
 140 .IP "Machine cible" 4
 141 The machine the compiler is building for.  This is only needed when building
 142 a cross\-toolchain, one that will be built on the build architecture, to be
 143 run on the host architecture, and to build code for the target architecture.
 144 .IP "Architecture Debian" 4
 145 Chaîne de caractères de l'architecture Debian qui spécifie l'emplacement
 146 dans l'archive FTP. Par exemple\ : i386, sparc, hurd\-i386.
 147 .IP "Debian architecture tuple" 4
 148 A Debian architecture tuple is the fully qualified architecture with all its
 149 components spelled out.  This differs with Debian architectures in that at
 150 least the \fIcpu\fP component does not embed the \fIabi\fP.  The current tuple has
 151 the form \fIabi\fP\-\fIlibc\fP\-\fIos\fP\-\fIcpu\fP.  Examples: base\-gnu\-linux\-amd64,
 152 eabihf\-musl\-linux\-arm.
 153 .IP "Debian architecture wildcard" 4
 154 A Debian architecture wildcard is a special architecture string that will
 155 match any real architecture being part of it.  The general form is a Debian
 156 architecture tuple with four or less elements, and with at least one of them
 157 being \fBany\fP.  Missing elements of the tuple are prefixed implicitly as
 158 \fBany\fP, and thus the following pairs are equivalent:
 159 .nf
 160     \fBany\fP\-\fBany\fP\-\fBany\fP\-\fBany\fP = \fBany\fP
 161     \fBany\fP\-\fBany\fP\-\fIos\fP\-\fBany\fP = \fIos\fP\-\fBany\fP
 162     \fBany\fP\-\fIlibc\fP\-\fBany\fP\-\fBany\fP = \fIlibc\fP\-\fBany\fP\-\fBany\fP
 163 .fi
 164 Examples: linux\-any, any\-i386, hurd\-any, eabi\-any\-any\-arm, musl\-any\-any.
 165 .IP "Type de système GNU" 4
 166 An architecture specification string consisting of two parts separated by a
 167 hyphen: cpu and system.  Examples: i586\-linux\-gnu, sparc\-linux\-gnu,
 168 i686\-gnu, x86_64\-netbsd.
 169 .IP "multiarch triplet" 4
 170 The clarified GNU system type, used for filesystem paths.  This triplet does
 171 not change even when the baseline ISA gets bumped, so that the resulting
 172 paths are stable over time.  The only current difference with the GNU system
 173 type is that the CPU part for i386 based systems is always i386.  Examples:
 174 i386\-linux\-gnu, x86_64\-linux\-gnu.  Example paths:
 175 /lib/powerpc64le\-linux\-gnu/, /usr/lib/i386\-kfreebsd\-gnu/.
 176 .
 177 .SH "VARIABLES D'ENVIRONNEMENT"
 178 Les variables suivantes sont positionnées par \fBdpkg\-architecture\fP\ :
 179 .IP \fBDEB_BUILD_ARCH\fP 4
 180 Architecture Debian de la machine de construction.
 181 .IP \fBDEB_BUILD_ARCH_ABI\fP 4
 182 The Debian abi name of the build machine (since dpkg 1.18.11).
 183 .IP \fBDEB_BUILD_ARCH_LIBC\fP 4
 184 The Debian libc name of the build machine (since dpkg 1.18.11).
 185 .IP \fBDEB_BUILD_ARCH_OS\fP 4
 186 Nom du système Debian de la machine de construction (depuis dpkg 1.13.2).
 187 .IP \fBDEB_BUILD_ARCH_CPU\fP 4
 188 Nom de processeur Debian de la machine de construction (depuis dpkg 1.13.2).
 189 .IP \fBDEB_BUILD_ARCH_BITS\fP 4
 190 Taille de pointeur de la machine de construction (en bits, depuis dpkg
 191 1.15.4).
 192 .IP \fBDEB_BUILD_ARCH_ENDIAN\fP 4
 193 Boutisme de la machine de construction (petit ou gros, depuis dpkg 1.15.4).
 194 .IP \fBDEB_BUILD_GNU_CPU\fP 4
 195 Partie CPU de \fBDEB_BUILD_GNU_TYPE\fP.
 196 .IP \fBDEB_BUILD_GNU_SYSTEM\fP 4
 197 Partie «\ système\ » de \fBDEB_BUILD_GNU_TYPE\fP.
 198 .IP \fBDEB_BUILD_GNU_TYPE\fP 4
 199 Type de système GNU de la machine de construction.
 200 .IP \fBDEB_BUILD_MULTIARCH\fP 4
 201 Le type en clair de système GNU de la machine de construction, utilisé pour
 202 les chemins du système de fichiers (depuis dpkg 1.16.0).
 203 .IP \fBDEB_HOST_ARCH\fP 4
 204 Architecture Debian de la machine hôte.
 205 .IP \fBDEB_HOST_ARCH_ABI\fP 4
 206 The Debian abi name of the host machine (since dpkg 1.18.11).
 207 .IP \fBDEB_HOST_ARCH_LIBC\fP 4
 208 The Debian libc name of the host machine (since dpkg 1.18.11).
 209 .IP \fBDEB_HOST_ARCH_OS\fP 4
 210 Nom du système Debian de la machine hôte (depuis dpkg 1.13.2).
 211 .IP \fBDEB_HOST_ARCH_CPU\fP 4
 212 Nom du processeur Debian de la machine hôte (depuis dpkg 1.13.2).
 213 .IP \fBDEB_HOST_ARCH_BITS\fP 4
 214 Taille de pointeur de la machine hôte (en bits, depuis dpkg 1.15.4).
 215 .IP \fBDEB_HOST_ARCH_ENDIAN\fP 4
 216 Boutisme de la machine hôte (petit ou gros, depuis dpkg 1.15.4).
 217 .IP \fBDEB_HOST_GNU_CPU\fP 4
 218 Partie «\ processeur\ » de \fBDEB_HOST_GNU_TYPE\fP.
 219 .IP \fBDEB_HOST_GNU_SYSTEM\fP 4
 220 Partie «\ système\ » de \fBDEB_HOST_GNU_TYPE\fP.
 221 .IP \fBDEB_HOST_GNU_TYPE\fP 4
 222 Type de système GNU de la machine hôte.
 223 .IP \fBDEB_HOST_MULTIARCH\fP 4
 224 Le type en clair de système GNU de la machine hôte, utilisé pour les chemins
 225 du système de fichiers (depuis dpkg 1.16.0).
 226 .IP \fBDEB_TARGET_ARCH\fP 4
 227 L'architecture Debian de la machine cible (depuis dpkg 1.17.14).
 228 .IP \fBDEB_TARGET_ARCH_ABI\fP 4
 229 The Debian abi name of the target machine (since dpkg 1.18.11).
 230 .IP \fBDEB_TARGET_ARCH_LIBC\fP 4
 231 The Debian libc name of the target machine (since dpkg 1.18.11).
 232 .IP \fBDEB_TARGET_ARCH_OS\fP 4
 233 Nom du système Debian de la machine cible (depuis dpkg 1.17.14).
 234 .IP \fBDEB_TARGET_ARCH_CPU\fP 4
 235 Nom du processeur Debian de la machine cible (depuis dpkg 1.17.14).
 236 .IP \fBDEB_TARGET_ARCH_BITS\fP 4
 237 Taille de pointeur de la machine cible (en bits, depuis dpkg 1.17.14).
 238 .IP \fBDEB_TARGET_ARCH_ENDIAN\fP 4
 239 Boutisme de la machine cible (petit ou gros, depuis dpkg 1.17.14).
 240 .IP \fBDEB_TARGET_GNU_CPU\fP 4
 241 Partie «\ processeur\ » de \fBDEB_TARGET_GNU_TYPE\fP (depuis dpkg 1.17.14).
 242 .IP \fBDEB_TARGET_GNU_SYSTEM\fP 4
 243 Partie «\ système\ » de \fBDEB_TARGET_GNU_TYPE\fP (depuis dpkg 1.17.14).
 244 .IP \fBDEB_TARGET_GNU_TYPE\fP 4
 245 Type du système GNU de la machine cible (depuis dpkg 1.17.14).
 246 .IP \fBDEB_TARGET_MULTIARCH\fP 4
 247 Le type de système clarifié GNU de la machine cible, utilisé pour les
 248 chemins du système de fichiers (depuis dpkg 1.17.14).
 249 .
 250 .SH FICHIERS
 251 .SS "Tables d'architectures"
 252 All these files have to be present for \fBdpkg\-architecture\fP to work. Their
 253 location can be overridden at runtime with the environment variable
 254 \fBDPKG_DATADIR\fP.  These tables contain a format \fBVersion\fP pseudo\-field on
 255 their first line to mark their format, so that parsers can check if they
 256 understand it, such as "# Version=1.0".
 257 .TP
 258 \fI%PKGDATADIR%/cputable\fP
 259 Table of known CPU names and mapping to their GNU name.  Format version 1.0
 260 (since dpkg 1.13.2).
 261 .TP
 262 \fI%PKGDATADIR%/ostable\fP
 263 Table of known operating system names and mapping to their GNU name.  Format
 264 version 2.0 (since dpkg 1.18.11).
 265 .TP
 266 \fI%PKGDATADIR%/tupletable\fP
 267 Mapping between Debian architecture tuples and Debian architecture names.
 268 Format version 1.0 (since dpkg 1.18.11).
 269 .TP
 270 \fI%PKGDATADIR%/abitable\fP
 271 Table of Debian architecture ABI attribute overrides.  Format version 2.0
 272 (since dpkg 1.18.11).
 273 .SS "Gestion de l'empaquetage"
 274 .TP
 275 \fI%PKGDATADIR%/architecture.mk\fP
 276 Un fragment de fichier Makefile qui définit correctement et exporte toutes
 277 les variables que \fBdpkg\-architecture\fP peut fournir (depuis dpkg 1.16.1).
 278 .
 279 .SH EXEMPLES
 280 \fBdpkg\-buildpackage\fP accepte l'option \fB\-a\fP, et la passe à
 281 \fBdpkg\-architecture\fP. Voici d'autres exemples\ :
 282 .IP
 283 CC=i386\-gnu\-gcc dpkg\-architecture \-c debian/rules build
 284 .IP
 285 eval \`dpkg\-architecture \-u\`
 286 .PP
 287 Vérifie si l'architecture en cours (ou celle spécifiée) est identique à une
 288 architecture\ :
 289 .IP
 290 dpkg\-architecture \-elinux\-alpha
 291 .IP
 292 dpkg\-architecture \-amips \-elinux\-mips
 293 .PP
 294 Vérifie si l'architecture en cours (ou celle spécifiée) est un système
 295 Linux\ :
 296 .IP
 297 dpkg\-architecture \-ilinux\-any
 298 .IP
 299 dpkg\-architecture \-ai386 \-ilinux\-any
 300 .
 301 .SS "Utilisation dans debian/rules"
 302 Les variables d'environnement définies par \fBdpkg\-architecture\fP sont
 303 fournies à \fIdebian/rules\fP comme variables pour make (consultez la
 304 documentation de make). Cependant, vous ne devez pas compter là\-dessus
 305 puisque cela empêche les appels manuels à ce script. À la place, vous devez
 306 toujours les initialiser en utilisant \fBdpkg\-architecture\fP avec l'option
 307 \fB\-q\fP. Voici quelques exemples, qui indiquent aussi comment améliorer la
 308 gestion des compilations croisées de votre paquet\ :
 309 .PP
 310 Récupération du type de système GNU et passage à ./configure\ :
 311 .PP
 312 .RS 4
 313 .nf
 314 DEB_BUILD_GNU_TYPE\ ?= $(shell dpkg\-architecture \-qDEB_BUILD_GNU_TYPE)
 315 DEB_HOST_GNU_TYPE\ ?= $(shell dpkg\-architecture \-qDEB_HOST_GNU_TYPE)
 316 [...]
 317 ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))
 318   confflags += \-\-build=$(DEB_HOST_GNU_TYPE)
 319 else
 320   confflags += \-\-build=$(DEB_BUILD_GNU_TYPE) \e
 321                \-\-host=$(DEB_HOST_GNU_TYPE)
 322 endif
 323 [...]
 324 \&./configure $(confflags)
 325 .fi
 326 .RE
 327 .PP
 328 Effectuer une action pour une architecture spécifique\ :
 329 .PP
 330 .RS 4
 331 .nf
 332 DEB_HOST_ARCH\ ?= $(shell dpkg\-architecture \-qDEB_HOST_ARCH)
 333
 334 ifeq ($(DEB_HOST_ARCH),alpha)
 335   [...]
 336 endif
 337 .fi
 338 .RE
 339 .PP
 340 Ou, si vous n'avez besoin que de vérifier le type du processeur et du
 341 système, utilisez les variables \fBDEB_HOST_ARCH_CPU\fP ou \fBDEB_HOST_ARCH_OS\fP.
 342 .PP
 343 Veuillez noter qu'il est également possible d'utiliser un fragment externe
 344 de fichier Makefile pour définir correctement toutes les variables que
 345 \fBdpkg\-architecture\fP peut fournir\ :
 346 .PP
 347 .RS 4
 348 .nf
 349 include %PKGDATADIR%/architecture.mk
 350
 351 ifeq ($(DEB_HOST_ARCH),alpha)
 352   [...]
 353 endif
 354 .fi
 355 .RE
 356 .PP
 357 Dans tous les cas, il ne faut jamais utiliser \fBdpkg \-\-print\-architecture\fP
 358 pour récupérer les informations relatives à l'architecture pendant la
 359 construction d'un paquet.
 360 .
 361 .SH ENVIRONNEMENT
 362 .TP
 363 \fBDPKG_DATADIR\fP
 364 If set, it will be used as the \fBdpkg\fP data directory, where the
 365 architecture tables are located (since dpkg 1.14.17).  Defaults to
 366 «%PKGDATADIR%».
 367 .SH NOTES
 368 Tous les noms de commandes et d'options longs ne sont disponibles qu'à
 369 partir de dpkg 1.17.17.
 370 .
 371 .SH "VOIR AUSSI"
 372 \fBdpkg\-buildpackage\fP(1), \fBdpkg\-cross\fP(1).
 373 .SH TRADUCTION
 374 Ariel VARDI <ariel.vardi@freesbee.fr>, 2002.
 375 Philippe Batailler, 2006.
 376 Nicolas François, 2006.
 377 Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>.