mod_so.c revision 407cde44becba3694e7c3d81ac99b5d86f4b03a9
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder/* ====================================================================
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * Copyright (c) 1995-1999 The Apache Group. All rights reserved.
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder *
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * Redistribution and use in source and binary forms, with or without
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * modification, are permitted provided that the following conditions
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * are met:
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder *
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * 1. Redistributions of source code must retain the above copyright
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * notice, this list of conditions and the following disclaimer.
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder *
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * 2. Redistributions in binary form must reproduce the above copyright
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * notice, this list of conditions and the following disclaimer in
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * the documentation and/or other materials provided with the
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * distribution.
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * 3. All advertising materials mentioning features or use of this
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * software must display the following acknowledgment:
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * "This product includes software developed by the Apache Group
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * for use in the Apache HTTP server project (http://www.apache.org/)."
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * 4. The names "Apache Server" and "Apache Group" must not be used to
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * endorse or promote products derived from this software without
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * prior written permission. For written permission, please contact
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * apache@apache.org.
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * 5. Products derived from this software may not be called "Apache"
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * nor may "Apache" appear in their names without prior written
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * permission of the Apache Group.
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder *
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * 6. Redistributions of any form whatsoever must retain the following
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * acknowledgment:
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * "This product includes software developed by the Apache Group
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * for use in the Apache HTTP server project (http://www.apache.org/)."
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder *
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE GROUP OR
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
770abb9d4554f378acbae393b25f8687eeeb3ad0Christian Maeder * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder * OF THE POSSIBILITY OF SUCH DAMAGE.
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder * ====================================================================
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * This software consists of voluntary contributions made by many
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * individuals on behalf of the Apache Group and was originally based
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * on public domain software written at the National Center for
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * Supercomputing Applications, University of Illinois, Urbana-Champaign.
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * For more information on the Apache Group and the Apache HTTP server
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * project, please see <http://www.apache.org/>.
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder *
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder */
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder/*
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * This module is used to load Apache modules at runtime. This means that the
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * server functionality can be extended without recompiling and even without
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * taking the server down at all. Only a HUP or WINCH signal needs to be send
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * to the server to reload the dynamically loaded modules.
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * To use, you'll first need to build your module as a shared library, then
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * update your configuration (httpd.conf) to get the Apache core to load the
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * module at start-up.
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * The easiest way to build a module as a shared library is to use the
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * `SharedModule' command in the Configuration file, instead of `AddModule'.
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * You should also change the file extension from `.o' to `.so'. So, for
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * example, to build the status module as a shared library edit Configuration
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * and change
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * AddModule modules/standard/mod_status.o
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * to
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * SharedModule modules/standard/mod_status.so
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * Run Configure and make. Now Apache's httpd binary will _not_ include
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * mod_status. Instead a shared object called mod_status.so will be build, in
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * the modules/standard directory. You can build most of the modules as shared
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder * libraries like this.
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * To use the shared module, move the .so file(s) into an appropriate
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * directory. You might like to create a directory called "modules" under you
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * server root for this (e.g. /usr/local/httpd/modules).
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * Then edit your conf/httpd.conf file, and add LoadModule lines. For
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * example
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * LoadModule status_module modules/mod_status.so
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder *
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * The first argument is the module's structure name (look at the end of the
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * module source to find this). The second option is the path to the module
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * file, relative to the server root. Put these directives right at the top
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * of your httpd.conf file.
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder *
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * Now you can start Apache. A message will be logged at "debug" level to your
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * error_log to confirm that the module(s) are loaded (use "LogLevel debug"
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * directive to get these log messages).
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder *
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * If you edit the LoadModule directives while the server is live you can get
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * Apache to re-load the modules by sending it a HUP or WINCH signal as normal.
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * You can use this to dynamically change the capability of your server
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * without bringing it down.
1ba51e89f63278f541a547315926a05f92c676ffChristian Maeder *
1ba51e89f63278f541a547315926a05f92c676ffChristian Maeder * Because currently there is only limited builtin support in the Configure
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * script for creating the shared library files (`.so'), please consult your
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * vendors cc(1), ld(1) and dlopen(3) manpages to find out the appropriate
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * compiler and linker flags and insert them manually into the Configuration
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * file under CFLAGS_SHLIB, LDFLAGS_SHLIB and LDFLAGS_SHLIB_EXPORT.
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder *
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder * If you still have problems figuring out the flags both try the paper
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder * http://developer.netscape.com/library/documentation/enterprise
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder * /unix/svrplug.htm#1013807
79e28be65fd0bc65adf266d5ae4f6deb92546bf7Christian Maeder * or install a Perl 5 interpreter on your platform and then run the command
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * $ perl -V:usedl -V:ccdlflags -V:cccdlflags -V:lddlflags
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder *
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * This gives you what type of dynamic loading Perl 5 uses on your platform
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * and which compiler and linker flags Perl 5 uses to create the shared object
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder * files.
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder *
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * Another location where you can find useful hints is the `ltconfig' script
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * of the GNU libtool 1.2 package. Search for your platform name inside the
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * various "case" constructs.
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder *
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder */
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder#define CORE_PRIVATE
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder#include "httpd.h"
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder#include "http_config.h"
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder#include "http_log.h"
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maedermodule MODULE_VAR_EXPORT so_module;
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder/*
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * Server configuration to keep track of actually
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder * loaded modules and the corresponding module name.
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder */
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maedertypedef struct moduleinfo {
5b55761e0df088c5b41183fb83106bfd02a61fa2Christian Maeder char *name;
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder module *modp;
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder} moduleinfo;
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maedertypedef struct so_server_conf {
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder ap_array_header_t *loaded_modules;
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder} so_server_conf;
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maederstatic void *so_sconf_create(ap_context_t *p, server_rec *s)
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder{
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder so_server_conf *soc;
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder soc = (so_server_conf *)ap_pcalloc(p, sizeof(so_server_conf));
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder soc->loaded_modules = ap_make_array(p, DYNAMIC_MODULE_LIMIT,
89026e63176e6e40c7be1bbc542326f0d29d8108Christian Maeder sizeof(moduleinfo));
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder#ifndef NO_DLOPEN
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder ap_os_dso_init();
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder#endif
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder return (void *)soc;
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder}
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder#ifndef NO_DLOPEN
8ab0f7627987d45eb3fe36845a91694977ca5cdbChristian Maeder
8ab0f7627987d45eb3fe36845a91694977ca5cdbChristian Maeder/*
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * This is the cleanup for a loaded shared object. It unloads the module.
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder * This is called as a cleanup function from the core.
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder */
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maederstatic ap_status_t unload_module(moduleinfo *modi)
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder{
4620e43bc9fa96506bd78ed6b3e5318b08de5996Christian Maeder /* only unload if module information is still existing */
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder if (modi->modp == NULL)
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder return APR_SUCCESS;
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder /* remove the module pointer from the core structure */
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder ap_remove_loaded_module(modi->modp);
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder
57dc8a87418e235e3d0621fb90728054044a9ef9Christian Maeder /* unload the module space itself */
ap_os_dso_unload((ap_os_dso_handle_t)modi->modp->dynamic_load_handle);
/* destroy the module information */
modi->modp = NULL;
modi->name = NULL;
return APR_SUCCESS;
}
/*
* This is the cleanup routine for files loaded by
* load_file(). Unfortunately we don't keep a record of the filename
* that was loaded, so we can't report the unload for debug purposes
* or include the filename in error message.
*/
static ap_status_t unload_file(void *handle)
{
ap_os_dso_unload((ap_os_dso_handle_t)handle);
return APR_SUCCESS;
}
/*
* This is called for the directive LoadModule and actually loads
* a shared object file into the address space of the server process.
*/
static const char *load_module(cmd_parms *cmd, void *dummy,
char *modname, char *filename)
{
ap_os_dso_handle_t modhandle;
module *modp;
const char *szModuleFile=ap_server_root_relative(cmd->pool, filename);
so_server_conf *sconf;
moduleinfo *modi;
moduleinfo *modie;
int i;
/*
* check for already existing module
* If it already exists, we have nothing to do
*/
sconf = (so_server_conf *)ap_get_module_config(cmd->server->module_config,
&so_module);
modie = (moduleinfo *)sconf->loaded_modules->elts;
for (i = 0; i < sconf->loaded_modules->nelts; i++) {
modi = &modie[i];
if (modi->name != NULL && strcmp(modi->name, modname) == 0)
return NULL;
}
modi = ap_push_array(sconf->loaded_modules);
modi->name = modname;
/*
* Load the file into the Apache address space
*/
if (!(modhandle = ap_os_dso_load(szModuleFile))) {
const char *my_error = ap_os_dso_error();
return ap_pstrcat (cmd->pool, "Cannot load ", szModuleFile,
" into server: ",
my_error ? my_error : "(reason unknown)",
NULL);
}
ap_log_error(APLOG_MARK, APLOG_DEBUG|APLOG_NOERRNO, 0, NULL,
"loaded module %s", modname);
/*
* Retrieve the pointer to the module structure through the module name:
* First with the hidden variant (prefix `AP_') and then with the plain
* symbol name.
*/
if (!(modp = (module *)(ap_os_dso_sym(modhandle, modname)))) {
return ap_pstrcat(cmd->pool, "Can't locate API module structure `", modname,
"' in file ", szModuleFile, ": ", ap_os_dso_error(), NULL);
}
modi->modp = modp;
modp->dynamic_load_handle = (void *)modhandle;
/*
* Make sure the found module structure is really a module structure
*
*/
if (modp->magic != MODULE_MAGIC_COOKIE) {
return ap_pstrcat(cmd->pool, "API module structure `", modname,
"' in file ", szModuleFile, " is garbled -"
" perhaps this is not an Apache module DSO?", NULL);
}
/*
* Add this module to the Apache core structures
*/
ap_add_loaded_module(modp);
/*
* Register a cleanup in the config ap_context_t (normally pconf). When
* we do a restart (or shutdown) this cleanup will cause the
* shared object to be unloaded.
*/
ap_register_cleanup(cmd->pool, modi,
(ap_status_t (*)(void*))unload_module, ap_null_cleanup);
/*
* Finally we need to run the configuration process for the module
*/
ap_single_module_configure(cmd->pool, cmd->server, modp);
return NULL;
}
/*
* This implements the LoadFile directive and loads an arbitrary
* shared object file into the adress space of the server process.
*/
static const char *load_file(cmd_parms *cmd, void *dummy, char *filename)
{
ap_os_dso_handle_t handle;
const char *file;
file = ap_server_root_relative(cmd->pool, filename);
if (!(handle = ap_os_dso_load(file))) {
const char *my_error = ap_os_dso_error();
return ap_pstrcat (cmd->pool, "Cannot load ", filename,
" into server:",
my_error ? my_error : "(reason unknown)",
NULL);
}
ap_log_error(APLOG_MARK, APLOG_DEBUG|APLOG_NOERRNO, 0, NULL,
"loaded file %s", filename);
ap_register_cleanup(cmd->pool, (void *)handle, unload_file, ap_null_cleanup);
return NULL;
}
#else /* not NO_DLOPEN */
static const char *load_file(cmd_parms *cmd, void *dummy, char *filename)
{
ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL,
"WARNING: LoadFile not supported on this platform");
return NULL;
}
static const char *load_module(cmd_parms *cmd, void *dummy,
char *modname, char *filename)
{
ap_log_error(APLOG_MARK, APLOG_STARTUP | APLOG_NOERRNO, 0, NULL,
"WARNING: LoadModule not supported on this platform");
return NULL;
}
#endif /* NO_DLOPEN */
static const command_rec so_cmds[] = {
{ "LoadModule", load_module, NULL, RSRC_CONF, TAKE2,
"a module name and the name of a shared object file to load it from"},
{ "LoadFile", load_file, NULL, RSRC_CONF, ITERATE,
"shared object file or library to load into the server at runtime"},
{ NULL }
};
module MODULE_VAR_EXPORT so_module = {
STANDARD20_MODULE_STUFF,
NULL, /* create per-dir config */
NULL, /* merge per-dir config */
so_sconf_create, /* server config */
NULL, /* merge server config */
so_cmds, /* command ap_table_t */
NULL, /* handlers */
NULL /* register hooks */
};