Guide utilisateur - 5. Fichier de Configuration de Fink

Ce chapitre vous décrit les différents éléments du fichier de configuration de Fink (fink.conf) et leur influence sur le comportement de Fink, en particulier sur celui de l'outil en ligne de commande fink (celui qui fonctionne avec la distribution source).

5.1 À propos de fink.conf

Lors de la première installation de Fink, vous devez répondre à un certain nombre de questions. Vos réponses servent à personnaliser le fichier de configuration, par exemple les miroirs que vous désirez utiliser pour le téléchargement des fichiers ou la façon d'acquérir les droits de super-utilisateur. Vous pouvez, à tout moment, réexécuter ce processus en lançant la commande fink configure. Certaines options ne peuvent être changées que manuellement en éditant le fichier fink.conf. En général, ces options sont réservés aux utilisateurs chevronnés.

Le fichier fink.conf est situé dans le répertoire /opt/sw/etc/ et peut être édité avec votre éditeur de texte préféré. Vous devez avoir les droits de super-utilisateur pour le modifier.

5.2 Syntaxe de fink.conf

Le fichier fink.conf est constitué de plusieurs lignes ayant le même format :

NomOption: Valeur

Il y a une option par ligne et le nom de l'option est séparée de la valeur par des double-points et une espace. Le contenu de la valeur dépend de l'option ; c'est généralement une valeur booléenne ("True" - vrai - ou "False" - faux), une chaîne de caractères ou une liste de chaînes de caractères séparées entre elles par une espace. Par exemple :

OptionBooléenne: True
OptionChaîne: QuelqueChose
OptionListe: Option1 Option2 Option3

5.3 Éléments obligatoires

Certains éléments doivent obligatoirement figuré dans le fichier fink.conf. Sans eux, Fink ne peut pas fonctionner correctement. Voici les éléments qui appartiennent à cette catégorie.

Basepath: chemin

Indique à fink où il est installé. Le chemin d'installation par défaut est /opt/sw, mais vous pouvez l'avoir changé lors de la première installation de Fink. Vous ne devez pas changer cette valeur après installation, fink ne s'y retrouverait plus.

5.4 Options utilisateur

D'autres éléments sont optionnels et permettent aux utilisateurs de changer le comportement de Fink.

RootMethod: su ou sudo ou none

Pour effectuer certaines opérations, Fink doit acquérir les droits de super-utilisateur. Les valeurs reconnues pour cette option sont sudo ou su. Si vous attribuez à cette option la valeur none (aucune), vous devrez d'abord acquérir les droits de super-utilisateur avant d'exécuter Fink. La valeur par défaut est sudo et ne doit pas être changée, sauf rares exceptions.
Trees: liste d'arborescences

La liste des arborescences disponibles est la suivante :
```
local/main      - tout paquet local que vous désirez installer
local/bootstrap - paquets utilisés pendant l'installation de Fink
stable/crypto   - paquets cryptographiques stables
stable/main     - autres paquets stables
unstable/crypto - paquets cryptographiques instables
unstable/main   - autres paquets instables
```
Vous pouvez aussi ajouter vos propres arborescences dans le répertoire /opt/sw/fink/dists pour faire ce que vous voulez, mais ce n'est pas nécessaire dans la plupart des cas. Les arborescences par défaut sont "local/main local/bootstrap stable/main". Cette liste doit toujours être identique à celle figurant dans le fichier /opt/sw/etc/apt/sources.list. À partir de la version 0.21.0, fink le fait automatiquement pour vous.

L'ordre des arborescences dans la liste est important. En effet, car les paquets issus d'une arborescence située en aval de la liste peuvent écraser ceux des paquets issus d'une arborescence située en amont de la liste.
Distribution: 10.1, 10.2, 10.2-gcc3.3, 10.3 ou 10.4

Fink doit savoir quelle version de Mac OS X est installée sur votre système. Mac OS X 10.0 et les versions antérieures ne sont pas gérées, et Mac OS X 10.1 et Mac OS X 10.2 ne sont plus maintenues dans les versions actuelles de fink. Les utilisateurs de Mac OS X10.2 ne peuvent installer que la version 0.24.7 de fink sortie en juin 2005. Ce champ est configuré par l'exécution du script /opt/sw/lib/fink/postinstall.pl. Il est peu probable que vous ayez à changer cette valeur.
FetchAltDir: chemin

En général, fink sauvegarde les sources qu'il télécharge dans le répertoire /opt/sw/src. Avec cette option, vous pouvez indiquer un autre répertoire pour le code source téléchargé. Par exemple:
```
FetchAltDir: /usr/src
```
Verbose: un nombre entre 0 et 3

Cette option permet de faire varier la quantité d'information que Fink donne sur ce qu'il est en train de faire. Les valeurs sont : 0 Quiet (Silencieux) (aucune indication sur les statistiques de téléchargement) 1 Low (Faible) (aucune indication pendant la décompression des archives tar) 2 Medium (Moyen) (affiche presque tout) 3 High (Fort) (affiche tout). La valeur par défaut est 1.
SkipPrompts: liste délimitée par des virgules

Disponible à partir de la version 0.25 de fink. Cette option permet d'utiliser les réponses par défaut à certaines questions. Chaque question appartient à une catégorie. Si cette catégorie apparaît dans la liste SkipPrompts, la réponse par défaut à cette question est choisie par fink après un très court laps de temps.

À l'heure actuelle, les catégories suivantes sont disponibles :

fetch - téléchargements et miroirs

virtualdep - choix entre différents paquets

Par défaut, cette liste est vide.
NoAutoIndex: booléen

Fink cache les fichiers de description de paquets dans /opt/sw/var/db/fink.db pour éviter d'avoir à les lire et les analyser à chaque fois qu'il est invoqué. Il vérifie si l'index des paquets doit être ou non mis à jour, sauf si la valeur de cette option est "True". Sa valeur par défaut est "False" et il n'est pas recommandé de la changer. Si vous le faites, vous devrez mettre à jour l'index manuellement en lançant la commande fink index.
SelfUpdateNoCVS: booléen

La commande fink selfupdate met à jour le gestionnaire de paquets Fink. Cette option assure que CVS n'est pas utilisé pour ce faire quand elle a pour valeur True. La valeur de l'option est définie automatiquement par la commande fink selfupdate-cvs, vous n'avez donc pas besoin de la modifier manuellement.
Buildpath: chemin

Fink doit créer plusieurs répertoires temporaires pour les paquets compilés à partir du source. Par défaut, ces répertoires sont placés dans /opt/sw/src/fink.build, mais si vous voulez qu'ils soient créés ailleurs, indiquez ici le chemin. Voir les définitions des champs KeepRootDir et KeepBuildDir dans la section Configuration Développeur pour de plus amples informations sur ces répertoires temporaires.

Sur Tiger, il est préférable que le répertoire de construction Buildpath se termine soit par .noindex, soit par .build, pour éviter que Spotlight n'indexe les fichiers temporaires de ce répertoire, ce qui aurait pour conséquence de diminuer la vitesse de compilation.
Bzip2Path: chemin du binaire bzip2 ou d'un binaire équivalent

Disponible à partir de la version 0.25 de fink. Cette option vous permet de modifier le chemin par défaut de la commande bzip2. Vous pouvez alors indiquer un chemin différent pour cette commande, passer des paramètres à bzip2 ou même utiliser un binaire équivalent tel pbzip2 pour décompresser les archives .bz2.

5.5 Options de téléchargement

Il existe plusieurs options dont la valeur influence la façon dont Fink télécharge les paquets.

ProxyPassiveFTP: booléen

Cette option indique à Fink s'il doit ou non utiliser le mode "passif" pour les téléchargements FTP. Pour certains serveurs FTP et certaines configurations de réseau, il faut donner à cette option la valeur True. Nous vous recommandons de lui laisser cette valeur, car le mode FTP actif est obsolète.
ProxyFTP: url

Si vous utilisez un proxy FTP, vous devez saisir son adresse ici, par exemple :
```
ProxyFTP: ftp://votrehôte.com:2121/
```
Laissez la valeur vide si vous n'utilisez pas de proxy FTP.
ProxyHTTP: url

Si vous utilisez un proxy HTTP, vous devez saisir son adresse ici, par exemple :
```
ProxyHTTP: http://votrehôte.com:3128/
```
Laissez la valeur vide si vous n'utilisez pas de proxy HTTP.
DownloadMethod: wget, curl, axel ou axelautomirror

Fink peut utiliser diverses applications pour télécharger les fichiers à partir d'Internet - wget, curl ou axel. La valeur axelautomirror utilise un mode expérimental de l'application axel pour déterminer le serveur le plus proche ayant le fichier demandé. L'utilisation des deux méthodes axel et axelautomirror n'est pas recommandé actuellement. L'application que vous choisissez comme méthode de téléchargement DOIT être installée !, faute de quoi aucun téléchargement n'aura lieu, car fink ne reviendra pas alors à la valeur par défaut curl.
SelfUpdateMethod: point, rsync ou git

fink peut utiliser différentes méthodes pour mettre à jour les fichiers info des paquets. rsync est la méthode recommandée. Cette méthode utilise rsync pour télécharger les fichiers qui ont été modifiés dans les arborescences activées. Notez qui si vous modifiez ou ajoutez des fichiers aux arborescences stable ou instable, le fait d'utiliser rsync les supprimera. Faites d'abord une sauvegarde, par exemple dans votre arborescence locale. git effectue le téléchargement à partir d'un accès anonyme ou d'un accès Github au serveur git de fink. Ceci présente l'inconvénient que git ne sait pas changer de miroirs, aussi, si le serveur n'est pas disponible, vous ne pouvez pas mettre à jour. point ne télécharge que la dernière version officielle des paquets. Cette méthode n'est pas recommandée car vos paquets risquent, alors, d'être obsolètes.
SelfUpdateCVSTrees: liste d'arborescences

Disponible à partir de la version 0.25 de fink. Par défaut, la méthode cvs ne met à jour que l'arborescence de la distribution en cours. Cette option permet de modifier la liste des versions de distribution qui sont mises à jour pendant l'exécution de la commande selfupdate. Notez que vous devez avoir installé un binaire "cvs" récent si vous désirez inclure des répertoires qui ne comportent pas de sous-répertoires CVS, comme par exemple dists/local/main.
UseBinaryDist: booléen

Force fink à télécharger les paquets binaires pré-compilés à partir de la distribution binaire, s'ils sont disponibles et si les-dits paquets ne sont pas déjà installés sur votre système. Ceci permet de gagner beaucoup de temps à l'installation. Nous vous recommandons donc d'utiliser cette option. Le fait d'utiliser l'option --use-binary-dist avec fink (ou l'option -b) a le même effet, mais est restreint à cette invocation de fink. L'utilisation de l'option --no-use-binary-dist avec fink a l'effet inverse et est, de même, restreint à cette invocation de fink. Disponible à partir de la version 0.23.0 de fink.

Notez que, dans ce mode, fink télécharge la version requise d'un paquet, si cette version est la version disponible la plus récente du paquet, mais ne force pas fink à choisir la version en fonction de sa disponibilité binaire.

5.6 Configuration des miroirs

Il peut être pénible de télécharger des logiciels à partir d'Internet et les vitesses de téléchargement ne sont pas toujours ce qu'elles devraient être. Les serveurs miroirs hébergent des copies des fichiers disponibles sur d'autres serveurs ; ils ont parfois une connexion plus rapide à Internet que le serveur maître ou peuvent être plus proche géographiquement de votre lieu de téléchargement que le serveur principal ne l'est, ce qui vous donne la possibilité de télécharger les fichiers plus rapidement. Ils permettent également de réduire la charge des serveurs primaires, par exemple ftp.gnu.org, et ils assurent un accès aux fichiers lorsqu'un serveur n'est pas disponible.

Pour que Fink choisisse le serveur le plus adapté à votre cas, vous devez lui indiquer le continent et le pays dans lequel vous résidez. Si les téléchargements à partir d'un serveur échouent, il vous demandera si vous voulez réessayer à partir du même miroir, à partir d'un miroir différent dans le même pays ou sur le même continent, ou d'un autre miroir n'importe où dans le monde.

Le fichier fink.conf contient la liste des miroirs que vous désirez utiliser.

MirrorContinent: un code de trois lettres

Vous devez changer cette valeur à l'aide de la commande fink configure. Le code de trois lettres est l'un de ceux qui sont dans le fichier /opt/sw/lib/fink/mirror/_keys. Par exemple, si vous vivez en Europe :
```
MirrorContinent: eur
```
MirrorCountry: un code de six lettres

Vous devez changer cette valeur à l'aide de la commande fink configure. Le code de six lettres est composé du code de trois lettres du continent (voir ci-dessus), suivi d'un tiret, puis du code de deux lettres du pays. Vous le trouverez dans le fichier /opt/sw/lib/fink/mirror/_keys. Par exemple, si vous vivez en Autriche :
```
MirrorCountry: eur-AT
```
MirrorOrder: MasterFirst, MasterLast, MasterNever ou ClosestFirst

Fink gère des miroirs 'Maîtres', serveurs miroirs des archives tar du code source de tous les paquets Fink. L'utilisation d'un miroir maître a pour avantage que les URL de téléchargement du source ne sont jamais obsolètes. Les utilisateurs peuvent choisir d'utiliser ces miroirs maintenus par l'équipe Fink, ou de n'utiliser que les URL initiales du source et des miroirs externes tels les miroirs gnome, KDE ou debian. De plus, on peut combiner les deux jeux de miroirs ; la recherche aura lieu alors par ordre de proximité de la zone de téléchargement, comme cela a été expliqué ci-dessus. Avec les options MasterFirst et MasterLast, l'utilisateur va directement au jeu de miroirs maîtres (ou au jeu de miroirs non maîtres) si un téléchargement échoue. Les options sont les suivantes :
```
MasterFirst - Cherche d'abord dans les miroirs "Maîtres". 
MasterLast - Cherche dans les miroirs "Maîtres" à la fin. 
MasterNever - N'utilise jamais les miroirs "Maîtres". 
ClosestFirst - Cherche d'abord dans les miroirs les plus proches 
  (combine tous les miroirs en un seul jeu de miroirs). 
```
Mirror-rsync:

La valeur de ce champ représente l'url de type rsync à partir de laquelle la commande fink selfupdate synchronise les arbres quand le champ SelfupdateMethod a la valeur rsync. Ce doit être une url de type rsync anonyme qui pointe sur un répertoire contenant toutes les distributions et les arborescences de fink. Disponible à partir de la version 0.25.2 de fink.

5.7 Configuration Développeur

Certaines options du fichier fink.conf sont réservées aux développeurs. Nous déconseillons à l'utilisateur moyen de Fink de les modifier. Ce sont les options suivantes qui appartiennent à cette catégorie.

KeepRootDir: booléen

Empêche Fink de supprimer le sous-répertoire root-[nom]-[version]-[révision] du répertoire ChemindeConstruction (Buildpath) après construction d'un paquet. La valeur par défaut est False (faux). Attention, si la valeur de cette option est True (vrai), cela peut très vite saturer votre disque dur ! La commande fink -K a le même effet, restreint à cette invocation de fink.
KeepBuildDir: booléen

Empêche fink de supprimer le sous-répertoire [nom]-[version]-[révision] du répertoire ChemindeConstruction (Buildpath) après construction d'un paquet. La valeur par défaut est False (faux). Attention, si la valeur de cette option est True (vrai), cela peut très vite saturer votre disque dur ! La commande fink -k a le même effet, restreint à cette invocation de fink.

5.8 Variables pour les utilisateurs avertis

Il existe quelques autres options qui peuvent se révéler utiles, mais exigent un certain doigté à l'usage.

MatchPackageRegEx:

Empêche fink de demander quel paquet installer s'il existe une correspondance unique à l'un des choix résultant de l'expression régulière Perl fournie. Exemple :
```
MatchPackageRegEx: (.*-ssl$|^xfree86$|^xfree86-shlibs$)
```
correspond aux paquets dont le nom commencent par xfree86 ou xfree86-shlibs ou se terminent par '-ssl' ; il n'existe qu'une seule possibilité, fink installera xfree86 et xfree86-shlibs.
CCacheDir: chemin

Si le paquet ccache-default est installé, les fichiers cache qu'il génère lorsque des paquets Fink sont installés sont placés dans le répertoire indiqué en tant que valeur du champ. La valeur par défaut est /opt/sw/var/ccache. Quand la valeur du champ est none, fink ne définit pas la variable d'environnement CCACHE_DIR et ccache utilise $HOME/.ccache, ce qui peut le conduire à placer des fichiers dont le possesseur est le super-utilisateur dans votre répertoire utilisateur. Introduit dans une version de fink postérieure à la version 0.21.0.
NotifyPlugin: plugin

Indique un plugin de notification pour savoir quand des paquets sont installés ou désinstallés. Le plugin par défaut est Growl (nécessite Mac::Growl pour fonctionner). Vous trouverez d'autres plugins dans le répertoire /opt/sw/lib/perl5/Fink/Notify. À Partir de la version 0.25 de fink, la liste est donnée par l'exécution de la commande fink plugins. Voir Fink Developer Wiki pour de plus amples informations.
AutoScanpackages: valeur booléenne

Lors de la construction de nouveaux paquets via fink, apt-get n'est pas immédiatement informé de leur existence. Naguère, il fallait exécuter la commande fink scanpackages pour que apt-get s'aperçoive de leur présence. Maintenant, cette commande est exécuté automatiquement. Si cette option est présente et que sa valeur est false (faux), fink scanpackages n'est pas automatiquement exécuté après construction des paquets. La valeur par défaut est true (vrai).
ScanRestrictivePackages: valeur booléenne

Lors de l'inspection des paquets pour le compte de apt-get, fink inspecte par défaut tous les paquets des arborescences activées. Néanmoins, si l'arbre apt résultant est accessible au public, son administrateur peut être tenu par la loi de ne pas y inclure les paquets dont la licence est soit Restrictive, soit Commercial. Si cette option est présente et que sa valeur est false (faux), fink ne prend pas en compte ces paquets lors de l'inspection.

5.9 Gestion du fichier sources.list d'apt

À partir de la version 0.21.0, fink gère activement le fichier /opt/sw/etc/apt/sources.list, qui est utilisé par apt pour trouver l'emplacement des fichiers binaires à installer. Le fichier sources.list par "défaut" possède un contenu similaire à celui indiqué ci-dessous. Son contenu prend en compte la distribution et les branches dont vous vous servez.

# Local modifications should either go above this line, 
# or at the end. #
# Default APT sources configuration for Fink, written by the fink 
# program

# Local package trees - packages built from source locally
# NOTE: this is automatically kept in sync with the Trees: line in 
# /opt/sw/etc/fink.conf
# NOTE: run 'fink scanpackages' to update the corresponding 
# Packages.gz files
deb file:/opt/sw/fink local main
deb file:/opt/sw/fink stable main crypto

# Official binary distribution: download location for packages
# from the latest release
deb http://us.dl.sourceforge.net/fink/direct_download 10.3/release \
main crypto

# Official binary distribution: download location for updated
# packages built between releases
deb http://us.dl.sourceforge.net/fink/direct_download 10.3/current \
main crypto

# Put local modifications to this file below this line, or at the top.

Pour la bonne compréhension du fonctionnement de ce fichier, voici la traduction en français :

# Les modifications locales doivent se faire soit au-dessus de 
# cette ligne, soit tout-à-fait à la fin du fichier. #
# Configuration par défaut des sources APT pour Fink, générée par le 
# programme fink 

# Arborescence locale des paquets - paquets construits localement 
# à partir des sources
# NOTE : automatiquement synchronisée avec la ligne Trees du fichier
# /opt/sw/etc/fink.conf
# NOTE : exécutez 'fink scanpackages' pour mettre à jour les fichiers 
# Packages.gz correspondants
deb file:/opt/sw/fink local main
deb file:/opt/sw/fink stable main crypto

# Distribution binaire officielle : adresse de téléchargement des 
# paquets à partir de la dernière version
deb http://us.dl.sourceforge.net/fink/direct_download 10.3/release \
main crypto

# Distribution binaire officielle : adresse de téléchargement des 
# paquets mis à jour entre deux versions
deb http://us.dl.sourceforge.net/fink/direct_download 10.3/current \
main crypto

# Faites vos modifications en-dessous de cette ligne ou tout-à-fait 
# au début du fichier.

Avec ce fichier par défaut, apt-get cherche d'abord dans votre installation locale les binaires déjà compilés, puis recherche les autres dans la distribution binaire officielle. Vous pouvez modifier l'ordre de recherche en ajoutant des lignes en début de fichier (ce seront elles qui seront les plus prioritaires) ou à la fin du fichier (elles seront les moins prioritaires).

Si vous changez la ligne Trees ou la distribution que vous utilisez, fink modifie automatiquement la partie "par défaut" (similaire à celle ci-dessus) du fichier pour qu'elle corresponde aux nouvelles valeurs. Néanmoins Fink préserve toutes les modifications locales apportées au fichier, à condition que les changements soient situés au début (au-dessus de la première ligne par "défaut" ou à la fin du fichier (en dessous de la dernière ligne par défaut).

Note : si vous avez modifié /opt/sw/etc/apt/sources.list avant de passer à la version 0.21.0 de fink, votre ancien fichier sources.list sera sauvegardé sous /opt/sw/etc/apt/sources.list.finkbak .

Suite: 6. Utilisation de l'outil fink en ligne de commande