Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] apxs - outil d'extension d'Apache (APache eXtenSion) [size=18] [b]Résumé[/b] [/size] [b]apxs[/b] [b]-g[/b] [ [b]-S[/b] variable=[i]valeur[/i][b][/b] ] [b]-n[/b] [i]nom[/i][b][/b] [b]apxs[/b] [b]-q[/b] [ [b]-S[/b] variable=[i]valeur[/i][b][/b] ] [b]requête[/b][i]...[/i] [b]apxs[/b] [b]-c[/b] [ [b]-S[/b] variable=[i]valeur[/i][b][/b] ] [ [b]-o[/b] fichier_dso ] [ [b]-I[/b] répertoire_à_inclure ] [ [b]-D[/b] variable [ =[i]valeur[/i][b][/b] ] ] [ [b]-L[/b] répertoire_de_bibliothèque ] [ [b]-l[/b] nom_de_bibliothèque ] [ [b]-Wc,drapeaux-du-compilateur[/b] ] [ [b]-Wl,drapeaux-du-lieur[/b] ] [b]fichiers[/b][i]...[/i] [b]apxs[/b] [b]-i[/b] [ [b]-S[/b] variable=[i]valeur[/i][b][/b] ] [ [b]-n[/b] nom ] [ [b]-a[/b] ] [ [b]-A[/b] ] [b]fichier_dso[/b][i]...[/i] [b]apxs[/b] [b]-e[/b] [ [b]-S[/b] variable=[i]valeur[/i][b][/b] ] [ [b]-n[/b] nom ] [ [b]-a[/b] ] [ [b]-A[/b] ] [b]fichier_dso[/b][i]...[/i] [size=18] [b]Description[/b] [/size] [b]apxs[/b] est un outil pour construire et installer des modules d'extension pour le serveur de protocole de transfert Hypertexte (HTTP) [b]Apache[/b]. Ceci est accompli en construisant un objet dynamique partagé (« Dynamic share object » : DSO) à partir d'un ou plusieurs fichiers sources ou objets. Les DSO peuvent ensuite être chargés par le serveur [b]Apache[/b] en fonctionnement par la directive « LoadModule » de mod_so. Ainsi, pour utiliser ce mécanisme d'extension, votre plate-forme doit supporter la spécificité DSO et votre binaire [i]httpd[/i] d'[b]Apache[/b] doit être construit avec le module mod_so. L'outil [b]apxs[/b] se plaint automatiquement si ce n'est pas le cas. Vous pouvez vérifier par vous-même que ces conditions sont réalisées en lançant manuellement la commande : .nf $ [b]httpd[/b] -l .fi Le module mod_so devrait faire partie de la liste affichée. Si ces conditions sont réalisées, vous pouvez facilement étendre les fonctionnalités de votre serveur [b]Apache[/b] en installant vos propre modules avec le mécanisme DSO grâce à l'aide de l'outil [b]apxs[/b] : .nf $ [b]apxs[/b] [b]-a[/b] -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/libexec/mod_foo.so chmod 755 /path/to/apache/libexec/mod_foo.so [activating module `foo' in /path/to/apache/etc/httpd.conf] $ [b]apachectl[/b] [b]restart[/b] /path/to/apache/sbin/apachectl restart: httpd not running, trying to start [Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module /path/to/apache/sbin/apachectl restart: httpd started $ .fi Les fichiers passés en argument peuvent être de différents types : fichier source en C (.c), fichier objet (.o) ou même archive de bibliothèque (.a). L'outil [b]apxs[/b] reconnaît automatiquement les extensions et utilise automatiquement les fichiers sources en C pour la compilation tandis qu'il utilise les fichiers objets et archives pour la phase de liaison. Mais en utilisant de tels objets précompilés, soyez sûr qu'ils sont compilés en code de position indépendante (PIC) pour être capable de les utiliser comme un DSO. Par exemple avec [b]GCC[/b] vous avez juste à utiliser [b]-fpic[/b]. Pour d'autres compilateurs C, veuillez consulter sa page de manuel ou chercher le drapeau qu'[b]apxs[/b] utilise pour compiler les fichiers objets. Pour plus de détails à propos du support DSO dans [b]Apache[/b], d'abord lisez l'information sur DSO dans [i]htdocs/manual/dso.html[/i], ensuite lisez la documentation de mod_so. [size=18] [b]Options[/b] [/size] Options courantes : [table][row][col]    [/col][col][b]-n[/b] [i]nom[/i][b][/b] Ceci positionne explicitement le nom du module pour les options [b]-i[/b] (installe) et [b]-g[/b] (génération de modèles). Utilisez ceci pour spécifier explicitement le nom du module. Pour l'option [b]-g[/b] ceci est imposé, pour l'option [b]-i[/b] l'outil [b]apxs[/b] essaye de déterminer le nom à partir de la source ou (comme un remplacement) au moins en le devinant à partir du nom du fichier.[/col][/row][/table] Options de requête : [table][row][col]    [/col][col][b]-q[/b] Effectuer une requête pour les connaissances d'[b]apxs[/b] au sujet de certaines configurations. Les paramètres de requêtes peuvent être un ou plusieurs des noms de variables suivants : CC TARGET CFLAGS SBINDIR CFLAGS_SHLIB INCLUDEDIR LD_SHLIB LIBEXECDIR LDFLAGS_SHLIB SYSCONFDIR LIBS_SHLIB PREFIX Utilisez cette option pour déterminer manuellement les configurations. Par exemple, utilisez : .nf INC=-I`apxs -q INCLUDEDIR` .fi à l'intérieur de vos « makefiles » si vous avez besoin d'un accès manuel aux fichiers d'en-tête C d'[b]Apache[/b].[/col][/row][/table] Options de configuration : [table][row][col]    [/col][col][b]-S[/b] variable=[i]valeur[/i][b][/b] Cette option change les configurations d'[b]apxs[/b] décrites précédemment.[/col][/row][/table] Options de génération de modèles : [table][row][col]    [/col][col][b]-g[/b] Cette option crée un sous-répertoire (voir l'option [b]-n[/b]) et à l'intérieur de celui-ci deux fichiers : un exemple de fichier source de module, nommé [i]mod_name.c[/i] qui peut être utilisé comme un modèle pour créer vos propre modules ou comme départ rapide pour jouer avec le mécanisme d'[b]apxs[/b], et un « makefile » correspondant, pour une construction et installation encore plus facile de ce module.[/col][/row][/table] Options de compilation DSO : [table][row][col]    [/col][col][b]-c[/b] Indiquer l'opération de compilation. À partir des fichiers passés en argument, il y a d'abord compilation des fichiers sources C (.c) en fichiers objets (.o) correspondants, et ensuite construction d'un DSO dans [i]fichier_dso[/i] en liant ces fichiers objets plus les fichiers objets restants (.o et .a). S'il n'y a pas d'option [b]-o[/b] spécifiée, le fichier de sortie est deviné à partir du premier nom de fichier parmi les [b]fichiers[/b] en argument et devient habituellement par défaut [i]mod_nom.so[/i].[/col][/row][/table] [table][row][col]    [/col][col][b]-o[/b] [i]fichier_dso[/i][b][/b] Spécifier explicitement le nom du fichier DSO créé. S'il n'est pas spécifié, et que le nom ne peut pas être deviné à partir de la liste de fichiers, le nom [i]mod_unknown.so[/i] est utilisé.[/col][/row][/table] [table][row][col]    [/col][col][b]-D[/b] variable[=valeur] Cette option est passée directement à la/aux commande(s) de compilation. Utilisez cette option pour ajouter vos définitions au processus de construction.[/col][/row][/table] [table][row][col]    [/col][col][b]-I[/b] [i]répertoire_à_inclure[/i][b][/b] Cette option est passée directement à la/aux commande(s) de compilation. Utilisez cette option pour ajouter vos répertoires à chercher au processus de construction.[/col][/row][/table] [table][row][col]    [/col][col][b]-L[/b] [i]libdir[/i][b][/b] Cette option est passée directement à la commande du lieur. Utilisez cette option pour ajouter vos répertoires de bibliothèques à chercher au processus de construction.[/col][/row][/table] [table][row][col]    [/col][col][b]-l[/b] [i]libname[/i][b][/b] Cette option est passée directement à la commande du lieur. Utilisez cette option pour ajouter vos bibliothèques à chercher au processus de construction.[/col][/row][/table] [table][row][col]    [/col][col][b]-Wc,[/b][i]drapeaux-du-compilateur[/i][b][/b] Cette option passe des drapeaux de compilateur comme drapeaux additionnels à la commande du compilateur. Utilisez cette option pour ajouter des options spécifiques du compilateur local.[/col][/row][/table] [table][row][col]    [/col][col][b]-Wl,[/b][i]drapeaux-du-lieur[/i][b][/b] Cette option passe des drapeaux de lieur comme drapeaux additionnels à la commande du lieur. Utilisez cette option pour ajouter des options spécifiques au lieur local.[/col][/row][/table] Options d'installation et de configuration DSO : [table][row][col]    [/col][col][b]-i[/b] Cette option indique l'opération d'installation et installe un ou plusieurs DSOs dans le répertoire [i]libexec[/i] du server.[/col][/row][/table] [table][row][col]    [/col][col][b]-a[/b] Cette option active le module en ajoutant automatiquement au fichier de configuration d'[b]Apache[/b] [i]httpd.conf[/i] une ligne « LoadModule » correspondante, ou en l'activant si elle existe déjà.[/col][/row][/table] [table][row][col]    [/col][col][b]-A[/b] Identique à l'option [b]-a[/b] mais la directive « LoadModule » créée est pré-fixée avec le signe dièse (#), le module est préparé pour une activation ultérieure mais initialement désactivé.[/col][/row][/table] [table][row][col]    [/col][col][b]-e[/b] Cette option indique l'opération d'édition, qui peut être utilisée avec les options [b]-a[/b] et [b]-A[/b] pareillement à l'opération [b]-i[/b] pour éditer le fichier de configuration [i]httpd.conf[/i] d'[b]Apache[/b] sans tenter d'installer le module.[/col][/row][/table] [size=18] [b]Exemples[/b] [/size] Supposons que vous avez un module [b]Apache[/b] nommé [i]mod_foo.c[/i] disponible qui pourrait étendre la fonctionnalité du serveur [b]Apache[/b]. Pour réaliser ceci, vous devez d'abord compiler la source C en DSO, qui convient au chargement dans le serveur [b]Apache[/b] en fonctionnement, via la commande suivante : .nf $ [b]apxs[/b] [b]-c[/b] 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 $ .fi Ensuite, vous devez mettre à jour la configuration d'[b]Apache[/b] en étant sûr qu'une directive « LoadModule » est présente pour charger le DSO. Pour simplifier cette étape, [b]apxs[/b] fournie une façon automatique pour installer le DSO dans le répertoire [i]libexec[/i] et mettre à jour le fichier [i]httpd.conf[/i] en conséquence. Ceci peut être accompli en lançant : .nf $ [b]apxs[/b] [b]-i[/b] -a mod_foo.c cp mod_foo.so /path/to/apache/libexec/mod_foo.so chmod 755 /path/to/apache/libexec/mod_foo.so [activating module `foo' in /path/to/apache/etc/httpd.conf] $ .fi Ainsi une ligne nommée .nf LoadModule foo_module libexec/mod_foo.so .fi est ajoutée au fichier de configuration si elle n'est pas encore présente. Si vous voulez avoir cette opération désactivée, utilisez l'option [b]-A[/b], exemple : .nf $ [b]apxs[/b] [b]-i[/b] -A mod_foo.c .fi Pour un test rapide du mécanisme d'[b]apxs[/b] vous pouvez créer un exemple de modèle de module [b]Apache[/b] et un « makefile » correspondant via : .nf $ [b]apxs[/b] [b]-g[/b] -n foo Creating [DIR] foo Creating [FILE] foo/Makefile Creating [FILE] foo/mod_foo.c $ .fi Ensuite, vous pouvez immédiatement compiler ce module exemple en DSO et le charger dans le serveur [b]Apache[/b] : .nf $ [b]cd[/b] [b]foo[/b] $ [b]make[/b] [b]all[/b] reload apxs -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 apxs -i -a -n "foo" mod_foo.so cp mod_foo.so /path/to/apache/libexec/mod_foo.so chmod 755 /path/to/apache/libexec/mod_foo.so [activating module `foo' in /path/to/apache/etc/httpd.conf] $ [b]apachectl[/b] [b]restart[/b] /path/to/apache/sbin/apachectl restart: httpd not running, trying to start [Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module /path/to/apache/sbin/apachectl restart: httpd started $ .fi Vous pouvez même utiliser [b]apxs[/b] pour compiler des modules complexes en dehors de l'arborescence d'[b]Apache[/b], comme PHP3, parce que [b]apxs[/b] reconnaît automatiquement les fichiers sources C et les fichiers objets. .nf $ [b]cd[/b] [b]php3[/b] $ [b]./configure[/b] [b]--with-shared-apache=../apache-1.3[/b] $ [b]apxs[/b] [b]-c[/b] -o libphp3.so mod_php3.c libmodphp3-so.a gcc -fpic -DSHARED_MODULE -I/tmp/apache/include -c mod_php3.c ld -Bshareable -o libphp3.so mod_php3.o libmodphp3-so.a $ .fi Seulement les fichiers sources en C sont compilés pendant que les fichiers objets restant sont utilisés pendant la phase de liaison. [size=18] [b]Voir aussi[/b] [/size] [b]apachectl[/b](1), [b]httpd[/b](8). [size=18] [b]Traduction[/b] [/size] Aymeric Nys , <aymeric@nnx.com>. [size=18] [b]Relecture[/b] [/size] Gérard Delafond
Fichier