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