apxs – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

apxs – APache-Erweiterungstool

ZUSAMMENFASSUNG

apxs -g [-S Name=Wert ] -n modname

apxs -q [-v ] [ -S Name=Wert ] query ...

apxs -c [-S Name=Wert ] [ -o dsofile ] [ -I incdir ] [ -D Name=Wert ] [ -L libdir ] [
-l Bibliotheksname ] [ -wc,Compiler-Flags ] [ -Wl,Linker-Flags ] Dateien ...

apxs -i [-S Name=Wert ] [ -n modname ] [ -a ] [ -A ] dso-Datei ...

apxs -e [-S Name=Wert ] [ -n modname ] [ -a ] [ -A ] dso-Datei ...

ZUSAMMENFASSUNG

apxs ist ein Tool zum Erstellen und Installieren von Erweiterungsmodulen für Apache HyperText
Transfer Protocol (HTTP)-Server. Dies wird durch den Aufbau eines dynamischen Shared Object erreicht
(DSO) von einer oder mehreren Quellen oder Objekten Dateien welches dann in den Apache geladen werden kann
Server zur Laufzeit über die LoadModule-Direktive von mod_so.

Um diesen Erweiterungsmechanismus nutzen zu können, muss Ihre Plattform die DSO-Funktion unterstützen
Die Apache httpd-Binärdatei muss mit dem Modul mod_so erstellt werden. Das Apxs-Tool automatisch
beschwert sich, wenn dies nicht der Fall ist. Sie können dies selbst überprüfen, indem Sie das manuell ausführen
Befehl

$ httpd -l

Das Modul mod_so sollte Teil der angezeigten Liste sein. Wenn diese Anforderungen erfüllt sind
Wenn dies erfüllt ist, können Sie die Funktionalität Ihres Apache-Servers ganz einfach erweitern, indem Sie Ihren eigenen installieren
Module mit dem DSO-Mechanismus mithilfe dieses Apxs-Tools:

$ apxs -i -a -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
cp mod_foo.so /path/to/apache/modules/mod_foo.so
chmod 755 /path/to/apache/modules/mod_foo.so
[Modul „foo“ in /path/to/Apache/etc/httpd.conf aktivieren]
$ apachectl neu starten
/path/to/apache/sbin/apachectl restart: httpd läuft nicht, versucht zu starten
[Dienstag, 31. März 11:27:55 1998] [Debug] mod_so.c(303): Modul foo_module geladen
/path/to/apache/sbin/apachectl restart: httpd gestartet
$_

Die Argumente Dateien kann eine beliebige C-Quelldatei (.c), eine Objektdatei (.o) oder sogar eine Bibliothek sein
Archiv (.a). Das Tool apxs erkennt diese Erweiterungen automatisch und automatisch
Ich habe die C-Quelldateien für die Kompilierung verwendet, während ich nur die Objekt- und Archivdateien für verwendet habe
die Verknüpfungsphase. Wenn Sie jedoch solche vorkompilierten Objekte verwenden, stellen Sie sicher, dass diese kompiliert sind
für positionsunabhängigen Code (PIC), um sie für einen dynamisch geladenen Shared verwenden zu können
Objekt. Bei GCC müssen Sie beispielsweise immer nur -fpic verwenden. Für andere C-Compiler
Konsultieren Sie die Handbuchseite oder achten Sie auf die Flags, die Apxs zum Kompilieren der Objektdateien verwendet.

Weitere Informationen zur DSO-Unterstützung in Apache finden Sie in der Dokumentation von mod_so oder vielleicht
Ich habe sogar die Quelldatei src/modules/standard/mod_so.c gelesen.

OPTIONAL

gemeinsam Optionen
-n modname
Dadurch wird explizit der Modulname für -i (Installation) und -g (Vorlage) festgelegt
Generation) Option. Verwenden Sie dies, um den Modulnamen explizit anzugeben. Für Option -g
Dies ist erforderlich, für die Option -i versucht das Apxs-Tool, den Namen aus dem zu ermitteln
Quelle oder (als Fallback) zumindest durch Erraten aus dem Dateinamen.

Abfrage Optionen
-q Führt eine Abfrage nach Variablen und Umgebungseinstellungen durch, die zum Erstellen von httpd verwendet werden. Wenn
aufgerufen ohne query Parameter gibt es alle bekannten Variablen und ihre Werte aus.
Der optionale Parameter -v formatiert die Listenausgabe. .PP Verwenden Sie dies zum manuellen
Bestimmen Sie die Einstellungen, die zum Erstellen des httpd verwendet werden, das Ihr Modul lädt. Zum Beispiel
Verwenden Sie INC=-I`apxs -q INCLUDEDIR` .PP in Ihren eigenen Makefiles, wenn Sie ein Handbuch benötigen
Zugriff auf die C-Header-Dateien von Apache.

Konfiguration Optionen
-S Name=Wert
Diese Option ändert die oben beschriebenen Apxs-Einstellungen.

Template Generation Optionen
-g Dies erzeugt ein Unterverzeichnis Name (siehe Option -n) und dort zwei Dateien: Ein Beispiel
Modulquelldatei mit dem Namen mod_Name.c, die als Vorlage zum Erstellen verwendet werden kann
Ihre eigenen Module oder als schneller Einstieg zum Spielen mit dem Apxs-Mechanismus. Und ein
entsprechendes Makefile für eine noch einfachere Erstellung und Installation dieses Moduls.

DSO Zusammenstellung Optionen
-c Dies zeigt den Kompilierungsvorgang an. Zunächst werden die C-Quelldateien (.c) kompiliert.
of Dateien in entsprechende Objektdateien (.o) und erstellt dann eine dynamisch freigegebene Datei
Objekt in dsofile durch Verknüpfung dieser Objektdateien plus der übrigen Objektdateien (.o
und .a) von Dateien. Wenn keine Option -o angegeben ist, wird die Ausgabedatei anhand der Datei ermittelt
erster Dateiname in Dateien und ist daher normalerweise standardmäßig auf mod_Name.So.

-o dsofile
Gibt explizit den Dateinamen des erstellten dynamisch freigegebenen Objekts an. Wenn nicht
angegeben und der Name lässt sich daraus nicht erraten Dateien Liste, der Fallback-Name
mod_unknown.so wird verwendet.

-D Name=Wert
Diese Option wird direkt an den/die Kompilierungsbefehl(e) weitergegeben. Nutzen Sie dies, um
Fügen Sie dem Build-Prozess Ihre eigenen Definitionen hinzu.

-I incdir
Diese Option wird direkt an den/die Kompilierungsbefehl(e) weitergegeben. Nutzen Sie dies, um
Fügen Sie Ihre eigenen Include-Verzeichnisse hinzu, um sie im Build-Prozess zu durchsuchen.

-L libdir
Diese Option wird direkt an den Linker-Befehl weitergegeben. Verwenden Sie dies, um Ihre hinzuzufügen
eigene Bibliotheksverzeichnisse zum Durchsuchen des Build-Prozesses.

-l Bibliotheksname
Diese Option wird direkt an den Linker-Befehl weitergegeben. Verwenden Sie dies, um Ihre hinzuzufügen
Eigene Bibliotheken zum Durchsuchen des Build-Prozesses.

-Toilette,Compiler-Flags
Diese Option ist bestanden Compiler-Flags als zusätzliche Flags zum libtool --mode=compile
Befehl. Verwenden Sie dies, um lokale Compiler-spezifische Optionen hinzuzufügen.

-WL,Linker-Flags
Diese Option ist bestanden Linker-Flags als zusätzliche Flags zum libtool --mode=link
Befehl. Verwenden Sie dies, um lokale Linker-spezifische Optionen hinzuzufügen.

-p Diese Option bewirkt, dass apxs eine Verknüpfung mit den apr/apr-util-Bibliotheken herstellt. Das ist nützlich
beim Kompilieren von Hilfsprogrammen, die die apr/apr-util-Bibliotheken verwenden.

DSO Installation und Konfiguration Optionen
-i Dies zeigt den Installationsvorgang an und installiert einen oder mehrere dynamisch
gemeinsam genutzte Objekte in den Server Module Verzeichnis.

-a Dadurch wird das Modul aktiviert, indem automatisch eine entsprechende LoadModule-Zeile hinzugefügt wird
in die Konfigurationsdatei httpd.conf von Apache hinzufügen oder sie aktivieren, falls sie bereits vorhanden ist.

-A Gleich wie Option -a, aber der erstellten LoadModule-Direktive wird ein Hash-Zeichen vorangestellt
(#), dh, das Modul wird nur für die spätere Aktivierung vorbereitet, aber zunächst deaktiviert.

-e Dies gibt den Bearbeitungsvorgang an, der mit den Optionen -a und -A verwendet werden kann
Ähnlich wie die Operation -i zum Bearbeiten der Apache-Konfigurationsdatei httpd.conf
ohne zu versuchen, das Modul zu installieren.

Beispiele:

Angenommen, Sie haben ein Apache-Modul namens mod_foo.c zur Verfügung, das Apache erweitern soll
Serverfunktionalität. Um dies zu erreichen, müssen Sie zunächst die C-Quelle in eine kompilieren
Gemeinsam genutztes Objekt, das zur Laufzeit über Folgendes in den Apache-Server geladen werden kann
Befehl:

$ apxs -c mod_foo.c
/path/to/libtool --mode=compile gcc ... -c mod_foo.c
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
$_

Anschließend müssen Sie die Apache-Konfiguration aktualisieren, indem Sie sicherstellen, dass eine LoadModule-Direktive vorhanden ist
vorhanden, um dieses gemeinsame Objekt zu laden. Um diesen Schritt zu vereinfachen, bietet apxs eine automatische Möglichkeit
um das gemeinsam genutzte Objekt in seinem Verzeichnis „modules“ zu installieren und die Datei httpd.conf zu aktualisieren
entsprechend. Dies kann erreicht werden, indem Sie Folgendes ausführen:

$ 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
[Modul „foo“ in /path/to/Apache/conf/httpd.conf aktivieren]
$_

Auf diese Weise wird eine Zeile benannt

LoadModule foo_module module/mod_foo.so

wird der Konfigurationsdatei hinzugefügt, falls noch nicht vorhanden. Wenn Sie dies deaktivieren möchten
Verwenden Sie standardmäßig die Option -A. dh

$ apxs -i -A mod_foo.c

Für einen schnellen Test des Apxs-Mechanismus können Sie eine Beispiel-Apache-Modulvorlage plus erstellen
ein entsprechendes Makefile über:

$ apxs -g -n foo
[DIR] foo wird erstellt
Erstellen von [DATEI] foo/Makefile
Erstellen von [DATEI] foo/modules.mk
Erstellen von [DATEI] foo/mod_foo.c
Erstellen von [DATEI] foo/.deps
$_

Anschließend können Sie dieses Beispielmodul sofort in ein gemeinsames Objekt kompilieren und laden
der Apache-Server:

$ cd foo
$ alles neu laden lassen
apxs -c mod_foo.c
/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
[Modul „foo“ in /path/to/Apache/conf/httpd.conf aktivieren]
Apachectl-Neustart
/path/to/apache/sbin/apachectl restart: httpd läuft nicht, versucht zu starten
[Dienstag, 31. März 11:27:55 1998] [Debug] mod_so.c(303): Modul foo_module geladen
/path/to/apache/sbin/apachectl restart: httpd gestartet
$_

Nutzen Sie Apxs online über die Dienste von onworks.net