path: root/man/fr/dpkg-architecture.1

.\" dpkg manual page - dpkg-architecture(1)
.\"
.\" Copyright © 2005 Marcus Brinkmann <brinkmd@debian.org>
.\" Copyright © 2005 Scott James Remnant <scott@netsplit.com>
.\" Copyright © 2006-2011 Guillem Jover <guillem@debian.org>
.\" Copyright © 2009-2012 Raphaël Hertzog <hertzog@debian.org>
.\"
.\" 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 <http://www.gnu.org/licenses/>.
.
.\"*******************************************************************
.\"
.\" 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\-\-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
<noyau>\-<processeur>. 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 <ariel.vardi@freesbee.fr>, 2002.
Philippe Batailler, 2006.
Nicolas François, 2006.
Veuillez signaler toute erreur à <debian\-l10n\-french@lists.debian.org>.