Blame doc/pl/rpmbuild.8

2ff057
.\" Jakub Bogusz <qboosh@pld-linux.org>, 2003
2ff057
.\" (partially based on rpm.8 translation by Przemek Borys 1999)
2ff057
.\" rpm 4.3-20030610
2ff057
.TH "RPMBUILD" "8" "9 czerwca 2002" "Red Hat, Inc."
2ff057
.SH NAZWA
2ff057
rpmbuild \- Budowanie pakietów RPM
2ff057
.SH SKŁADNIA
2ff057
.SS "BUDOWANIE PAKIETÓW:"
2ff057
.PP
2ff057
2ff057
\fBrpmbuild\fR {\fB-ba|-bb|-bp|-bc|-bi|-bl|-bs\fR} [\fBopcje-rpmbuild\fR] \fB\fIPLIK_SPEC\fB\fR\fI ...\fR
2ff057
2ff057
\fBrpmbuild\fR {\fB-ta|-tb|-tp|-tc|-ti|-tl|-ts\fR} [\fBopcje-rpmbuild\fR] \fB\fITARBALL\fB\fR\fI ...\fR
2ff057
2ff057
\fBrpmbuild\fR {\fB--rebuild|--recompile\fR} \fB\fIPAKIET_ŹRÓDŁOWY\fB\fR\fI ...\fR
2ff057
2ff057
.SS "RÓŻNE:"
2ff057
.PP
2ff057
2ff057
\fBrpmbuild\fR \fB--showrc\fR
2ff057
2ff057
.SS "opcje-rpmbuild"
2ff057
.PP
2ff057
2ff057
 [\fB--buildroot \fIKATALOG\fB\fR] [\fB--clean\fR] [\fB--nobuild\fR]
2ff057
 [\fB--rmsource\fR] [\fB--rmspec\fR] [\fB--short-circuit\fR] [\fB--sign\fR]
2ff057
 [\fB--target \fIPLATFORMA\fB\fR]
2ff057
2ff057
.SH "OPIS"
2ff057
.PP
2ff057
\fBrpmbuild\fR służy do budowania binarnych i źródłowych pakietów
2ff057
oprogramowania. \fBPakiet\fR składa się z archiwum plików oraz metadanych
2ff057
używanych do instalowania i usuwania plików. Metadane zawierają pomocnicze
2ff057
skrypty, atrybuty plików oraz informacje opisujące pakiet.
2ff057
\fBPakiety\fR występują w dwóch wersjach: pakietach binarnych, służących do
2ff057
opakowania oprogramowania do instalacji oraz pakietach źródłowych,
2ff057
zawierających kod źródłowy i przepis na zbudowanie pakietów binarnych.
2ff057
.PP
2ff057
Trzeba wybrać jeden z następujących podstawowych trybów:
2ff057
\fBBudowanie pakietu\fR,
2ff057
\fBBudowanie pakietu z tarballa\fR,
2ff057
\fBRekompilacja pakietu\fR,
2ff057
\fBWyświetlenie konfiguracji\fR.
2ff057
.SS "OPCJE OGÓLNE"
2ff057
.PP
2ff057
Opcje te mogą być używane we wszystkich trybach.
2ff057
.TP
2ff057
\fB-?\fR, \fB--help\fR
2ff057
Wypisuje informację o użyciu dłuższą niż zwykle.
2ff057
.TP
2ff057
\fB--version\fR
2ff057
Wypisuje pojedynczą linię, zawierającą numer wersji używanego \fBrpm\fR-a.
2ff057
.TP
2ff057
\fB--quiet\fP
2ff057
Wypisuje jak najmniej - zazwyczaj tylko komunikaty o błędach.
2ff057
.TP
2ff057
\fB-v\fR
2ff057
Wypisuje szczegółowe informacje - zwykle komunikaty o przebiegu procesu.
2ff057
.TP
2ff057
\fB-vv\fR
2ff057
Wypisuje dużo brzydkich informacji diagnostycznych.
2ff057
.TP
2ff057
\fB--rcfile \fILISTA_PLIKÓW\fB\fR
2ff057
Każdy z plików w oddzielonej dwukropkami \fILIŚCIE_PLIKÓW\fP jest
2ff057
odczytywany kolejno przez \fBrpm\fR-a w poszukiwaniu informacji o
2ff057
konfiguracji.
2ff057
Istnieć musi tylko pierwszy plik z listy, a tyldy są zamieniane na
2ff057
wartość \fB$HOME\fR.
2ff057
Domyślną \fILISTĄ_PLIKÓW\fR jest 
2ff057
\fI/usr/lib/rpm/rpmrc\fR:\fI/usr/lib/rpm/redhat/rpmrc\fR:\fI/etc/rpmrc\fR:\fI~/.rpmrc\fR.
2ff057
.TP
2ff057
\fB--pipe \fIKOMENDA\fB\fR
2ff057
Przekazuje potokiem wyjście \fBrpm\fP-a do \fIKOMENDY\fR.
2ff057
.TP
2ff057
\fB--dbpath \fIKATALOG\fB\fR
2ff057
Używa bazy danych z \fIKATALOGU\fR zamiast domyślnego \fI/var/lib/rpm\fR.
2ff057
.TP
2ff057
\fB--root \fIKATALOG\fB\fR
2ff057
Używa do wszystkich operacji systemu zakorzenionego w \fIKATALOGU\fR.
2ff057
Zauważ, że oznacza to, że baza danych w \fIKATALOGU\fP
2ff057
będzie używana przy sprawdzaniu zależności, a wszystkie skrypty (np.
2ff057
\fB%post\fR przy instalacji pakietu lub
2ff057
\fB%prep\fR przy budowaniu pakietu)
2ff057
będą uruchamiane po chroot(2) na
2ff057
\fIKATALOG\fR.
2ff057
.SS "OPCJE BUDOWANIA"
2ff057
.PP
2ff057
Ogólną postacią komendy budowania rpm-a jest
2ff057
.PP
2ff057
2ff057
\fBrpmbuild\fR \fB-b\fIETAP\fB|-t\fIETAP\fB\fR [ \fB     opcje-rpmbuild
2ff057
\fR ] \fB\fIPLIK\fB\fR\fI ...\fR
2ff057
2ff057
.PP
2ff057
Jeśli do zbudowania pakietu używany jest plik spec, to argumentem powinno
2ff057
być \fB-b\fR, a jeśli \fBrpmbuild\fR powinien zajrzeć wewnątrz (być może
2ff057
skompresowanego) pliku tar w poszukiwaniu speca, to powinna być użyta opcja
2ff057
\fB-t\fR. Po pierwszym argumencie, drugi znak (\fIETAP\fR) określa etapy
2ff057
budowania i pakietowania, które należy wykonać. Może być jednym z:
2ff057
.TP
2ff057
\fB-ba\fR
2ff057
Buduje pakiety binarny i źródłowy (po wykonaniu etapów %prep, %build
2ff057
i %install).
2ff057
.TP
2ff057
\fB-bb\fR
2ff057
Buduje pakiet binarny (po wykonaniu etapów %prep, %build i %install).
2ff057
.TP
2ff057
\fB-bp\fR
2ff057
Wykonuje etap "%prep" z pliku spec. Zwykle obejmuje to rozpakowanie źródeł
2ff057
i zaaplikowanie wszelkich łat.
2ff057
.TP
2ff057
\fB-bc\fR
2ff057
Wykonuje etap "%build" z pliku spec (po wykonaniu etapu %prep).
2ff057
Ogólnie obejmuje to odpowiednik "make".
2ff057
.TP
2ff057
\fB-bi\fR
2ff057
Wykonuje etap "%install" z pliku spec (po wykonaniu etapów %prep i %build).
2ff057
Ogólnie obejmuje to odpowiednik "make install".
2ff057
.TP
2ff057
\fB-bl\fR
2ff057
Dokonuje sprawdzenia listy. W sekcji "%files" pliku spec rozwijane są makra
2ff057
i dokonywane są sprawdzenia, by upewnić się, że każdy plik istnieje.
2ff057
.TP
2ff057
\fB-bs\fR
2ff057
Buduje tylko pakiet źródłowy.
2ff057
.PP
2ff057
Mogą być też użyte następujące opcje:
2ff057
.TP
2ff057
\fB--buildroot \fIKATALOG\fB\fR
2ff057
Na czas budowania pakietu zastępuje wartość BuildRoot \fIKATALOGIEM\fR.
2ff057
.TP
2ff057
\fB--clean\fR
2ff057
Usuwa drzewo budowania po stworzeniu pakietów.
2ff057
.TP
2ff057
\fB--nobuild\fR
2ff057
Nie wykonuje żadnych etapów budowania. Przydatne do testowania plików spec.
2ff057
.TP
2ff057
\fB--rmsource\fR
2ff057
Usuwa źródła po budowaniu (może być też używane samodzielnie, np.
2ff057
"\fBrpmbuild\fR \fB--rmsource foo.spec\fR").
2ff057
.TP
2ff057
\fB--rmspec\fR
2ff057
Usuwa plik spec po budowaniu (może być też używane samodzielnie, np.
2ff057
"\fBrpmbuild\fR \fB--rmspec foo.spec\fR").
2ff057
.TP
2ff057
\fB--short-circuit\fR
2ff057
Przechodzi wprost do podanego etapu (tzn. pomija wszystkie etapy
2ff057
prowadzące do podanego). Prawidłowe tylko z \fB-bc\fR i \fB-bi\fR.
2ff057
.TP
2ff057
\fB--sign\fR
2ff057
Osadza w pakiecie sygnaturę GPG. Sygnatura ta może być używana do
2ff057
weryfikowania integralności i pochodzenia pakietu. Zobacz sekcję o
2ff057
SYGNATURACH GPG w
2ff057
\fBrpm\fR(8), gdzie znajdują się szczegóły dotyczące konfiguracji.
2ff057
.TP
2ff057
\fB--target \fIPLATFORMA\fB\fR
2ff057
Podczas budowania pakietu interpretuje \fIPLATFORMĘ\fR jako
2ff057
\fBarch-vendor-os\fR i ustawia odpowiednio makra
2ff057
\fB%_target\fR, 
2ff057
\fB%_target_cpu\fR oraz
2ff057
\fB%_target_os\fP.
2ff057
.SS "OPCJE PRZEBUDOWYWANIA I REKOMPILACJI"
2ff057
.PP
2ff057
Istnieją dwa inne sposoby na wywołanie budowania przy użyciu rpm-a:
2ff057
.PP
2ff057
2ff057
\fBrpmbuild\fR \fB--rebuild|--recompile\fR \fB\fIPAKIET_ŹRÓDŁOWY\fB\fR\fI ...\fR
2ff057
2ff057
.PP
2ff057
Po takim wywołaniu, \fBrpmbuild\fR instaluje podany pakiet źródłowy oraz
2ff057
wykonuje etapy prep, kompilacji i instalacji. Dodatkowo, \fB--rebuild\fR
2ff057
buduje nowy pakiet binarny. Po tym jak budowanie jest zakończone, katalog
2ff057
budowania jest usuwany (jak przy \fB--clean\fR), a potem źródła i plik spec
2ff057
dla pakietu są usuwane.
2ff057
.SS "WYŚWIETLANIE KONFIGURACJI"
2ff057
.PP
2ff057
Polecenie
2ff057
.PP
2ff057
2ff057
\fBrpmbuild\fR \fB--showrc\fR
2ff057
2ff057
.PP
2ff057
pokazuje wartości, których \fBrpmbuild\fR będzie używał dla wszystkich
2ff057
opcji, które są aktualnie ustawione w plikach konfiguracyjnych
2ff057
\fIrpmrc\fR oraz
2ff057
\fImacros\fR.
2ff057
.SH "PLIKI"
2ff057
.SS "Konfiguracja rpmrc"
2ff057
.PP
2ff057
.nf
2ff057
\fI/usr/lib/rpm/rpmrc\fR
2ff057
\fI/usr/lib/rpm/redhat/rpmrc\fR
2ff057
\fI/etc/rpmrc\fR
2ff057
\fI~/.rpmrc\fR
2ff057
.fi
2ff057
.SS "Konfiguracja makr"
2ff057
.PP
2ff057
.nf
2ff057
\fI/usr/lib/rpm/macros\fR
2ff057
\fI/usr/lib/rpm/redhat/macros\fR
2ff057
\fI/etc/rpm/macros\fR
2ff057
\fI~/.rpmmacros\fR
2ff057
.fi
2ff057
.SS "Baza danych"
2ff057
.PP
2ff057
.nf
2ff057
\fI/var/lib/rpm/Basenames\fR
2ff057
\fI/var/lib/rpm/Conflictname\fR
2ff057
\fI/var/lib/rpm/Dirnames\fR
2ff057
\fI/var/lib/rpm/Filemd5s\fR
2ff057
\fI/var/lib/rpm/Group\fR
2ff057
\fI/var/lib/rpm/Installtid\fR
2ff057
\fI/var/lib/rpm/Name\fR
2ff057
\fI/var/lib/rpm/Packages\fR
2ff057
\fI/var/lib/rpm/Providename\fR
2ff057
\fI/var/lib/rpm/Provideversion\fR
2ff057
\fI/var/lib/rpm/Pubkeys\fR
2ff057
\fI/var/lib/rpm/Removed\fR
2ff057
\fI/var/lib/rpm/Requirename\fR
2ff057
\fI/var/lib/rpm/Requireversion\fR
2ff057
\fI/var/lib/rpm/Sha1header\fR
2ff057
\fI/var/lib/rpm/Sigmd5\fR
2ff057
\fI/var/lib/rpm/Triggername\fR
2ff057
.fi
2ff057
.SS "Tymczasowe"
2ff057
.PP
2ff057
\fI/var/tmp/rpm*\fR
2ff057
.SH "ZOBACZ TAKŻE"
2ff057
2ff057
.nf
2ff057
\fBpopt\fR(3),
2ff057
\fBrpm2cpio\fR(8),
2ff057
\fBgendiff\fR(1),
2ff057
\fBrpm\fR(8),
2ff057
.fi
2ff057
2ff057
\fBhttp://www.rpm.org/ <URL:http://www.rpm.org/>
2ff057
\fR
2ff057
.SH "AUTORZY"
2ff057
2ff057
.nf
2ff057
Marc Ewing <marc@redhat.com>
2ff057
Jeff Johnson <jbj@redhat.com>
2ff057
Erik Troan <ewt@redhat.com>
2ff057
.fi