Gentoo ebuild - 8 (EAPI 2)

10. 2. 2009 | David Watzke

Články - Gentoo ebuild - 8 (EAPI 2)  

Co nového přináší EAPI 2? Závislosti na nastavení USE flagů, novou funkci src_prepare, oddělení konfigurační fáze z funkce src_compile do src_configure, možnost úpravy názvů souborů stahovaných do distfiles a volání výchozích definicí jednotlivých fází a další novinky.

Obsah

• Závislost na USE
• Blokující balíčky
• Názvy souborů stahovaných do distfiles
• Nové a změněné funkce
• doman podporuje jazyky

O tom, co je to EAPI a jak zvolit použitou verzi, se dočtete v předchozím díle seriálu: Gentoo ebuild - 7 (EAPI 1, QA kontroly, binární balíčky). Podpora EAPI 2 byla přidána jako první do Paludisu 0.30.1, pkgcore 0.4.7.9 a poté do Portage 2.2_rc11.

Závislost na USE

Poznámka: následující text předpokládá základní znalosti o závislostech ebuildů, které poskytuje 6. díl tohoto seriálu: Gentoo ebuild - 6 (závislosti, sloty, restrikce).

Tato novinka vám v ebuildu umožní specifikovat závislost na USE-flagu u balíčku, na kterém ebuild závisí. Představte si, že váš ebuild závisí na programu, který poskytuje jiný balíček (třeba app-test/showcase), ale jen za předpokladu, že byl sestaven s povoleným USE-flagem "X". V takovém případě je vhodné závislost uvést následujícím způsobem:

app-test/showcase[X]

Balíčkovací systém při instalaci vašeho ebuildu ověří, zda máte v systému balíček app-test/showcase zkompilovaný s USE="X" a vypíše chybu ve dvou případech: buď pokud tuto podmínku nesplňujete a máte balíček nainstalovaný bez tohoto USE-flagu, anebo pokud balíček nemáte nainstalovaný a se současným nastavením by se býval nainstaloval bez požadovaného USE-flagu.

Ebuild může samozřejmě záviset na více USE najednou a také může vyžadovat určitý USE-flag vypnutý, například takto:

app-test/showcase[mp3,ogg,-qt4,-X]

Zvláštní zápis

app-test/showcase[qt4?]

je ekvivalentem

qt4? ( app-test/showcase[qt4] )
!qt4? ( app-test/showcase )

a používá se tehdy, když váš ebuild obsahuje stejný USE-flag (qt4) jako jeho závislost (která je v této ukázce stále app-test/showcase), a vy chcete sestavit následující podmínku: když je USE-flag zapnutý u vašeho ebuildu, bude jej vyžadovat i u závislosti, pokud ovšem zapnutý není, tak na tom nezáleží. Opakem je potom následující zápis:

app-test/showcase[!qt4?]

který je ekvivalentem:

!qt4? ( app-test/showcase[-qt4] )
qt4? ( app-test/showcase )

a vyjadřuje toto: pokud je USE-flag vypnutý pro tento ebuild, musí být vypnutý i pro závislost, v opačném případě (když je USE-flag zapnutý) na nastavení USE nezáleží.

Posledním případem jsou tyto zápisy:

app-test/showcase[qt4=]
app-test/showcase[!qt4=]

První z nich vyžaduje stejné nastavení USE-flagu "qt4" pro váš ebuild a závislost a druhý naopak vyžaduje různé nastavení tohoto USE-flagu.

Ještě dodám, že tohle vše lze navíc kombinovat s udáním verze a slotu, takže zápis závislosti ve výsledku může vypadat například takto:

>=app-test/showcase-2.2:2[-mp3,ogg?,qt4=]

Znamená to, že ebuild bude vyžadovat balíček app-test/showcase verze 2.2 nebo novější, se slotem 2 a patřičným nastavením USE-flagů.

Blokující balíčky

Význam operátoru "!" u závislostí byl v EAPI 2 lehce pozměnen. Dříve zápis

!app-test/showcase

způsobil přerušení instalace v případě, že byl nainstalován balíček app-test/showcase. Nyní je ovšem možná dočasná instalace takových balíčků vedle sebe, která v případě kolize přepíše soubory staršího balíčku a když je později starý balíček odinstalován, tak nejsou odstraněny soubory, které byly přepsány novějším balíčkem.

Pro explicitní zákaz byť jen dočasné instalace balíčků vedle sebe lze použít nový operátor "!!":

!!app-test/showcase

Když nastane případ, že je balíček app-test/showcase blokován více nainstalovanými ebuildy najednou, tak má operátor "!!" prioritu a balíček se nenainstaluje.

Názvy souborů stahovaných do distfiles

Nově lze nastavit názvy souborů v SRC_URI, pod kterými se uloží do distfiles. Je třeba za URL přidat operátor "->" a za něj požadovaný název. Vše se odděluje mezerou.

SRC_URI="http://dl.google.com/earth/client/GE4/release_4_3/GoogleEarthLinux.bin
		-> GoogleEarthLinux-${PV}.bin"

Tato vlastnost se může hodit třeba tehdy, když není v názvu souboru uvedena verze, což by později mohlo způsobit problém.

Nové a změněné funkce

Dříve, když jste chtěli po rozbalení zdrojových archívů upravovat zdrojové kódy, bylo nutné (nebo vhodné) předefinovat funkci src_unpack, do které jste vždycky museli na začátek překopírovat výchozí definici. Toto řeší nová funkce src_prepare, která se spouští po src_unpack a jejíž výchozí pracovní adresář je nastaven na ${S}. Definice tedy může vypadat takto:

src_prepare() {
	epatch "${FILESDIR}/${P}-new-ffmpeg.patch"
}

Z funkce src_compile byla oddělena část sloužící pro konfiguraci balíčku (např. spuštění ./configure pomocí econf) do funkce src_configure, která se logicky spouští před ní. Výchozí definice těchto funkcí nyní vypadají následovně:

src_configure() {
	if [[ -x ${ECONF_SOURCE:-.}/configure ]] ; then
		econf
	fi
}

src_compile() {
	if [ -f Makefile ] || [ -f GNUmakefile ] || [ -f makefile ]; then
		emake || die "emake failed"
	fi
}

Výchozí definice funkcí pkg_nofetch a src_* jsou nyní dostupné pod svým názvem s přidaným "default_" na začátku. K dispozici jsou tedy:

default_pkg_nofetch
default_src_unpack
default_src_prepare
default_src_configure
default_src_compile
default_src_test

Když chcete v určité funkci zavolat její vychozí definici, stačí spustit pouze default beze zbytku názvu, protože jde o alias.

Nové pořadí spouštění funkcí jednotlivých fází instalace je následující:

1. pkg_setup
2. src_unpack
3. src_prepare
4. src_configure
5. src_compile
6. src_test
7. src_install
8. pkg_preinst
9. pkg_postinst
10. pkg_prerm
11. pkg_postrm

doman podporuje jazyky

Příkaz doman (sloužící k instalaci manuálových stránek) nyní podporuje jazyky, což v praxi znamená, že

doman program.cs.1

nainstaluje manuál jako /usr/share/man/cs/man1/program.1.

Seriál Gentoo ebuild (dílů: 8)

První díl: Gentoo ebuild - 1 (začínáme: názvy ebuildů a proměnné), poslední díl: Gentoo ebuild - 8 (EAPI 2).
Předchozí díl: Gentoo ebuild - 7 (EAPI 1, QA kontroly, binární balíčky)

Diskuse k tomuto článku

[Jirka]

Nejvetsi bolesti portage je revdep-rebuild. U toho nikdy poradne clovek nevi, co se vlastne bude kompilovat. Predstavte si, ze updatem worldu se zmeni nejaka knihovna. Vsechno vypada ok, update probehl korektne. Pak udelate revdep-rebuild a dozvite se, ze update knihovny rozhodil Openoffice. A to je kompilace na dlouho. Kdybyste vedeli, ze se to stane, tak byste treba s updatem pockali, az si ty dokumenty, co potrebujete zpracovat, dopisete.

Chapu, ze je to problem, system muze jen tezko vedet, co se updatem poskodi, poradne protoze nevi, v jakem stavu byly binarky v dobe updatu. Ale aspon u tech nejvetsich baliku by bylo fajn to nejak osefovat, aby clovek, co updatuje, byl na potecialni problem pripraven. Nektere balicky jsou notoricky  "problemove" a gentooista si jich brzo vsimne. Ale nekdy ne, a pak to boli.

[David Watzke]

Tak všechny balíky o kterých vím, že něco rozbíjej, afaik vypisujou varování. Každopádně s tímhle problém nemám a to reconcilio (revdep-rebuild pro paludis) spouštím minimálně. Možná je to ale tím, že ten systém znám zpaměti

[TomCat1]

Zkuste přejít na portage 2.2. Tam to fuguje tak, že pokud by se rozbila závislost, tak zůstane nainstalována i starší verze knihoven. Programy pak dál fungují. Po velmi krátkém hledání jsem našel např. toto.

[Jirk]

2.2 je hard masked. Takze NE.

[Marián Kyral]

# Zac Medico <zmedico@gentoo.org> (05 Jan 2009)
# Portage 2.2 is masked due to known bugs in the
# package sets and preserve-libs features.
>=sys-apps/portage-2.2_pre

Nevím, které bugy to jsou, ale portage 2.2 používám už hodně dlouho a žádného problému jsem si nevšiml.

[jAHu]

presne na tento problem je nova featura

@preserve-libs

[janik]

Pre mna su tie zavislosti na USE sklamanim. Som sa na to tesil. Preco nemoze nastavit ten USE flag automaticky, ale musi cakat na mna, kym to spravim manualne? Aj tak sa nastavenia USE menia ako sa im chce podla profilu a musim to pri kazdom update kontrolovat, takze ze by tam bola nejaka automatika navysse, by mi nevadilo.

[Scarabeus IV]

In progress, portage bude vypisovat vsechny useflag zmeny najednou misto po jedne jak to dela ted a bude mnohem jednodussi je tam zadat, mozna udelame i to ze to zmeni ty soubory automaticky ale to by nebylo prilis gentoo way.

[Mintaka]

Tak tomu nějak nerozumím, nebo jsme každý v jiném systému.

USE flagy jsou přeci přednastaveny automaticky. Manuálně si můžete (nemusíte) upravit vlastní volby. Nastavení USE se nemusí měnit automaticky podle profilu a není třeba ho kontrolovat.

Takhle začíná moje USE

USE="-* python pam ssl md5sum nls  ......

[Scarabeus IV]

Pouzivat src_prepare() na vkladani patchu neni zrovna nejlepsi :]
Lip to vypada s "inherit base", kdy se proste pouzije pole PATCHES
PATCHES=( "$FILESDIR/$PV-broken_linking.patch" "$FILESDIR/$PV-gcc4.4.patch" )

[David Watzke]

Jo, to je pravda, pokud člověk jenom patchuje, je to lepší takhle. Ta funkce je vhodná pro nějaký to sedování. Díky za doplnění.

[Filip Jirsák]

také může vyžadovat určitý USE-flag zapnutý

Podle kontextu by tam asi mělo být vypnutý.

Až budou všechny balíčky v Portage používat závislosti na USE, snad odpadnou takové problémy, jako je ten s MPlayerem a X v nedávném dotazu.

[David Watzke]

Podle kontextu by tam asi mělo být vypnutý.

Je to tak, spletl jsem se.

[Robert Krátký]

Opraveno.