apxs - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

apxs - інструмент розширення APache

СИНТАКСИС

apxs -g [ -S ім'я=значення ] -n ім'я моди

apxs -q [ -v ] [ -S ім'я=значення ] запит ...

apxs -c [ -S ім'я=значення ] [ -o dsofile ] [ -I вкл ] [ -D ім'я=значення ] [ -L libdir ] [
-l libname ] [ -Туалет,прапори компілятора ] [ -Wl,лінкер-прапори ] файли ...

apxs -i [ -S ім'я=значення ] [ -n ім'я моди ] [ -a ] [ -A ] dso-файл ...

apxs -e [ -S ім'я=значення ] [ -n ім'я моди ] [ -a ] [ -A ] dso-файл ...

РЕЗЮМЕ

apxs — це інструмент для створення та встановлення модулів розширення для Apache HyperText
Сервер протоколу передачі (HTTP). Це досягається шляхом побудови динамічного спільного об'єкта
(DSO) з одного або кількох джерел або об’єктів файли який потім можна завантажити в Apache
сервер під час виконання за допомогою директиви LoadModule від mod_so.

Отже, щоб використовувати цей механізм розширення, ваша платформа повинна підтримувати функцію DSO і вашу
Двійковий файл Apache httpd має бути створений за допомогою модуля mod_so. Інструмент apxs автоматично
скаржиться, якщо це не так. Ви можете перевірити це самостійно, запустивши вручну
команда

$ httpd -l

Модуль mod_so має бути частиною відображеного списку. Якщо ці вимоги є
Ви можете легко розширити функціональність свого сервера Apache, встановивши свій власний
модулі з механізмом DSO за допомогою цього інструменту apxs:

$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I/шлях/до/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
[активація модуля `foo' в /path/to/apache/etc/httpd.conf]
$ apachectl перезапустити
/path/to/apache/sbin/apachectl restart: httpd не працює, намагається запустити
[Вт, 31 березня 11:27:55 1998] [налагодження] mod_so.c(303): завантажений модуль foo_module
/path/to/apache/sbin/apachectl перезапуск: запущено httpd
$_

Аргументи файли може бути будь-який вихідний файл C (.c), об’єктний файл (.o) або навіть бібліотека
архів (.a). Інструмент apxs автоматично розпізнає ці розширення
використовував вихідні файли C для компіляції, а лише використовував файли об’єкта та архіву для
фаза зв'язування. Але при використанні таких попередньо скомпільованих об’єктів переконайтеся, що вони скомпільовані
для позиції незалежного коду (PIC), щоб мати можливість використовувати їх для динамічно завантажуваного спільного доступу
об'єкт. Наприклад, з GCC вам завжди потрібно просто використовувати -fpic. Для інших компіляторів C
перегляньте його сторінку посібника або дивіться, які прапори використовує apxs для компіляції об’єктних файлів.

Щоб дізнатися більше про підтримку DSO в Apache, прочитайте документацію mod_so або, можливо
навіть прочитати вихідний файл src/modules/standard/mod_so.c.

ВАРІАНТИ

загальний Опції
-n ім'я моди
Це явно встановлює назву модуля для -i (встановлення) і -g (шаблон
генерація) варіант. Використовуйте це, щоб явно вказати назву модуля. Для варіанту -g
це потрібно, для параметра -i інструмент apxs намагається визначити назву з
джерело або (як запасний варіант), принаймні, вгадуючи його з назви файлу.

Запит Опції
-q Виконує запит щодо змінних і параметрів середовища, які використовуються для створення httpd. Коли
викликається без запит параметри, він друкує всі відомі змінні та їх значення.
Додатковий параметр -v форматує вихід списку. .PP Використовуйте це, щоб вручну
визначити параметри, використані для створення httpd, який завантажуватиме ваш модуль. Наприклад
використовуйте INC=-I`apxs -q INCLUDEDIR` .PP у своїх власних Make-файлах, якщо вам потрібен посібник
доступ до заголовних файлів C Apache.

конфігурація Опції
-S ім'я=значення
Цей параметр змінює описані вище налаштування apxs.

шаблон Покоління Опції
-g Це створює підкаталог ім'я (див. параметр -n) і там два файли: Зразок
вихідний файл модуля з назвою mod_ім'я.c, який можна використовувати як шаблон для створення
ваші власні модулі або як швидкий початок для гри з механізмом apxs. І а
відповідний Makefile для ще простішої збірки та встановлення цього модуля.

DSO Compilation Опції
-c Це вказує на операцію компіляції. Спочатку він компілює вихідні файли C (.c)
of файли у відповідні об’єктні файли (.o), а потім створює динамічно спільний файл
об'єкт в dsofile зв’язавши ці об’єктні файли та інші об’єктні файли (.o
і .a) з файли. Якщо параметр -o не вказано, вихідний файл вгадується з файлу
перше ім'я файлу в файли і, таким чином, зазвичай за замовчуванням має значення mod_ім'я.так.

-o dsofile
Явно вказує ім’я файлу створеного динамічно спільного об’єкта. Якщо ні
вказано, і назву неможливо вгадати з файли список, резервна назва
використовується mod_unknown.so.

-D ім'я=значення
Цей параметр безпосередньо передається команді(ям) компіляції. Використовуйте це, щоб
додайте свої власні визначення до процесу збірки.

-I вкл
Цей параметр безпосередньо передається команді(ям) компіляції. Використовуйте це, щоб
додайте власні каталоги включення для пошуку до процесу збірки.

-L libdir
Цей параметр безпосередньо передається команді компонувальника. Використовуйте це, щоб додати свій
власні каталоги бібліотеки для пошуку в процесі збірки.

-l libname
Цей параметр безпосередньо передається команді компонувальника. Використовуйте це, щоб додати свій
власні бібліотеки для пошуку до процесу збірки.

-Туалет,прапори компілятора
Цей варіант проходить прапори компілятора як додаткові прапори до libtool --mode=compile
команда. Використовуйте це, щоб додати локальні параметри компілятора.

-Wl,лінкер-прапори
Цей варіант проходить лінкер-прапори як додаткові прапорці до libtool --mode=link
команда. Використовуйте це, щоб додати локальні параметри компонувальника.

-p Цей параметр змушує apxs зв'язуватися з бібліотеками apr/apr-util. Це корисно
під час компіляції допоміжних програм, які використовують бібліотеки apr/apr-util.

DSO установка та конфігурація Опції
-i Це вказує на операцію встановлення та встановлює один або декілька динамічно
спільні об'єкти на сервері Модулі каталог.

-a Це активує модуль шляхом автоматичного додавання відповідного рядка LoadModule
до файлу конфігурації Apache httpd.conf або увімкнувши його, якщо він уже існує.

-A Те саме, що і параметр -a, але створена директива LoadModule має префікс хеш-знака
(#), тобто, модуль щойно підготовлений до подальшої активації, але спочатку вимкнений.

-e Це вказує на операцію редагування, яку можна використовувати з параметрами -a та -A
аналогічно операції -i для редагування файлу конфігурації Apache httpd.conf
не намагаючись встановити модуль.

ПРИКЛАДИ

Припустимо, у вас є доступний модуль Apache з назвою mod_foo.c, який має розширити Apache
функціональність сервера. Щоб досягти цього, вам спочатку потрібно скомпілювати вихідний код C в a
спільний об'єкт, придатний для завантаження на сервер Apache під час виконання за допомогою наступного
команда:

$ apxs -c mod_foo.c
/шлях/до/libtool --mode=compile gcc ... -c mod_foo.c
/шлях/до/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
$_

Потім ви повинні оновити конфігурацію Apache, переконавшись, що директива LoadModule є
презентувати, щоб завантажити цей спільний об’єкт. Щоб спростити цей крок, apxs забезпечує автоматичний спосіб
для встановлення спільного об'єкта в його каталозі "modules" та оновлення файлу httpd.conf
відповідно. Цього можна досягти, запустивши:

$ 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
[активація модуля `foo' в /path/to/apache/conf/httpd.conf]
$_

Таким чином рядок з іменем

LoadModule foo_module modules/mod_foo.so

додається до файлу конфігурації, якщо все ще немає. Якщо ви хочете, щоб це було вимкнено
за замовчуванням використовуйте параметр -A, тобто

$ apxs -i -A mod_foo.c

Для швидкого тестування механізму apxs ви можете створити зразок шаблону модуля Apache plus
відповідний файл Makefile через:

$ apxs -g -n foo
Створення [DIR] foo
Створення [FILE] foo/Makefile
Створення [FILE] foo/modules.mk
Створення [FILE] foo/mod_foo.c
Створення [FILE] foo/.deps
$_

Потім ви можете негайно зібрати цей зразок модуля в спільний об’єкт і завантажити його
сервер Apache:

$ CD foo
$ зробити все перезавантаження
apxs -c mod_foo.c
/шлях/до/libtool --mode=compile gcc ... -c mod_foo.c
/шлях/до/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
[активація модуля `foo' в /path/to/apache/conf/httpd.conf]
перезапуск apachectl
/path/to/apache/sbin/apachectl restart: httpd не працює, намагається запустити
[Вт, 31 березня 11:27:55 1998] [налагодження] mod_so.c(303): завантажений модуль foo_module
/path/to/apache/sbin/apachectl перезапуск: запущено httpd
$_

Використовуйте apxs онлайн за допомогою служб onworks.net