apxs - Online sa Cloud

PROGRAMA:

NAME

apxs - tool ng APache eXtenSion

SINOPSIS

mga apx -g [ -S pangalan=halaga ] -n modname

mga apx -q [ -v ] [ -S pangalan=halaga ] tanong ...

mga apx -c [ -S pangalan=halaga ] [ -o dsofile ] [ -I incdir ] [ -D pangalan=halaga ] [ -L libdir ] [
-l libname ] [ -Wc,compiler-flag ] [ -Wl,linker-flags ] file ...

mga apx -i [ -S pangalan=halaga ] [ -n modname ] [ -a ] [ -A ] dso-file ...

mga apx -e [ -S pangalan=halaga ] [ -n modname ] [ -a ] [ -A ] dso-file ...

BUOD

apxs ay isang tool para sa pagbuo at pag-install ng mga extension module para sa Apache HyperText
Server ng Transfer Protocol (HTTP). Ito ay nakakamit sa pamamagitan ng pagbuo ng isang dynamic na shared object
(DSO) mula sa isa o higit pang pinagmulan o bagay file na pagkatapos ay mai-load sa Apache
server sa ilalim ng runtime sa pamamagitan ng LoadModule na direktiba mula sa mod_so.

Kaya para magamit ang mekanismo ng extension na ito, dapat suportahan ng iyong platform ang tampok na DSO at ang iyong
Ang Apache httpd binary ay kailangang itayo gamit ang mod_so module. Awtomatikong ang apxs tool
nagrereklamo kung hindi ito ang kaso. Maaari mong suriin ito sa iyong sarili sa pamamagitan ng manu-manong pagpapatakbo ng
utos

$ httpd -l

Ang module mod_so ay dapat na bahagi ng ipinapakitang listahan. Kung ang mga kinakailangan na ito ay
natupad madali mong mapalawak ang functionality ng iyong Apache server sa pamamagitan ng pag-install ng sarili mo
mga module na may mekanismo ng DSO sa tulong ng tool na ito ng 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
[pag-activate ng module `foo' sa /path/to/apache/etc/httpd.conf]
$apachectl restart
/path/to/apache/sbin/apachectl restart: httpd hindi tumatakbo, sinusubukang magsimula
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): na-load ang module foo_module
/path/to/apache/sbin/apachectl restart: nagsimula ang httpd
$_

Ang mga argumento file maaaring maging anumang C source file (.c), object file (.o) o kahit isang library
archive (.a). Awtomatikong kinikilala ng apxs tool ang mga extension na ito at awtomatiko
ginamit ang C source file para sa compilation habang ginagamit lang ang object at archive file para sa
ang yugto ng pag-uugnay. Ngunit kapag gumagamit ng mga naturang pre-compiled objects siguraduhing sila ay compiled
para sa position independent code (PIC) para magamit ang mga ito para sa isang dynamic na na-load na nakabahagi
bagay. Halimbawa sa GCC kailangan mo lang gumamit ng -fpic. Para sa iba pang mga C compiler
kumunsulta sa manu-manong pahina nito o sa panonood para sa mga flag na ginagamit ng mga apx upang i-compile ang mga object file.

Para sa higit pang mga detalye tungkol sa suporta ng DSO sa Apache basahin ang dokumentasyon ng mod_so o marahil
kahit na basahin ang src/modules/standard/mod_so.c source file.

Opsyon

Karaniwan Options
-n modname
Ito ay tahasang nagtatakda ng pangalan ng module para sa -i (install) at -g (template
henerasyon) opsyon. Gamitin ito para tahasang tukuyin ang pangalan ng module. Para sa opsyon -g
ito ay kinakailangan, para sa opsyon -i ang apxs tool ay sumusubok na tukuyin ang pangalan mula sa
source o (bilang isang fallback) kahit man lang sa pamamagitan ng paghula nito mula sa filename.

Tanong Options
-q Nagsasagawa ng query para sa mga variable at setting ng kapaligiran na ginamit upang bumuo ng httpd. Kailan
hinihingi nang wala tanong mga parameter, ito ay nagpi-print ng lahat ng mga kilalang variable at ang kanilang mga halaga.
Ang opsyonal na -v parameter ay nagfo-format ng listahan na output. .PP Gamitin ito sa mano-mano
tukuyin ang mga setting na ginamit upang buuin ang httpd na maglo-load ng iyong module. Halimbawa
gamitin ang INC=-I`apxs -q INCLUDEDIR` .PP sa loob ng sarili mong Makefiles kung kailangan mo ng manual
access sa mga file ng C header ng Apache.

Configuration Options
-S pangalan=halaga
Binabago ng opsyong ito ang mga setting ng apx na inilarawan sa itaas.

Template Henerasyon Options
-g Ito ay bumubuo ng isang subdirectory pangalan (tingnan ang opsyon -n) at mayroong dalawang file: Isang sample
module source file na pinangalanang mod_pangalan.c na maaaring gamitin bilang isang template para sa paglikha
sarili mong mga module o bilang isang mabilis na pagsisimula sa paglalaro gamit ang mekanismo ng apxs. At a
kaukulang Makefile para sa mas madaling pagbuo at pag-install ng module na ito.

DSO Pagtitipon Options
-c Ito ay nagpapahiwatig ng compilation operation. Una nitong pinagsama-sama ang mga C source file (.c)
of file sa kaukulang object file (.o) at pagkatapos ay bumuo ng isang dynamic na ibinabahagi
bagay sa dsofile sa pamamagitan ng pag-link sa mga object file na ito kasama ang natitirang object file (.o
at .a) ng file. Kung walang -o na opsyon ay tinukoy ang output file ay nahulaan mula sa
unang filename sa file at sa gayon ay kadalasang nagde-default sa mod_pangalan.kaya.

-o dsofile
Tahasang tinutukoy ang filename ng nilikhang dynamic na nakabahaging object. Kung hindi
tinukoy at hindi mahulaan ang pangalan mula sa file listahan, ang fallback na pangalan
mod_unknown.so ay ginagamit.

-D pangalan=halaga
Direktang ipinapasa ang opsyong ito sa (mga) compilation command. Gamitin ito sa
idagdag ang iyong sariling mga kahulugan sa proseso ng pagbuo.

-I incdir
Direktang ipinapasa ang opsyong ito sa (mga) compilation command. Gamitin ito sa
idagdag ang iyong sariling isama ang mga direktoryo upang maghanap sa proseso ng pagbuo.

-L libdir
Ang opsyong ito ay direktang ipinapasa sa linker command. Gamitin ito upang idagdag ang iyong
sariling mga direktoryo ng aklatan upang maghanap sa proseso ng pagbuo.

-l libname
Ang opsyong ito ay direktang ipinapasa sa linker command. Gamitin ito upang idagdag ang iyong
sariling mga aklatan upang maghanap sa proseso ng pagbuo.

-Wc,compiler-flag
Ang pagpipiliang ito ay pumasa compiler-flag bilang karagdagang mga flag sa libtool --mode=compile
utos. Gamitin ito upang magdagdag ng mga opsyong tukoy sa lokal na compiler.

-Wl,linker-flags
Ang pagpipiliang ito ay pumasa linker-flags bilang karagdagang mga flag sa libtool --mode=link
utos. Gamitin ito upang magdagdag ng mga opsyong tukoy sa lokal na linker.

-p Ang pagpipiliang ito ay nagiging sanhi ng pag-link ng mga apx laban sa mga aklatan ng apr/apr-util. Ito ay kapaki-pakinabang
kapag nag-compile ng mga helper program na gumagamit ng mga library ng apr/apr-util.

DSO instalasyon at Configuration Options
-i Ito ay nagpapahiwatig ng pagpapatakbo ng pag-install at nag-i-install ng isa o higit pa nang pabago-bago
nakabahaging mga bagay sa server module direktoryo.

-a Ina-activate nito ang module sa pamamagitan ng awtomatikong pagdaragdag ng kaukulang linya ng LoadModule
sa httpd.conf configuration file ng Apache, o sa pamamagitan ng pagpapagana nito kung mayroon na ito.

-A Pareho sa opsyon -a ngunit ang ginawang LoadModule na direktiba ay may prefix na hash sign
(#), ibig sabihin, ang module ay inihanda lamang para sa pag-activate sa ibang pagkakataon ngunit sa una ay hindi pinagana.

-e Ito ay nagpapahiwatig ng pagpapatakbo ng pag-edit, na maaaring gamitin sa mga -a at -A na opsyon
katulad ng -i na operasyon upang i-edit ang httpd.conf configuration file ng Apache
nang hindi sinusubukang i-install ang module.

HALIMBAWA

Ipagpalagay na mayroon kang isang Apache module na pinangalanang mod_foo.c na magagamit na dapat na pahabain ang Apache's
pag-andar ng server. Upang magawa ito kailangan mo munang i-compile ang C source sa a
shared object na angkop para sa paglo-load sa Apache server sa ilalim ng runtime sa pamamagitan ng sumusunod
utos:

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

Pagkatapos ay kailangan mong i-update ang configuration ng Apache sa pamamagitan ng pagtiyak na ang isang LoadModule directive ay
naroroon upang i-load ang nakabahaging bagay na ito. Upang pasimplehin ang hakbang na ito, nagbibigay ang mga apx ng awtomatikong paraan
upang i-install ang nakabahaging bagay sa direktoryo nitong "mga module" at i-update ang httpd.conf file
naaayon. Ito ay maaaring makamit sa pamamagitan ng pagpapatakbo:

$ 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
[pag-activate ng module `foo' sa /path/to/apache/conf/httpd.conf]
$_

Sa ganitong paraan isang linya na pinangalanan

LoadModule foo_module modules/mod_foo.so

ay idinaragdag sa configuration file kung wala pa rin. Kung gusto mong i-disable ito
bawat default gamitin ang -A na opsyon, ibig sabihin

$ apxs -i -A mod_foo.c

Para sa isang mabilis na pagsubok ng mekanismo ng apxs maaari kang lumikha ng isang sample na template ng module ng Apache plus
isang kaukulang Makefile sa pamamagitan ng:

$ apxs -g -n foo
Lumilikha ng [DIR] foo
Lumilikha ng [FILE] foo/Makefile
Gumagawa ng [FILE] foo/modules.mk
Gumagawa ng [FILE] foo/mod_foo.c
Ginagawa ang [FILE] foo/.deps
$_

Pagkatapos ay maaari mong agad na i-compile ang sample na module na ito sa isang shared object at i-load ito sa
ang Apache server:

$ cd foo
$ gawin ang lahat ng i-reload
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
[pag-activate ng module `foo' sa /path/to/apache/conf/httpd.conf]
Apachectl restart
/path/to/apache/sbin/apachectl restart: httpd hindi tumatakbo, sinusubukang magsimula
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): na-load ang module foo_module
/path/to/apache/sbin/apachectl restart: nagsimula ang httpd
$_

Gumamit ng mga apx online gamit ang mga serbisyo ng onworks.net