Linux Certif

Toute la documentation sur la certification Linux LPI

dpkg-buildpackage

NAZWA

dpkg-buildpackage - buduje pakiety Œród³owe lub binarne ze Œróde³

SK£ADNIA

dpkg-buildpackage [opcje]

OPIS

dpkg-buildpackage jest skryptem kontrolnym, którego mo¿na u¿yæ do zautomatyzowania budowania pakietu.

OPCJE

-b

Okre¶la budowanie tylko pakietów binarnych, ¿adne pliki Œród³owe nie bêd± budowane ani dystrybuowane

-B

Okre¶la budowanie tylko pakietów binarnych, bez dystrybuowania ¿adnych pakietów binarnych niezale¿nych od architektury.

-S

Okre¶la budowanie tylko pakietów Œród³owych, bez budowania pakietów binarnych.

Opcje -sx okre¶laj±, czy do wydania do³±czane s± oryginalne pliki Œród³owe, je¿eli zostanie wygenerowany choæ jeden z nich (tj. nie u¿yto opcji -b lub -B).

-si

Domy¶lnie lub je¶li to okre¶lono, oryginalne Œród³a bêd± do³±czone tylko je¶li numer oryginalnej wersji autora programu (tzn. wersja bez epoki i bez numeru rewizji Debiana) ró¿ni siê od numeru wersji autora programu z poprzedniego wpisu dziennika zmian.

-sa

Wymusza do³±czenie oryginalnych Œróde³.

-sd

Wymusza pominiêcie oryginalnych Œróde³ i do³±czenie tylko pliku ró¿nic (diff).

-aarchitektura

Okre¶la architekturê Debiana dla której jest budowany pakiet. Architektura komputera, na której jest budowany pakiet, jest okre¶lana automatycznie i stanowi równie¿ domy¶ln± architekturê docelow±.

Je¶li architektura docelowa ró¿ni siê od architektury u¿ywanej podczas budowania (jak ma to miejsce przy kompilacji skro¶nej), oraz je¶li zmienna ¶rodowiska PKG_CONFIG_LIBDIR nie jest ustawiona, wtedy jest ustawiana na warto¶æ nadaj±c± siê do kompilacji skro¶nej ("/usr/typ-systemu-gnu/lib/pkgconfig/:/usr/share/pkgconfig").

-ttyp-systemu-gnu

Okre¶la typ systemu GNU, dla którego budujemy. Mo¿e byæ u¿yte zamiast -a lub jako uzupe³nienie do nadpisania domy¶lnego typu systemu GNU docelowej architektury Debiana.

-jzadania

Liczba zadañ, które mog± zostaæ równocze¶nie uruchomione, odpowiednik opcji make(1) o tej samej nazwie. Dodaje siê do zmiennej ¶rodowiskowej MAKEFLAGS, co powinno spowodowaæ, ¿e wszystkie kolejne wywo³ania programu make odziedzicz± tê opcjê. Tak¿e dodaje parallel=zadania do zmiennej ¶rodowiskowej DEB_BUILD_OPTIONS, co pozwala plikom debian/rules na korzystanie z tej informacji dla ich w³asnych celów.Warto¶æ parallel=zadania zmiennej ¶rodowiska DEB_BUILD_OPTIONS nadpisze warto¶æ przekazan± w opcji -j, je¶li j± podano.

-vwersja

U¿ywa informacji z dziennika zmian ze wszystkich wersji póŒniejszych ni¿ wersja.

-Copis_zmian

Czyta opis zmian z pliku opis_zmian, zamiast u¿ywaæ informacji z dziennika zmian z katalogu ze Œród³ami.

-madres opiekuna

U¿ywa adresu_opiekuna jako nazwy i adresu e-mail opiekuna tego pakietu, zamiast pobieraæ te warto¶ci z pliku kontrolnego z katalogu ze Œród³ami.

-eadres_opiekuna

U¿ywa adresu_opiekuna jako nazwy i adresu e-mail opiekuna tego wydania, zamiast pobieraæ te warto¶ci z dziennika zmian z katalogu ze Œród³ami.

-D

Sprawdza zale¿no¶ci i konflikty czasu budowania, przerywa dzia³anie z b³êdem, je¿eli nie bêd± spe³nione.

-d

Nie sprawdza zale¿no¶ci czasu budowania ani konfliktów.

-E

Przekszta³ca pewne ostrze¿enia w b³êdy. Tylko dpkg-source u¿ywa tej opcji, jednak¿e dpkg-buildpackage rozpoznaje j± i przekazuje niezmienion± do dpkg-source.

-W

Neguje poprzednio ustawione -E. Tylko dpkg-source u¿ywa tej opcji, jednak¿e dpkg-buildpackage rozpoznaje j± i przekazuje niezmienion± do dpkg-source.

-nc

Nie czy¶ci katalogu ze Œród³ami (implikuje -b).

-tc

Po zbudowaniu pakietu czy¶ci katalog ze Œród³ami (u¿ywaj±c gain-root-command debian/rules clean).

-rpolecenie-uzyskiwania-praw-administratora

Kiedy dpkg-buildpackage potrzebuje wykonaæ czê¶æ procesu budowania jako administrator, poprzedza wykonywane polecenia poleceniem-uzyskiwania-praw-administratora, je¶li takowe zosta³o podane. Je¶li natomiast nie zosta³o podane, zostanie domy¶lnie u¿yte polecenie fakeroot, o ile jest dostêpne. polecenie-uzyskiwania-praw-administratora powinno zaczynaæ siê nazw± programu dostêpnego przez zmienn± systemow± PATH, któremu bêd± przekazywane argumenty w postaci w³a¶ciwego programu do wykonania oraz jego parametrów. polecenie-uzyskiwania-praw-administratora mo¿e samo zawieraæ parametry (musz± byæ one rozdzielone spacjami), ale nie mo¿e zawieraæ metaznaków pow³oki. poleceniem-uzyskiwania-praw-administratora mog± typowo byæ fakeroot, sudo, super lub really. su nie nadaje siê do tego celu, poniewa¿ mo¿e tylko wywo³aæ pow³okê u¿ytkownika u¿ywaj±c -c zamiast przekazywaæ indywidualnie argumenty dla polecenia do wykonania.

-Rplik_rules

Budowanie pakietu Debiana zwykle wymaga wywo³ania debian/rules jako polecenia z kilkoma standardowymi parametrami. U¿ywaj±c tej opcji mo¿na podaæ wywo³anie innego programu, który pos³u¿y do zbudowania pakietu (mo¿e tak¿e zawieraæ dodatkowe parametry rozdzielone spacjami). Mo¿e byæ tak¿e u¿yta do wykonania standardowego pliku regu³ z u¿yciem innego programu make (np. podaj±c /usr/local/bin/make -f debian/rules jako plik_rules).

-ppolecenie-podpisywania

Gdy dpkg-buildpackage bêdzie potrzebowa³ wywo³aæ GPG lub PGP aby podpisaæ plik kontrolny Œróde³ (.dsc) lub plik .changes, zostanie uruchomione polecenie-podpisywania (w razie konieczno¶ci przeszukuj±c PATH) zamiast pgp. Parametry normalnie przekazywane do pgp zostan± przekazane do polecenia-podpisywania. Je¶li polecenie-podpisywania przyjmuje argumenty w stylu GPG zamiast atylu PGP, nale¿y u¿yæ opcji -sgpg. polecenie-podpisywania nie powinno zawieraæ spacji ani innych metaznaków pow³oki.

-kid-klucza

Okre¶la ID klucza u¿ywanego do podpisywania pakietów.

-us

Nie próbuje podpisywaæ pakietów.

-uc

Nie próbuje podpisywaæ plików .changes.

-i[wyra¿_regularne]

Przekazywana bez zmian do dpkg-source.

-I[wzorzec]

Przekazywana bez zmian do dpkg-source. Mo¿e byæ powtórzona wiele razy.

-s[nsAkurKUR]

Przekazywana bez zmian do dpkg-source.

-z, -Z

Przekazywana bez zmian do dpkg-source.

--admindir=katalog

Zmienia po³o¿enie bazy danych dpkg. Domy¶lnie jest to /var/lib/dpkg.

-h, --help

Wy¶wietla informacjê o u¿ytkowaniu i koñczy dzia³anie.

--version

Wy¶wietla informacjê o wersji i pomy¶lnie koñczy dzia³anie.

ŠRODOWISKO

Odpowiednie zmienne ¶rodowiska do okre¶lania opcji kompilatora i linkera s± ustawiane na warto¶ci domy¶lne, chyba ¿e ju¿ s± ustawione w ¶rodowisku. Nale¿y zauwa¿yæ, ¿e ten mechanizm zosta³ wprowadzony dopiero w wersji 1.14.17 dpkg-dev i jeszcze nie wszystkie pliki rules i narzêdzia do budowania pakietów honoruj± te zmienne.

CFLAGS

Opcje optymalizacji, które s± przekazywane do systemu budowania Debiana i mog±/powinny byæ nadpisane przy budowaniu pakietu je¶li jest to potrzebne (warto¶æ domy¶lna: -g -O2, lub -g -O0 je¶li opcja noopt jest podana w DEB_BUILD_OPTIONS). Nadpisywanie opcji mo¿e byæ u¿yte w celu ustawienia wy¿szego poziomu optymalizacji lub radzenia sobie z b³êdami kompilatora, które pojawiaj± siê przy niektórych poziomach optymalizacji (poziom okre¶lony w ostatniej opcji "zwyciê¿a").

CFLAGS_APPEND

Opcje optymalizacji dodawane do flag kompilatora, które nie mog± byæ nadpisane przez pakiet (g³ównie u¿ywane dla testów budowania). Warto¶æ domy¶lna: puste.

CXXFLAGS

To samo co CFLAGS dla Œróde³ C++.

CXXFLAGS_APPEND

To samo co CFLAGS_APPEND dla Œróde³ C++.

FFLAGS

To samo co CFLAGS dla Œróde³ w Fortranie.

FFLAGS_APPEND

To samo co CFLAGS_APPEND dla Œróde³ w Fortranie.

CPPFLAGS

Flagi preprocesora, które s± przekazywane do systemu budowania Debiana i mog±/powinny byæ nadpisane przy budowaniu pakietu je¶li jest to potrzebne (warto¶æ domy¶lna: puste). To makro jest rzadko stosowane (wiêkszo¶æ systemów budowania u¿ywa po prostu CFLAGS zamiast CPPFLAGS).

CPPFLAGS_APPEND

Flagi dodawane do flag preprocesora, które nie mog± byæ nadpisane przez pakiet (g³ównie u¿ywane dla testów budowania). Warto¶æ domy¶lna: puste.

LDFLAGS

Opcje przekazywane do kompilatora podczas ³±czenia plików wykonywalnych lub wspó³dzielonych bibliotek (je¶li linker jest wywo³ywany bezpo¶rednio, -Wl i , musz± byæ usuniête z tych opcji). Warto¶æ domy¶lna: puste.

LDFLAGS_APPEND

Opcje optymalizacji dodawane do flag kompilatora podczas ³±czenia kodu, które nie mog± byæ nadpisane przez pakiet (g³ównie u¿ywane dla testów budowania). Warto¶æ domy¶lna: puste.

B£ÊDY

Powinno byæ mo¿liwe podanie spacji, metaznaków pow³oki oraz argumentów dla gain-root-command oraz sign-command.

ZOBACZ TAK¯E

dpkg-source(1), dpkg-architecture(1), dpkg-genchanges(1), gpg(1), pgp(1).

AUTORZY

Copyright (C) 1995-1996 Ian Jackson
Copyright (C) 2000 Wichert Akkerman
Copyright (C) 2007 Frank Lichtenheld

Niniejszy program jest oprogramowaniem wolnym, sprawdŒ Powszechn± Licencjê Publiczn± GNU w wersji drugiej lub póŒniejszej, by dowiedzieæ siê o warunkach dystrybucji. Brak JAKIEJKOLWIEK gwarancji.

T£UMACZE

Piotr Roszatycki <dexter@debian.org>, 1999
Bartosz Feñski <fenio@debian.org>, 2004-2005
Robert Luberda <robert@debian.org>, 2006-2008
Wiktor Wandachowicz <siryes@gmail.com>, 2008