246 lines
7.3 KiB
Groff
246 lines
7.3 KiB
Groff
.\" 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
|