dh - Online en la nube

PROGRAMA:

NOMBRE

dh - secuenciador de comandos de debhelper

SINOPSIS

dh secuencia [--con addon[,addon ...]] [--lista] [opciones de debhelper]

DESCRIPCIÓN

dh ejecuta una secuencia de comandos debhelper. El apoyado secuencias corresponden a la
objetivos de un debian / reglas archivo: arco de construcción, construcción independiente, build, limpia, instalar-indep,
instalar-arco, instalar, arco binario, indep binarioy binario.

ANULACIÓN OBJETIVOS

A debian / reglas El uso de archivos dh puede anular el comando que se ejecuta en cualquier paso de una
secuencia, definiendo un objetivo de anulación.

Para anular dh_comando, agregue un objetivo llamado anular_dh_comando al archivo de reglas. Cuando
normalmente correría dh_comando, dh en su lugar, llamará a ese objetivo. El objetivo de anulación puede
luego ejecute el comando con opciones adicionales, o ejecute comandos completamente diferentes en su lugar.
Vea los ejemplos a continuación.

Los destinos de anulación también se pueden definir para que se ejecuten solo cuando se construya una arquitectura dependiente o
paquetes independientes de la arquitectura. Utilice objetivos con nombres como anular_dh_comando-arco
y anular_dh_comando-independiente. (Tenga en cuenta que para utilizar esta función, debe construir-depender de
debhelper 8.9.7 o superior).

CAMPUS

--con addon[,addon ...]
Agregue los comandos debhelper especificados por el complemento dado en los lugares apropiados en el
secuencia de comandos que se ejecuta. Esta opción se puede repetir más de una vez, o
Se pueden enumerar varios complementos, separados por comas. Esto se usa cuando hay un
paquete de terceros que proporciona comandos debhelper. Ver el PROGRAMACIÓN se declara en
documentación sobre la interfaz del complemento de secuencia.

--sin addon
El inverso de --con, deshabilita el uso del complemento dado. Esta opción se puede repetir
más de una vez, o se pueden enumerar varios complementos para deshabilitar, separados por comas.

--lista, -l
Enumere todos los complementos disponibles.

--no actuar
Imprime comandos que se ejecutarían para una secuencia determinada, pero no los ejecuta.

Tenga en cuenta que dh normalmente omite los comandos en ejecución que sabe que no harán nada. Con
--no-act, se imprime la lista completa de comandos en una secuencia.

Otras opciones pasadas a dh se pasan a cada comando que ejecuta. Esto se puede utilizar para configurar
una opción como -v or -X or -N, así como para opciones más especializadas.

EJEMPLOS

Para ver qué comandos se incluyen en una secuencia, sin hacer nada:

dh binary-arch --no-actuar

Este es un archivo de reglas muy simple, para paquetes donde las secuencias de comandos predeterminadas
trabajar sin opciones adicionales.

#!/ usr / bin / make -f
%:
dh $ @

A menudo querrá pasar una opción a un comando debhelper específico. La forma fácil de hacer
con es agregando un destino de anulación para ese comando.

#!/ usr / bin / make -f
%:
dh $ @

anular_dh_strip:
tira_dh -Xfoo

override_dh_auto_configure:
dh_auto_configure - --with-foo --disable-bar

A veces el automatizado dh_auto_configure(1) y dh_auto_build(1) no puedo adivinar qué hacer
por un paquete extraño. A continuación, le mostramos cómo evitar ejecutar cualquiera de ellos y, en su lugar, ejecutar el suyo
comandos.

#!/ usr / bin / make -f
%:
dh $ @

override_dh_auto_configure:
./mondoconfig

override_dh_auto_build:
hacer que el universo explote de placer

Otro caso común es querer hacer algo manualmente antes o después de una determinada
Se ejecuta el comando debhelper.

#!/ usr / bin / make -f
%:
dh $ @

override_dh_fixperms:
dh_fixperms
chmod 4755 debian / foo / usr / bin / foo

Si su paquete usa herramientas automáticas y desea refrescar configuración.sub y config.adivina
versiones más nuevas del autotools-dev paquete en el momento de la compilación, puede utilizar algunos comandos
proporcionada en autotools-dev que lo automatizan, así.

#!/ usr / bin / make -f
%:
dh $ @ --con autotools_dev

Las herramientas de Python no son ejecutadas por dh por defecto, debido al cambio continuo en esa área.
(Antes del nivel de compatibilidad v9, dh se ejecuta dh_pysupport.) Aquí se explica cómo utilizar dh_python2.

#!/ usr / bin / make -f
%:
dh $ @ --con python2

Aquí es cómo forzar el uso de Perl Módulo :: Construir sistema de construcción, que puede ser necesario si
debhelper detecta erróneamente que el paquete utiliza MakeMaker.

#!/ usr / bin / make -f
%:
dh $ @ --buildsystem = perl_build

A continuación se muestra un ejemplo de cómo anular el dh_auto_* los comandos encuentran la fuente del paquete,
para un paquete donde la fuente se encuentra en un subdirectorio.

#!/ usr / bin / make -f
%:
dh $ @ --sourcedirectory = src

Y aquí hay un ejemplo de cómo decirle a la dh_auto_* comandos para construir en un subdirectorio,
que será eliminado en limpia.

#!/ usr / bin / make -f
%:
dh $ @ --builddirectory = build

Si su paquete se puede construir en paralelo, use compat 10 o pase --paralelo
a dh. Luego paquete de compilación dpkg -j trabajará.

#!/ usr / bin / make -f
%:
dh $ @ --paralelo

Si su paquete no se puede construir de manera confiable mientras usa varios subprocesos, pase
--no paralelo a dh (o el relevante dh_auto_* mando):

#!/ usr / bin / make -f
%:
dh $ @ --no-paralelo

He aquí una forma de prevenir dh de ejecutar varios comandos que no desea que se ejecuten,
definiendo objetivos de anulación vacíos para cada comando.

#!/ usr / bin / make -f
%:
dh $ @

# Comandos para no ejecutar:
override_dh_auto_test override_dh_compress override_dh_fixperms:

Un proceso de compilación largo para un paquete de documentación separado se puede separar usando
anulaciones independientes de la arquitectura. Estos se omitirán al ejecutar build-arch y
secuencias de arco binario.

#!/ usr / bin / make -f
%:
dh $ @

override_dh_auto_build-indep:
$ (MAKE) -C docs

# No se necesitan pruebas para los documentos
override_dh_auto_test-indep:

override_dh_auto_install-indep:
$ (MAKE) -C instalación de documentos

Agregando al ejemplo anterior, suponga que necesita modificar un archivo, pero solo al compilar el
paquete dependiente de la arquitectura, ya que no está presente cuando se compila solo documentación.

override_dh_fixperms-arch:
dh_fixperms
chmod 4755 debian / foo / usr / bin / foo

INTERNOS

Si tienes curiosidad por dhinternos, así es como funciona bajo el capó.

Cada comando de debhelper registrará cuando se ejecute correctamente en
debian / package.debhelper.log. (Cuales dh_limpio elimina.) Entonces dh puede decir qué comandos tienen
ya se ha ejecutado, para qué paquetes, y omita la ejecución de esos comandos nuevamente.

Cada vez dh se ejecuta, examina el registro y encuentra el último comando registrado que está en el
secuencia especificada. Luego continúa con el siguiente comando de la secuencia. los --Hasta que,
--antes de, --despuésy --restante Las opciones pueden anular este comportamiento.

Una secuencia también puede ejecutar objetivos dependientes en debian / rules. Por ejemplo, el "binario"
La secuencia ejecuta el destino "instalar".

dh utiliza el DH_INTERNAL_OPCIONES variable de entorno para pasar información a través de
Los comandos de debhelper que se ejecutan dentro de los objetivos de reemplazo. El contenido (y de hecho,
existencia) de esta variable de entorno, como su nombre podría sugerir, está sujeta a cambios
en cualquier momento.

Comandos en el construcción independiente, instalar-indep y indep binario Se pasan las secuencias -i
opción para garantizar que solo funcionen en paquetes independientes de la arquitectura y comandos en el
arco de construcción, instalar-arco y arco binario Se pasan las secuencias -a opción para asegurar que
solo funciona en paquetes que dependen de la arquitectura.

OBSOLETO CAMPUS

Las siguientes opciones están obsoletas. En su lugar, es mucho mejor utilizar objetivos de anulación.
Son no disponible en compat 10.

--Hasta que cmd
Ejecute comandos en la secuencia hasta e incluyendo cmd, luego se detiene.

--antes de cmd
Ejecute comandos en la secuencia anterior cmd, luego se detiene.

--después cmd
Ejecute comandos en la secuencia que sigue cmd.

--restante
Ejecute todos los comandos en la secuencia que aún no se han ejecutado.

En las opciones anteriores, cmd puede ser un nombre completo de un comando debhelper o una subcadena. Será
Primero busque un comando en la secuencia que coincida exactamente con el nombre, para evitar cualquier
ambigüedad. Si hay varias coincidencias de subcadenas, la última de la secuencia será
usado.

Utilice dh en línea utilizando los servicios de onworks.net