| Nykyinen versio |
Oma tekstisi |
| Rivi 1: |
Rivi 1: |
| {{DISPLAYTITLE:{{lcfirst:{{PAGENAME}}}}}}
| | {{Ohjelma | nimi=ebuild | kuva= | kuvateksti= | lisenssi=[[GPL]]| käyttöliittymä=ei | kotisivu=[http://gentoo.org gentoo.org] }} |
| {{Ohjelma | |
| | nimi=ebuild | |
| | kuva= | |
| | kuvateksti= | |
| | lisenssi=[[GPL]] | |
| | käyttöliittymä=ei | |
| | kotisivu=[http://gentoo.org gentoo.org] | |
| }} | |
|
| |
|
| '''ebuild''' on kieli jolla kuvaillaan, miten paketteja asennetaan sekä ohjelma, joka toteuttaa kyseisen kielen. Ebuild on käytössä erityisesti [[Gentoo]]-[[jakelu|jakelussa]] [[paketinhallintajärjestelmä| paketinhallintajärjestelmän]] osana.
| | Ebuild on kieli jolla kuvaillaan, miten paketteja asennetaan sekä ohjelma, joka toteuttaa kyseisen kielen. Ebuild on käytössä erityisesti [[Gentoo]]-[[jakelu|jakelussa]] [[paketinhallintajärjestelmä| paketinhallintajärjestelmän]] osana. |
|
| |
|
| ==Kieli== | | ==Kieli== |
| Rivi 15: |
Rivi 7: |
|
| |
|
| ===Muuttujat=== | | ===Muuttujat=== |
| Seuraavien tyypillisesti ebuildin alussa määriteltävien muuttujien määrittely on suositeltavaa: | | Seuraavien tyypillisesti ebuildin alussa määriteltävien muuttujien käyttö on suositeltavaa: |
|
| |
|
| #kuvaus | | #kuvaus |
| Rivi 40: |
Rivi 32: |
|
| |
|
| ====Paketinnimi-muuttujat==== | | ====Paketinnimi-muuttujat==== |
| Kokonaisuudelle, jonka ebuildin nimi on kategoria/paketti-1.0-r1.ebuild muuttujat ovat | | Kokonaisuudelle, jonka ebuildin nimi on paketti-1.0-r1.ebuild muuttujat ovat |
|
| |
|
| *P="paketti-1.0" | | *P="paketti-1.0" |
| Rivi 48: |
Rivi 40: |
| *PVR="1.0-r1" | | *PVR="1.0-r1" |
| *PF="paketti-1.0-r1" | | *PF="paketti-1.0-r1" |
| *CATEGORY=kategoria
| |
|
| |
|
| Näitä on hyvä käyttää SRC_URI:n ja muun tarvittavan kanssa. Mikäli [[gentoo|gentoon]] tai muun [[jakelu|jakelun]] tarjoama versiomuotoilu ei sovi, määrittele vastaavat sopivat muuttujat MY_ -etuliitteellä, esim. MY_P. Älä muuta ebuildin nimeä. | | Näitä on hyvä käyttää SRC_URI:n ja muun tarvittavan kanssa. Mikäli [[gentoo| gentoon]], tai muun [[jakelu | jakelun]], tarjoama versiomuotoilu ei sovi määrittele vastavat sopivat muuttujat MY_ -etuliitteellä, esim MY_P. Älä muuta ebuildin nimeä. |
|
| |
|
| ====Hakemistomuuttujat==== | | ====Hakemistomuuttujat==== |
| Rivi 57: |
Rivi 48: |
| *WORKDIR="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/work" kertoo mihin hakemistoon ohjelman SRC_URI-objektit puretaan tai siirretään kääntämistä, tai muuta, varten. | | *WORKDIR="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/work" kertoo mihin hakemistoon ohjelman SRC_URI-objektit puretaan tai siirretään kääntämistä, tai muuta, varten. |
|
| |
|
| *FILESDIR="${PORTDIR}/${CATEGORY}/${PN}/files" files-kansio ebuidin hakemistosta tänne voit tallettaa esimerkiksi pienikokoisia patcheja, alle 20 KiB. | | *FILESDIR="${PORTDIR}/${CATEGORY}/${PN}/files" files-kansio ebuidin hakemistosta tänne voit tallettaa esimerkiksi pienikokoisia patcheja, alle 20kiB. |
|
| |
|
| *S="${WORKDIR}/${P}" Tämä kertoo pääasiallisen kansion, jossa työ tehdään oletusasetusta voi muokata tarpeen mukaan, yleensä suhteessa WORKDIR:iin. | | *S="${WORKDIR}/${P}" Tämä kertoo pääasiallisen kansion, jossa työ tehdään oletusasetusta voi muokata tarpeen mukaan, yleensä suhteessa WORKDIR:iin. |
| Rivi 66: |
Rivi 57: |
|
| |
|
| ====Riippuvuusmuuttujat==== | | ====Riippuvuusmuuttujat==== |
| *DEPEND Ebuildin riippuvuudet, näiden tulee olla asennettuina, ennen kuin ebuild ajetaan.
| |
| *RDEPEND Ebuildin ajonaikaiset riippuvuudet, esimerkiksi dynaamisesti ladattavat kirjastot.
| |
| *PDEPEND Ebuildin jälkeisriippuvuudet, nämä tulee asentaa ebuildin ajon jälkeen.
| |
| *PROVIDE Kuvailee paketin tarjoaman virtuaalipaketin, älä käytä, jos et tiedä, mitä olet tekemässä.
| |
|
| |
| Dynaamisten riippuvuuksien määrittely seuraavia yhdistelemällä loogisina lausekkeina. riippuvuudet ilmaistaan pitkässä muodossa kategoria/paketti-(versio)
| |
|
| |
| *<, >, =, >= ja <= nämä kuvaavat, että riippuvuuden version tulee olla kirjatulle versiolle pienempi, suurempi, yhtäsuuri kuin, suurempi tai yhtä suuri kuin tai pienempi tai yhtä suuri kuin.
| |
|
| |
| *use? riippuvuus on voimassa, mikäli USE-muuttuja use on asetettu. Vastaavasti ei voimassa kun !use?.
| |
|
| |
| *|| tai-operaattori jomman kumman riippuvuuksista täytyy olla täytetty
| |
|
| |
| *!kategoria/paketti käänteinen riippuvuus. Tämä ei saa olla asennettuna ebuildia asennettaessa.
| |
|
| |
| * *-jälkiliite, versionumerossa vastaa mitä tahansa merkkijonoa.
| |
|
| |
| ====Muut muuttujat==== | | ====Muut muuttujat==== |
| *RESTRICT, rajoittaa portagen ominaisuuksia listan mukaan, listaerottimena toimii välilyönti
| |
| **binchecks, jätetään binäärien laadunvalvonta suorittamatta.
| |
| **confcache, ei käytetä confcachea
| |
| **fetch, SRC_URI-kohdetta ei yritetä hakea
| |
| **mirror, älä hae SRC_URI-kohdetta gentoon omilta palvelimilta
| |
| **primaryuri, hae ensisijaisesti SRC_URI-kohde suoraan SRC_URI:sta
| |
| **strip, ei poisteta debug-symboleja
| |
| **test, ei ajeta src_test-funktiota
| |
| **userpriv
| |
|
| |
| *QA-muuttujat Nämä muuttujat vaientavat portagen laadunvalvontavaroituksia. Muuttujien tarkoitus on lähinnä estää varoitukset suljetun lähdekoodin binääreistä, joita ei voida käytännössä korjata.
| |
| **QA_TEXTRELS
| |
| **QA_EXECSTACK
| |
| **QA_WX_LOAD
| |
|
| |
|
| ===Funktiot=== | | ===Funktiot=== |
| ebuild-kielessä on otsikon jälkeen [[Bash-skriptaus|bash-syntaksin]] mukaisia funktioita, joilla on oma osansa paketin asennuksessa. Mitään näistä funktioista ei ole pakko määritellä. Funktioton ebuild toimiikin tyypillisesti [[autotools]]-ohjelmaa varten, jolle ei tarvitse määritellä käännösaikaisia valintoja. src-alkuiset funktiot ajetaan tyypillisesti [[sandbox|sandboxin]] sisällä, eikä niissä saisi kajota muuhun järjestelmään. | | ebuild-kielessä on otsikon jälkeen [[Bash-skriptaus|bash-syntaksin]] mukaisia funktioita, joilla on oma osansa paketin asennuksessa. Mitään näistä funktioista ei ole pakko määritellä. Funktioton ebuild toimiikin tyypillisesti [[autotools]]-ohjelmaa varten, jolle ei tarvitse määritellä käännösaikaisia valintoja. src-alkuiset funktiot ajetaan tyypillisesti sandboxin sisällä, eikä niissä saisi kajota muuhun järjestelmään. |
|
| |
|
| ====pkg_nofetch==== | | ====pkg_nofetch==== |
| Rivi 108: |
Rivi 68: |
| Ajetaan tarkistuksia asetusten suhteen. | | Ajetaan tarkistuksia asetusten suhteen. |
| ====src_unpack==== | | ====src_unpack==== |
| Puretaan SRC_URI-objekti $WORKDIR-muuttujan osoittamaan kansioon ja ajetaan eutils.eclassin epatch-funktio patcheille tarpeen mukaan, tar.bz2 ja tar.gz -pakatuille ohjelmille riittää tässä oletusfunktio. | | Puretaan SRC_URI-objekti $WORKDIR-muuttujan osoittamaan kansioon ja ajetaan epatch funktio patcheille tarpeen mukaan, tar.bz2 ja tar.gz -pakatuille ohjelmille riittää tässä oletusfunktio. |
| | |
| ====src_compile==== | | ====src_compile==== |
| Tässä funktiossa käännetään lähdekoodi tai tehdään muuta vastaavaa. | | Tässä funktiossa käännetään lähdekoodi tai tehdään muuta vastaavaa. |
| Rivi 127: |
Rivi 86: |
| ====pkg_config==== | | ====pkg_config==== |
| Ajetaan viimeiseksi tässä uudistetaan systeemin asetuksia, mikäli se on tarpeen. | | Ajetaan viimeiseksi tässä uudistetaan systeemin asetuksia, mikäli se on tarpeen. |
|
| |
| ===Apufunktiot===
| |
|
| |
| ====Usea tarkkailevat apufunktiot====
| |
| USE-muuttujan USE="valinta" suhteen nämä funktiot tekevät seuraavaa
| |
|
| |
| *useq valinta, Tämä palauttaa tosi, mikäli valinta on määritelty.
| |
| Seuraavat ovat lisäksi käteviä autotools-ohjelmien kanssa.
| |
| *use_with valinta [configure-valitsin=valinta] [configure-valitsinasetus], palauttaa <tt>--with-configure-valitsin=configure-valitsinasetus</tt> tai without, mikäli muuttujaa ei ole määritelty.
| |
| *use_enable valinta [configure-valitsin=valinta] [configure-valitsinasetus], palauttaa
| |
| <tt>--enable-configure-valitsin=configure-valitsinasetus</tt> tai disable, mikäli muuttujaa ei ole määritelty.
| |
|
| |
| ====Tulostusfunktiot====
| |
| *einfo "viesti", merkityksetön tuloste esimerkiksi asennuksen edistymisestä
| |
| *elog "viesti", tuloste, joka on tarkoitettu huomioitavaksi ja joka tulostetaan myös logeihin
| |
| *ewarn "varoitusviesti", varoitustuloste
| |
| *eerror "virheilmoitus", virhetuloste
| |
| *ebegin "tapahtumailmoitus", tulostaa ilmoituksen tapahtumasta, jonka onnistumisesta voidaan ilmoittaa funktiolla eend.
| |
| *eend <onnistuma> "virheilmoitus" jos onnistuma ei ole 0 tulostetaan virheilmoitus, muuten ilmoitetaan onnistumisesta.
| |
|
| |
|
| ===Muut ominaisuudet=== | | ===Muut ominaisuudet=== |
| *Import-lauseella voit sisällyttää ebuildiin .eclass-tiedostoja eclass-hakemistosta
| | Import-lauseella voit sisällyttää ebuildiin .eclass-tiedostoja eclass-hakemistosta #-merkillä alkavat rivit sivuutetaan kommentteina samalla tavalla kuin [[bash]]issa. |
| *'#'-merkillä alkavat rivit sivuutetaan kommentteina samalla tavalla kuin [[bash]]issa. Omia muuttujia voidaan määritellä bash-tyylisesti missä tahansa ebuidin kohdassa.
| |
| | |
| ===Tyyli===
| |
| Tässä tärkeitä asioita tyylistä ebuildien tekemisestä erityisesti [[gentoo|gentoolle]]
| |
| | |
| *Käytä muuttujia, erityisesti oletusmuuttujia silloin kuin ne on määritelty. Tämä tekee ebuildeista portattavia - hyvin tehdyn ebuildin kohteen uuden version ebuildin voikin tyypillisesti tehdä vain ebuildin nimeä muuttamalla. Lisäksi esimerkiksi portagen ylläpitämän järjestelmän juuri ei aina ole "/", esimerkiksi osX:ssä, mutta se on aina $ROOT.
| |
| | |
| *Käytä apufunktioita silloin kuin sopii.
| |
| | |
| *Käytä eclasseja silloin kuin on soveliasta ja tutustu ohjelmakategoriasi ebuildien teon periaatteisiin, mikäli niitä on dokumentoitu.
| |
| | |
| ==Ohjelma==
| |
| Ebuildia käytetään seuraavasti
| |
| ebuild <polku ebuildiin><ohjelma>-<versio>.ebuild <toiminto>
| |
| Tässä saatetaan edellyttää, että kohteena oleva ebuild on oikeassa paikassa hakemistopuussa, esimerkiksi PORTDIR_OVERLAY, ja että ohjelman SRC_URI-objekti on saatavilla DISTDIR=${PORTDIR}/distfiles - hakemistossa.
| |
| | |
| ===Toiminnot===
| |
| ====Ebuildeja ajavat toiminnot====
| |
| Seuraavat ajavat ebuildilleen (lähes)nimikkofunktionsa täsmälleen
| |
| *unpack
| |
| *compile
| |
| *test
| |
| *preinst
| |
| *install
| |
| *postinst
| |
| *qmerge
| |
| *prerm
| |
| *postrm
| |
| *config
| |
| | |
| Nämä taas ajavat useampia funktioita, jotka riittävät paketin asennukseen(merge) tai poistoon (unmerge)
| |
| *merge, myös hakee kokonaisuuden SRC_URI-objektin
| |
| *unmerge
| |
| | |
| ====Muut toiminnot====
| |
| *digest, luo SRC_URI-objektin varmentamiseen vaadittavat kryptografiset tiivisteet. Tiivisteet lasketaan $DISTDIR:ssä olevasta objektista tai haetaan tarvittaessa netistä.
| |
| *manifest, Luo tiivisteet itse ebuildiin liittyvistä tiedostoista.
| |
| *fetch, noutaa SRC_URI:n ja asettaa sen $DISTDIR:iin
| |
| *clean, siistii ebuildin luoman hakemistopuun $PORTAGE_TMPDIR:stä
| |
| *package, luo binääripaketin tar.bz2-muodossa $D:n hakemistopuusta ja asettaa sen PGKDIR="${PORTDIR}/packages"-muuttujan osoittamaan hakemistoon
| |
| *rpm, luo package-toimintoa vastaavasti [[rpm|rpm-paketin]], tämä paketti ei välttämättä toimi kuitenkaan kaikissa [[jakelu|jakeluissa]] ja sen ominaisuudet saattavat olla vajavaiset.
| |
| | |
| ==Lähdekoodin muokkaus- ja uudelleenasennusesimerkki==
| |
| | |
| Esimerkki squidin ohjelmakoodin muuttamisesta ja uudelleenasennuksesta. Squid on aiemmin jo asennettu järjestelmään.
| |
| | |
| $ sudo su
| |
| # cd /usr/portage/net-proxy/squid
| |
| # ebuild squid-3.4.5.ebuild digest
| |
| # ebuild squid-3.4.5.ebuild fetch
| |
| # ebuild squid-3.4.5.ebuild unpack
| |
| # cd /var/tmp/portage/net-proxy/squid-3.4.5/work/squid-3.4.5/src/
| |
| # $EDITOR <tiedosto> tai aja omat patch-tiedostot
| |
| # cd /usr/portage/net-proxy/squid
| |
| # ebuild squid-3.4.5.ebuild compile
| |
| # ebuild squid-3.4.5.ebuild install
| |
| # ebuild squid-3.4.5.ebuild qmerge
| |
| | |
| | |
| ==Muuta luettavaa==
| |
| *[[portage]]
| |
| *[[emerge]]
| |
| *[[eclass]]
| |
| ===Man-sivut===
| |
| *<tt>[[man]] 1 ebuild</tt> ebuild-ohjelman man-sivu
| |
| *<tt>[[man]] 5 ebuild</tt> ebuild-tiedostorakenteen, tai kielen, man-sivu
| |
| | |
| Lisää man-sivuja aiheesta [[gentoo|gentoossa]] saat
| |
| [[emerge]] portage-manpages
| |
| | |
| *<tt>[[man]] eutils.[[eclass]]</tt> ...
| |
|
| |
|
| [[Luokka:Paketinhallinta]] | | [[Luokka:Ylläpitotyökalut]] |
| [[Luokka:Gentoo]]
| |