| .\"******************************************************************* |
| .\" |
| .\" This file was generated with po4a. Translate the source file. |
| .\" |
| .\"******************************************************************* |
| .TH dpkg\-buildpackage 1 2011\-08\-14 "Proyecto Debian" "Herramientas de dpkg" |
| .SH NOMBRE |
| dpkg\-buildpackage \- Construcción de paquetes binarios o fuente a partir de |
| las fuentes |
| . |
| .SH SINOPSIS |
| \fBdpkg\-buildpackage\fP [\fIoption\fP...] |
| . |
| .SH DESCRIPCIÓN |
| \fBdpkg\-buildpackage\fP es un programa que automatiza el proceso de |
| construcción de un paquete de Debian. Éste consiste de los siguientes pasos: |
| .IP \fB1.\fP 3 |
| Preparación del entorno de construcción, definiendo varias variables de |
| entorno (consulte \fBVARIABLES DE ENTORNO\fP) para invocar \fBdpkg\-source |
| \-\-before\-build\fP (a menos que se defina \fB\-T\fP o \fB\-\-target\fP. |
| .IP \fB2.\fP 3 |
| Verificar que las dependencias y conflictos de construcción |
| («build\-dependencies» y «build\-conflicts», respectivamente) estén |
| satisfechas (a menos que especifique \fB\-d\fP). |
| .IP \fB3.\fP 3 |
| Si se selecciona un objetivo específico con \fB\-T\fP o \fB\-\-target\fP, invoca ese |
| objetivo y se detiene. De no ser así, invoca \fBfakeroot debian/rules clean\fP |
| para limpiar el árbol de construcción (a menos que especifique \fB\-nc\fP). |
| .IP \fB4.\fP 3 |
| Invocación de \fBdpkg\-source \-b\fP para generar el paquete fuente (a menos que |
| se requiera sólo la construcción del paquete binario con \fB\-b\fP, \fB\-B\fP o |
| \fB\-A\fP). |
| .IP \fB5.\fP 3 |
| It calls \fBdebian/rules\fP \fBbuild\fP followed by \fBfakeroot debian/rules\fP |
| \fIbinary\-target\fP (unless a source\-only build has been requested with |
| \fB\-S\fP). Note that \fIbinary\-target\fP is either \fBbinary\fP (default case, or if |
| \fB\-b\fP is specified) or \fBbinary\-arch\fP (if \fB\-B\fP is specified) or |
| \fBbinary\-indep\fP (if \fB\-A\fP is specified). |
| .IP \fB6.\fP 3 |
| Invocación de \fBgpg\fP para firmar el fichero \fB.dsc\fP (de existir, a menos que |
| se especifique \fB\-us\fP). |
| .IP \fB7.\fP 3 |
| Invocación de \fBdpkg\-genchanges\fP para generar el fichero \fB.changes\fP. Muchas |
| de las opciones de \fBdpkg\-buildpackage\fP se introducen a \fBdpkg\-genchanges\fP. |
| .IP \fB8.\fP 3 |
| Invocación de \fBgpg\fP para firmar el fichero \fB.changes\fP (a menos que se |
| especifique \fB\-us\fP). |
| .IP \fB9.\fP 3 |
| Si se especifica \fB\-tc\fP, se invocará nuevamente \fBfakeroot debian/rules |
| clean\fP. Por último, invoca \fBdpkg\-source \-\-after\-build\fP. |
| . |
| .SH OPCIONES |
| .TP |
| \fB\-b\fP |
| Especifica una construcción sólo binaria, no se construirán ficheros de |
| fuentes y/o distribuidas. Se introduce a \fBdpkg\-genchanges\fP. |
| .TP |
| \fB\-B\fP |
| Especifica una construcción sólo binaria, limitada a paquetes dependientes |
| de arquitectura. Se introduce a \fBdpkg\-genchanges\fP. |
| .TP |
| \fB\-A\fP |
| Especifica una construcción sólo binaria, limitada a paquetes independientes |
| de la arquitectura. Se introduce a \fBdpkg\-genchanges\fP. |
| .TP |
| \fB\-S\fP |
| Especifica una construcción sólo de las fuentes, no se construirá ningún |
| paquete binario. Se introduce a \fBdpkg\-genchanges\fP. |
| .TP |
| \fB\-F\fP |
| Define una construcción completa normal, se construyen los paquetes binarios |
| y de fuente. Es idéntica al comportamiento predefinido cuando no se define |
| ninguna opción de construcción. |
| .P |
| \fB\-\-target=\fP\fItarget\fP |
| .br |
| \fB\-\-target \fP\fItarget\fP |
| .br |
| \fB\-T\fP\fItarget\fP |
| .RS |
| Invoca \fBdebian/rules\fP \fItarget\fP después de definir el entorno de |
| construcción, deteniendo en este punto el proceso de construcción del |
| paquete. Si se introduce \fB\-\-as\-root\fP, la orden se ejecutará como el usuario |
| «root» (véase \fB\-r\fP). Tenga en cuenta que los objetivos oficiales que |
| precisan ejecutarse como administrador según las directrices de Debian no |
| necesitan esta opción. |
| .RE |
| .TP |
| \fB\-\-as\-root\fP |
| Su uso sólo tiene sentido con \fB\-\-target\fP. Requiere que se ejecute el |
| objetivo con permisos del usuario «root». |
| .P |
| \fB\-si\fP |
| .br |
| \fB\-sa\fP |
| .br |
| \fB\-sd\fP |
| .br |
| \fB\-v\fP\fIversión\fP |
| .br |
| \fB\-C\fP\fIdescripción\-de\-cambios\fP |
| .br |
| \fB\-m\fP\fIdirección\-mantenedor\fP |
| .br |
| \fB\-e\fP\fIdirección\-mantenedor\fP |
| .RS |
| Se introduce sin cambios a \fBdpkg\-genchanges\fP. Consulte la página de manual. |
| .RE |
| .TP |
| \fB\-a\fP\fIarquitectura\fP |
| Especifica la arquitectura de Debian para la cual se construye el |
| paquete. La arquitectura de la máquina en la que se construye el paquete se |
| detecta automáticamente, y es también la arquitectura de destino por omisión |
| para la máquina anfitrión. |
| .TP |
| \fB\-t\fP\fItipo\-sistema\-gnu\fP |
| Define el tipo de sistema GNU para el cual se construye el paquete. Se puede |
| usar en lugar de «\-a», o como un complemento para invalidar el tipo de |
| sistema GNU predefinido de la arquitectura Debian de destino. |
| .TP |
| \fB\-j\fP\fItareas\fP |
| El número máximo de tareas («jobs») ejecutándose simultáneamente, |
| equivalente a la opción de \fBmake\fP(1) del mismo nombre. Se añadirá a la |
| variable de entorno «MAKEFLAGS», que causa que todas las invocaciones |
| posteriores a «make» hereden esta opción. También añade |
| \fBparallel=\fP\fItareas\fP a la variable de entorno «DEB_BUILD_OPTIONS», que |
| permite que los ficheros «debian/rules» usen esta información para sus |
| propios propósitos. \fBparallel=\fP\fItareas\fP en la variable de entorno |
| «DEB_BUILD_OPTIONS» invalida el valor \fB\-j\fP en caso de introducir esta |
| opción. |
| .TP |
| \fB\-D\fP |
| Verifica las dependencias y los conflictos de construcción, interrumpiendo |
| el proceso si alguna no está satisfecha. Este es el comportamiento por |
| omisión. |
| .TP |
| \fB\-d\fP |
| No revisa dependencias ni conflictos de construcción. |
| .TP |
| \fB\-nc\fP |
| No limpia el árbol de fuentes (implica \fB\-b\fP si no se introdujo \fB\-B\fP, \fB\-A\fP |
| o \fB\-S\fP). |
| .TP |
| \fB\-tc\fP |
| Limpia el árbol de fuentes (usando \fIorden\-para\-obtener\-root\fP \fBdebian/rules |
| clean\fP) después de la creación del paquete. |
| .TP |
| \fB\-r\fP\fIorden\-para\-obtener\-root\fP |
| Cuando \fBdpkg\-buildpackage\fP necesite ejecutar parte del proceso de |
| construcción como «root», añade el prefijo \fIorden\-para\-obtener\-root\fP a la |
| orden a ejecutar en caso de haberse especificado. La |
| \fIorden\-para\-obtener\-root\fP debe ser el nombre de un programa que esté dentro |
| del \fBPATH\fP, y tomará como argumentos el nombre del proceso a ejecutar, así |
| como los argumentos que éste toma. La \fIorden\-para\-obtener\-root\fP puede |
| incluir parámetros, pero no caracteres especiales del intérprete de |
| órdenes. La \fIorden\-para\-obtener\-root\fP puede ser \fBfakeroot\fP, \fBsudo\fP, |
| \fBsuper\fP o \fBreally\fP. \fBsu\fP no es adecuado ya que sólo puede invocar el |
| intérprete de órdenes del usuario con \fB\-c\fP, en lugar de introducir los |
| argumentos individualmente a la orden a ejecutar. |
| .TP |
| \fB\-R\fP\fIfichero\-reglas\fP |
| Habitualmente, construir un paquete de Debian incluye invocar |
| \fBdebian/rules\fP como una orden con varios parámetros estándar. Esta opción |
| posibilita invocar otro programa para construir el paquete (puede incluir |
| parámetros separados por espacios). Por otra parte, se puede usar para |
| ejecutar el fichero de reglas («rules») estándar con otro programa de make |
| (por ejemplo, usando \fB/usr/local/bin/make \-f debian/rules\fP como |
| \fIfichero\-reglas\fP. |
| .TP |
| \fB\-p\fP\fIorden\-para\-firmar\fP |
| Cuando \fBdpkg\-buildpackage\fP necesita ejecutar GPG o PGP para firmar el |
| fichero fuente de control (\fB.dsc\fP) o un fichero \fB.changes\fP, ejecutará |
| \fIorden\-para\-firmar\fP (buscando en \fBPATH\fP si es necesario) en lugar de |
| \fBgpg\fP. \fIorden\-para\-firmar\fP recibirá todos los argumentos que obtendría |
| \fBpgp\fP. Debe usar la opción \fB\-sgpg\fP si la \fIorden\-para\-firmar\fP toma los |
| argumentos en formato GPG en vez de PGP. La \fIorden\-para\-firmar\fP no debe |
| contener espacios ni tampoco caracteres especiales del intérprete de |
| órdenes. |
| .TP |
| \fB\-k\fP\fIllave\-id\fP |
| Especifica una llave de identificación a usar para firmar los paquetes. |
| .TP |
| \fB\-us\fP |
| No firma el paquete fuente. |
| .TP |
| \fB\-uc\fP |
| No firma el fichero \fB.changes\fP. |
| .P |
| \fB\-i\fP[\fIexp\-reg\fP] |
| .br |
| \fB\-I\fP\fI[patrón]\fP |
| .br |
| \fB\-s\fP[\fBnsAkurKUR\fP] |
| .br |
| \fB\-z\fP, \fB\-Z\fP |
| .br |
| .RS |
| Se introduce sin cambios a \fBdpkg\-source\fP. Consulte la página de manual. |
| .RE |
| .TP |
| \fB\-\-source\-option=\fP\fIopción\fP |
| Introduce la opción \fIopción\fP a \fBdpkg\-source\fP. |
| .TP |
| \fB\-\-changes\-option=\fP\fIopción\fP |
| Introduce la opción \fIopción\fP a \fBdpkg\-genchanges\fP. |
| .P |
| \fB\-\-admindir=\fP\fIdirectorio\fP |
| .br |
| \fB\-\-admindir\fP \fIdirectorio\fP |
| .RS |
| Cambia el directorio con la base de datos de \fBdpkg\fP. Por omisión es |
| \fI/var/lib/dpkg\fP. |
| .RE |
| .TP |
| \fB\-h\fP, \fB\-\-help\fP |
| Muestra el modo de uso y termina. |
| .TP |
| \fB\-\-version\fP |
| Muestra la versión y termina. |
| . |
| .SH ENTORNO |
| Even if \fBdpkg\-buildpackage\fP exports some variables, \fBdebian/rules\fP should |
| not rely on their presence and should instead use the respective interface |
| to retrieve the needed values. |
| .SS "Variables definidas por dpkg\-architecture" |
| \fBdpkg\-architecture\fP se invoca con los parámetros \fB\-a\fP y \fB\-t\fP. Toda |
| variable que ofrece una salida mediante su opción \fB\-s\fP se integra en el |
| entorno de construcción. |
| .SS "Compiler flags are no longer exported" |
| Between versions 1.14.17 and 1.16.1, \fBdpkg\-buildpackage\fP exported compiler |
| flags (\fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBFFLAGS\fP, \fBCPPFLAGS\fP and \fBLDFLAGS\fP) with |
| values as returned by \fBdpkg\-buildflags\fP. This is no longer the case. |
| . |
| .SH FALLOS |
| Debería ser posible especificar espacios y caracteres especiales del |
| intérprete de órdenes en los argumentos iniciales de la |
| \fIorden\-para\-obtener\-root\fP y la \fIorden\-para\-firmar\fP. |
| . |
| .SH "VÉASE TAMBIÉN" |
| \fBdpkg\-source\fP(1), \fBdpkg\-architecture\fP(1), \fBdpkg\-buildflags\fP(1), |
| \fBdpkg\-genchanges\fP(1), \fBfakeroot\fP(1), \fBgpg\fP(1). |
| . |
| .SH AUTORES |
| Copyright \(co 1995\-1996 Ian Jackson |
| .br |
| Copyright \(co 2000 Wichert Akkerman |
| .br |
| Copyright \(co 2007 Frank Lichtenheld |
| .br |
| Copyright \(co 2008\-2010 Rapha\[:e]l Hertzog |
| .sp |
| Esto es software libre; vea la versión 2 o posterior de la Licencia Pública |
| General GNU para condiciones de copia. NO hay ninguna garantía. |
| .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. |