dh - Online w chmurze

PROGRAM:

IMIĘ

dh - debhelper sekwencer poleceń

STRESZCZENIE

dh sekwencja [--z addon[,addon ...]] [--lista] [opcje debhelpera]

OPIS

dh uruchamia sekwencję poleceń debhelper. Obsługiwane sekwencjas odpowiadają
cele A debian/zasady file: budowanie łuku, kompilacja niezależna, budować, kleń, instalacja niezależna,
instalacja arch, zainstalować, binarny-arch, binarna niezależna, dwójkowy.

NADPISANIE CELE

A debian/zasady plik za pomocą dh może przesłonić polecenie, które jest uruchamiane w dowolnym kroku w a
sekwencji, definiując nadpisany cel.

Przekroczyć dh_polecenie, dodaj cel o nazwie nadpisanie_dh_polecenie do pliku reguł. Kiedy to
normalnie biegałbym dh_polecenie, dh zamiast tego wywoła ten cel. Nadrzędny cel może:
następnie uruchom polecenie z dodatkowymi opcjami lub uruchom zupełnie inne polecenia.
Zobacz przykłady poniżej.

Nadrzędne cele można również zdefiniować tak, aby działały tylko wtedy, gdy budowanie jest zależne od architektury lub
pakiety niezależne od architektury. Użyj celów o nazwach takich jak nadpisanie_dh_polecenie-łuk
i nadpisanie_dh_polecenie-niezależna. (Pamiętaj, że aby korzystać z tej funkcji, powinieneś
debhelper 8.9.7 lub nowszy.)

OPCJE

--z addon[,addon ...]
Dodaj polecenia debhelper określone przez dany dodatek w odpowiednich miejscach w
sekwencja uruchamianych poleceń. Ta opcja może być powtórzona więcej niż raz lub
można wymienić wiele dodatków, oddzielonych przecinkami. Jest to używane, gdy istnieje
pakiet innej firmy, który udostępnia polecenia debhelper. Zobacz PROGRAMOWANIE plik dla
dokumentacja dotycząca interfejsu dodatku do sekwencji.

--z pominięciem addon
Odwrotność --z, wyłącza korzystanie z danego dodatku. Tę opcję można powtórzyć
więcej niż jeden raz lub można wymienić wiele dodatków do wyłączenia, oddzielonych przecinkami.

--lista, -l
Wymień wszystkie dostępne dodatki.

--brak działania
Wyświetla polecenia, które zostałyby uruchomione dla danej sekwencji, ale ich nie uruchamia.

Zauważ, że dh zwykle pomija uruchamiane polecenia, o których wie, że nic nie zrobią. Z
--no-act, wypisywana jest pełna lista poleceń w sekwencji.

Inne opcje przekazane do dh są przekazywane do każdego uruchamianego polecenia. Można to wykorzystać do ustawienia
opcja taka jak -v or -X or -N, a także bardziej wyspecjalizowane opcje.

PRZYKŁADY

Aby zobaczyć, jakie polecenia są zawarte w sekwencji, bez robienia czegokolwiek:

dh binarny-arch --no-act

Jest to bardzo prosty plik reguł, dla pakietów, w których domyślne sekwencje poleceń
pracować bez dodatkowych opcji.

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

Często będziesz chciał przekazać opcję do konkretnego polecenia debhelper. Łatwy sposób na zrobienie
with polega na dodaniu celu nadpisania dla tego polecenia.

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

override_dh_strip:
dh_strip -Xfoo

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

Czasami zautomatyzowane dh_auto_configure(1) i dh_auto_build(1) nie mogę odgadnąć, co robić
za dziwny pakiet. Oto jak uniknąć biegania i zamiast tego prowadzić własną
Polecenia.

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

override_dh_auto_configure:
./mondoconfig

override_dh_auto_build:
spraw, aby wszechświat-eksplodował-w-zachwytem

Innym częstym przypadkiem jest chęć zrobienia czegoś ręcznie przed lub po konkretnym
uruchomiono polecenie debhelper.

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

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

Jeśli Twój pakiet korzysta z autotools i chcesz się odświeżyć konfiguracja.sub i konfiguracja.zgadnij w
nowsze wersje z autotools-dev pakiet w czasie kompilacji, możesz użyć niektórych poleceń
opatrzony w autotools-dev które to automatyzują, w ten sposób.

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

Narzędzia Pythona nie są domyślnie uruchamiane przez dh ze względu na ciągłe zmiany w tym obszarze.
(Przed poziomem zgodności v9 dh działa dh_pysupport.) Oto jak używać dh_python2.

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

Oto jak wymusić użycie Perla Moduł::Budowa zbudować system, który może być konieczny, jeśli
debhelper błędnie wykrywa, że ​​pakiet używa MakeMakera.

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

Oto przykład zastępowania miejsca, w którym dh_auto_* komendy odnajdują źródło pakietu,
dla pakietu, w którym źródło znajduje się w podkatalogu.

#!/usr/bin/make -f
%:
dh $@ --katalog_źródłowy=źródło

A oto przykład, jak powiedzieć dh_auto_* komendy do wbudowania w podkatalog,
który zostanie usunięty w dniu kleń.

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

Jeśli twój pakiet można zbudować równolegle, użyj kompatybilności 10 lub pass --równoległy
do dh. Następnie dpkg-buildpackage -j będzie działać.

#!/usr/bin/make -f
%:
dh $@ --równoległy

Jeśli Twój pakiet nie może być zbudowany niezawodnie przy użyciu wielu wątków, proszę przejść
--no-równoległe do dh (lub odpowiedni dh_auto_* Komenda):

#!/usr/bin/make -f
%:
dh $@ --nie-równoległy

Oto sposób na zapobieganie dh od uruchomienia kilku poleceń, których nie chcesz, aby były uruchamiane,
definiując puste cele nadpisania dla każdego polecenia.

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

# Polecenia, których nie można uruchomić:
override_dh_auto_test override_dh_compress override_dh_fixperms:

Długi proces budowania osobnego pakietu dokumentacji można oddzielić za pomocą
nadpisania niezależne od architektury. Zostaną one pominięte podczas uruchamiania build-arch i
sekwencje łuków binarnych.

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

override_dh_auto_build-indep:
$(MAKE) -C dokumenty

# Żadne testy nie są potrzebne dla dokumentów
override_dh_auto_test-indep:

override_dh_auto_install-indep:
$(MAKE) -C instalacja dokumentów

Dodając do powyższego przykładu, załóżmy, że musisz chmod plik, ale tylko podczas budowania
pakiet zależny od architektury, ponieważ nie jest obecny podczas budowania tylko dokumentacji.

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

wewnętrzne

Jeśli jesteś ciekawy dhwnętrze, oto jak to działa pod maską.

Każde polecenie debhelper będzie rejestrować, kiedy zostanie pomyślnie uruchomione
debian/pakiet.debhelper.log. (Który dh_czysty usuwa.) Więc dh może powiedzieć, które polecenia mają
zostały już uruchomione, dla których pakietów i pomiń ponowne uruchamianie tych poleceń.

Za każdym razem dh jest uruchamiany, sprawdza dziennik i znajduje ostatnie zarejestrowane polecenie, które znajduje się w
określoną sekwencję. Następnie kontynuuje wykonywanie następnego polecenia w sekwencji. ten --dopóki,
--przed, --po, --pozostały opcje mogą zastąpić to zachowanie.

Sekwencja może również uruchamiać cele zależne w debian/rules. Na przykład „binarny”
sekwencja uruchamia cel "instalacji".

dh używa DH_INTERNAL_OPTIONS zmienna środowiskowa do przekazywania informacji do
komendy debhelper, które są uruchamiane wewnątrz przesłoniętych celów. Treść (i rzeczywiście
istnienie) tej zmiennej środowiskowej, jak nazwa może sugerować, może ulec zmianie
kiedykolwiek.

Polecenia w kompilacja niezależna, instalacja niezależna i binarna niezależna sekwencje są przekazywane -i
opcja zapewniająca, że ​​działają tylko z pakietami niezależnymi od architektury i poleceniami w
budowanie łuku, instalacja arch i binarny-arch sekwencje są przekazywane -a możliwość zapewnienia ich
działa tylko na pakietach zależnych od architektury.

ODRADZANA OPCJE

Następujące opcje są przestarzałe. Dużo lepiej jest zamiast tego używać przesłoniętych celów.
Są nie dostępny w komp. 10.

--dopóki cmd
Uruchom polecenia w sekwencji do czasu włącznie cmd, Wtedy się zatrzymaj.

--przed cmd
Uruchom polecenia w kolejności przed cmd, Wtedy się zatrzymaj.

--po cmd
Uruchamiaj polecenia w kolejności następującej po cmd.

--pozostały
Uruchom wszystkie polecenia w sekwencji, które jeszcze nie zostały uruchomione.

W powyższych opcjach cmd może być pełną nazwą polecenia debhelper lub podciągiem. Będzie
najpierw wyszukaj polecenie w sekwencji dokładnie pasującej do nazwy, aby uniknąć jakichkolwiek
Dwuznaczność. Jeśli istnieje wiele dopasowań podciągów, ostatnim w sekwencji będzie
używany.

Korzystaj z dh online za pomocą usług onworks.net