configure - Configure l'arborescence des sources

R�sum�

Vous devez appeler le script configure depuis le r�pertoire racine de la distribution.

./configure [OPTION]... [VARIABLE=VALEUR]...

Pour d�finir des variables d'environnement (par exemple CC,CFLAGS, etc...), utilisez la clause VARIABLE=VALEUR. Voir ci-dessous pour la description de quelques variables usuelles.

Options

• Options de Configuration
• R�pertoires d'installation
• Types de Syst�mes
• Fonctionnalit�s optionnelles
• Options pour les programmes support

Options de Configuration

Les options suivantes affectent le comportement du script configure.

-C

--config-cache

C'est un alias pour --cache-file=config.cache

--cache-file=FICHIER

Les r�sultats des tests seront mis en cache dans le fichier FICHIER. Cette option est d�sactiv�e par d�faut.

-h

--help [short|recursive]

Affichage de l'aide et sortie du script. Avec l'argument short, seules les options sp�cifiques � ce paquet seront affich�es. L'argument recursive permet d'afficher l'aide de tous les paquets inclus.

-n

--no-create

Le script configure s'ex�cute normalement, mais ne cr�e pas les fichiers r�sultants. Ceci permet de v�rifier les r�sultats des tests avant de g�n�rer les fichiers makefile pour la compilation.

-q

--quiet

Les messages checking ... ne sont pas affich�s au cours du processus de configuration.

--srcdir=DIR

D�finit le r�pertoire DIR comme r�pertoire des fichiers sources. Par d�faut, c'est le r�pertoire o� se situe le script configure, ou le r�pertoire parent.

--silent

Identique � --quiet

-V

--version

Affichage des informations de copyright et sortie du script.

R�pertoires d'installation

Ces options permettent de sp�cifier le r�pertoire d'installation. L'arborescence de l'installation d�pend de l'organisation (layout) s�lectionn�e.

--prefix=PREFIX

Installe les fichiers ind�pendants de l'architecture dans PREFIX. Par d�faut, le r�pertoire d'installation est /usr/local/apache2.

--exec-prefix=EPREFIX

Installe les fichiers d�pendants de l'architecture dans EPREFIX. La valeur par d�faut de cette option correspond � la valeur d�finie par l'option --prefix.

Par d�faut, make install va installer tous les fichiers dans /usr/local/apache2/bin, /usr/local/apache2/lib, etc... Vous pouvez cependant sp�cifier un pr�fixe d'installation autre que /usr/local/apache2 en utilisant l'option --prefix (par exemple --prefix=$HOME).

Sp�cifier une organisation (layout) des r�pertoires

--enable-layout=LAYOUT

Configure le code source et les scripts de compilation de fa�on � ce que l'arborescence d'installation adopte l'organisation LAYOUT. Ceci vous permet de sp�cifier des chemins s�par�s pour chaque type de fichier de l'installation du serveur HTTP Apache. Le fichier config.layout contient de nombreux exemples de configurations, et vous pouvez cr�er vos propres configurations personnalis�es en vous basant sur ces exemples. Les diff�rentes organisations contenues dans ce fichier sont enregistr�es sous forme de sections <Layout FOO>...</Layout> et r�f�renc�es dans ce cas par le nom FOO. L'organisation par d�faut est Apache.

Configuration avanc�e des r�pertoires d'installation

Pour une d�finition plus pr�cise des r�pertoires d'installation, utilisez les options ci-dessous. Notez que les r�pertoires par d�faut sont d�finis par autoconf, et que leurs valeurs sont �cras�es par les valeurs correspondantes d�finies lors du choix de l'organisation des r�pertoires (layout).

--bindir=DIR

Installe les ex�cutables utilisateur dans DIR. Les ex�cutables utilisateur sont des programmes support comme htpasswd, dbmmanage, etc..., et destin�s aux administrateurs du site. Par d�faut, DIR est d�fini � EPREFIX/bin.

--datadir=DIR

Installe les donn�es non modifiables ind�pendantes de l'architecture dans DIR. Par d�faut, datadir est d�fini � PREFIX/share. Cette option est fournie par autoconf et actuellement inutilis�e.

--includedir=DIR

Installe les fichiers d'en-t�tes C dans DIR. Par d�faut, includedir est d�fini � EPREFIX/include.

--infodir=DIR

Installe la documentation info dans DIR. Par d�faut, infodir est d�fini � PREFIX/info. Cette option est actuellement inutilis�e.

--libdir=DIR

Installe les fichiers objet des biblioth�ques dans DIR. Par d�faut, libdir est d�fini � EPREFIX/lib.

--libexecdir=DIR

Installe les ex�cutables du programme (autrement dit les modules partag�s) dans DIR. Par d�faut, libexecdir est d�fini � EPREFIX/modules.

--localstatedir=DIR

Installe les donn�es temporaires modifiables sp�cifiques � la machine dans DIR. Par d�faut, localstatedir est d�fini � PREFIX/var. Cette option est fournie par autoconf et est actuellement inutilis�e.

--mandir=DIR

Installe les pages de manuel dans DIR. Par d�faut, mandir est d�fini � EPREFIX/man.

--oldincludedir=DIR

Installe les fichiers d'en-t�tes C pour les programmes autres que gcc dans DIR. Par d�faut, oldincludedir est d�fini � /usr/include. Cette option est fournie par autoconf et est actuellement inutilis�e.

--sbindir=DIR

Installe les ex�cutables de l'administrateur syst�me dans DIR. Ce sont les programmes du serveur comme httpd, apache2ctl, suexec, etc..., qui sont n�cessaires � l'ex�cution du serveur HTTP Apache. Par d�faut, sbindir est d�fini � EPREFIX/sbin.

--sharedstatedir=DIR

Installe les donn�es modifiables ind�pendantes de l'architecture dans DIR. Par d�faut, sharedstatedir est d�fini � PREFIX/com. Cette option est fournie par autoconf et est actuellement inutilis�e.

--sysconfdir=DIR

Installe les donn�es non modifiables sp�cifiques � la machine comme les fichiers de configuration du serveur apache2.conf, mime.types, etc... dans DIR. Par d�faut, sysconfdir est d�fini � PREFIX/conf.

Types de syst�mes

Ces options sont utilis�es pour la compilation crois�e du serveur HTTP Apache afin de pouvoir l'utiliser sur une autre plateforme mat�rielle. Dans le cas g�n�ral o� la compilation et l'ex�cution du serveur ont lieu sur le m�me syst�me, ces options ne sont pas utilis�es.

--build=BUILD

D�finit le type du syst�me sur lequel les outils sont compil�s. Par d�faut, il s'agit de la cha�ne renvoy�e par le script config.guess.

--host=HOST

D�finit le type du syst�me sur lequel le serveur s'ex�cutera. Par d�faut, HOST est identique � BUILD.

--target=TARGET

Configure les compilateurs de build pour le type de syst�me TARGET. Par d�faut, TARGET est identique � HOST. Cette option est fournie par autoconf et n'est pas requise par le serveur HTTP Apache.

Fonctionnalit�s optionnelles

Ces options vous permettent de configurer avec pr�cision les fonctionnalit�s de votre futur serveur HTTP.

Syntaxe g�n�rale

D'une mani�re g�n�rale, vous pouvez utiliser la syntaxe suivante pour activer ou d�sactiver une fonctionnalit� :

--disable-FONCTIONNALITE

D�sactive la fonctionnalit� FONCTIONNALITE. Identique � --enable-FONCTIONNALITE=no.

--enable-FONCTIONNALITE[=ARG]

Active la fonctionnalit� FONCTIONNALITE. La valeur par d�faut de ARG est yes.

--enable-MODULE=shared

Le module sp�cifi� sera compil� en tant que module DSO. Par d�faut, les modules activ�s sont li�s dynamiquement.

--enable-MODULE=static

Le module correspondant sera li� statiquement.

Choix des modules � compiler

La plupart des modules sont compil�s par d�faut et ils doivent �tre d�sactiv�s de mani�re explicite ou via les mots-cl�s few ou none (voir ci-dessous --enable-modules, --enable-mods-shared et --enable-mods-static pour une explication plus d�taill�e).

Par d�faut, les autres modules ne sont pas compil�s et doivent �tre activ�s explicitement, ou en utilisant les mots-cl�s all ou reallyall pour �tre disponibles.

Pour d�terminer quels modules sont compil�s par d�faut, ex�cutez la commande ./configure -h ou ./configure --help, et consultez les Optional Features. Par exemple, supposons que vous soyez int�ress� par les modules mod_example1 et mod_example2, et que vous voyiez ceci :

Optional Features:
  ...
  --disable-example1     example module 1
  --enable-example2      example module 2
  ...

Le module mod_example1 est ici activ� par d�faut, et vous devez sp�cifier --disable-example1 si vous ne voulez pas le compiler. Par contre, le module mod_example2 est d�sactiv� par d�faut, et vous devez sp�cifier --enable-example2 si vous voulez le compiler.

Modules Multi-Processus

Les Modules Multi-Processus, ou MPMs, constituent le coeur du serveur. Un et un seul MPM doit �tre actif pour que le serveur puisse fonctionner. Vous trouverez la liste des MPMs disponibles � la page d'index des modules.

Les MPMs peuvent �tre compil�s en tant que modules DSO pour un chargement dynamique, ou li�s statiquement avec le serveur, et sont activ�s via les options suivantes :

--with-mpm=MPM

S�lectionne le MPM par d�faut pour votre serveur. Si les MPMs sont compil�s en tant que modules DSO (voir --enable-mpms-shared), cette option sp�cifie le MPM qui sera charg� par d�faut selon le fichier de configuration. Dans le cas contraire, cette option sp�cifie le seul MPM disponible qui sera li� statiquement avec le serveur.

Si cette option est omise, c'est le MPM par d�faut pour votre syst�me d'exploitation qui sera utilis�.

--enable-mpms-shared=Liste de MPM

D�finit une liste de MPMs � compiler en tant que modules dynamiquement partag�s (DSO). Un de ces modules doit �tre charg� dynamiquement via la directive LoadModule.

Liste de MPM est une liste, entour�e d'apostrophes, de noms de MPM s�par�s par des espaces. Par exemple :

--enable-mpms-shared='prefork worker'

Vous pouvez aussi utiliser le mot-cl� all, ce qui aura pour effet de sp�cifier tous les MPMs qui supportent le chargement dynamique sur la plate-forme consid�r�e, et de les compiler en tant que modules DSO. Par exemple :

--enable-mpms-shared=all

Modules tiers

Pour ajouter des modules tiers, utilisez les options suivantes :

--with-module=type-module:fichier-module[, type-module:fichier-module]

Ajoute un ou plusieurs modules tiers � la liste des modules li�s statiquement. Le fichier source du module fichier-module sera recherch� dans le sous-r�pertoire type-module de l'arborescence des sources de votre serveur HTTP Apache. S'il ne l'y trouve pas, configure consid�rera fichier-module comme un chemin de fichier absolu et essaiera de copier le fichier source dans le sous-r�pertoire type-module. Si ce sous-r�pertoire n'existe pas, il sera cr�� et un fichier Makefile.in standard y sera enregistr�.

Cette option est con�ue pour ajouter de petits modules externes ne comportant qu'un seul fichier source. Pour des modules plus complexes, vous devrez lire la documentation du fournisseur du module.

Note

Si vous voulez compiler un module DSO (li� de mani�re dynamique au lieu de statique), utilisez le programme apxs.

Options cumulatives et autres options

--enable-maintainer-mode

Active les avertissements de d�bogage et de compilation et charge tous les modules compil�s.

--enable-mods-shared=LISTE-MODULES

D�finit une liste de modules � activer et � compiler en tant que modules dynamiques partag�s. Cela signifie que ces modules doivent �tre charg�s dynamiquement en utilisant la directive LoadModule.

LISTE-MODULES est une liste, entour�e d'apostrophes, de noms de modules s�par�s par des espaces. Les noms des modules sont sp�cifi�s sans le pr�fixe mod_. Par exemple :

--enable-mods-shared='headers rewrite dav'

Vous pouvez aussi utiliser les mots-cl�s reallyall, all, most, few et none. Par exemple,

--enable-mods-shared=most

va compiler la plupart des modules en tant que modules DSO,

--enable-mods-shared=few

ne compilera qu'un jeu de modules de base.

Le jeu par d�faut correspond au mot-cl� most.

Les directives LoadModule correspondant aux diff�rents modules choisis sont automatiquement g�n�r�es dans le fichier de configuration principal. Par d�faut, toutes ces directives sont mises en commentaire, sauf pour les modules requis ou ceux explicitement s�lectionn�s par un argument --enable-nom-module du script configure. Vous pouvez modifier le jeu de modules charg� en activant ou d�sactivant les directives LoadModule dans le fichier apache2.conf. En outre, les directives LoadModule peuvent �tre activ�es pour tous les modules compil�s via l'option --enable-load-all-modules du script configure.

Avertissement : --enable-mods-shared=all ne compile pas vraiment tous les modules. En fait, pour compiler tous les modules, il faut utiliser :

./configure \
--with-ldap \
--enable-mods-shared="all ssl ldap cache proxy authn_alias file_cache authnz_ldap charset_lite dav_lock disk_cache"

--enable-mods-static=MODULE-LIST

Cette option produit le m�me effet que l'option --enable-mods-shared, � l'exception que les modules seront li�s statiquement. Cela signifie que les modules sp�cifi�s seront toujours disponibles au cours du fonctionnement de httpd. Ils n'ont pas besoin d'�tre charg�s via la directive LoadModule.

--enable-modules=MODULE-LIST

Cette option se comporte comme --enable-mods-shared, et va �galement lier les modules concern�s dynamiquement. Le mot-cl� sp�cial none d�sactive la compilation de tous les modules.

--enable-v4-mapped

Permet aux sockets IPv6 de traiter les connexions IPv4.

--with-port=PORT

Permet de d�finir le port TCP sur lequel le programme httpd va �couter. Ce num�ro de port est utilis� lors de la g�n�ration du fichier de configuration apache2.conf. Sa valeur par d�faut est 80.

--with-program-name

Permet de d�finir un nom d'ex�cutable alternatif. Le nom par d�faut est httpd.

Paquets optionnels

Ces options permettent de d�finir des paquets optionnels.

Syntaxe g�n�rale

D'une mani�re g�n�rale, vous pouvez utiliser la syntaxe suivante pour d�finir un paquet optionnel :

--with-PAQUET[=ARG]

Utilise le paquet PAQUET. La valeur par d�faut de ARG est yes.

--without-PAQUET

N'utilise pas le paquet PAQUET. Cette option est identique � --with-PAQUET=no. Elle est fournie par autoconf mais n'est pas tr�s utile pour le serveur HTTP Apache.

Paquets sp�cifiques

--with-apr=REP|FICHIER

La Biblioth�que pour la portabilit� d'Apache ou Apache Portable Runtime (APR) fait partie de la distribution des sources de httpd et est compil�e automatiquement avec le serveur HTTP. Si vous voulez utiliser une APR d�j� install�e � la place, vous devez indiquer � configure le chemin du script apr-config. Vous pouvez sp�cifier le chemin absolu et le nom ou le r�pertoire d'installation de l'APR. apr-config doit se trouver dans ce r�pertoire ou dans le sous-repertoire bin.

--with-apr-util=REP|FICHIER

Les utilitaires pour la Biblioth�que pour la portabilit� d'Apache ou Apache Portable Runtime Utilities (APU) font partie de la distribution des sources de httpd et sont compil�s automatiquement avec le serveur HTTP. Si vous voulez utiliser des APU d�j� install�s � la place, vous devez indiquer � configure le chemin du script apu-config. Vous pouvez sp�cifier le chemin absolu et le nom ou le r�pertoire d'installation des APU. apu-config doit se trouver dans ce r�pertoire ou dans le sous-repertoire bin.

--with-ssl=REP

Si mod_ssl a �t� activ�, configure recherche une installation d'OpenSSL. Vous pouvez d�finir le r�pertoire de la bo�te � outils SSL/TLS � la place.

--with-z=REP

configure recherche automatiquement une biblioth�que zlib install�e si la configuration de vos sources en n�cessite une (par exemple lorsque mod_deflate est activ�). Vous pouvez d�finir le r�pertoire de la biblioth�que de compression � la place.

De nombreuses fonctionnalit�s du serveur HTTP Apache, y compris les directives RewriteMap DBM de mod_rewrite et mod_authn_dbm utilisent une base de donn�es simple de la forme cl�/valeur pour une recherche rapide d'informations. SDBM, inclus dans les APU, est donc toujours disponible. Si vous souhaitez utiliser d'autres types de bases de donn�es, utilisez les options suivantes afin de les activer :

--with-gdbm[=chemin]

Si aucun chemin n'est sp�cifi�, configure va rechercher les fichiers d'en-t�tes et les biblioth�ques d'une installation DBM GNU dans les chemins standards. Avec un chemin explicite, configure recherchera les fichiers concern�s dans chemin/lib et chemin/include. En fait, chemin permet de sp�cifier plusieurs chemins d'en-t�tes et biblioth�ques sp�cifiques en les s�parant par des caract�res ':'.

--with-ndbm[=chemin]

Identique � --with-gdbm, mais recherche une installation de New DBM.

--with-berkeley-db[=chemin]

Identique � --with-gdbm, mais recherche une installation de Berkeley DB.

Options pour les programmes de support

--enable-static-support

Permet de compiler une version des binaires de support li�s statiquement. En d'autres termes, la compilation produira un ex�cutable ind�pendant comportant toutes les biblioth�ques n�cessaires. Sans cette option, les binaires de supports sont li�s dynamiquement.

--enable-suexec

Utilisez cette option pour activer la programme suexec, qui vous permet de d�finir un uid et un gid pour les processus lanc�s. N'utilisez cette option que si vous ma�trisez toutes les implications en mati�re de s�curit� de l'ex�cution d'un binaire suid sur votre serveur. D'autres options permettent de configurer suexec comme d�crit ci-dessous.

Il est possible de lier statiquement le binaire d'un programme support particulier en utilisant les options suivantes :

--enable-static-ab

Compile une version li�e statiquement du programme ab.

--enable-static-checkgid

>Compile une version li�e statiquement du programme checkgid.

--enable-static-htdbm

Compile une version li�e statiquement du programme htdbm.

--enable-static-htdigest

Compile une version li�e statiquement du programme htdigest.

--enable-static-htpasswd

Compile une version li�e statiquement du programme htpasswd.

--enable-static-logresolve

Compile une version li�e statiquement du programme logresolve.

--enable-static-rotatelogs

Compile une version li�e statiquement du programme rotatelogs.

Options de configuration de suexec

Les options suivantes permettent de d�finir avec pr�cision le comportement du programme suexec. Voir Configurer et installer suEXEC pour plus de d�tails.

--with-suexec-bin

D�finit le chemin du binaire suexec. La valeur par d�faut est --sbindir (voir D�finition pr�cise des r�pertoires d'installation).

--with-suexec-caller

D�finit l'utilisateur qui a l'autorisation d'appeler suexec. Il est en g�n�ral souhaitable que ce soit le m�me que celui sous lequel httpd s'ex�cute.

--with-suexec-docroot

D�finit l'arborescence des r�pertoires dans laquelle le lancement des ex�cutables via suexec est autoris�. La valeur par d�faut est --datadir/htdocs.

--with-suexec-gidmin

D�finit la valeur de GID la plus basse autoris�e comme valeur cible pour suexec. La valeur par d�faut est 100.

--with-suexec-logfile

D�finit le nom du fichier journal de suexec. La valeur par d�faut est --logfiledir/suexec_log.

--with-suexec-safepath

D�finit la valeur de la variable d'environnement PATH pour les processus lanc�s par suexec. La valeur par d�faut est /usr/local/bin:/usr/bin:/bin.

--with-suexec-userdir

D�finit le sous-r�pertoire du r�pertoire utilisateur qui contient tous les ex�cutables pouvant �tre lanc�s par suexec. Cette option est n�cessaire si vous souhaitez utiliser suexec avec des r�pertoires utilisateurs (d�finis via mod_userdir). La valeur par d�faut est public_html.

--with-suexec-uidmin

D�finit la valeur d'UID la plus basse autoris�e comme valeur cible pour suexec. La valeur par d�faut est 100.

--with-suexec-umask

D�finit le masque de permissions umask pour les processus lanc�s par suexec. Il correspond par d�faut au masque d�fini par la configuration de votre syst�me.

Variables d'environnement

Certaines variables d'environnement permettent de modifier les choix effectu�s par configure, ou d'aider ce dernier � trouver les biblioth�ques et programmes poss�dant des noms et chemins non standards.

CC

D�finit la commande du compilateur C � utiliser pour la compilation.

CFLAGS

D�finit les param�tres du compilateur C que vous voulez utiliser pour la compilation.

CPP

D�finit la commande du pr�processeur C � utiliser.

CPPFLAGS

D�finit les param�tres du pr�processeur C/C++, par exemple -Ir�pertoire-include, si certains de vos fichiers d'en-t�tes se trouvent dans le r�pertoire non standard r�pertoire-include.

LDFLAGS

D�finit les param�tres de l'�diteur de liens, par exemple -Lr�pertoire-lib, si certaines de vos biblioth�ques se trouvent dans le r�pertoire non standard r�pertoire-lib.