Ceci est le guide d'utilisation de l'environnement de compilation de Owl. Il
assume que vous ayez lu les CONCEPTS; sinon, merci de les lire avant que
vous ne continuiez avec ce document.


	Organisation de /usr/src/world.

L'environnement de compilation est pr-configur pour l'utilisation de
/usr/src/world (la valeur de HOME= dans les fichiers buildworld.conf et
installworld.conf). Il est recommand que vous laissiez cette valeur par
dfaut et soit que vous placiez effectivement les fichiers dans
/usr/src/world soit que vous utilisiez un lien symbolique si /usr/src n'est
pas sur un priphrique appropri (voir ci-dessous les besoins).

En compilant nativement (c.--d. sur Owl), le rpertoire est dj l.
Autrement, vous avez besoin de crer le rpertoire, ajouter le pseudo
utilisateur "build", de prfrence avec l'UID 151 et le GID 150
("sources"), et le rendre propritaire du rpertoire.

Placez l'arborescence CVS dans /usr/src/world. La faon la plus simple pour
faire cela est en extrayant native.tar.gz disponible via les miroirs FTP.
Vous obtiendrez le rpertoire "native", et un lien symbolique Makefile.

Pour compiler effectivement depuis les sources, placez galement le
rpertoire "sources" dans /usr/src/world.

Si vous n'tes pas, encore, sur un systme Owl et voulez installer des
paquets binaires, crez /usr/src/world/RPMS et placez y les paquets pour
votre architecture. Notez que vous avez besoin de l'arborescence CVS mme
pour installer les paquets binaires.


	Besoins.

Pour (re-)compiler Owl depuis les sources, vous aurez besoin :

d'au moins de 1000 Mo d'espace disque libre sous /usr/src/world utilisables
durant les compilations;

d'au moins 64 Mo de mmoire physique (il est possible de compiler sur moins
avec suffisamment d'espace de swap, mais vous ne devriez pas);

d'au moins 200 Mo de mmoire virtuelle en compilant sur et pour un Alpha;

de 1  5 heures de temps CPU, sur un systme moderne (au moment de cette
criture).

Et, bien sr, vous devriez excuter la compilation sur Owl. Compiler sur un
autre systme GNU/*/Linux est possible, mais difficile et ncessite que vous
convertissiez effectivement le systme en Owl avec plusieurs itrations de
"make buildworld" et "make installworld".

Voici quelques temps de compilation (heures:minutes), ainsi vous savez 
quoi vous attendre :

Dual Pentium 4 Xeon, HT (4-way MP), 2.8 GHz, 2 GB		0:50
Dual Pentium III, 600 MHz, 512 MB				3:35
UltraSparc IIi, 400 MHz, 256 MB					10:00
Alpha 21164PC (164SX-1MB), 533 MHz, 128 MB			14:00

(Oui, gcc est si gourmand et lent sur Alpha.)

Les temps de compilation vont augmenter quand nous ajouterons plus de
paquets et mettrons  jour vers de nouvelles versions de logiciels dj dans
Owl.


	(Re-)compilations natives.

Vous avez besoin d'avoir un noyau Linux 2.4.x configur sans
/usr/src/linux. En tant que l'utilisateur "build", changez de rpertoire
vers /usr/src/world et tapez :

	make clean && make buildworld

Avec le fichier buildworld.conf par dfaut, les paquets seront compils pour
la version la plus ancienne de l'architecture du systme de compilation
(voir ARCHITECTURES) et la compilation tentera d'utiliser tous les
processeurs systmes.

Le fichier buildworld.conf (aussi bien que les autres fichiers *.conf) peut
tre dit en le copiant depuis native/Owl/build vers /usr/src/world. Vous
avez d'abord besoin de supprimer le lien symbolique, si un a t cr pour
vous auparavant.

Tous les paquets sont compils avec les versions de bibliothques et
d'outils de compilation qui sont installes sur le systme. Plusieurs
itrations de buildworld et installworld (deux sont suffisantes la plupart
du temps) doivent tre utilises quand il y a eu des mises  jour
significatives des paquets utiliss durant les compilations.


	Installations de paquets binaires.

"make installworld" installera les paquets trouvs dans /usr/src/world/RPMS
dans le systme courant, ou dans tout nouveau rpertoire racine de votre
choix (comme spcifi par la valeur de ROOT= dans le fichier
installworld.conf). Par dfaut, les paquets seront installs dans /owl.

"make installworld" doit tre excut en tant que root.


	(Re-)compilations de paquets individuels.

Les paquets individuels peuvent tre compils ou re-compils avec
"make PACKAGE=nom" o "nom" est le nom du paquet source. Pour les paquets
trangers (SRPMs) compils avec l'environnement de compilation de Owl vous
avez aussi besoin d'inclure dans "nom" la partie numro de version.

$Owl: Owl/doc/fr/BUILD,v 1.10 2006/02/15 16:38:43 solar Exp $
