Attachment #99120 for bug #149608

View | Details | Raw Unified | Return to bug 149608 | Differences between

and this patch




.TH "MAKE.CONF" "5" "Oct 2006" "Portage 2.1" "Portage"
.SH "TYTU£"
make.conf \- w³asne ustawienia dla Portage
.SH "SK£ADNIA"

Plik ten zawiera opis zmiennych u¿ywanych przez Portage. Portage sprawdza w
pierwszej kolejno¶ci aktualnie zdefiniowane zmienne ¶rodowiskowe, je¶li ich
nie znajdzie, sprawdza plik /etc/make.conf. Gdy i w tym pliku nie bêdzie
zdefiniowanych zmiennych, zostanie sprawdzony plik /etc/make.globals.
Ostatecznie, gdy i tutaj Portage nie znajdzie nic, domy¶lne ustawienia profilu
odczytywane s± z pliku /etc/make.profile/make.defaults. Nale¿y mieæ na uwadze,
¿e zmiany dokonywane przez u¿ytkowników powinny zostaæ zapisywane jako zmienne
¶rodowiskowe lub powinny trafiæ do pliku /etc/make.conf.
.br
Wyj±tkami s± zmienne przyrostowe takie jak USE, CONFIG_PROTECT* czy
ACCEPT_KEYWORDS. Zmienne przyrostowe pobierane s± z pliku make.defaults do

.TP
\fBCCACHE_DIR\fR = \fI[path]\fR
Zmienna okre¶laj±ca po³o¿enie katalogu roboczego dla ccache. Aby zasiêgn±æ
wiêkszej ilo¶ci informacji, nale¿y przejrzeæ stronê manuala \fBccache\fR(1).
.br
Warto¶ci± domy¶ln± jest /var/tmp/ccache
.TP

procesora, wykorzystywanych przy kompilacji pakietów. Prawie wszystkie ebuildy
skorzystaj± z tych ustawieñ, przez co nasz system bêdzie w pe³ni
zoptymalizowany i dostosowany do naszych potrzeb. Nale¿y u¿ywaæ rozs±dnych
ustawieñ, gdy¿ czê¶æ z programów mo¿e mieæ problemy z kompilacj± lub
uruchomieniem przy zbyt agresywnych opcjach.

Po wiêksz± ilo¶æ informacji prosimy siêgaæ do rozdzia³u \fIInvoking GCC\fR

prosimy  wydaæ polecenie `emerge \-\-help config`.
.TP
\fBCONFIG_PROTECT_MASK\fR = \fI[oddzielona spacj± lista katalogów]\fR
Wszystkie pliki konfiguracyjne w katalogach, które zostan± wymienione w tej
zmiennej zostan± pozbawione ochrony. W celu uzyskania wiêkszej ilo¶ci
informacji prosimy wydaæ polecenie `emerge \-\-help config`.
.TP
.B CTARGET
Zmienna ta jest przekazywana przez \fIskrypt ebuild\fR do \fIconfigure\fR
jako \fI\-\-target=${CTARGET}\fR jedynie w przypadku, gdy jest zdefiniowana.
.TP
\fBDISTDIR\fR = \fI[¶cie¿ka]\fR
Definiuje po³o¿enie lokalnego repozytorium z kodami ¼ród³owymi.

Domy¶ln± warto¶ci± jest ${PORTDIR}/distfiles.
.TP
.B EBEEP_IGNORE
Okre¶la, czy sygna³y d¼wiêkowe wydawane przez emerge podczas wy¶wietlania
wa¿nych informacji maj± byæ ignorowane, czy nie. Domy¶lnie zmienna ta nie jest
ustawiona.
.TP
.B EMERGE_DEFAULT_OPTS
Opcje do³±czane do linii poleceñ \fBemerge\fR(1) przy ka¿dym uruchomieniu.
Nie bêd± one dodawane do linii poleceñ, je¶li do parametrów dodamy
--ignore-default-opts.
.TP
.B EPAUSE_IGNORE
Okre¶la, czy krótkie przerwy spowodowane wy¶wietleniem wa¿nej informacji maj±
byæ ignorowane, czy te¿ nie. Warto¶æ ta domy¶lnie nie jest ustawiona.
.TP
\fBFEATURES\fR = \fI"sandbox ccache autoaddcvs"\fR
Okre¶la dzia³ania domy¶lnie podejmowane przez Portage. Opcje te powinny byæ
modyfikowane jedynie przez deweloperów i/lub opiekunów pakietów.
'sandbox' jest wa¿n± czê¶ci± \fBFEATURES\fR i nie powinien byæ domy¶lnie
wy³±czony. Zmienna ta jest zmienn± przyrostow±.
.RS
.TP
.B assume-digests
W chwili zatwierdzania plików do cvs przy pomocy \fBrepoman\fR(1), program
zak³ada, ¿e wszystkie istniej±ce sumy kontrole plików ze zmiennej SRC_URI s±
poprawne. Ta opcja powoduje równie¿ generowanie plików digest za pomoc±
polecenia \fBebuild\fR(1) i \fBemerge\fR(1) (emerge generuje pliki digest tylko
wtedy, gdy opcja \fIdigest\fR jest w³±czona).
.TP
.B autoaddcvs
Sprawia, ¿e Portage stara siê automatycznie dodaæ do cvs pliki, które powinny
zostaæ dodane w pó¼niejszym czasie. Operacja ta jest wykonywana podczas
tworzenia i dzia³a tylko w przypadku posiadania wpisu \fIcvs\fR w zmiennej
\fBFEATURES\fR.
.TP
.B buildpkg
Dla wszystkich instalowanych pakietów tworzone bêd± pakiety binarne.
.TP
.B buildsyspkg
Dla instalowanych pakietów z zestawu system tworzone bêd± pakiety binarne.
.TP
.B ccache
Uaktywnia wsparcie Portage dla ccache. Je¿eli katalog dla ccache nie istnieje
w ¶rodowisku u¿ytkownika, wtedy Portage u¿yje domy¶lnego ${PORTAGE_TMPDIR}/ccache
(z \fIuserpriv\fR) lub w innym przypadku /root/.ccache.
.TP
.B confcache

nale¿± do niego.
.TP
.B cvs
Opcja przydatna dla deweloperów, powoduj±ca, ¿e Portage uaktywania wszystkie
flagi USE w zmiennej SRC_URI w trakcie tworzenia plików digest.
.TP
.B digest
Automatycznie generuje plik digest dla pakietu podczas wykonywania polecenia
\fBemerge\fR(1). Je¶li opcja \fIassume-digests\fR jest tak¿e w³±czona, wówczas
bie¿±ce pliki digest SRC_URI zostan± ponownie wykorzystane, gdziekolwiek jest
to mo¿liwe.
.TP
.B distcc

Portage u¿ywa plików blokad, aby rywalizuj±ce warstwy nie u¿ywa³y tych samych
plików w jednym czasie. Opcja ta domy¶lnie jest w³±czona, jednak mo¿e
spowodowaæ atak serca w przypadku mniej inteligentych zdalnych systemów plików,
takich jak na przyk³ad NFSv2 i dziwnie skonfigurowany serwer Samby (opcja
oplocks wy³±czona, re\-export NFS). Istnieje narzêdzie
(/usr/lib/portage/bin/clean_locks), które mo¿e siê okazaæ pomoce w przypadku
wyst±pienia problemów z blokadami (z regu³y w przypadku b³êdu lub utracenia

.B fixpackages
Uruchamia skrypt, który naprawia zale¿no¶ci we wszystkich pakietach binarnych.
Zostaje on uruchomiony w przypadku gdy pakiety przenoszone s± wewn±trz drzewa
Portage. Nale¿y mieæ na uwadze, ¿e ta operacja mo¿e trwaæ do¶æ d³ugo.
.TP
.B getbinpkg
Zmusza za ka¿dym razem emerge do ¶ci±gniêcia ¼róde³ z \fIPORTAGE_BINHOST\fR. Po

.TP
.B metadata-transfer
Automatycznie wykonuje przes³anie metadanych, gdy wykonywane jest polecenie
`emerge \-\-sync`.
.TP
.B mirror
Spowoduje to, ¿e opcja \fBFETCHCOMMAND\fR bêdzie uruchamiana zawsze, nawet w
przypadku, gdy plik bêdzie siê znajdowa³ ju¿ w \fBDISTDIR\fR.
.TP
.B noauto
W trakcie wykorzystywania \fBebuild\fR(1), uruchamiana bêdzie jedynie ¿±dana

¦ci±ga ¼ród³a w tle podczas kompilacji pakietów.
.TP
.B sandbox
Uruchamia wsparcie dla sandbox, gdy uruchamiamy \fBemerge\fR(1) lub \fBebuild\fR(1).
.TP
.B severe
Akceptuje jedynie te pliki Manifest, które zosta³y podpisane kluczami uznanymi

.TP
.B sfperms
Skrót od Smart Filesystem Permissions. Przed wgraniem plików do systemu
sprawdza prawa dostêpu do tych, które maj± ustawione bity setuid i setgid.
Z plików z bitem setuid usuwane s± prawa odczytu dla wszystkich u¿ytkowników i
dla grupy, a z plików z bitem setgid prawa odczytu dla wszystkich u¿ytkowników.
Wiêcej informacji w opisie opcji \fIsuidctl\fR poni¿ej.

.TP
.B stricter
Nakazuje Portage reagowaæ natychmiast w przypadkach które mog± kolidowaæ z
za³o¿eniami bezpieczeñstwa systemu (np. textrels, wykonywalny stos).
Wiêcej informacji na ten temat nale¿y szukaæ pod zmiennymi \fIQA_STRICT_*\fR w
\fBmake.conf\fR(5).
.TP
.B suidctl
Przed zainstalowaniem pakietów do systemu, automatycznie stripuje bity setuid z
ka¿dego pliku nieznajduj±cego siê na li¶cie w pliku \fI/etc/portage/suidctl.conf\fR.
.TP
.B test
Uruchamia testy po zainstalowaniu dla ka¿dego z pakietów celem upewnienia siê,
czy zosta³ on poprawnie skompilowany. Po wiêcej informacji nale¿y udaæ siê do
rozdzia³u \fItest\fR manuala \fBebuild\fR(1) i \fIsrc_test()\fR manuala
\fBebuild\fR(5).
.TP
.B userfetch
Gdy Portage zostanie wywo³ane przez u¿ytkownika root, polecenie zostanie
wykonane przez portage:portage na czas pobierania ¼róde³.
.TP
.B userpriv
Zezwala Portage na usuniêcie uprawnieñ superu¿ytkownika i kompilacjê pakietów
jako portage:portage bez u¿ycia sandbox (chyba, ¿e flaga \fIusersandbox\fR jest
równie¿ u¿ywana).
.TP
.B usersandbox
Uaktywnia wsparcie sandbox w czasie kompilacji w przypadku, gdy Portage nie pracuje
z uprawnieniami superu¿ytkownika (\fIuserpriv\fR).
.RE
.TP
.B FETCHCOMMAND

\fBGENTOO_MIRRORS\fR = \fI[adresy URL]\fR
W zmiennej tej umieszczamy oddzielone spacj± adresy serwerów lustrzanych.
Serwery te u¿ywane s± do ¶ci±gania plików przed serwerami umieszczonymi w 
\fIskryptach ebuild\fR. Zainstalowanie programu "mirrorselect" mo¿e pomóc w
wyborze serwerów lustrzanych.
.TP
\fBhttp_proxy ftp_proxy\fR = \fI[adres:port]\fR

.TP
.B MAKEOPTS
Zmiennej tej u¿ywamy w przypadku gdy chcemy, aby make dzia³a³ równolegle do
siebie. Dla przyk³adu, gdy posiadamy system z dwoma procesorami, ustawiamy tê
zmienn± na warto¶æ "\-j2" lub "\-j3" dla zwiêkszenia wydajno¶ci kompilacji
kilku pakietów. Zalecane ustawienia okre¶lone s± wzorem \fICPUs+1\fR i 
\fI2*CPUs+1\fR. Dla wiêkszej ilo¶ci informacji warto zobaczyæ \fBmake\fR(1).
.TP
\fBNOCOLOR\fR = \fI["true" | "false"]\fR
Okre¶la, czy kolory maj± byæ domy¶lnie wy³±czone.
.br
Domy¶ln± warto¶ci± jest false.
.TP

.TP
.B PORT_LOGDIR
Zmienna okre¶laj±ca katalog, w który tworzone bêd± pliki log ebuildów. Logi
bêd± tworzone tylko w przypadku, gdy zmienna ta zawieraæ bêdzie katalog, w
którym u¿ytkownik ma uprawnienia do zapisu.
.TP
\fBPORTAGE_BINHOST\fR = \fI"ftp://login:has³o@serwer.lustrzany.grp/pub/grp/i686/athlon\-xp"\fR
W zmiennej tej podajemy adres, z którego Portage bêdzie pobiera³o gotowe ju¿
pakiety binarne. Mo¿e znajdowaæ siê tutaj tylko jeden adres serwera, który
posiada w swoich zasobach pakiety .tbz2. Zmienna ta u¿ywana jest tylko w
przypadku gdy uruchamiamy \fBemerge\fR(1) z opcjami pobierania pakietów
binarnych. Wiêcej informacji znajduje siê na stronie man \fBemerge\fR(1).
Adres ten musi wskazywaæ na katalog, w którym s± tworzone pakiety binarne.

parametru nice, a jedynie go zwiêkszy. Wiêcej informacji znajduje siê w manualu
\fBnice\fR(1).
\fBPORTAGE_RSYNC_EXTRA_OPTS\fR = \fI[opcje dla rsync]\fR
Dodatkowe opcje dla rsync, u¿ywane podczas \fBemerge \-\-sync\fR.
.br
Standardowo zmienna ta jest pusta.
.TP
\fBPORTAGE_RSYNC_OPTS\fR = \fI[opcje dla rsync]\fR
Domy¶lne opcje rsync, u¿ywane podczas \fBemerge \-\-sync\fR.
.br
\fBNie nale¿y zmieniaæ tych opcji, o ile nie ma siê pewno¶ci co siê robi!\fR
.br
Standardowo warto¶æ tej zmiennej to: "--recursive --links --safe-links --perms
--times --compress --force --whole-file --delete --delete-after --stats

Zmiennej \fBROOT\fR u¿ywamy do okre¶lenia docelowego g³ównego systemu plików,
który bêdzie u¿ywany do instalacji pakietów lub ebuildów. Wszystkie zale¿no¶ci
ze zmiennych \fBRDEPEND\fR i \fBPDEPEND\fR zostan± zainstalowane w katalogu
okre¶lonym jako parametr \fBROOT\fR. Wszystkie zale¿no¶ci ze zmniennej
\fBDEPEND\fR bêd± instalowane do katalogu /. Zmienn± tê ustawiamy czê¶ciej w
samym ¶rodowisku, ni¿ w pliku \fI/etc/make.conf\fR. Powszechnie zmienna ta
u¿ywana jest do tworzenia nowych obrazów build.

.TP
\fBSYNC\fR = \fI[RSYNC]\fR
W tej zmiennej umieszczamy preferowany przez nas serwer rsync. U¿ywany jest on
do synchronizacji naszego lokalnego drzewa ka¿dorazowo przy wydaniu polecenia
`emerge \-\-sync`.
.br
Domy¶ln± warto¶ci± jest "rsync://rsync.gentoo.org/gentoo\-portage".
.TP
\fBUSE\fR = \fI[lista flag USE oddzielonych spacj±]\fR
Zmienna ta przechowuje opcje kontroluj±ce zachowanie pakietów podczas ich
kompilacji. Wiêcej informacji na ten temat mo¿na znale¼æ w \fBebuild\fR(5).
Lista warto¶ci jakich mo¿na u¿yæ znajduje siê w pliku
\fI/usr/portage/profiles/use.desc\fR.
.TP
\fBUSE_EXPAND_HIDDEN\fR = \fI[rozdzielona spacjami lista nazw zmiennych]\fR
Nazwy zmiennych w \fBUSE_EXPAND\fR, które nie powinny byæ pokazane w trybie
wy¶wietlaj±cym wiêcej informacji (\-\-verbose), przy wykonaniu polecenia
\fBemerge\fR(1).
.TP
\fBUSE_ORDER\fR = \fI"env:pkg:conf:auto:defaults"\fR

nadpisz± make.conf (conf), które nadpisz± generowane automatycznie warto¶ci dla
zainstalowanych pakietów (auto), które nadpisz± make.defaults (defaults).
.br
\fB***Ostrze¿enie***\fR
.br
Nie nale¿y modyfikowaæ tej zmiennej, je¿eli nie jest siê pewnym, z czym to siê
wi±¿e. Je¶li system zostanie uszkodzony przez jej modyfikacjê, nikt na ¶wiecie
nie bêdzie w stanie mu wtedy pomóc.
.br
Domy¶lne warto¶ci to "env:pkg:conf:defaults".

.BR ebuild (1),
.BR ebuild (5)
.TP
Skrypt \fI/usr/sbin/ebuild.sh\fR.
.TP
Aplikacje pomocnicze znajduj±ce siê w katalogu \fI/usr/lib/portage/bin\fR.
.SH T£UMACZENIE
Damian Kuras <shadoww@gentoo.org>
.br
Polski projekt t³umaczenia manuali Gentoo
.br
http://gentoo.org/~rane/tlumaczenie-manuali.html
.br
Arfrever Frehtes Taifersar Arahesis <FFTA@WP.PL>

Return to bug 149608