apxs2 - Online di Cloud

PROGRAM:

NAMA

apxs - alat APache eXtenSion

RINGKASAN

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

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

apxs -c [-S nama=nilai ] [-o dsfile ] [-I termasuk ] [-D nama=nilai ] [-L libdir ] [
-l nama lib ] [-Toilet,bendera-kompiler ] [-wl,bendera penghubung ] arsip ...

apxs -i [-S nama=nilai ] [-n nama mod ] [-a ] [-A ] file dso ...

apxs -e [-S nama=nilai ] [-n nama mod ] [-a ] [-A ] file dso ...

RINGKASAN

apxs adalah alat untuk membangun dan menginstal modul ekstensi untuk Apache HyperText
Server Protokol Transfer (HTTP). Ini dicapai dengan membangun objek bersama yang dinamis
(DSO) dari satu atau lebih sumber atau objek arsip yang kemudian dapat dimuat ke dalam Apache
server di bawah runtime melalui direktif LoadModule dari mod_so.

Jadi untuk menggunakan mekanisme ekstensi ini, platform Anda harus mendukung fitur DSO dan
Biner Apache httpd harus dibangun dengan modul mod_so. Alat apxs secara otomatis
mengeluh jika tidak demikian. Anda dapat memeriksanya sendiri dengan menjalankan secara manual
Command

$httpd-l

Modul mod_so harus menjadi bagian dari daftar yang ditampilkan. Jika persyaratan ini adalah
terpenuhi Anda dapat dengan mudah memperluas fungsionalitas server Apache Anda dengan menginstal sendiri
modul dengan mekanisme DSO dengan bantuan alat apxs ini:

$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I/path/ke/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/ke/Apache/modules/mod_foo.so
[mengaktifkan modul `foo' di /path/to/Apache/etc/httpd.conf]
$apachectl restart
/path/to/Apache/sbin/apachectl restart: httpd tidak berjalan, mencoba memulai
[Sel 31 Mar 11:27:55 1998] [debug] mod_so.c(303): modul yang dimuat foo_module
/path/to/Apache/sbin/apachectl restart: httpd dimulai
$_

Argumen arsip dapat berupa file sumber C (.c), file objek (.o) atau bahkan perpustakaan
arsip (.a). Alat apxs secara otomatis mengenali ekstensi ini dan secara otomatis
menggunakan file sumber C untuk kompilasi sementara hanya menggunakan objek dan file arsip untuk
fase menghubungkan. Tetapi saat menggunakan objek yang telah dikompilasi sebelumnya, pastikan objek tersebut dikompilasi
untuk kode independen posisi (PIC) agar dapat menggunakannya untuk berbagi yang dimuat secara dinamis
obyek. Misalnya dengan GCC Anda selalu hanya perlu menggunakan -fpic. Untuk kompiler C lainnya
lihat halaman manualnya atau perhatikan flag yang digunakan apxs untuk mengkompilasi file objek.

Untuk detail lebih lanjut tentang dukungan DSO di Apache, baca dokumentasi mod_so atau mungkin
bahkan membaca file sumber src/modules/standard/mod_so.c.

PILIHAN

Umum Opsi
-n nama mod
Ini secara eksplisit menetapkan nama modul untuk -i (instal) dan -g (templat
generasi) pilihan. Gunakan ini untuk secara eksplisit menentukan nama modul. Untuk opsi -g
ini diperlukan, untuk opsi -i alat apxs mencoba menentukan nama dari
source atau (sebagai fallback) setidaknya dengan menebaknya dari nama file.

Pertanyaan Opsi
-q Melakukan kueri untuk variabel dan pengaturan lingkungan yang digunakan untuk membangun httpd. Kapan
dipanggil tanpa pertanyaan parameter, ia mencetak semua variabel yang diketahui dan nilainya.
Parameter -v opsional memformat output daftar. .PP Gunakan ini untuk secara manual
tentukan pengaturan yang digunakan untuk membangun httpd yang akan memuat modul Anda. Contohnya
gunakan INC=-I`apxs -q INCLUDEDIR` .PP di dalam Makefile Anda sendiri jika Anda membutuhkan manual
akses ke file header C Apache.

konfigurasi Opsi
-S nama=nilai
Opsi ini mengubah pengaturan apxs yang dijelaskan di atas.

Contoh Generasi Opsi
-g Ini menghasilkan subdirektori nama (lihat opsi -n) dan ada dua file: Contoh
file sumber modul bernama mod_nama.c yang dapat digunakan sebagai template untuk membuat
modul Anda sendiri atau sebagai permulaan cepat untuk bermain dengan mekanisme apxs. Dan
Makefile yang sesuai untuk membuat dan menginstal modul ini dengan lebih mudah.

DSO Kompilasi Opsi
-c Ini menunjukkan operasi kompilasi. Ini pertama mengkompilasi file sumber C (.c)
of arsip ke dalam file objek yang sesuai (.o) dan kemudian membangun file yang dibagikan secara dinamis
objek dalam dsfile dengan menautkan file objek ini ditambah file objek yang tersisa (.o
dan .a) dari arsip. Jika tidak ada opsi -o yang ditentukan, file keluaran akan ditebak dari
nama file pertama di arsip dan dengan demikian biasanya default ke mod_nama.jadi.

-o dsfile
Secara eksplisit menentukan nama file dari objek yang dibagikan secara dinamis yang dibuat. Jika tidak
ditentukan dan namanya tidak dapat ditebak dari arsip daftar, nama cadangan
mod_unknown.so digunakan.

-D nama=nilai
Opsi ini langsung diteruskan ke perintah kompilasi. Gunakan ini untuk
tambahkan definisi Anda sendiri ke proses build.

-I termasuk
Opsi ini langsung diteruskan ke perintah kompilasi. Gunakan ini untuk
tambahkan direktori include Anda sendiri untuk mencari ke proses build.

-L libdir
Opsi ini langsung diteruskan ke perintah linker. Gunakan ini untuk menambahkan
direktori perpustakaan sendiri untuk mencari proses pembuatan.

-l nama lib
Opsi ini langsung diteruskan ke perintah linker. Gunakan ini untuk menambahkan
perpustakaan sendiri untuk mencari proses pembangunan.

-Toilet,bendera-kompiler
Opsi ini lolos bendera-kompiler sebagai flag tambahan ke libtool --mode=compile
memerintah. Gunakan ini untuk menambahkan opsi khusus kompiler lokal.

-Wl,bendera penghubung
Opsi ini lolos bendera penghubung sebagai flag tambahan ke libtool --mode=link
memerintah. Gunakan ini untuk menambahkan opsi khusus tautan lokal.

-p Opsi ini menyebabkan apxs menautkan ke pustaka apr/apr-util. Ini berguna
saat mengkompilasi program pembantu yang menggunakan perpustakaan apr/apr-util.

DSO Instalasi dan konfigurasi Opsi
-i Ini menunjukkan operasi instalasi dan menginstal satu atau lebih secara dinamis
objek bersama ke dalam server modul direktori.

-a Ini mengaktifkan modul dengan secara otomatis menambahkan baris LoadModule yang sesuai
ke file konfigurasi httpd.conf Apache, atau dengan mengaktifkannya jika sudah ada.

-A Sama seperti opsi -a tetapi arahan LoadModule yang dibuat diawali dengan tanda hash
(#), yaitu, modul hanya disiapkan untuk aktivasi nanti tetapi awalnya dinonaktifkan.

-e Ini menunjukkan operasi pengeditan, yang dapat digunakan dengan opsi -a dan -A
mirip dengan operasi -i untuk mengedit file konfigurasi httpd.conf Apache
tanpa mencoba menginstal modul.

CONTOH

Asumsikan Anda memiliki modul Apache bernama mod_foo.c yang tersedia yang seharusnya memperluas modul Apache
fungsionalitas server. Untuk mencapai ini, pertama-tama Anda harus mengkompilasi sumber C menjadi a
objek bersama yang cocok untuk dimuat ke server Apache di bawah runtime melalui yang berikut:
perintah:

$apxs -c mod_foo.c
/path/ke/libtool --mode=compile gcc ... -c mod_foo.c
/path/ke/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
$_

Maka Anda harus memperbarui konfigurasi Apache dengan memastikan direktif LoadModule adalah
hadir untuk memuat objek bersama ini. Untuk menyederhanakan langkah ini, apxs menyediakan cara otomatis
untuk menginstal objek bersama di direktori "modul" dan memperbarui file httpd.conf
demikian. Ini dapat dicapai dengan menjalankan:

$ apxs -i -a mod_foo.la
/path/to/instdso.sh mod_foo.la /path/to/Apache/modules
/path/ke/libtool --mode=install cp mod_foo.la /path/to/Apache/modules
...
chmod 755 /path/ke/Apache/modules/mod_foo.so
[mengaktifkan modul `foo' di /path/to/Apache/conf/httpd.conf]
$_

Dengan cara ini garis bernama

LoadModule modul foo_module/mod_foo.so

ditambahkan ke file konfigurasi jika masih belum ada. Jika Anda ingin menonaktifkan ini
per default gunakan opsi -A, yaitu

$ apxs -i -A mod_foo.c

Untuk pengujian cepat mekanisme apxs, Anda dapat membuat contoh template modul Apache plus
Makefile yang sesuai melalui:

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

Kemudian Anda dapat segera mengkompilasi modul sampel ini menjadi objek bersama dan memuatnya ke dalam
server Apache:

$ cd fo
$ buat semua isi ulang
apxs -c mod_foo.c
/path/ke/libtool --mode=compile gcc ... -c mod_foo.c
/path/ke/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/ke/libtool --mode=install cp mod_foo.la /path/to/Apache/modules
...
chmod 755 /path/ke/Apache/modules/mod_foo.so
[mengaktifkan modul `foo' di /path/to/Apache/conf/httpd.conf]
restart apachectl
/path/to/Apache/sbin/apachectl restart: httpd tidak berjalan, mencoba memulai
[Sel 31 Mar 11:27:55 1998] [debug] mod_so.c(303): modul yang dimuat foo_module
/path/to/Apache/sbin/apachectl restart: httpd dimulai
$_

Gunakan apxs2 online menggunakan layanan onworks.net