rse 98/04/04 10:02:46
Modified: . INSTALL
Log:
Make sure the user informed about DSO support even if he uses APACI and not
reading src/Configuration.tmpl He has to notice that the nice --enable-shared
option is only available if his platform really supports DSO.
Revision Changes Path
1.4 +40 -12 apache-1.3/INSTALL
Index: INSTALL
===================================================================
RCS file: /export/home/cvs/apache-1.3/INSTALL,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- INSTALL 1998/04/01 12:59:56 1.3
+++ INSTALL 1998/04/04 18:02:46 1.4
@@ -41,12 +41,14 @@
The following requirements exist for building Apache:
o Disk Space:
+
Make sure you have approximately 12 MB of temporary free disk space
available. After installation Apache occupies approximately 3 MB of
disk space (the actual required disk space depends on the amount of
compiled in third party modules, etc).
o ANSI-C Compiler:
+
Make sure you have an ANSI-C compiler installed. The GNU C compiler
(GCC) from the Free Software Foundation (FSF) is recommended. If you
don't have GCC then at least make sure your vendors compiler is ANSI
@@ -54,15 +56,43 @@
http://www.gnu.ai.mit.edu/ and the GCC distribution under
http://www.gnu.ai.mit.edu/order/ftp.html .
- o Perl 5 Interpreter (OPTIONAL):
- For some of the support scripts like `apachectl' (which are written
in
- Perl) the Perl 5 interpreter is required. If no such interpreter is
- found by APACI's `configure' script this is no harm. You still can
- build and install Apache 1.3. Only those support scripts cannot be
- used. If you have multiple Perl interpreters installed (perhaps a
Perl
- 4 from the vendor and a Perl 5 from your own), then it is recommended
- to use the --with-perl option (see below) to make sure the correct
one
- is selected by APACI.
+ o Perl 5 Interpreter [OPTIONAL]:
+
+ For some of the support scripts like `apxs' or `dbmmanage' (which are
+ written in Perl) the Perl 5 interpreter is required. If no such
+ interpreter is found by APACI's `configure' script this is no harm.
+ Of course, you still can build and install Apache 1.3. Only those
+ support scripts cannot be used. If you have multiple Perl
interpreters
+ installed (perhaps a Perl 4 from the vendor and a Perl 5 from your
+ own), then it is recommended to use the --with-perl option (see
below)
+ to make sure the correct one is selected by APACI.
+
+ o Dynamic Shared Object (DSO) support [OPTIONAL]:
+
+ To provide maximum flexibility Apache now is able to load modules
+ under runtime via the DSO mechanism by using the pragmatic
+ dlopen()/dlsym() system calls. These system calls are not available
+ under all operating systems therefore you cannot use the DSO
mechanism
+ on all platforms. And Apache currently has only limited built-in
+ knowledge on how to compile shared objects because this is heavily
+ platform-dependend. The current state is this:
+
+ o Out-of-the-box supported platforms are:
+ - Linux - IRIX
+ - FreeBSD - OSF1
+ - Solaris - UnixWare
+ - SunOS
+
+ o Entirely unsupported platforms are:
+ - HP-UX (because no dlopen-style interface)
+ - Ultrix (because no dlopen-style interface)
+ - AIX (although it has dlopen it is a braindead one)
+
+ If your system is not on these lists but has the dlopen-style
+ interface, you either have to provide the appropriate compiler and
+ linker flags (see CFLAGS_SHLIB, LDFLAGS_SHLIB and
LDFLAGS_SHLIB_EXPORT
+ below) manually or at least make sure a Perl 5 interpreter is
+ installed from which Apache can guess the options.
3. Configuring the source tree
---------------------------
@@ -152,9 +182,7 @@
no=disabled) can be seen when running `./configure --help'. There are two
special NAME variants: "max" for enabling or disabling all modules except
the bootstrapping "so" module and "remain" for enabling or disabling only
- these modules which are still not enabled. ATTENTION: Shared object
- support is not available on all platforms. See the src/Configuration.tmpl
- file for the definitive list of supported platforms.
+ these modules which are still not enabled.
Use the --with-perl=FILE option to select a particular Perl interpreter
executable to be used with Apache. Per default APACI tries to find it
