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 programem automatyzuj±cym proces budowania pakietu Debiana. Proces ten sk³ada siê z nastêpuj±cych kroków:

1.

It prepares the build environment by setting various environment variables (see ENVIRONMENT) and calls dpkg-source --before-build (unless -T or --target has been used).

2.

Sprawdza czy zale¿no¶ci i konflikty czasu budowania s± spe³nione (o ile nie jest podane -d).

3.

Je¶li okre¶lony cel zosta³ wskazany z u¿yciem opcji -T lub --target, wywo³uje ten cel i na tym koñczy. W przeciwnym wypadku wywo³uje fakeroot debian/rules clean, aby wyczy¶ciæ drzewo budowania pakietu (chyba ¿e u¿yje siê opcji -nc).

4.

It calls dpkg-source -b to generate the source package (unless a binary-only build has been requested with -b, -B or -A).

5.

Wywo³uje debian/rules build, a nastêpnie fakeroot debian/rules binary-target (chyba ¿e ¿±dano tylko zbudowania pakietu Œród³owego, podaj±c opcjê -S). Proszê zauwa¿yæ, ¿e binary-target ma warto¶æ binary (domy¶lnie, lub gdy podano -b), binary-arch (je¶li podano -B) lub binary-indep (je¶li podano -A).

6.

Wywo³uje gpg aby podpisaæ plik .dsc (je¶li jest, chyba ¿e podano opcjê -us).

7.

Wywo³uje dpkg-genchanges aby wygenerowaæ plik .changes. Do dpkg-genchanges przekazywanych jest wiele opcji dpkg-buildpackage.

8.

Wywo³uje gpg aby podpisaæ plik .changes (chyba ¿e podano opcjê -uc).

9.

If -tc is specified, it will call fakeroot debian/rules clean again. Finally it calls dpkg-source --after-build.

OPCJE

-b

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

-B

Okre¶la budowanie tylko pakietów binarnych, ograniczone do pakietów zale¿nych od architektury. Przekazywane do dpkg-genchanges.

-A

Okre¶la budowanie tylko pakietów binarnych, ograniczone do pakietów niezale¿nych od architektury. Przekazywane do dpkg-genchanges.

-S

Okre¶la budowanie tylko pakietów Œród³owych, bez budowania pakietów binarnych. Przekazywane do dpkg-genchanges.

-F

Specifies a normal full build, binary and source packages will be built. This is the same as the default case when no build option is specified.

--target=cel
--target cel
-Tcel

Wywo³uje debian/rules cel po przygotowaniu ¶rodowiska budowania i na tym koñczy proces budowania pakietu. Je¶li podana zosta³a równie¿ opcja --as-root, wtedy polecenie to jest wykonywane z prawami administratora. Proszê zauwa¿yæ, ¿e cele oficjalnie okre¶lone w Polityce Debiana jako wymagaj±ce uruchamiania z prawami administratora nie wymagaj± tej opcji.

--as-root

Znacz±ca jedynie w po³±czeniu z opcj± --target. Wymusza uruchomienie celu z prawami administratora.

-si
-sa
-sd
-vwersja
-Copis_zmian
-madres opiekuna
-eadres_opiekuna

Przekazywana bez zmian do dpkg-genchanges. Wiêcej informacji na stronie podrêcznika tego programu.

-aarchitektura

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

-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 nadpisuje warto¶æ przekazan± w opcji -j, je¶li zosta³a ona podana.

-D

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

-d

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

-nc

Pomija czyszczenie drzewa Œróde³ pakietu (implikuje -b, je¶li nic innego nie zosta³o wybrane spo¶ród -B, -A oraz -S).

-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 gpg. 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]
-I[wzorzec]
-s[nsAkurKUR]
-z, -Z

Przekazywana bez zmian do dpkg-source. Wiêcej informacji na stronie podrêcznika tego programu

--source-option=opt

Pass option opt to dpkg-source.

--changes-option=opt

Pass option opt to dpkg-genchanges.

--admindir=katalog
--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

Even if dpkg-buildpackage export some variables, debian/rules should not rely on their presence and should instead use the respective interface to retrieve the needed values.

Zmienne ustawiane przez dpkg-architecture

Wywo³uje program dpkg-architecture z przekazaniem parametrów -a oraz -t. Wszystkie zmienne uzyskane na wyj¶ciu dziêki jego opcji -s s± do³±czane do ¶rodowiska budowania.

Flagi kompilatora

The CFLAGS, CXXFLAGS, FFLAGS, CPPFLAGS and LDFLAGS environment variables are set to the values that dpkg-buildflags returned. See its manual page for more information.

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), fakeroot(1), gpg(1).

AUTORZY

Copyright © 1995-1996 Ian Jackson
Copyright © 2000 Wichert Akkerman
Copyright © 2007 Frank Lichtenheld
Copyright © 2008-2010 Raphaël Hertzog

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