apxs - Online nel cloud

PROGRAMMA:

NOME

apxs: strumento di estensione APache

SINOSSI

apxs -g [-S Nome=APPREZZIAMO ]-n nomemod

apxs -q [-v ] [-S Nome=APPREZZIAMO ] domanda ...

apxs -c [-S Nome=APPREZZIAMO ] [-o dsofile ] [-I indir ] [-D Nome=APPREZZIAMO ] [-L libdir ] [
-l nomelib ] [-Bagno,flag del compilatore ] [-Wl,flag del linker ] file ...

apxs -i [-S Nome=APPREZZIAMO ] [-n nomemod ] [-a ] [-A ] dso-file ...

apxs -e [-S Nome=APPREZZIAMO ] [-n nomemod ] [-a ] [-A ] dso-file ...

SOMMARIO

apxs è uno strumento per creare e installare moduli di estensione per Apache HyperText
Server del protocollo di trasferimento (HTTP). Ciò si ottiene costruendo un oggetto condiviso dinamico
(DSO) da una o più sorgenti o oggetti file che poi può essere caricato in Apache
server in fase di runtime tramite la direttiva LoadModule di mod_so.

Quindi, per utilizzare questo meccanismo di estensione, la tua piattaforma deve supportare la funzionalità DSO e il tuo
Il binario httpd di Apache deve essere creato con il modulo mod_so. Lo strumento apxs automaticamente
si lamenta se così non è. Puoi verificarlo tu stesso eseguendo manualmente il file
command

$ httpd -l

Il modulo mod_so dovrebbe far parte dell'elenco visualizzato. Se questi requisiti sono
soddisfatto, puoi facilmente estendere le funzionalità del tuo server Apache installandone uno tuo
moduli con il meccanismo DSO con l'aiuto di questo strumento apxs:

$ apxs -i -a -c mod_pippo.c
gcc -fpic -DSHARED_MODULE -I/percorso/di/apache/include -c mod_foo.c
ld -Bshareable -o mod_foo.so mod_foo.o
cp mod_foo.so /percorso/to/apache/modules/mod_foo.so
chmod 755 /percorso/to/apache/modules/mod_foo.so
[attivando il modulo `foo' in /path/to/apache/etc/httpd.conf]
$ apachectl riavvio
/path/to/apache/sbin/apachectl restart: httpd non in esecuzione, tentativo di avvio
[Mar 31 marzo 11:27:55 1998] [debug] mod_so.c(303): modulo caricato foo_module
/path/to/apache/sbin/apachectl restart: httpd avviato
$ _

Gli argomenti file può essere qualsiasi file sorgente C (.c), un file oggetto (.o) o anche una libreria
archivio (.a). Lo strumento apxs riconosce automaticamente queste estensioni e automaticamente
ha utilizzato i file sorgente C per la compilazione mentre utilizzava solo l'oggetto e i file di archivio per
la fase di collegamento. Ma quando usi tali oggetti precompilati assicurati che siano compilati
per il codice indipendente dalla posizione (PIC) per poterli utilizzare per una condivisione caricata dinamicamente
oggetto. Ad esempio con GCC devi sempre usare -fpic. Per altri compilatori C
consultare la sua pagina man o fare attenzione ai flag che apxs utilizza per compilare i file oggetto.

Per maggiori dettagli sul supporto DSO in Apache leggi la documentazione di mod_so o forse
anche leggere il file sorgente src/modules/standard/mod_so.c.

VERSIONI

Uncommon Opzioni
-n nomemod
Questo imposta esplicitamente il nome del modulo per -i (install) e -g (template
generazione) opzione. Utilizzarlo per specificare esplicitamente il nome del modulo. Per l'opzione -g
questo è richiesto, per l'opzione -i lo strumento apxs tenta di determinare il nome dal file
source o (come fallback) almeno indovinandolo dal nome del file.

domanda Opzioni
-q Esegue una query per le variabili e le impostazioni di ambiente utilizzate per creare httpd. Quando
invocato senza domanda parametri, stampa tutte le variabili conosciute e i loro valori.
Il parametro facoltativo -v formatta l'output dell'elenco. .PP Utilizzare questo per manualmente
determinare le impostazioni utilizzate per creare l'httpd che caricherà il modulo. Ad esempio
usa INC=-I`apxs -q INCLUDEDIR` .PP all'interno dei tuoi Makefile se hai bisogno del manuale
accesso ai file header C di Apache.

Configurazione Opzioni
-S Nome=APPREZZIAMO
Questa opzione modifica le impostazioni di apxs descritte sopra.

Modello Generazione Opzioni
-g Questo genera una sottodirectory Nome (vedi opzione -n) e ci sono due file: A sample
file sorgente del modulo denominato mod_Nome.c che può essere utilizzato come modello per la creazione
i tuoi moduli o come inizio rapido per giocare con il meccanismo apxs. E un
Makefile corrispondente per creare e installare ancora più facilmente questo modulo.

DSO compilazione Opzioni
-c Indica l'operazione di compilazione. Per prima cosa compila i file sorgente C (.c)
of file nei file oggetto corrispondenti (.o) e quindi crea un file condiviso dinamicamente
oggetto in dsofile collegando questi file oggetto più i file oggetto rimanenti (.o
e .a) di file. Se non viene specificata l'opzione -o, il file di output viene indovinato da
primo nome file in file e quindi di solito il valore predefinito è mod_Nome.COSÌ.

-o dsofile
Specifica esplicitamente il nome file dell'oggetto condiviso dinamicamente creato. Altrimenti
specificato e il nome non può essere dedotto dal file file list, il nome di fallback
Viene utilizzato mod_unknown.so.

-D Nome=APPREZZIAMO
Questa opzione viene passata direttamente ai comandi di compilazione. Usa questo per
aggiungi le tue definizioni al processo di compilazione.

-I indir
Questa opzione viene passata direttamente ai comandi di compilazione. Usa questo per
aggiungi le tue directory di inclusione da cercare nel processo di compilazione.

-L libdir
Questa opzione viene passata direttamente al comando del linker. Usa questo per aggiungere il tuo
proprie directory di libreria da cercare nel processo di compilazione.

-l nomelib
Questa opzione viene passata direttamente al comando del linker. Usa questo per aggiungere il tuo
proprie librerie da cercare nel processo di compilazione.

-WC,flag del compilatore
Questa opzione passa flag del compilatore come flag aggiuntivi a libtool --mode=compile
comando. Usalo per aggiungere opzioni locali specifiche del compilatore.

-Wl,flag del linker
Questa opzione passa flag del linker come flag aggiuntivi a libtool --mode=link
comando. Usalo per aggiungere opzioni specifiche del linker locale.

-p Questa opzione fa sì che apxs si colleghi alle librerie apr/apr-util. Questo è utile
durante la compilazione di programmi di supporto che utilizzano le librerie apr/apr-util.

DSO Installazione ed Configurazione Opzioni
-i Indica l'operazione di installazione e ne installa uno o più in modo dinamico
oggetti condivisi nel server moduli directory.

-a Questo attiva il modulo aggiungendo automaticamente una riga LoadModule corrispondente
al file di configurazione httpd.conf di Apache o abilitandolo se già esiste.

-A Come l'opzione -a ma la direttiva LoadModule creata è preceduta da un cancelletto
(#), vale a dire, il modulo è solo preparato per l'attivazione successiva ma inizialmente disabilitato.

-e Indica l'operazione di modifica, che può essere utilizzata con le opzioni -ae -A
in modo simile all'operazione -i per modificare il file di configurazione httpd.conf di Apache
senza tentare di installare il modulo.

ESEMPI

Supponiamo di avere a disposizione un modulo Apache chiamato mod_foo.c che dovrebbe estendere quello di Apache
funzionalità del server. Per ottenere ciò devi prima compilare il sorgente C in a
oggetto condiviso adatto per essere caricato nel server Apache in fase di runtime tramite quanto segue
comando:

$ apxs -c mod_pippo.c
/percorso/del/libtool --mode=compile gcc ... -c mod_foo.c
/percorso/del/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
$ _

Quindi devi aggiornare la configurazione di Apache assicurandoti che ci sia una direttiva LoadModule
presente per caricare questo oggetto condiviso. Per semplificare questo passaggio apxs fornisce un modo automatico
installare l'oggetto condiviso nella sua directory "modules" e aggiornare il file httpd.conf
di conseguenza. Ciò può essere ottenuto eseguendo:

$ apxs -i -a mod_foo.la
/percorso/per/instdso.sh mod_foo.la /percorso/per/apache/modules
/percorso/per/libtool --mode=installa cp mod_foo.la /percorso/per/apache/modules
...
chmod 755 /percorso/to/apache/modules/mod_foo.so
[attivando il modulo `foo' in /path/to/apache/conf/httpd.conf]
$ _

In questo modo una linea denominata

LoadModule foo_module moduli/mod_foo.so

viene aggiunto al file di configurazione se ancora non presente. Se vuoi disabilitarlo
per impostazione predefinita usa l'opzione -A, vale a dire

$ apxs -i -A mod_pippo.c

Per un rapido test del meccanismo apxs puoi creare un modello di modulo Apache plus
un Makefile corrispondente tramite:

$ apxs -g -n foo
Creazione di [DIR] foo
Creazione di [FILE] foo/Makefile
Creazione del [FILE] foo/modules.mk
Creazione del [FILE] foo/mod_foo.c
Creazione del [FILE] foo/.deps
$ _

Quindi puoi immediatamente compilare questo modulo di esempio in un oggetto condiviso e caricarlo
il server Apache:

$ cd foo
$ fai ricaricare tutto
apxs -c mod_pippo.c
/percorso/del/libtool --mode=compile gcc ... -c mod_foo.c
/percorso/del/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
apxs -i -a -n "foo" mod_foo.la
/percorso/per/instdso.sh mod_foo.la /percorso/per/apache/modules
/percorso/per/libtool --mode=installa cp mod_foo.la /percorso/per/apache/modules
...
chmod 755 /percorso/to/apache/modules/mod_foo.so
[attivando il modulo `foo' in /path/to/apache/conf/httpd.conf]
apachectl riavvio
/path/to/apache/sbin/apachectl restart: httpd non in esecuzione, tentativo di avvio
[Mar 31 marzo 11:27:55 1998] [debug] mod_so.c(303): modulo caricato foo_module
/path/to/apache/sbin/apachectl restart: httpd avviato
$ _

Utilizza apxs online utilizzando i servizi onworks.net