Content-type: text/html Manpage of MAKE.CONF

MAKE.CONF

Section: Portage (5)
Updated: Styczeń 2007
Index Return to Main Contents

TYTUŁ

make.conf - własne ustawienia dla Portage

SKŁADNIA

/etc/make.conf

OPIS

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.
Wyjątkami są zmienne przyrostowe takie jak USE, CONFIG_PROTECT* czy ACCEPT_KEYWORDS. Zmienne przyrostowe pobierane są z pliku make.defaults do make.globals, z niego następnie do make.conf i na końcu do zmiennych środowiskowych. Do usunięcia tych zmiennych wymagane jest usunięcie wszystkiego tak jak w przypadku export USE="-*".

ZMIENNE

ACCEPT_KEYWORDS = [oddzielona spacjami lista słów kluczowych (KEYWORDS)]

Uaktywnia możliwość instalowania testowych ebuildów, które nie zostały jeszcze oznaczone jako stabilne. Użytkownicy używający architektury 'x86' ustawią tę zmienną na wartość '~x86', zgodnie z tym użytkownicy używający 'ppc' ustawią ją na wartość '~ppc'. Jest to zmienne przyrostowa. Definiuje jedynie wartość ~arch.
Domyślnie ustawiona jest na wartość zmiennej $ARCH.

BUILD_PREFIX = [ścieżka]

Zmienna określająca lokalizację katalogu roboczego potrzebnego do kompilacji poszczególnych pakietów.
Wartością domyślną jest ${PORTAGE_TMPDIR}/portage

CBUILD

Zmienna ta zostaje przekazana przez skrypt ebuild do configure jako --build=${CBUILD} tylko w przypadku gdy jest zdefiniowana. Nie należy ustawiać tej zmiennej samodzielnie, chyba że jesteśmy pewni co robimy.

CCACHE_DIR = [path]

Zmienna określająca położenie katalogu roboczego dla ccache. Aby zasięgnąć większej ilości informacji, należy przejrzeć stronę manuala ccache(1).
Wartością domyślną jest /var/tmp/ccache

CCACHE_SIZE = "size"

Określa limit miejsca na dysku dla ccache. Domyślna wartość to 2 GB. Wielkość można określać przy pomocy przedrostków 'G', 'M' lub 'K'.

CFLAGS CXXFLAGS

Zmienne służące do ustawienia pożądanych optymalizacji/instrukcji dla 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 Invoking GCC podręcznika gcc:
http://gcc.gnu.org/onlinedocs/

CHOST

Zmienna ta zostaje przekazana przez skrypt ebuild do configure jako --host=${CHOST}. W ten sposób można wymusić build-host.

Po więcej informacji należy się udać pod jeden z poniższych adresów:
http://gcc.gnu.org/onlinedocs/gcc-4.1.1/gcc/Submodel-Options.html
http://gcc.gnu.org/onlinedocs/gcc-3.3/gcc/Submodel-Options.html
http://gcc.gnu.org/onlinedocs/gcc-3.2/gcc/Submodel-Options.html
http://gcc.gnu.org/onlinedocs/gcc-2.95.3/gcc_2.html

CLEAN_DELAY = liczba całkowita

Określa jak długo będzie trwało odliczanie przed wykonaniem polecenia `emerge clean`.
Domyślną wartością jest 5 sekund.

COLLISION_IGNORE = [oddzielona spacjami lista plików i/lub katalogów]

Ta zmienna pozwala użytkownikowi wyłączyć cechę collision-protect dla specyficznych plików i/lub katalogów.

CONFIG_PROTECT = [oddzielona spacjami lista plików i/lub katalogów]

Wszystkie pliki konfiguracyjne w katalogach, które zostaną wymienione w tej zmiennej będą plikami chronionymi. W celu uzyskania większej ilości informacji prosimy wydać polecenie `emerge --help config`.

CONFIG_PROTECT_MASK = [oddzielona spacjami lista plików i/lub katalogów]

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`.

CTARGET

Zmienna ta jest przekazywana przez skrypt ebuild do configure jako --target=${CTARGET} jedynie w przypadku, gdy jest zdefiniowana.

DISTDIR = [ścieżka]

Definiuje położenie lokalnego repozytorium z kodami źródłowymi.
Domyślną wartością jest ${PORTDIR}/distfiles.

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.

EMERGE_DEFAULT_OPTS

Opcje dołączane do linii poleceń emerge(1) przy każdym uruchomieniu. Nie będą one dodawane do linii poleceń, jeśli do parametrów dodamy --ignore-default-opts.

EPAUSE_IGNORE

Określa, czy krótkie przerwy spowodowane wyświetleniem ważnej informacji mają być ignorowane, czy też nie. Zmienna ta domyślnie nie jest ustawiona. Jeśli jest ustawiona na jakąkolwiek wartość, przerwy są ignorowane.

FEATURES = "sandbox ccache autoaddcvs"

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ą FEATURES i nie powinien być domyślnie wyłączony. Zmienna ta jest zmienną przyrostową.

assume-digests: W chwili zatwierdzania plików do cvs przy pomocy repoman(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 ebuild(1) i emerge(1) (emerge generuje pliki digest tylko wtedy, gdy opcja digest jest włączona).
buildpkg: Dla wszystkich instalowanych pakietów tworzone będą pakiety binarne.
buildsyspkg: Dla instalowanych pakietów z zestawu system tworzone będą pakiety binarne.
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.
confcache: Włącza wsparcie dla confcache. Jest to skrypt przechowujący odpowiedzi na pytania dla configure i przyspieszający jego działanie za pomocą funkcji pomocniczej econf. Więcej informacji w ebuild(5).
collision-protect: Cecha QA pozwalająca upewnić się, że pakiet nie nadpisze plików, które nie należą do niego. Zmienna COLLISION_IGNORE może być używana do wybiórczego wyłączenia tej cechy.
digest: Automatycznie generuje plik digest dla pakietu podczas wykonywania polecenia emerge(1). Jeśli opcja assume-digests jest także włączona, wówczas bieżące pliki digest SRC_URI zostaną ponownie wykorzystane, gdziekolwiek jest to możliwe.
distcc: Włącza obsługę distcc. distlocks 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ć pomocne w przypadku wystąpienia problemów z blokadami (z reguły w przypadku błędu lub utracenia połączenia).
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.
getbinpkg: Zmusza za każdym razem emerge do ściągnięcia źródeł z PORTAGE_BINHOST. Po więcej informacji należy udać się do make.conf(5).
gpg: Sprawdza poprawność podpisów plików Manifest.
installsources: Instaluje kod źródłowy do /usr/src/debug/${CATEGORY}/${PF} (patrz też splitdebug). Ta cecha działa tylko wtedy, gdy zainstalowany jest debugedit.
keeptemp: Nie pozwala na usunięcie katalogu ${T} po instalacji.
keepwork: Nie pozwala na usunięcie katalogu ${WORKDIR} po instalacji.
metadata-transfer: Automatycznie wykonuje przesłanie metadanych, gdy wykonywane jest polecenie `emerge --sync`.
mirror: Spowoduje to, że opcja FETCHCOMMAND będzie uruchamiana zawsze, nawet w przypadku, gdy plik będzie się znajdował już w DISTDIR.
noauto: W trakcie wykorzystywania ebuild(1), uruchamiana będzie jedynie żądana przez nas funkcja.
noclean: Zmienna ta nie pozwala na usuwanie plików źródłowych i plików tymczasowych po procesie instalacji.
nodoc: Zmienna niezezwalająca na instalację dokumentacji (/usr/share/doc).
noinfo: Zmienna niezezwalająca na instalację stron info.
noman: Zmienna niezezwalająca na instalację manuali.
nostrip: Zapobiega stripowaniu pakietów binarnych, którą zostaną zainstalowane w systemie.
notitles: Wyłącza aktualizację belki tytułowej xterm (która zawiera informację na temat aktualnego statusu).
parallel-fetch: Ściąga źródła w tle podczas kompilacji pakietów.
sandbox: Uruchamia wsparcie dla sandbox, gdy uruchamiamy emerge(1) lub ebuild(1).
severe: Akceptuje jedynie te pliki Manifest, które zostały podpisane kluczami uznanymi przez nasz system za zaufane.
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 suidctl poniżej.
sign: Gdy zatwierdzamy efekty naszej pracy programem repoman(1), podpisuje plik Manifest z użyciem klucza GPG. Więcej informacji na temat zmiennej PORTAGE_GPG_KEY znajdziemy w make.conf(5).
splitdebug: Przed stripowaniem plików ELF etdyn i etexec zapisuje informacje potrzebne do debugowania. Ta cecha jest wyłączana przez nostrip. W celu instalacji kodu źródłowego patrz na installsources.
strict: Nakazuje Portage reagować natychmiast w przypadkach uznawanych za niebezpieczne (np. niepoprawne sumy kontrolne lub ich całkowity brak).
stricter: Nakazuje Portage reagować natychmiast w przypadkach które mogą kolidować z założeniami bezpieczeństwa systemu (np. relokacje tekstu, wykonywalny stos). Więcej informacji na ten temat należy szukać pod zmiennymi QA_STRICT_* w make.conf(5).
suidctl: Przed zainstalowaniem pakietów do systemu, automatycznie stripuje bity setuid z każdego pliku nieznajdującego się na liście w pliku /etc/portage/suidctl.conf.
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 test manuala ebuild(1) i src_test() manuala ebuild(5). Ta cecha implikuję flagę USE "test".
userfetch: Gdy Portage zostanie wywołane przez użytkownika root, polecenie zostanie wykonane przez portage:portage na czas pobierania źródeł.
userpriv: Zezwala Portage na usunięcie uprawnień superużytkownika i kompilację pakietów jako portage:portage bez użycia sandbox (chyba, że flaga usersandbox jest również używana).
usersandbox: Uaktywnia wsparcie sandbox w czasie kompilacji w przypadku, gdy Portage nie pracuje z uprawnieniami superużytkownika (userpriv).

FETCHCOMMAND

Zmienna ta zawiera polecenie używane do ściągania kodów źródłowych z internetu. Musi zawierać pełną ścieżkę do pliku wykonywalnego, w taki sam sposób, jak zmienne \${DISTDIR} i \${URI}.

GENTOO_MIRRORS = [adresy URL]

W zmiennej tej umieszczamy oddzielone spacją adresy serwerów lustrzanych. Serwery te używane są do ściągania plików przed serwerami umieszczonymi w skryptach ebuild. Zainstalowanie programu "mirrorselect" może pomóc w wyborze serwerów lustrzanych.

http_proxy ftp_proxy = [adres:port]

Zmienna ta używana jest w przypadku konieczności użycia wget(1) do ściągania kodów źródłowych. Wymagana jest ona tylko w przypadku używania przez użytkownika serwera proxy do łączenia się z siecią Internet.

INSTALL_MASK = [space delimited list of file names]

Używaj tę zmienną, jeśli chcesz wybiórczo zapobiec skopiowania określonych plików do drzewa twojego systemu plików. To nie działa z dowiązaniami symbolicznymi, a tylko z plikami zwykłymi. Przydatne, jeśli życzysz sobie wyfiltrować pliki takie, jak HACKING.gz i TODO.gz.

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 CPUs+1 i 2*CPUs+1. Dla większej ilości informacji warto zobaczyć make(1).

NOCOLOR = ["true" | "false"]

Określa, czy kolory mają być domyślnie wyłączone.
Domyślną wartością jest false.

PKGDIR = [ścieżka]

Zmienna określająca położenie katalogu, w którym przechowywane będą pakiety binarne .tbz2.
Domyślną wartością jest ${PORTDIR}/packages.

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.

PORTAGE_BINHOST = "ftp://login:hasło@serwer.lustrzany.grp/pub/grp/i686/athlon-xp"

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 emerge(1) z opcjami pobierania pakietów binarnych. Więcej informacji znajduje się na stronie man emerge(1). Zauważ, że adres ten musi wskazywać na katalog "All", w którym są tworzone pakiety binarne, a nie na korzeń PKGDIR.

PORTAGE_COMPRESS = "bzip2"

Ta zmienna zawiera polecenie używane do komprymowania dokumentacji podczas fazy instalacji.

PORTAGE_COMPRESS_FLAGS = "-9"

Ta zmienna zawiera flagi dla polecenia PORTAGE_COMPRESS.

PORTAGE_ELOG_CLASSES

PORTAGE_ELOG_SYSTEM

PORTAGE_ELOG_COMMAND

PORTAGE_ELOG_MAILURI

PORTAGE_ELOG_MAILFROM

PORTAGE_ELOG_MAILSUBJECT

Dokumentację elogu przejrzyj w /etc/make.conf.example.

PORTAGE_NICENESS = [liczba]

Wartość tej zmiennej zostanie dodana do aktualnego poziomu parametru nice, z którym zostanie uruchomione emerge. Innymi słowy, zmienna ta nie ustawi poziomu parametru nice, a jedynie go zwiększy. Więcej informacji znajduje się w manualu nice(1).

PORTAGE_RSYNC_EXTRA_OPTS = [opcje dla rsync]

Dodatkowe opcje dla rsync używane podczas emerge --sync.
Standardowo zmienna ta jest pusta.

PORTAGE_RSYNC_OPTS = [opcje dla rsync]

Domyślne opcje rsync używane podczas emerge --sync.
Nie należy zmieniać tych opcji, o ile nie ma się pewności co się robi!
Standardowo wartość tej zmiennej to: "--recursive --links --safe-links --perms --times --compress --force --whole-file --delete --delete-after --stats --timeout=180 --exclude='/distfiles' --exclude='/local' --exclude='/packages'"

PORTAGE_RSYNC_RETRIES = [LICZBA]

Ilość prób, które rsync wykona, zanim zwróci informację o niepowodzeniu.
Standardowa wartość to 3.

PORTAGE_TMPDIR = [ścieżka]

Określa położenie tymczasowego katalogu potrzebnego do kompilacji pakietów.
Domyślną wartością jest /var/tmp.

PORTDIR = [path]

Określa położenie drzewa Portage.
Domyślną wartością jest /usr/portage.

PORTDIR_OVERLAY = "[ścieżka] [kolejna-ścieżka] [itd...]"

Określa położenie katalogu, w którym użytkownik może przechowywać ebuildy spoza Portage, a przy wydaniu polecenia `emerge --sync` nie zostaną one nadpisane. Katalogi oddzielone są od siebie spacją.
Domyślnie zmienna ta nie posiada wartości.

QA_STRICT_EXECSTACK = "set"

Ustawienie tej zmiennej powoduje, że Portage będzie ignorować wszelkie ustawienia QA_EXECSTACK w ebuildach. Więcej informacji w ebuild(5).

QA_STRICT_WX_LOAD = "set"

Ustawienie tej zmiennej powoduje, że Portage będzie ignorować wszelkie ustawienia QA_WX_LOAD w ebuildach. Więcej informacji w ebuild(5).

QA_STRICT_TEXTRELS = "set"

Ustawienie tej zmiennej powoduje, że Portage będzie ignorować wszelkie ustawienia QA_TEXTREL w ebuildach. Więcej infrormacji w ebuild(5).

RESUMECOMMAND

Zmienna ta zawiera polecenie potrzebne do przywrócenia ściągania pakietów, które zostały tylko częściowo ściągnięte. Powinna zostać zdefiniowana w formacie takim jak zmienna FETCHCOMMAND.

ROOT = [ścieżka]

Zmiennej ROOT 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 RDEPEND i PDEPEND zostaną zainstalowane w katalogu określonym jako parametr ROOT. Wszystkie zależności ze zmniennej DEPEND będą instalowane do katalogu /. Zmienną tę ustawiamy częściej w samym środowisku, niż w pliku /etc/make.conf. Powszechnie zmienna ta używana jest do tworzenia nowych obrazów budowy. Upewnij się, że używasz bezwzględną ścieżkę.
Domyślna wartość to /.

RPMDIR = [ścieżka]

Określa katalog, w którym będą przetrzymywane pakiety RPM.
Domyślną wartością jest ${PORTDIR}/rpm.

SYNC = [RSYNC]

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`.
Domyślną wartością jest "rsync://rsync.gentoo.org/gentoo-portage".

USE = [lista flag USE oddzielonych spacją]

Zmienna ta przechowuje opcje kontrolujące zachowanie pakietów podczas ich kompilacji. Więcej informacji na ten temat można znaleźć w ebuild(5). Lista wartości jakich można użyć znajduje się w pliku /usr/portage/profiles/use.desc.

USE_EXPAND_HIDDEN = [rozdzielona spacjami lista nazw zmiennych]

Nazwy zmiennych w USE_EXPAND, które nie powinny być pokazywane w trybie wyświetlającym więcej informacji (--verbose) polecenia emerge(1).

USE_ORDER = "env:pkg:conf:defaults:pkginternal"

Określa pierwszeństwo warstw we wzrostowym układaniu w stos zmiennej USE. Pierwszeństwo maleje z lewej do prawej tak, że env nadpisuje pkg, pkg nadpisuje conf itd.

***Ostrzeżenie***
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.

env: USE z obecnej zmiennej środowiskowej USE, jeśli ona istnieje
pkg: USE danego pakietu z /etc/portage/package.use (patrz portage(5))
conf: USE z make.conf
defaults: USE z make.defaults i package.use w profilu (patrz portage(5))
pkginternal: USE z wartości domyślnych IUSE ebuildu (flagi włączone przez przedrostek +; patrz ebuild(5))

ZGŁASZANIE BŁĘDÓW

Wszystkie błędy prosimy zgłaszać za pomocą serwisu http://bugs.gentoo.org/

AUTORZY

Daniel Robbins <drobbins@gentoo.org>
Nicholas Jones <carpaski@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
Saleem Abdulrasool <compnerd@gentoo.org>

PLIKI

/etc/make.conf: Zawiera zmienne nadpisujące te z pliku make.defaults potrzebne przy kompilacji pakietów.
/etc/make.globals: Zawiera domyślne zmienne potrzebne przy kompilacji pakietów. W celu zmodyfikowania zmiennych należy wprowadzić odpowiednie zmiany do pliku /etc/make.conf.
/usr/portage/profiles/use.desc: Zawiera listę wszystkich globalnych flag USE.
/usr/portage/profiles/use.local.desc: Zawiera listę wszystkich lokalnych flag USE.

ZOBACZ TAKŻE

emerge(1), portage(5), ebuild(1), ebuild(5)

Skrypt /usr/sbin/ebuild.sh.
Aplikacje pomocnicze znajdujące się w katalogu /usr/lib/portage/bin.

TŁUMACZENIE

Damian Kuras <shadoww@gentoo.org>
Polski projekt tłumaczenia manuali Gentoo
http://gentoo.org/~rane/tlumaczenie-manuali.html

This document was created by man2html, using the manual pages.
Time: 21:22:09 GMT, January 18, 2008