apxs - Dalam talian dalam Awan

JADUAL:

NAMA

apxs - Alat eXtenSion APache

SINOPSIS

apx -g [ -S nama=nilai ] -n nama mod

apx -q [ -v ] [ -S nama=nilai ] pertanyaan ...

apx -c [ -S nama=nilai ] [ -o dsofile ] [ -I incdir ] [ -D nama=nilai ] [ -L libdir ] [
-l libname ] [ -Wc,pengkompil-bendera ] [ -Wl,penghubung-bendera ] fail ...

apx -i [ -S nama=nilai ] [ -n nama mod ] [ -a ] [ -A ] fail dso ...

apx -e [ -S nama=nilai ] [ -n nama mod ] [ -a ] [ -A ] fail dso ...

RINGKASAN

apxs ialah alat untuk membina dan memasang modul sambungan untuk Apache HyperText
Pelayan Transfer Protocol (HTTP). Ini dicapai dengan membina objek kongsi dinamik
(DSO) daripada satu atau lebih sumber atau objek fail yang kemudiannya boleh dimuatkan ke dalam Apache
pelayan di bawah runtime melalui arahan LoadModule daripada mod_so.

Jadi untuk menggunakan mekanisme sambungan ini, platform anda perlu menyokong ciri DSO dan anda
Perduaan httpd Apache perlu dibina dengan modul mod_so. Alat apxs secara automatik
mengadu jika ini tidak berlaku. Anda boleh menyemak ini sendiri dengan menjalankan secara manual
arahan

$ httpd -l

Modul mod_so harus menjadi sebahagian daripada senarai yang dipaparkan. Jika keperluan ini
dipenuhi anda boleh dengan mudah memanjangkan kefungsian pelayan Apache anda dengan memasang anda sendiri
modul dengan mekanisme DSO dengan bantuan alat apxs ini:

$ 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
[mengaktifkan modul `foo' dalam /path/to/apache/etc/httpd.conf]
$ Apachectl mulakan semula
/path/to/apache/sbin/apachectl restart: httpd tidak berjalan, cuba untuk bermula
[Selasa 31 Mac 11:27:55 1998] [nyahpepijat] mod_so.c(303): memuatkan modul foo_module
/path/to/apache/sbin/apachectl restart: httpd bermula
$_

Hujah-hujah fail boleh menjadi mana-mana fail sumber C (.c), fail objek (.o) atau pun perpustakaan
arkib (.a). Alat apxs secara automatik mengenali sambungan ini dan secara automatik
menggunakan fail sumber C untuk penyusunan sementara hanya menggunakan objek dan fail arkib untuk
fasa penghubung. Tetapi apabila menggunakan objek pra-disusun sedemikian pastikan ia disusun
untuk kod bebas kedudukan (PIC) untuk dapat menggunakannya untuk perkongsian yang dimuatkan secara dinamik
objek. Contohnya dengan GCC anda sentiasa perlu menggunakan -fpic. Untuk penyusun C lain
rujuk halaman manualnya atau perhatikan bendera yang digunakan apx untuk menyusun fail objek.

Untuk butiran lanjut tentang sokongan DSO dalam Apache, baca dokumentasi mod_so atau mungkin
malah membaca fail sumber src/modules/standard/mod_so.c.

PILIHAN

Common Pilihan
-n nama mod
Ini secara eksplisit menetapkan nama modul untuk -i (pasang) dan -g (template
generasi) pilihan. Gunakan ini untuk menyatakan secara eksplisit nama modul. Untuk pilihan -g
ini diperlukan, untuk pilihan -i alat apxs cuba menentukan nama daripada
sumber atau (sebagai sandaran) sekurang-kurangnya dengan meneka dari nama fail.

Query Pilihan
-q Melakukan pertanyaan untuk pembolehubah dan tetapan persekitaran yang digunakan untuk membina httpd. Bila
dipanggil tanpa pertanyaan parameter, ia mencetak semua pembolehubah yang diketahui dan nilainya.
Parameter -v pilihan memformat output senarai. .PP Gunakan ini untuk secara manual
tentukan tetapan yang digunakan untuk membina httpd yang akan memuatkan modul anda. Contohnya
gunakan INC=-I`apxs -q INCLUDEDIR` .PP di dalam Makefiles anda sendiri jika anda memerlukan manual
akses kepada fail pengepala C Apache.

konfigurasi Pilihan
-S nama=nilai
Pilihan ini menukar tetapan apx yang diterangkan di atas.

Templat Generasi Pilihan
-g Ini menjana subdirektori nama (lihat pilihan -n) dan terdapat dua fail: Sampel
fail sumber modul bernama mod_nama.c yang boleh digunakan sebagai templat untuk mencipta
modul anda sendiri atau sebagai permulaan pantas untuk bermain dengan mekanisme apxs. Dan a
Makefile yang sepadan untuk membina dan memasang modul ini dengan lebih mudah.

DSO Penyusunan Pilihan
-c Ini menunjukkan operasi penyusunan. Ia mula-mula menyusun fail sumber C (.c)
of fail ke dalam fail objek yang sepadan (.o) dan kemudian membina perkongsian secara dinamik
objek di dsofile dengan memautkan fail objek ini serta fail objek yang selebihnya (.o
dan .a) daripada fail. Jika tiada pilihan -o ditentukan, fail output diteka dari
nama fail pertama dalam fail dan oleh itu biasanya lalai kepada mod_nama.so.

-o dsofile
Secara eksplisit menyatakan nama fail bagi objek kongsi dinamik yang dicipta. Jika tidak
dinyatakan dan nama tidak boleh diteka daripada fail senarai, nama sandaran
mod_unknown.so digunakan.

-D nama=nilai
Pilihan ini dihantar terus ke arahan kompilasi. Gunakan ini untuk
tambahkan takrif anda sendiri pada proses binaan.

-I incdir
Pilihan ini dihantar terus ke arahan kompilasi. Gunakan ini untuk
tambah direktori sertakan anda sendiri untuk mencari proses binaan.

-L libdir
Pilihan ini dihantar terus ke arahan pemaut. Gunakan ini untuk menambah anda
direktori perpustakaan sendiri untuk mencari proses binaan.

-l libname
Pilihan ini dihantar terus ke arahan pemaut. Gunakan ini untuk menambah anda
perpustakaan sendiri untuk mencari proses binaan.

-Wc,pengkompil-bendera
Pilihan ini berlalu pengkompil-bendera sebagai bendera tambahan kepada libtool --mode=compile
perintah. Gunakan ini untuk menambah pilihan khusus pengkompil tempatan.

-Wl,penghubung-bendera
Pilihan ini berlalu penghubung-bendera sebagai bendera tambahan kepada libtool --mode=link
perintah. Gunakan ini untuk menambah pilihan khusus pemaut setempat.

-p Pilihan ini menyebabkan apx untuk dipautkan dengan perpustakaan apr/apr-util. Ini berguna
apabila menyusun atur cara pembantu yang menggunakan perpustakaan apr/apr-util.

DSO Pemasangan and konfigurasi Pilihan
-i Ini menunjukkan operasi pemasangan dan memasang satu atau lebih secara dinamik
berkongsi objek ke dalam pelayan modul direktori.

-a Ini mengaktifkan modul dengan menambah baris LoadModule yang sepadan secara automatik
ke fail konfigurasi httpd.conf Apache, atau dengan mendayakannya jika ia sudah wujud.

-A Sama seperti pilihan -a tetapi arahan LoadModule yang dibuat diawali dengan tanda cincang
(#), iaitu, modul hanya disediakan untuk pengaktifan kemudian tetapi pada mulanya dilumpuhkan.

-e Ini menunjukkan operasi penyuntingan, yang boleh digunakan dengan pilihan -a dan -A
sama seperti operasi -i untuk mengedit fail konfigurasi httpd.conf Apache
tanpa cuba memasang modul.

CONTOH

Andaikan anda mempunyai modul Apache bernama mod_foo.c tersedia yang sepatutnya memanjangkan Apache
fungsi pelayan. Untuk mencapai ini anda perlu menyusun sumber C ke dalam a
objek kongsi yang sesuai untuk dimuatkan ke dalam pelayan Apache di bawah masa jalan melalui perkara berikut
arahan:

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

Kemudian anda perlu mengemas kini konfigurasi Apache dengan memastikan arahan LoadModule adalah
hadir untuk memuatkan objek kongsi ini. Untuk memudahkan langkah ini, apx menyediakan cara automatik
untuk memasang objek kongsi dalam direktori "modul" dan mengemas kini fail httpd.conf
sewajarnya. Ini boleh dicapai dengan menjalankan:

$ 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
[mengaktifkan modul `foo' dalam /path/to/apache/conf/httpd.conf]
$_

Dengan cara ini baris dinamakan

LoadModule modul foo_module/mod_foo.so

ditambahkan pada fail konfigurasi jika masih tidak ada. Jika anda ingin melumpuhkan ini
setiap lalai gunakan pilihan -A, iaitu

$ apxs -i -A mod_foo.c

Untuk ujian pantas mekanisme apxs anda boleh mencipta contoh templat modul Apache ditambah
Makefile yang sepadan melalui:

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

Kemudian anda boleh segera menyusun modul sampel ini ke dalam objek kongsi dan memuatkannya ke dalam
pelayan Apache:

$ cd foo
$ buat semua muat semula
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
[mengaktifkan modul `foo' dalam /path/to/apache/conf/httpd.conf]
apachectl mulakan semula
/path/to/apache/sbin/apachectl restart: httpd tidak berjalan, cuba untuk bermula
[Selasa 31 Mac 11:27:55 1998] [nyahpepijat] mod_so.c(303): memuatkan modul foo_module
/path/to/apache/sbin/apachectl restart: httpd bermula
$_

Gunakan apx dalam talian menggunakan perkhidmatan onworks.net