summaryrefslogtreecommitdiffstats
path: root/docs/manual/platform/win_compiling.html.en
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 06:33:50 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 06:33:50 +0000
commitfe39ffb8b90ae4e002ed73fe98617cd590abb467 (patch)
treeb80e5956907d8aeaaffe4e4f0c068c0e6157ce8b /docs/manual/platform/win_compiling.html.en
parentInitial commit. (diff)
downloadapache2-upstream/2.4.56.tar.xz
apache2-upstream/2.4.56.zip
Adding upstream version 2.4.56.upstream/2.4.56
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'docs/manual/platform/win_compiling.html.en')
-rw-r--r--docs/manual/platform/win_compiling.html.en517
1 files changed, 517 insertions, 0 deletions
diff --git a/docs/manual/platform/win_compiling.html.en b/docs/manual/platform/win_compiling.html.en
new file mode 100644
index 0000000..492215b
--- /dev/null
+++ b/docs/manual/platform/win_compiling.html.en
@@ -0,0 +1,517 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
+<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
+<!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>Compiling Apache for Microsoft Windows - Apache HTTP Server Version 2.4</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<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" />
+<script src="../style/scripts/prettify.min.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<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>
+<p class="apache">Apache HTTP Server Version 2.4</p>
+<img alt="" src="../images/feather.png" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<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.4</a> &gt; <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Compiling Apache for Microsoft Windows</h1>
+<div class="toplang">
+<p><span>Available Languages: </span><a href="../en/platform/win_compiling.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/platform/win_compiling.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+
+
+ <p>There are many important points to consider before you begin compiling
+ Apache HTTP Server (httpd). See <a href="windows.html">Using Apache HTTP
+ Server on Microsoft Windows</a> before you begin.</p>
+
+ <p>httpd can be built on Windows using a cmake-based build system or with
+ Visual Studio project files maintained by httpd developers. The cmake-based
+ build system directly supports more versions of Visual Studio but currently
+ has considerable functional limitations.</p>
+
+ </div>
+<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#vstudio">Building httpd with the included Visual Studio project files</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#cmake">Building httpd with cmake</a></li>
+</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="vstudio" id="vstudio">Building httpd with the included Visual Studio project files</a></h2>
+
+
+ <h3><a name="requirements" id="requirements">Requirements</a></h3>
+
+
+
+ <p>Compiling Apache requires the following environment to be
+ properly installed:</p>
+
+ <ul>
+ <li>
+ <p>Disk Space</p>
+
+ <p>Make sure you have at least 200 MB of free disk space
+ available. After installation Apache requires approximately
+ 80 MB of disk space, plus space for log and cache files,
+ which can grow rapidly. The actual disk space requirements
+ will vary considerably based on your chosen configuration and
+ any third-party modules or libraries, especially when OpenSSL
+ is also built. Because many files are text and very easily
+ compressed, NTFS filesystem compression cuts these requirements
+ in half.</p>
+ </li>
+
+ <li>
+ <p>Appropriate Patches</p>
+
+ <p>The httpd binary is built with the help of several patches to
+ third party packages, which ensure the released code is buildable
+ and debuggable. These patches are available and distributed from <a href="http://www.apache.org/dist/httpd/binaries/win32/patches_applied/">http://www.apache.org/dist/httpd/binaries/win32/patches_applied/</a>
+ and are recommended to be applied to obtain identical results as the
+ "official" ASF distributed binaries.</p>
+ </li>
+
+ <li>
+ <p>Microsoft Visual C++ 6.0 (Visual Studio 97) or later.</p>
+
+ <p>Apache can be built using the command line tools, or from
+ within the Visual Studio IDE Workbench. The command line
+ build requires the environment to reflect the <code>PATH</code>,
+ <code>INCLUDE</code>, <code>LIB</code> and other variables
+ that can be configured with the <code>vcvars32.bat</code> script.</p>
+
+ <div class="note">You may want the Visual Studio Processor Pack for your older
+ version of Visual Studio, or a full (not Express) version of newer
+ Visual Studio editions, for the ml.exe assembler. This will allow
+ you to build OpenSSL, if desired, using the more efficient assembly
+ code implementation.</div>
+
+ <div class="note">Only the Microsoft compiler tool chain is actively supported by
+ the active httpd contributors. Although the project regularly accepts
+ patches to ensure MinGW and other alternative builds work and improve
+ upon them, they are not actively maintained and are often broken in
+ the course of normal development.</div>
+ </li>
+
+ <li>
+ <p>Updated Microsoft Windows Platform SDK, February 2003 or later.</p>
+
+ <p>An appropriate Windows Platform SDK is included by default in the
+ full (not express/lite) versions of Visual C++ 7.1 (Visual Studio 2002)
+ and later, these users can ignore these steps unless explicitly choosing
+ a newer or different version of the Platform SDK.</p>
+
+ <p>To use Visual C++ 6.0 or 7.0 (Studio 2000 .NET), the Platform SDK
+ environment must be prepared using the <code>setenv.bat</code>
+ script (installed by the Platform SDK) before starting the command
+ line build or launching the msdev/devenv GUI environment. Installing
+ the Platform SDK for Visual Studio Express versions (2003 and later)
+ should adjust the default environment appropriately.</p>
+
+ <div class="example"><p><code>
+ "c:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32"<br />
+ "c:\Program Files\Platform SDK\setenv.bat"
+ </code></p></div>
+ </li>
+
+ <li>
+ <p>Perl and awk</p>
+
+ <p>Several steps recommended here require a perl interpreter during
+ the build preparation process, but it is otherwise not required.</p>
+
+ <p>To install Apache within the build system, several files are
+ modified using the <code>awk.exe</code> utility. awk was chosen since
+ it is a very small download (compared with Perl or WSH/VB) and
+ accomplishes the task of modifying configuration files upon
+ installation. Brian Kernighan's
+ <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/">http://www.cs.princeton.edu/~bwk/btl.mirror/</a>
+ site has a compiled native Win32 binary,
+ <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe">http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe</a> which
+ you must save with the name <code>awk.exe</code> (rather than
+ <code>awk95.exe</code>).</p>
+
+ <div class="note">If awk.exe is not found, Makefile.win's install target
+ will not perform substitutions in the installed .conf files.
+ You must manually modify the installed .conf files to allow
+ the server to start. Search and replace all "@token@" tags
+ as appropriate.</div>
+
+ <div class="note">The Visual Studio IDE will only find <code>awk.exe</code>
+ from the PATH, or executable path specified in the menu option
+ Tools -&gt; Options -&gt; (Projects -&gt;) Directories. Ensure
+ awk.exe is in your system path.</div>
+
+ <div class="note">Also note that if you are using Cygwin tools
+ (<a href="http://www.cygwin.com/">http://www.cygwin.com/</a>)
+ the awk utility is named <code>gawk.exe</code> and that the file
+ <code>awk.exe</code> is really a symlink to the <code>gawk.exe</code>
+ file. The Windows command shell does not recognize symlinks, and
+ because of this building InstallBin will fail. A workaround is
+ to delete <code>awk.exe</code> from the cygwin installation and
+ copy <code>gawk.exe</code> to <code>awk.exe</code>. Also note the
+ cygwin/mingw ports of gawk 3.0.x were buggy, please upgrade to 3.1.x
+ before attempting to use any gawk port.</div>
+ </li>
+
+ <li>
+ <p>[Optional] zlib library (for <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>)</p>
+
+ <p>Zlib must be installed into a <code>srclib</code> subdirectory named
+ <code>zlib</code>. This must be built in-place. Zlib can be obtained
+ from <a href="http://www.zlib.net/">http://www.zlib.net/</a> -- the
+ <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> is confirmed to work correctly with
+ version 1.2.3.</p>
+
+ <div class="example"><p><code>
+ nmake -f win32\Makefile.msc<br />
+ nmake -f win32\Makefile.msc test
+ </code></p></div>
+ </li>
+
+ <li>
+ <p>[Optional] OpenSSL libraries (for <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>
+ and <code>ab.exe</code> with ssl support)</p>
+
+ <div class="note">The OpenSSL library is cryptographic software. The country
+ in which you currently reside may have restrictions on the import,
+ possession, use, and/or re-export to another country, of encryption
+ software. BEFORE using any encryption software, please check your
+ country's laws, regulations and policies concerning the import,
+ possession, or use, and re-export of encryption software, to see
+ if this is permitted. See
+ <a href="http://www.wassenaar.org/">http://www.wassenaar.org/</a>
+ for more information.</div>
+
+ <p>Configuring and building OpenSSL requires perl to be installed.</p>
+
+ <p>OpenSSL must be installed into a <code>srclib</code> subdirectory
+ named <code>openssl</code>, obtained from
+ <a href="http://www.openssl.org/source/">http://www.openssl.org/source/</a>, in order to compile
+ <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> or the <code>abs.exe</code> project, which
+ is ab.c with SSL support enabled. To prepare OpenSSL to be linked
+ to Apache mod_ssl or abs.exe, and disable patent encumbered features
+ in OpenSSL, you might use the following build commands:</p>
+
+ <div class="example"><p><code>
+ perl Configure no-rc5 no-idea enable-mdc2 enable-zlib VC-WIN32
+ -Ipath/to/srclib/zlib -Lpath/to/srclib/zlib<br />
+ ms\do_masm.bat<br />
+ nmake -f ms\ntdll.mak
+ </code></p></div>
+
+ <div class="note">It is not advisable to use zlib-dynamic, as that transfers
+ the cost of deflating SSL streams to the first request which must
+ load the zlib dll. Note the suggested patch enables the -L flag to
+ work with windows builds, corrects the name of zdll.lib and ensures
+ .pdb files are generated for troubleshooting. If the assembler is
+ not installed, you would add no-asm above and use ms\do_ms.bat
+ instead of the ms\do_masm.bat script.</div>
+ </li>
+
+ <li>
+ <p>[Optional] Database libraries (for <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code>
+ and <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>)</p>
+
+ <p>The apr-util library exposes dbm (keyed database) and dbd (query
+ oriented database) client functionality to the httpd server and its
+ modules, such as authentication and authorization. The sdbm dbm and
+ odbc dbd providers are compiled unconditionally.</p>
+
+ <p>The dbd support includes the Oracle instantclient package, MySQL,
+ PostgreSQL and sqlite. To build these all, for example, set up the
+ LIB to include the library path, INCLUDE to include the headers path,
+ and PATH to include the dll bin path of all four SDK's, and set the
+ DBD_LIST environment variable to inform the build which client driver
+ SDKs are installed correctly, e.g.;</p>
+
+ <div class="example"><p><code>
+ set DBD_LIST=sqlite3 pgsql oracle mysql
+ </code></p></div>
+
+ <p>Similarly, the dbm support can be extended with DBM_LIST to
+ build a Berkeley DB provider (db) and/or gdbm provider, by similarly
+ configuring LIB, INCLUDE and PATH first to ensure the client library
+ libs and headers are available.</p>
+
+ <div class="example"><p><code>
+ set DBM_LIST=db gdbm
+ </code></p></div>
+
+ <div class="note">Depending on the choice of database distributions, it may be
+ necessary to change the actual link target name (e.g. gdbm.lib vs.
+ libgdb.lib) that are listed in the corresponding .dsp/.mak files
+ within the directories srclib\apr-util\dbd or ...\dbm.</div>
+
+ <p>See the README-win32.txt file for more hints on obtaining the
+ various database driver SDKs.</p>
+ </li>
+ </ul>
+
+
+
+ <h3><a name="unixsrcbuild" id="unixsrcbuild">Building from Unix sources</a></h3>
+
+
+
+ <p>The policy of the Apache HTTP Server project is to only release Unix sources.
+ Windows source packages made available for download have been supplied by
+ volunteers and may not be available for every release. You can still build
+ the server on Windows from the Unix source tarball with just a few additional
+ steps.</p>
+
+ <ol>
+ <li>Download and unpack the Unix source tarball for the latest version.</li>
+ <li>Download and unpack the Unix source tarball for latest version of
+ APR, AR-Util and APR-Iconv, place these sources in directories httpd-2.x.x\srclib\apr, httpd-2.x.x\srclib\apr-util and httpd-2.x.x\srclib\apr-iconv</li>
+ <li>Open a Command Prompt and CD to the httpd-2.x.x folder</li>
+ <li>Run the line endings conversion utility at the prompt;</li>
+ </ol>
+
+ <div class="example"><p><code>
+ perl srclib\apr\build\lineends.pl
+ </code></p></div>
+
+ <p>You can now build the server with the Visual Studio development
+ environment using the IDE. Command-Line builds of the server are not
+ possible from Unix sources unless you export .mak files as explained
+ below.
+ </p>
+
+
+
+ <h3><a name="commandbuild" id="commandbuild">Command-Line Build</a></h3>
+
+
+
+ <p><code>Makefile.win</code> is the top level Apache makefile.
+ To compile Apache on Windows, simply use one of the following commands
+ to build the <code>release</code> or <code>debug</code> flavor:</p>
+
+ <div class="example"><p><code>
+ nmake /f Makefile.win _apacher<br /><br />
+ nmake /f Makefile.win _apached
+ </code></p></div>
+
+ <p>Either command will compile Apache. The latter will disable
+ optimization of the resulting files, making it easier to single
+ step the code to find bugs and track down problems.</p>
+
+ <p>You can add your apr-util dbd and dbm provider choices with the
+ additional make (environment) variables DBD_LIST and DBM_LIST,
+ see the comments about [Optional] Database libraries, above.
+ Review the initial comments in Makefile.win for additional options
+ that can be provided when invoking the build.</p>
+
+
+
+ <h3><a name="workspacebuild" id="workspacebuild">Developer Studio Workspace IDE Build</a></h3>
+
+
+
+ <p>Apache can also be compiled using VC++'s Visual Studio
+ development environment. To simplify this process, a
+ Visual Studio workspace, <code>Apache.dsw</code>, is provided.
+ This workspace exposes the entire list of working <code>.dsp</code>
+ projects that are required for the complete Apache binary release.
+ It includes dependencies between the projects to assure that they
+ are built in the appropriate order.</p>
+
+ <p>Open the <code>Apache.dsw</code> workspace, and select
+ <code>InstallBin</code> (<code>Release</code> or <code>Debug</code> build,
+ as desired) as the Active Project. <code>InstallBin</code> causes all
+ related project to be built, and then invokes <code>Makefile.win</code> to
+ move the compiled executables and dlls. You may personalize the
+ <code>INSTDIR=</code> choice by changing <code>InstallBin</code>'s Settings,
+ General tab, Build command line entry. <code>INSTDIR</code> defaults to the
+ <code>/Apache2</code> directory. If you only want a test compile (without
+ installing) you may build the <code>BuildBin</code> project instead.</p>
+
+ <p>The <code>.dsp</code> project files are distributed in Visual Studio 6.0
+ (98) format. Visual C++ 5.0 (97) will recognize them. Visual Studio
+ 2002 (.NET) and later users must convert <code>Apache.dsw</code> plus
+ the <code>.dsp</code> files into an <code>Apache.sln</code> plus
+ <code>.msproj</code> files. Be sure you reconvert the <code>.msproj</code>
+ file again if its source <code>.dsp</code> file changes! This is really
+ trivial, just open <code>Apache.dsw</code> in the VC++ 7.0 IDE once again
+ and reconvert.</p>
+
+ <div class="note">There is a flaw in the .vcproj conversion of .dsp files. devenv.exe
+ will mis-parse the /D flag for RC flags containing long quoted /D'efines
+ which contain spaces. The command:
+ <div class="example"><p><code>
+ perl srclib\apr\build\cvtdsp.pl -2005
+ </code></p></div>
+ will convert the /D flags for RC flags to use an alternate, parseable
+ syntax; unfortunately this syntax isn't supported by Visual Studio 97
+ or its exported .mak files. These /D flags are used to pass the long
+ description of the mod_apachemodule.so files to the shared .rc resource
+ version-identifier build.</div>
+
+ <div class="note"><strong>Building with OpenSSL 1.1.0 and up</strong>
+ Due to difference in the build structure of OpenSSL begining with version
+ 1.1.0 you will need to convert the dsp files affected with cvtdsp.pl from
+ APR 1.6 or greater. The command:
+ <div class="example"><p><code>
+ perl srclib\apr\build\cvtdsp.pl -ossl11
+ </code></p></div>
+ </div>
+
+ <p>Visual Studio 2002 (.NET) and later users should also use the Build
+ menu, Configuration Manager dialog to uncheck both the <code>Debug</code>
+ and <code>Release</code> Solution modules <code>abs</code>,
+ <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> and <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> components, as
+ well as every component starting with <code>apr_db*</code>. These modules
+ are built by invoking <code>nmake</code>, or the IDE directly with the
+ <code>BinBuild</code> target, which builds those modules conditionally
+ if the <code>srclib</code> directories <code>openssl</code> and/or
+ <code>zlib</code> exist, and based on the setting of <code>DBD_LIST</code>
+ and <code>DBM_LIST</code> environment variables.</p>
+
+
+
+ <h3><a name="exportingmakfiles" id="exportingmakfiles">Exporting command-line .mak files</a></h3>
+
+
+
+ <p>Exported <code>.mak</code> files pose a greater hassle, but they are
+ required for Visual C++ 5.0 users to build <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>,
+ abs (<code class="program"><a href="../programs/ab.html">ab</a></code> with SSL support) and/or
+ <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. The .mak files also support a broader
+ range of C++ tool chain distributions, such as Visual Studio Express.</p>
+
+ <p>You must first build all projects in order to create all dynamic
+ auto-generated targets, so that dependencies can be parsed correctly.
+ Build the entire project from within the Visual Studio 6.0 (98) IDE,
+ using the <code>BuildAll</code> target, then use the Project Menu Export
+ for all makefiles (checking on "with dependencies".) Run the following
+ command to correct absolute paths into relative paths so they will build
+ anywhere:</p>
+
+ <div class="example"><p><code>
+ perl srclib\apr\build\fixwin32mak.pl
+ </code></p></div>
+
+ <p>You must type this command from the <em>top level</em>
+ directory of the httpd source tree. Every
+ <code>.mak</code> and <code>.dep</code> project file within
+ the current directory and below will be corrected, and the
+ timestamps adjusted to reflect the <code>.dsp</code>.</p>
+
+ <p>Always review the generated <code>.mak</code> and <code>.dep</code>
+ files for Platform SDK or other local, machine specific file paths.
+ The <code>DevStudio\Common\MSDev98\bin\</code> (VC6) directory contains
+ a <code>sysincl.dat</code> file, which lists all exceptions. Update
+ this file (including both forward and backslashed paths, such as both
+ <code>sys/time.h</code> and <code>sys\time.h</code>) to ignore such
+ newer dependencies. Including local-install paths in a distributed
+ <code>.mak</code> file will cause the build to fail completely.</p>
+
+ <p>If you contribute back a patch that revises project files, we
+ must commit project files in Visual Studio 6.0 format. Changes
+ should be simple, with minimal compilation and linkage flags that
+ can be recognized by all Visual Studio environments.</p>
+
+
+
+ <h3><a name="installation" id="installation">Installation</a></h3>
+
+
+
+ <p>Once Apache has been compiled, it needs to be installed in
+ its server root directory. The default is the
+ <code>\Apache2</code> directory, of the same drive.</p>
+
+ <p>To build and install all the files into the desired folder
+ <em>dir</em> automatically, use one of the following
+ <code>nmake</code> commands:</p>
+
+ <div class="example"><p><code>
+ nmake /f Makefile.win installr INSTDIR=<em>dir</em><br />
+ nmake /f Makefile.win installd INSTDIR=<em>dir</em>
+ </code></p></div>
+
+ <p>The <em>dir</em> argument to <code>INSTDIR</code> provides
+ the installation directory; it can be omitted if Apache is
+ to be installed into <code>\Apache22</code> (of the current
+ drive).</p>
+
+
+
+ <h3><a name="projectcomponents-warn" id="projectcomponents-warn">Warning about building Apache from the development tree</a></h3>
+
+
+
+ <div class="note">Note only the <code>.dsp</code> files are maintained between <code>release</code>
+ builds. The <code>.mak</code> files are NOT regenerated, due to the tremendous
+ waste of reviewer's time. Therefore, you cannot rely on the <code>NMAKE</code>
+ commands above to build revised <code>.dsp</code> project files unless you
+ then export all <code>.mak</code> files yourself from the project. This is
+ unnecessary if you build from within the Microsoft
+ Developer Studio environment.</div>
+
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="cmake" id="cmake">Building httpd with cmake</a></h2>
+
+
+ <p>The primary documentation for this build mechanism is in the
+ <code>README.cmake</code> file in the source distribution. Refer to that file
+ for detailed instructions.</p>
+
+ <p>Building httpd with cmake requires building APR and APR-util separately.
+ Refer to their <code>README.cmake</code> files for instructions.</p>
+
+ <p>The primary limitations of the cmake-based build are inherited from the APR-util
+ project, and are listed below because of their impact on httpd:</p>
+
+ <ul>
+ <li>No cmake build for the APR-iconv subproject is available, and the
+ APR-util cmake build cannot consume an existing APR-iconv build. Thus,
+ <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> and possibly some third-party modules
+ cannot be used.</li>
+ <li>The cmake build for the APR-util subproject does not support most of the
+ optional DBM and DBD libraries supported by the included Visual Studio
+ project files. This limits the database backends supported by a number of
+ bundled and third-party modules.</li>
+ </ul>
+
+ </div></div>
+<div class="bottomlang">
+<p><span>Available Languages: </span><a href="../en/platform/win_compiling.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/platform/win_compiling.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</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 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/win_compiling.html';
+(function(w, d) {
+ if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+ d.write('<div id="comments_thread"><\/div>');
+ var s = d.createElement('script');
+ s.type = 'text/javascript';
+ s.async = true;
+ s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+ (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+ }
+ else {
+ d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+ }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2023 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>
+<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[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+ prettyPrint();
+}
+//--><!]]></script>
+</body></html> \ No newline at end of file