dh - Интернет в облаке

ПРОГРАММА:

ИМЯ

dh - секвенсор команд debhelper

СИНТАКСИС

dh последовательность [--с участием Аддон[,Аддон ...]] [--список] [параметры debhelper]

ОПИСАНИЕ

dh запускает последовательность команд debhelper. Поддерживаемый последовательностьs соответствуют
цели debian / rules файл: строить арку, строить, строить, чистым, установка-независимо,
установка-арка, устанавливать, двоичная арка, двоичный индекскачества двоичный.

ПЕРЕОПРЕДЕЛЕНИЕ ЦЕЛЕВЫЕ

A debian / rules файл с помощью dh может переопределить команду, выполняемую на любом этапе
последовательность, определяя цель переопределения.

Переопределить dh_command, добавьте цель с именем переопределить_dh_command в файл правил. Когда это
обычно работает dh_command, dh вместо этого вызовет эту цель. Цель переопределения может
затем запустите команду с дополнительными параметрами или вместо этого выполните совершенно другие команды.
См. Примеры ниже.

Цели переопределения также могут быть определены для запуска только в том случае, если построение зависит от архитектуры или
независимые от архитектуры пакеты. Используйте цели с такими именами, как переопределить_dh_command-арх
и переопределить_dh_command-независимый. (Обратите внимание, что для использования этой функции вы должны использовать Build-Depend on
debhelper 8.9.7 или более поздней версии.)

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--с участием Аддон[,Аддон ...]
Добавьте команды debhelper, указанные в данном надстройке, в соответствующие места в
последовательность выполняемых команд. Эта опция может повторяться более одного раза, или
несколько дополнений могут быть перечислены через запятую. Это используется, когда есть
сторонний пакет, который предоставляет команды debhelper. Увидеть ПРОГРАММИРОВАНИЕ файл для
документация об интерфейсе аддона последовательности.

--без Аддон
Обратное --с участием, отключает использование данного дополнения. Этот вариант можно повторить
может быть указано более одного раза или несколько надстроек, которые нужно отключить, через запятую.

--список, -l
Список всех доступных дополнений.

- не действовать
Печатает команды, которые будут выполняться для данной последовательности, но не запускает их.

Обратите внимание, что dh обычно пропускает запущенные команды, которые, как ему известно, ничего не сделают. С участием
--no-act, выводится полный список команд в последовательности.

Другие варианты переданы в dh передаются каждой выполняемой команде. Это можно использовать для установки
такой вариант, как -v or -X or -N, а также для более специализированных вариантов.

ПРИМЕРЫ

Чтобы увидеть, какие команды включены в последовательность, ничего не делая:

dh двоичная-арка --no-act

Это очень простой файл правил для пакетов, в которых последовательность команд по умолчанию
работать без дополнительных опций.

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

Часто вам нужно передать параметр определенной команде debhelper. Легкий способ сделать
with - это добавление цели переопределения для этой команды.

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

override_dh_strip:
dh_strip -Xfoo

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

Иногда автоматизированный dh_auto_configure(1) и dh_auto_build(1) не могу угадать, что делать
за странный пакет. Вот как избежать бега и вместо этого запустить свой собственный
команды.

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

override_dh_auto_configure:
./мондоконфиг

override_dh_auto_build:
заставить вселенную взорваться от восторга

Другой распространенный случай - это желание сделать что-то вручную до или после определенного
Команда debhelper запущена.

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

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

Если в вашем пакете используются автоинструменты и вы хотите освежить config.sub и config.угадай
более новые версии из autotools-dev пакет во время сборки, вы можете использовать некоторые команды
предоставляется в autotools-dev которые автоматизируют это, вот так.

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

Инструменты Python не запускаются dh по умолчанию из-за постоянных изменений в этой области.
(До уровня совместимости v9 dh запускается dh_pysupport.) Вот как использовать dh_python2.

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

Вот как заставить использовать Perl Модуль :: Сборка система сборки, которая может понадобиться, если
debhelper ошибочно определяет, что пакет использует MakeMaker.

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

Вот пример переопределения, когда dh_auto_* команды находят источник пакета,
для пакета, исходный код которого находится в подкаталоге.

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

А вот пример того, как сказать dh_auto_* команды для создания подкаталога,
который будет удален чистым.

#!/ usr / bin / make -f
%:
dh $ @ --builddirectory = сборка

Если ваш пакет может быть собран параллельно, используйте compat 10 или передайте --параллельно
к dh. потом dpkg-buildpackage -j будет работать.

#!/ usr / bin / make -f
%:
dh $ @ --параллельно

Если ваш пакет не может быть надежно построен при использовании нескольких потоков, пожалуйста, передайте
- непараллельный к dh (или соответствующий dh_auto_* команда):

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

Вот способ предотвратить dh от запуска нескольких команд, которые вы не хотите запускать,
путем определения пустых целей переопределения для каждой команды.

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

# Команды, которые нельзя запускать:
override_dh_auto_test override_dh_compress override_dh_fixperms:

Длинный процесс сборки для отдельного пакета документации можно разделить с помощью
независимые от архитектуры переопределения. Они будут пропущены при запуске build-arch и
двоично-арочные последовательности.

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

override_dh_auto_build-indep:
$ (СДЕЛАТЬ) -C документы

# Никаких тестов для документов не требуется
override_dh_auto_test-indep:

override_dh_auto_install-indep:
$ (MAKE) -C установить документы

Добавляя к приведенному выше примеру, предположим, что вам нужно изменить файл chmod, но только при создании
пакет, зависящий от архитектуры, поскольку его нет при сборке только документации.

override_dh_fixperms-архив:
dh_fixperms
chmod 4755 debian / foo / usr / bin / foo

ВНУТРЕННИЕ

Если тебе интересно dhвнутренности, вот как это работает под капотом.

Каждая команда debhelper будет записывать, когда она успешно запущена в
debian / package.debhelper.log. (Который dh_clean удаляет.) Итак dh может сказать, какие команды имеют
уже был запущен, для каких пакетов, и пропустите повторный запуск этих команд.

Каждый раз dh запущен, он исследует журнал и находит последнюю зарегистрированную команду, которая находится в
указанная последовательность. Затем он переходит к следующей команде в последовательности. В --до,
--до, --послекачества --осталось параметры могут переопределить это поведение.

Последовательность также может запускать зависимые цели в debian / rules. Например, «двоичный»
Последовательность запускает цель «установить».

dh использует DH_INTERNAL_OPTIONS переменная среды для передачи информации
Команды debhelper, выполняемые внутри целей переопределения. Содержание (и действительно,
Существование) этой переменной окружения, как следует из названия, может быть изменено
в любое время.

Команды в строить, установка-независимо и двоичный индекс последовательности передаются -i
вариант, чтобы гарантировать, что они работают только с архитектурно-независимыми пакетами, и команды в
строить арку, установка-арка и двоичная арка последовательности передаются -a возможность убедиться, что они
работает только с пакетами, зависящими от архитектуры.

DEPRECATED ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Следующие параметры устарели. Вместо этого гораздо лучше использовать цели переопределения.
Они не доступно в совместимости 10.

--до CMD
Запускайте команды в последовательности до включительно CMD, затем остановись.

--до CMD
Выполните команды в последовательности до CMD, затем остановись.

--после CMD
Выполняйте команды в последовательности, следующей за CMD.

--осталось
Выполните все команды в последовательности, которые еще предстоит выполнить.

В приведенных выше вариантах CMD может быть полным именем команды debhelper или подстрокой. Это будет
сначала найдите команду в последовательности, точно соответствующей имени, чтобы избежать
двусмысленность. Если есть несколько совпадений подстрок, последняя в последовательности будет
используемый.

Используйте dh онлайн с помощью сервисов onworks.net