apxs.xml.ko

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

<?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: 106090:151405 (outdated) -->

<!--
 Copyright 2004 The Apache Software Foundation

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<manualpage metafile="apxs.xml.meta">
<parentdocument href="./">Programs</parentdocument>

<title>apxs - APache eXtenSion 档备</title>

<summary>
    <p><code>apxs</code>绰 酒颇摹 窍捞欺咆胶飘 傈价 橇肺配妮
    (HTTP) 辑滚狼 犬厘葛碘阑 哪颇老窍绊 汲摹窍绰 档备捞促. 捞
    档备绰 咯矾 家胶客 坷宏璃飘<var>颇老</var>阑 啊瘤绊,
    <module>mod_so</module>狼 <directive
    module="mod_so">LoadModule</directive> 瘤矫绢肺 角青吝俊
    酒颇摹 辑滚肺 佬绢甸老 荐 乐绰 悼利傍蜡按眉(DSO)甫 父电促.</p>

    <p>弊贰辑 捞繁 犬厘规侥阑 荤侩窍妨搁 敲贰汽捞 DSO 扁瓷阑
    瘤盔窍绊 酒颇摹 <code>httpd</code> 角青颇老阑
    <module>mod_so</module> 葛碘苞 鞍捞 哪颇老秦具 茄促.
    <code>apxs</code> 档备绰 捞 炼扒捞 父练窍瘤臼栏搁 角青窍瘤
    臼绰促. 流立 疙飞绢甫 角青窍咯 炼扒捞 父练窍绰瘤 舅酒杭
    荐 乐促</p>

    <example>
      $ httpd -l
    </example>

    <p>格废俊 <module>mod_so</module> 葛碘捞 唱客具 茄促. 炼扒阑
    父练窍搁 <code>apxs</code> 档备肺 DSO 葛碘阑 汲摹窍咯
    酒颇摹辑滚狼 扁瓷阑 奖霸 犬厘且 荐 乐促:</p>

    <example>
      $ apxs -i -a -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 />
      cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
      chmod 755 /path/to/apache/modules/mod_foo.so<br />
      [activating module `foo' in /path/to/apache/etc/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 />
      /path/to/apache/sbin/apachectl restart: httpd started<br />
      $ _
    </example>

    <p>酒痹刚飘 <var>files</var>俊绰 C 家胶颇老 (.c) 捞唱
    坷宏璃飘颇老 (.o), 扼捞宏矾府葛澜 (.a)阑 荤侩且 荐 乐促.
    <code>apxs</code> 档备绰 犬厘磊甫 焊绊 磊悼栏肺 C 家胶颇老篮
    哪颇老窍绊, 坷宏璃飘客 葛澜颇老篮 傅农俊父 荤侩茄促. 弊矾唱
    哪颇老茄 坷宏璃飘甫 荤侩窍妨搁 悼利栏肺 佬绢甸老 荐 乐绰
    傍蜡按眉肺 荤侩窍扁困秦 馆靛矫 坷宏璃飘甫 困摹刀赋内靛(PIC,
    position independent code)肺 哪颇老秦具 茄促. GCC狼 版快
    <code>-fpic</code>阑 荤侩窍搁 等促. 促弗 C 哪颇老矾绰 汲疙辑甫
    曼绊窍芭唱 <code>apxs</code>啊 坷宏璃飘颇老阑 哪颇老且锭
    荤侩窍绰 可记阑 曼绊窍扼.</p>

    <p>酒颇摹狼 DSO 瘤盔俊 措茄 歹 磊技茄 郴侩篮
    <module>mod_so</module> 巩辑甫 曼绊窍芭唱
    <code>src/modules/standard/mod_so.c</code> 家胶颇老阑 佬绢毫扼.</p>
</summary>
<seealso><a href="apachectl.html">apachectl</a></seealso>
<seealso><a href="httpd.html">httpd</a></seealso>

<section id="synopsis"><title>俺夸</title>
    <p><code><strong>apxs</strong> -<strong>g</strong>
    [ -<strong>S</strong> <var>name</var>=<var>value</var> ]
    -<strong>n</strong> <var>modname</var></code></p>

    <p><code><strong>apxs</strong> -<strong>q</strong>
    [ -<strong>S</strong> <var>name</var>=<var>value</var> ]
    <var>query</var> ...</code></p>

    <p><code><strong>apxs</strong> -<strong>c</strong>
    [ -<strong>S</strong> <var>name</var>=<var>value</var> ]
    [ -<strong>o</strong> <var>dsofile</var> ]
    [ -<strong>I</strong> <var>incdir</var> ]
    [ -<strong>D</strong> <var>name</var>=<var>value</var> ]
    [ -<strong>L</strong> <var>libdir</var> ]
    [ -<strong>l</strong> <var>libname</var> ]
    [ -<strong>Wc,</strong><var>compiler-flags</var> ]
    [ -<strong>Wl,</strong><var>linker-flags</var> ]
    <var>files</var> ...</code></p>

    <p><code><strong>apxs</strong> -<strong>i</strong>
    [ -<strong>S</strong> <var>name</var>=<var>value</var> ]
    [ -<strong>n</strong> <var>modname</var> ]
    [ -<strong>a</strong> ]
    [ -<strong>A</strong> ]
    <var>dso-file</var> ...</code></p>

    <p><code><strong>apxs</strong> -<strong>e</strong>
    [ -<strong>S</strong> <var>name</var>=<var>value</var> ]
    [ -<strong>n</strong> <var>modname</var> ]
    [ -<strong>a</strong> ]
    [ -<strong>A</strong> ]
    <var>dso-file</var> ...</code></p>
</section>

<section id="options"><title>可记</title>
    <section id="options.common"><title>傍烹 可记</title>
      <dl>
      <dt><code>-n <var>modname</var></code></dt>
      <dd><code>-i</code> (install)苞 <code>-g</code> (template
      generation) 可记阑 荤侩且锭 流立 葛碘疙阑 瘤沥茄促. 捞
      可记阑 荤侩窍咯 葛碘疙阑 流立 瘤沥茄促. <code>-g</code>
      可记阑 荤侩茄促搁 捞 可记阑 馆靛矫 荤侩秦具窍绊,
      <code>-i</code> 可记阑 荤侩茄促搁 <code>apxs</code> 档备绰
      家胶唱 (付瘤阜 矫档肺) 颇老疙阑 啊瘤绊 捞抚阑 眠螟茄促.</dd>
      </dl>
    </section>

    <section id="options.query"><title>龙狼 可记</title>
      <dl>
      <dt><code>-q</code></dt>
      <dd><code>apxs</code>狼 汲沥蔼阑 舅酒辰促. <var>query</var>俊绰
      促澜阑 荤侩且 荐 乐促: <code>CC</code>, <code>CFLAGS</code>,
      <code>CFLAGS_SHLIB</code>, <code>INCLUDEDIR</code>,
      <code>LD_SHLIB</code>, <code>LDFLAGS_SHLIB</code>,
      <code>LIBEXECDIR</code>, <code>LIBS_SHLIB</code>,
      <code>SBINDIR</code>, <code>SYSCONFDIR</code>, <code>TARGET</code>.

      <p>汲沥阑 流立 舅酒尘锭 荤侩茄促.</p>
      <example>
        INC=-I`apxs -q INCLUDEDIR`
      </example>

      <p>抗甫 甸绢, 酒颇摹 C 庆歹颇老阑 流立 立辟茄促搁
      Makefile俊辑 困客 鞍捞 荤侩茄促.</p></dd>
      </dl>
    </section>

    <section id="options.conf"><title>汲沥 可记</title>
      <dl>
      <dt><code>-S <var>name</var>=<var>value</var></code></dt>
      <dd>捞 可记篮 困俊辑 汲疙茄 apxs 汲沥阑 函版茄促.</dd>
      </dl>
    </section>

    <section id="options.template"><title>斑夯(template) 积己 可记</title>
      <dl>
      <dt><code>-g</code></dt>
      <dd>窍困叼泛配府 <var>name</var>阑 父甸绊 (<code>-n</code>
      可记 曼绊) 弊镑俊 颇老 滴俺甫 父电促: 茄 颇老篮
      <code>mod_<var>name</var>.c</code>扼绰 斑夯 葛碘家胶颇老肺,
      磊脚狼 葛碘阑 父甸锭 斑夯栏肺 荤侩窍芭唱 apxs 扁瓷阑
      矫氰秦杭锭 荤侩茄促. 促弗 颇老篮 捞 葛碘阑 奖霸 哪颇老窍绊
      汲摹窍扁困茄 <code>Makefile</code>捞促.</dd>
      </dl>
    </section>

    <section id="options.dso"><title>DSO 哪颇老 可记</title>
      <dl>
      <dt><code>-c</code></dt>
      <dd>哪颇老阑 瘤矫茄促. 刚历 <var>files</var>俊辑 C
      家胶颇老甸(.c)阑 坷宏璃飘颇老(.o)肺 哪颇老窍绊,
      <var>files</var>狼 唱赣瘤 坷宏璃飘颇老甸(.o苞 .a)苞
      傅农窍咯 悼利傍蜡按眉 <var>dsofile</var>阑 父电促.
      <code>-o</code> 可记阑 荤侩窍瘤臼栏搁 <var>files</var>狼
      霉锅掳 颇老疙俊辑 捞抚阑 眠螟窍咯 焊烹
      <code>mod_<var>name</var>.so</code>甫 荤侩茄促.</dd>

      <dt><code>-o <var>dsofile</var></code></dt>
      <dd>积己且 悼利傍蜡按眉 颇老疙阑 流立 瘤沥茄促. 捞抚阑
      瘤沥窍瘤臼绊 <var>files</var> 格废俊辑 捞抚阑 眠螟窍瘤
      给窍搁 付瘤阜栏肺 <code>mod_unknown.so</code>甫 捞抚栏肺
      荤侩茄促.</dd>

      <dt><code>-D <var>name</var>=<var>value</var></code></dt>
      <dd>捞 可记阑 哪颇老 疙飞绢肺 流立 傈崔茄促.
      哪颇老锭 磊脚狼 define阑 眠啊茄促.</dd>

      <dt><code>-I <var>incdir</var></code></dt>
      <dd>捞 可记阑 哪颇老 疙飞绢肺 流立 傈崔茄促.
      哪颇老锭 include甫 茫阑 叼泛配府甫 眠啊茄促.</dd>

      <dt><code>-L <var>libdir</var></code></dt>
      <dd>捞 可记阑 傅目 疙飞绢肺 流立 傈崔茄促.
      哪颇老锭 扼捞宏矾府甫 茫阑 叼泛配府甫 眠啊茄促.</dd>

      <dt><code>-l <var>libname</var></code></dt>
      <dd>捞 可记阑 傅目 疙飞绢肺 流立 傈崔茄促.
      哪颇老锭 荤侩且 扼捞宏矾府甫 眠啊茄促.</dd>

      <dt><code>-Wc,<var>compiler-flags</var></code></dt>
      <dd>捞 可记篮 眠啊 可记 <var>compiler-flags</var>甫
      哪颇老 疙飞绢肺 傈崔茄促. 哪颇老矾 漂蜡狼 可记阑 眠啊且锭
      荤侩茄促.</dd>

      <dt><code>-Wl,<var>linker-flags</var></code></dt>
      <dd>捞 可记篮 眠啊 可记 <var>linker-flags</var>甫
      傅目 疙飞绢肺 傈崔茄促. 傅目 漂蜡狼 可记阑 眠啊且锭
      荤侩茄促.</dd>
      </dl>
    </section>

    <section id="options.dsoinstall">
    <title>DSO 汲摹苞 汲沥 可记</title>
      <dl>
      <dt><code>-i</code></dt>
      <dd>汲摹甫 瘤矫茄促. 咯矾 悼利傍蜡按眉甫 辑滚狼
      <var>modules</var> 叼泛配府俊 汲摹茄促.</dd>

      <dt><code>-a</code></dt>
      <dd>酒颇摹 <code>httpd.conf</code> 汲沥颇老俊 利例茄
      <directive module="mod_so">LoadModule</directive> 临阑
      眠啊窍芭唱 捞固 乐促搁 劝己拳窍咯 葛碘阑 荤侩窍档废
      父电促.</dd>

      <dt><code>-A</code></dt>
      <dd><code>-a</code>客 厚搅窍瘤父, <directive
      module="mod_so">LoadModule</directive> 瘤矫绢 菊俊
      快拱沥磊(<code>#</code>)甫 嘿牢促. <em>溜</em>, 泅犁绰
      荤侩窍瘤臼瘤父 唱吝俊 荤侩且 荐 乐档废 葛碘阑 霖厚茄促.</dd>

      <dt><code>-e</code></dt>
      <dd>祈笼阑 瘤矫茄促. <code>-a</code> 趣篮 <code>-A</code>
      可记苞 鞍捞 荤侩且 荐 乐栏哥, <code>-i</code> 疙飞苞
      厚搅窍瘤父 葛碘阑 汲摹窍瘤臼绊 酒颇摹
      <code>httpd.conf</code> 汲沥颇老父 祈笼茄促.</dd>
      </dl>
    </section>
</section>

<section id="examples"><title>抗力</title>
    <p>酒颇摹辑滚狼 扁瓷阑 犬厘窍绰 <code>mod_foo.c</code>扼绰
    酒颇摹 葛碘捞 乐促绊 啊沥窍磊. 刚历 促澜 疙飞绢甫 荤侩窍咯
    C 家胶甫 酒颇摹 辑滚啊 佬绢甸老 傍蜡按眉肺 哪颇老茄促:</p>

    <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 />
      $ _
    </example>

    <p>弊府绊 捞 傍蜡按眉甫 佬绢甸捞绰 <directive
    module="mod_so">LoadModule</directive> 瘤矫绢甫 酒颇摹
    汲沥俊 眠啊茄促. <code>apxs</code>绰 磊悼栏肺 傍蜡按眉甫
    "modules" 叼泛配府俊 汲摹窍绊 <code>httpd.conf</code> 颇老阑
    舅嘎霸 荐沥窍咯 埃窜洒 累诀阑 付模促. 促澜 鞍捞 角青茄促:</p>

    <example>
      $ apxs -i -a mod_foo.c<br />
      cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
      chmod 755 /path/to/apache/modules/mod_foo.so<br />
      [activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
      $ _
    </example>

    <p>弊矾搁 促澜苞 鞍篮 临阑</p>

    <example>
      LoadModule foo_module modules/mod_foo.so
    </example>

    <p>汲沥颇老俊 绝促搁 眠啊茄促. 捞 汲沥阑 扁夯利栏肺 荤侩窍瘤
    臼绰促搁 <code>-A</code> 可记阑 荤侩茄促. <em>溜</em></p>

    <example>
      $ apxs -i -A mod_foo.c
    </example>

    <p>apxs甫 奖霸 荤侩窍妨绊 促澜苞 鞍捞 酒颇摹 葛碘 斑夯苞
    Makefile阑 父甸 荐 乐促:</p>

    <example>
      $ apxs -g -n foo<br />
      Creating [DIR]  foo<br />
      Creating [FILE] foo/Makefile<br />
      Creating [FILE] foo/mod_foo.c<br />
      $ _
    </example>

    <p>弊繁饶 官肺 斑夯 葛碘阑 傍蜡按眉肺 哪颇老窍咯 酒颇摹
    辑滚啊 佬档废茄促:</p>

    <example>
      $ 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 />
      chmod 755 /path/to/apache/modules/mod_foo.so<br />
      [activating module `foo' in /path/to/apache/etc/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 />
      /path/to/apache/sbin/apachectl restart: httpd started<br />
      $ _
    </example>

    <p>缴瘤绢 酒颇摹 家胶 观俊辑 <code>apxs</code>甫 荤侩窍咯
    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><code>apxs</code>绰 磊悼栏肺 C 家胶颇老苞 坷宏璃飘颇老阑
    备喊茄促. C 家胶颇老父 哪颇老窍绊 唱赣瘤 坷宏璃飘颇老篮
    傅农且锭 荤侩茄促.</p>
</section>
</manualpage>