blob: 1881be07239b2434ef1dfe583a8e0378cddc49be [file] [log] [blame]
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-architecture 1 2011\-08\-14 "Proyecto Debian" "Herramientas de dpkg"
.SH NOMBRE
dpkg\-architecture \- Configurar y determinar la arquitectura para la
construcción de paquetes
.
.SH SINOPSIS
\fBdpkg\-architecture\fP [\fIoption\fP...] [\fIcommand\fP]
.PP
.
.SH DESCRIPCIÓN
dpkg\-architecture facilita determinar y configurar la arquitectura de
construcción y de la máquina anfitrión para la construcción de un paquete.
.PP
La arquitectura de construcción siempre se determina con una invocación
externa a \fBdpkg\fP(1), y no se puede definir en la línea de órdenes.
.PP
Puede definir la arquitectura del anfitrión introduciendo una o ambas
opciones \fB\-a\fP y \fB\-t\fP. El valor por omisión es una invocación externa a
\fBgcc\fP(1), o la misma que la arquitectura de construcción en caso de no
disponer de \s-1CC\s0 o gcc. Es suficiente usar \fB\-a\fP o \fB\-t\fP, el valor del
otro se definirá con un valor predefinido adecuado. De hecho, a veces es
mejor definir sólo uno, ya que \fBdpkg\-architecture\fP le avisará si su opción
no encaja con la opción predefinida.
.
.SH ÓRDENES
.TP
\fB\-l\fP
Muestra las variables de entorno, una por línea, con el formato
\fIVARIABLE=valor\fP. Esta es la acción predefinida.
.TP
\fB\-e\fP\fIdebian\-architecture\fP
Revisa si la arquitectura es la misma. Por omisión, \fIdebian\-architecture\fP
se compara con la arquitectura del sistema Debian actual, el sistema
anfitrión. Esta acción no expande los comodines de arquitectura. La orden
finaliza con un estado de salida de cero si coinciden, y de 1 en caso
contrario.
.TP
\fB\-i\fP\fIcomodín\-arquitectura\fP
Revisa la identidad de la arquitectura expandiendo \fIcomodin\-arquitectura\fP
como un comodín de arquitectura, y comparándola con la arquitectura del
sistema Debian actual. La orden finaliza con un estado de salida de cero si
coincide, y de 1 en caso contrario.
.TP
\fB\-q\fP\fInombre\-variable\fP
Muestra el valor de una única variable.
.TP
\fB\-s\fP
Muestra una orden «export». Se puede usar para definir las variables de
entorno mediante eval.
.TP
\fB\-u\fP
Muestra una orden similar a \fB\-s\fP, pero para eliminar la definición
unset») de todas las variables.
.TP
\fB\-c\fP\fI orden\fP
Ejecuta una \fIorden\fP en un entorno cuyas variables ya están definidas con un
valor predefinido.
.TP
\fB\-L\fP
Muestra una lista de nombres de arquitectura válidos.
.TP
\fB\-\-help\fP
Muestra el modo de uso y termina.
.TP
\fB\-\-version\fP
Muestra la versión y termina.
.
.SH OPCIONES
.TP
\fB\-a\fP\fIdebian\-architecture\fP
Define la arquitectura de Debian.
.TP
\fB\-t\fP\fItipo\-sistema\-gnu\fP
Define el tipo de sistema GNU.
.TP
\fB\-f\fP
Los scripts respetan los valores de variables de entorno preexistentes que
tienen el mismo nombre que los valores contenidos en el script (por ejemplo,
usados por \fBdpkg\-architecture\fP), a menos que se use esta marca de
forzado. Permite al usuario sobreescribir un valor, aún cuando la invocación
a \fBdpkg\-architecture\fP se encuentra en otro script (por ejemplo,
\fBdpkg\-buildpackage\fP(1)).
.
.SH TÉRMINOS
.IP "máquina de construcción" 4
La máquina en la que se construye el paquete.
.IP "máquina anfitrión" 4
La máquina para la cual se construye el paquete.
.IP "Arquitectura de Debian" 4
La cadena de la arquitectura de Debian, que especifica el árbol binario en
el archivo \s-1FTP\s0. Ejemplos: i386, sparc, hurd\-i386.
.IP "comodín de arquitectura" 4
Un comodín de arquitectura es una cadena especial de arquitectura que encaja
con cualquier arquitectura real del que es parte. La forma habitual es
<kernel>\-<cpu>. Ejemplos: linux\-any, any\-i386, hurd\-any.
.IP "tipo de sistema \s-1GNU\s0" 4
Una cadena de definición de arquitectura que consiste de dos partes
separadas por un guión: el procesador y el sistema. Ejemplos:
i386\-linux\-gnu, sparc\-linux\-gnu, i386\-gnu, x86_64\-netbsd.
.
.SH VARIABLES
Las siguientes variables se definen mediante \fBdpkg\-architecture\fP:
.IP \s-1DEB_BUILD_ARCH\s0 4
La arquitectura de Debian de la máquina de construcción.
.IP \s-1DEB_BUILD_ARCH_OS\s0 4
El nombre del sistema Debian de la máquina de construcción.
.IP \s-1DEB_BUILD_ARCH_CPU\s0 4
El nombre de Debian del procesador de la máquina de construcción.
.IP \s-1DEB_BUILD_ARCH_BITS\s0 4
El tamaño del puntero de la máquina de construcción, en bits.
.IP \s-1DEB_BUILD_ARCH_ENDIAN\s0 4
El nivel de «endianización» de la máquina de construcción, «little» o «big».
.IP \s-1DEB_BUILD_GNU_CPU\s0 4
La parte \s-1CPU\s0 de \s-1DEB_BUILD_GNU_TYPE\s0.
.IP \s-1DEB_BUILD_GNU_SYSTEM\s0 4
La parte de «System» de \s-1DEB_BUILD_GNU_TYPE\s0.
.IP \s-1DEB_BUILD_GNU_TYPE\s0 4
El tipo de sistema \s-1GNU\s0 de la máquina de construcción.
.IP \s-1DEB_BUILD_MULTIARCH\s0 4
The clarified \s-1GNU\s0 system type of the build machine, used for
filesystem paths.
.IP \s-1DEB_HOST_ARCH\s0 4
La arquitectura de Debian de la máquina anfitrión.
.IP \s-1DEB_HOST_ARCH_OS\s0 4
El nombre de sistema Debian de la máquina anfitrión.
.IP \s-1DEB_HOST_ARCH_CPU\s0 4
El nombre del procesador Debian de la máquina anfitrión.
.IP \s-1DEB_HOST_ARCH_BITS\s0 4
El tamaño del puntero de la máquina anfitrión, en bits.
.IP \s-1DEB_HOST_ARCH_ENDIAN\s0 4
El nivel de «endianización» de la máquina anfitrión, «little» o «big».
.IP \s-1DEB_HOST_GNU_CPU\s0 4
La parte de \s-1CPU\s0 de \s-1DEB_HOST_GNU_TYPE\s0.
.IP \s-1DEB_HOST_GNU_SYSTEM\s0 4
La parte de «System» de \s-1DEB_HOST_GNU_TYPE\s0.
.IP \s-1DEB_HOST_GNU_TYPE\s0 4
El tipo de sistema \s-1GNU\s0 de la máquina anfitrión.
.IP \s-1DEB_HOST_MULTIARCH\s0 4
The clarified \s-1GNU\s0 system type of the host machine, used for
filesystem paths.
.
.SH DEBIAN/RULES
Las variables de entorno definidas por \fBdpkg\-architecture\fP se introducen a
\fIdebian/rules\fP como variables de «make» (consulte la documentación de
make). Por otra parte, no debería depender de ellos, ya que esto rompe la
invocación manual del script. En lugar de ello, se deberían iniciar mediante
\fBdpkg\-architecture\fP con la opción «\-q». Aquí hay algunos ejemplos, que
muestran también como mejorar la compatibilidad de su paquete con la
construcción para varias arquitecturas.
.PP
En lugar de:
.IP
.nf
ARCH=\`dpkg \-\-print\-architecture\`
configure $(\s-1ARCH\s0)\-linux
.fi
.PP
use lo siguiente:
.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
En lugar de:
.IP
.nf
ARCH=\`dpkg \-\-print\-architecture\`
ifeq ($(\s-1ARCH\s0),alpha)
...
endif
.fi
.PP
use:
.IP
.nf
\&\s-1DEB_HOST_ARCH\s0 := $(shell dpkg\-architecture \-qDEB_HOST_ARCH)
ifeq ($(\s-1DEB_HOST_ARCH\s0),alpha)
...
endif
.fi
.PP
o si sólo precisa revisar el tipo de sistema o CPU, use las variables
«DEB_HOST_ARCH_OS» o «DEB_HOST_ARCH_CPU».
.PP
En general, invocar dpkg en el fichero de reglas rules») para obtener la
información de arquitectura está obsoleto (a menos que desee ofrecer
compatibilidad con versiones anteriores, véase a continuación). La opción
«\-\-print\-architecture» es particularmente inestable, ya que existen
arquitecturas de Debian que no encajan con el nombre de un procesador.
.
.SH "COMPATIBILIDAD CON VERSIONES ANTERIORES"
Las variables «DEB_*_ARCH_BITS» y «DEB_*_ARCH_ENDIAN» se introdujeron a
partir de la versión 1.15.4 de dpkg\-dev. Su uso en \fIdebian/rules\fP requiere
una dependencia de construcción sobre dpkg\-dev (>= 1.15.4).
.PP
Las variables «DEB_HOST_ARCH_CPU» y «DEB_HOST_ARCH_OS» se introdujeron a
partir de la versión 1.13.2 de dpkg\-dev. Antes, los ficheros \fIdebian/rules\fP
solían revisar aquellos valores de «DEB_HOST_GNU_CPU» o «DEB_HOST_GNU_TYPE»
susceptibles de haber cambiado.
.PP
Se deberían actualizar aquellas partes de los ficheros \fIdebian/rules\fP que
revisan las variables que deciden el modo o el objetivo a compilar. Puede
usar el siguiente código si desea permitir la compatibilidad con versiones
anteriores de dpkg\-dev:
.IP
.nf
DEB_HOST_ARCH_CPU := $(shell dpkg\-architecture \-qDEB_HOST_ARCH_CPU 2>/dev/null)
DEB_HOST_ARCH_OS := $(shell dpkg\-architecture \-qDEB_HOST_ARCH_OS 2>/dev/null)
# Take account of old dpkg\-architecture output.
ifeq ($(DEB_HOST_ARCH_CPU),)
DEB_HOST_ARCH_CPU := $(shell dpkg\-architecture \-qDEB_HOST_GNU_CPU)
ifeq ($(DEB_HOST_ARCH_CPU),x86_64)
DEB_HOST_ARCH_CPU := amd64
endif
endif
ifeq ($(DEB_HOST_ARCH_OS),)
DEB_HOST_ARCH_OS := $(subst \-gnu,,$(shell dpkg\-architecture \-qDEB_HOST_GNU_SYSTEM))
ifeq ($(DEB_HOST_ARCH_OS),gnu)
DEB_HOST_ARCH_OS := hurd
endif
endif
.fi
.PP
Y de forma parecida con «DEB_BUILD_ARCH_CPU» y «DEB_BUILD_ARCH_OS».
.PP
Si desea la compatibilidad con versiones de dpkg\-dev que no incluían
\fBdpkg\-architecture\fP, puede usar lo siguiente:
.IP
.nf
\&\s-1DEB_BUILD_ARCH\s0 := $(shell dpkg \-\-print\-architecture)
\&\s-1DEB_BUILD_GNU_CPU\s0 := $(patsubst hurd\-%,%,$(\s-1DEB_BUILD_ARCH\s0))
ifeq ($(filter\-out hurd\-%,$(\s-1DEB_BUILD_ARCH\s0)),)
\s-1DEB_BUILD_GNU_SYSTEM\s0 := gnu
else
\s-1DEB_BUILD_GNU_SYSTEM\s0 := linux\-gnu
endif
DEB_BUILD_GNU_TYPE=$(\s-1DEB_BUILD_GNU_CPU\s0)\-$(\s-1DEB_BUILD_GNU_SYSTEM\s0)
\&\s-1DEB_HOST_ARCH\s0 := $(\s-1DEB_BUILD_ARCH\s0)
\&\s-1DEB_HOST_GNU_CPU\s0 := $(\s-1DEB_BUILD_GNU_CPU\s0)
\&\s-1DEB_HOST_GNU_SYSTEM\s0 := $(\s-1DEB_BUILD_GNU_SYSTEM\s0)
\&\s-1DEB_HOST_GNU_TYPE\s0 := $(\s-1DEB_BUILD_GNU_TYPE\s0)
.fi
.PP
Inserte un subconjunto de estas líneas al inicio del fichero «debian/rules»;
estos valores predefinidos se sobreescribirán en caso de usar
dpkg\-architecture.
.PP
No necesita el conjunto completo. Seleccione un conjunto consistente que
contenga los valores que usa en el fichero de reglas. Por ejemplo, si sólo
necesita la arquitectura Debian del sistema de destino, tiene suficiente con
«DEB_HOST_ARCH=\`dpkg \-\-print\-architecture\» (de hecho, esta es la
arquitectura de Debian de la máquina de construcción, pero recuerde que sólo
intentamos crear la compatibilidad con versiones anteriores que tienen una
compilación nativa).
.PP
Las opciones \fB\-e\fP y \fB\-i\fP aparecieron en recientes versiones de
\fBdpkg\-architecture\fP (a partir de la versión 1.13.13 de dpkg).
.
.SH EJEMPLOS
\fBdpkg\-buildpackage\fP acepta la opción \fB\-a\fP y la introduce a
\fBdpkg\-architecture\fP. Otros ejemplos:
.IP
CC=i386\-gnu\-gcc dpkg\-architecture \-c debian/rules build
.IP
eval \`dpkg\-architecture \-u\`
.PP
Revisa si una arquitectura equivale a la arquitectura actual o dada:
.IP
dpkg\-architecture \-elinux\-alpha
.IP
dpkg\-architecture \-amips \-elinux\-mips
.PP
Revisa si la arquitectura actual o introducida con «\-a» es de un sistema
Linux:
.IP
dpkg\-architecture \-ilinux\-any
.IP
dpkg\-architecture \-ai386 \-ilinux\-any
.
.SH FICHEROS
All these files have to be present for \fBdpkg\-architecture\fP to work. Their
location can be overridden at runtime with the environment variable
\fBDPKG_DATADIR\fP.
.TP
\fI/usr/share/dpkg/cputable\fP
Tabla de nombres de CPU conocidos y su correlación con su nombre GNU.
.TP
\fI/usr/share/dpkg/ostable\fP
Tabla de sistemas operativos conocidos y su correlación con su nombre GNU.
.TP
\fI/usr/share/dpkg/triplettable\fP
Correlación entre tuples de 3 de la arquitectura de Debian, y los nombres de
arquitectura de Debian.
.
.SH "VÉASE TAMBIÉN"
\fBdpkg\-buildpackage\fP(1), \fBdpkg\-cross\fP(1).
.
.SH AUTOR
\fBdpkg\-architecture\fP y su página de manual fueron escritos originalmente por
Marcus Brinkmann <brinkmd@debian.org>.
.SH "TRADUCTOR"
Rudy Godoy <rudy@kernel\-panik.org>,
Rubén Porras <nahoo@inicia.es>,
Bruno Barrera C. <bruno.barrera@igloo.cl>,
Carlos Izquierdo <gheesh@ertis.net>,
Esteban Manchado y
NOK.
Debian L10n Spanish <debian\-l10n\-spanish@lists.debian.org>.
.br
Revisiones por Santiago Vila <sanvila@unex.es>,
Javier Fernández\-Sanguino, Rubén Porras,
Luis Uribe y Omar Campagne.