Un article de Gentoo Linux Wiki.

Gentoo pour Mac OS X est le Portage de Gentoo utilisé sous Mac OS X ; c'est très récent, et en lourd développement/tests (version alpha). Portage installe des logiciels dans le répertoire racine / et peut éventuellement écrire par dessus des paquetages importants qui avaient été installés par Mac OS X. En utilisant cette technologie, vous prenez vos propres risques !

[modifier] Pré-requis

Pour utiliser Gentoo pour MacOS, vous devez avoir Macintosh OS 10.2 ou supérieur. De plus, vous devez installer l'outil de développement XCode (version 1.2 ou supérieure) que vous pouvez télécharger sur le Apple Developer Connection member site (un compte gratuit doit être ouvert).

[modifier] Installation

Installer Gentoo pour Mac OS X est très simple si vous suivez les instructions décrites ci-dessous. Si vous avez un problème quelconque, où qu'il soit, consultez la partie sur les problèmes rencontrés, ou venez en parler sur le channel IRC #gentoo-osx sur irc.freenode.net.

[modifier] L'installeur

Tout d'abord vous devez télecharger le disque image du programme d'installation de Gentoo pour Mac OS X (dmg). Vous pouvez l'obtenir sur metadistribution.org. Montez l'image dmg (en double-cliquant dessus) et lancez l'installation (encore une fois en double-cliquant), puis suivez les instructions à l'écran.

[modifier] Terminal.app

Après que le programme d'installation ait fini son travail, vous devez ouvrir Terminal.app (ou n'importe quel autre émulateur de terminal). Si vous avez déjà Terminal.app d'ouvert, vous devrez ouvrir une nouvelle fenêtre (un nouveau shell) pour pouvoir continuer. De plus, notez qu'utiliser un autre shell que bash n'est pas supporté et ne marchera probablement pas. Vous pouvez facilement changer le shell par défaut pour Terminal.app ; cela se trouve dans la fenêtre de préférences de Terminal (cliquer sur Terminal->Préférences dans le menu pour afficher cette fenêtre), en choisissant l'option "Exécuter cette commande" et taper :

/bin/bash

[modifier] Mise à jour de Portage

Il est important de garder à jour la base de données des informations sur les paquetages de portage (habituellement appelée 'l'arborescence de portage' -en anglais 'portage tree', qui est situé dans /usr/portage). L'arborescence de portage contient les information de tous les paquetages que portage connaît et sait installer, ainsi que les directions à prendre pour installer le paquetage pour vous. Il est important de mettre à jour ces informations (il est demandé de ne pas faire plus d'une mise à jour par jour selon la charte -NdT-) avant de continuer, afin d'être sûr que nous avons bien les dernières informations sur les derniers paquetages.

Une fois dans la console, vous devrez avoir les privilèges root pour pouvoir continuer. Si vous êtes l'administrateur système de l'ordinateur, c'est facilement réalisé à l'aide de la commande sudo.

# sudo su
Password:

Pour être sur que vous utilisez les dernières mises à jour et informations disponibles, vous devrez effectuer une synchronisation de votre arborescence de portage avec la dernière en date sur les serveurs de Gentoo :

# emerge sync

[modifier] Configuration

Vous devez désormais signaler à Portage quelques points à propos de votre version de OSX. Portage utilise les fichiers dans /etc/make.profile pour déterminer quels paquetages sont déjà installés par Mac OS X, quels paquetages sont masqués selon votre version de MacOS X, et les options de configuration par défaut. Nous vous recommandons d'utiliser l'un des profils disponibles, et de simplement fournir au système un alias de /etc/make.profile vers un profile déjà préparé. Entrer la commande de l'un des deux blocs de code suivant, en choisissant le plus approprié pour votre système.

ln -s /usr/portage/profiles/default-darwin/macos/10.3 /etc/make.profile

ln -s /usr/portage/profiles/default-darwin/macos/10.4 /etc/make.profile

Les utilisateurs expérimentés pourront également s'aventurer dans une configuration personnalisée en spécifiant des options de configuration dans /etc/make.conf. Cela n'est pas recommandé pour l'utilisateur moyen.

[modifier] Installer les paquetages systèmes

Puis vous devrez 'emerger' le système. Cela installe des paquetages dont portage a besoin pour fonctionner entièrement et correctement :

# emerge system

Bravo ! Votre nouvelle Gentoo pour MacOSX est désormais opérationnelle.

[modifier] Erreurs rencontrées

• emerge: command not found

L'installeur de Gentoo pour Mac OSX met à jour le fichier /etc/profile en ajoutant /usr/lib/portage/bin dans votre variable d'environnement PATH. Afin de pouvoir taper simplement "emerge ...", vous devriez taper source /etc/profile ou vous délogger puis relogger, et ce afin éviter d'avoir à taper le chemin complet (/usr/lib/portage/bin/<toolname>) pour lancer des outils de Portage.

• Problèmes avec GNU sed

Si vous rencontrez des problèmes avec GNU sed, lisez la page en:PortingTips

[modifier] Installer des logiciels en utilisant Portage

Pour installer un paquetage à l'aide de portage, tout ce que vous avez à faire est de l'"emerger". Portage s'occupera de la gestion des dépendances du paquetage. Installer un paquetage est très simple une fois que l'on connaît le nom de celui-ci.

# emerge lynx

[modifier] Les paquetages masqués

Vous devriez pouvoir installer n'importe quel paquetage qui a déjà été testé comme fonctionnant avec macos, et mise à jour dans l'arborescence de Portage. Pour l'instant, très peu de paquetages ne sont pas masqués. Si un ebuild n'a pas encore le mot-clef macos, vous aurez un message similaire à celui-ci :

root# emerge -p cowsay

 These are the packages that I would merge, in order:
 
 Calculating dependencies
 !! all ebuilds that could satisfy "cowsay" have been masked.
 !! possible candidates are:
 - games-misc/cowsay-3.03 (masked by: missing keyword)

[modifier] Paquetages en test (testing)

Vous pouvez vouloir tester un paquetage vous-même pour voir s'il fonctionne, sans tenir compte de son état masqué. Même si l'on ne recommande pas aux utilisateurs moyen de le faire, les personnes qui voudraient aider les développeurs à tester les paquetages sont libres de démasquer et tester les paquetages qu'ils veulent sur leur système. Cela peut se faire en ajoutant le mot-clef 'macos' dans le fichier d'informations du paquetage, lebuild'. Pour ajouter le mot-clef macos dans un ebuild, vous devez utiliser la commande 'ekeyword', qui fait parti du paquetage gentoolkit-dev.

# emerge gentoolkit-dev

root# cd /usr/portage/games-misc/cowsay
# ekeyword macos cowsay-3.03.ebuild

Si un paquetage compile correctement, merci de nous le faire savoir en faisant un report de bug sur http://bugs.gentoo.org (inscription libre nécessaire) qui nous signalera que le paquetage marche (vous pouvez assigner le bug à l'équipe de développement de Gentoo pour Mac OS X, osx@gentoo.org). S'il ne compile pas, merci de soumettre un report de bug, de la même façon, en signalant l'erreur que vous avez eu (vous aurez sûrement plusieurs erreurs, copiez à partir du premier message de compilation qui retourne une erreur jusqu'à la fin de l'emerge).

Vous aurez besoin d'installer le paquetage de développement de X11 pour la plupart des paquetages nécessitant X11. Si vous ne l'avez pas déjà fait à l'installation de XCode, vous pouvez installer facilement celui-ci à partir du fichier X11SDK.pkg qui se trouve dans le répertoire Packages de votre CD de XCode 1.2 (cliquez simplement dessus pour l'installer). Voir la page en:PackagesThatNeedX11 pour plus de détails. Dans l'absolu, évitez d'emerger portage à partir des ebuilds. Il y a un certain nombre de paquetages qui dépendent d'un portage encore en développement, comme gentoolkit. Plus d'informations sur la page en:PortageDeps.

[modifier] Les paquetages déjà installés

Si vous trouvez un paquetage qui est déjà installé par Mac OS X, vous devriez envoyer un bug à http://bugs.gentoo.org. Sue votre système, vous pouvez ajouter un paquetage dans /etc/portage/package.provided pour que Portage comprenne que ce paquetage est déjà installé.

root# echo nom-cat/paquetage-x.y.z >> /etc/portage/package.provided

Pour avoir une liste des paquetages que les développeurs ont déjà détecté comme étant préinstallés par Apple dans votre version de Mac OS X, vous pouvez consulter /etc/make.profile/package.provided. Modifier ce fichier n'est pas recommandé, puisqu'il sera remplacé par un autre à chaque fois que vous mettrez votre arborescence de Portage à jour (en utilisant 'emerge sync').

[modifier] Utiliser CVS

Les script présents dans CVS ont des problèmes avec les systèmes de fichiers comme HFS(+). Ainsi, pour faire un checkout de l'arborescence CVS vous devrez créer une image sensible à la casse (d'au moins 750Mo) dans laquelle portage sera mis. Vous pouvez utiliser l'une des deux commandes suivantes, qui permettent de créer un tel système de fichier :

# hdiutil create -size 750m <Imagename> -volname <Volumename> -fs UFS

# hdiutil create -size 750m <Imagename> -volname <Volumename> -fs HFSX

[modifier] Désinstaller Gentoo pour Mac OS

Pour désinstaller Gentoo pour MacOS X, vous pouvez utiliser le script perl de désinstallation (http://dev.gentoo.org/~alexander/files/uninstall.pl) qui vous permet de choisir ou non de désinstaller également les paquetages que vous avez emergé avec Gentoo pour MacOS. Lancez le script avec les privilèges root :

# sudo perl uninstall.pl

[modifier] Les paquetages disponibles

Il y a plusieurs façons de savoir quels ebuils compilent jusque là sur MacOS :

• Gentoo Linux Fresh Mac OS X Ebuilds
• Gentoo Portage (check the advanced search)
• [[Gentoo MacOS compiles] On the Wiki] (plus à jour)
• http://packages.gentoo.org/feeds

[modifier] Eléments avancés

Le dernier programme d'installation de Gentoo pour MacOS propose un système de protection contre les collision, qui empêche Portage d'écrire par dessus des fichiers qu'il ne possède pas ou n'a pas installé. Vous pouvez désactiver cette protection avec le drapeau FEATURES="-collision-protect". Par exemple (Ceci est dangereux, ne le faites pas) :

root# FEATURES="-collision-protect" emerge autoconf

[modifier] Equipes de développement de Gentoo pour MacOS

[modifier] Développement

• Management du projet
  • Manager technique : pvdabeel
  • Manager opératoire : dostrow

• Documentation (pages du projet incluses)
  • Leader : alexander
  • Membres : alexander, dostrow, schlesi
  • Traduction française : iznogoud

• Tests des ebuilds
  • Leaders : j4rg0n, gongloo
  • Membres : j4rg0n, gongloo, liquidx, bubi

• Portage :
  • Leader : liquidx
  • Membres : liquidx, twk-b

• équipe IHM :
  • Leader : pas encore défini, candidats : hansmi, dostrow
  • Membres : hansmi, dostrow, twk-b
  • Commentaires : Il y avait un installeur graphique, nommé iportage, écrit par ct. Ajouter un support des metadata à l'installeur et une interface de préférences système pour les paquetages, comme MySQL, a été proposé.

[modifier] Liens utiles

• Guide d'installation officiel