QU'EST-CE QUE DARWINPORTS DarwinPorts est un gestionnaire permettant de compiler, d'installer et d'archiver un logiciel, similaire en termes de fonctionnalités à l'architecture des ports FreeBSD afin de maintenir une extensibilité future. DarwinPorts fonctionne et permet d'être compilé sur Mac OS X 10.2 (Darwin 6.0), Mac OS X 10.3 (Darwin 7.0.0) et Mac OS X 10.4 (Darwin 8.0.0). Le système est portable, et est écrit en TCL avec un set limité d'extensions TCL en C. Le "DarwinPorts User Guide" est disponible à : http://darwinports.opendarwin.org/docs Pour une documentation plus appronfondie sur l'architecture interne de ce système de ports, reportez-vous au fichier base/docs/INTERNALS. Notez svp que l'architecture de DarwinPorts est composé de deux parties. "L'infrastructure de DarwinPorts", qui réside dans le sous-répertoire base/ est le seul composant obligatoire du système, et le répertoire "dports" qui contient la description des logiciels portés. Le dernier composant peut être optionnel et peut être récupéré sur le net ou une copie locale peut également être utilisée. Reportez-vous à la documentation sur ${prefix}/etc/ports/sources .conf ci-dessous. INSTALLATION Pour des instructions d'installation spécifiques à d'autres plateformes, reportez-vous au fichier base/docs/README.platforms. Étapes de l'installation : 1. cd base/ ./configure Vous place dans le répertoire base/ et lance le script configure. Des paramètres peuvent être passés au script (cf. ci-dessous). 2. make Lancez 'make' pour compiler tout ce qui est nécessaire. 3. sudo make install Lancez 'sudo make install' pour installer DarwinPorts sur votre système. 4. [optionnel] éditez ${prefix}/etc/ports/ports.conf Le fichier de configuration "${prefix}/etc/ports/ ports.conf" définit la majeure partie des options de configuration de l'infrastructure de DarwinPorts si vous désirez changer les chemins et emplacements où sont stockés les données, changez les options suivantes : portdbpath Spécifie la base où stocker les données spécifiques au système de ports. prefix Indique la base dans laquelle installer les ports. 5. [optionnel] éditez ${prefix}/etc/ports/sources.conf Le fichier "${prefix}/etc/ports/sources.conf" liste l'emplacement des hiérarchies des ports locales et distantes. Si l'argument "--with-dports-dir=RÉP." n'a pas été utilisé lors du lancement du script "./configure", la hiérarchie de dports (darwinports/dports, depuis la copie que vous avez installé) sera ajoutée au fichier "source.conf". Tout le code TCL nécessaire sera compilé et installé comme indiqué ci-dessous: [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0 [Mac OS X 10.3] /Library/Tcl/darwinports1.0 [Mac OS X 10.4] /Library/Tcl/darwinports1.0 [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0 - Librairie TCL permettant d'interagir avec le système DarwinPorts. ${prefix} est situé par défaut à /opt/local mais ce choix peut être modifié en changeant le répertoire pour base/ et en utilisant manuellement ./configure avec l'argument --prefix ${prefix}/bin/port - Utilitaire en mode texte pour la compilation de port ${prefix}/share/darwinports/ - Librairies TCL internes du système de ports Les fichiers suivants sont fournis en vue de la personnalisation du système : ${prefix}/etc/ports/ports.conf - Réglages personnels des ports pour les utilisateurs ${prefix}/etc/ports/sources.conf - Liste des sources pour les ports (endroit où récupérer les données des ports) UTILISATION DE LA COMMANDE 'PORT' Si vous ne l'avez déjà fait, ajoutez /opt/local/bin à votre variable path (ou ${prefix}/bin si vous avez choisi d'installer DarwinPorts dans un autre emplacement). Si vous ne savez pas comment faire et utilisez Panther (Mac OS X 10.3) ou Tiger (Mac OS X 10.4), ajoutez la ligne suivante dans votre fichier ~/.profile. Si ce fichier n'existe pas, créez-le. (Cela est valable également si vous utilisez un bourne shell sous Jaguar (Mac OS 10.2)). export PATH=$PATH:/opt/local/bin Si vous utilisez Jaguar (Mac OS X 10.2), ajoutez la ligne suivante dans votre fichier ~/.cshrc. Si ce fichier n'existe pas, créez-le. (Cela est valable également si vous utilisez tcsh sous Panther (Mac OS 10.3) ou Tiger (Mac OS X 10.4)). set path=($path /opt/local/bin) Vos changements ne seront pris en compte que lorsque vous ouvrirez un nouveau shell. La commande suivante compilera et installera le port : port install Pour rechercher un port spécifique, essayez d'utiliser "port search" : port search vi Référez-vous à la page man de port(1) pour une documentation plus complète sur cette commande. Il est également possible d'effectuer des opérations, comme compiler ou récupérer tous les ports du système en utilisant la commande "portall". Elle prend les mêmes arguments essentiels que la commande "port" mais opère de façon interactive sur chaque port dans dports/. CRÉER DE NOUVEAUX PORTS Un port consiste en un répertoire contenant un fichier Portfile et ses fichiers associés. Actuellement les seuls fichiers livrés avec un port sont les patchs, et sont au minimum censés être gardés. Un fichier Portfile consiste en un code TCL valide, évalué par un interpréteur de DarwinPorts. Les fichiers Portfiles utilisent une syntaxe très stricte composée de paires de type clé/valeur, permettant d'autoriser à l'auteur l'utilisation complète des fonctionnalités offertes par TCL lorsque cela lui est nécessaire. Pour commencer reportez-vous au fichier base/doc/exampleport et la page man de portfile(7) ou au guide de DarwinPorts à : http://darwinports.opendarwin.org/docs