> Linux Reviews > man >

ebuild

ebuild.1.man
ebuild.5.man

1. ebuild.1.man

Manpage of EBUILD

EBUILD

Section: Portage (1)
Updated: Dec 2005
Index Return to Main Contents

NAZWA

ebuild - strona man programu ebuild - niskopoziomowego interfejsu maszyny Portage.

SK�ADNIA

ebuild plik opcja [opcje]...

OPIS

Program ebuild jest bezpo�rednim interfejsem maszyny Portage. Pozwala on na wykonywanie okre�lonych czynno�ci zwi�zanych w ebuildem przy pomocy komend lub ich grup, w celu wywo�ania specyficznych dla ebuildu kontekst�w i funkcji. Przyjmuj�c jako argumenty nazw� pliku ebuild i jedn� lub wi�cej opcji, program przetwarza skrypt ebuild i wywo�uje okre�lone polecenia. Funkcje zawarte w plikach ebuild obejmuj� pobieranie �r�de� program�w, rozpakowywanie ich, kompilowanie, instalowanie plik�w obiektowych w tymczasowym katalogu "image", instalowanie obrazu z tego katalogu w systemie, tworzenie tarballa bzip z obrazu i inne czynno�ci.

PLIK

Plik musi by� poprawnym skryptem ebuild. Wi�cej informacji na ten temat mo�na uzyska� czytaj�c stron� man ebuild(5).

OPCJE

help: Pokazuje skr�con� form� strony man oraz dodatkowe informacje specyficzne dla pakietu podanego jako pierwszy argument.
setup: Wywo�uje wszystkie w�a�ciwe pakietowi czynno�ci instalacyjne i egzotyczne testy systemu.
clean: Sprz�ta tymczasowy katalog, kt�ry zosta� stworzony przez Portage dla wskazanego pliku ebuild. Katalog ten zazwyczaj zawiera rozpakowany kod �r�d�owy oraz "obraz instalacyjny" programu (wszystkie pliki, jakie zostan� zainstalowane w systemie lub umieszczone w pakiecie). Lokalizacja katalogu, w kt�rym ma miejsce budowanie programu, okre�lona jest przez zmienn� BUILD_PREFIX. Wi�cej informacji o tej zmiennej mo�na uzysta� wykonuj�c polecenie emerge [-v] info. Opis nadpisywania jej warto�ci znajduje si� na stronie man make.conf(5).
Uwaga: Portage sprz�ta niemal wszystko po poprawnym zainstalowaniu pakietu, chyba �e zmienna FEATURES zawiera 'noclean'. Dodanie noclean do FEATURES spowoduje pozostawianie ogromnej ilo�ci plik�w i w kr�tkim czasie doprowadzi do zaj�cia du�ego obszaru pami�ci. Nie zaleca si� dodawania opcji noclean, chyba �e chcemy wykorzysta� tymczasowe pliki do instalacji w przysz�o�ci. Opcjonalnie mo�na r�cznie wyczy�ci� katalog rm -rf /var/tmp/portage, co b�dzie jednoznaczne z usuni�ciem wszystkich plik�w tymczasowych.
fetch: Sprawdza, czy wszystkie �r�d�a zawarte w zmiennej SRC_URI znajduj� si� w katalogu okre�lonym zmienn� DISTDIR (wi�cej informacji na stronie man make.conf(5)) i posiadaj� poprawne sumy md5. Je�li �r�d�a nie zostan� odnalezione, program spr�buje je pobra�, wykorzystuj�c adresy serwer�w zgromadzone w zmiennej SRC_URI. Je�li dla jednego pliku istnieje kilka �r�de�, z kt�rych mo�e on zosta� pobrany, Portage pinguje ka�d� lokalizacj�, aby sprawdzi� kt�ra z nich oferuje najszybszy transfer. Serwery lustrzane okre�lone w zmiennej GENTOO_MIRRORS zawsze s� przeszukiwane jako pierwsze. Je�li znalezione na dysku lub pobrane �r�d�a posiadaj� sumy md5 niezgodne z tymi, kt�re zosta�y zapisane w files/digest-[pakiet]-[wersja-rewizja], wy�wietlone zostanie ostrze�enie i program ebuild zako�czy dzia�anie z kodem b��du 1.
digest: Tworzy plik wyci�gu dla pakietu w katalogu /usr/portage/[kategoria]/[pakiet]/files/. Plik ten zawiera sumy md5 dla wszystkich plik�w okre�lonych w zmiennej SRC_URI. Je�li pobrane �r�d�a pakietu s� uskodzone lub zawieraj� b��dy, zostanie to wykryte na podstawie sum md5.
manifest: Aktualizuje plik manifestu dla pakietu, tworz�c sumy md5 dla plik�w w katalogu files oraz dla ebuildu.
unpack: Wypakowuje pliki do podkatalogu w katalogu budowania programu (BUILD_PREFIX) poprzez wywo�anie funkcji src_unpack() w skrypcie ebuild podanym jako argument. Je�li funkcja src_unpack() nie zosta�a zdefiniowana, program korzysta z domy�nej funkcji w celu rozpakowania plik�w okre�lonych w zmiennej SRC_URI. �r�d�a s� zazwyczaj rozpakowywane do katalogu ${BUILD_PREFIX}/[pakiet]-[wersja-rewizja]/work. Mo�e to zosta� zmienione poprzez zmienn� ${WORKDIR}.
Je�li piszemy ebuilda, chcemy mie� pewno��, �e zmienna S (okre�laj�ca katalog z rozpakowanymi �r�d�ami) wskazuje na odpowiednie miejsce. Domy�lnie katalog ten okre�lony jest jako ${WORKDIR}/${P}, wi�c cz�sto definiowanie zmiennej S nie jest konieczne. Funkcja src_unpack() jest r�wnie� odpowiedzialna za zastosowanie w�a�ciwych patchy na �r�d�ach tak, aby by�y one gotowe do kompilacji.
compile: Kompiluje rozpakowane �r�d�a poprzez wywo�anie funkcji src_compile() zdefiniowanej w pliku ebuild podanym jako argument. Gdy funkcja src_compile() rozpoczyna dzia�anie, katalogiem roboczym staje si� ten, na kt�ry wskazuje zmienna ${S}. Po zako�czeniu dzia�ania funkcji src_compile(), �r�d�a powinny by� w pe�ni skompilowane.
test: Wykonuje specyficzne dla pakietu testy, aby zweryfikowa�, czy program zosta� zbudowany poprawnie.
preinst: Wykonuje w�a�ciwe dla pakietu czynno�ci, kt�re s� konieczne przed jego zainstalowaniem w systemie.
install: Instaluje pakiet w tymczasowym katalogu instalacyjnym poprzez wywo�anie funkcji src_install(). Po zako�czeniu instalacji katalog instalacyjny (${BUILD_PREFIX}/[pakiet]-[wersja-rewizja]/image) b�dzie zawiera� wszystkie pliki, kt�re powinny zosta� zainstalowane w systemie lub w��czone do binarnego pakietu.
postinst: Wykonuje czynno�ci konieczne po zainstalowaniu pakietu w systemie. Zazwyczaj powoduje wy�wietlenie pomocnych informacji.
qmerge: Instaluje wszystkie pliki w katalogu instalacyjnym w dzia�aj�cym systemie plik�w. Proces ten przebiega nast�puj�co: po pierwsze zostaje wywo�ana funkcja pkg_preinst() (je�li zosta�a zdefiniowana). Nast�pnie pliki zostaj� zainstalowane w dzia�aj�cym systemie plik�w, a sumy md5 tych plik�w zostaj� zapisane w /var/db/pkg/${KATEGORIA}/${PN}-${PVR}/ZAWARTO��. Po przeniesieniu wszystkich plik�w do systemu, wywo�ywana jest funkcja pkg_postinst() (je�li j� zdefiniowano).
merge: Aby zainstalowa� pakiet nale�y wywo�a� program ebuild kolejno z nast�puj�cymi opcjami: fetch, unpack, compile, install i qmerge. Je�li po prostu chcemy zainstalowa� pakiet nie zwracaj�c uwagi na poszczeg�lne etapy, mo�emy skorzysta� z opcji merge, kt�ra wykona wszystkie wymienione kroki, zatrzymuj�c instalacj�, je�li co� p�jdzie nie tak.
unmerge: Ta opcja wywo�uje w pierwszej kolejno�ci funkcj� pkg_prerm (je�li zosta�a zdefiniowana). Nast�pnie powoduje usuni�cie z systemu plik�w wszystkich plik�w, kt�re posiadaj� poprawne sumy md5 i warto�ci mtime w pliku okre�laj�cym zawarto�� pakietu. Wszystkie puste katalogi zostaj� rekurencyjnie usuni�te. Ostatecznie zostaje wywo�ana funkcja pkg_postrm (je�li j� zdefiniowano). Zainstalowanie nowej wersji pakietu a nast�pnie usuni�cie starszej jest bezpieczne - jest to zalecany spos�b aktualizacji.
prerm: Powoduje wykonanie czynno�ci koniecznych przed usuni�ciem pakietu z systemu. Ma zwi�zek z unmerge.
postrm: Wykonuje czynno�ci potrzebne po usuni�ciu pakietu z systemu. Ma zwi�zek z unmerge.
config: Wykonuje specyficzne dla pakietu czynno�ci konieczne po zako�czeniu procesu instalacji. Zazwyczaj obejmuje to ustawienie plik�w konfiguracyjnych lub inne podobne dzia�ania, kt�re u�ytkownik by� mo�e b�dzie chcia� wykona�.
package: Ta opcja jest bardzo podobna do opcji merge, jednak po pobraniu �r�de�, rozpakowaniu ich, skompilowaniu i zainstalowaniu, tworzony jest tarball .tbz2. Zostaje on umieszczony w katalogu ${PKGDIR}/All (zmienna ${PKGDIR} domy�lnie wskazuje na /usr/portage/packages). W katalogu ${PKGDIR}/${CATEGORY} tworzone jest dowi�zanie symboliczne, kt�re wskazuje na pakiet w ${PKGDIR}/All.
rpm: Buduje pakiet RPM z plik�w w tymczasowym katalogu instalacyjnym. Obcenie informacje o zale�no�ciach ebuild�w nie s� do��czane do pakiet�w RPM.

ZG�ASZANIE B��D�W

Wszystkie b��dy prosimy zg�asza� za pomoc� serwisu http://bugs.gentoo.org/

AUTORZY

Achim Gottinger <achim@gentoo.org>
Daniel Robbins <drobbins@gentoo.org>
Nicholas Jones <carpaski@gentoo.org>
Mike Frysinger <vapier@gentoo.org>

PLIKI

/etc/make.conf: Zawiera zmienne, zwi�zane z procesem budowania program�w, kt�re nadpisuj� definicje z pliku make.globals.

ZOBACZ TAK�E

emerge(1), ebuild(5), make.conf(5)

Skrypt /usr/sbin/ebuild.sh
Aplikacje pomocnicze w katalogu /usr/lib/portage/bin.

T�UMACZENIE

Waldemar Kor�ub <stawrul@gmail.com>
Polski projekt t�umaczenia manuali Gentoo
http://gentoo.org/~rane/tlumaczenie-manuali

This document was created by man2html using the manual pages.
Time: 17:40:21 GMT, May 11, 2012

2. ebuild.5.man

Manpage of EBUILD

EBUILD

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

NAZWA

ebuild - format, zmienne i funkcje skrypt�w ebuild

OPIS

Program ebuild(1) przyjmuje pojedynczy skrypt ebuild jako argument. Skrypt ten zawiera zmienne i polecenia, kt�re okre�laj� w jaki spos�b nale�y pobra�, rozpakowa�, poprawi�, skompilowa�, zainstalowa� i osadzi� w systemie dany pakiet oprogramowania, u�ywaj�c jego oryginalnych �r�de�. Dodatkowo, skrypt mo�e w razie potrzeby zawiera� polecenia wykonywane przed/po procesach instalacji/deinstalacji. Wszystkie skrypty ebuild s� pisane w bashu.

PRZYK�ADY

Oto przyk�adowy prosty skrypt ebuild:

# Copyright 1999-2007 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: $

inherit some_eclass another_eclass

DESCRIPTION="Super-useful stream editor (sed)"
HOMEPAGE="http://www.gnu.org/software/sed/sed"
SRC_URI="ftp://alpha.gnu.org/pub/gnu/sed/${P}.tar.gz"

LICENSE="GPL-2"
SLOT="0"
KEYWORDS="~x86"
IUSE=""

DEPEND="virtual/libc"
RDEPEND="virtual/libc"

src_compile() {
        econf || die "could not configure"
        emake || die "emake failed"
}

src_install() {
        into /usr
        doinfo doc/sed.info
        doman doc/sed.1
        into /
        dobin sed/sed || die "dobin sed failed"
        dodir /usr/bin
        dosym /bin/sed /usr/bin/sed
        dodoc NEWS README* THANKS TODO AUTHORS BUGS ANNOUNCE
}

ZMIENNE

UWAGI NT. U�YTKOWANIA

- Wszystkie zmienne, kt�re mo�na znale�� w pliku make.conf(5) s� dla
nas dost�pne w plikach ebuild (na przyk�ad zmienne PORTAGE* i PORTDIR*)
- Przypisuj�c w skryptach ebuild warto�ci do zmiennych nie wolno stawia� spacji pomi�dzy nazw� zmiennej a znakiem r�wno�ci.

P

Zmienna ta zawiera nazw� pakietu bez numeru rewizji ebuilda. Nie wolno jej NIGDY modyfikowa�.
xfree-4.2.1-r2.ebuild --> $P=='xfree-4.2.1'

PN

Zawiera nazw� skryptu bez numeru wersji.
xfree-4.2.1-r2.ebuild --> $PN=='xfree'

PV

Zawiera numer wersji bez numeru rewizji.
xfree-4.2.1-r2.ebuild --> $PV=='4.2.1'

PR

Zawiera numer rewizji lub 'r0', je�li numer rewizji nie istnieje.
xfree-4.2.1-r2.ebuild --> $PR=='r2'

PVR

Zawiera numer wersji oraz numer rewizji.
xfree-4.2.1-r2.ebuild --> $PVR=='4.2.1-r2'

PF

Zawiera pe�n� nazw� pakietu [PN]-[PVR]
xfree-4.2.1-r2.ebuild --> $PF=='xfree-4.2.1-r2'

CATEGORY

Zawiera nazw� kategorii, do kt�rej nale�y pakiet.

A

Zawiera wszystkie pliki �r�d�owe, kt�rych wymaga pakiet. Nigdy nie nale�y definiowa� tej zmiennej. Jest ona automatycznie generowana ze zmiennej SRC_URI.

WORKDIR = "${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/work"

Zawiera �cie�k� do g��wnego katalogu, w kt�rym b�dzie budowany pakiet. Nie nale�y modyfikowa� tej zmiennej.

FILESDIR = "${PORTDIR}/${CATEGORY}/${PN}/files"

Zawiera �cie�k� do podkatalogu 'files' z katalogu pakietu w drzewie portage. Nie nale�y modyfikowa� tej zmiennej.

S = "${WORKDIR}/${P}"

Zawiera �cie�k� do tymczasowego katalogu budowania. Ze zmiennej tej korzystaj� funkcje src_compile i src_install. Dla obu tych funkcji katalogiem roboczym jest �cie�ka ze zmiennej S. Zmienn� t� mo�na zmodyfikowa�, umieszczaj�c w niej �cie�k� do katalogu, do kt�rego zosta�o rozpakowane archiwum pakietu.

T = "${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/temp"

Zawiera �ciezk� do katalogu tymczasowego. Zmiennej tej mo�emy u�ywa� zgodnie z upodobaniami.

D = "${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image"

Zawiera �cie�k� do tymczasowego katalogu instalacji. Ka�da operacja zapisu, kt�ra nie wykorzystuje pomocniczych narz�dzi i funkcji (opisanych poni�ej), powinna by� poprzedzona zmienn� ${D}. Nie nale�y modyfikowa� tej zmiennej.

PORTAGE_LOG_FILE

Zawiera �cie�k� logu budowania. Je�li zmienna PORT_LOGDIR jest nieustawiona, wtedy PORTAGE_LOG_FILE="${T}/build.log".

ROOT = "/"

Zawiera �cie�k�, kt�r� Portage powinien u�ywa� jako korze� �ywego systemu plik�w. Gdy pakiety chc� wprowadzi� zmiany do �ywego systemu plik�w, powinny to zrobi� do drzewa poprzedzonego przedrostkiem ${ROOT}. Nie nale�y zmienia� tej zmiennej.

DESCRIPTION = "Niezmiernie po�yteczny pakiet"

Zmienna ta powinna zawiera� kr�tki opis pakietu.

SRC_URI = "http://pozyteczny.com/pakiet/${P}.tar.gz"

Zawiera list� odno�nik�w URI wymaganych plik�w �r�d�owych. Mo�e zawiera� wiele odno�nik�w dla pojedynczego pliku. Lista zostanie wykorzystana, je�li plik nie zostanie znaleziony na �adnym z serwer�w w GENTOO_MIRRORS.

HOMEPAGE = "http://pozyteczny.com/"

Powinna zawiera� list� odno�nik�w URL do strony g��wnej pakietu oraz innych �r�de� informacji na jego temat.

KEYWORDS = [-~][x86,ppc,sparc,mips,alpha,arm,hppa]

Zmienna ta powinna zawiera� list� architektur, o kt�rych wiemy, �e ebuild na nich zadzia�a/nie zadzia�a. Zwykle je�li nie jeste�my pewni co do architektury, nie dodajemy jej do zmiennej. Je�li ebuild nie zadzia�a na danej architekturze, nale�y doda� j� poprzedzon� znakiem -, na przyk�ad -ppc. Je�li planujemy doda� ebuild do drzewa Portage, powinni�my poda� ~arch dla tych architektur, dla kt�rych ebuild NA PEWNO DZIA�A. (Pakiety, kt�re maj� w ten spos�b ustawiony KEYWORD mo�na odmaskowa�, ustawiaj�c zmienn� ACCEPT_KEYWORDS="~arch" w wierszu polece� lub w pliku make.conf(5)). Miarodajn� list� architektur znajdziemy w pliku /usr/portage/profiles/arch.list. Lista powinna by� uporz�dkowana alfabetycznie.

SLOT

Za pomoc� tej zmiennej ustawiamy warto�� SLOT dla pakiet�w, kt�re by� mo�e b�d� musia�y wsp�istnie�. Domy�lnie powinni�my ustawi� SLOT="0", chyba �e mamy powa�ne powody, by uczyni� inaczej. Zmienna ta ZAWSZE powinna zosta� ustawiona.

LICENSE

W tej zmiennej powinni�my umie�ci� rozdzielon� spacjami list� licencji, na kt�rych wydany jest pakiet. Ustawiane licencje _musz�_ odpowiada� tym z katalogu /usr/portage/licenses/. Je�li danej licencji nie ma jeszcze w Portage, najpierw nale�y j� tam doda�.

IUSE

Zmienna ta powinna zawiera� list� wszelkich flag USE, z kt�rych korzysta nasz skrypt. Mo�emy tu pomin�� jedynie flagi w�a�ciwe dla architektury (patrz KEYWORDS).

DEPEND

Zmienna ta powinna zawiera� list� wszystkich pakiet�w, kt�re musz� by� ju� zainstalowane, aby nasz pakiet da� si� skompilowa�.

Atomy DEPEND

Atom depend to po prostu zale�no��, kt�rej Portage u�ywa przy obliczaniu powi�za� mi�dzy pakietami. Nale�y zauwa�y�, �e je�li dany Atom nie zosta� jeszcze zainstalowany, dopasowywana jest najnowsza dost�pna wersja.

Podstawy atom�w

Podstawy atom�w to po prostu kompletna specyfikacja kategoria/nazwapakietu. Oto przyk�adowe podstawy atom�w:

sys-apps/sed
sys-libs/zlib
net-misc/dhcp

Wersje atom�w

Czasem mo�emy potrzebowa� okre�li� precyzyjnie jakie wersje atom�w s� nam potrzebne. Nale�y jedynie zwr�ci� uwag�, �e numery wersji musz� by� ��czone przedrostkiem (patrz ni�ej). Dlatego numery wersji dodajemy jako przyrostek do reszty:

sys-apps/sed-4.0.5
sys-libs/zlib-1.1.4-r1
net-misc/dhcp-3.0_p2

Numer wersji zwykle sk�ada si� z dw�ch lub trzech liczb, oddzielonych kropkami, na przyk�ad 1.2 lub 4.5.2. Ten ci�g znak�w mo�e by� czasem zako�czony liter�, na przyk�ad 1.2a lub 4.5.2z. Nale�y zwr�ci� uwag�, �e znak ten nie ma oznacza� statusu alpha, beta, itd... Do tego s�u�� osobne przyrostki: _alpha, _beta, _pre (pre-release), _rc (release canditate) lub _p (patch). Czyli dla trzeciej wersji pre-release pakietu napisaliby�my na przyk�ad 1.2_pre3.

Operatory przedrostkowe atom�w [> >= = <= <]

Czasem mo�emy potrzebowa� okre�li� zale�no�� od og�lnych zakres�w wersji pakiet�w, zamiast podawa� za ka�dym razem konkretn� wersj�. Do tego celu s�u�� standardowe operatory Boole'a:

>media-libs/libgd-1.6
>=media-libs/libgd-1.6
=media-libs/libgd-1.6
<=media-libs/libgd-1.6
<media-libs/libgd-1.6

Rozszerzone przedrostki [!~] i przyrostki [*] atom�w

Na tym nie koniec funkcjonalno�ci. W razie potrzebny mo�emy zdefiniowa� pakiety blokuj�ce oraz okre�li� zakres interesuj�cych nas wersji pakiet�w. Nale�y te� zwr�ci� uwag�, �e te rozszerzone przyrostki i przedrostki mo�na dowolnie ��czy� z klasami atom�w, opisanymi wy�ej. Oto kilka typowych przyk�ad�w z drzewa Portage:

!app-text/dos2unix
=dev-libs/glib-2*
!=net-fs/samba-2*
~net-libs/libnet-1.0.2a

! oznacza, �e dany pakiet nie mo�e by� zainstalowany w tym samym czasie
* oznacza, �e interesuje nas zainstalowanie dowolnej wersji pakietu z podan� podstaw�. Tak wi�c w przypadku '2*' interesuj� nas wersje '2.1', '2.2',
~ oznacza, �e interesuje nas dowolna rewizja podstawowej wersji podanego pakietu. W powy�szym przyk�adzie wi�c mog� to by� wersje '1.0.2a', '1.0.2a-r1',

Dynamiczne zale�no�ci

Czasem, zale�nie od u�ytych flag USE, programy mog� posiada� zmienn� list� zale�no�ci. Portage daje nam kilka sposob�w na poradzenie sobie z t� sytuacj�. Zauwa�my tylko, �e gdy u�ywamy poni�szych przyk�ad�w sk�adni, ka�dy przypadek jest traktowany jako jeden Atom w kontek�cie, w kt�rym si� pojawia. Oznacza to, �e ka�dy Atom mo�e warunkowo w��cza� wiele atom�w, jak i mo�e by� zagnie�d�ony w niesko�czono��.

usevar? ( Atom DEPEND )

Aby do��czy� bibliotek� jpeg gdy u�ytkownik ustawi� flag� jpeg w USE, nale�y u�y� poni�szej sk�adni:
jpeg? ( media-libs/jpeg )

!usevar? ( Atom )

Je�li chcemy do��czy� pakiet tylko wtedy, gdy u�ytkownik nie w��czy� okre�lonej flagi w zmiennej USE, nale�y u�y� poni�szej sk�adni:
!nophysfs? ( dev-games/physfs )
Cz�sto przydaje si� to wtedy, gdy chcemy doda� opcjonalne, lecz domy�lnie w��czone wsparcie dla jakiej� funkcji.

usevar? ( Atom je�li prawda ) !usevar? ( Atom je�li fa�sz )

Obs�uga funkcjonalno�ci takiej jak operator tr�jargumentowy z j�zyka C odbywa si� za pomoc� dw�ch wyra�e�, jednego zwyk�ego, drugiego odwr�conego. Je�li pakiet korzysta z GTK1 lub GTK2, ale nie obu na raz, mo�emy obs�u�y� to w ten spos�b:
gtk2? ( =x11-libs/gtk+-2* ) !gtk2? ( =x11-libs/gtk+-1* )
W ten spos�b domy�lnie b�dzie wykorzystywa� lepsz� bibliotek� GTK2.

|| ( Atom Atom ... )

Gdy pakiet mo�e korzysta� z kilku r�nych pakiet�w, a u�ycie pakietu wirtualnego nie jest wskazane, mo�na zastosowa� tak� sk�adni�.

|| (
app-games/unreal-tournament
app-games/unreal-tournament-goty
)

W tym przyk�adzie wida�, �e unreal-tournament posiada normaln� wersj� oraz wersj� goty. Oba pakiety posiadaj� te same pliki podstawowe i dla innych pakiet�w nie ma znaczenia kt�ry z nich b�dzie zainstalowany. Jednak dodanie pakietu wirtualnego nie jest wskazane ze wzgl�du na ma�� wag� problemu.
Innym dobrym przyk�adem jest sytuacja, gdy pakiet mo�e zosta� skompilowany z wieloma interfejsami wideo, ale mo�e posiada� w danym czasie tylko jeden z nich.

|| (
sdl? ( media-libs/libsdl )
svga? ( media-libs/svgalib )
opengl? ( virtual/opengl )
ggi? ( media-libs/libggi )
virtual/x11
)

W tym przypadku zostanie wybrany tylko jeden z pakiet�w, za� kolejno��, w jakiej b�d� wybierane, ustala ich kolejno�� na li�cie. Tak wi�c sdl ma najwi�ksze szanse na bycie wybranym, zaraz po nim svga, nast�pnie opengl, ggi, za� jesli u�ytkownik nie poda �adnej z poprzednich opcji, wybrany zostanie domy�lny interfejs, X.

RDEPEND

Zmienna ta powinna zawiera� list� wszystkich pakiet�w, kt�re s� wymagane, aby program uruchomi� si� (m�wimy o nich te� jako o zale�no�ciach czasu uruchamiania). Je�li zmienna ta nie zostanie ustawiona, przyjmie t� sam� warto��, co zmienna DEPEND.
Wszystkie powy�sze sposoby definiowania zmiennych zale�no�ci dotycz� r�wnie� tej zmiennej.

PDEPEND

Zmienna ta powinna zawiera� list� wszytkich tych pakiet�w, kt�re musz� zosta� zainstalowane zaraz po zainstalowaniu naszego programu.
Wszystkie powy�sze sposoby definiowania zmiennych zale�no�ci dotycz� r�wnie� tej zmiennej.

RESTRICT = [strip,mirror,fetch,userpriv]

W tej zmiennej powinni�my zawrze� rozdzielon� spacjami list� restrykcji co do opcji Portage.

binchecks: Wy��cza wszelkie sprawdzania QA dla plik�w binarnych. To powinno by� u�ywane TYLKO w wypadku pakiet�w, w kt�rych wypadku sprawdzania plik�w binarnych nie maj� sensu (np. w wypadku linux-headers i kernel-sources mo�na bezpiecznie omin�� te sprawdzania, poniewa� nie maj� te pakiety plik�w binarnych). Je�li sprawdzania plik�w binarnych musz� by� omini�te z innych powod�w (jak w�asno�ciowe pliki binarne), przejrzyj sekcj� ZMIENNE KONTROLNE QA w celu dok�adniejszych wyja�nie�.
confcache: Wy��cza u�ycie confcache przez econf.
fetch: Podobne do opcji mirror, ale pliki nie b�d� r�wnie� pobierane z SRC_URI.
mirror: Pliki wymienione w zmiennej SRC_URI nie b�d� pobierane z wymienionych w zmiennej GENTOO_MIRRORS serwer�w lustrzanych Gentoo.
primaryuri: Najpierw nale�y pobra� pliki z URL-i wymienionych w zmiennej SRC_URI, zanim wykorzystane zostan� serwery lustrzane z listy zawartej w GENTOO_MIRRORS.
strip: B�d�ce ostatecznym produktem kompilacji pliki binarne i biblioteki nie b�d� pozbawiane symboli debugowania.
test: Funkcja src_test nie zostanie uruchomiona, nawet je�li u�ytkownik ustawi� zmienn� FEATURES=test.
userpriv: Wy��cza funkcj� userpriv dla okreslonych pakiet�w.

PROVIDE = "virtual/TARGET"

Powinni�my u�y� tej zmiennej tylko wtedy, gdy pakiet dostarcza funkcjonalno�ci wirtualnej. Przyk�adowo, pakiety blackdown-jdk i sun-jdk dostarczaj� virtual/jdk. Pozwala to pakietom zdefiniowa� zale�no�� od pakietu virtual/jdk, zamiast konkretnie od pakiet�w blackdown lub sun.

ZMIENNE KONTROLNE QA

U�YCIE: Jest kilka zmiennych QA, kt�re pozwalaj� ebuildowi wykonywa� par� manipulacji zwi�zanych z testami QA. U�ycie tych zmiennych powinno by� jak najmniejsze. W innym wypadku, �ama�y by zasady test�w QA ustanowione przez grup� QA. Ich podstawowym zastosowaniem jest u�ycie w ebuildach, kt�re instaluj� zamkni�te oprogramowanie, kt�re nie mo�e by� modyfikowane.
Nalezy pami�ta�, �e obiekty, kt�re �ami� te zasady mog� nie dzia�a� na pewnych architekturach.
QA_TEXTRELS: Ta zmienna mo�e by� ustawiona jako lista plik�w, relatywnie do katalogu z obrazem, dla plik�w, kt�rych przeniesienie nie mo�e zosta� wyelminowane. �cie�ka mo�e zawiera� wyra�enia regularne.
Ta zmienna jest przeznaczona do u�ycia z zamkni�tym oprogramowaniem, kt�re nie mo�e by� modyfikowane.
QA_EXECSTACK: Ta zmienna powinna zawiera� list� plik�w, relatywn� do katalogu z obrazem, obiekt�w kt�re wymagaj� wykonywalnego stosu, by m�c dzia�a�. �cie�ka mo�e zawiera� wyra�enia regularne.
Ta zmienna jest przeznaczona do u�ycia z obiektami, kt�re rzeczywi�cie wymagaj� wykonywalnego stosu (np. nie te, kt�re twierdz�, �e wymagaj�, ale w rzeczywisto�ci nie).
QA_WX_LOAD: Ta zmienna powinna zawiera� list� plik�w, relatywn� do katalogu z obrazem, plik�w, kt�re zawieraj� zapisywalne i wykonywalne cz�ci. Rzadko spotykane. �cie�ka mo�e zawiera� wyra�enia regularne.

DEKLARACJE PORTAGE

inherit: Funkcjonalno�� "inherit" (dziedziczenia) to spos�b zarz�dzania specjalnymi klasami funkcji w Portage, kt�re s� zdefiniowane poza ebuildami i dostarczaj� danych i mo�liwo�ci, kt�re mo�na dziedziczy�. Definiuj� funkcje i typy danych jako �atwo wymienialne cz�ci, rozszerzone oraz uproszczone fragmenty kodu, s�u��ce do wykonywania najbardziej typowych zada� i czyni�ce proces budowania bardziej eleganckim. Deklaracja inherit mo�e by� u�yta w ebuildzie tylko raz i nigdy nie mo�e by� u�yta wewn�trz jakichkolwiek instrukcji warunkowych. Eklasy nale�y podawa� pos�ugujac si� wy��cznie ich nazw�, pomijaj�c rozszerzenie .eclass. "inherit" musi si� pojawi� przed deklaracj� zmiennych.

FUNKCJE

pkg_nofetch: Je�li dodamy opcj� fetch do zmiennej RESTRICT, w�wczas zostanie uruchomiona niniejsza funkcja, o ile nie b�dzie mo�na znale�� plik�w wymienionych w zmiennej SRC_URI. Funkcja ta przydaje si� g��wnie wtedy, gdy trzeba poinformowa� u�ytkownika w jaki spos�b samemu zdoby� wspomniane pliki. Powinni�my jedynie wy�wietli� komunikat i pozwoli� funkcji samej zako�czy� dzia�anie. Nie nale�y wywo�ywa� na ko�cu funkcji die.
pkg_setup: Z tej funkcji korzystamy wtedy, gdy pakiet wymaga wykonania specjalnych polece� konfiguruj�cych lub sprawdze�, kt�re musz� by� wykonane na samym poczatku.
Pocz�tkowy katalog roboczy to ${PORTAGE_TMPDIR}.
src_unpack: Funkcji tej u�ywa si� w celu rozpakowania wszystkich plik�w �r�d�owych z katalogu A do katalogu WORKDIR. Je�li funkcja nie b�dzie zdefiniowana w skrypcie ebuild, automatycznie wywo�ana zostanie unpack ${A}. Nak�adanie �atek i inne modyfikacje dokonywane przed procesem konfigurowania i kompilacji powinny by� wykonane tutaj.
Pocz�tkowy katalog roboczy to $WORKDIR.
src_compile: Wszystkie czynno�ci niezb�dne przy konfiguracji i kompilacji powinny by� wykonane tutaj.
Pocz�tkowy katalog roboczy to $S.
src_test: Wykonuje wszystkie procedury testuj�ce danego pakietu. Domy�lnie uruchamia polecenie 'make check', a nast�pnie 'make test'.
Pocz�tkowy katalog roboczy to $S.
src_install: Funkcja ta powinna zawiera� wszystkie niezb�dne czynno�ci, maj�ce na celu zainstalowanie pakietu w tymczasowym katalogu instalacji.
Pocz�tkowy katalog roboczy to $S.
pkg_preinst pkg_postinst: W tych funkcjach powinni�my dokonywa� wszelkich tych zmian w prawdziwym systemie plik�w, kt�re musz� by� wykonane przed lub po osadzeniu pakietu w systemie. R�wnie� komentarze dla u�ytkownika powinny znajdowa� si� w tym miejscu, gdy� w�wczas b�d� wy�wietlone jako ostatnie.
Pocz�tkowy katalog roboczy to $PWD.
pkg_prerm pkg_postrm: Funkcje analogiczne do pkg_*inst, lecz s�u��ce do odinstalowania.
Pocz�tkowy katalog roboczy to $PWD.
pkg_config: Funkcja ta powinna zawiera� opcjonalne podstawowe czynno�ci konfiguracyjne.
Pocz�tkowy katalog roboczy to $PWD.

FUNKCJE POMOCNICZE: OG�LNE

die [pow�d]

Powoduje przerwanie aktualnego procesu instalacji. Zostanie wy�wietlony komunikat pow�d.

use <flaga USE>

Je�li flaga USE znajduje si� w zmiennej USE, niniejsza funkcja zwr�ci 0 (warto�� "prawda" pow�oki), nie wypisuj�c niczego. Je�li flagi USE nie ma w zmiennej USE, funkcja zwr�ci warto�� 1 (warto�� "fa�sz" pow�oki), nie wypisuj�c niczego. Polecenie usev pe�ni t� sam� funkcj� co use, lecz wypisuje wi�cej komunikat�w.

Przyk�ad:

if use gnome ; then
        guiconf="--enable-gui=gnome --with-x"
elif use gtk ; then
        guiconf="--enable-gui=gtk --with-x"
elif use X ; then
        guiconf="--enable-gui=athena --with-x"
else
        # Nie zostanie zbudowana wersja z gui
        guiconf=""
fi

use_with <flaga USE> [parametr configure] [opcja configure]

Funkcja przydatna przy tworzeniu w�asnej listy opcji, kt�re chcemy przekaza� do skryptu configure. Je�li flaga USE znajduje si� w zmiennej USE i podamy opcj� configure, w�wczas zostanie wypisany napis --with-[parametr configure]=[opcja configure]. Je�li nie podamy opcji configure, w�wczas wypisane zostanie tylko --with-[parametr configure]. Je�li flagi USE nie ma w zmiennej USE, wypisany zostanie napis --without-[parametr configure]. Je�li nie podamy parametru configure, w�wczas zamiast niego zostanie u�yta flaga USE.

Przyk�ady:

USE="opengl"
myconf=$(use_with opengl)
(zmienna myconf ma teraz warto�� "--with-opengl")

USE="jpeg"
myconf=$(use_with jpeg libjpeg)
(zmienna myconf ma teraz warto�� "--with-libjpeg")

USE=""
myconf=$(use_with jpeg libjpeg)
(zmienna myconf ma teraz warto�� "--without-libjpeg")

USE="sdl"
myconf=$(use_with sdl SDL all-plugins)
(zmienna myconf ma teraz warto�� "--with-SDL=all-plugins")

use_enable <flaga USE> [parametr configure] [opcja configure]

Funkcja dzia�a analogicznie jak use_with, tylko �e opcje do configure to --enable- zamiast --with- oraz --disable- zamiast --without-.

has <element> <lista element�w>

Je�li element znajduje si� na li�cie element�w, w�wczas element zostanie wypisany na ekran, a funkcja has zwr�ci 0. W przeciwnym wypadku nic nie zostanie wypisane, a funkcja zwr�ci 1. Analogicznie jak w przypadku funkcji use, istnieje funkcja hasq, kt�ra nic nie wypisuje na ekran. Nale�y u�ywa� jej wsz�dzie tam, gdzie to, co funkcja wypisuje, jest nieistotne. Nigdy nie nale�y u�ywa� tych danych do oblicze�.
Zmienna IFS decyduje o znaku, kt�ry b�dzie oddziela� poszczeg�lne elementy listy element�w. Zmienna ta przyjmuje domy�ln� warto�� ' ', czyli spacj�. Jest to ustawienie pow�oki bash(1).

has_version <kategoria/pakiet-wersja>

Funkcja sprawdza czy kategoria/pakiet-wersja jest zainstalowana. Wszystkie warto�ci, jakie s� akceptowalne w zmiennej DEPEND mog� by� u�yte jako parametr funkcji. Zwraca ona 0 je�li <kategoria/pakiet-wersja> jest zainstalowana, za� 1 je�li nie.

best_version <nazwa pakietu>

Funkcja ta wyszuka nazw� pakietu w bazie danych aktualnie zainstalowanych program�w i wypisze na ekran "najlepsz� wersj�" spo�r�d nich.

Przyk�ad:: VERINS="$(best_version net-ftp/glftpd)"
(Zmienna VERINS posiada teraz warto�� "net-ftp/glftpd-1.27" je�li zainstalowany jest pakiet glftpd-1.27)

FUNKCJE POMOCNICZE: WYPISYWANIE NA EKRAN

einfo "dyspozycjyjna wiadomo��": Takie samo jak elog, ale powinno by� u�ywane, gdy wiadomo�� nie jest wa�na dla u�ytkownika (jak wiadomo�ci post�pu lub stanu podczas procesu budowania).
elog "powiadomienie": Je�li chcemy wypisa� komunikat, na kt�ry u�ytkownik powinien zwr�ci� uwag� i go przeczyta�, powinni�my u�y� funkcji elog. Dzia�a ona podobnie jak echo(1), tylko wy�wietla tekst tak, aby przyci�gn�� uwag� u�ytkownika. Wiadomo�� zostanie tak�e zalogowana przez Portage dla p�niejszego przegl�du.
ewarn "ostrze�enie": Funkcja dzia�a podobnie jak einfo, lecz powinna by� u�ywana wtedy, gdy chcemy ostrzec u�ytkownika.
eerror "komunikat b��du": Funkcja dzia�a podobnie jak einfo, lecz powinna by� u�ywana wtedy, gdy chcemy powiadomi� u�ytkownika o b��dzie.
ebegin "komunikat": Podobnie jak w przypadku funkcji einfo, wypisujemy komunikat, daj�c do zrozumienia, �e wykonywana operacja mo�e zaj�� troch� czasu. Gdy zako�czy si� ona, musimy wywo�a� funkcj� eend.
eend <status> ["komunikat b��du"]: Funkcja ta dopisuje do komunikatu funkcji ebegin znacznik "OK" lub "!!" (w przypadku wyst�pienia b��du). Je�li status jest niezerowy, dodatkowo zostanie wypisany komunikat b��du.

FUNKCJE POMOCNICZE: ROZPAKOWYWANIE

unpack <�r�d�o> [lista nast�pnych �r�de�]: Funkcja ta rozpakowuje archiwa i/lub pliki tar z listy �r�de� do bie��cego katalogu. Opr�cz rozpakowania, funkcja do��czy �r�d�o do zmiennej DISTDIR.

FUNKCJE POMOCNICZE: KOMPILACJA

econf [opcje configure]

Funkcji tej u�ywa si� zamiast skryptu configure. Wykonuje ona nast�puj�ce polecenie:

configure \
        --prefix=/usr \
        --host=${CHOST} \
        --mandir=/usr/share/man \
        --infodir=/usr/share/info \
        --datadir=/usr/share \
        --sysconfdir=/etc \
        --localstatedir=/var/lib \
        ${EXTRA_ECONF} \
        opcje configure

Nale�y zwr�ci� uwag�, �e zmienna EXTRA_ECONF ma s�u�y� u�ytkownikom, a nie autorom ebuild�w. Je�li chcemy przekaza� skryptowi configure wi�cej opcji, nale�y to zrobi� poprzez dodanie argument�w do funkcji econf.

emake [opcje make]

Funkcji tej u�ywa si� zamiast polecenia make. Wykonuje ona polecenie 'make ${MAKEOPTS} opcje make' (zgodnie z ustawieniami w pliku /etc/make.globals), domy�ln� warto�ci� jest MAKEOPTS="-j2".

***uwaga***
je�li zamierzamy u�y� funkcji emake, powinni�my upewni� si�, �e kompilowany program poradzi sobie z budowaniem r�wnoleg�ym (make -j2). Nale�y to dok�adnie przetestowa�, poniewa� budowanie r�wnoleg�e najcz�ciej zawodzi _czasem_, a nie za ka�dym razem. Je�li stwierdzimy, �e nasz pakiet nie buduje si� r�wnolegle i nie b�dziemy potrafili tego naprawi�, powinni�my wywo�ywa� 'emake -j1' zamiast 'make'.

FUNKCJE POMOCNICZE: INSTALACJA

einstall [opcje make]

Funkcji tej u�ywa si� zamiast polecenia make install. Wykonuje ona nast�puj�ce polecenie:

make \
        prefix=${D}/usr \
        datadir=${D}/usr/share \
        infodir=${D}/usr/share/info \
        localstatedir=${D}/var/lib \
        mandir=${D}/usr/share/man \
        sysconfdir=${D}/etc \
        ${EXTRA_EINSTALL} \
        opcje make \
        install

Nie nale�y u�ywa� tej funkcji zamiast 'emake install DESTDIR=${D}'. Jest to bowiem preferowany spos�b instalowania pakiet�w opartych na make. Nie nale�y r�wnie� wykorzystywa� zmiennej EXTRA_EINSTALL, gdy� s�u�y ona u�ytkownikom.

prepall

prepalldocs

prepallinfo

prepallman

prepallstrip

Funkcje te przydaj� si�, gdy program jest instalowany do katalogu ${D} poprzez skrypty (na przyk�ad pliki Makefile). Je�li chcemy upewni� si�, �e biblioteki s� wykonywalne, pliki aclocal s� instalowane we w�a�ciwym miejscu, pliki doc/info/man s� skomprymowane, a pliki wykonywalne zosta�y pozbawione symboli debugowania, powinni�my u�y� tego zestawu funkcji.

prepall:: Funkcja wywo�uje funkcje prepallman, prepallinfo, prepallstrip, ustawia uprawnienia wykonywalno�ci dla bibliotek i sprawdza katalogi aclocal. Nale�y zauwa�y�, �e funkcja ta *nie* wywo�uje funkcji prepalldocs.
prepalldocs:: Komprymuje pliki z dokumentacj� w katalogu ${D}/usr/share/doc.
prepallinfo:: Komprymuje pliki info w katalogu ${D}/usr/share/info.
prepallman:: Komprymuje pliki man w katalogu ${D}/usr/share/man.
prepallstrip:: Usuwa symbole debugowania ze wszystkich plik�w wykonywalnych i bibliotek.

prepinfo [katalog]

prepman [katalog]

prepstrip [katalog]

Funkcje r�ni� si� nieznacznie od funkcji prepall.

prepinfo:: Je�li katalog nie zosta� podany, funkcja prepinfo b�dzie dzia�a� na katalogu usr. Jej dzia�anie polega na skomprymowaniu wszystkich plik�w w katalogu ${D}/katalog/info.
prepman:: Je�li katalog nie zosta� podany, funkcja prepman b�dzie dzia�a� na katalogu usr. Jej dzia�anie polega na skomprymowaniu wszystkich plik�w w katalogu ${D}/dir/man/*/.
prepstrip:: Wszystkie pliki w katalogu ${D}/katalog zostan� pozbawione symboli debugowania. Mo�liwe jest podanie wi�cej ni� jednego katalogu.

dosed "s:orygina�:zmiana:g" <plik>

Uruchamia program sed (w tym skopiowanie/przeniesienie pliku) dla pliku.
'dosed s:/usr/local:/usr:g /usr/bin/jaki�-skrypt' uruchamia program sed dla pliku ${D}/usr/bin/jaki�-skrypt

dodir <�cie�ka>

tworzy katalog wewn�trz katalogu ${D}.
'dodir /usr/lib/apache' tworzy katalog ${D}/usr/lib/apache. Zauwa�my, �e funkcje do* wywo�aj� funkcj� dodir za nas.

diropts [opcje dla programu install(1)]

Funkcja ta mo�e zosta� u�yta do podania opcji funkcji install, kt�r� wykorzystuje funkcja dodir. Domy�lne opcje to -m0755.

into <�cie�ka>

Ustawia katalog g��wny (DESTTREE) dla pozosta�ych funkcji, takich jak dobin, dosbin, doman, doinfo, dolib.
Domy�lnym katalogiem g��wnym jest /usr.

keepdir <�cie�ka>

Instruuje portage, aby nie kasowa� katalogu, nawet je�li jest pusty. Dzia�a tak samo jak funkcja dodir.

dobin <plik binarny> [wi�cej plik�w binarnych]

Instaluje plik binarny lub ca�� ich list� do katalogu DESTTREE/bin. W razie potrzeby tworzy katalogi.

dosbin <plik binarny> [wi�cej plik�w binarnych]

Instaluje plik binarny lub ca�� ich list� do katalogu DESTTREE/sbin. W razie potrzeby tworzy katalogi.

doinitd <skrypt init.d> [wi�cej skrypt�w init.d]

Instaluje skrypty init.d Gentoo. Zostan� zainstalowane w prawid�owym dla Gentoo katalogu dla tego rodzaju plik�w (/etc/init.d/). W razie potrzeby zostan� utworzone potrzebne katalogi.

doconfd <plik conf.d> [wi�cej plik�w conf.d]

Instaluje pliki conf.d Gentoo. Zostan� zainstalowane w prawid�owym dla Gentoo katalogu dla tego rodzaju plik�w (/etc/conf.d/). W razie potrzeby zostan� utworzone potrzebne katalogi.

doenvd <plik env.d> [wi�cej plik�w env.d]

Instaluje pliki env.d Gentoo. Zostan� zainstalowane w prawid�owym dla Gentoo katalogu dla tego rodzaju plik�w (/etc/env.d/). W razie potrzeby zostan� utworzone potrzebne katalogi.

dolib <biblioteka> [wi�cej bibliotek]

dolib.a <biblioteka> [wi�cej bibliotek]

dolib.so <biblioteka> [wi�cej bibliotek]

Funkcje te instaluj� bibliotek� lub ca�� ich list� w katalogu DESTTREE/lib. W razie potrzeby tworzy katalogi.

libopts [opcje dla funkcji install(1)]

Funkcji tej mo�emy u�y�, aby zdefiniowa� opcje dla funkcji install, z kt�rej korzystaj� funkcje dolib. Domy�lna opcja to -m0644.

doman [-i18n=<locale>] <strona man> [wi�cej stron man]

Instaluje strony dokumentacji systemowej man do katalogu /usr/share/man/man[0-9n], w zale�no�ci od ko�c�wki pliku man. Pliki zostan� skomprymowane, je�li jeszcze nie s�. Mo�emy poda� strony man specyficzne dla u�ywanego locale za pomoc� opcji -i18n. W�wczas strona podr�cznika zostanie zainstalowana do katalogu /usr/share/man/<locale>/man[0-9n].

dohard <nazwa pliku> <nazwa dowi�zania>

dosym <nazwa pliku> <nazwa dowi�zania>

Wykonuje polecenie ln tworz�c albo dowi�zanie twarde (hard), albo symboliczne (sym).

d [-a typy-plik�w] [-r] [-x lista-katalog�w-do-pomini�cia] [lista-plik�w-i-katalog�w]

Instaluje pliki z listy (nazwy plik�w rozdzielone spacjami) do katalogu /usr/share/doc/${PF} pod warunkiem, �e nazwa pliku ko�czy si� na , poprzez u�ycie opcji -a, za� za pomoc� opcji -A mo�emy doda� typy plik�w do listy domy�lnych. Poprzez parametr -x mo�emy okre�li� katalogi do pomini�cia (domy�lnie pomijany jest katalog CVS), za� parametr -r w��cza prac� rekursywn�.

doinfo <pliki-info> [wi�cej plik�w info]

Instaluje pliki dokumentacji info do katalogu DESTDIR/info. Pliki s� automatycznie komprymowane za pomoc� narz�dzia gzip. W razie potrzeby tworzy katalogi.

domo <plik locale> [wi�cej plik�w locale]

Instaluje pliki locale do katalogu DESTDIR/usr/share/locale/[LANG], w zale�no�ci od ko�c�wki nazwy pliku. Tworzy katalogi w razie potrzeby.

fowners <uprawnienia> <plik> [wi�cej plik�w]

fperms <uprawnienia> <plik> [wi�cej plik�w]

Wykonuje polecenie chown (funkcja fowners) lub chmod (funkcja fperms), nadaj�c uprawnienia plikom.

insinto [�cie�ka]

Ustawia katalog g��wny (INSDESTTREE) dla funkcji doins.
Domy�lnym katalogiem g��wnym jest /.

insopts [opcje dla funkcji install(1)]

Funkcji tej mo�emy u�y�, aby zdefiniowa� opcje dla funkcji install, z kt�rej korzysta funkcja doins. Domy�lne opcje to -m0644.

doins <plik> [wi�cej plik�w]

Instaluje pliki do katalogu INSDESTTREE. Funkcja ta korzysta z funkcji install(1). W razie potrzeby tworzy niezb�dne katalogi.

exeinto [�cie�ka]

Ustawia katalog g��wny (EXEDESTTREE) dla funkcji doexe.
Domy�lnym katalogiem g��wnym jest /.

exeopts [opcje dla funkcji install(1)]

Funkcji tej mo�emy u�y�, aby zdefiniowa� opcje dla funkcji install, z kt�rej korzysta funkcja doexe. Domy�lne opcje to -m0755.

doexe <plik wykonywalny> [wi�cej plik�w wykonywalnych]

Instaluje jeden lub wi�cej plik�w wykonywalnych do katalogu EXEDESTTREE. Funkcja ta korzysta z funkcji install(1). W razie potrzeby tworzy niezb�dne katalogi.

docinto [�cie�ka]

Ustawia podkatalog wzgl�dny (DOCDESTTREE), z kt�rego korzysta funkcja dodoc.

dodoc <dokument> [wi�cej dokument�w]

Instaluje jeden lub wi�cej dokument�w do katalogu /usr/share/doc/${PF}/DOCDESTTREE. Pliki s� automatycznie komprymowane za pomoc� narz�dzia gzip. W razie potrzeby tworzy niezb�dne katalogi.

newbin <stary plik> <nowa nazwa pliku>

newsbin <stary plik> <nowa nazwa pliku>

newinitd <stary plik> <nowa nazwa pliku>

newconfd <stary plik> <nowa nazwa pliku>

newenvd <stary plik> <nowa nazwa pliku>

newlib <stary plik> <nowa nazwa pliku>

newlib.so <stary plik> <nowa nazwa pliku>

newlib.a <stary plik> <nowa nazwa pliku>

newman <stary plik> <nowa nazwa pliku>

newinfo <stary plik> <nowa nazwa pliku>

newins <stary plik> <nowa nazwa pliku>

newexe <stary plik> <nowa nazwa pliku>

newdoc <stary plik> <nowa nazwa pliku>

Wszystkie powy�sze funkcje dzia�aj� analogicznie jak funkcje do*, tylko pracuj� z jednym plikiem i jest on instalowany pod nazw� [nowa nazwa pliku].