github.com/krum110487/go-htaccess@v0.0.0-20240316004156-60641c8e7598/tests/data/apache_2_2_34/manual/programs/configure.html.en (about)

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