apxs - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

apxs - công cụ eXtenSion của APache

SYNOPSIS

apx -g [-S tên=giá trị ] -n tên mod

apx -q [-v ] [-S tên=giá trị ] truy vấn hữu ích. Cảm ơn !

apx -c [-S tên=giá trị ] [-o tập tin dso ] [-I bao gồm ] [-D tên=giá trị ] [-L thư viện ] [
-l tên thư viện ] [-Wctrình biên dịch-cờ ] [-Ờ,liên kết-cờ ] các tập tin hữu ích. Cảm ơn !

apx -i [-S tên=giá trị ] [-n tên mod ] [-a ] [-A ] tệp dso hữu ích. Cảm ơn !

apx -e [-S tên=giá trị ] [-n tên mod ] [-a ] [-A ] tệp dso hữu ích. Cảm ơn !

TÓM TẮT

apxs là một công cụ để xây dựng và cài đặt các mô-đun mở rộng cho Siêu văn bản Apache
Máy chủ Giao thức truyền (HTTP). Điều này đạt được bằng cách xây dựng một đối tượng chia sẻ động
(DSO) từ một hoặc nhiều nguồn hoặc đối tượng các tập tin sau đó có thể được tải vào Apache
máy chủ trong thời gian chạy thông qua chỉ thị LoadModule từ mod_so.

Vì vậy, để sử dụng cơ chế tiện ích mở rộng này, nền tảng của bạn phải hỗ trợ tính năng DSO và
Apache httpd binary phải được xây dựng bằng mô-đun mod_so. Công cụ apxs tự động
khiếu nại nếu đây không phải là trường hợp. Bạn có thể tự mình kiểm tra điều này bằng cách chạy thủ công
lệnh

$ httpd -l

Mô-đun mod_so phải là một phần của danh sách được hiển thị. Nếu những yêu cầu này là
hoàn thành, bạn có thể dễ dàng mở rộng chức năng của máy chủ Apache bằng cách cài đặt của riêng bạn
mô-đun với cơ chế DSO nhờ sự trợ giúp của công cụ apxs này:

$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I / path / to / apache / include -c mod_foo.c
ld -Có thể chia sẻ -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
[kích hoạt mô-đun `foo 'trong /path/to/apache/etc/httpd.conf]
$ apachectl khởi động lại
/ path / to / apache / sbin / apachectl restart: httpd not running, try to start
[Thứ Ba, 31:11:27, ngày 55 tháng 1998 năm XNUMX] [gỡ lỗi] mod_so.c(303): mô-đun đã tải foo_module
/ path / to / apache / sbin / apachectl restart: httpd started
$_

Các đối số các tập tin có thể là bất kỳ tệp nguồn C nào (.c), tệp đối tượng (.o) hoặc thậm chí là một thư viện
kho lưu trữ (.a). Công cụ apxs tự động nhận dạng các tiện ích mở rộng này và tự động
đã sử dụng tệp nguồn C để biên dịch trong khi chỉ sử dụng đối tượng và tệp lưu trữ cho
giai đoạn liên kết. Nhưng khi sử dụng các đối tượng được biên dịch trước như vậy, hãy đảm bảo rằng chúng được biên dịch
cho mã độc lập vị trí (PIC) để có thể sử dụng chúng cho một chia sẻ được tải động
sự vật. Ví dụ với GCC, bạn luôn phải sử dụng -fpic. Đối với các trình biên dịch C khác
tham khảo trang hướng dẫn sử dụng của nó hoặc xem apxs cờ sử dụng để biên dịch các tệp đối tượng.

Để biết thêm chi tiết về hỗ trợ DSO trong Apache, hãy đọc tài liệu của mod_so hoặc có thể
thậm chí đọc tệp nguồn src / modules / standard / mod_so.c.

LỰA CHỌN

Chung Các lựa chọn
-n tên mod
Điều này đặt tên mô-đun một cách rõ ràng cho -i (cài đặt) và -g (mẫu
thế hệ) tùy chọn. Sử dụng điều này để chỉ định rõ ràng tên mô-đun. Đối với tùy chọn -g
điều này là bắt buộc, đối với tùy chọn -i, công cụ apxs cố gắng xác định tên từ
nguồn hoặc (dưới dạng dự phòng) ít nhất bằng cách đoán nó từ tên tệp.

Query Các lựa chọn
-q Thực hiện truy vấn cho các biến và cài đặt môi trường được sử dụng để xây dựng httpd. Khi nào
được gọi mà không có truy vấn tham số, nó in ra tất cả các biến đã biết và giá trị của chúng.
Tham số -v tùy chọn định dạng đầu ra danh sách. .PP Sử dụng cái này để thủ công
xác định cài đặt được sử dụng để tạo httpd sẽ tải mô-đun của bạn. Ví dụ
sử dụng INC = -I`apxs -q INCLUDEDIR` .PP bên trong Trang điểm của riêng bạn nếu bạn cần hướng dẫn sử dụng
truy cập vào các tệp tiêu đề C của Apache.

Cấu hình Các lựa chọn
-S tên=giá trị
Tùy chọn này thay đổi cài đặt apx được mô tả ở trên.

Template Thế hệ Các lựa chọn
-g Điều này tạo ra một thư mục con tên (xem tùy chọn -n) và có hai tệp: Một mẫu
tệp nguồn mô-đun có tên mod_tên.c có thể được sử dụng làm mẫu để tạo
mô-đun của riêng bạn hoặc để bắt đầu nhanh chóng để chơi với cơ chế apxs. Và một
Makefile tương ứng để xây dựng và cài đặt mô-đun này dễ dàng hơn.

DSO Biên soạn Các lựa chọn
-c Điều này cho biết hoạt động biên dịch. Đầu tiên nó biên dịch các tệp nguồn C (.c)
of các tập tin vào các tệp đối tượng tương ứng (.o) và sau đó xây dựng một chia sẻ động
đối tượng trong tập tin dso bằng cách liên kết các tệp đối tượng này với các tệp đối tượng còn lại (.o
và .a) trong tổng số các tập tin. Nếu tùy chọn no -o được chỉ định, tệp đầu ra được đoán từ
tên tệp đầu tiên trong các tập tin và do đó thường mặc định là mod_tên.vì thế.

-o tập tin dso
Chỉ định rõ ràng tên tệp của đối tượng được chia sẻ động đã tạo. Nếu không
được chỉ định và không thể đoán tên từ các tập tin danh sách, tên dự phòng
mod_unknown.so được sử dụng.

-D tên=giá trị
Tùy chọn này được chuyển trực tiếp đến (các) lệnh biên dịch. Sử dụng cái này để
thêm các định nghĩa của riêng bạn vào quá trình xây dựng.

-I bao gồm
Tùy chọn này được chuyển trực tiếp đến (các) lệnh biên dịch. Sử dụng cái này để
thêm các thư mục bao gồm của riêng bạn để tìm kiếm trong quá trình xây dựng.

-L thư viện
Tùy chọn này được chuyển trực tiếp đến lệnh trình liên kết. Sử dụng cái này để thêm
các thư mục thư viện riêng để tìm kiếm trong quá trình xây dựng.

-l tên thư viện
Tùy chọn này được chuyển trực tiếp đến lệnh trình liên kết. Sử dụng cái này để thêm
thư viện riêng để tìm kiếm trong quá trình xây dựng.

-Wc,trình biên dịch-cờ
Tùy chọn này vượt qua trình biên dịch-cờ dưới dạng các cờ bổ sung cho libtool --mode = compile
chỉ huy. Sử dụng điều này để thêm các tùy chọn dành riêng cho trình biên dịch cục bộ.

- Tôi,liên kết-cờ
Tùy chọn này vượt qua liên kết-cờ dưới dạng các cờ bổ sung cho liên kết libtool --mode =
chỉ huy. Sử dụng điều này để thêm các tùy chọn dành riêng cho trình liên kết cục bộ.

-p Tùy chọn này khiến các apx liên kết với các thư viện apr / apr-use. Cái này hữu ích
khi biên dịch các chương trình trợ giúp sử dụng các thư viện apr / apr-use.

DSO của DINTEK và Cấu hình Các lựa chọn
-i Điều này cho biết hoạt động cài đặt và cài đặt một hoặc nhiều động
các đối tượng được chia sẻ vào máy chủ của mô-đun thư mục.

-a Điều này kích hoạt mô-đun bằng cách tự động thêm một dòng LoadModule tương ứng
vào tệp cấu hình httpd.conf của Apache hoặc bằng cách bật tệp nếu nó đã tồn tại.

- Tương tự như tùy chọn -a nhưng chỉ thị LoadModule được tạo có tiền tố là dấu thăng
(#), tức là, mô-đun chỉ được chuẩn bị để kích hoạt sau này nhưng ban đầu bị vô hiệu hóa.

-e Điều này cho biết thao tác chỉnh sửa, có thể được sử dụng với các tùy chọn -a và -A
tương tự như thao tác -i để chỉnh sửa tệp cấu hình httpd.conf của Apache
mà không cố gắng cài đặt mô-đun.

VÍ DỤ

Giả sử bạn có sẵn một mô-đun Apache có tên là mod_foo.c, mô-đun này sẽ mở rộng
chức năng máy chủ. Để thực hiện điều này, trước tiên bạn phải biên dịch nguồn C thành
đối tượng được chia sẻ phù hợp để tải vào máy chủ Apache trong thời gian chạy thông qua phần sau
chỉ huy:

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

Sau đó, bạn phải cập nhật cấu hình Apache bằng cách đảm bảo rằng chỉ thị LoadModule là
trình bày để tải đối tượng được chia sẻ này. Để đơn giản hóa bước này, apxs cung cấp một cách tự động
để cài đặt đối tượng được chia sẻ trong thư mục "mô-đun" của nó và cập nhật tệp httpd.conf
cho phù hợp. Điều này có thể đạt được bằng cách chạy:

$ 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
hữu ích. Cảm ơn !
chmod 755 /path/to/apache/modules/mod_foo.so
[kích hoạt mô-đun `foo 'trong /path/to/apache/conf/httpd.conf]
$_

Theo cách này, một dòng có tên

LoadModule foo_module modules / mod_foo.so

được thêm vào tệp cấu hình nếu vẫn không xuất hiện. Nếu bạn muốn tắt tính năng này
theo mặc định, sử dụng tùy chọn -A, tức là

$ apxs -i -A mod_foo.c

Để kiểm tra nhanh cơ chế apxs, bạn có thể tạo một mẫu mô-đun Apache mẫu cộng
một Makefile tương ứng qua:

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

Sau đó, bạn có thể ngay lập tức biên dịch mô-đun mẫu này thành một đối tượng được chia sẻ và tải nó vào
máy chủ Apache:

$ cd foo
$ làm cho tất cả tải lại
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
hữu ích. Cảm ơn !
chmod 755 /path/to/apache/modules/mod_foo.so
[kích hoạt mô-đun `foo 'trong /path/to/apache/conf/httpd.conf]
khởi động lại apachectl
/ path / to / apache / sbin / apachectl restart: httpd not running, try to start
[Thứ Ba, 31:11:27, ngày 55 tháng 1998 năm XNUMX] [gỡ lỗi] mod_so.c(303): mô-đun đã tải foo_module
/ path / to / apache / sbin / apachectl restart: httpd started
$_

Sử dụng các apx trực tuyến bằng các dịch vụ onworks.net