apxs - En ligne dans le Cloud

PROGRAMME:

Nom

apxs - outil d'extension APache

SYNOPSIS

apx -g [ -S prénom=Plus-value ] -n nom de mod

apx -q [ -v ] [-S prénom=Plus-value ] question

apx -c [ -S prénom=Plus-value ] [-o dsofichier ] [-I Incdir ] [-D prénom=Plus-value ] [-L libdir ] [
-l nomlib ] [-Toilettes,drapeaux-compilateur ] [-Wl,linker-drapeaux ] fichiers

apx -i [ -S prénom=Plus-value ] [-n nom de mod ] [-a ] [-A ] dso-fichier

apx -e [ -S prénom=Plus-value ] [-n nom de mod ] [-a ] [-A ] dso-fichier

RÉSUMÉ

apxs est un outil pour construire et installer des modules d'extension pour Apache HyperText
Serveur de protocole de transfert (HTTP). Ceci est réalisé en construisant un objet partagé dynamique
(DSO) d'une ou plusieurs source ou objet fichiers qui peut ensuite être chargé dans Apache
serveur sous runtime via la directive LoadModule de mod_so.

Donc, pour utiliser ce mécanisme d'extension, votre plate-forme doit prendre en charge la fonctionnalité DSO et votre
Le binaire Apache httpd doit être construit avec le module mod_so. L'outil apxs automatiquement
se plaint si ce n'est pas le cas. Vous pouvez le vérifier vous-même en exécutant manuellement le
commander

$ httpd -l

Le module mod_so devrait faire partie de la liste affichée. Si ces exigences sont
rempli, vous pouvez facilement étendre les fonctionnalités de votre serveur Apache en installant votre propre
modules avec le mécanisme DSO à l'aide de cet outil apxs :

$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I/chemin/vers/apache/include -c mod_foo.c
ld -Bshareable -o mod_foo.so mod_foo.o
cp mod_foo.so /chemin/vers/apache/modules/mod_foo.so
chmod 755 /chemin/vers/apache/modules/mod_foo.so
[activation du module `foo' dans /path/to/apache/etc/httpd.conf]
$ apachectl redémarrer
/path/to/apache/sbin/apachectl restart : httpd ne fonctionne pas, essaie de démarrer
[Mar 31 11:27:55 1998] [débogage] mod_so.c(303) : module chargé foo_module
/chemin/vers/apache/sbin/apachectl redémarrer : httpd démarré
$ _

Les arguments fichiers peut être n'importe quel fichier source C (.c), un fichier objet (.o) ou même une bibliothèque
archive (.a). L'outil apxs reconnaît automatiquement ces extensions et automatiquement
utilisé les fichiers source C pour la compilation tout en utilisant simplement les fichiers objet et archive pour
la phase de liaison. Mais lorsque vous utilisez de tels objets précompilés, assurez-vous qu'ils sont compilés
pour le code indépendant de la position (PIC) pour pouvoir les utiliser pour un partage chargé dynamiquement
objet. Par exemple, avec GCC, vous devez toujours utiliser -fpic. Pour les autres compilateurs C
consultez sa page de manuel ou sur surveillez les drapeaux qu'apxs utilise pour compiler les fichiers objets.

Pour plus de détails sur le support DSO dans Apache, lisez la documentation de mod_so ou peut-être
même lire le fichier source src/modules/standard/mod_so.c.

OPTIONS

Commun Options
-n nom de mod
Cela définit explicitement le nom du module pour les -i (installation) et -g (modèle
génération). Utilisez ceci pour spécifier explicitement le nom du module. Pour l'option -g
ceci est requis, pour l'option -i, l'outil apxs essaie de déterminer le nom à partir du
source ou (comme solution de repli) au moins en le devinant à partir du nom de fichier.

Question Options
-q Exécute une requête pour les variables et les paramètres d'environnement utilisés pour construire httpd. Lorsque
invoqué sans question paramètres, il imprime toutes les variables connues et leurs valeurs.
Le paramètre facultatif -v formate la sortie de la liste. .PP Utilisez-le pour manuellement
déterminer les paramètres utilisés pour construire le httpd qui chargera votre module. Par exemple
utilisez INC=-I`apxs -q INCLUDEDIR` .PP dans vos propres Makefiles si vous avez besoin du manuel
accès aux fichiers d'en-tête C d'Apache.

Configuration Options
-S prénom=Plus-value
Cette option modifie les paramètres apxs décrits ci-dessus.

Modèle Generation Options
-g Cela génère un sous-répertoire prénom (voir option -n) et là deux fichiers : Un exemple
fichier source du module nommé mod_prénom.c qui peut être utilisé comme modèle pour créer
vos propres modules ou comme démarrage rapide pour jouer avec le mécanisme apxs. Et un
Makefile correspondant pour une construction et une installation encore plus faciles de ce module.

DSO Compilation Options
-c Ceci indique l'opération de compilation. Il compile d'abord les fichiers source C (.c)
of fichiers dans les fichiers objet correspondants (.o), puis crée un fichier partagé dynamiquement
objet dans dsofichier en liant ces fichiers objets plus les fichiers objets restants (.o
et .a) de fichiers. Si aucune option -o n'est spécifiée, le fichier de sortie est deviné à partir du
premier nom de fichier dans fichiers et est donc généralement par défaut mod_prénom.donc.

-o dsofichier
Spécifie explicitement le nom de fichier de l'objet partagé dynamiquement créé. Si non
spécifié et le nom ne peut pas être deviné à partir du fichiers liste, le nom de secours
mod_unknown.so est utilisé.

-D prénom=Plus-value
Cette option est directement transmise à la ou aux commandes de compilation. Utilisez ceci pour
ajoutez vos propres définitions au processus de construction.

-I Incdir
Cette option est directement transmise à la ou aux commandes de compilation. Utilisez ceci pour
ajoutez vos propres répertoires d'inclusion pour rechercher dans le processus de génération.

-L libdir
Cette option est directement transmise à la commande de l'éditeur de liens. Utilisez-le pour ajouter votre
propres répertoires de bibliothèque pour rechercher le processus de construction.

-l nomlib
Cette option est directement transmise à la commande de l'éditeur de liens. Utilisez-le pour ajouter votre
propres bibliothèques pour rechercher dans le processus de construction.

-Toilettes,drapeaux-compilateur
Cette option passe drapeaux-compilateur en tant qu'indicateurs supplémentaires pour le libtool --mode=compile
commander. Utilisez-le pour ajouter des options locales spécifiques au compilateur.

-Wl,linker-drapeaux
Cette option passe linker-drapeaux en tant qu'indicateurs supplémentaires pour le libtool --mode=link
commander. Utilisez ceci pour ajouter des options spécifiques à l'éditeur de liens local.

-p Cette option provoque le lien entre apxs et les bibliothèques apr/apr-util. C'est utile
lors de la compilation de programmes d'aide qui utilisent les bibliothèques apr/apr-util.

DSO Installation et Configuration Options
-i Ceci indique l'opération d'installation et installe un ou plusieurs dynamiquement
objets partagés dans le serveur modules répertoire.

-a Ceci active le module en ajoutant automatiquement une ligne LoadModule correspondante
au fichier de configuration httpd.conf d'Apache, ou en l'activant s'il existe déjà.

-A Identique à l'option -a mais la directive LoadModule créée est préfixée par un signe dièse
(#), à, le module est juste préparé pour une activation ultérieure mais initialement désactivé.

-e Ceci indique l'opération d'édition, qui peut être utilisée avec les options -a et -A
de la même manière que l'opération -i pour éditer le fichier de configuration httpd.conf d'Apache
sans essayer d'installer le module.

EXEMPLES

Supposons que vous ayez un module Apache nommé mod_foo.c disponible qui devrait étendre Apache
fonctionnalité du serveur. Pour ce faire, vous devez d'abord compiler le source C dans un
objet partagé adapté pour le chargement dans le serveur Apache sous runtime via le suivant
commander:

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

Ensuite, vous devez mettre à jour la configuration Apache en vous assurant qu'une directive LoadModule est
présent pour charger cet objet partagé. Pour simplifier cette étape apxs fournit un moyen automatique
installer l'objet partagé dans son répertoire "modules" et mettre à jour le fichier httpd.conf
par conséquent. Ceci peut être réalisé en exécutant:

$ apxs -i -a mod_foo.la
/chemin/vers/instdso.sh mod_foo.la /chemin/vers/apache/modules
/chemin/vers/libtool --mode=install cp mod_foo.la /chemin/vers/apache/modules

chmod 755 /chemin/vers/apache/modules/mod_foo.so
[activation du module `foo' dans /path/to/apache/conf/httpd.conf]
$ _

De cette façon, une ligne nommée

LoadModule foo_module modules/mod_foo.so

est ajouté au fichier de configuration s'il n'est toujours pas présent. Si vous voulez que cela soit désactivé
par défaut utilisez l'option -A, à

$ apxs -i -A mod_foo.c

Pour un test rapide du mécanisme apxs, vous pouvez créer un exemple de modèle de module Apache plus
un Makefile correspondant via :

$ apxs -g -n foo
Création de [DIR] foo
Création de [FILE] foo/Makefile
Création de [FILE] foo/modules.mk
Création de [FILE] foo/mod_foo.c
Création de [FILE] foo/.deps
$ _

Ensuite, vous pouvez immédiatement compiler cet exemple de module dans un objet partagé et le charger dans
le serveur Apache :

$ cd foo
$ faire tout recharger
apxs -c mod_foo.c
/chemin/vers/libtool --mode=compile gcc ... -c mod_foo.c
/chemin/vers/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
apxs -i -a -n "foo" mod_foo.la
/chemin/vers/instdso.sh mod_foo.la /chemin/vers/apache/modules
/chemin/vers/libtool --mode=install cp mod_foo.la /chemin/vers/apache/modules

chmod 755 /chemin/vers/apache/modules/mod_foo.so
[activation du module `foo' dans /path/to/apache/conf/httpd.conf]
apachectl redémarrer
/path/to/apache/sbin/apachectl restart : httpd ne fonctionne pas, essaie de démarrer
[Mar 31 11:27:55 1998] [débogage] mod_so.c(303) : module chargé foo_module
/chemin/vers/apache/sbin/apachectl redémarrer : httpd démarré
$ _

Utilisez apxs en ligne à l'aide des services onworks.net