Apache HTTP Server Version 1.3

ソースの再構築

変更の概要

• モジュールのないソースファイルが src から src/main に移されています。
• 以前 src にあったモジュールソースファイルは、src/modules/standard に移されています。
• support ディレクトリは今、src/support にあります。

• OS の 仕様は src/os ディレクトリで追加されます。現在、これは unix 、OS/2、Windows 32、のプラットフォームの情報を含んでいます。
• Configuration syntax は新しいモジュールを追加することにより単純化されています。ユーザはもはや、モジュール構成の名前を入力する必要があります。さらに、新しいモジュールはファイルシステム上のどこかに配置されるか、src/modulesにある普通に新しいか、もしくは存在するディレクトリに配置されます。
• モジュール authors は Apache のコンピレーションにそれらのモジュールを追加するために、より単純な命令を与えることができます。要求された追加のライブラリのように、Configure によって要求されたコンパイル時の情報も与えることができます。
• モジュール authors は、もし要求されていれば、Configure によって要求された情報を含んでいる"module definition file"に従って、コンパイルされる前 (.a または .o) のバージョンのモジュールを配布することができます。
• 全てのサブディレクトリ (main, modules/* and os/*) はライブラリとして構築されています。

モジュールの追加

  Module    status_module    mod_status.o

  AddModule    modules/standard/mod_status.o

普通モジュールを追加するときは、モジュール author の命令に従うべきです。しかしながら、単一のソースファイルとしてモジュールが生じると、mod_foo.c を示し、それから以下のように、推奨されたApache にモジュールを追加する方法を示します:

• Put mod_foo.c into the directory src/modules/extra
• Go to the src directory and add the following line to Configuration
AddModule modules/extra/mod_foo.o
• Run ./Configure
• Run make

モジュール authors の新機能

Apache 1.3 以降から、モジュール authors はこれらの新しい特徴を利用することができます:

• モジュールかオブジェクトファイルへのパスを要求するだけの AddModule を、単純化された Configuration が命令します。
• もしモジュールがコンパイル時のオプションを要求すると(特別のライブラリのように)、これらはモジュールファイルソースか、外部"モジュール定義ファイル"で指定されます。
• もしモジュールがバイナリとして (.o か .a) 配布されると、その時、外部"モジュール定義ファイル"が配布され、そしてそれは、特別のライブラリとモジュールの構造名のようにモジュールを追加するのに必要な情報の Configure を与えます。
• モジュールはファイルシステムのどこかでインストールされますが、src/modules 下のディレクトリが推奨されています。
• もしモジュールがそれ自身のディレクトリにあれば、Apache は自動的にモジュールの依存を含むファイルを与えられるモジュールを構築するために Makefile を作ります。

簡単なソース配布の構築

• mod_demo/mod_demo.c
• mod_demo/Makefile.tmpl

  AddModule  modules/mod_demo/mod_demo.o

mod_demo/Makefile.tmpl はモジュールソースの依存を含むべきです。例えば、いくつかの標準 Apache モジュール API 機能のインターフェースとなる、単純なモジュールは、このようになるかもしれません:

  mod_demo.o: mod_demo.c $(INCDIR)/httpd.h $(INCDIR)/http_protocol.h

もしモジュールもヘッダファイルに付属すると、これらはアーカイブに追加されます。もしモジュールが様々なソースファイルから構成されていると、与えられた makefile を使っているライブラリファイルに構築されます。この場合、mod_demo/Makefile として makefile を配布し、mod_demo/Makefile.tmpl を含まないでください。もし Configure が Makefile.tmpl を見ると、なんらかの存在する Makefile を上書きするのを安全だと見なします。

Makefile.tmpl から makefile が自動的に作られるモジュールディレクトリの例については、Apache src/modules/standard を見てください(このディレクトリも、単一のディレクトリで様々なモジュールをどのように配布しているのかを示していることに注意してください)。 カスタムの makefile (それぞれにライブラリとオブジェクトファイルを構築するための)を使って構築されたモジュールの例としては src/modules/proxy と src/modules/example を見てください

コンパイル時の情報を追加する

/*
 * Module definition information - the part between the -START and -END
 * lines below is used by Configure. This could be stored in a separate
 * instead.
 *
 * MODULE-DEFINITION-START
 * Name: demo_module
 * ConfigStart
    LIBS="$LIBS $DBM_LIB"
    if [ "X$DBM_LIB" != "X" ]; then
        echo " + using $DBM_LIB for mod_demo"
    fi
 * ConfigEnd
 * MODULE-DEFINITION-END
 */

Configure によって実行されるような、ConfigStart と ConfigEnd の間にある行はコンパイル時のオプションとライブラリを追加するために使われます。この場合には、($DBM_LIBから) DBM ライブラリを標準のコンピレーションライブラリ($LIB) に追加して、メッセージを表示します。

内蔵されたモジュールの定義の例については、デフォルト配布の mod_auth_dbm.c を見てください。

バイナリ配布についてのモジュール定義情報

Name: demo_module
ConfigStart
 LIBS="$LIBS $DBM_LIB"
 if [ "X$DBM_LIB" != "X" ]; then
     echo " + using $DBM_LIB for mod_demo"
 fi
ConfigEnd