dh - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

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

СИНТАКСИС

dh послідовність [--з аддон[,аддон ...]] [-- список] [параметри debhelper]

ОПИС

dh запускає послідовність команд debhelper. Підтримані послідовністьs відповідають
цілі а debian/правила Файл: будувати-арку, побудувати indep, будувати, очистити, встановити-незалежний,
установка-арка, встановлювати, бінарно-арх, бінарно-незалежний та двійковий.

ОБЕРЕЖИТИ ЦІЛІ

A debian/правила файл, використовуючи dh може замінити команду, яка виконується на будь-якому кроці в a
послідовності, визначивши цільову перевизначення.

Для заміни dh_command, додайте ціль з іменем override_dh_command до файлу правил. Коли це
зазвичай бігав би dh_command, dh замість цього викличе цю ціль. Ціль перевизначення може
потім запустіть команду з додатковими параметрами або замість них запустіть зовсім інші команди.
Дивіться приклади нижче.

Цілі заміни також можуть бути визначені для запуску лише тоді, коли архітектура залежить або
архітектурно незалежні пакети. Використовуйте цілі з іменами, як override_dh_command-арх
та override_dh_command-індеп. (Зверніть увагу, що для використання цієї функції вам слід Build-Depend on
debhelper 8.9.7 або вище.)

ВАРІАНТИ

--з аддон[,аддон ...]
Додайте команди debhelper, визначені даним аддоном, у відповідні місця в файлі
послідовність команд, що виконується. Цей варіант можна повторити більше одного разу, або
можна перерахувати кілька доповнень, розділених комами. Це використовується, коли є a
сторонній пакет, який надає команди debhelper. Див ПРОГРАМУВАННЯ файл для
документація про інтерфейс додатка послідовності.

--без аддон
Зворотне значення --з, вимикає використання даного аддона. Цей варіант можна повторити
більше одного разу, або кілька додатків для вимкнення можуть бути перераховані, розділені комами.

-- список, -l
Перелік усіх доступних доповнень.

--ні дії
Друкує команди, які будуть виконуватися для заданої послідовності, але не виконує їх.

Зауважте, що dh зазвичай пропускає запущені команди, які, як він знає, нічого не дадуть. З
--no-act, виводиться повний список команд у послідовності.

Інші варіанти перейшли до dh передаються кожній команді, яку вона виконує. Це можна використовувати для встановлення
такий варіант, як -v or -X or -N, а також для більш спеціалізованих варіантів.

ПРИКЛАДИ

Щоб побачити, які команди включені в послідовність, фактично нічого не роблячи:

dh binary-arch --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:
./mondoconfig

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.guess з
новіші версії від 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=build

Якщо ваш пакет можна створити паралельно, будь ласка, використовуйте compat 10 або перейдіть --паралельний
до dh. Тоді dpkg-buildpackage -j буду працювати.

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

Якщо ваш пакунок не може бути надійно створений під час використання кількох потоків, будь ласка, передайте
--не паралельно до dh (або відповідного dh_auto_* команда):

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

Ось спосіб запобігти 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:
$(MAKE) -C документи

# Для документів не потрібні тести
override_dh_auto_test-indep:

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

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

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

ВНУТРІШНІСТЬ

Якщо вам цікаво dh's внутрішніх частин, ось як це працює під капотом.

Кожна команда debhelper записуватиметься, коли вона буде успішно виконана
debian/package.debhelper.log. (Який dh_clean видаляє.) Отже dh може визначити, які команди мають
вже запущено, для яких пакетів, і пропустіть виконання цих команд знову.

Щоразу dh запущено, він перевіряє журнал і знаходить останню зареєстровану команду, яка знаходиться в
зазначену послідовність. Потім він продовжується наступною командою в послідовності. The --доки,
--до того, --після та --залишається параметри можуть замінити цю поведінку.

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

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

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

ЗНИЖЕНИЙ ВАРІАНТИ

Наступні параметри не підтримуються. Набагато краще замість цього використовувати цілі заміни.
Вони НЕ доступний у compat 10.

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

--до того CMD
Виконайте команди в попередній послідовності CMD, потім зупинись.

--після CMD
Виконайте команди в наступній послідовності CMD.

--залишається
Виконайте всі команди в послідовності, яку ще потрібно виконати.

У наведених вище варіантах, CMD може бути повною назвою команди debhelper або підрядком. Це буде
спочатку знайдіть команду в послідовності, яка точно відповідає назві, щоб уникнути будь-яких
двозначність. Якщо є кілька збігів підрядка, останній у послідовності буде
використаний

Використовуйте dh онлайн за допомогою служб onworks.net