You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by jo...@apache.org on 2004/09/28 17:24:00 UTC
cvs commit: httpd-2.0/docs/manual/programs apxs.xml
jorton 2004/09/28 08:24:00
Modified: docs/manual/programs apxs.xml
Log:
Bring up to date a little, and don't talk about building PHP3(!).
Revision Changes Path
1.5 +22 -29 httpd-2.0/docs/manual/programs/apxs.xml
Index: apxs.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/programs/apxs.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -d -w -u -r1.4 -r1.5
--- apxs.xml 17 Apr 2004 11:18:05 -0000 1.4
+++ apxs.xml 28 Sep 2004 15:24:00 -0000 1.5
@@ -203,11 +203,13 @@
<dt><code>-Wc,<var>compiler-flags</var></code></dt>
<dd>This option passes <var>compiler-flags</var> as additional flags to
- the compiler command. Use this to add local compiler-specific options.</dd>
+ the <code>libtool --mode=compile</code> command. Use this to add local
+ compiler-specific options.</dd>
<dt><code>-Wl,<var>linker-flags</var></code></dt>
- <dd>This option passes <var>linker-flags</var> as additional flags to
- the linker command. Use this to add local linker-specific options.</dd>
+ <dd>This option passes <var>linker-flags</var> as additional
+ flags to the <code>libtool --mode=link</code> command. Use this
+ to add local linker-specific options.</dd>
</dl>
</section>
@@ -248,8 +250,8 @@
<example>
$ apxs -c mod_foo.c<br />
- gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c<br />
- ld -Bshareable -o mod_foo.so mod_foo.o<br />
+ /path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
+ /path/to/libtool --mode=link -o mod_foo.la mod_foo.slo<br />
$ _
</example>
@@ -261,10 +263,12 @@
achieved by running:</p>
<example>
- $ apxs -i -a mod_foo.c<br />
- cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
+ $ apxs -i -a mod_foo.la<br />
+ /path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
+ /path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
+ ...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
- [activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
+ [activating module `foo' in /path/to/apache/conf/httpd.conf]<br />
$ _
</example>
@@ -289,7 +293,9 @@
$ apxs -g -n foo<br />
Creating [DIR] foo<br />
Creating [FILE] foo/Makefile<br />
+ Creating [FILE] foo/modules.mk<br />
Creating [FILE] foo/mod_foo.c<br />
+ Creating [FILE] foo/.deps<br />
$ _
</example>
@@ -300,12 +306,14 @@
$ cd foo<br />
$ make all reload<br />
apxs -c mod_foo.c<br />
- gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c<br />
- ld -Bshareable -o mod_foo.so mod_foo.o<br />
- apxs -i -a -n "foo" mod_foo.so<br />
- cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
+ /path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
+ /path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
+ apxs -i -a -n "foo" mod_foo.la<br />
+ /path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
+ /path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
+ ...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
- [activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
+ [activating module `foo' in /path/to/apache/conf/httpd.conf]<br />
apachectl restart<br />
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
@@ -313,20 +321,5 @@
$ _
</example>
- <p>You can even use <code>apxs</code> to compile complex modules outside the
- Apache source tree, like PHP3:</p>
-
- <example>
- $ cd php3<br />
- $ ./configure --with-shared-apache=../apache-1.3<br />
- $ apxs -c -o libphp3.so mod_php3.c libmodphp3-so.a<br />
- gcc -fpic -DSHARED_MODULE -I/tmp/apache/include -c mod_php3.c<br />
- ld -Bshareable -o libphp3.so mod_php3.o libmodphp3-so.a<br />
- $ _
- </example>
-
- <p>because <code>apxs</code> automatically recognized C source files and
- object files. Only C source files are compiled while remaining object
- files are used for the linking phase.</p>
</section>
</manualpage>