Linux.fi - Käyttäjän muokkaukset [fi]

Keskustelu:Init

2007-05-10T19:22:04Z

Jkarlson:

jälleen minulla on sysvinit, joka käynnistää palvelut rinnakkain. minulla ei myöskään ole hakemistoa /etc/rc.d vaan runlevels. I

Init ei myöskään millään tasolla perustu palvelujen käynnistämiseen rinnakkain, on olemassa tiettyjä ominaisuuksia ja joitain ominaisuuksia ei ole.

Ehkä tässä initeille voisi tehdä jotain alaotsikoita. nämä kokonaiset iso kappaleet eivät jotenkin miellytä silmääni.

otsikot ovat pop, niiden avulla voi sisällysluettelosta hypätä suoraan haluamaansa kohtaan, eikä koko pitkää tekstiä tarvitse editoida kerralla.

mielestäni kannattaa ainakin vielä kerran uudelleenkoostaa.

--[[Käyttäjä:Jkarlson|jkarlson]] 10. toukokuuta 2007 kello 22.22 (EEST)

Keskustelu:Dd

2007-05-10T16:50:30Z

Jkarlson:

dd if=tiedosto.txt of=teksti count=3
en saa tätä mitenkään toimimaan, man-sivun mukaan olen lähes varma, ettei myöskään toimi:
dd if=/root/tiedosto.txt of=/dev/null count=3
--[[Käyttäjä:Jkarlson|jkarlson]] 10. toukokuuta 2007 kello 19.50 (EEST)

Dd

2007-05-10T16:47:37Z

Jkarlson: /* Levykuvien luominen */

dd on työkalu eri tiedostojen matalan tason kopiointiin ja muuntamiseen toiseen muotoon. Toisin kuin [[cp]], joka kopioi kokonaisia tiedostoja, kopioi dd tiedoston sisällön bitintarkasti. Tästä syystä dd:llä voidaan esimerkiksi tehdä identtinen kopio jostakin osiosta (partition) jollekin toiselle osiolle.

== Käyttö ==
dd if=/dev/urandom of=/dev/hda
Kopioi koko ykköskiintolevyn (/dev/hda), mukaanlukien esimerkiksi osiotaulukon, täyteen satunnaista dataa, mikä tuhoaa kaiken tällä kiintolevyllä ja sen eri osioilla sijaitsevan tiedon. Mikäli lähdetiedostona käytetään /dev/random:ia, on satunnaisluvun taso korkeampi, mutta operaatio sujuu selvästi hitaammin.

dd if=dev/zero of=/dev/hdb bs=512 count=2
Kirjoittaa kiintolevyn /dev/hdb osiotaulukon ja pääkäynnistyslohkon täyteen nollaa, mikä käytännössä estää kiintolevyn nykyisten tietojen käytön. Sitä varten käytettäväksi lohkokooksi määritellään 512 tavua ja tämän lohkon kirjoitus määritellään toistettavaksi kaksi kertaa.

dd if=/root/tiedosto.txt of=/dev/null count=3
Kopioi tiedoston /root/tiedosto.txt kolme kertaa bitti bitiltä [[laitetiedostot|nollalaitteeseen]] /dev/null. (kts keskustelu!)

Dd:tä voi käyttää myös [[komentorivin perusteet|putkissa]], if- ja of-parametrit eivät ole pakollisia:
fortune | dd | less
toimii tarkalleen samoin kuin
fortune | less
Tällöin dd:n käyttö vaikuttaa tyhmältä, mutta jos välissä on vaikkapa [[ssh]]-yhteys, dd:stä saattaa olla enemmän hyötyä:
fortune | ssh kayttaja@kone 'dd | less'

===[[levykuva|Levykuvien]] luominen===
dd if=/dev/fd0 of=korppu.img
Tekee sisälläolevasta levykkeestä (laitetiedosto /dev/fd0) [[levykuva]]n (imagen) tiedostoon korppu.img. Vastaavasti voi luoda myös iso-imagen optisesta levystä.

dd if=/dev/zero of=/polku/<[[levykuva|levykuvan]] nimi> count=<koko> bs=1024
Luo tyhjän tiedoston, jota voi käyttää levykuvana. Levykuvan koko annetaan tässä kibitavuina.

[[Luokka:Coreutils]]
[[Luokka:Komentorivin perustyökalut]]

Dd

2007-05-10T16:46:03Z

Jkarlson: /* Käyttö */

dd on työkalu eri tiedostojen matalan tason kopiointiin ja muuntamiseen toiseen muotoon. Toisin kuin [[cp]], joka kopioi kokonaisia tiedostoja, kopioi dd tiedoston sisällön bitintarkasti. Tästä syystä dd:llä voidaan esimerkiksi tehdä identtinen kopio jostakin osiosta (partition) jollekin toiselle osiolle.

== Käyttö ==
dd if=/dev/urandom of=/dev/hda
Kopioi koko ykköskiintolevyn (/dev/hda), mukaanlukien esimerkiksi osiotaulukon, täyteen satunnaista dataa, mikä tuhoaa kaiken tällä kiintolevyllä ja sen eri osioilla sijaitsevan tiedon. Mikäli lähdetiedostona käytetään /dev/random:ia, on satunnaisluvun taso korkeampi, mutta operaatio sujuu selvästi hitaammin.

dd if=dev/zero of=/dev/hdb bs=512 count=2
Kirjoittaa kiintolevyn /dev/hdb osiotaulukon ja pääkäynnistyslohkon täyteen nollaa, mikä käytännössä estää kiintolevyn nykyisten tietojen käytön. Sitä varten käytettäväksi lohkokooksi määritellään 512 tavua ja tämän lohkon kirjoitus määritellään toistettavaksi kaksi kertaa.

dd if=/root/tiedosto.txt of=/dev/null count=3
Kopioi tiedoston /root/tiedosto.txt kolme kertaa bitti bitiltä [[laitetiedostot|nollalaitteeseen]] /dev/null. (kts keskustelu!)

Dd:tä voi käyttää myös [[komentorivin perusteet|putkissa]], if- ja of-parametrit eivät ole pakollisia:
fortune | dd | less
toimii tarkalleen samoin kuin
fortune | less
Tällöin dd:n käyttö vaikuttaa tyhmältä, mutta jos välissä on vaikkapa [[ssh]]-yhteys, dd:stä saattaa olla enemmän hyötyä:
fortune | ssh kayttaja@kone 'dd | less'

===Levykuvien luominen===
dd if=/dev/fd0 of=korppu.img
Tekee sisälläolevasta levykkeestä (laitetiedosto /dev/fd0) [[levykuva]]n (imagen) tiedostoon korppu.img

dd if=/dev/zero of=/polku/<[[levykuva|levykuvan]] nimi> count=<koko> bs=1024
Luo tyhjän tiedoston, jota voi käyttää levykuvana. Levykuvan koko annetaan tässä kibitavuina.

[[Luokka:Coreutils]]
[[Luokka:Komentorivin perustyökalut]]

Keskustelu:Dd

2007-05-10T16:45:05Z

Jkarlson:

dd if=tiedosto.txt of=teksti count=3
en saa tätä mitenkään toimimaan, man-sivun mukaan olen lähes varma, ettei myöskään toimi:
dd if=/root/tiedosto.txt of=/dev/null count=3

Dd

2007-05-10T16:20:12Z

Jkarlson: /* Käyttö */

dd on työkalu eri tiedostojen matalan tason kopiointiin ja muuntamiseen toiseen muotoon. Toisin kuin [[cp]], joka kopioi kokonaisia tiedostoja, kopioi dd tiedoston sisällön bitintarkasti. Tästä syystä dd:llä voidaan esimerkiksi tehdä identtinen kopio jostakin osiosta (partition) jollekin toiselle osiolle.

== Käyttö ==
dd if=/dev/urandom of=/dev/hda
Kopioi koko ykköskiintolevyn (/dev/hda), mukaanlukien esimerkiksi osiotaulukon, täyteen satunnaista dataa, mikä tuhoaa kaiken tällä kiintolevyllä ja sen eri osioilla sijaitsevan tiedon. Mikäli lähdetiedostona käytetään /dev/random:ia, on satunnaisluvun taso korkeampi, mutta operaatio sujuu selvästi hitaammin.

dd if=dev/zero of=/dev/hdb bs=512 count=2
Kirjoittaa kiintolevyn /dev/hdb osiotaulukon ja pääkäynnistyslohkon täyteen nollaa, mikä käytännössä estää kiintolevyn nykyisten tietojen käytön. Sitä varten käytettäväksi lohkokooksi määritellään 512 tavua ja tämän lohkon kirjoitus määritellään toistettavaksi kaksi kertaa.

===[[levykuva|levykuvien]] luonti===
dd if=/dev/fd0 of=korppu.img
Tekee sisälläolevasta levykkeestä (laitetiedosto /dev/fd0) [[levykuva]]n (imagen) tiedostoon korppu.img

dd if=/dev/zero of=/polku/<[[levykuva|levykuvan]] nimi> count=<koko> bs=1024
Luo tyhjän tiedoston, jota voi käyttää levykuvana, levykuvan koko kibitavuina.

===yleistä===

Dd:tä voi käyttä myös putkissa, if- ja of-parametrit eivät ole pakollisia:
fortune | dd | less
toimii tarkalleen samoin kuin
fortune | less
Tällöin dd:n käyttö vaikuttaa tyhmältä, mutta jos välissä on vaikkapa [[ssh]]-yhteys, dd:stä saattaa olla enemmän hyötyä:
fortune | ssh kayttaja@kone 'dd | less'

[[Luokka:Coreutils]][[Luokka:Komentorivin perustyökalut]]

Dd

2007-05-10T16:13:15Z

Jkarlson: /* Käyttö */

dd on työkalu eri tiedostojen matalan tason kopiointiin ja muuntamiseen toiseen muotoon. Toisin kuin [[cp]], joka kopioi kokonaisia tiedostoja, kopioi dd tiedoston sisällön bitintarkasti. Tästä syystä dd:llä voidaan esimerkiksi tehdä identtinen kopio jostakin osiosta (partition) jollekin toiselle osiolle.

== Käyttö ==
dd if=/dev/urandom of=/dev/hda
Kopioi koko ykköskiintolevyn (/dev/hda), mukaanlukien esimerkiksi osiotaulukon, täyteen satunnaista dataa, mikä tuhoaa kaiken tällä kiintolevyllä ja sen eri osioilla sijaitsevan tiedon. Mikäli lähdetiedostona käytetään /dev/random:ia, on satunnaisluvun taso korkeampi, mutta operaatio sujuu selvästi hitaammin.

dd if=dev/zero of=/dev/hdb bs=512 count=2
Kirjoittaa kiintolevyn /dev/hdb osiotaulukon ja pääkäynnistyslohkon täyteen nollaa, mikä käytännössä estää kiintolevyn nykyisten tietojen käytön. Sitä varten käytettäväksi lohkokooksi määritellään 512 tavua ja tämän lohkon kirjoitus määritellään toistettavaksi kaksi kertaa.

dd if=/dev/fd0 of=korppu.img
Tekee sisälläolevasta levykkeestä (laitetiedosto /dev/fd0) [[levykuva]]n (imagen) tiedostoon korppu.img

dd if=/dev/zero of=/polku/<[[levykuva|levykuvan]] nimi> count=<koko> bs=1024
Luo tyhjän tiedoston, jota voi käyttää levykuvana, levykuvan koko kibitavuina.

Dd:tä voi käyttä myös putkissa, if- ja of-parametrit eivät ole pakollisia:
fortune | dd | less
toimii tarkalleen samoin kuin
fortune | less
Tällöin dd:n käyttö vaikuttaa tyhmältä, mutta jos välissä on vaikkapa [[ssh]]-yhteys, dd:stä saattaa olla enemmän hyötyä:
fortune | ssh kayttaja@kone 'dd | less'

[[Luokka:Coreutils]][[Luokka:Komentorivin perustyökalut]]

Dd

2007-05-10T16:03:03Z

Jkarlson:

dd on työkalu eri tiedostojen matalan tason kopiointiin ja muuntamiseen toiseen muotoon. Toisin kuin [[cp]], joka kopioi kokonaisia tiedostoja, kopioi dd tiedoston sisällön bitintarkasti. Tästä syystä dd:llä voidaan esimerkiksi tehdä identtinen kopio jostakin osiosta (partition) jollekin toiselle osiolle.

== Käyttö ==
dd if=/dev/urandom of=/dev/hda
Kopioi koko ykköskiintolevyn (/dev/hda), mukaanlukien esimerkiksi osiotaulukon, täyteen satunnaista dataa, mikä tuhoaa kaiken tällä kiintolevyllä ja sen eri osioilla sijaitsevan tiedon. Mikäli lähdetiedostona käytetään /dev/random:ia, on satunnaisluvun taso korkeampi, mutta operaatio sujuu selvästi hitaammin.

dd if=dev/zero of=/dev/hdb bs=512 count=2
Kirjoittaa kiintolevyn /dev/hdb osiotaulukon ja pääkäynnistyslohkon täyteen nollaa, mikä käytännössä estää kiintolevyn nykyisten tietojen käytön. Sitä varten käytettäväksi lohkokooksi määritellään 512 tavua ja tämän lohkon kirjoitus määritellään toistettavaksi kaksi kertaa.

dd if=/dev/fd0 of=korppu.img
Tekee sisälläolevasta levykkeestä (laitetiedosto /dev/fd0) [[levykuva]]n (imagen) tiedostoon korppu.img

dd if=/root/tiedosto.txt of=/dev/null count=3
Kopioi tiedoston /root/tiedosto.txt kolme kertaa bitti bitiltä nollalaitteeseen /dev/null.

Dd:tä voi käyttä myös putkissa, if- ja of-parametrit eivät ole pakollisia:
fortune | dd | less
toimii tarkalleen samoin kuin
fortune | less
Tällöin dd:n käyttö vaikuttaa tyhmältä, mutta jos välissä on vaikkapa [[ssh]]-yhteys, dd:stä saattaa olla enemmän hyötyä.

[[Luokka:Coreutils]][[Luokka:Komentorivin perustyökalut]]

Usein kysyttyjä kysymyksiä ytimestä

2007-05-10T14:32:55Z

Jkarlson: /* Miksi 1 GiB:n muistista jää osa käyttämättä? */

= Kernel - Usein kysyttyjä kysymyksiä =

== Miksi 1 GiB:n muistista jää osa käyttämättä? ==

Tarkempi kuvaus ongelman syistä ja ratkaisuista löytyy mm. artikkelista [http://groups-beta.google.com/group/cn.bbs.comp.unix.development.kernel/browse_thread/thread/ae812c4736d7aa10/0d1cc7cecaf6671d?q=linux+kernel+ram+896+arcangeli&rnum=1&hl=en&fwc=1 High Memory in the Linux Kernel]. Ytimen versiosta 2.6.16 alkaen on mahdollista käyttää ratkaisua, jossa muutetaan kernelin muistinjakoa, jolloin ei tarvitse vielä turvautua highmem-tukeen, joka tuo oman overheadinsä. Vanhemmille ytimille tarvittava patch löytyy mm. [http://members.optusnet.com.au/ckolivas/kernel/ Con Kolivasin seteistä].
Muisti voidaan jakaa neljällä eri tavalla:

* 3G/1G - vanha tapa, jossa muistia käytetään n. 896 MiB.
* 3G/1G - Jako koneille, joissa on tasan 1 GiB muistia.
* 2G/2G - Jako koneille, joissa on tasan 2 GiB muistia.
* 1G/3G - Jako koneille, joissa on tasan 3 GiB muistia.

Haittapuoli esimerkiksi 2G/2G jaosta on se, että user space virtuaalimuistiavaruus (prosessin maksimikoko) on enää 2 GiB entisen reilun 3GiB:n sijasta. Tämä estää esimerkiksi [[wine|winen]] toiminnan ja saattaa haitata prosesseja, jotka käyttävät matalan tason muistinhallintaa. Useimpia tämä ei kuitenkaan haittaa.

== Patchsetit (eli korjauspaketit) ==

Yleisimpiä patchsettejä ovat mm. 
 
- mm (Andrew Mortonin kokeellinen patchset, tässä testataan paljon asioita) 
- ac (Alan Coxin patchset, RedHat tuntuu käyttävän näitä osina paketointiaan) 
- xx-git (tarkoittaa että paketti on git paketoinnista) 
- xx-pre (prerelease-versio) 
- xx-rc (release candicate versio) 

Nämä yleisimmät patchsetit löydät suoraan [http://www.kernel.org kernel.org]:ista.

- [http://iphitus.loudas.com/archck.php beyond] ("archck, nitro") 
- [http://members.optusnet.com.au/ckolivas/kernel/ ck] (Con Kolivasin patchset, panostaa työpöytäkäytön vasteaikoihin) 
- [http://sourceforge.net/projects/wolk WOLK] (WOLK patchset lisää monia pätsejä monista projekteista. Se tähtää vakauteen, skaalautuvuuteen, suorituskykyyn, ja erityisesti turvallisuuteen. Tosin kehitystyö on näköjään loppunut kokonaan.) 

Vanilla on peruskerneli, eli tarkoittaa Linus Torvaldsin kernel-paketointia.

Korjauspaketeilla pyritään korjaamaan tai säätämään jotain kernelin ominaisuutta,
esimerkiksi laitetukea tai vasteaikaa. Isommat patchsetit yleensä lisäävät paljon ominaisuuksia.

Korjauspaketti asennetaan komennolla
[[patch]] -pN < polku patch-tiedostoon
N on poistettavien polkujen lukumäärä, yleensä vaihtelee 0-1 välillä. Tämän jälkeen ydin pitää vielä kääntää uusiksi.

== Miten vältät yleisimmät ongelmat käynnistyksen yhteydessä ==

Parametri acpi=off voi auttaa bugiseen ACPI-toteutuksen kiertämiseen.

Parametria init=/bin/sh voi käyttää salasanan vaihtoon.

Parametrillä vga=xxx voidaan määritellä framebuffer tilan resoluutio.

== Kuinka kernel käännetään? ==
[[Kernelin kääntäminen]] on ohjeistettuna tässä wikissä.

== Kysy jotain? ==

[[Luokka:Järjestelmä]]

Dd

2007-05-10T14:11:52Z

Jkarlson: /* Käyttö */

dd on työkalu eri tiedostojen matalan tason kopiointiin ja muuntamiseen toiseen muotoon. Toisin kuin [[cp]], joka kopioi kokonaisia tiedostoja, kopioi dd yksittäisiä bittejä. Tästä syystä dd:llä voidaan esimerkiksi tehdä identtinen kopio jostakin osiosta (partition) jollekin toiselle osiolle.

== Käyttö ==
dd if=/dev/urandom /dev/hda
Kopioi koko ykköskiintolevyn (/dev/hda), mukaanlukien esimerkiksi osiotaulukon, täyteen satunnaista dataa, mikä tuhoaa kaiken tällä kiintolevyllä ja sen eri osioilla sijaitsevan tiedon. Mikäli lähdetiedostona käytetään /dev/random:ia, on satunnaisluvun taso korkeampi, mutta operaatio sujuu selvästi hitaammin.

dd if=dev/zero of=/dev/hdb bs=512 count=2
Kirjoittaa kiintolevyn /dev/hdb osiotaulukon ja pääkäynnistyslohkon täyteen nollaa, mikä käytännössä estää kiintolevyn nykyisten tietojen käytön. Sitä varten käytettäväksi lohkokooksi määritellään 512 tavua ja tämän lohkon kirjoitus määritellään toistettavaksi kaksi kertaa.

dd if=/dev/fd0 of=korppu.img
Tekee sisälläolevasta levykkeestä (laitetiedosto /dev/fd0) levykuvan (imagen) tiedostoon korppu.img

dd if=/dev/zero of=/polku/levykuva.img count=<koko> bs=1024
luo kibitavuina määrätynkokoisen tyhjän tiedoston, jota voidaan käyttää [[levykuva|levykuvan]] pohjana.

Dd:tä voi käyttä myös putkissa, if- ja of-parametrit eivät ole pakollisia:
fortune | dd | less
toimii tarkalleen samoin kuin
fortune | less
Tällöin dd:n käyttö vaikuttaa tyhmältä, mutta jos välissä on vaikkapa [[ssh]]-yhteys, dd:stä saattaa olla enemmän hyötyä.

[[Luokka:Coreutils]][[Luokka:Komentorivin perustyökalut]]

Levykuva

2007-05-10T14:06:04Z

Jkarlson:

Levykuva on tiedosto, jonka sisällön käsitetään vastaavan merkkijonojen mielessä täsmällisesti jonkun massamuistilaitteen sisältöä.

==katso myös==
*[[loop]]
*[[dd]]

Initramfs

2007-05-10T14:02:28Z

Jkarlson: /* initrd:n luonti käsin */

Initial ramdisk, tai initrd, kuten sitä yleensä nimitetään, on keskusmuistiin ytimen käynnistyksen yhteydessä ladattava massamuistinomainen alue.

==kuvaus==
Tyypillisesti initrd sisältää järjestelmän käynnistämiseen tarvittavat modulit ja perustyökalut. Tällöin itse järjestelmän käynnistys saattaa nopeutua, eikä ole tarpeellista ladata tarpeettomia ajureita, joita muuten vaadittaisiin käynnistykseen.

==initrd:n automaattinen luonti==
===[[Debian]]-pohjaiset===
Initrd:n Debian-pohjaisissa [[jakelu| jakeluissa]] automatisoitu ytimen kääntämisen yhteydessä tapahtuvaksi, liittämällä --initrd -parametrin make-kpkg-komentoon:
make-kpkg --initrd --rootcmd fakeroot kernel_image

===[[Gentoo]]===
[[genkernel]] luo initrd-kuvan automaattisesti

===[[mkinitramfs]]===
Initrd:n voi (useimmissa [[jakelu|jakeluissa]]) luoda <tt>mkinitramfs</tt>-työkalulla. Seuraava esimerkki tallentaa luodun initrd:n tiedostoon initrd.img:
mkinitramfs -o initrd.img

==initrd:n luonti käsin==
Initrd:n voi myös luoda käsin peruskomentorivityökaluilla kuten minkä tahansa [[levykuva|levykuvan]].

==Katso==
[[kernelin kääntäminen]]

[[Luokka:Järjestelmä]]
[[Luokka:Käsitteet]]

Initramfs

2007-05-10T13:54:23Z

Jkarlson:

Initial ramdisk, tai initrd, kuten sitä yleensä nimitetään, on keskusmuistiin ytimen käynnistyksen yhteydessä ladattava massamuistinomainen alue.

==kuvaus==
Tyypillisesti initrd sisältää järjestelmän käynnistämiseen tarvittavat modulit ja perustyökalut. Tällöin itse järjestelmän käynnistys saattaa nopeutua, eikä ole tarpeellista ladata tarpeettomia ajureita, joita muuten vaadittaisiin käynnistykseen.

==initrd:n automaattinen luonti==
===[[Debian]]-pohjaiset===
Initrd:n Debian-pohjaisissa [[jakelu| jakeluissa]] automatisoitu ytimen kääntämisen yhteydessä tapahtuvaksi, liittämällä --initrd -parametrin make-kpkg-komentoon:
make-kpkg --initrd --rootcmd fakeroot kernel_image

===[[Gentoo]]===
[[genkernel]] luo initrd-kuvan automaattisesti

===[[mkinitramfs]]===
Initrd:n voi (useimmissa [[jakelu|jakeluissa]]) luoda <tt>mkinitramfs</tt>-työkalulla. Seuraava esimerkki tallentaa luodun initrd:n tiedostoon initrd.img:
mkinitramfs -o initrd.img

==initrd:n luonti käsin==
Initrd:n voi myös luoda käsin peruskomentorivityökaluilla.

==Katso==
[[kernelin kääntäminen]]

[[Luokka:Järjestelmä]]
[[Luokka:Käsitteet]]

Init

2007-05-10T13:34:49Z

Jkarlson: /* muuta */

Init on [[wikipedia:fi:Unix|Unix]]-järjestelmissä ohjelma, jonka tehtävänä on kaikkien muiden ohjelmien (prosessien) käynnistäminen. Tyypillisesti järjestelmän ydin käynnistää init-ohjelman ensimmäisenä ulkoisena prosessina ([[PID]] 1).

==yleistä==
Linux-järjestelmissä on perinteisesti ollut käytössä kahden tyyppisiä init-ohjelmia, [[wikipedia:en:System V|System V Unixin]] ([[sysvinit]]) ja [[wikipedia:fi:BSD|BSD-Unixin]] initin toimintaa jäljitteleviä. Lähes kaikki [[jakelu]]t käyttävät nykyisin System V -tyylistä initiä poikkeuksena esimerkiksi [[Slackware]] ja [[Arch Linux]] jotka käyttävät BSD-initiä.

==toteutukset==
*[[sysvinit]]: Useimmat [[jakelu|levitysversiot]] käyttävät tätä
*[[bsdinit]]: [[archlinux]], [[slackware]]
*[[init-ng]]: uusi init, uusilla ominaisuuksilla, harva distro kuitenkaan suosii tätä
*[[upstart]]: [[Ubuntu|Ubuntun]] init
*[[minit]]: kevyt init

==[[ydin]]-parametrit==
*init=<polku rootilla inittiin> Oletusarvo tässä on /sbin/init. Kuitenkin vikatilanteessa saatetaan haluta käynnistää kone esimerkiksi suoraan shelliin. Esimerkiksi parametrilla ''init=/bin/zsh'' ydin korvaisi normaalin init-ohjelman [[Zsh]]-[[komentotulkki|komentotulkilla]].

*S käynnistää initin yhden käyttäjän tilassa.

*rdinit=<polku initrd:llä initiin> ajaa [[initrd]]:n initin ohjelman /init sijaan.

[[Luokka:Järjestelmä]]

Init

2007-05-10T12:52:29Z

Jkarlson:

Init on [[wikipedia:fi:Unix|Unix]]-järjestelmissä ohjelma, jonka tehtävänä on kaikkien muiden ohjelmien (prosessien) käynnistäminen. Tyypillisesti järjestelmän ydin käynnistää init-ohjelman ensimmäisenä ulkoisena prosessina ([[PID]] 1).

==yleistä==
Linux-järjestelmissä on perinteisesti ollut käytössä kahden tyyppisiä init-ohjelmia, [[wikipedia:en:System V|System V Unixin]] ([[sysvinit]]) ja [[wikipedia:fi:BSD|BSD-Unixin]] initin toimintaa jäljitteleviä. Lähes kaikki [[jakelu]]t käyttävät nykyisin System V -tyylistä initiä poikkeuksena esimerkiksi [[Slackware]] ja [[Arch Linux]] jotka käyttävät BSD-initiä.

==toteutukset==
*[[sysvinit]]: Useimmat [[jakelu|levitysversiot]] käyttävät tätä
*[[bsdinit]]: [[archlinux]], [[slackware]]
*[[init-ng]]: uusi init, uusilla ominaisuuksilla, harva distro kuitenkaan suosii tätä
*[[upstart]]: [[Ubuntu|Ubuntun]] init
*[[minit]]: kevyt init

==muuta==
Käytettävän init-ohjelman voi itse vaihtaa [[ydin|ytimen]] init-parametrilla. Esimerkiksi parametrilla ''init=/bin/zsh'' ydin korvaisi normaalin init-ohjelman [[Zsh]]-[[komentotulkki|komentotulkilla]].

[[Luokka:Järjestelmä]]

Sysvinit

2007-05-10T12:47:06Z

Jkarlson:

Sysvinit on useimpien [[jakelu|levitysversioiden]] [[init]]-ohjelma.

==yleistä==
System V -initin toiminta pohjautuu ns. [[ajotaso]]ihin (runlevel), joiden avulla määritellään järjestelmän eri tilojen (esim. monen käyttäjän tekstipohjainen, monen käyttäjän graafinen, yhden käyttäjän tila sekä uudelleenkäynnistys ja sulkeminen) yhteydessä käynnistettävät ja suljettavat prosessit. Käytännössä nämä määritellään /etc/rc?.d-hakemistojen alle sijoitettavilla [[symbolinen linkki|symlinkeillä]]. BSD-init taas pohjautuu /etc-hakemiston alle sijoitettaviin rc-[[wikipedia:fi:skripti|skripteihin]]. BSD-initin valttina on nopeus ja yksinkertaisuus.

Nykyisin System V -init on alkanut hitautensa ja joustamattomuutensa vuoksi käydä monella tapaa vanhentuneeksi. Tästä syystä on viime aikoina perustettu lukuisia projekteja, joiden tehtävänä on korvaavan järjestelmän kehittäminen. Tunnetuin näistä on [[Initng]], joka pohjautuu useiden prosessien käynnistämiseen samanaikaisesti perinteisen yksi prosessi kerrallaan -tavan sijaan. Joissain tapauksissa Initng on jopa puolittanut järjestelmän käynnistysajan verrattuna vanhanmalliseen initiin.

==katso==
*[[init-skriptit]]
*[[init]]

Fork()

2007-05-10T12:21:32Z

Jkarlson:

Fork on SVr4, 4.3BSD ja POSIX.1-2001 -standardienmukainen funktio [[C]]:ssä, jolla luodaan ohjelmalle kutsun suorituskohtaan lapsiprosessi vastaavassa tilassa.

==Määritelmä==
pid_t fork()
===palautusarvo===
palautusarvo pid_t on -1 virheen tapauhtuessa, muuten se vastaa lapsiprosessin [[pid|prosessitunnusta]]. Lapsiprosessille palautusarvo näkyy nollana 0x0.
==käyttö==
===[[demoni|taustaprosessin]] luominen===
fork-funktion ajavan ohjelman toinen osa jää taustalle, alkuperäinen ohjelma voidaan sammuttaa esim [[exit()]]-kutsulla.
pid_t prosessi = fork();
if pid_t > exit(EXIT_SUCCESS);
if pid_t < exit(EXIT_FAILURE);
/*taustaprosessin toiminta*/

Taustaprosessi

2007-05-10T12:03:51Z

Jkarlson: /* katso */

Daemon eli demoni on Linux-järjestelmässä (ja yleisestikin UNIXissa) taustapalvelu. Esimerkiksi http-palvelin toimii yleensä demonina.

==katso==
*[[fork]]
*[[init-skriptit]]

[[Luokka:Järjestelmä]]

Taustaprosessi

2007-05-10T12:03:32Z

Jkarlson:

Daemon eli demoni on Linux-järjestelmässä (ja yleisestikin UNIXissa) taustapalvelu. Esimerkiksi http-palvelin toimii yleensä demonina.

==katso==
[[fork]]
[[init-skriptit]]

[[Luokka:Järjestelmä]]

Ebuild

2007-05-10T11:57:25Z

Jkarlson: /* Muuta luettavaa */

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

==Kieli==
ebuild epäilemättä on kielenä monipuolinen, jopa tietyllä tapaa täydellinen. On kuitenkin tärkeää muistaa noudattaa oikeita käytäntöjä tehtäessä paketteja Gentoo-järjestelmään. Esimerkiksi valmiiseen järjestelmään kirjoittaminen useimmissa funktioissa on huonoa tyyliä, ja aiheuttaakin tyypillisesti esimerkiksi [[portage |portagessa]] [[sandbox]]-loukkauksen.

===Muuttujat===
Seuraavien tyypillisesti ebuildin alussa määriteltävien muuttujien määrittely on suositeltavaa:

#kuvaus
DESCRIPTION="tässä kerrot mitä ohjelma tekee"
#ohjelman kotisivu
HOMEPAGE="http://hyodyllinen.ohjelma.org"
#mistä ohjelman lähdekoodi haetaan
SRC_URI="ftp://hyodyllinen.ohjelma.org/pub/${P}.tar.bz2"
#ohjelman lisenssi
LICENCE="GPL-2"
#kertoo, mihin slottiin ebuild asentuu, Gentoossa samassa slotissa
#ei voi olla kahta samannimistä pakettia
SLOT="0"
#kertoo mihin avainsanoihin ebuild kuuluu
KEYWORDS="x86 -*"
#kertoo mitkä USE-muuttujat vaikuttavat ebuildiin
IUSE=""

#kertoo mitkä paketit ovat paketin riippuvuuksia
DEPEND="dev-libs/hyodyllinen-kirjasto"
#kertoo ne ebuildit, jotka ovat ebuildin ajonaikaisia riippuvuuksia
#tyypillisesti dynaaminen kirjastolinkkaus voi hajota vain näihin.
RDEPEND="dev-libs/hyödyllinen-kirjasto"

====Paketinnimi-muuttujat====
Kokonaisuudelle, jonka ebuildin nimi on kategoria/paketti-1.0-r1.ebuild muuttujat ovat

*P="paketti-1.0"
*PN="paketti"
*PV="1.0"
*PR="r1"
*PVR="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ä.

====Hakemistomuuttujat====
*ROOT="/" kertoo, mitä juurta portagen, tai vastaavan, ylläpitämä systeemi käyttää. Älä koske tämän ulkopuolelle, äläkä muuta tätä muuttujaa.

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

*S="${WORKDIR}/${P}" Tämä kertoo pääasiallisen kansion, jossa työ tehdään oletusasetusta voi muokata tarpeen mukaan, yleensä suhteessa WORKDIR:iin.

*T="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/temp" Tilapäishakemisto vapaasti käytettävissä.

*D="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image" Hakemistokuva asennettavasta kokonaisuudesta. Älä muuta.

====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====
*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:
*QA_TEXTRELS
*QA_EXECSTACK
*QA_WX_LOAD

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

====pkg_nofetch====
Tätä funktiota kutsutaan, mikäli RESTRICT="fetch" on asetettu ja ebuildin SRC_URI kohdetta ei kyetä noutamaan.
pkg_nofetchin jälkeen muita funktioita ei kutsuta vaan siirrytään ohjelman loppuun.
====pkg_setup====
Ajetaan tarkistuksia asetusten suhteen.
====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.

====src_compile====
Tässä funktiossa käännetään lähdekoodi tai tehdään muuta vastaavaa.

====src_test====
Funktiota kutsutaan src_compilen jälkeen, mikäli FEATURES="test" on määritelty, funktiossa tulee ajaa asennettavan ohjelman tarjoamat yksikkötestaus-rutiinit, oletustoteutuksessa nämä ovat <tt>make check</tt> ja <tt>make test</tt>

====src_install====
Tässä funktiossa siirretään kokonaisuuden asennettava osa, esim suoritettava binääri, hakemistorakenteeseen, jonka juurena toimii muuttujan $D osoittama hakemisto, esimerkiksi make install DESTDIR=$D

====pkg_preinst ja pkg_postinst====
Nämä funktiot ajetaan sandboxin ulkopuolella ennen ja jälkeen $D-kuvan sisällyttämistä varsinaiseen ROOT-muuttujan osoittamaan kohteeseen, tyypillisesti "/".

====pkg_prerm ja pkg_postrm====
Vastaavasti kuin edelliset nämä ajetaan ennen ja jälkeen kokonaisuuden sisällön, eli sen, minkä asensit $D:hen, poistamista järjestelmästä.

====pkg_config====
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===
*Import-lauseella voit sisällyttää ebuildiin .eclass-tiedostoja eclass-hakemistosta
*'#'-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.

==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:Ylläpitotyökalut]]

Ebuild

2007-05-10T11:56:23Z

Jkarlson: /* Man-sivut */

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

==Kieli==
ebuild epäilemättä on kielenä monipuolinen, jopa tietyllä tapaa täydellinen. On kuitenkin tärkeää muistaa noudattaa oikeita käytäntöjä tehtäessä paketteja Gentoo-järjestelmään. Esimerkiksi valmiiseen järjestelmään kirjoittaminen useimmissa funktioissa on huonoa tyyliä, ja aiheuttaakin tyypillisesti esimerkiksi [[portage |portagessa]] [[sandbox]]-loukkauksen.

===Muuttujat===
Seuraavien tyypillisesti ebuildin alussa määriteltävien muuttujien määrittely on suositeltavaa:

#kuvaus
DESCRIPTION="tässä kerrot mitä ohjelma tekee"
#ohjelman kotisivu
HOMEPAGE="http://hyodyllinen.ohjelma.org"
#mistä ohjelman lähdekoodi haetaan
SRC_URI="ftp://hyodyllinen.ohjelma.org/pub/${P}.tar.bz2"
#ohjelman lisenssi
LICENCE="GPL-2"
#kertoo, mihin slottiin ebuild asentuu, Gentoossa samassa slotissa
#ei voi olla kahta samannimistä pakettia
SLOT="0"
#kertoo mihin avainsanoihin ebuild kuuluu
KEYWORDS="x86 -*"
#kertoo mitkä USE-muuttujat vaikuttavat ebuildiin
IUSE=""

#kertoo mitkä paketit ovat paketin riippuvuuksia
DEPEND="dev-libs/hyodyllinen-kirjasto"
#kertoo ne ebuildit, jotka ovat ebuildin ajonaikaisia riippuvuuksia
#tyypillisesti dynaaminen kirjastolinkkaus voi hajota vain näihin.
RDEPEND="dev-libs/hyödyllinen-kirjasto"

====Paketinnimi-muuttujat====
Kokonaisuudelle, jonka ebuildin nimi on kategoria/paketti-1.0-r1.ebuild muuttujat ovat

*P="paketti-1.0"
*PN="paketti"
*PV="1.0"
*PR="r1"
*PVR="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ä.

====Hakemistomuuttujat====
*ROOT="/" kertoo, mitä juurta portagen, tai vastaavan, ylläpitämä systeemi käyttää. Älä koske tämän ulkopuolelle, äläkä muuta tätä muuttujaa.

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

*S="${WORKDIR}/${P}" Tämä kertoo pääasiallisen kansion, jossa työ tehdään oletusasetusta voi muokata tarpeen mukaan, yleensä suhteessa WORKDIR:iin.

*T="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/temp" Tilapäishakemisto vapaasti käytettävissä.

*D="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image" Hakemistokuva asennettavasta kokonaisuudesta. Älä muuta.

====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====
*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:
*QA_TEXTRELS
*QA_EXECSTACK
*QA_WX_LOAD

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

====pkg_nofetch====
Tätä funktiota kutsutaan, mikäli RESTRICT="fetch" on asetettu ja ebuildin SRC_URI kohdetta ei kyetä noutamaan.
pkg_nofetchin jälkeen muita funktioita ei kutsuta vaan siirrytään ohjelman loppuun.
====pkg_setup====
Ajetaan tarkistuksia asetusten suhteen.
====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.

====src_compile====
Tässä funktiossa käännetään lähdekoodi tai tehdään muuta vastaavaa.

====src_test====
Funktiota kutsutaan src_compilen jälkeen, mikäli FEATURES="test" on määritelty, funktiossa tulee ajaa asennettavan ohjelman tarjoamat yksikkötestaus-rutiinit, oletustoteutuksessa nämä ovat <tt>make check</tt> ja <tt>make test</tt>

====src_install====
Tässä funktiossa siirretään kokonaisuuden asennettava osa, esim suoritettava binääri, hakemistorakenteeseen, jonka juurena toimii muuttujan $D osoittama hakemisto, esimerkiksi make install DESTDIR=$D

====pkg_preinst ja pkg_postinst====
Nämä funktiot ajetaan sandboxin ulkopuolella ennen ja jälkeen $D-kuvan sisällyttämistä varsinaiseen ROOT-muuttujan osoittamaan kohteeseen, tyypillisesti "/".

====pkg_prerm ja pkg_postrm====
Vastaavasti kuin edelliset nämä ajetaan ennen ja jälkeen kokonaisuuden sisällön, eli sen, minkä asensit $D:hen, poistamista järjestelmästä.

====pkg_config====
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===
*Import-lauseella voit sisällyttää ebuildiin .eclass-tiedostoja eclass-hakemistosta
*'#'-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.

==Muuta luettavaa==

*[[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:Ylläpitotyökalut]]

Ebuild

2007-05-10T11:55:27Z

Jkarlson: /* Man-sivut */

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

==Kieli==
ebuild epäilemättä on kielenä monipuolinen, jopa tietyllä tapaa täydellinen. On kuitenkin tärkeää muistaa noudattaa oikeita käytäntöjä tehtäessä paketteja Gentoo-järjestelmään. Esimerkiksi valmiiseen järjestelmään kirjoittaminen useimmissa funktioissa on huonoa tyyliä, ja aiheuttaakin tyypillisesti esimerkiksi [[portage |portagessa]] [[sandbox]]-loukkauksen.

===Muuttujat===
Seuraavien tyypillisesti ebuildin alussa määriteltävien muuttujien määrittely on suositeltavaa:

#kuvaus
DESCRIPTION="tässä kerrot mitä ohjelma tekee"
#ohjelman kotisivu
HOMEPAGE="http://hyodyllinen.ohjelma.org"
#mistä ohjelman lähdekoodi haetaan
SRC_URI="ftp://hyodyllinen.ohjelma.org/pub/${P}.tar.bz2"
#ohjelman lisenssi
LICENCE="GPL-2"
#kertoo, mihin slottiin ebuild asentuu, Gentoossa samassa slotissa
#ei voi olla kahta samannimistä pakettia
SLOT="0"
#kertoo mihin avainsanoihin ebuild kuuluu
KEYWORDS="x86 -*"
#kertoo mitkä USE-muuttujat vaikuttavat ebuildiin
IUSE=""

#kertoo mitkä paketit ovat paketin riippuvuuksia
DEPEND="dev-libs/hyodyllinen-kirjasto"
#kertoo ne ebuildit, jotka ovat ebuildin ajonaikaisia riippuvuuksia
#tyypillisesti dynaaminen kirjastolinkkaus voi hajota vain näihin.
RDEPEND="dev-libs/hyödyllinen-kirjasto"

====Paketinnimi-muuttujat====
Kokonaisuudelle, jonka ebuildin nimi on kategoria/paketti-1.0-r1.ebuild muuttujat ovat

*P="paketti-1.0"
*PN="paketti"
*PV="1.0"
*PR="r1"
*PVR="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ä.

====Hakemistomuuttujat====
*ROOT="/" kertoo, mitä juurta portagen, tai vastaavan, ylläpitämä systeemi käyttää. Älä koske tämän ulkopuolelle, äläkä muuta tätä muuttujaa.

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

*S="${WORKDIR}/${P}" Tämä kertoo pääasiallisen kansion, jossa työ tehdään oletusasetusta voi muokata tarpeen mukaan, yleensä suhteessa WORKDIR:iin.

*T="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/temp" Tilapäishakemisto vapaasti käytettävissä.

*D="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image" Hakemistokuva asennettavasta kokonaisuudesta. Älä muuta.

====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====
*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:
*QA_TEXTRELS
*QA_EXECSTACK
*QA_WX_LOAD

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

====pkg_nofetch====
Tätä funktiota kutsutaan, mikäli RESTRICT="fetch" on asetettu ja ebuildin SRC_URI kohdetta ei kyetä noutamaan.
pkg_nofetchin jälkeen muita funktioita ei kutsuta vaan siirrytään ohjelman loppuun.
====pkg_setup====
Ajetaan tarkistuksia asetusten suhteen.
====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.

====src_compile====
Tässä funktiossa käännetään lähdekoodi tai tehdään muuta vastaavaa.

====src_test====
Funktiota kutsutaan src_compilen jälkeen, mikäli FEATURES="test" on määritelty, funktiossa tulee ajaa asennettavan ohjelman tarjoamat yksikkötestaus-rutiinit, oletustoteutuksessa nämä ovat <tt>make check</tt> ja <tt>make test</tt>

====src_install====
Tässä funktiossa siirretään kokonaisuuden asennettava osa, esim suoritettava binääri, hakemistorakenteeseen, jonka juurena toimii muuttujan $D osoittama hakemisto, esimerkiksi make install DESTDIR=$D

====pkg_preinst ja pkg_postinst====
Nämä funktiot ajetaan sandboxin ulkopuolella ennen ja jälkeen $D-kuvan sisällyttämistä varsinaiseen ROOT-muuttujan osoittamaan kohteeseen, tyypillisesti "/".

====pkg_prerm ja pkg_postrm====
Vastaavasti kuin edelliset nämä ajetaan ennen ja jälkeen kokonaisuuden sisällön, eli sen, minkä asensit $D:hen, poistamista järjestelmästä.

====pkg_config====
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===
*Import-lauseella voit sisällyttää ebuildiin .eclass-tiedostoja eclass-hakemistosta
*'#'-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.

==Muuta luettavaa==

*[[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 [[gentoossa]] saat
[[emerge]] portage-manpages

*<tt>[[man]] eutils.[[eclass]]</tt> ...

[[Luokka:Ylläpitotyökalut]]

Ebuild

2007-05-10T11:47:17Z

Jkarlson: /* Funktiot */

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

==Kieli==
ebuild epäilemättä on kielenä monipuolinen, jopa tietyllä tapaa täydellinen. On kuitenkin tärkeää muistaa noudattaa oikeita käytäntöjä tehtäessä paketteja Gentoo-järjestelmään. Esimerkiksi valmiiseen järjestelmään kirjoittaminen useimmissa funktioissa on huonoa tyyliä, ja aiheuttaakin tyypillisesti esimerkiksi [[portage |portagessa]] [[sandbox]]-loukkauksen.

===Muuttujat===
Seuraavien tyypillisesti ebuildin alussa määriteltävien muuttujien määrittely on suositeltavaa:

#kuvaus
DESCRIPTION="tässä kerrot mitä ohjelma tekee"
#ohjelman kotisivu
HOMEPAGE="http://hyodyllinen.ohjelma.org"
#mistä ohjelman lähdekoodi haetaan
SRC_URI="ftp://hyodyllinen.ohjelma.org/pub/${P}.tar.bz2"
#ohjelman lisenssi
LICENCE="GPL-2"
#kertoo, mihin slottiin ebuild asentuu, Gentoossa samassa slotissa
#ei voi olla kahta samannimistä pakettia
SLOT="0"
#kertoo mihin avainsanoihin ebuild kuuluu
KEYWORDS="x86 -*"
#kertoo mitkä USE-muuttujat vaikuttavat ebuildiin
IUSE=""

#kertoo mitkä paketit ovat paketin riippuvuuksia
DEPEND="dev-libs/hyodyllinen-kirjasto"
#kertoo ne ebuildit, jotka ovat ebuildin ajonaikaisia riippuvuuksia
#tyypillisesti dynaaminen kirjastolinkkaus voi hajota vain näihin.
RDEPEND="dev-libs/hyödyllinen-kirjasto"

====Paketinnimi-muuttujat====
Kokonaisuudelle, jonka ebuildin nimi on kategoria/paketti-1.0-r1.ebuild muuttujat ovat

*P="paketti-1.0"
*PN="paketti"
*PV="1.0"
*PR="r1"
*PVR="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ä.

====Hakemistomuuttujat====
*ROOT="/" kertoo, mitä juurta portagen, tai vastaavan, ylläpitämä systeemi käyttää. Älä koske tämän ulkopuolelle, äläkä muuta tätä muuttujaa.

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

*S="${WORKDIR}/${P}" Tämä kertoo pääasiallisen kansion, jossa työ tehdään oletusasetusta voi muokata tarpeen mukaan, yleensä suhteessa WORKDIR:iin.

*T="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/temp" Tilapäishakemisto vapaasti käytettävissä.

*D="${PORTAGE_TMPDIR}/portage/${CATEGORY}/${PF}/image" Hakemistokuva asennettavasta kokonaisuudesta. Älä muuta.

====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====
*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:
*QA_TEXTRELS
*QA_EXECSTACK
*QA_WX_LOAD

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

====pkg_nofetch====
Tätä funktiota kutsutaan, mikäli RESTRICT="fetch" on asetettu ja ebuildin SRC_URI kohdetta ei kyetä noutamaan.
pkg_nofetchin jälkeen muita funktioita ei kutsuta vaan siirrytään ohjelman loppuun.
====pkg_setup====
Ajetaan tarkistuksia asetusten suhteen.
====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.

====src_compile====
Tässä funktiossa käännetään lähdekoodi tai tehdään muuta vastaavaa.

====src_test====
Funktiota kutsutaan src_compilen jälkeen, mikäli FEATURES="test" on määritelty, funktiossa tulee ajaa asennettavan ohjelman tarjoamat yksikkötestaus-rutiinit, oletustoteutuksessa nämä ovat <tt>make check</tt> ja <tt>make test</tt>

====src_install====
Tässä funktiossa siirretään kokonaisuuden asennettava osa, esim suoritettava binääri, hakemistorakenteeseen, jonka juurena toimii muuttujan $D osoittama hakemisto, esimerkiksi make install DESTDIR=$D

====pkg_preinst ja pkg_postinst====
Nämä funktiot ajetaan sandboxin ulkopuolella ennen ja jälkeen $D-kuvan sisällyttämistä varsinaiseen ROOT-muuttujan osoittamaan kohteeseen, tyypillisesti "/".

====pkg_prerm ja pkg_postrm====
Vastaavasti kuin edelliset nämä ajetaan ennen ja jälkeen kokonaisuuden sisällön, eli sen, minkä asensit $D:hen, poistamista järjestelmästä.

====pkg_config====
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===
*Import-lauseella voit sisällyttää ebuildiin .eclass-tiedostoja eclass-hakemistosta
*'#'-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.

==Muuta luettavaa==

===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 gentoossa saat
emerge portage-manpages

*<tt>man eutils.eclass</tt> ...

[[Luokka:Ylläpitotyökalut]]

Säännöllinen lauseke

2007-05-10T11:25:24Z

Jkarlson: /* tai */

Säännöllinen lauseke (engl. regular expression, regexp) on merkkijonotemplaatti [[wikipedia:fi:säännöllinen kieli| säännölliselle kielelle]], joka siis voidaan tunnistaa [[wikipedia:fi:äärellinen automaatti|äärellisellä automaatilla]]. Säännöllisiä lausekkeita käytetään monissa ohjelmointikielissä.

==Toteutukset==
===[[Posix]]-tyylinen===
====elementit====
*[<merkkejä>] mikä tahansa merkeistä, tässä usein sallitaan myös laajempia ilmauksia kuten a-z, englantilaisille pienaakkosille, ja 0-9, numeroille.
*$<sisältö elementtinä>$ merkitsee sisältönsä yhdeksi elementiksi toistolauseille ulospäin täydelliseksi säännölliseksi lausekkeeksi sisällepäin.
====toisto-operaattorit====
*'*': edellinen elementti 0 tai mielivaltaisen montaa kertaa kokonaan
*'+': edellinen elementti mielivaltaisen monta kertaa
*'?': edellinen elementti 0 tai 1 kertaa
monissa sovelluksissa sallitaan myös
*'{<toistokerrat>}': edellinen elementti toistokerrat kertaa
====unioni(tai)====
merkkijono kuuluu kieleen, jos se kuuluu | edeltävään tai sen jälkeiseen säännölliseen lauseekkeeseen.

====erityismerkit====
*'^': Rivin alku, tämä ei siis vastaa rivin ensimmäistä merkkiä vaan vain rivin alkua.
*'$': Rivin loppu, vastaavasti.
*'.': mikä tahansa merkki
===[[Perl]]===

==Linkkejä==
===Wikipedia===
*[[wikipedia:fi:säännöllinen lauseke|Säännöllinen lauseke]]
*[[wikipedia:fi:äärellinen automaatti|Äärellinen automaatti]]
*[[wikipedia:fi:pinoautomaatti|Pinoautomaatti]]
*[[wikipedia:fi:turingin kone|Turingin kone]]

[[Luokka:Käsitteet]]

Säännöllinen lauseke

2007-05-10T11:24:28Z

Jkarlson: /* Posix */

Säännöllinen lauseke (engl. regular expression, regexp) on merkkijonotemplaatti [[wikipedia:fi:säännöllinen kieli| säännölliselle kielelle]], joka siis voidaan tunnistaa [[wikipedia:fi:äärellinen automaatti|äärellisellä automaatilla]]. Säännöllisiä lausekkeita käytetään monissa ohjelmointikielissä.

==Toteutukset==
===[[Posix]]-tyylinen===
====elementit====
*[<merkkejä>] mikä tahansa merkeistä, tässä usein sallitaan myös laajempia ilmauksia kuten a-z, englantilaisille pienaakkosille, ja 0-9, numeroille.
*$<sisältö elementtinä>$ merkitsee sisältönsä yhdeksi elementiksi toistolauseille ulospäin täydelliseksi säännölliseksi lausekkeeksi sisällepäin.
====toisto-operaattorit====
*'*': edellinen elementti 0 tai mielivaltaisen montaa kertaa kokonaan
*'+': edellinen elementti mielivaltaisen monta kertaa
*'?': edellinen elementti 0 tai 1 kertaa
monissa sovelluksissa sallitaan myös
*'{<toistokerrat>}': edellinen elementti toistokerrat kertaa
====tai====
merkkijono kuuluu kieleen, jos se kuuluu | edeltävään tai sen jälkeiseen säännölliseen lauseekkeeseen.
====erityismerkit====
*'^': Rivin alku, tämä ei siis vastaa rivin ensimmäistä merkkiä vaan vain rivin alkua.
*'$': Rivin loppu, vastaavasti.
*'.': mikä tahansa merkki
===[[Perl]]===

==Linkkejä==
===Wikipedia===
*[[wikipedia:fi:säännöllinen lauseke|Säännöllinen lauseke]]
*[[wikipedia:fi:äärellinen automaatti|Äärellinen automaatti]]
*[[wikipedia:fi:pinoautomaatti|Pinoautomaatti]]
*[[wikipedia:fi:turingin kone|Turingin kone]]

[[Luokka:Käsitteet]]

Siirrettävyys

2007-05-10T10:47:15Z

Jkarlson:

Siirrettävyys on lähdekoodin ominaisuus, joka kertoo kuinka hyvin lähdekoodia vastaava ohjelma tai toimii erilaisissa ympäristöissä.

==Katso==
*[[LSB]]
*[[posix]]

POSIX

2007-05-10T10:41:24Z

Jkarlson:

[[IEEE]]:n standardikokoelma koskien käyttöjärjestelmien tarjoamia rajapintoja ja muuta toiminnallisuutta. Tämä on olennaista muunmuassa [[siirrettävyys|siirrettävyyden]] takaamisessa.

==Katso==
*[[wikipedia:fi:posix| posix wikipediassa]]
*[[LSB]]