httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: httpd-docs-1.3/htdocs/manual cygwin.html index.html.en index.html.ja.jis install.html.en install.html.ja.jis invoking.html new_features_1_3.html.en stopping.html
Date Wed, 11 Jul 2001 14:42:35 GMT
martin      01/07/11 07:42:35

  Modified:    htdocs/manual index.html.en index.html.ja.jis
                        install.html.ja.jis invoking.html
                        new_features_1_3.html.en stopping.html
  Added:       htdocs/manual cygwin.html
  Add cygwin documentation and links; by Stipe Tolj <>
  Revision  Changes    Path
  1.50      +33 -32    httpd-docs-1.3/htdocs/manual/index.html.en
  Index: index.html.en
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/index.html.en,v
  retrieving revision 1.49
  retrieving revision 1.50
  diff -u -u -r1.49 -r1.50
  --- index.html.en	2001/02/17 05:22:44	1.49
  +++ index.html.en	2001/07/11 14:41:41	1.50
  @@ -73,11 +73,11 @@
   <tr><td align="center" bgcolor="#e9e9e9">
     <strong>Release Notes</strong>
  -<A HREF="new_features_1_3.html">New Features in Version 1.3</A>
  +<a href="new_features_1_3.html">New Features in Version 1.3</a>
  -<A HREF="upgrading_to_1_3.html">Upgrading to Version 1.3</A>
  +<a href="upgrading_to_1_3.html">Upgrading to Version 1.3</a>
  -<A HREF="LICENSE">Apache License</A>
  +<a href="LICENSE">Apache License</a>
  @@ -86,22 +86,22 @@
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Reference Manual</strong>
  -<A HREF="install.html">Compiling and Installing</A>
  +<a href="install.html">Compiling and Installing</a>
  -<A HREF="invoking.html">Starting</A>
  +<a href="invoking.html">Starting</a>
  -<A HREF="stopping.html">Stopping or Restarting</A>
  +<a href="stopping.html">Stopping or Restarting</a>
  -<A HREF="mod/directives.html">Run-time Configuration Directives</A>
  +<a href="mod/directives.html">Run-time Configuration Directives</a>
  -Modules: <A HREF="mod/index-bytype.html">By Type</A> or 
  -    <A HREF="mod/index.html">Alphabetical</A>
  +Modules: <a href="mod/index-bytype.html">By Type</a> or 
  +    <a href="mod/index.html">Alphabetical</a>
  -<A HREF="programs/">Server and Supporting Programs</A>
  +<a href="programs/">Server and Supporting Programs</a>
  -<A HREF="dso.html">Dynamic Shared Object (DSO) Support</A>
  +<a href="dso.html">Dynamic Shared Object (DSO) Support</a>
  -<A HREF="misc/API.html">The Apache API</A>
  +<a href="misc/API.html">The Apache API</a>
  @@ -109,15 +109,16 @@
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Platform Specific Notes</strong>
  -<A HREF="windows.html">Microsoft Windows</A>
  +<a href="windows.html">Microsoft Windows</a> |
  +<a href="cygwin.html">Cygwin</a>
  -<A HREF="netware.html">Novell Netware 5</A>
  +<a href="netware.html">Novell Netware 5</a>
  -<A HREF="mpeix.html">HP MPE/iX</A>
  +<a href="mpeix.html">HP MPE/iX</a>
  -<A HREF="unixware.html">UnixWare</A>
  +<a href="unixware.html">UnixWare</a>
  -<A HREF="readme-tpf.html">TPF</A>
  +<a href="readme-tpf.html">TPF</a>
  @@ -131,31 +132,31 @@
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Using the Apache HTTP Server</strong>
  -<A HREF="configuring.html">Configuration Files</A>
  +<a href="configuring.html">Configuration Files</a>
  -<a href="server-wide.html">Server-Wide Configuration</A>
  +<a href="server-wide.html">Server-Wide Configuration</a>
  -<A HREF="urlmapping.html">Mapping URLs to the Filesystem</A>
  +<a href="urlmapping.html">Mapping URLs to the Filesystem</a>
  -<A HREF="vhosts/index.html">Virtual Hosts</A>
  +<a href="vhosts/index.html">Virtual Hosts</a>
   <a href="howto/ssi.html">Server Side Includes</a>
   <a href="howto/cgi.html">Dynamic Content with CGI</a>
  -<A HREF="handler.html">Handlers</A>
  +<a href="handler.html">Handlers</a>
  -<A HREF="content-negotiation.html">Content negotiation</A>
  +<a href="content-negotiation.html">Content negotiation</a>
  -<A HREF="env.html">Environment Variables</A>
  +<a href="env.html">Environment Variables</a>
  -<A HREF="suexec.html">Using SetUserID Execution for CGI</A>
  +<a href="suexec.html">Using SetUserID Execution for CGI</a>
  -<A HREF="misc/perf-tuning.html">General Performance hints</A>
  +<a href="misc/perf-tuning.html">General Performance hints</a>
  -<A HREF="misc/security_tips.html">Security tips</A>
  +<a href="misc/security_tips.html">Security tips</a>
  -<A HREF="misc/rewriteguide.html">URL Rewriting Guide</A>
  +<a href="misc/rewriteguide.html">URL Rewriting Guide</a>
  @@ -163,15 +164,15 @@
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Other Topics</strong>
  -<A HREF="misc/FAQ.html">Frequently Asked Questions</A>
  +<a href="misc/FAQ.html">Frequently Asked Questions</a>
  -<A HREF="misc/tutorials.html">Tutorials</A>
  +<a href="misc/tutorials.html">Tutorials</a>
  -<A HREF="misc/">Other Notes</A>
  +<a href="misc/">Other Notes</a>
  1.3       +30 -29    httpd-docs-1.3/htdocs/manual/
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -u -r1.2 -r1.3
  ---	2001/02/28 10:45:36	1.2
  +++	2001/07/11 14:41:45	1.3
  @@ -66,11 +66,11 @@
   <tr><td align="center" bgcolor="#e9e9e9">
     <strong>Notes sur cette version</strong>
  -<A HREF="new_features_1_3.html">Nouvelles fonctionnalités de la version 1.3</A>
  +<a href="new_features_1_3.html">Nouvelles fonctionnalités de la version 1.3</a>
  -<A HREF="upgrading_to_1_3.html">Migrer vers la version 1.3</A>
  +<a href="upgrading_to_1_3.html">Migrer vers la version 1.3</a>
  -<A HREF="LICENSE">License Apache</A>
  +<a href="LICENSE">License Apache</a>
  @@ -79,35 +79,36 @@
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Manuel de référence</strong>
  -<A HREF="install.html">Compilation et installation</A>
  +<a href="install.html">Compilation et installation</a>
  -<A HREF="invoking.html">Démarrage</A>
  +<a href="invoking.html">Démarrage</a>
  -<A HREF="stopping.html">Arrêt et redémarrage</A>
  +<a href="stopping.html">Arrêt et redémarrage</a>
  -<A HREF="mod/directives.html">Directives de configuration de l'exécution</A>
  +<a href="mod/directives.html">Directives de configuration de l'exécution</a>
  -Modules: <A HREF="mod/index-bytype.html">par type</A> or 
  -    <A HREF="mod/index.html">par ordre alphabétique</A>
  +Modules: <a href="mod/index-bytype.html">par type</a> or 
  +    <a href="mod/index.html">par ordre alphabétique</a>
  -<A HREF="dso.html">Support des Objets partagés dynamiques (DSO)</A>
  +<a href="dso.html">Support des Objets partagés dynamiques (DSO)</a>
  -<A HREF="misc/API.html">L'API Apache</A>
  +<a href="misc/API.html">L'API Apache</a>
   <table border="0" cellpadding="4" cellspacing="0" bgcolor="#ffffff" width="280">
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Notes liées aux plates-formes</strong>
  -<A HREF="windows.html">Microsoft Windows</A>
  +<a href="windows.html">Microsoft Windows</a> |
  +<a href="cygwin.html">Cygwin</a>
  -<A HREF="netware.html">Novell Netware 5</A>
  +<a href="netware.html">Novell Netware 5</a>
  -<A HREF="mpeix.html">HP MPE/iX</A>
  +<a href="mpeix.html">HP MPE/iX</a>
  -<A HREF="unixware.html">UnixWare</A>
  +<a href="unixware.html">UnixWare</a>
  -<A HREF="readme-tpf.html">TPF</A>
  +<a href="readme-tpf.html">TPF</a>
  @@ -121,40 +122,40 @@
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Utilisation du serveur HTTP Apache</strong>
  -<A HREF="configuring.html">Fichiers de configuration</A>
  +<a href="configuring.html">Fichiers de configuration</a>
  -<a href="server-wide.html">Configuration globale du serveur</A>
  +<a href="server-wide.html">Configuration globale du serveur</a>
  -<A HREF="vhosts/index.html">Hôtes virtuels</A>
  +<a href="vhosts/index.html">Hôtes virtuels</a>
   <a href="howto/ssi.html">Inclusion côté serveur (SSI)</a>
   <a href="howto/cgi.html">Contenu dynamique avec les CGI</a>
  -<A HREF="handler.html">Handlers</A>
  +<a href="handler.html">Handlers</a>
  -<A HREF="content-negotiation.html">Négotiation de contenu</A>
  +<a href="content-negotiation.html">Négotiation de contenu</a>
  -<A HREF="env.html">Variables d'environnement</A>
  +<a href="env.html">Variables d'environnement</a>
  -<A HREF="suexec.html">Using SetUserID Execution for CGI</A>
  +<a href="suexec.html">Using SetUserID Execution for CGI</a>
  -<A HREF="misc/perf-tuning.html">Aides sur les performances générales</A>
  +<a href="misc/perf-tuning.html">Aides sur les performances générales</a>
  -<A HREF="misc/security_tips.html">Trucs sur la sécurité</A>
  +<a href="misc/security_tips.html">Trucs sur la sécurité</a>
  -<A HREF="misc/rewriteguide.html">Guide de réécriture d'URLs</A>
  +<a href="misc/rewriteguide.html">Guide de réécriture d'URLs</a>
   <table border="0" cellpadding="4" cellspacing="0" bgcolor="#ffffff" width="280">
   <tr><td align="center" bgcolor="#e9e9e9">
   <strong>Autres sujets</strong>
  -<A HREF="misc/FAQ.html">Foires aux questions</A>
  +<a href="misc/FAQ.html">Foires aux questions</a>
  -<A HREF="misc/tutorials.html">Tutoriels</A>
  +<a href="misc/tutorials.html">Tutoriels</a>
  -<A HREF="misc/">Autres notes</A>
  +<a href="misc/">Autres notes</a>
  1.8       +2 -1      httpd-docs-1.3/htdocs/manual/index.html.ja.jis
  Index: index.html.ja.jis
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/index.html.ja.jis,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -u -r1.7 -r1.8
  --- index.html.ja.jis	2001/01/23 23:18:27	1.7
  +++ index.html.ja.jis	2001/07/11 14:41:48	1.8
  @@ -107,7 +107,8 @@
   <tr><td align="center" bgcolor="#e9e9e9">
  -<a href="windows.html">Microsoft Windows</a>
  +<a href="windows.html">Microsoft Windows</a> |
  +<a href="cygwin.html">Cygwin</a>
   <a href="netware.html">Novell Netware 5</a>
  1.33      +1 -0      httpd-docs-1.3/htdocs/manual/install.html.en
  Index: install.html.en
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install.html.en,v
  retrieving revision 1.32
  retrieving revision 1.33
  diff -u -u -r1.32 -r1.33
  --- install.html.en	2001/03/28 21:25:41	1.32
  +++ install.html.en	2001/07/11 14:41:50	1.33
  @@ -23,6 +23,7 @@
   distribution. For compiling and installation on specific platforms, see</P>
   <LI><A HREF="windows.html">Using Apache with Microsoft Windows</A>
  +<LI><A HREF="cygwin.html">Using Apache with Cygwin</A>
   <LI><A HREF="netware.html">Using Apache with Novell Netware 5</A>
   <LI><A HREF="mpeix.html">Using Apache with HP MPE/iX</A>
   <LI><A HREF="unixware.html">Compiling Apache under UnixWare</A>
  1.3       +2 -0      httpd-docs-1.3/htdocs/manual/
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -u -r1.2 -r1.3
  ---	2001/03/28 21:25:41	1.2
  +++	2001/07/11 14:41:52	1.3
  @@ -33,6 +33,8 @@
         <li><a href="windows.html">Usar Apache con Microsoft
  +      <li><a href="cygwin.html">Usar Apache con Cygwin</a></li>
         <li><a href="netware.html">Usar Apache con Novell Netware
  1.4       +1 -0      httpd-docs-1.3/htdocs/manual/
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -u -r1.3 -r1.4
  ---	2001/03/28 21:25:41	1.3
  +++	2001/07/11 14:41:55	1.4
  @@ -25,6 +25,7 @@
   sur d'autres plates-formes, consultez </P>
   <LI><A HREF="windows.html">Utilisation d'Apache sur Microsoft Windows</A>
  +<LI><A HREF="cygwin.html">Utilisation d'Apache sur Cygwin</A>
   <LI><A HREF="netware.html">Utilisation d'Apache sur Novell Netware 5</A>
   <LI><A HREF="mpeix.html">Utilisation d'Apache sur HP MPE/iX</A>
   <LI><A HREF="unixware.html">Utilisation d'Apache sur UnixWare</A>
  1.6       +1 -0      httpd-docs-1.3/htdocs/manual/install.html.ja.jis
  Index: install.html.ja.jis
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install.html.ja.jis,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -u -r1.5 -r1.6
  --- install.html.ja.jis	2001/05/17 03:38:50	1.5
  +++ install.html.ja.jis	2001/07/11 14:41:58	1.6
  @@ -25,6 +25,7 @@
   <LI><A HREF="windows.html">Microsoft Windows $B>e$G(B Apache $B$r;HMQ$9$k(B</A>
  +<LI><A HREF="cygwin.html">Cygwin $B>e$G(B Apache $B$r;HMQ$9$k(B</A>
   <LI><A HREF="netware.html">Novell Netware 5 $B>e$G(B Apache $B$r;HMQ$9$k(B</A>
   <LI><A HREF="mpeix.html">HP MPE/iX $B>e$G(B Apache $B$r;HMQ$9$k(B</A>
   <LI><A HREF="unixware.html">UnixWare $B>e$G(B Apache $B$r%3%s%Q%$%k$9$k(B</A>
  1.35      +2 -1      httpd-docs-1.3/htdocs/manual/invoking.html
  Index: invoking.html
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/invoking.html,v
  retrieving revision 1.34
  retrieving revision 1.35
  diff -u -u -r1.34 -r1.35
  --- invoking.html	2001/01/29 02:42:21	1.34
  +++ invoking.html	2001/07/11 14:41:59	1.35
  @@ -31,7 +31,8 @@
   <h2><a name="windows">Starting Apache On Windows</a></h2>
   <p>On Windows, Apache is normally run as a service on Windows NT, or
  -as a console application on Windows 95. For details, see <A
  +as a console application on Windows 95. This does not apply in its full extend
  +for the Cygwin platform. For details, see <A
   HREF="windows.html#run">running Apache for Windows</A>.</p>
   <h2><a name="unix">Starting Apache on Unix</a></h2>
  1.85      +5 -0      httpd-docs-1.3/htdocs/manual/new_features_1_3.html.en
  Index: new_features_1_3.html.en
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/new_features_1_3.html.en,v
  retrieving revision 1.84
  retrieving revision 1.85
  diff -u -u -r1.84 -r1.85
  --- new_features_1_3.html.en	2000/12/14 15:20:42	1.84
  +++ new_features_1_3.html.en	2001/07/11 14:42:03	1.85
  @@ -47,6 +47,11 @@
       remains experimental.  All versions of Apache running on Windows prior 
       to 1.3.15 should be considered beta quality releases.
  +<DT><STRONG><A HREF="cygwin.html">Support for Cygwin</A></STRONG>
  +<DD>Apache now supports the Cygwin platform for the Windows NT and Windows 2000 
  +    operating systems. The Cygwin versions should be considered as stable
  +    and reliable as the <A HREF="windows.html">Windows</A> native counterpart.
   <DT><STRONG><A HREF="netware.html">Support for NetWare 5.x</A></STRONG>
   <DD>Apache now experimentally supports the NetWare 5.x operating systems.
  1.19      +1 -1      httpd-docs-1.3/htdocs/manual/stopping.html
  Index: stopping.html
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/stopping.html,v
  retrieving revision 1.18
  retrieving revision 1.19
  diff -u -u -r1.18 -r1.19
  --- stopping.html	2001/02/27 21:42:28	1.18
  +++ stopping.html	2001/07/11 14:42:07	1.19
  @@ -16,7 +16,7 @@
   <H1 ALIGN="CENTER">Stopping and Restarting Apache</H1>
   <P>This document covers stopping and restarting Apache on Unix
  -only. Windows users should see <A HREF="windows.html#signal">Signalling
  +and Cygwin only. Windows users should see <A HREF="windows.html#signal">Signalling
   Apache when running</A>.</P>
   <P>You will notice many <CODE>httpd</CODE> executables running on your
  1.5       +1 -1      httpd-docs-1.3/htdocs/manual/
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -u -r1.4 -r1.5
  ---	2001/02/28 11:01:14	1.4
  +++	2001/07/11 14:42:09	1.5
  @@ -13,7 +13,7 @@
   <p>Ce document décrit l'arrêt et le
  -redémarrage d'Apache sur Unix seulement. Les utilisateurs
  +redémarrage d'Apache sur Unix et Cygwin seulement. Les utilisateurs
   de Windows sont invités à lire le paragraphe <a
   href="windows.html#signal">signaler à Apache en cours
  1.1                  httpd-docs-1.3/htdocs/manual/cygwin.html
  Index: cygwin.html
  <title>Using Apache with Cygwin</title>
  <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
  <!--#include virtual="header.html" -->
  <h1 align="CENTER"><a name="help">Using Apache With Cygwin</a></h1>
  <p>This document explains how to install, configure and run Apache 1.3 under
     the <a href="">Cygwin</a> platform for Microsoft
     Windows. Cygwin is a POSIX.1 emulation layer for Microsoft Windows 32-bit
     operating systems.
  <p>The Apache Group does not guarantee that this software will work as
     documented, or even at all. If you find any bugs, please document them on
     our <a href="">bug reporting page.</a>
  <p>Latest development news, pre-compiled distribution binaries and third-party
     modules as DLLs may be found at
     <a href=""></a>.
       Contributions are highly welcome (please see
     <a href="">TODO</a> list), please
     submit your code or suggestions to the bug report page, or join the mailing list.</p>
  <p>The <a href="windows.html">Win32 port</a> of Apache is built on its
     custom code within Apache to assure interoperability with the Windows
     operating systems.  While it is considered release quality, it is slower
     and less thoroughly tested than the Unix ports.  The Cygwin alternative
     uses the well tested unix code by using the Cygwin portability layer for
     Unix emulation.  The Cygwin port may suffer from gaps in security or
     reliability due to the interaction of the Cygwin compatibility layer to
     the native Windows API.</p>
  <p>The <a href="windows.html">Win32 port</a> will be more familiar to
     Windows users.  The Cygwin port will be more familiar to Unix admins and
     developers, including the Apache/Unix build environment.  Due to these
     two different code bases, the security and reliability of the two ports
     are unrelated to each other.  The Win32 port should be considered the
     more secure of the two at this time.  The Win32 port is recommended for
     most Windows users, however the Cygwin port offers an extra layer of
     compatibility for Unix developers.</p>
  <p>Apache still performs best, and is most reliable on Unix platforms. First
     benchmarks have shown that the same Apache setup on Cygwin performs about
     30% slower than the corresponding native Windows version.</p>
  <p>Most of this document assumes that you have a working Cygwin installation
     and want to compile Apache yourself from the orginal distribution
    <li><a href="#hist">History of Apache for Cygwin</a>
    <li><a href="#diff">Differences to Apache for Windows (native)</a>
    <li><a href="#req">Requirements</a>
    <li><a href="#down">Downloading Apache for Cygwin</a>
    <li><a href="#inst">Configuring and installing Apache for Cygwin</a>
    <li><a href="#run">Running Apache for Cygwin</a>
    <li><a href="#serv">Running Apache for Cygwin as a Service</a>
  <h2><a name="hist">History of Apache for Cygwin</a></h2>
  <p>Cygwin support for Apache has been developed since Apache 1.2.6 and
     Cygwin b18.
  <p>Due to licensing issues there has not been an official binary distribution
     until Red Hat Inc. (former Cygnus Solutions Inc.) changed their Cygwin license
     to ensure compiled executables do not fall under GPL license if the distributed
     software is considered as open source.
  <p>Cygwin is supported in the official source distributions from Apache 1.3.20
     and on. Pre-compiled binaries for the Cygwin platform (without the
     <code>cygwin1.dll</code>) will be supplied at
     <a href=""></a> for
     released version.
  <h2><a name="diff">Differences to Apache for Windows (native)</a></h2>
  <p>Both versions, Apache for Windows and Apache for Cygwin are designed to run
     on the same operating systems, the Windows NT and Windows 2000 family. But
     there are considerable differences for those.
  <p>While Apache for Windows is a native Windows port, Apache for Cywin relies on
     the Cygwin POSIX.1 emulation layer provided by the <code>cygwin1.dll</code>
     dynamic library to fake a Unix compliant enviroment. Therefore we consider
     Apache for Cygwin more closer to the Unix side then to the Windows side, even
     while it runs on Windows.
  <p>Most significant differences are the ammount of changes to the source code
     needed to compile and run Apache on the Cygwin platform. While the native
     Windows port needs huge changes and platform specific additions, the Cygwin
     based port changes are very small and most of the present source code can
     be used without major changes on the Cygwin platform.
  <p><strong>When to use Apache for Cygwin and/or Apache for Windows?</strong><br>
     Apache for Cygwin is considered to be very useful if you want a seamless
     transition from Unix sytems to Windows systems for your HTTP services.
  <p>If you are using Windows NT or Windows 2000 for development and office
     purposes, but your productive HTTP server environments are Unix based systems
     you may use Apache for Cygwin to develop on Windows and simply copy the whole
     Apache configurations (i.e. <code>httpd.conf</code>) and Perl
     (<code>mod_perl</code>), PHP (<code>mod_php</code>) or Python
     (<code>mod_snake</code>) applications to your productive Unix systems.
  <p><strong>What about modules (<code>mod_foo</code>) for Apache
for Cygwin?</strong><br>
     Apache for Cygwin can be build with most of the available Apache modules with
     no or very few effort in changes. Most popular modules have been compiled and
     tested with Apache for Cygwin, including <code>mod_dav, mod_ssl, mod_php, mod_perl,
     mod_gzip, mod_jserv</code>.
  <p>While there are developers that support the Windows native port of Apache, very
     fiew module developers do. That is why it is usually very hard to make a Unix
     based Apache installation with different modules work the same way on the
     Windows side using the native port. Apache for Cygwin makes it possible.
  <p><strong>What are the differences for the configuration files?</strong><br>
     While the Apache for Windows port uses Windows native path names to refer a
     specific file or directory, like
    # httpd.conf (for Windows)
    DocumentRoot "c:/apache/htdocs"
     Apache for Cygwin can use unmodified
     POSIX style path names like
    # httpd.conf (for Cygwin)
    DocumentRoot "/usr/local/apache/htdocs"
  <p><strong>What about performance?</strong><br>
     Apache for Cygwin is and should be considered not as performative as Apache
     for Windows on the same hardware architecture.
  <p>This is trivial, because Cygwin emulates a Unix enviroment on a
     "foreign" operating system, while Apache for Windows runs in its own native
     environment. First benchmark results have shown that Apache for Cygwin is
     about 30% slower then his native Apache for Windows counterpart.
  <h2><a name="req">Requirements</a></h2>
  <p>This Apache 1.3 port for Cygwin is designed to run on Windows NT 4.0 and
     Windows 2000, <strong>NOT</strong> on Windows 95 and 98. Windows NT 4.0
     and Windows 2000 have both been successfully tested and approved.
     In all cases TCP/IP networking must be installed.</p>
  <p>Cygwin 1.x is required to compile and run this version. Cygwin 1.1.8
     and 1.3.2 have been tested and approved on both supported OS.
  <p><strong>Note:</strong>If you want to compile shared DLL modules using
     <a href="programs/apxs.html"><code>apxs</code></a> you will need
     patched version of <code>ld.exe</code> with <code>--auto-import</code>
     support which can be found
     <a href="">here</a>.</p>
  <h2><a name="down">Downloading Apache for Cygwin</a></h2>
  <p>The Cygwin platform is supported out-of-the-box for Apache 1.3.20 and
     on. This means there is no extra download required for the Cygwin
     platform. The latest version of Apache can be found on the
     Apache web server at <a href=""></a>.This will list the current release,
     any more recent alpha or beta-test releases, together with details
     of mirror web and anonymous FTP sites.</p>
  <h2><a name="inst">Configuring and installing Apache for Cygwin</a></h2>
  <p>Apache on Cygwin is configured and compiled the same way as on Unix
     systems. Refer to the general <a href="configuring.html">configuration</a>
     and <a href="install.html">installation</a> documents for details.
  <p>There are three ways in configuring and building Apache for Cygwin,
     depending on how additional Apache modules should be used:</p>
  <li><strong>Static linked version</strong>
  <p>To build a static linked version of <code>httpd</code> including
     additional modules you will have to give the following statements to
     the shell:
    $ cd apache_1.3.x
    $ ./configure [--enable-module=<i>module</i>|--add-module=<i>/path/to/module</i>]
    $ make
       This will produce the required extra libaries or object files for
     <i>module</i> and link everything to <code>src/httpd.exe</code>.</p>
  <li><strong>Shared core DLL linked version (one for all version)</strong>
  <p>To build a DLL version of <code>httpd</code> including additional
     modules you have to give the following statements to the shell:
    $ cd apache_1.3.x
    $ ./configure --enable-rule=SHARED_CORE \
    $ make
    $ make install
    This will produce the required extra libraries or object files which hold all
    static linked code. Then <code>dllwrap</code> and <code>dlltool</code>
    export all of those (including any added extra module code) to the shared
    <code>libhttpd.dll</code> and create the <code>libhttpd.a</code>
    library which is required for linking <code>httpd.exe</code>.</p>
  <li><strong>Shared DLL modules linked version</strong>
  <p>This method is currently <strong>ONLY</strong> supported using
     a patched version of <code>ld.exe</code>. Please see the
     <a href="#req">requirements</a> section on where to get that version.
  <p>To build a dynamic loadable DLL version of <code>httpd</code> which
     load DLL modules on the fly while runtime you have to proceed as follows:</p>
  <li><p>First build Apache's shared core giving the following statements
    to the shell:
    $ cd apache_1.3.x
    $ ./configure --enable-rule=SHARED_CORE --enable-module=so \
    $ make
    $ make install
    Now the <code>make</code> process will break when trying to compile the
    shared module defined using <code>--enable-shared</code>. You will have
    to use a work-around, due to the fact that currently there is no
    <code>src/libhttpd.dll</code> build that is required to link against the
    shared module.</p>
  <li>Place an empty file to satisfy <code>make</code> and
    restart the <code>make</code> process again:
    $ touch <i>/path/to/</i>
    $ make
    $ make install
    This will build the core dynamic library <code>libhttpd.dll</code> as
    described in the previous build alternative.</p>
  <li> Now we have to link the shared module against that library:
    $ cd <i>/path/to/module</i>
    $ gcc --shared -o <i>module</i>.dll <i>module</i>.lo <i>/path/to/libhttpd.dll</i>
    The build shared DLL module has to be placed to Apache's installation
    <code>bin</code>directory where <code>libhttpd.dll</code> goes
  <li>Add configuration directives to <code>conf/httpd.conf</code> to load
  and activate shared DLL modules while runtime:
    # httpd.conf
    LoadModule foo_module   bin/mod_foo.dll
    AddModule mod_foo.c
     The above steps have to be repeated for each shared DLL module you want
     to create.</p>
  <li><strong>Using apxs to create shared DLL modules</strong>
  <p>To make the extension process of your <code>httpd</code> using
     shared DLL modules easier you may use the
     <a href="programs/apxs.html"><code>apxs</code></a> tool.
  <p>Make sure you have configured <code>$CFG_LDFLAGS_SHLIB</code> within
     <code>apxs</code> to include the <code>--shared</code> directive
     the path to the shared code DLL <code>libhttpd.dll</code>.
  <p>Now you shoud be able to create a shared DLL module from a <code>mod_foo.c</code>
     source code file with:
    $ apxs -c mod_foo.c -o mod_foo.dll
     Place the created DLL file to Apache's <code>bin</code> directory, so
     the <code>dlopen()</code> function within the compiled in <code>mod_so.c</code>
     module can find and load it while runtime.
  <h2><a name="inst">Running Apache for Cygwin</a></h2>
  <p>Apache on Cygwin can be started and stoped in the same manner
     as on Unix systems. You may also use the
     <a href="programs/apachctl.html"><code>apachectl</code></a> tool
     starting and stoping Apache.
  <li><strong>Starting Apache</strong>
  <p>If installed to the default Apache layout directory you can start
     <code>httpd</code> as follows:
    $ /usr/local/apache/bin/httpd
     An explicit background <code>&</code> indicator is not required. The
     resulting parent process is detached from the current terminal.
     Check the global <code>error_log</code> to see if Apache has started
     cleanly without any major problems.</p>
  <li><strong>Stopping Apache</strong>
  <p>To stop Apache send at least a  <code>SIGTERM</code> sginal to the
     parent <code>httpd</code> process:
    $ kill -TERM `cat /usr/local/apache/logs/`
  <li><strong>Gracefully re-starting Apache</strong>
  <p>In order to update configuration directives and hence reload the given
     <code>httpd.conf</code> configuration file you may send a <code>SIGHUP</code>
     to the parent <code>httpd</code> process:
    $ kill -HUP `cat /usr/local/apache/logs/`
  <h2><a name="serv">Running Apache for Cygwin as a Service</a></h2>
  <p>Apache on Cygwin can be invoked as Windows NT or Windows 2000 service.
     Cygwin has its own <code>cygrunsrv.exe</code> facility to define, remove,
     start and stop services as follows:
  <li><strong>Installing Apache as a new Service</strong>
  <p>Use the following statement to install the <code>httpd.exe</code> as
a new
    $ cygrunsrv -I <i>service_name</i>-p /usr/local/apache/bin/httpd.exe [-a <i>arguments</i>]
        [-e <i>VAR=VALUE</i>] [-t auto|manual] [-u <i>user</i>] [-w
    Where <code>-a</code> is used to pass command line arguments to
    <code>httpd.exe</code>, like <code>-DFOO</code> defines and <code>-e</code>
    is used to pass environment variables to the starting environment. If necessary
    you may use the <code>-t</code> options to set the starting type of the service.
    If you want the new service to run under a different user you will have to supply
    necessary arguments for the <code>-u</code> and <code>-w</code>
  <li><strong>Starting Apache as a Service</strong>
  <p>After the new service is installed it can be started using the following
    $ cygrunsrv -S <i>service_name</i>
    Check your process table and global <code>error_log</code> file to ensure
    has started without any major problems.</p>
  <li><strong>Stoping Apache Service</strong>
  <p>A running Apache service may be stopped using the following comand:
    $ cygrunsrv -E <i>service_name</i>
    This will stop all running <code>httpd.exe</code> processes and shutdown the
    service for the machine.</p>
  <li><strong>Removing Apache Service</strong>
  <p>An installed Apache service may be removed from the internal service invokation
     table of Windows NT or Windows 2000 using the following comand:
    $ cygrunsrv -R <i>service_name</i>
     This will remove your previously defined and installed service from the machine.</p>
  <p>Please refer to the corresponding <code>man</code> page of <code>cygrunsrv</code>
     the Cygwin mailing list for further details of how services are invoked.</p>
  <p>Any additional contributions to this document and the Cygwin support
     for Apache are highly welcome. Please send them to Stipe Tolj
     <a href="">&lt;;</a>.</p>
  <!--#include virtual="footer.html" -->

View raw message