.\" dpkg manual page - dpkg-buildpackage(1) .\" .\" Copyright Š 1995-1996 Ian Jackson .\" Copyright Š 2000 Wichert Akkerman .\" Copyright Š 2007-2008 Frank Lichtenheld .\" Copyright Š 2008-2011 Guillem Jover .\" Copyright Š 2008-2012 RaphaĂŤl Hertzog .\" .\" This is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH dpkg\-buildpackage 1 2012\-05\-04 "Projekt Debian" "programy pomocnicze dpkg" .SH NAZWA dpkg\-buildpackage \- buduje pakiety źródłowe lub binarne ze źródeł . .SH SKŁADNIA \fBdpkg\-buildpackage\fP [\fIopcja\fP...] . .SH OPIS \fBdpkg\-buildpackage\fP jest programem automatyzującym proces budowania pakietu Debiana. Proces ten składa się z następujących kroków: .IP \fB1.\fP 3 Przygotowuje środowisko budowania poprzez ustawienie różnych zmiennych środowiska (patrz \fBŚRODOWISKO\fP) i wywołuje \fBdpkg\-source \-\-before\-build\fP (chyba że użyto \fB\-T\fP lub \fB\-\-target\fP). .IP \fB2.\fP 3 Sprawdza czy zależności i konflikty czasu budowania są spełnione (o ile nie jest podane \fB\-d\fP). .IP \fB3.\fP 3 Jeśli określony cel został wskazany z użyciem opcji \fB\-T\fP lub \fB\-\-target\fP, wywołuje ten cel i na tym kończy. W przeciwnym wypadku wywołuje \fBfakeroot debian/rules clean\fP, aby wyczyścić drzewo budowania pakietu (chyba że użyje się opcji \fB\-nc\fP). .IP \fB4.\fP 3 Wywołuje \fBdpkg\-source \-b\fP aby wygenerować pakiet źródłowy (chyba że żądano tylko zbudowania pakietu binarnego, podając opcję \fB\-b\fP, \fB\-B\fP lub \fB\-A\fP). .IP \fB5.\fP 3 Wywołuje \fBdebian/rules\fP \fBbuild\-target\fP, a następnie \fBfakeroot debian/rules\fP \fIbinary\-target\fP (chyba że żądano tylko zbudowania pakietu źródłowego, podając opcję \fB\-S\fP). Proszę zauważyć, że \fIbuild\-target\fP i \fIbinary\-target\fP mają wartość albo \fBbuild\fP i \fBbinary\fP (domyślnie, lub gdy podano \fB\-b\fP) albo \fBbuild\-arch\fP i \fBbinary\-arch\fP (jeśli podano \fB\-B\fP) albo \fBbuild\-indep\fP i \fBbinary\-indep\fP (jeśli podano \fB\-A\fP). .IP \fB6.\fP 3 Wywołuje \fBgpg\fP aby podpisać plik \fB.dsc\fP (jeśli jest, chyba że podano opcję \fB\-us\fP). .IP \fB7.\fP 3 Wywołuje \fBdpkg\-genchanges\fP aby wygenerować plik \fB.changes\fP. Do \fBdpkg\-genchanges\fP przekazywanych jest wiele opcji \fBdpkg\-buildpackage\fP. .IP \fB8.\fP 3 Wywołuje \fBgpg\fP aby podpisać plik \fB.changes\fP (chyba że podano opcję \fB\-uc\fP). .IP \fB9.\fP 3 Jeśli podana jest opcja \fB\-tc\fP, wywołuje ponownie \fBfakeroot debian/rules clean\fP. Na końcu wywołuje \fBdpkg\-source \-\-after\-build\fP. . .SH OPCJE .TP \fB\-b\fP Określa budowanie tylko pakietów binarnych, żadne pliki źródłowe nie będą budowane ani dystrybuowane. Przekazywane do \fBdpkg\-genchanges\fP. .TP \fB\-B\fP Określa budowanie tylko pakietów binarnych, ograniczone do pakietów zależnych od architektury. Przekazywane do \fBdpkg\-genchanges\fP. .TP \fB\-A\fP Określa budowanie tylko pakietów binarnych, ograniczone do pakietów niezależnych od architektury. Przekazywane do \fBdpkg\-genchanges\fP. .TP \fB\-S\fP Określa budowanie tylko pakietów źródłowych, bez budowania pakietów binarnych. Przekazywane do \fBdpkg\-genchanges\fP. .TP \fB\-F\fP Określa normalne, pełne budowanie \- zostaną zbudowane pakiety binarne i źródłowe. Jest to ten sam i domyślny przypadek, gdy nie podano opcji budowania. .P \fB\-\-target=\fP\fIcel\fP .br \fB\-\-target \fP\fIcel\fP .br \fB\-T\fP\fIcel\fP .RS Wywołuje \fBdebian/rules\fP \fIcel\fP po przygotowaniu środowiska budowania i na tym kończy proces budowania pakietu. Jeśli podana została również opcja \fB\-\-as\-root\fP, 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. .RE .TP \fB\-\-as\-root\fP Znacząca jedynie w połączeniu z opcją \fB\-\-target\fP. Wymusza uruchomienie celu z prawami administratora. .P \fB\-si\fP .br \fB\-sa\fP .br \fB\-sd\fP .br \fB\-v\fP\fIwersja\fP .br \fB\-C\fP\fIopis\-zmian\fP .br \fB\-m\fP\fIadres\-opiekuna\fP .br \fB\-e\fP\fIadres\-opiekuna\fP .RS Przekazywana bez zmian do \fBdpkg\-genchanges\fP. Więcej informacji na stronie podręcznika tego programu. .RE .TP \fB\-a\fP\fIarchitektura\fP 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ą. .TP \fB\-t\fP\fItyp\-systemu\-gnu\fP 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. .TP \fB\-j\fP\fIzadania\fP Liczba zadań, które mogą zostać równocześnie uruchomione, odpowiednik opcji \fBmake\fP(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 \fBparallel=\fP\fIzadania\fP do zmiennej środowiskowej DEB_BUILD_OPTIONS, co pozwala plikom debian/rules na korzystanie z tej informacji dla ich własnych celów. Wartość \fBparallel=\fP\fIzadania\fP zmiennej środowiska DEB_BUILD_OPTIONS nadpisuje wartość przekazaną w opcji \fB\-j\fP, jeśli została ona podana. .TP \fB\-D\fP 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. .TP \fB\-d\fP Nie sprawdza zależności czasu budowania ani konfliktów. .TP \fB\-nc\fP Pomija czyszczenie drzewa źródeł pakietu (implikuje \fB\-b\fP, jeśli nic innego nie zostało wybrane spośród \fB\-B\fP, \fB\-A\fP oraz \fB\-S\fP). .TP \fB\-tc\fP Po zbudowaniu pakietu czyści katalog ze źródłami (używając \fIgain\-root\-command\fP \fBdebian/rules clean\fP). .TP \fB\-r\fP\fIpolecenie\-uzyskiwania\-praw\-administratora\fP Kiedy \fBdpkg\-buildpackage\fP potrzebuje wykonać część procesu budowania jako administrator, poprzedza wykonywane polecenia \fIpoleceniem\-uzyskiwania\-praw\-administratora\fP, jeśli takowe zostało podane. Jeśli natomiast nie zostało podane, zostanie domyślnie użyte polecenie \fBfakeroot\fP, o ile jest dostępne. \fIpolecenie\-uzyskiwania\-praw\-administratora\fP powinno zaczynać się nazwą programu dostępnego przez zmienną systemową \fBPATH\fP, któremu będą przekazywane argumenty w postaci właściwego programu do wykonania oraz jego parametrów. \fIpolecenie\-uzyskiwania\-praw\-administratora\fP może samo zawierać parametry (muszą być one rozdzielone spacjami), ale nie może zawierać metaznaków powłoki. \fIpoleceniem\-uzyskiwania\-praw\-administratora\fP mogą typowo być \fBfakeroot\fP, \fBsudo\fP, \fBsuper\fP lub \fBreally\fP. \fBsu\fP nie nadaje się do tego celu, ponieważ może tylko wywołać powłokę użytkownika używając \fB\-c\fP zamiast przekazywać indywidualnie argumenty dla polecenia do wykonania. .TP \fB\-R\fP\fIplik_rules\fP Budowanie pakietu Debiana zwykle wymaga wywołania \fBdebian/rules\fP 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 \fB/usr/local/bin/make \-f debian/rules\fP jako \fIplik_rules\fP). .TP \fB\-p\fP\fIpolecenie\-podpisywania\fP Gdy \fBdpkg\-buildpackage\fP będzie potrzebował wywołać GPG lub PGP aby podpisać plik kontrolny źródeł (\fB.dsc\fP) lub plik \fB.changes\fP, zostanie uruchomione \fIpolecenie\-podpisywania\fP (w razie konieczności przeszukując \fBPATH\fP) zamiast \fBgpg\fP. Parametry normalnie przekazywane do \fBgpg\fP zostaną przekazane do \fIpolecenia\-podpisywania\fP. \fIPolecenie\-podpisywania\fP nie powinno zawierać spacji, ani żadnych innych metaznaków powłoki. .TP \fB\-k\fP\fIid\-klucza\fP Określa ID klucza używanego do podpisywania pakietów. .TP \fB\-us\fP Nie próbuje podpisywać pakietów. .TP \fB\-uc\fP Nie próbuje podpisywać plików \fB.changes\fP. .P \fB\-i\fP[\fIwyraż_regularne\fP] .br \fB\-I\fP\fI[wzorzec]\fP .br \fB\-s\fP[\fBnsAkurKUR\fP] .br \fB\-z\fP, \fB\-Z\fP .br .RS Przekazywana bez zmian do \fBdpkg\-source\fP. Więcej informacji na stronie podręcznika tego programu .RE .TP \fB\-\-source\-option=\fP\fIopc\fP Przekazuje opcję \fIopc\fP do \fBdpkg\-source\fP. .TP \fB\-\-changes\-option=\fP\fIopc\fP Przekazuje opcję \fIopc\fP do \fBdpkg\-genchanges\fP. .P \fB\-\-admindir=\fP\fIkatalog\fP .br \fB\-\-admindir \fP\fIkatalog\fP .RS Zmienia położenie bazy danych \fBdpkg\fP. Domyślnie jest to \fI/var/lib/dpkg\fP. .RE .TP \fB\-?\fP, \fB\-\-help\fP Wyświetla informację o użytkowaniu i kończy działanie. .TP \fB\-\-version\fP Wyświetla informację o wersji i pomyślnie kończy działanie. . .SH ŚRODOWISKO Nawet gdy \fBdpkg\-buildpackage\fP eksportuje jakieś zmienne, \fBdebian/rules\fP nie powinno polegać na ich obecności i powinno używać odpowiedniego interfejsu do pozyskania potrzebnych wartości. .SS "Zmienne ustawiane przez dpkg\-architecture" Wywołuje program \fBdpkg\-architecture\fP z przekazaniem parametrów \fB\-a\fP oraz \fB\-t\fP. Wszystkie zmienne uzyskane na wyjściu dzięki jego opcji \fB\-s\fP są dołączane do środowiska budowania. .SS "Flagi kompilatora nie są dłużej eksportowane." Między wersjami 1.14.17 i 1.16.1, \fBdpkg\-buildpackage\fP eksportowało flagi kompilatora (\fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBFFLAGS\fP, \fBCPPFLAGS\fP i \fBLDFLAGS\fP) z wartościami zwracanymi przez \fBdpkg\-buildflags\fP. Obecnie tak się nie dzieje. . .SH "KOMPATYBILNOŚĆ WSTECZNA" \fBdpkg\-buildpackage\fP używa celów \fBbuild\-arch\fP i \fBbuild\-indep\fP od wersji 1.16.2. Są one w związku z tym obowiązkowe. Aby zapobiec psuciu istniejących pakietów i w celu ułatwienia przejścia, jeśli \fBmake \-f debian/rules \-qn\fP \fIbuild\-target\fP zwróci 2 jako kod zakończenia, to zostanie użyty cel \fBbuild\fP. .SH BŁĘDY Powinno być możliwe podanie spacji, metaznaków powłoki oraz argumentów dla \fIgain\-root\-command\fP oraz \fIsign\-command\fP. . .SH "ZOBACZ TAKŻE" \fBdpkg\-source\fP(1), \fBdpkg\-architecture\fP(1), \fBdpkg\-buildflags\fP(1), \fBdpkg\-genchanges\fP(1), \fBfakeroot\fP(1), \fBgpg\fP(1). .SH "TŁUMACZE" Piotr Roszatycki , 1999 .br Bartosz Feński , 2004-2005 .br Robert Luberda , 2006-2008 .br Wiktor Wandachowicz , 2008 .br Michał Kułach , 2012