make.conf
1. make.conf.5.man
Manpage of MAKE.CONF
MAKE.CONF
Section: Portage (5)Updated: Styczeń 2007
Index Return to Main Contents
TYTUŁ
make.conf - własne ustawienia dla PortageSKŁADNIA
/etc/make.confOPIS
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
http://gcc.gnu.org/onlinedocs/gcc-3.3/gcc/Submodel-Options
http://gcc.gnu.org/onlinedocs/gcc-3.2/gcc/Submodel-Options
http://gcc.gnu.org/onlinedocs/gcc-2.95.3/gcc - 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. - Określa położenie tymczasowego katalogu potrzebnego do kompilacji pakietów.
- 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
Arfrever Frehtes Taifersar Arahesis <FFTA@WP.PL>
Index
This document was created by man2html using the manual pages.
Time: 17:40:38 GMT, May 11, 2012
