3. Configuration

3.1.1. Principe

autoconf permet de configurer correctement un logiciel. Il crée les fichiers nécessaires à la compilation (Makefile par exemple), et modifie parfois directement les sources (par exemple par le biais d'un fichier config.in).

Le principe d'autoconf est simple :

• l'auteur du logiciel sait quels tests sont nécessaires pour configurer son logiciel (ex: "quelle version de cette librairie utilise tu ?"). Il les écrit dans un fichier nommé configure.in, en suivant une syntaxe précise.

• il exécute autoconf. Ce dernier génère à partir du fichier configure.in un script de configuration appelé configure. Ce script est celui qui effectuera les tests nécessaires à la configuration du programme.

• l'utilisateur final exécute ce script, et autoconf se charge de configurer tout ce qui est nécessaire à la compilation.

3.1.2. Exemple

Un exemple d'utilisation d'autoconf :

$ ./configure
loading cache ./config.cache
checking for gcc... gcc
checking whether the C compiler (gcc  ) works... yes
checking whether the C compiler (gcc  ) is a cross-compiler... no
checking whether we are using GNU C... yes
checking whether gcc accepts -g... yes
checking for main in -lX11... yes
checking for main in -lXpm... yes
checking for main in -lguile... yes
checking for main in -lm... yes
checking for main in -lncurses... yes
checking how to run the C preprocessor... gcc -E
checking for X... libraries /usr/X11R6/lib, headers /usr/X11R6/include
checking for ANSI C header files... yes
checking for unistd.h... yes
checking for working const... yes
updating cache ./config.cache
creating ./config.status
creating lib/Makefile
creating src/Makefile
creating Makefile

Si on veut avoir un peu plus de contrôle sur ce que génère configure, on peut lui passer des options via la ligne de commande ou des variables d'environnement. Exemple :

./configure --with-gcc --prefix=/opt/GNU

ou encore (sous bash) :

export CC=`which gcc`
export CFLAGS=-O2
./configure --with-gcc

3.1.3. Et si... ça ne marche pas ?

Typiquement, il s'agit d'une erreur de type "configure: error: Cannot find library guile" (95% des erreurs du script configure).

Clairement, le script configure n'a pas réussi à trouver une librairie (dans notre exemple, la librairie guile). Le principe est que le script configure compile un petit programme de test qui utilise cette librairie. S'il n'arrive pas à compiler ce programme, c'est qu'il n'arrivera pas à compiler le logiciel. D'où une erreur.

1. Regardez d'où vient l'erreur rencontrée en regardant la fin du fichier config.log, qui contient une trace de toutes les étapes de la configuration. Le compilateur C est généralement assez explicite dans ses messages d'erreur. Cela vous aidera pour résoudre le problème.

2. Vérifiez que la librairie en question est bien installée. Si ce n'est pas le cas, installez-la (à partir des sources ou d'un binaire précompilé) et exécutez à nouveau configure. Une méthode efficace pour le vérifier est de rechercher le fichier matérialisant la librairie, qui est invariablement libnom.so. Par exemple,

   $ find / -name libguile*

   ou encore :

   $ locate libguile

3. Vérifiez qu'elle est accessible au compilateur. C'est à dire que la librairie est bien située dans un répertoire parmi : /usr/lib, /lib, /usr/X11R6/lib (ou parmi ceux spécifiés par la la variable d'environnement LD_LIBRARY_PATH, voir la partie LD_LIBRARY_PATH de la section Et si ça ne fonctionne pas  ?"). Vérifiez que ce fichier est bien une librairie en faisant un "file libguile.so".

4. Vérifiez que les fichiers d'en-tête correspondant à la librairie sont bien installés à la bonne place (généralement /usr/include ou /usr/local/include ou /usr/X11R6/include. Si vous ne savez pas de quels fichiers d'en-tête vous avez besoin, vérifiez que vous avez bien installé la version de développement de la librairie nécessaire (par exemple, sous Debian GNU/Linux : libgtk-dev au lieu de libgtk). La version de développement de la bibliothèque est livrée avec les fichiers include nécessaires à la compilation d'un logiciel utilisant cette librairie.

5. Vérifiez que vous avez assez de place disque (le script configure a besoin d'un peu de place pour des fichiers temporaires). Utilisez df -k pour visualiser les partitions de votre système, et ne vous préoccupez que des partitions pleines ou presque.

Si vous ne comprenez pas le message d'erreur stocké dans le fichier config.log, n'hésitez pas à demander aide et assistance à la communauté du logiciel libre (voir la section Support technique).

De plus, méfiez vous si configure répond 100% de No ou s'il répond No alors que vous êtes certain qu'une bibliothèque existe (par exemple il serait très étrange qu'il n'existe pas au moins une librairie curses !). Dans ce cas, on est probablement en présence d'une variable LD_LIBRARY_PATH mal positionnée !