APXS(1) apxs APXS(1) (NAME) apxs - (APache eXtenSion tool) (SYNOPSIS) apxs -g [ -S name=value ] -n modname apxs -q [ -v ] [ -S name=value ] query ... apxs -c [ -S name=value ] [ -o dsofile ] [ -I incdir ] [ -D name=value ] [ -L libdir ] [ -l libname ] [ -Wc,compiler-flags ] [ -Wl,linker- flags ] files ... apxs -i [ -S name=value ] [ -n modname ] [ -a ] [ -A ] dso-file ... apxs -e [ -S name=value ] [ -n modname ] [ -a ] [ -A ] dso-file ... (DESCRIPTION) apxs Apache HyperText Transfer Protocol (HTTP) . (DSO) files ( ) LoadModule mod_so . DSO httpd mod_so . apxs . : $ httpd -l mod_so . DSO apxs : $ apxs -i -a -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/modules/mod_foo.so chmod 755 /path/to/apache/modules/mod_foo.so [activating module `foo' in /path/to/apache/etc/httpd.conf] $ apachectl restart /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 $ _ files C (.c) (.o) (.a) . apxs C (linking) . (PIC) . GCC -fpic . C apxs . DSO mod_so src/modules/standard/mod_so.c . (OPTIONS) (Common Options) -n modname -i () -g ( ) . . -g -i apxs ( ) . (Query Options) -q httpd . query . -v . httpd . C Makefile : INC=-I`apxs -q INCLUDEDIR` (Configuration Options) -S name=value apxs . (Template Generation Options) -g name ( -n ) : mod_name.c apxs Makefile . DSO (DSO Compilation Options) -c . C (.c) files (.o) (.o .a) files dsofile . -o files mod_name.so . -o dsofile . files mod_unknown.so . -D name=value () . (defines) . -I incdir () . include . -L libdir (linker) . . -l libname (linker) . . -Wc,compiler-flags compiler-flags libtool --mode=compile . . -Wl,linker-flags linker-flags libtool --mode=link . (linker) . -p apxs apr/apr-util . apr/apr-util . DSO (DSO Installation and Configuration Options) -i modules . -a LoadModule httpd.conf . -A -a LoadModule (#) . -e -a -A -i httpd.conf . (EXAMPLES) mod_foo.c . C : $ 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 $ _ 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 [activating module `foo' in /path/to/apache/conf/httpd.conf] $ _ LoadModule foo_module modules/mod_foo.so . -A : $ apxs -i -A mod_foo.c apxs Makefile : $ apxs -g -n foo Creating [DIR] foo Creating [FILE] foo/Makefile Creating [FILE] foo/modules.mk Creating [FILE] foo/mod_foo.c Creating [FILE] foo/.deps $ _ : $ cd foo $ make all reload 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 ... chmod 755 /path/to/apache/modules/mod_foo.so [activating module `foo' in /path/to/apache/conf/httpd.conf] apachectl restart /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 $ _ Apache HTTP Server 2026-04-30 APXS(1)