martin 01/07/11 07:42:35
Modified: htdocs/manual index.html.en index.html.fr index.html.ja.jis
install.html.en install.html.es install.html.fr
install.html.ja.jis invoking.html
new_features_1_3.html.en stopping.html
stopping.html.fr
Added: htdocs/manual cygwin.html
Log:
Add cygwin documentation and links; by Stipe Tolj <[EMAIL PROTECTED]>
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>
</td></tr><tr><td>
-<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>
</td></tr><tr><td>
-<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>
</td></tr><tr><td>
-<A HREF="LICENSE">Apache License</A>
+<a href="LICENSE">Apache License</a>
</td></tr>
</table>
@@ -86,22 +86,22 @@
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Reference Manual</strong>
</td></tr><tr><td>
-<A HREF="install.html">Compiling and Installing</A>
+<a href="install.html">Compiling and Installing</a>
</td></tr><tr><td>
-<A HREF="invoking.html">Starting</A>
+<a href="invoking.html">Starting</a>
</td></tr><tr><td>
-<A HREF="stopping.html">Stopping or Restarting</A>
+<a href="stopping.html">Stopping or Restarting</a>
</td></tr><tr><td>
-<A HREF="mod/directives.html">Run-time Configuration Directives</A>
+<a href="mod/directives.html">Run-time Configuration Directives</a>
</td></tr><tr><td>
-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>
</td></tr><tr><td>
-<A HREF="programs/">Server and Supporting Programs</A>
+<a href="programs/">Server and Supporting Programs</a>
</td></tr><tr><td>
-<A HREF="dso.html">Dynamic Shared Object (DSO) Support</A>
+<a href="dso.html">Dynamic Shared Object (DSO) Support</a>
</td></tr><tr><td>
-<A HREF="misc/API.html">The Apache API</A>
+<a href="misc/API.html">The Apache API</a>
</td></tr></table>
<p>
@@ -109,15 +109,16 @@
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Platform Specific Notes</strong>
</td></tr><tr><td>
-<A HREF="windows.html">Microsoft Windows</A>
+<a href="windows.html">Microsoft Windows</a> |
+<a href="cygwin.html">Cygwin</a>
</td></tr><tr><td>
-<A HREF="netware.html">Novell Netware 5</A>
+<a href="netware.html">Novell Netware 5</a>
</td></tr><tr><td>
-<A HREF="mpeix.html">HP MPE/iX</A>
+<a href="mpeix.html">HP MPE/iX</a>
</td></tr><tr><td>
-<A HREF="unixware.html">UnixWare</A>
+<a href="unixware.html">UnixWare</a>
</td></tr><tr><td>
-<A HREF="readme-tpf.html">TPF</A>
+<a href="readme-tpf.html">TPF</a>
</td></tr></table>
</td>
@@ -131,31 +132,31 @@
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Using the Apache HTTP Server</strong>
</td></tr><tr><td>
-<A HREF="configuring.html">Configuration Files</A>
+<a href="configuring.html">Configuration Files</a>
</td></tr><tr><td>
-<a href="server-wide.html">Server-Wide Configuration</A>
+<a href="server-wide.html">Server-Wide Configuration</a>
</td></tr><tr><td>
-<A HREF="urlmapping.html">Mapping URLs to the Filesystem</A>
+<a href="urlmapping.html">Mapping URLs to the Filesystem</a>
</td></tr><tr><td>
-<A HREF="vhosts/index.html">Virtual Hosts</A>
+<a href="vhosts/index.html">Virtual Hosts</a>
</td></tr><tr><td>
<a href="howto/ssi.html">Server Side Includes</a>
</td></tr><tr><td>
<a href="howto/cgi.html">Dynamic Content with CGI</a>
</td></tr><tr><td>
-<A HREF="handler.html">Handlers</A>
+<a href="handler.html">Handlers</a>
</td></tr><tr><td>
-<A HREF="content-negotiation.html">Content negotiation</A>
+<a href="content-negotiation.html">Content negotiation</a>
</td></tr><tr><td>
-<A HREF="env.html">Environment Variables</A>
+<a href="env.html">Environment Variables</a>
</td></tr><tr><td>
-<A HREF="suexec.html">Using SetUserID Execution for CGI</A>
+<a href="suexec.html">Using SetUserID Execution for CGI</a>
</td></tr><tr><td>
-<A HREF="misc/perf-tuning.html">General Performance hints</A>
+<a href="misc/perf-tuning.html">General Performance hints</a>
</td></tr><tr><td>
-<A HREF="misc/security_tips.html">Security tips</A>
+<a href="misc/security_tips.html">Security tips</a>
</td></tr><tr><td>
-<A HREF="misc/rewriteguide.html">URL Rewriting Guide</A>
+<a href="misc/rewriteguide.html">URL Rewriting Guide</a>
</td></tr></table>
<p>
@@ -163,15 +164,15 @@
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Other Topics</strong>
</td></tr><tr><td>
-<A HREF="misc/FAQ.html">Frequently Asked Questions</A>
+<a href="misc/FAQ.html">Frequently Asked Questions</a>
</td></tr><tr><td>
-<A HREF="misc/tutorials.html">Tutorials</A>
+<a href="misc/tutorials.html">Tutorials</a>
</td></tr><tr><td>
-<A HREF="misc/">Other Notes</A>
+<a href="misc/">Other Notes</a>
</td></tr></table>
</td>
</tr>
-</table>
+</table></p>
</div>
1.3 +30 -29 httpd-docs-1.3/htdocs/manual/index.html.fr
Index: index.html.fr
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/index.html.fr,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -u -r1.2 -r1.3
--- index.html.fr 2001/02/28 10:45:36 1.2
+++ index.html.fr 2001/07/11 14:41:45 1.3
@@ -66,11 +66,11 @@
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Notes sur cette version</strong>
</td></tr><tr><td>
-<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>
</td></tr><tr><td>
-<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>
</td></tr><tr><td>
-<A HREF="LICENSE">License Apache</A>
+<a href="LICENSE">License Apache</a>
</td></tr>
</table>
@@ -79,35 +79,36 @@
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Manuel de r�f�rence</strong>
</td></tr><tr><td>
-<A HREF="install.html">Compilation et installation</A>
+<a href="install.html">Compilation et installation</a>
</td></tr><tr><td>
-<A HREF="invoking.html">D�marrage</A>
+<a href="invoking.html">D�marrage</a>
</td></tr><tr><td>
-<A HREF="stopping.html">Arr�t et red�marrage</A>
+<a href="stopping.html">Arr�t et red�marrage</a>
</td></tr><tr><td>
-<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>
</td></tr><tr><td>
-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>
</td></tr><tr><td>
-<A HREF="dso.html">Support des Objets partag�s dynamiques (DSO)</A>
+<a href="dso.html">Support des Objets partag�s dynamiques (DSO)</a>
</td></tr><tr><td>
-<A HREF="misc/API.html">L'API Apache</A>
+<a href="misc/API.html">L'API Apache</a>
</td></tr></table>
<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>
</td></tr><tr><td>
-<A HREF="windows.html">Microsoft Windows</A>
+<a href="windows.html">Microsoft Windows</a> |
+<a href="cygwin.html">Cygwin</a>
</td></tr><tr><td>
-<A HREF="netware.html">Novell Netware 5</A>
+<a href="netware.html">Novell Netware 5</a>
</td></tr><tr><td>
-<A HREF="mpeix.html">HP MPE/iX</A>
+<a href="mpeix.html">HP MPE/iX</a>
</td></tr><tr><td>
-<A HREF="unixware.html">UnixWare</A>
+<a href="unixware.html">UnixWare</a>
</td></tr><tr><td>
-<A HREF="readme-tpf.html">TPF</A>
+<a href="readme-tpf.html">TPF</a>
</td></tr></table>
</td>
@@ -121,40 +122,40 @@
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Utilisation du serveur HTTP Apache</strong>
</td></tr><tr><td>
-<A HREF="configuring.html">Fichiers de configuration</A>
+<a href="configuring.html">Fichiers de configuration</a>
</td></tr><tr><td>
-<a href="server-wide.html">Configuration globale du serveur</A>
+<a href="server-wide.html">Configuration globale du serveur</a>
</td></tr><tr><td>
-<A HREF="vhosts/index.html">H�tes virtuels</A>
+<a href="vhosts/index.html">H�tes virtuels</a>
</td></tr><tr><td>
<a href="howto/ssi.html">Inclusion c�t� serveur (SSI)</a>
</td></tr><tr><td>
<a href="howto/cgi.html">Contenu dynamique avec les CGI</a>
</td></tr><tr><td>
-<A HREF="handler.html">Handlers</A>
+<a href="handler.html">Handlers</a>
</td></tr><tr><td>
-<A HREF="content-negotiation.html">N�gotiation de contenu</A>
+<a href="content-negotiation.html">N�gotiation de contenu</a>
</td></tr><tr><td>
-<A HREF="env.html">Variables d'environnement</A>
+<a href="env.html">Variables d'environnement</a>
</td></tr><tr><td>
-<A HREF="suexec.html">Using SetUserID Execution for CGI</A>
+<a href="suexec.html">Using SetUserID Execution for CGI</a>
</td></tr><tr><td>
-<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>
</td></tr><tr><td>
-<A HREF="misc/security_tips.html">Trucs sur la s�curit�</A>
+<a href="misc/security_tips.html">Trucs sur la s�curit�</a>
</td></tr><tr><td>
-<A HREF="misc/rewriteguide.html">Guide de r��criture d'URLs</A>
+<a href="misc/rewriteguide.html">Guide de r��criture d'URLs</a>
</td></tr></table>
<table border="0" cellpadding="4" cellspacing="0" bgcolor="#ffffff"
width="280">
<tr><td align="center" bgcolor="#e9e9e9">
<strong>Autres sujets</strong>
</td></tr><tr><td>
-<A HREF="misc/FAQ.html">Foires aux questions</A>
+<a href="misc/FAQ.html">Foires aux questions</a>
</td></tr><tr><td>
-<A HREF="misc/tutorials.html">Tutoriels</A>
+<a href="misc/tutorials.html">Tutoriels</a>
</td></tr><tr><td>
-<A HREF="misc/">Autres notes</A>
+<a href="misc/">Autres notes</a>
</td></tr></table>
</td>
</tr>
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">
<strong>$B%W%i%C%H%U%)!<%`8GM-$N>pJs(B</strong>
</td></tr><tr><td>
-<a href="windows.html">Microsoft Windows</a>
+<a href="windows.html">Microsoft Windows</a> |
+<a href="cygwin.html">Cygwin</a>
</td></tr><tr><td>
<a href="netware.html">Novell Netware 5</a>
</td></tr><tr><td>
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>
<UL>
<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/install.html.es
Index: install.html.es
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install.html.es,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -u -r1.2 -r1.3
--- install.html.es 2001/03/28 21:25:41 1.2
+++ install.html.es 2001/07/11 14:41:52 1.3
@@ -33,6 +33,8 @@
<li><a href="windows.html">Usar Apache con Microsoft
Windows</a></li>
+ <li><a href="cygwin.html">Usar Apache con Cygwin</a></li>
+
<li><a href="netware.html">Usar Apache con Novell Netware
5</a></li>
1.4 +1 -0 httpd-docs-1.3/htdocs/manual/install.html.fr
Index: install.html.fr
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install.html.fr,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -u -r1.3 -r1.4
--- install.html.fr 2001/03/28 21:25:41 1.3
+++ install.html.fr 2001/07/11 14:41:55 1.4
@@ -25,6 +25,7 @@
sur d'autres plates-formes, consultez </P>
<UL>
<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 @@
$B%$%s%9%H!<%k$K$D$$$F$O!"0J2<$N9`L\$r;2>H$7$F$/[EMAIL PROTECTED](B</P>
<UL>
<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
system,
1.5 +1 -1 httpd-docs-1.3/htdocs/manual/stopping.html.fr
Index: stopping.html.fr
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/stopping.html.fr,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -u -r1.4 -r1.5
--- stopping.html.fr 2001/02/28 11:01:14 1.4
+++ stopping.html.fr 2001/07/11 14:42:09 1.5
@@ -13,7 +13,7 @@
d'Apache</h1>
<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
d'ex�cution</a>.</p>
1.1 httpd-docs-1.3/htdocs/manual/cygwin.html
Index: cygwin.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<title>Using Apache with Cygwin</title>
</head>
<!-- Background white, links blue (unvisited), navy (visited), red (active)
-->
<body
bgcolor="#ffffff"
text="#000000"
link="#0000ff"
vlink="#000080"
alink="#ff0000"
>
<!--#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="http://www.cygwin.com";>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="http://www.apache.org/bug_report.html";>bug reporting page.</a>
<p>Latest development news, pre-compiled distribution binaries and third-party
modules as DLLs may be found at
<a href="http://apache.dev.wapme.net/";>http://apache.dev.wapme.net/</a>.
Contributions are highly welcome (please see
<a href="http://apache.dev.wapme.net/TODO.cygwin";>TODO</a> list), please
submit your code or suggestions to the bug report page, or join the
[email protected] mailing list.</p>
<p>The <a href="windows.html">Win32 port</a> of Apache is built on its own,
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 most
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
sources.</p>
<hr>
<ul>
<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>
</ul>
<hr>
<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="http://www.apache.org/httpd";>http://www.apache.org/httpd</a> for
each
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
<pre>
# httpd.conf (for Windows)
DocumentRoot "c:/apache/htdocs"
</pre>
Apache for Cygwin can use unmodified
POSIX style path names like
<pre>
# httpd.conf (for Cygwin)
DocumentRoot "/usr/local/apache/htdocs"
</pre>
<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 a
patched version of <code>ld.exe</code> with <code>--auto-import</code>
support which can be found
<a href="http://sourceforge.net/projects/kde-cygwin/";>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="http://www.apache.org/httpd";>
http://www.apache.org/httpd</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>
<ul>
<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:
<pre>
$ cd apache_1.3.x
$ ./configure
[--enable-module=<i>module</i>|--add-module=<i>/path/to/module</i>]
$ make
</pre>
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:
<pre>
$ cd apache_1.3.x
$ ./configure --enable-rule=SHARED_CORE \
[--enable-module=<i>module</i>|--add-module=<i>/path/to/module</i>]
$ make
$ make install
</pre>
This will produce the required extra libraries or object files which hold
all
static linked code. Then <code>dllwrap</code> and <code>dlltool</code> will
export all of those (including any added extra module code) to the shared
<code>libhttpd.dll</code> and create the <code>libhttpd.a</code> import
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 can
load DLL modules on the fly while runtime you have to proceed as
follows:</p>
<ul>
<li><p>First build Apache's shared core giving the following statements
to the shell:
<pre>
$ cd apache_1.3.x
$ ./configure --enable-rule=SHARED_CORE --enable-module=so \
[--enable-module=<i>module</i>|--add-module=<i>/path/to/module</i>] \
[--enable-shared=<i>module</i>]
$ make
$ make install
</pre>
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:
<pre>
$ touch <i>/path/to/module.so</i>
$ make
$ make install
</pre>
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:
<pre>
$ cd <i>/path/to/module</i>
$ gcc --shared -o <i>module</i>.dll <i>module</i>.lo
<i>/path/to/libhttpd.dll</i>
</pre>
The build shared DLL module has to be placed to Apache's installation
<code>bin</code>directory where <code>libhttpd.dll</code> goes too.</p>
<li>Add configuration directives to <code>conf/httpd.conf</code> to load
and activate shared DLL modules while runtime:
<pre>
# httpd.conf
[...]
LoadModule foo_module bin/mod_foo.dll
AddModule mod_foo.c
[...]
</pre>
</ul>
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 and
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:
<pre>
$ apxs -c mod_foo.c -o mod_foo.dll
</pre>
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.
</ul>
<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 for
starting and stoping Apache.
<ul>
<li><strong>Starting Apache</strong>
<p>If installed to the default Apache layout directory you can start
<code>httpd</code> as follows:
<pre>
$ /usr/local/apache/bin/httpd
</pre>
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:
<pre>
$ kill -TERM `cat /usr/local/apache/logs/httpd.pid`
</pre>
<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:
<pre>
$ kill -HUP `cat /usr/local/apache/logs/httpd.pid`
</pre>
</ul>
<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:
<ul>
<li><strong>Installing Apache as a new Service</strong>
<p>Use the following statement to install the <code>httpd.exe</code> as a new
service:
<pre>
$ 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
<i>passwd</i>]
</pre>
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> options.</p>
<li><strong>Starting Apache as a Service</strong>
<p>After the new service is installed it can be started using the following
command:
<pre>
$ cygrunsrv -S <i>service_name</i>
</pre>
Check your process table and global <code>error_log</code> file to ensure
Apache
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:
<pre>
$ cygrunsrv -E <i>service_name</i>
</pre>
This will stop all running <code>httpd.exe</code> processes and shutdown
the HTTP
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:
<pre>
$ cygrunsrv -R <i>service_name</i>
</pre>
This will remove your previously defined and installed service from the
machine.</p>
</ul>
<p>Please refer to the corresponding <code>man</code> page of
<code>cygrunsrv</code> and
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="mailto:[EMAIL PROTECTED]"><[EMAIL PROTECTED]></a>.</p>
<!--#include virtual="footer.html" -->
</body>
</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
