apxs - Online în cloud

PROGRAM:

NUME

apxs - instrument APache eXtenSion

REZUMAT

aprox -g [-S nume=valoare ] -n modname

aprox -q [-v ] [ -S nume=valoare ] întrebare ...

aprox -c [-S nume=valoare ] [ -o dsofile ] [ -I incldir ] [ -D nume=valoare ] [ -L libdir ] [
-l libname ] [ -Toaleta,compilator-steaguri ] [ -Wl,linker-steaguri ] fișiere ...

aprox -i [-S nume=valoare ] [ -n modname ] [ -a ] [ -A ] dso-file ...

aprox -e [-S nume=valoare ] [ -n modname ] [ -a ] [ -A ] dso-file ...

REZUMAT

apxs este un instrument pentru construirea și instalarea modulelor de extensie pentru Apache HyperText
Server de protocol de transfer (HTTP). Acest lucru se realizează prin construirea unui obiect partajat dinamic
(DSO) de la una sau mai multe surse sau obiecte fișiere care apoi poate fi încărcat în Apache
server în runtime prin directiva LoadModule de la mod_so.

Deci, pentru a utiliza acest mecanism de extensie, platforma dvs. trebuie să accepte caracteristica DSO și dvs
Binarul Apache httpd trebuie să fie construit cu modulul mod_so. Instrumentul apxs automat
se plânge dacă nu este cazul. Puteți verifica acest lucru singur rulând manual programul
comandă

$ httpd -l

Modulul mod_so ar trebui să facă parte din lista afișată. Dacă aceste cerinţe sunt
îndeplinită, puteți extinde cu ușurință funcționalitatea serverului dvs. Apache instalându-vă propriul dvs
module cu mecanismul DSO cu ajutorul acestui instrument apxs:

$ 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
[activează modulul `foo' în /path/to/apache/etc/httpd.conf]
$ apachectl reporniți
/path/to/apache/sbin/apachectl restart: httpd nu rulează, încearcă să pornească
[Marți, 31 martie 11:27:55 1998] [depanare] mod_so.c(303): modul încărcat foo_module
/path/to/apache/sbin/apachectl restart: httpd a început
_$

Argumentele fișiere poate fi orice fișier sursă C (.c), un fișier obiect (.o) sau chiar o bibliotecă
arhiva (.a). Instrumentul apxs recunoaște automat aceste extensii și automat
a folosit fișierele sursă C pentru compilare, în timp ce doar a folosit fișierele obiect și arhivă pentru
faza de legătură. Dar atunci când utilizați astfel de obiecte pre-compilate, asigurați-vă că sunt compilate
pentru codul independent de poziție (PIC) pentru a le putea folosi pentru un partajat încărcat dinamic
obiect. De exemplu, cu GCC, trebuie să utilizați întotdeauna -fpic. Pentru alte compilatoare C
consultați pagina sa de manual sau la ceas pentru steagurile pe care apxs le folosește pentru a compila fișierele obiect.

Pentru mai multe detalii despre suportul DSO în Apache, citiți documentația mod_so sau poate
citește chiar și fișierul sursă src/modules/standard/mod_so.c.

OPŢIUNI

Comun Opţiuni
-n modname
Aceasta setează în mod explicit numele modulului pentru -i (instalare) și -g (șablon
generație) opțiunea. Utilizați aceasta pentru a specifica în mod explicit numele modulului. Pentru opțiunea -g
acest lucru este necesar, pentru opțiunea -i instrumentul apxs încearcă să determine numele din
sursă sau (ca alternativă) cel puțin ghicindu-l din numele fișierului.

Întrebare Opţiuni
-q Efectuează o interogare pentru variabile și setări de mediu utilizate pentru a construi httpd. Cand
invocat fără întrebare parametrii, imprimă toate variabilele cunoscute și valorile acestora.
Parametrul opțional -v formatează ieșirea listei. .PP Folosiți acest lucru pentru a manual
determinați setările folosite pentru a construi httpd-ul care vă va încărca modulul. De exemplu
utilizați INC=-I`apxs -q INCLUDEDIR` .PP în propriile dvs. Makefiles dacă aveți nevoie de manual
acces la fișierele de antet C ale Apache.

Configuraţie Opţiuni
-S nume=valoare
Această opțiune modifică setările apxs descrise mai sus.

Format Generație Opţiuni
-g Aceasta generează un subdirector nume (vezi opțiunea -n) și există două fișiere: Un eșantion
fișierul sursă al modulului numit mod_nume.c care poate fi folosit ca șablon pentru creare
propriile module sau ca o pornire rapidă pentru a juca cu mecanismul apxs. Și a
Makefile corespunzător pentru construirea și instalarea și mai ușoară a acestui modul.

DSO Compilation Opţiuni
-c Aceasta indică operația de compilare. Mai întâi compilează fișierele sursă C (.c)
of fișiere în fișierele obiect corespunzătoare (.o) și apoi construiește un partajat dinamic
obiect în dsofile prin conectarea acestor fișiere obiect plus fișierele obiect rămase (.o
iar .a) din fișiere. Dacă nu este specificată nicio opțiune -o, fișierul de ieșire este ghicit din
primul nume de fișier în fișiere și, astfel, de obicei este implicit la mod_nume.asa de.

-o dsofile
Specifică în mod explicit numele de fișier al obiectului partajat dinamic creat. Dacă nu
specificat și numele nu poate fi ghicit din fișiere listă, numele alternativ
este utilizat mod_unknown.so.

-D nume=valoare
Această opțiune este transmisă direct la comenzile de compilare. Folosește asta pentru a
adăugați propriile definiții la procesul de construire.

-I incldir
Această opțiune este transmisă direct la comenzile de compilare. Folosește asta pentru a
adăugați propriile directoare include pentru a căuta în procesul de construire.

-L libdir
Această opțiune este transmisă direct la comanda linker. Utilizați acest lucru pentru a adăuga dvs
propriile directoare de bibliotecă pentru a căuta în procesul de construire.

-l libname
Această opțiune este transmisă direct la comanda linker. Utilizați acest lucru pentru a adăuga dvs
propriile biblioteci pentru a căuta în procesul de construire.

-Toaleta,compilator-steaguri
Această opțiune trece compilator-steaguri ca steaguri suplimentare pentru libtool --mode=compile
comanda. Utilizați aceasta pentru a adăuga opțiuni locale specifice compilatorului.

-Wl,linker-steaguri
Această opțiune trece linker-steaguri ca steaguri suplimentare pentru libtool --mode=link
comanda. Utilizați aceasta pentru a adăuga opțiuni locale specifice linkerului.

-p Această opțiune face ca apxs să se conecteze cu bibliotecile apr/apr-util. Acest lucru este util
la compilarea programelor de ajutor care folosesc bibliotecile apr/apr-util.

DSO Instalare și Configuraţie Opţiuni
-i Aceasta indică operația de instalare și instalează unul sau mai multe dinamic
obiecte partajate în server module director.

-a Acest lucru activează modulul prin adăugarea automată a unei linii LoadModule corespunzătoare
la fișierul de configurare httpd.conf al Apache sau activându-l dacă acesta există deja.

-A La fel ca și opțiunea -a, dar directiva creată LoadModule este prefixată cu un semn hash
(#), de exemplu, modulul este doar pregătit pentru activare ulterioară, dar inițial dezactivat.

-e Aceasta indică operația de editare, care poate fi utilizată cu opțiunile -a și -A
similar cu operația -i pentru a edita fișierul de configurare httpd.conf al Apache
fără a încerca să instalați modulul.

EXEMPLE

Să presupunem că aveți disponibil un modul Apache numit mod_foo.c, care ar trebui să îl extindă pe cel al lui Apache
funcționalitatea serverului. Pentru a realiza acest lucru, mai întâi trebuie să compilați sursa C în a
obiect partajat potrivit pentru încărcare în serverul Apache în timpul de execuție prin următoarele
comanda:

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

Apoi trebuie să actualizați configurația Apache, asigurându-vă că există o directivă LoadModule
prezent pentru a încărca acest obiect partajat. Pentru a simplifica acest pas, apxs oferă o modalitate automată
pentru a instala obiectul partajat în directorul său „module” și pentru a actualiza fișierul httpd.conf
în consecinţă. Acest lucru poate fi realizat rulând:

$ 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
[Activarea modulului `foo' în /path/to/apache/conf/httpd.conf]
_$

În acest fel o linie numită

LoadModule foo_module modules/mod_foo.so

este adăugat la fișierul de configurare dacă încă nu este prezent. Dacă doriți să dezactivați acest lucru
utilizați implicit opțiunea -A, de exemplu

$ apxs -i -A mod_foo.c

Pentru un test rapid al mecanismului apxs, puteți crea un model de șablon de modul Apache plus
un Makefile corespunzător prin:

$ apxs -g -n foo
Se creează [DIR] foo
Se creează [FILE] foo/Makefile
Se creează [FILE] foo/modules.mk
Se creează [FILE] foo/mod_foo.c
Se creează [FILE] foo/.deps
_$

Apoi puteți compila imediat acest exemplu de modul într-un obiect partajat și îl puteți încărca în
serverul Apache:

$ cd foo
$ reîncarcă toate
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
[Activarea modulului `foo' în /path/to/apache/conf/httpd.conf]
reporniți apachectl
/path/to/apache/sbin/apachectl restart: httpd nu rulează, încearcă să pornească
[Marți, 31 martie 11:27:55 1998] [depanare] mod_so.c(303): modul încărcat foo_module
/path/to/apache/sbin/apachectl restart: httpd a început
_$

Utilizați apxs online folosind serviciile onworks.net