apxs - Online in de cloud

PROGRAMMA:

NAAM

apxs - APache eXtenSion-tool

KORTE INHOUD

apxs -g [-S naam=waarde ​n modnaam

apxs -q [-v ] [-S naam=waarde ] vraag ...

apxs -c [-S naam=waarde ] [-o dsobestand ] [-I inclusief ] [-D naam=waarde ] [-L libdir ] [
-l libnaam ] [-Wc,compiler-vlaggen ] [-Wl,linker-vlaggen ] bestanden ...

apxs -i [-S naam=waarde ] [-n modnaam ] [-a ] [-A ] dso-bestand ...

apxs -e [-S naam=waarde ] [-n modnaam ] [-a ] [-A ] dso-bestand ...

OVERZICHT

apxs is een tool voor het bouwen en installeren van uitbreidingsmodules voor de Apache HyperText
Transfer Protocol (HTTP)-server. Dit wordt bereikt door een dynamisch gedeeld object te bouwen
(DSO) van een of meer bronnen of objecten bestanden die vervolgens in de Apache kan worden geladen
server onder runtime via de LoadModule-richtlijn van mod_so.

Dus om dit uitbreidingsmechanisme te gebruiken, moet uw platform de DSO-functie en uw
Apache httpd binary moet gebouwd worden met de mod_so module. De apxs-tool automatisch
klaagt als dit niet het geval is. U kunt dit zelf controleren door de
commando

$ httpd-l

De module mod_so zou deel moeten uitmaken van de weergegeven lijst. Als deze eisen zijn
vervuld, kunt u eenvoudig de functionaliteit van uw Apache-server uitbreiden door uw eigen functionaliteit te installeren
modules met het DSO-mechanisme met behulp van deze apxs-tool:

$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I/pad/naar/apache/include -c mod_foo.c
ld -Bshareable -o mod_foo.so mod_foo.o
cp mod_foo.so /pad/naar/apache/modules/mod_foo.so
chmod 755 /pad/naar/apache/modules/mod_foo.so
[module `foo' activeren in /path/to/apache/etc/httpd.conf]
$ apachectl opnieuw opstarten
/path/to/apache/sbin/apachectl restart: httpd werkt niet, probeert te starten
[din 31 mrt 11:27:55 1998] [foutopsporing] mod_so.c(303): geladen module foo_module
/pad/naar/apache/sbin/apachectl herstart: httpd gestart
$_

de argumenten bestanden kan elk C-bronbestand (.c), een objectbestand (.o) of zelfs een bibliotheek zijn
archief (.a). De apxs-tool herkent deze extensies automatisch en automatisch
gebruikte de C-bronbestanden voor compilatie terwijl alleen de object- en archiefbestanden werden gebruikt
de koppelfase. Maar als u dergelijke vooraf gecompileerde objecten gebruikt, zorg er dan voor dat ze zijn gecompileerd
voor positie-onafhankelijke code (PIC) om ze te kunnen gebruiken voor een dynamisch geladen shared
voorwerp. Bij GCC moet je bijvoorbeeld altijd gewoon -fpic gebruiken. Voor andere C-compilers
raadpleeg de handleidingpagina of bekijk de vlaggen die apxs gebruikt om de objectbestanden te compileren.

Lees voor meer details over DSO-ondersteuning in Apache de documentatie van mod_so of wellicht
lees zelfs het bronbestand src/modules/standard/mod_so.c.

OPTIES

Gemeen Opties
-n modnaam
Dit stelt expliciet de modulenaam in voor de -i (install) en -g (template
generatie) optie. Gebruik dit om expliciet de modulenaam op te geven. Voor optie -g
dit is vereist, voor optie -i probeert de apxs-tool de naam te bepalen van de
source of (als een terugval) in ieder geval door het te raden aan de hand van de bestandsnaam.

Vraag Opties
-q Voert een query uit voor variabelen en omgevingsinstellingen die worden gebruikt om httpd te bouwen. Wanneer
ingeroepen zonder vraag parameters, drukt het alle bekende variabelen en hun waarden af.
De optionele parameter -v formatteert de lijstuitvoer. .PP Gebruik dit om handmatig
instellingen bepalen die worden gebruikt om de httpd te bouwen die uw module zal laden. Bijvoorbeeld
gebruik INC=-I`apxs -q INCLUDIR` .PP in je eigen Makefiles als je een handleiding nodig hebt
toegang tot de C-headerbestanden van Apache.

Configuratie Opties
-S naam=waarde
Deze optie wijzigt de hierboven beschreven apxs-instellingen.

Sjabloon Generatie Opties
-g Dit genereert een submap naam (zie optie -n) en daar twee bestanden: Een voorbeeld
module bronbestand met de naam mod_naam.c die kan worden gebruikt als sjabloon voor het maken
je eigen modules of als een snelle start voor het spelen met het apxs-mechanisme. En een
bijbehorende Makefile voor nog eenvoudiger bouwen en installeren van deze module.

DSO Compilatie Opties
-c Dit geeft de compilatiebewerking aan. Het compileert eerst de C-bronbestanden (.c)
of bestanden in overeenkomstige objectbestanden (.o) en bouwt vervolgens een dynamisch gedeeld
bezwaar in dsobestand door deze objectbestanden plus de overige objectbestanden (.o
en .a) van bestanden. Als er geen optie -o is opgegeven, wordt het uitvoerbestand geraden uit de
eerste bestandsnaam in bestanden en dus meestal standaard naar mod_naam.Dus.

-o dsobestand
Specificeert expliciet de bestandsnaam van het gemaakte dynamisch gedeelde object. Als niet
opgegeven en de naam kan niet worden geraden uit de bestanden lijst, de terugvalnaam
mod_unknown.so wordt gebruikt.

-D naam=waarde
Deze optie wordt direct doorgegeven aan de compilatieopdracht(en). Gebruik dit om
voeg uw eigen definities toe aan het bouwproces.

-I inclusief
Deze optie wordt direct doorgegeven aan de compilatieopdracht(en). Gebruik dit om
voeg uw eigen include-mappen toe om te zoeken naar het bouwproces.

-L libdir
Deze optie wordt direct doorgegeven aan het linkercommando. Gebruik dit om uw toe te voegen
eigen bibliotheekmappen om te zoeken naar het bouwproces.

-l libnaam
Deze optie wordt direct doorgegeven aan het linkercommando. Gebruik dit om uw toe te voegen
eigen bibliotheken om te zoeken naar het bouwproces.

-Wc,compiler-vlaggen
Deze optie gaat voorbij compiler-vlaggen als extra vlaggen voor de libtool --mode=compile
commando. Gebruik dit om lokale compilerspecifieke opties toe te voegen.

-Wl,linker-vlaggen
Deze optie gaat voorbij linker-vlaggen als extra vlaggen voor de libtool --mode=link
commando. Gebruik dit om lokale linkerspecifieke opties toe te voegen.

-p Deze optie zorgt ervoor dat apxs wordt gekoppeld aan de apr/apr-util-bibliotheken. Dit is handig
bij het compileren van helperprogramma's die de apr/apr-util-bibliotheken gebruiken.

DSO Installatie en Configuratie Opties
-i Dit geeft de installatiebewerking aan en installeert een of meer dynamisch
gedeelde objecten naar die van de server modules directory.

-a Dit activeert de module door automatisch een overeenkomstige LoadModule-regel toe te voegen
naar het httpd.conf configuratiebestand van Apache, of door het in te schakelen als het al bestaat.

-A Hetzelfde als optie -a maar de gemaakte LoadModule-richtlijn wordt voorafgegaan door een hekje
​ dat wil zeggen, is de module zojuist voorbereid voor latere activering, maar aanvankelijk uitgeschakeld.

-e Dit geeft de bewerking aan, die kan worden gebruikt met de opties -a en -A
vergelijkbaar met de bewerking -i om het configuratiebestand httpd.conf van Apache te bewerken
zonder te proberen de module te installeren.

Voorbeelden

Stel dat je een Apache-module met de naam mod_foo.c beschikbaar hebt die die van Apache zou moeten uitbreiden
serverfunctionaliteit. Om dit te bereiken moet je eerst de C-bron compileren naar een
gedeeld object dat geschikt is om tijdens runtime in de Apache-server te laden via het volgende
opdracht:

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

Vervolgens moet u de Apache-configuratie bijwerken door ervoor te zorgen dat er een LoadModule-richtlijn is
aanwezig om dit gedeelde object te laden. Om deze stap te vereenvoudigen biedt apxs een automatische manier
om het gedeelde object in de map "modules" te installeren en het bestand httpd.conf bij te werken
overeenkomstig. Dit kan worden bereikt door het uitvoeren van:

$ apxs -i -a mod_foo.la
/pad/naar/instdso.sh mod_foo.la /pad/naar/apache/modules
/pad/naar/libtool --mode=install cp mod_foo.la /pad/naar/apache/modules
...
chmod 755 /pad/naar/apache/modules/mod_foo.so
[module `foo' activeren in /path/to/apache/conf/httpd.conf]
$_

Op deze manier een lijn genaamd

LoadModule foo_module modules/mod_foo.so

wordt toegevoegd aan het configuratiebestand als het nog steeds niet aanwezig is. Als u dit wilt uitschakelen
gebruik standaard de optie -A, dat wil zeggen

$ apxs -i -A mod_foo.c

Voor een snelle test van het apxs-mechanisme kunt u een voorbeeld van een Apache-modulesjabloon plus maken
een bijbehorende Makefile via:

$ apxs -g -n foo
[DIR] foo maken
[FILE] foo/Makefile maken
Aanmaken van [FILE] foo/modules.mk
[BESTAND] foo/mod_foo.c maken
[FILE] foo/.deps maken
$_

Vervolgens kunt u deze voorbeeldmodule onmiddellijk compileren tot een gedeeld object en erin laden
de Apache-server:

$ cd foo
$ zorg ervoor dat alles opnieuw wordt geladen
apxs -c mod_foo.c
/path/to/libtool --mode=compileer gcc ... -c mod_foo.c
/pad/naar/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
apxs -i -a -n "foo" mod_foo.la
/pad/naar/instdso.sh mod_foo.la /pad/naar/apache/modules
/pad/naar/libtool --mode=install cp mod_foo.la /pad/naar/apache/modules
...
chmod 755 /pad/naar/apache/modules/mod_foo.so
[module `foo' activeren in /path/to/apache/conf/httpd.conf]
apachect opnieuw opstarten
/path/to/apache/sbin/apachectl restart: httpd werkt niet, probeert te starten
[din 31 mrt 11:27:55 1998] [foutopsporing] mod_so.c(303): geladen module foo_module
/pad/naar/apache/sbin/apachectl herstart: httpd gestart
$_

Gebruik apxs online met behulp van onworks.net-services