Manual de Referinţă pentru Catalyst

1.  Introducere

Acest document se doreşte a fi o referinţă completă pentru toate platformele ţintă ale Catalyst, opţiunile fişierelor specificaţie, şi a tuturor celorlalte aspecte ale Catalyst.

2.  Referinţe privind Versiunea Ţintă Snapshot

Numele ţintei: snapshot

Descrierea Ţintei: O versiune snapshot pentru Portage, arborele Portage pregătit şi compresat folosit pentru construirea tuturor celorlaltor ţinte.

Versiunea snapshot ţintă foloseşte următoarele setări:

3.  Referinţe privind Arhivele Tar Ţintă (stage1, stage2, stage3)

Numele ţintei stage1

Descrierea ţintei: o arhivă tar stage1, elementul de bază pentru construirea arhivelor tar stage2 şi stage3.

Cerinţe pentru construire: O versiune snapshot a arborelui Portage ca şi o arhivă "sursă" stage2 sau stage3 pentru configurarea mediului chroot.

Fişierul ţintă stage1 foloseşte urmatoarele setări:

4.  Referinţe privind GRP

Numele ţintei: grp

Descrierea ţintei: Un set de pachete GRP. GRP este acronimul pentru 'Gentoo Reference Platform' şi constă dintr-un set de pachete şi arhive sursă, grupate în (opţional) directoare separate pentru o uşoară integrare în CD-urile de instalare.

Cerinţe pentru construire: Un snapshot al arborelui Portage şi o arhivă sursă stage3.

Ţinta GRP foloseşte următoarele setări:

5.  Referinţe despre Ţinta Tinderbox

Numele ţintei: tinderbox

Descrierea ţintei: Tinderbox este o ţintă de tip QA (Quality Assurance - Asigurarea Calităţii) folosit pentru a construi serii de pachete de test

Cerinţe pentru construire: Un snapshot al arborelui Portage şi o arhivă sursă stage3

Ţinta tinderbox foloseşte următoarele setări:

Utilizare: Iată cum funcţionează tinderbox. Arhiva sursă specificată este folosită pentru a configura mediul chroot. Apoi, rsync este folosit pentru a crea o copie de siguranţă iniţială curată a mediului chroot. Primul pachet specificat în tinderbox/packages este instalat, folosind indicatorii USE specificaţi în tinderbox/use. Instalarea fiind corectă, Catalyst foloseşte rsync pentru a restaura mediul chroot la forma sa originală. Apoi, fiecare pachet specificat în tinderbox/packages este instalat în mod succesiv; fiecare instalare este urmată de "reîntoarcerea la starea iniţială", adică pasul rsync.

Din cauza pasului rsync, adică reîntoarcerea la starea iniţială, tinderbox poate detecta erori în dependenţele dibtre pachete. Pentru ca un pachet să fie compilat cu succes, trebuie să depindă de orice ar avea nevoie pentru o compilare curată dintr-o arhivă stage3 originală. De asemenea, acestă testare a tinderbox este chiar foarte eficientă când pkgcache este activat în /etc/catalyst/catalyst.conf, deoarece pachetele pre-construite vor fi folosite pentru satisfacerea oricăror dependenţe. Aceasta înseamnă că pachete mari consumatoare de CPU ca xfree vor fi compilate doar odată pentru fiecare rulare a tinderbox, demonstrând că pkgcache este activat.

Tinderbox va continua să compileze prin parcurgerea tuturor pachetelor specificate în tinderbox/packages, chiar dacă unele pachete nu se vor compila. Un fişier log al compilării este creat şi localizat la [storedir]/tmp/[rel_type]/[subarch]-tinderbox-[version_stamp]/tmp/tinderbox.log. Dacă un pachet este compilat corect, o linie va fi înregistrată în acest fişier ce va conţine numele pachetului aşa cum este specificat în tinderbox/packages. Dacă un pachet nu este compilat corespunzător , o linie va fi înregistrată în acest fişier şi va conţine numele pachetului, precedat de "! ". Luaţi aminte că eşecurile în compilarea unor pachete anterioare pot cauza mai târziu erori în compilarea viitoarelor pachete.

În afara fişierului /tmp/tinderbox.log creat în interiorul mediului chroot, tinderbox nu efectuează un alt proces de log. Pentru a efectua log procesului de compilare, folosiţi comanda script împreună cu catalyst, după cum urmează:

# script
Script started, file is typescript
# catalyst -f /foo/bar/oni.spec
# exit Script done, file is typescript

Apoi, deschideţi fişierul typescript din directorul curent pentru un log complet al procesului de compilare.

6.  Referinţe privind Livecd-stage1

Numele ţintă: livecd-stage1

Descrierea ţintei: Prima ţintă prealabilă pentru construirea unui LiveCD, de fapt o arhivă compresată ce conţine un fişier stage3 plus alte pachete.

Cerinţe pentru construire: Un snapshot al arborelui Portage şi o arhivă sursă stage3

Ţinta livecd-stage1 foloseşte următoarele setări:

7.  Referinţe pentru Ţinta Livecd-stage2

Numele ţintă: livecd-stage2

Descrierea ţintei: Această ţintă pregăteşte LiveCD-ul pentru uz general. Un LiveCD stage2 conţine un livecd-stage1 plus kernel şi scripturi iniţializare (initrd) ce vor fi folosite pentru boot-area imaginii CD-ului.

Cerinţe pentru construire: Un snapshot cu arborele Portage şi o imagine sursă cu livecd-stage1

LiveCD-stage2 foloseşte următoarele setări:

8.  Referinţe despre Opţiunile Catalyst

Introducere

Sunt multe diferite opţiuni ce pot fi setate în catalyst.conf. Găsiţi mai jos explicaţii detaliate a fiecăreia.

ccache

Numele Opţiunii: ccache

Descriere: Activează suportul ccache în timpul compilării.

Scop: Măreşte dramatic viteza compilării după prima compilare.

Utilizare: Adăugaţi ccache la options în /etc/catalyst/catalyst.conf.

Exemplu: options: ccache

pkgcache

Numele Opţiunii: pkgcache

Descriere: Activează caching-ul arhivelor sursă .tbz2.

Scop: Măreşte dramatic viteza compilării după prima compilare prin utilizarea pachetelor precompilate.

Utilizare: Adăugaţi pkgcache la options în /etc/catalyst/catalyst.conf.

Example: options: pkgcache

distcc

Numele Opţiunii: distcc

Descriere: Activează compilarea distribuită în reţea.

Scop: Măreşte dramatic viteza compilării prin utilizarea mai multor calculatoare gazdă pentru compilare.

Utilizare: Adăugaţi distcc la options în /etc/catalyst/catalyst.conf, şi setaţi distcc_hosts în fişierele dvs. specificaţie (spec).

Exemplu: options: distcc

envscript

Nume Parametru: envscript

Descriere: Activează definirea oricărei variabile de mediu ce va fi utilizată în timpul compilării.

Scop: Pentru a activa folosirea setărilor HTTP proxy, MAKEOPTS, şi a altor setări specifice mediului.

Utilizare: Setaţi envscript=script.sh în /etc/catalyst/catalyst.conf. Un script envscript foloseşte următorul format:

export MAKEOPTS="-j4"
export GENTOO_MIRRORS="mymirror"
export meep="foo"

storedir

Numele Opţiunii: storedir

Descriere: Specifică directorul principal de lucru al Catalyst.

Scop: Activează definirea din partea utilizatorului a directorului de lucru.

Utilizare: Setaţi storedir către o locaţie specificată în /etc/catalyst/catalyst.conf

Exemplu: storedir: /home/user/catalyst_storedir

sharedir

Numele Opţiunii: sharedir

Descriere: Specifică locaţia pricipalelor fişiere program şi binare ale Catalyst.

Scop: Activează definirea din partea utilizatorului a locaţiei pricipalelor fişiere program şi a binarelor Catalyst.

Utilizare: Setaţi sharedir către o locaţie specificată în /etc/catalyst/catalyst.conf

Exemplu: sharedir: /home/user/catalyst_sharedir