granicus.if.org Git - apache/blob - docs/manual/programs/configure.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>configure - Configure the source tree - Apache HTTP Server</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body id="manual-page"><div id="page-header">
  14 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  15 <p class="apache">Apache HTTP Server Version 2.1</p>
  16 <img alt="" src="../images/feather.gif" /></div>
  17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  18 <div id="path">
  19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>configure - Configure the source tree</h1>
  20 <div class="toplang">
  21 <p><span>Available Languages: </span><a href="../en/programs/configure.html" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  23 </div>
  24
  25     <p>The <code>configure</code> script configures the source tree
  26     for compiling and installing the Apache HTTP Server on your
  27     particular platform. Various options allow the compilation of a
  28     server corresponding to your personal requirements.</p>
  29
  30     <p>This script, included in the root directory of the source
  31     distribution, is for compilation on Unix and Unix-like systems
  32     only. For other platforms, see the <a href="../platform/">platform</a> documentation.</p>
  33 </div>
  34 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
  35 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
  36 <li><img alt="" src="../images/down.gif" /> <a href="#env">Environment variables</a></li>
  37 </ul><h3>See also</h3><ul class="seealso"><li><a href="../install.html">Compiling and Installing</a></li></ul></div>
  38 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  39 <div class="section">
  40 <h2><a name="synopsis" id="synopsis">Synopsis</a></h2>
  41     <p>You should call the <code>configure</code> script from within the
  42     root directory of the distribution.</p>
  43
  44     <p><code><strong>./configure</strong> [<var>OPTION</var>]...
  45     [<var>VAR</var>=<var>VALUE</var>]...</code></p>
  46
  47     <p>To assign environment variables (e.g. <code>CC</code>,
  48     <code>CFLAGS</code> ...), specify them as
  49     <code><var>VAR</var>=<var>VALUE</var></code>. See <a href="#env">below</a>
  50     for descriptions of some of the useful variables.</p>
  51 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  52 <div class="section">
  53 <h2><a name="options" id="options">Options</a></h2>
  54   <ul>
  55     <li><a href="#configurationoptions">Configuration options</a></li>
  56     <li><a href="#installationdirectories">Installation directories</a></li>
  57     <li><a href="#systemtypes">System types</a></li>
  58     <li><a href="#optionalfeatures">Optional features</a></li>
  59     <li><a href="#supportopt">Options for support programs</a></li>
  60   </ul>
  61
  62   <h3><a name="configurationoptions" id="configurationoptions">Configuration options</a></h3>
  63
  64     <p>The following options influence the behavior of
  65     <code>configure</code> itself.</p>
  66
  67     <dl>
  68       <dt><code>-C</code></dt>
  69       <dt><code>--config-cache</code></dt>
  70       <dd>This is an alias for <code>--cache-file=config.cache</code></dd>
  71
  72       <dt><code>--cache-file=<var>FILE</var></code></dt>
  73       <dd>The test results will be cached in file <var>FILE</var>.
  74         This option is disabled by default.</dd>
  75
  76       <dt><code>-h</code></dt>
  77       <dt><code>--help [short|recursive]</code></dt>
  78       <dd>Output the help and exit. With the argument <code>short</code> only
  79         options specific to this package will displayed. The argument
  80         <code>recursive</code> displays the short help of all the included
  81         packages.</dd>
  82
  83       <dt><code>-n</code></dt>
  84       <dt><code>--no-create</code></dt>
  85       <dd>The <code>configure</code> script is run normally but does
  86         not create output files. This is useful to check the test results
  87         before generating makefiles for compilation.</dd>
  88
  89       <dt><code>-q</code></dt>
  90       <dt><code>--quiet</code></dt>
  91       <dd>Do not print <code>checking ...</code> messages during the
  92         configure process.</dd>
  93
  94       <dt><code>--srcdir=<var>DIR</var></code></dt>
  95       <dd>Defines directory <var>DIR</var> to be the source file directory.
  96         Default is the directory, where configure is located, or the parent
  97         directory <code>..</code>.</dd>
  98
  99       <dt><code>--silent</code></dt>
 100       <dd>Same as <code>--quiet</code></dd>
 101
 102       <dt>-V</dt>
 103       <dt>--version</dt>
 104       <dd>Display copyright information and exit.</dd>
 105     </dl>
 106
 107
 108   <h3><a name="installationdirectories" id="installationdirectories">Installation
 109     directories</a></h3>
 110
 111     <p>These options define the installation directory. The installation
 112       tree depends on the selected layout.</p>
 113
 114     <dl>
 115       <dt><code>--prefix=<var>PREFIX</var></code></dt>
 116       <dd>Install architecture-independent files in <var>PREFIX</var>.
 117         By default the installation directory is set to
 118         <code>/usr/local/apache2</code>.</dd>
 119
 120       <dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
 121       <dd>Install architecture-dependent files in <var>EPREFIX</var>.
 122         By default the installation directory is set to the
 123         <var>PREFIX</var> directory.</dd>
 124     </dl>
 125
 126     <p>By default, <code>make install</code> will install all the files in
 127       <code>/usr/local/apache2/bin</code>, <code>/usr/local/apache2/lib</code>
 128       etc. You can specify an installation prefix other than
 129       <code>/usr/local/apache2</code> using <code>--prefix</code>,
 130       for instance <code>--prefix=$HOME</code>.</p>
 131
 132     <h4><a name="layout" id="layout">Define a directory layout</a></h4>
 133       <dl>
 134         <dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
 135         <dd>Configure the source code and build scripts to assume an
 136           installation tree based on the layout <var>LAYOUT</var>. This allows
 137           you to separately specify the locations for each type of file within
 138           the Apache HTTP Server installation. The <code>config.layout</code>
 139           file contains several example configurations, and you can also create
 140           your own custom configuration following the examples. The different
 141           layouts in this file are grouped into <code>&lt;Layout
 142             FOO&gt;...&lt;/Layout&gt;</code> sections and referred to by name as
 143           in <code>FOO</code>. The default layout is <code>Apache</code>.</dd>
 144       </dl>
 145
 146
 147     <h4><a name="directoryfinetuning" id="directoryfinetuning">Fine tuning of the installation
 148       directories</a></h4>
 149
 150       <p>For better control of the installation directories, use the options
 151         below. Please note that the directory defaults are set by
 152         <code>autoconf</code> and be overwritten by the corresponding layout
 153         setting.</p>
 154
 155       <dl>
 156
 157         <dt><code>--bindir=<var>DIR</var></code></dt>
 158         <dd>Install user executables in <var>DIR</var>. The user executables
 159           are supporting programs like <code>htpasswd</code>,
 160           <code>dbmmanage</code>, etc. which are useful for site
 161           administrators. By default <var>DIR</var> is set to
 162           <code><var>EPREFIX</var>/bin</code>.</dd>
 163
 164         <dt><code>--datadir=<var>DIR</var></code></dt>
 165         <dd>Install read-only architecture-independent data in <var>DIR</var>.
 166           By default <code>datadir</code> is set to
 167           <code><var>PREFIX</var>/share</code>. This option is offered by
 168           <code>autoconf</code> and currently unused.</dd>
 169
 170         <dt><code>--includedir=<var>DIR</var></code></dt>
 171         <dd>Install C header files in <var>DIR</var>. By default
 172           <code>includedir</code> is set to
 173           <code><var>EPREFIX</var>/include</code>.</dd>
 174
 175         <dt><code>--infodir=<var>DIR</var></code></dt>
 176         <dd>Install info documentation in <var>DIR</var>.
 177           By default <code>infodir</code> is set to
 178           <code><var>PREFIX</var>/info</code>. This option is currently
 179           unused.</dd>
 180
 181         <dt><code>--libdir=<var>DIR</var></code></dt>
 182         <dd>Install object code libraries in <var>DIR</var>. By default
 183           <code>libdir</code> is set to
 184           <code><var>EPREFIX</var>/lib</code>.</dd>
 185
 186         <dt><code>--libexecdir=<var>DIR</var></code></dt>
 187         <dd>Install the program executables (i.e., shared modules) in
 188           <var>DIR</var>. By default <code>libexecdir</code> is set to
 189           <code><var>EPREFIX</var>/libexec</code>.</dd>
 190
 191         <dt><code>--localstatedir=<var>DIR</var></code></dt>
 192         <dd>Install modifiable single-machine data in <var>DIR</var>.
 193           By default <code>localstatedir</code> is set to
 194           <code><var>PREFIX</var>/var</code>. This option is offered by
 195           <code>autoconf</code> and currently unused.</dd>
 196
 197         <dt><code>--mandir=<var>DIR</var></code></dt>
 198         <dd>Install the man documentation in <var>DIR</var>. By default
 199           <code>mandir</code> is set to
 200           <code><var>EPREFIX</var>/man</code>.</dd>
 201
 202         <dt><code>--oldincludedir=<var>DIR</var></code></dt>
 203         <dd>Install C header files for non-gcc in <var>DIR</var>.
 204           By default <code>oldincludedir</code> is set to
 205           <code>/usr/include</code>. This option is offered by
 206           <code>autoconf</code> and currently unused.</dd>
 207
 208         <dt><code>--sbindir=<var>DIR</var></code></dt>
 209         <dd>Install the system administrator executables in <var>DIR</var>.
 210           Those are server programs like <code>httpd</code>,
 211           <code>apachectl</code>, <code>suexec</code>, etc. which are neccessary
 212           to run the Apache HTTP Server. By default <code>sbindir</code> is
 213           set to <code><var>EPREFIX</var>/sbin</code>.</dd>
 214
 215         <dt><code>--sharedstatedir=<var>DIR</var></code></dt>
 216         <dd>Install modifiable architecture-independent data in <var>DIR</var>.
 217           By default <code>sharedstatedir</code> is set to
 218           <code><var>PREFIX</var>/com</code>. This option is offered by
 219           <code>autoconf</code> and currently unused.</dd>
 220
 221         <dt><code>--sysconfdir=<var>DIR</var></code></dt>
 222         <dd>Install read-only single-machine data like the server configuration
 223           files <code>httpd.conf</code>, <code>mime.types</code>, etc. in
 224           <var>DIR</var>. By default <code>sysconfdir</code> is set to
 225           <code><var>PREFIX</var>/etc</code>.</dd>
 226       </dl>
 227
 228
 229
 230   <h3><a name="systemtypes" id="systemtypes">System types</a></h3>
 231
 232     <p>These options are used to cross-compile the Apache HTTP Server to run on
 233       another system. In normal cases, when building and running the server on
 234       the same system, these options are not used.</p>
 235
 236     <dl>
 237       <dt><code>--build=<var>BUILD</var></code></dt>
 238       <dd>Defines the system type of the system on which the tools are being
 239         built. It defaults to the result of the script
 240         <code>config.guess</code>.</dd>
 241
 242       <dt><code>--host=<var>HOST</var></code></dt>
 243       <dd>Defines the system type of the system on which the server will run.
 244         <var>HOST</var> defaults to <var>BUILD</var>.</dd>
 245
 246       <dt><code>--target=<var>TARGET</var></code></dt>
 247       <dd>Configure for building compilers for the system type
 248         <var>TARGET</var>. It defaults to <var>HOST</var>. This option is
 249         offered by <code>autoconf</code> and not necessary for the Apache HTTP
 250         Server.</dd>
 251     </dl>
 252
 253
 254   <h3><a name="optionalfeatures" id="optionalfeatures">Optional Features</a></h3>
 255
 256     <p>These options are used to fine tune the features your HTTP server will
 257       have.</p>
 258
 259     <h4><a name="generaloptfeat" id="generaloptfeat">General syntax</a></h4>
 260       <p>Generally you can use the following syntax to enable or disable a
 261         feature:</p>
 262
 263       <dl>
 264         <dt><code>--disable-<var>FEATURE</var></code></dt>
 265         <dd>Do not include <var>FEATURE</var>. This is the same as
 266           <code>--enable-<var>FEATURE</var>=no</code>.</dd>
 267
 268         <dt><code>--enable-<var>FEATURE</var>[=<var>ARG</var>]</code></dt>
 269         <dd>Include <var>FEATURE</var>. The default value for <var>ARG</var>
 270           is <code>yes</code>.</dd>
 271
 272         <dt><code>--enable-<var>MODULE</var>=shared</code></dt>
 273         <dd>The corresponding module will be build as DSO module.</dd>
 274
 275         <dt><code>--enable-<var>MODULE</var>=static</code></dt>
 276         <dd>By default enabled modules are linked statically. You can force
 277           this explicitly.</dd>
 278       </dl>
 279
 280       <div class="note"><h3>Note</h3>
 281         <code>configure</code> will not complain about
 282         <code>--enable-<var>foo</var></code> even if <var>foo</var> doesn't
 283         exist, so you need to type carefully.
 284       </div>
 285
 286
 287
 288     <h4><a name="enabledmodules" id="enabledmodules">Modules enabled by default</a></h4>
 289       <p>Some modules are compiled by default and have to be disabled
 290         explicitly. Use the following options to remove discrete modules from
 291         the compilation process.</p>
 292
 293       <dl>
 294         <dt><code>--disable-actions</code></dt>
 295         <dd>Disable action triggering on requests, which is provided by
 296           <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code>.</dd>
 297
 298         <dt><code>--disable-alias</code></dt>
 299         <dd>Disable the mapping of requests to different parts of the
 300           filesystem, which is provided by <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>.</dd>
 301
 302         <dt><code>--disable-asis</code></dt>
 303         <dd>Disable support for as-is filetypes, which is provided by
 304           <code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code>.</dd>
 305
 306         <dt><code>--disable-auth</code></dt>
 307         <dd>Disable user-based access control provided  by
 308           <code class="module"><a href="../mod/mod_auth.html">mod_auth</a></code>. This module provides for HTTP Basic
 309           Authentication, where the usernames and passwords are stored in
 310           plain text files.</dd>
 311
 312         <dt><code>--disable-autoindex</code></dt>
 313         <dd>Disable the directory listing functionality provided by
 314           <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>.</dd>
 315
 316         <dt><code>--disable-access</code></dt>
 317         <dd>Disable host-based access control provided by
 318           <code class="module"><a href="../mod/mod_access.html">mod_access</a></code>.</dd>
 319
 320         <dt><code>--disable-cgi</code></dt>
 321         <dd><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, which provides support for CGI scripts,
 322           is enabled by default when using a non-threaded MPM. Use this
 323           option to disable CGI support.</dd>
 324
 325         <dt><code>--disable-cgid</code></dt>
 326         <dd>When using the threaded MPMs <code class="module"><a href="../mod/worker.html">worker</a></code> or
 327           <code class="module"><a href="../mod/perchild.html">perchild</a></code> support for CGI scripts is provided by
 328           <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> by default. To disable CGI support use
 329           this option.</dd>
 330
 331         <dt><code>--disable-charset-lite</code></dt>
 332         <dd>Disable character set translation provided by
 333           <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>. This module will be installed by
 334           default only on EBCDIC systems.</dd>
 335
 336         <dt><code>--disable-dir</code></dt>
 337         <dd>Disable directory request handling provided by
 338           <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>.</dd>
 339
 340         <dt><code>--disable-env</code></dt>
 341         <dd>Enable setting and clearing of environment variables, which is
 342           provided by <code class="module"><a href="../mod/mod_env.html">mod_env</a></code>.</dd>
 343
 344
 345         <dt><code>--disable-http</code></dt>
 346           <dd>Disable the HTTP protocol handling. The <code>http</code>
 347             module is a basic one, enabling the server to function as an
 348             HTTP server. It is only useful to disable it if you want to use
 349             another protocol module instead. <strong>Don't disable this
 350             module unless you are really sure what you are doing.</strong>
 351             <br />
 352             Note: This module will always be linked statically.</dd>
 353
 354         <dt><code>--disable-imap</code></dt>
 355         <dd>Disable support for server based imagemaps, which provided by
 356           <code class="module"><a href="../mod/mod_imap.html">mod_imap</a></code>.</dd>
 357
 358         <dt><code>--disable-include</code></dt>
 359         <dd>Disable Server Side Includes provided by
 360           <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>.</dd>
 361
 362         <dt><code>--disable-log-config</code></dt>
 363         <dd>Disable the logging configuration provided by
 364           <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>. You won't be able to log requests
 365           to the server without this module.</dd>
 366
 367         <dt><code>--disable-mime</code></dt>
 368         <dd><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> associates the requested filename's
 369           extensions with the file's behavior and content (mime-type,
 370           language, character set and encoding). Disabling the mapping of
 371           file-extensions to MIME is normally not recommended.</dd>
 372
 373         <dt><code>--disable-negotiation</code></dt>
 374         <dd>Disable content negotiation provided by
 375           <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>.</dd>
 376
 377         <dt><code>--disable-setenvif</code></dt>
 378         <dd>Disable support for basing environment variables on headers,
 379           which is provided by <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>.</dd>
 380
 381         <dt><code>--disable-status</code></dt>
 382         <dd>Enable the process/thread monitoring, which is provided by
 383           <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.</dd>
 384
 385         <dt><code>--disable-userdir</code></dt>
 386         <dd>Disable the mapping of requests to user-specific directories,
 387           which is provided by <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</dd>
 388       </dl>
 389
 390
 391     <h4><a name="disabledmodules" id="disabledmodules">Modules, disabled by default</a></h4>
 392       <p>Some modules are compiled by default and have to be enabled
 393         explicitly or by using the keywords <code>most</code> or
 394         <code>all</code> (see <code>--enable-mods-shared</code> below for
 395         further explanation) to be available. Therefore use the options
 396         below.</p>
 397
 398       <dl>
 399         <dt><code>--enable-auth-anon</code></dt>
 400         <dd>Enable anonymous user access provided by
 401           <code class="module"><a href="../mod/mod_auth_anon.html">mod_auth_anon</a></code>.</dd>
 402
 403         <dt><code>--enable-auth-dbm</code></dt>
 404         <dd><code class="module"><a href="../mod/mod_auth_dbm.html">mod_auth_dbm</a></code> provides for HTTP Basic
 405           Authentication, where the usernames and passwords are stored in DBM
 406           type database files. Use this option to enable the module.</dd>
 407
 408         <dt><code>--enable-auth-digest</code></dt>
 409         <dd>Enable RFC2617 Digest authentication provided by
 410           <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. This module uses plain text files
 411           to store the credentials.</dd>
 412
 413         <dt><code>--enable-auth-ldap</code></dt>
 414         <dd>Enable LDAP based authentication provided by
 415           <code class="module"><a href="../mod/mod_auth_ldap.html">mod_auth_ldap</a></code>.</dd>
 416
 417         <dt><code>--enable-cache</code></dt>
 418         <dd>Enable dynamic file caching provided by
 419           <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>. This experimental module may be
 420           interesting for servers with high load or caching proxy servers. At
 421           least one storage management module (e.g.
 422           <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> or <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code>)
 423           is also necessary.</dd>
 424
 425         <dt><code>--enable-cern-meta</code></dt>
 426         <dd>Enable the CERN-type meta files support provided by
 427           <code class="module"><a href="../mod/mod_cern_meta.html">mod_cern_meta</a></code>.</dd>
 428
 429         <dt><code>--enable-charset-lite</code></dt>
 430         <dd>Enable character set translation provided by
 431           <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>. This module will be installed by
 432           default only on EBCDIC systems. On other systems, you have to enable
 433           it.</dd>
 434
 435         <dt><code>--enable-dav</code></dt>
 436         <dd>Enable the WebDAV protocol handling provided by
 437           <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. Support for filesystem resources is
 438           provided by the seperate module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. This
 439           module is also automatically enabled with
 440           <code>--enable-dav</code>.<br />
 441           Note: <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> can only be used together with the
 442           <code>http</code> protocol module.</dd>
 443
 444         <dt><code>--enable-dav-fs</code></dt>
 445         <dd>Enable DAV support for filesystem resources, which is provides by
 446           <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. This module is a provider for the
 447           <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> module, so you should also use
 448           <code>--enable-dav</code>.</dd>
 449
 450         <dt><code>--enable-deflate</code></dt>
 451         <dd>Enable deflate transfer encoding provided by
 452           <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</dd>
 453
 454         <dt><code>--enable-disk-cache</code></dt>
 455         <dd>Enable disk caching provided by
 456           <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>.</dd>
 457
 458         <dt><code>--enable-expires</code></dt>
 459         <dd>Enable Expires header control provided by
 460           <code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code>.</dd>
 461
 462         <dt><code>--enable-ext-filter</code></dt>
 463         <dd>Enable the external filter support provided by
 464           <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>.</dd>
 465
 466         <dt><code>--enable-file-cache</code></dt>
 467         <dd>Enable the file cache provided by
 468           <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>.</dd>
 469
 470         <dt><code>--enable-headers</code></dt>
 471         <dd>Enable control of HTTP headers provided by
 472           <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>.</dd>
 473
 474         <dt><code>--enable-info</code></dt>
 475         <dd>Enable the server information provided by
 476           <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>.</dd>
 477
 478         <dt><code>--enable-ldap</code></dt>
 479         <dd>Enable LDAP caching and connection pooling services provided by
 480           <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>.</dd>
 481
 482         <dt><code>--enable-logio</code></dt>
 483         <dd>Enable logging of input and output bytes including headers provided
 484           by <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</dd>
 485
 486         <dt><code>--enable-mem-cache</code></dt>
 487         <dd>Enable memory caching provided by
 488           <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code>.</dd>
 489
 490         <dt><code>--enable-mime-magic</code></dt>
 491         <dd>Enable automatical determining of MIME types, which is provided by
 492           <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>.</dd>
 493
 494         <dt><code>--enable-isapi</code></dt>
 495         <dd>Enable the isapi extension support provided by
 496           <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code>.</dd>
 497
 498         <dt><code>--enable-proxy</code></dt>
 499         <dd>Enable the proxy/gateway functionality provided by
 500           <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. The proxying capabilities for
 501           <code>CONNECT</code>, <code>FTP</code> and <code>HTTP</code> are
 502           provided by the seperate modules <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code>,
 503           <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> and <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>.
 504           These three modules are also automatically enabled with
 505           <code>--enable-proxy</code>.</dd>
 506
 507         <dt><code>--enable-proxy-connect</code></dt>
 508         <dd>Enable proxy support for <code>CONNECT</code> request handling,
 509           which is provided by <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code>. This module
 510           is an extension for the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module, so you
 511           should also use <code>--enable-proxy</code>.</dd>
 512
 513         <dt><code>--enable-proxy-ftp</code></dt>
 514         <dd>Enable proxy support for <code>FTP</code> requests, which is
 515           provided by <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>.. This module
 516           is an extension for the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module, so you
 517           should also use <code>--enable-proxy</code>.</dd>
 518
 519         <dt><code>--enable-proxy-http</code></dt>
 520         <dd>Enable proxy support for <code>HTTP</code> requests, which is
 521           provided by <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>. This module
 522           is an extension for the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module, so you
 523           should also use <code>--enable-proxy</code>.</dd>
 524
 525         <dt><code>--enable-rewrite</code></dt>
 526         <dd>Enable rule based URL manipulation provided by
 527           <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</dd>
 528
 529         <dt><code>--enable-so</code></dt>
 530         <dd>Enable DSO capability provided by <code class="module"><a href="../mod/mod_so.html">mod_so</a></code>. This
 531           module will be automatically enabled if you use the
 532           <code>--enable-mods-shared</code> option.</dd>
 533
 534         <dt><code>--enable-speling</code></dt>
 535         <dd>Enable the functionality to correct common URL misspellings, which
 536           is provided by <code class="module"><a href="../mod/mod_spelling.html">mod_spelling</a></code>.</dd>
 537
 538         <dt><code>--enable-ssl</code></dt>
 539         <dd>Enable support for SSL/TLS provided by
 540           <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</dd>
 541
 542         <dt><code>--enable-unique-id</code></dt>
 543         <dd>Enable the generation of per-request unique ids, which is provided
 544           by <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code>.</dd>
 545
 546         <dt><code>--enable-usertrack</code></dt>
 547         <dd>Enable user-session tracking provided by
 548           <code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code>.</dd>
 549
 550         <dt><code>--enable-vhost-alias</code></dt>
 551         <dd>Enable mass virtual hosting provided by
 552           <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>.</dd>
 553       </dl>
 554
 555
 556     <h4><a name="developermodules" id="developermodules">Modules for developers</a></h4>
 557       <p>The following modules are useful only for developers and testing
 558         purposes and are disabled by default. Use the following options to
 559         enable them. If you are not sure whether you need one of these
 560         modules, omit them.</p>
 561
 562       <dl>
 563
 564         <dt><code>--enable-bucketeer</code></dt>
 565         <dd>Enable the manipulation filter for buckets, which is provided by
 566           <code>mod_bucketeer</code>.</dd>
 567
 568
 569         <dt><code>--enable-case-filter</code></dt>
 570         <dd>Enable the example uppercase conversion output filter support of
 571           <code>mod_case_filter</code>.</dd>
 572
 573
 574         <dt><code>--enable-case-filter-in</code></dt>
 575         <dd>Enable the example uppercase conversion input filter support of
 576           <code>mod_case_filter_in</code>.</dd>
 577
 578         <dt><code>--enable-echo</code></dt>
 579         <dd>Enable the ECHO server provided by
 580           <code class="module"><a href="../mod/mod_echo.html">mod_echo</a></code>.</dd>
 581
 582         <dt><code>--enable-example</code></dt>
 583         <dd>Enable the example and demo module
 584           <code class="module"><a href="../mod/mod_example.html">mod_example</a></code>.</dd>
 585
 586
 587         <dt><code>--enable-optional-fn-export</code></dt>
 588         <dd>Enable the example for an optional function exporter, which is
 589           provided by <code>mod_optional_fn_export</code>.</dd>
 590
 591
 592         <dt><code>--enable-optional-fn-import</code></dt>
 593         <dd>Enable the example for an optional function importer, which is
 594           provided by <code>mod_optional_fn_import</code>.</dd>
 595
 596
 597         <dt><code>--enable-optional-hook-export</code></dt>
 598         <dd>Enable the example for an optional hook exporter, which is provided
 599           by <code>mod_optional_hook_export</code>.</dd>
 600
 601
 602         <dt><code>--enable-optional-hook-import</code></dt>
 603         <dd>Enable the example optional hook importer, which is provided by
 604           <code>mod_optional_hook_import</code>.</dd>
 605       </dl>
 606
 607
 608     <h4><a name="modules" id="modules">MPMs and third-party modules</a></h4>
 609       <p>To add the necessary Multi Processing Module and additional third-party
 610         modules use the following options:</p>
 611
 612       <dl>
 613         <dt><code>--with-module=<var>module-type</var>:<var>module-file</var>
 614           </code></dt>
 615         <dd><p>Add a third-party module to the list of statically linked
 616             modules. The module source file <code><var>module-file</var></code>
 617             will be searched in the <code>modules/<var>module-type</var></code>
 618             subdirectory of your Apache HTTP server source tree so it has to be
 619             placed there before. If it is not found here
 620             <code>configure</code> is considering <var>module-file</var> to be
 621             an absolute file path and tries to copy the source file into the
 622             <var>module-type</var> subdirectory.</p>
 623           <p>This option is useful to add small external modules consisting of
 624             one source file. For more complex modules you should read the
 625             vendor's documentation.</p>
 626           <div class="note"><h3>Note</h3>
 627             If you want to build a DSO module instead of a statically linked
 628             use <a href="apxs.html">apxs</a>.</div>
 629         </dd>
 630
 631         <dt><code>--with-mpm=MPM</code></dt>
 632         <dd>Choose the process model for your server. You have to select
 633           exactly one <a href="../mpm.html">Multi-Processing Module</a>.
 634           Otherwise the <a href="../mpm.html#defaults">default MPM</a> for
 635           your operating system will be taken. Possible MPMs are
 636           <code class="module"><a href="../mod/beos.html">beos</a></code>, <code class="module"><a href="../mod/leader.html">leader</a></code>,
 637           <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="../mod/perchild.html">perchild</a></code>,
 638           <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/threadpool.html">threadpool</a></code> and
 639           <code class="module"><a href="../mod/worker.html">worker</a></code>.</dd>
 640       </dl>
 641
 642
 643     <h4><a name="otheroptfeat" id="otheroptfeat">Cumulative and other options</a></h4>
 644       <dl>
 645         <dt><code>--enable-maintainer-mode</code></dt>
 646         <dd>Turn on debugging and compile time warnings.</dd>
 647
 648         <dt><code>--enable-mods-shared=<var>MODULE-LIST</var></code></dt>
 649         <dd>
 650           <p>Defines a list of modules to be enabled and build as dynamic
 651             shared modules. This mean, these module have to be loaded
 652             dynamically by using the  <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</p>
 653           <p><var>MODULE-LIST</var> is a space separated list of modulenames
 654             enclosed by quotation marks. The module names are given without the
 655             preceding <code>mod_</code>. For example:</p>
 656           <div class="example"><p><code>
 657             --enable-mods-shared='headers rewrite dav'
 658           </code></p></div>
 659           <p>Additionally you can use the special keywords <code>all</code> and
 660             <code>most</code>. For example,</p>
 661           <div class="example"><p><code>
 662             --enable-mods-shared=most
 663           </code></p></div>
 664           <p>will compile most modules and build them as DSO modules.
 665             </p>
 666         </dd>
 667
 668         <dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
 669         <dd>This option behaves similar to <code>--enable-mods-shared</code>,
 670           but will link the given modules statically. This mean, these modules
 671           will always be present while running <code>httpd</code>. They need
 672           not be loaded with <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</dd>
 673
 674         <dt><code>--enable-v4-mapped</code></dt>
 675         <dd>Allow IPv6 sockets to handle IPv4 connections.</dd>
 676
 677         <dt><code>--with-port=<var>PORT</var></code></dt>
 678         <dd>This defines the port on which <code>httpd</code> will listen. This
 679           port number is used when generating the configuration file
 680           <code>httpd.conf</code>. The default is 80.</dd>
 681
 682         <dt><code>--with-program-name</code></dt>
 683         <dd>Define an alternative executable name. The default is
 684           <code>httpd</code>.</dd>
 685       </dl>
 686
 687
 688
 689   <h3><a name="packages" id="packages">Optional packages</a></h3>
 690     <p>These options are used to define optional packages.</p>
 691
 692     <h4><a name="generalpackages" id="generalpackages">General syntax</a></h4>
 693       <p>Generally you can use the following syntax to define an optional
 694         package:</p>
 695
 696       <dl>
 697         <dt><code>--with-<var>PACKAGE</var>[=<var>ARG</var>]</code></dt>
 698         <dd>Use the package <var>PACKAGE</var>. The default value for
 699           <var>ARG</var> is<code>yes</code>.</dd>
 700
 701         <dt><code>--without-<var>PACKAGE</var></code></dt>
 702         <dd>Do not use the package <var>PACKAGE</var>. This is the same as
 703           <code>--with-<var>PACKAGE</var>=no</code>. This option is provided by
 704           <code>autoconf</code> but not very useful for the Apache HTTP
 705           Server.</dd>
 706       </dl>
 707
 708
 709
 710
 711     <h4><a name="packageopt" id="packageopt">Specific packages</a></h4>
 712       <dl>
 713         <dt><code>--with-apr=<var>DIR</var>|<var>FILE</var></code></dt>
 714         <dd>The Apache Portable Runtime (APR) is part of the <code>httpd</code>
 715           source distribution and will automatically be build together with the
 716           HTTP server. If you want to use an already installed APR instead you
 717           have to tell <code>configure</code> the path to the
 718           <code>apr-config</code> script. You may set the absolute path and name
 719           or the directory to the installed APR. <code>apr-config</code> must
 720           exists within this directory or the subdirectory
 721           <code>bin</code>.</dd>
 722
 723         <dt><code>--with-apr-util=<var>DIR</var>|<var>FILE</var></code></dt>
 724         <dd>The Apache Portable Runtime Utilities (APU) are part of the
 725           <code>httpd</code> source distribution and will automatically be build
 726           together with the HTTP server. If you want to use an already installed
 727           APU instead you have to tell <code>configure</code> the path to the
 728           <code>apu-config</code> script. You may set the absolute path and name
 729           or the directory to the installed APU. <code>apu-config</code> must
 730           exists within this directory or the subdirectory
 731           <code>bin</code>.</dd>
 732
 733         <dt><code>--with-ssl=<var>DIR</var></code></dt>
 734         <dd>If <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> has been enabled <code>configure</code>
 735           searches for an installed OpenSSL. You can set the directory path
 736           to the SSL/TLS toolkit instead.</dd>
 737
 738         <dt><code>--with-z=<var>DIR</var></code></dt>
 739         <dd><code>configure</code> searches automatically for an installed
 740           <code>zlib</code> library if your source configuration requires one
 741           (e.g., when <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> is enabled). You can set the
 742           directory path to the compression library instead.</dd>
 743       </dl>
 744
 745       <p>Several features of the Apache HTTP Server, including
 746         <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> and <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>'s DBM
 747         <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> use simple
 748         key/value databases for quick lookups of information. SDBM is included
 749         in the APU, so this database is always available. If you would like to
 750         use other database types, use the following options to enable
 751         them:</p>
 752
 753       <dl>
 754         <dt><code>--with-gdbm[=<var>path</var>]</code></dt>
 755         <dd>If no <var>path</var> is specified, <code>configure</code> will
 756           search for the include files and libraries of a GNU DBM
 757           installation in the usual search paths. An explicit
 758           <var>path</var> will cause <code>configure</code> to look in
 759           <code><var>path</var>/lib</code> and
 760           <code><var>path</var>/include</code> for the relevant files.
 761           Finally, the <var>path</var> may specify specific include and
 762           library paths separated by a colon.</dd>
 763
 764         <dt><code>--with-ndbm[=<var>path</var>]</code></dt>
 765         <dd>Like <code>--with-gdbm</code>, bur searches for a New DBM
 766           installation.</dd>
 767
 768         <dt><code>--with-berkeley-db[=<var>path</var>]</code></dt>
 769         <dd>Like <code>--with-gdbm</code>, but searches for a Berkeley DB
 770           installation.</dd>
 771       </dl>
 772
 773       <div class="note"><h3>Note</h3>
 774         <p>The DBM options are provided by the APU and passed through to its
 775           configuration script. They are useless when using an already
 776           installed APU defined by <code>--with-apr-util</code>.</p>
 777         <p>You may use more then one DBM implementation together with your
 778           HTTP server. The appropriated DBM type will be configured within
 779           the runtime configuration at each time.</p>
 780       </div>
 781
 782
 783
 784   <h3><a name="supportopt" id="supportopt">Options for support programs</a></h3>
 785     <dl>
 786       <dt><code>--enable-static-support</code></dt>
 787       <dd>Build a statically linked version of the support binaries. This
 788         means, a stand-alone executable will be built with all the necessary
 789         libraries integrated. Otherwise the support binaries are linked
 790         dynamically by default.</dd>
 791
 792       <dt><code>--enable-suexec</code></dt>
 793       <dd>Use this option to enable <code><a href="suexec.html">suexec</a></code>, which allows you to set
 794         uid and gid for spawned processes. <strong>Do not use this
 795         option unless you understand all the security implications of
 796         running a suid binary on your server.</strong> Further options
 797         to configure <code>suexec</code> are described <a href="#suexec">below</a>.</dd> </dl>
 798
 799     <p>It is possible to create a statically linked binary of a single
 800       support program by using the following options:</p>
 801
 802     <dl>
 803       <dt><code>--enable-static-ab</code></dt>
 804       <dd>Build a statically linked version of <code><a href="ab.html">ab</a></code>.</dd>
 805
 806
 807       <dt><code>--enable-static-checkgid</code></dt>
 808       <dd>Build a statically linked version of <code>checkgid</code>.</dd>
 809
 810
 811       <dt><code>--enable-static-htdbm</code></dt>
 812       <dd>Build a statically linked version of <code>htdbm</code>.</dd>
 813
 814       <dt><code>--enable-static-htdigest</code></dt>
 815       <dd>Build a statically linked version of <code><a href="htdigest.html">htdigest</a></code>.</dd>
 816
 817       <dt><code>--enable-static-htpasswd</code></dt>
 818       <dd>Build a statically linked version of <code><a href="htpasswd.html">htpasswd</a></code>.</dd>
 819
 820       <dt><code>--enable-static-logresolve</code></dt>
 821       <dd>Build a statically linked version of <code><a href="logresolve.html">logresolve</a></code>.</dd>
 822
 823       <dt><code>--enable-static-rotatelogs</code></dt>
 824       <dd>Build a statically linked version of <code><a href="rotatelogs.html">rotatelogs</a></code>.</dd>
 825     </dl>
 826
 827     <h4><a name="suexec" id="suexec">suexec configuration options</a></h4>
 828       <p>The following options are used to fine tune the behavior of <code><a href="suexec.html">suexec</a></code>. See <a href="suexec.html#install">Configuring and installing suEXEC</a>
 829         for further information.</p>
 830
 831       <dl>
 832         <dt><code>--with-suexec-bin</code></dt>
 833         <dd>This defines the path to suexec binary. Default is
 834           <code>--sbindir</code> (see <a href="directoryfinetuning">Fine
 835             tuning of installation directories</a>).</dd>
 836
 837         <dt><code>--with-suexec-caller</code></dt>
 838         <dd>This defines the user allowed to call <code>suexec</code>. It should
 839           be the same as the user under which <code>httpd</code> normally
 840           runs.</dd>
 841
 842         <dt><code>--with-suexec-docroot</code></dt>
 843         <dd>This defines the directory tree under which <code>suexec</code>
 844           access is allowed for executables. Default value is
 845           <code>--datadir/htdocs</code>.</dd>
 846
 847         <dt><code>--with-suexec-gidmin</code></dt>
 848         <dd>Define this as the lowest GID allowed to be a target user for
 849           <code>suexec</code>. The default value is 100.</dd>
 850
 851         <dt><code>--with-suexec-logfile</code></dt>
 852         <dd>This defines the filename of the <code>suexec</code> logfile. By
 853           default the logfile is named <code>suexec_log</code> and located in
 854           <code>--logfiledir</code>.</dd>
 855
 856         <dt><code>--with-suexec-safepath</code></dt>
 857         <dd>Define the value of the environment variable <code>PATH</code> to
 858           be set for processes started by <code>suexec</code>. Default value is
 859           <code>/usr/local/bin:/usr/bin:/bin</code>.</dd>
 860
 861         <dt><code>--with-suexec-userdir</code></dt>
 862         <dd>This defines the subdirectory under the user's directory that
 863           contains all executables for which <code>suexec</code> access is
 864           allowed. This setting is necessary when you want to use
 865           <code>suexec</code> together with user-specific directories (as
 866           provided by <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>). The default is
 867           <code>public_html</code>.</dd>
 868
 869         <dt><code>--with-suexec-uidmin</code></dt>
 870         <dd>Define this as the lowest UID allowed to be a target user for
 871           <code>suexec</code>. The default value is 100.</dd>
 872
 873         <dt><code>--with-suexec-umask</code></dt>
 874         <dd>Set <code>umask</code> for processes started by <code>suexec</code>.
 875           It defaults to your system settings.</dd>
 876       </dl>
 877
 878
 879 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 880 <div class="section">
 881 <h2><a name="env" id="env">Environment variables</a></h2>
 882   <p>There are some useful environment variables to override the choices made by
 883     <code>configure</code> or to help it to find libraries and programs with
 884     nonstandard names or locations.</p>
 885
 886
 887   <dl>
 888     <dt><code>CC</code></dt>
 889     <dd>Define the C compiler command to be used for compilation.</dd>
 890
 891     <dt><code>CFLAGS</code></dt>
 892     <dd>Set C compiler flags you want to use for compilation.</dd>
 893
 894     <dt><code>CPP</code></dt>
 895     <dd>Define the C preprocessor command to be used.</dd>
 896
 897     <dt><code>CPPFLAGS</code></dt>
 898     <dd>Set C/C++ preprocessor flags, e.g. <code>-I<var>includedir</var></code>
 899       if you have headers in a nonstandard directory <var>includedir</var>.</dd>
 900
 901     <dt><code>LDFLAGS</code></dt>
 902     <dd>Set linker flags, e.g. <code>-L<var>libdir</var></code> if you have
 903       libraries in a nonstandard directory <var>libdir</var>.</dd>
 904   </dl>
 905 </div></div>
 906 <div class="bottomlang">
 907 <p><span>Available Languages: </span><a href="../en/programs/configure.html" title="English">&nbsp;en&nbsp;</a> |
 908 <a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 909 </div><div id="footer">
 910 <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 911 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
 912 </body></html>