.\" Jakub Bogusz <qboosh@pld-linux.org>, 2003
.\" (partially based on rpm.8 translation by Przemek Borys 1999)
.\" rpm 4.3-20030610
.TH "RPMBUILD" "8" "9 czerwca 2002" "Red Hat, Inc."
.SH NAZWA
rpmbuild \- Budowanie pakietów RPM
.SH SKŁADNIA
.SS "BUDOWANIE PAKIETÓW:"
.PP

\fBrpmbuild\fR {\fB-ba|-bb|-bp|-bc|-bi|-bl|-bs\fR} [\fBopcje-rpmbuild\fR] \fB\fIPLIK_SPEC\fB\fR\fI ...\fR

\fBrpmbuild\fR {\fB-ta|-tb|-tp|-tc|-ti|-tl|-ts\fR} [\fBopcje-rpmbuild\fR] \fB\fITARBALL\fB\fR\fI ...\fR

\fBrpmbuild\fR {\fB--rebuild|--recompile\fR} \fB\fIPAKIET_ŹRÓDŁOWY\fB\fR\fI ...\fR

.SS "RÓŻNE:"
.PP

\fBrpmbuild\fR \fB--showrc\fR

.SS "opcje-rpmbuild"
.PP

 [\fB--buildroot \fIKATALOG\fB\fR] [\fB--clean\fR] [\fB--nobuild\fR]
 [\fB--rmsource\fR] [\fB--rmspec\fR] [\fB--short-circuit\fR] [\fB--sign\fR]
 [\fB--target \fIPLATFORMA\fB\fR]

.SH "OPIS"
.PP
\fBrpmbuild\fR służy do budowania binarnych i źródłowych pakietów
oprogramowania. \fBPakiet\fR składa się z archiwum plików oraz metadanych
używanych do instalowania i usuwania plików. Metadane zawierają pomocnicze
skrypty, atrybuty plików oraz informacje opisujące pakiet.
\fBPakiety\fR występują w dwóch wersjach: pakietach binarnych, służących do
opakowania oprogramowania do instalacji oraz pakietach źródłowych,
zawierających kod źródłowy i przepis na zbudowanie pakietów binarnych.
.PP
Trzeba wybrać jeden z następujących podstawowych trybów:
\fBBudowanie pakietu\fR,
\fBBudowanie pakietu z tarballa\fR,
\fBRekompilacja pakietu\fR,
\fBWyświetlenie konfiguracji\fR.
.SS "OPCJE OGÓLNE"
.PP
Opcje te mogą być używane we wszystkich trybach.
.TP
\fB-?\fR, \fB--help\fR
Wypisuje informację o użyciu dłuższą niż zwykle.
.TP
\fB--version\fR
Wypisuje pojedynczą linię, zawierającą numer wersji używanego \fBrpm\fR-a.
.TP
\fB--quiet\fP
Wypisuje jak najmniej - zazwyczaj tylko komunikaty o błędach.
.TP
\fB-v\fR
Wypisuje szczegółowe informacje - zwykle komunikaty o przebiegu procesu.
.TP
\fB-vv\fR
Wypisuje dużo brzydkich informacji diagnostycznych.
.TP
\fB--rcfile \fILISTA_PLIKÓW\fB\fR
Każdy z plików w oddzielonej dwukropkami \fILIŚCIE_PLIKÓW\fP jest
odczytywany kolejno przez \fBrpm\fR-a w poszukiwaniu informacji o
konfiguracji.
Istnieć musi tylko pierwszy plik z listy, a tyldy są zamieniane na
wartość \fB$HOME\fR.
Domyślną \fILISTĄ_PLIKÓW\fR jest 
\fI/usr/lib/rpm/rpmrc\fR:\fI/usr/lib/rpm/redhat/rpmrc\fR:\fI/etc/rpmrc\fR:\fI~/.rpmrc\fR.
.TP
\fB--pipe \fIKOMENDA\fB\fR
Przekazuje potokiem wyjście \fBrpm\fP-a do \fIKOMENDY\fR.
.TP
\fB--dbpath \fIKATALOG\fB\fR
Używa bazy danych z \fIKATALOGU\fR zamiast domyślnego \fI/var/lib/rpm\fR.
.TP
\fB--root \fIKATALOG\fB\fR
Używa do wszystkich operacji systemu zakorzenionego w \fIKATALOGU\fR.
Zauważ, że oznacza to, że baza danych w \fIKATALOGU\fP
będzie używana przy sprawdzaniu zależności, a wszystkie skrypty (np.
\fB%post\fR przy instalacji pakietu lub
\fB%prep\fR przy budowaniu pakietu)
będą uruchamiane po chroot(2) na
\fIKATALOG\fR.
.SS "OPCJE BUDOWANIA"
.PP
Ogólną postacią komendy budowania rpm-a jest
.PP

\fBrpmbuild\fR \fB-b\fIETAP\fB|-t\fIETAP\fB\fR [ \fB     opcje-rpmbuild
\fR ] \fB\fIPLIK\fB\fR\fI ...\fR

.PP
Jeśli do zbudowania pakietu używany jest plik spec, to argumentem powinno
być \fB-b\fR, a jeśli \fBrpmbuild\fR powinien zajrzeć wewnątrz (być może
skompresowanego) pliku tar w poszukiwaniu speca, to powinna być użyta opcja
\fB-t\fR. Po pierwszym argumencie, drugi znak (\fIETAP\fR) określa etapy
budowania i pakietowania, które należy wykonać. Może być jednym z:
.TP
\fB-ba\fR
Buduje pakiety binarny i źródłowy (po wykonaniu etapów %prep, %build
i %install).
.TP
\fB-bb\fR
Buduje pakiet binarny (po wykonaniu etapów %prep, %build i %install).
.TP
\fB-bp\fR
Wykonuje etap "%prep" z pliku spec. Zwykle obejmuje to rozpakowanie źródeł
i zaaplikowanie wszelkich łat.
.TP
\fB-bc\fR
Wykonuje etap "%build" z pliku spec (po wykonaniu etapu %prep).
Ogólnie obejmuje to odpowiednik "make".
.TP
\fB-bi\fR
Wykonuje etap "%install" z pliku spec (po wykonaniu etapów %prep i %build).
Ogólnie obejmuje to odpowiednik "make install".
.TP
\fB-bl\fR
Dokonuje sprawdzenia listy. W sekcji "%files" pliku spec rozwijane są makra
i dokonywane są sprawdzenia, by upewnić się, że każdy plik istnieje.
.TP
\fB-bs\fR
Buduje tylko pakiet źródłowy.
.PP
Mogą być też użyte następujące opcje:
.TP
\fB--buildroot \fIKATALOG\fB\fR
Na czas budowania pakietu zastępuje wartość BuildRoot \fIKATALOGIEM\fR.
.TP
\fB--clean\fR
Usuwa drzewo budowania po stworzeniu pakietów.
.TP
\fB--nobuild\fR
Nie wykonuje żadnych etapów budowania. Przydatne do testowania plików spec.
.TP
\fB--rmsource\fR
Usuwa źródła po budowaniu (może być też używane samodzielnie, np.
"\fBrpmbuild\fR \fB--rmsource foo.spec\fR").
.TP
\fB--rmspec\fR
Usuwa plik spec po budowaniu (może być też używane samodzielnie, np.
"\fBrpmbuild\fR \fB--rmspec foo.spec\fR").
.TP
\fB--short-circuit\fR
Przechodzi wprost do podanego etapu (tzn. pomija wszystkie etapy
prowadzące do podanego). Prawidłowe tylko z \fB-bc\fR i \fB-bi\fR.
.TP
\fB--sign\fR
Osadza w pakiecie sygnaturę GPG. Sygnatura ta może być używana do
weryfikowania integralności i pochodzenia pakietu. Zobacz sekcję o
SYGNATURACH GPG w
\fBrpm\fR(8), gdzie znajdują się szczegóły dotyczące konfiguracji.
.TP
\fB--target \fIPLATFORMA\fB\fR
Podczas budowania pakietu interpretuje \fIPLATFORMĘ\fR jako
\fBarch-vendor-os\fR i ustawia odpowiednio makra
\fB%_target\fR, 
\fB%_target_cpu\fR oraz
\fB%_target_os\fP.
.SS "OPCJE PRZEBUDOWYWANIA I REKOMPILACJI"
.PP
Istnieją dwa inne sposoby na wywołanie budowania przy użyciu rpm-a:
.PP

\fBrpmbuild\fR \fB--rebuild|--recompile\fR \fB\fIPAKIET_ŹRÓDŁOWY\fB\fR\fI ...\fR

.PP
Po takim wywołaniu, \fBrpmbuild\fR instaluje podany pakiet źródłowy oraz
wykonuje etapy prep, kompilacji i instalacji. Dodatkowo, \fB--rebuild\fR
buduje nowy pakiet binarny. Po tym jak budowanie jest zakończone, katalog
budowania jest usuwany (jak przy \fB--clean\fR), a potem źródła i plik spec
dla pakietu są usuwane.
.SS "WYŚWIETLANIE KONFIGURACJI"
.PP
Polecenie
.PP

\fBrpmbuild\fR \fB--showrc\fR

.PP
pokazuje wartości, których \fBrpmbuild\fR będzie używał dla wszystkich
opcji, które są aktualnie ustawione w plikach konfiguracyjnych
\fIrpmrc\fR oraz
\fImacros\fR.
.SH "PLIKI"
.SS "Konfiguracja rpmrc"
.PP
.nf
\fI/usr/lib/rpm/rpmrc\fR
\fI/usr/lib/rpm/redhat/rpmrc\fR
\fI/etc/rpmrc\fR
\fI~/.rpmrc\fR
.fi
.SS "Konfiguracja makr"
.PP
.nf
\fI/usr/lib/rpm/macros\fR
\fI/usr/lib/rpm/redhat/macros\fR
\fI/etc/rpm/macros\fR
\fI~/.rpmmacros\fR
.fi
.SS "Baza danych"
.PP
.nf
\fI/var/lib/rpm/Basenames\fR
\fI/var/lib/rpm/Conflictname\fR
\fI/var/lib/rpm/Dirnames\fR
\fI/var/lib/rpm/Filemd5s\fR
\fI/var/lib/rpm/Group\fR
\fI/var/lib/rpm/Installtid\fR
\fI/var/lib/rpm/Name\fR
\fI/var/lib/rpm/Packages\fR
\fI/var/lib/rpm/Providename\fR
\fI/var/lib/rpm/Provideversion\fR
\fI/var/lib/rpm/Pubkeys\fR
\fI/var/lib/rpm/Removed\fR
\fI/var/lib/rpm/Requirename\fR
\fI/var/lib/rpm/Requireversion\fR
\fI/var/lib/rpm/Sha1header\fR
\fI/var/lib/rpm/Sigmd5\fR
\fI/var/lib/rpm/Triggername\fR
.fi
.SS "Tymczasowe"
.PP
\fI/var/tmp/rpm*\fR
.SH "ZOBACZ TAKŻE"

.nf
\fBpopt\fR(3),
\fBrpm2cpio\fR(8),
\fBgendiff\fR(1),
\fBrpm\fR(8),
.fi

\fBhttp://www.rpm.org/ <URL:http://www.rpm.org/>
\fR
.SH "AUTORZY"

.nf
Marc Ewing <marc@redhat.com>
Jeff Johnson <jbj@redhat.com>
Erik Troan <ewt@redhat.com>
.fi