update transformation

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@105321 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
André Malo
2004-09-28 17:32:39 +00:00
parent 0d9c89ae6f
commit d902d5e491
5 changed files with 45 additions and 61 deletions

View File

@ -19,7 +19,7 @@
.el .ne 3
.IP "\\$1" \\$2
..
.TH "APXS" 8 "2003-11-25" "Apache HTTP Server" "apxs"
.TH "APXS" 8 "2004-09-28" "Apache HTTP Server" "apxs"
.SH NAME
apxs \- APache eXtenSion tool
@ -96,7 +96,7 @@ This explicitly sets the module name for the -i (install) and -g (template gener
.TP
-q
Performs a query for apxs's knowledge about certain settings\&. The \fIquery\fR parameters can be one or more of the following strings: CC, CFLAGS, CFLAGS_SHLIB, INCLUDEDIR, LD_SHLIB, LDFLAGS_SHLIB, LIBEXECDIR, LIBS_SHLIB, SBINDIR, SYSCONFDIR, TARGET\&. .PP Use this for manually determining settings\&. For instance use .nf INC=-I`apxs -q INCLUDEDIR` .fi .PP inside your own Makefiles if you need manual access to Apache's C header files\&.
Performs a query for apxs's knowledge about certain settings\&. The \fIquery\fR parameters can be one or more of the following strings: CC, CFLAGS, CFLAGS_SHLIB, INCLUDEDIR, LD_SHLIB, LDFLAGS_SHLIB, LIBEXECDIR, LIBS_SHLIB, SBINDIR, SYSCONFDIR, TARGET\&. .PP Use this for manually determining settings\&. For instance use INC=-I`apxs -q INCLUDEDIR` .PP inside your own Makefiles if you need manual access to Apache's C header files\&.
.SS "Configuration Options"
@ -135,10 +135,10 @@ This option is directly passed through to the linker command\&. Use this to add
This option is directly passed through to the linker command\&. Use this to add your own libraries to search to the build process\&.
.TP
-Wc,\fIcompiler-flags\fR
This option passes \fIcompiler-flags\fR as additional flags to the compiler command\&. Use this to add local compiler-specific options\&.
This option passes \fIcompiler-flags\fR as additional flags to the libtool --mode=compile command\&. Use this to add local compiler-specific options\&.
.TP
-Wl,\fIlinker-flags\fR
This option passes \fIlinker-flags\fR as additional flags to the linker command\&. Use this to add local linker-specific options\&.
This option passes \fIlinker-flags\fR as additional flags to the libtool --mode=link command\&. Use this to add local linker-specific options\&.
.SS "DSO Installation and Configuration Options"
@ -164,8 +164,8 @@ Assume you have an Apache module named mod_foo\&.c available which should extend
.nf
$ apxs -c mod_foo\&.c
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo\&.c
ld -Bshareable -o mod_foo\&.so mod_foo\&.o
/path/to/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
/path/to/libtool --mode=link -o mod_foo\&.la mod_foo\&.slo
$ _
.fi
@ -175,10 +175,12 @@ Then you have to update the Apache configuration by making sure a LoadModule dir
.nf
$ apxs -i -a mod_foo\&.c
cp mod_foo\&.so /path/to/apache/modules/mod_foo\&.so
$ apxs -i -a mod_foo\&.la
/path/to/instdso\&.sh mod_foo\&.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo\&.la /path/to/apache/modules
\&.\&.\&.
chmod 755 /path/to/apache/modules/mod_foo\&.so
[activating module `foo' in /path/to/apache/etc/httpd\&.conf]
[activating module `foo' in /path/to/apache/conf/httpd\&.conf]
$ _
.fi
@ -209,7 +211,9 @@ For a quick test of the apxs mechanism you can create a sample Apache module tem
$ apxs -g -n foo
Creating [DIR] foo
Creating [FILE] foo/Makefile
Creating [FILE] foo/modules\&.mk
Creating [FILE] foo/mod_foo\&.c
Creating [FILE] foo/\&.deps
$ _
.fi
@ -222,12 +226,14 @@ Then you can immediately compile this sample module into a shared object and loa
$ cd foo
$ make all reload
apxs -c mod_foo\&.c
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo\&.c
ld -Bshareable -o mod_foo\&.so mod_foo\&.o
apxs -i -a -n "foo" mod_foo\&.so
cp mod_foo\&.so /path/to/apache/modules/mod_foo\&.so
/path/to/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
/path/to/libtool --mode=link gcc \&.\&.\&. -o mod_foo\&.la mod_foo\&.slo
apxs -i -a -n "foo" mod_foo\&.la
/path/to/instdso\&.sh mod_foo\&.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo\&.la /path/to/apache/modules
\&.\&.\&.
chmod 755 /path/to/apache/modules/mod_foo\&.so
[activating module `foo' in /path/to/apache/etc/httpd\&.conf]
[activating module `foo' in /path/to/apache/conf/httpd\&.conf]
apachectl restart
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start
[Tue Mar 31 11:27:55 1998] [debug] mod_so\&.c(303): loaded module foo_module
@ -236,20 +242,3 @@ Then you can immediately compile this sample module into a shared object and loa
.fi
.PP
You can even use apxs to compile complex modules outside the Apache source tree, like PHP3:
.nf
$ cd php3
$ \&./configure --with-shared-apache=\&.\&./apache-1\&.3
$ apxs -c -o libphp3\&.so mod_php3\&.c libmodphp3-so\&.a
gcc -fpic -DSHARED_MODULE -I/tmp/apache/include -c mod_php3\&.c
ld -Bshareable -o libphp3\&.so mod_php3\&.o libmodphp3-so\&.a
$ _
.fi
.PP
because apxs automatically recognized C source files and object files\&. Only C source files are compiled while remaining object files are used for the linking phase\&.

View File

@ -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>
@ -247,8 +249,8 @@
<div class="example"><p><code>
$ 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 />
$ _
</code></p></div>
@ -260,10 +262,12 @@
achieved by running:</p>
<div class="example"><p><code>
$ 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 />
$ _
</code></p></div>
@ -288,7 +292,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 />
$ _
</code></p></div>
@ -299,12 +305,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 />
@ -312,21 +320,6 @@
$ _
</code></p></div>
<p>You can even use <code>apxs</code> to compile complex modules outside the
Apache source tree, like PHP3:</p>
<div class="example"><p><code>
$ 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 />
$ _
</code></p></div>
<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>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/apxs.html" title="English">&nbsp;en&nbsp;</a> |

View File

@ -21,6 +21,8 @@
<p><span><3E><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD>: </span><a href="../en/programs/apxs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../ko/programs/apxs.html" title="Korean">&nbsp;ko&nbsp;</a></p>
</div>
<div class="outofdate"><3E><> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20>ֽ<EFBFBD><D6BD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20>ƴմϴ<D5B4>.
<20>ֱٿ<D6B1> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD>ϼ<EFBFBD><CFBC><EFBFBD>.</div>
<p><code>apxs</code><3E><> <20><><EFBFBD><EFBFBD>ġ <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ؽ<EFBFBD>Ʈ <20><><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
(HTTP) <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> Ȯ<><C8AE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϰ<EFBFBD> <20><>ġ<EFBFBD>ϴ<EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD>̴<EFBFBD>. <20><>

View File

@ -1,7 +1,7 @@
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 1.4 -->
<!-- English Revision: 1.4 (outdated: 1.5) -->
<!--
Copyright 2004 The Apache Software Foundation

View File

@ -7,6 +7,6 @@
<variants>
<variant>en</variant>
<variant>ko</variant>
<variant outdated="yes">ko</variant>
</variants>
</metafile>