.\" dpkg manual page - dpkg-architecture(1) .\" .\" Copyright © 2005 Marcus Brinkmann .\" Copyright © 2005 Scott James Remnant .\" Copyright © 2006-2011 Guillem Jover .\" Copyright © 2009-2012 Raphaël 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 dpkg\-architecture 1 20\-01\-2012 "Projet Debian" "Utilitaires de dpkg" .SH NOM dpkg\-architecture \- Fixer et déterminer l'architecture pour la construction d'un paquet . .SH SYNOPSIS \fBdpkg\-architecture\fP [\fIoption\fP...] [\fIcommande\fP] .PP . .SH DESCRIPTION dpkg\-architecture aide à déterminer et à fixer l'architecture de construction et l'architecture hôte pour la création d'un paquet. .PP L'architecture de construction est toujours déterminée par un appel externe à \fBdpkg\fP(1). Elle ne peut pas être spécifiée en ligne de commande. .PP Vous pouvez spécifier une architecture hôte en utilisant une des options \fB\-a\fP et \fB\-t\fP (ou les deux). Par défaut, la valeur est déterminée par un appel à \fBgcc\fP(1), ou en utilisant l'architecture de construction si \s-1CC\s0 ou gcc ne sont pas disponibles. Utiliser une seule des options \fB\-a\fP et \fB\-t\fP est suffisant, la valeur de l'une est utilisée comme valeur par défaut de l'autre. Bien sûr, il est préférable de n'en préciser qu'une seule, puisque \fBdpkg\-architecture\fP affichera un avertissement si le choix ne correspond pas à la valeur par défaut. . .SH COMMANDES .TP \fB\-l\fP Affiche les variables d'environnement, une par ligne, en utilisant le format \fIVARIABLE=valeur\fP. C'est l'action par défaut. .TP \fB\-e\fP\fIarchitecture\-debian\fP Vérifie l'égalité d'architectures. Par défaut, \fIarchitecture\-debian\fP est comparée à l'architecture Debian actuelle, qui est celle de la machine hôte. Cette action ne développe pas les architectures joker. La commande quitte avec un code de retour de 0 si l'architecture correspond et de 1 dans le cas contraire. .TP \fB\-i\fP\fIarchitecture\-joker\fP Vérifie l'égalité d'architectures en développant \fIarchitecture\-joker\fP et en comparant à l'architecture Debian actuelle. La commande quitte avec un code de retour de 0 si l'architecture correspond et de 1 dans le cas contraire. .TP \fB\-q\fP\fInom\-de\-variable\fP Affiche la valeur d'une seule variable. .TP \fB\-s\fP Produit une commande, qui peut être utilisée pour positionner les variables d'environnement avec «\ eval\ ». .TP \fB\-u\fP Produit une commande similaire à celle produite par \fB\-s\fP, mais pour supprimer les variables de l'environnement. .TP \fB\-c\fP \fIcommande\fP Exécute une \fIcommande\fP dans un environnement où toutes les variables sont positionnées aux valeurs spécifiées. .TP \fB\-L\fP Affiche une liste des architectures valables. .TP \fB\-?\fP, \fB\-\-help\fP Affiche un message d'aide puis quitte. .TP \fB\-\-version\fP Affiche le numéro de version puis quitte. . .SH OPTIONS .TP \fB\-a\fP\fIarchitecture\-debian\fP Fixe l'architecture Debian. .TP \fB\-t\fP\fItype\-de\-système\-gnu\fP Fixe le type de système GNU. .TP \fB\-f\fP Les valeurs positionnées par les variables d'environnement ayant le même nom que celles utilisées par les scripts sont prises en compte (c'est\-à\-dire utilisée par \fBdpkg\-architecture\fP), sauf si cette option est présente. Ceci permet à un utilisateur de surcharger une valeur même lorsque l'appel à \fBdpkg\-architecture\fP est inclus dans un autre script (par exemple \fBdpkg\-buildpackage\fP(1)). . .SH TERMINOLOGIE .IP "Machine de construction" 4 Machine sur laquelle le paquet est construit. .IP "Machine hôte" 4 Machine pour laquelle le paquet est construit. .IP "Architecture Debian" 4 Chaîne de caractères de l'architecture Debian, qui spécifie l'emplacement dans l'archive \s-1FTP\s0. Par exemple\ : i386, sparc, hurd\-i386. .IP "Architecture joker" 4 Une architecture 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 \-. Par exemple\ : linux\-any, any\-i386, hurd\-any. .IP "Type de système \s-1GNU\s0" 4 Chaîne de caractères définissant l'architecture et constituée de deux parties séparées par un tiret\ : processeur et système. Par exemple\ : i386\-linux\-gnu, sparc\-linux\-gnu, i386\-gnu, x86_64\-netbsd. . .SH "VARIABLES D'ENVIRONNEMENT" Les variables suivantes sont positionnées par \fBdpkg\-architecture\fP\ : .IP \s-1DEB_BUILD_ARCH\s0 4 Architecture Debian de la machine de construction. .IP \s-1DEB_BUILD_ARCH_OS\s0 4 Nom du système Debian de la machine de construction. .IP \s-1DEB_BUILD_ARCH_CPU\s0 4 Nom de processeur Debian de la machine de construction. .IP \s-1DEB_BUILD_ARCH_BITS\s0 4 Taille de pointeur de la machine de construction (en bits). .IP \s-1DEB_BUILD_ARCH_ENDIAN\s0 4 «\ Endianness»\ de la machine de construction (little ou big). .IP \s-1DEB_BUILD_GNU_CPU\s0 4 Partie \s-1CPU\s0 de \s-1DEB_BUILD_GNU_TYPE\s0. .IP \s-1DEB_BUILD_GNU_SYSTEM\s0 4 Partie «\ système\ » de \s-1DEB_BUILD_GNU_TYPE\s0. .IP \s-1DEB_BUILD_GNU_TYPE\s0 4 Type de système \s-1GNU\s0 de la machine de construction. .IP \s-1DEB_BUILD_MULTIARCH\s0 4 Le type de système clarifié \s-1GNU\s0 de la machine de construction, utilisé pour les chemins du système de fichiers. .IP \s-1DEB_HOST_ARCH\s0 4 Architecture Debian de la machine hôte. .IP \s-1DEB_HOST_ARCH_OS\s0 4 Nom du système Debian de la machine hôte. .IP \s-1DEB_HOST_ARCH_CPU\s0 4 Nom du processeur Debian de la machine hôte. .IP \s-1DEB_HOST_ARCH_BITS\s0 4 Taille de pointeur de la machine hôte (en bits). .IP \s-1DEB_HOST_ARCH_ENDIAN\s0 4 «\ Endianess\ » de la machine hôte (little ou big). .IP \s-1DEB_HOST_GNU_CPU\s0 4 Partie «\ processeur\ » de \s-1DEB_HOST_GNU_TYPE\s0. .IP \s-1DEB_HOST_GNU_SYSTEM\s0 4 Partie «\ système\ » de \s-1DEB_HOST_GNU_TYPE\s0. .IP \s-1DEB_HOST_GNU_TYPE\s0 4 Type de système \s-1GNU\s0 de la machine hôte. .IP \s-1DEB_HOST_MULTIARCH\s0 4 Le type de système clarifié \s-1GNU\s0 de la machine hôte, utilisé pour les chemins du système de fichiers. . .SH DEBIAN/RULES Les variables d'environnement définies par \fBdpkg\-architecture\fP sont fournies à \fIdebian/rules\fP 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 \fBdpkg\-architecture\fP avec l'option \-q. Voici quelques exemples, qui indiquent aussi comment améliorer la gestion des compilations croisées de votre paquet\ : .PP Récupération du type de système GNU et passage à ./configure\ : .IP .nf \&\s-1DEB_BUILD_GNU_TYPE\s0 := $(shell dpkg\-architecture \-qDEB_BUILD_GNU_TYPE) \&\s-1DEB_HOST_GNU_TYPE\s0 := $(shell dpkg\-architecture \-qDEB_HOST_GNU_TYPE) [...] configure \-\-build=$(\s-1DEB_BUILD_GNU_TYPE\s0) \-\-host=$(\s-1DEB_HOST_GNU_TYPE\s0) .fi .PP Effectuer une action pour une architecture spécifique\ : .IP .nf \&\s-1DEB_HOST_ARCH\s0\ := $(shell dpkg\-architecture \-qDEB_HOST_ARCH) ifeq ($(\s-1DEB_HOST_ARCH\s0),alpha) [...] endif .fi .PP Ou, si vous n'avez besoin que de vérifier le type du processeur et du système, utilisez les variables DEB_HOST_ARCH_CPU ou DEB_HOST_ARCH_OS. .PP Veuillez noter qu'il est également possible d'utiliser un fragment externe de fichier Makefile pour définir correctement toutes les variables que \fBdpkg\-architecture\fP peut fournir\ : .IP .nf include /usr/share/dpkg/architecture.mk ifeq ($(\s-1DEB_HOST_ARCH\s0),alpha) [...] endif .fi .PP Dans tous les cas, il ne faut jamais utiliser \fBdpkg \-\-print\-architecture\fP pour récupérer les informations relatives à l'architecture pendant la construction d'un paquet. . .SH "COMPATIBILITÉ ARRIÈRE" Le fragment de fichier Makefile /usr/share/dpkg/architecture.mk Makefile est fourni par dpkg\-dev depuis la version 1.16.1. .PP Les variables DEB_*_ARCH_BITS et DEB_*_ARCH_ENDIAN sont apparues avec la version 1.15.4 de dpkg\-dev. Si elles sont utilisées dans \fIdebian/rules\fP, une dépendance de construction sur dpkg\-dev (>= 1.15.4) est nécessaire. .PP Les variables DEB_HOST_ARCH_CPU et DEB_HOST_ARCH_OS sont apparues dans la version 1.13.2 de dpkg\-dev. .PP Les options \fB\-e\fP et \fB\-i\fP n'ont été ajoutées que relativement récemment à \fBdpkg\-architecture\fP (depuis la version 1.13.13 de dpkg). . .SH EXEMPLES \fBdpkg\-buildpackage\fP accepte l'option \fB\-a\fP, et la passe à \fBdpkg\-architecture\fP. Voici d'autres exemples\ : .IP CC=i386\-gnu\-gcc dpkg\-architecture \-c debian/rules build .IP eval \`dpkg\-architecture \-u\` .PP Vérifie si une architecture est identique à l'architecture actuelle ou à celle spécifiée\ : .IP dpkg\-architecture \-elinux\-alpha .IP dpkg\-architecture \-amips \-elinux\-mips .PP Vérifie si l'architecture actuelle ou celle spécifiée avec \-a correspond à un système Linux\ : .IP dpkg\-architecture \-ilinux\-any .IP dpkg\-architecture \-ai386 \-ilinux\-any . .SH FICHIERS Tous ces fichiers sont nécessaires afin que \fBdpkg\-architecture\fP puisse fonctionner. Leurs emplacements peuvent être modifiés lors du traitement via la variable d'environnement \fBDPKG_DATADIR\fP. .TP \fI/usr/share/dpkg/cputable\fP Table des noms de processeurs connus et liaison avec leur nom GNU. .TP \fI/usr/share/dpkg/ostable\fP Table des noms des systèmes d'exploitation connus et liaison avec leurs noms GNU. .TP \fI/usr/share/dpkg/triplettable\fP Correspondances entre les triplets de l'architecture Debian et les noms des architectures Debian. . .SH "VOIR AUSSI" \fBdpkg\-buildpackage\fP(1), \fBdpkg\-cross\fP(1). .SH TRADUCTION Ariel VARDI , 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute erreur à .