diff options
author | 2015-11-30 03:10:21 -0500 | |
---|---|---|
committer | 2015-11-30 03:10:21 -0500 | |
commit | c0b7206652b2852bc574694e7ba07ba1c2acdc00 (patch) | |
tree | 5cb95cb0e19e03610525903df46279df2c3b7eb1 /rubbos/app/httpd-2.0.64/modules/mappers/mod_so.c | |
parent | b6d3d6e668b793220f2d3af1bc3e828553dc3fe6 (diff) |
delete app
Change-Id: Id4c572809969ebe89e946e88063eaed262cff3f2
Signed-off-by: hongbotian <hongbo.tianhongbo@huawei.com>
Diffstat (limited to 'rubbos/app/httpd-2.0.64/modules/mappers/mod_so.c')
-rw-r--r-- | rubbos/app/httpd-2.0.64/modules/mappers/mod_so.c | 368 |
1 files changed, 0 insertions, 368 deletions
diff --git a/rubbos/app/httpd-2.0.64/modules/mappers/mod_so.c b/rubbos/app/httpd-2.0.64/modules/mappers/mod_so.c deleted file mode 100644 index 984cb549..00000000 --- a/rubbos/app/httpd-2.0.64/modules/mappers/mod_so.c +++ /dev/null @@ -1,368 +0,0 @@ -/* Licensed to the Apache Software Foundation (ASF) under one or more - * contributor license agreements. See the NOTICE file distributed with - * this work for additional information regarding copyright ownership. - * The ASF licenses this file to You under the Apache License, Version 2.0 - * (the "License"); you may not use this file except in compliance with - * the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -/* - * This module is used to load Apache modules at runtime. This means that the - * server functionality can be extended without recompiling and even without - * taking the server down at all. Only a HUP or AP_SIG_GRACEFUL signal - * needs to be sent to the server to reload the dynamically loaded modules. - * - * To use, you'll first need to build your module as a shared library, then - * update your configuration (httpd.conf) to get the Apache core to load the - * module at start-up. - * - * The easiest way to build a module as a shared library is to use the - * `SharedModule' command in the Configuration file, instead of `AddModule'. - * You should also change the file extension from `.o' to `.so'. So, for - * example, to build the status module as a shared library edit Configuration - * and change - * AddModule modules/standard/mod_status.o - * to - * SharedModule modules/standard/mod_status.so - * - * Run Configure and make. Now Apache's httpd binary will _not_ include - * mod_status. Instead a shared object called mod_status.so will be build, in - * the modules/standard directory. You can build most of the modules as shared - * libraries like this. - * - * To use the shared module, move the .so file(s) into an appropriate - * directory. You might like to create a directory called "modules" under you - * server root for this (e.g. /usr/local/httpd/modules). - * - * Then edit your conf/httpd.conf file, and add LoadModule lines. For - * example - * LoadModule status_module modules/mod_status.so - * - * The first argument is the module's structure name (look at the end of the - * module source to find this). The second option is the path to the module - * file, relative to the server root. Put these directives right at the top - * of your httpd.conf file. - * - * Now you can start Apache. A message will be logged at "debug" level to your - * error_log to confirm that the module(s) are loaded (use "LogLevel debug" - * directive to get these log messages). - * - * If you edit the LoadModule directives while the server is live you can get - * Apache to re-load the modules by sending it a HUP or AP_SIG_GRACEFUL - * signal as normal. You can use this to dynamically change the capability - * of your server without bringing it down. - * - * Because currently there is only limited builtin support in the Configure - * script for creating the shared library files (`.so'), please consult your - * vendors cc(1), ld(1) and dlopen(3) manpages to find out the appropriate - * compiler and linker flags and insert them manually into the Configuration - * file under CFLAGS_SHLIB, LDFLAGS_SHLIB and LDFLAGS_SHLIB_EXPORT. - * - * If you still have problems figuring out the flags both try the paper - * http://developer.netscape.com/library/documentation/enterprise - * /unix/svrplug.htm#1013807 - * or install a Perl 5 interpreter on your platform and then run the command - * - * $ perl -V:usedl -V:ccdlflags -V:cccdlflags -V:lddlflags - * - * This gives you what type of dynamic loading Perl 5 uses on your platform - * and which compiler and linker flags Perl 5 uses to create the shared object - * files. - * - * Another location where you can find useful hints is the `ltconfig' script - * of the GNU libtool 1.2 package. Search for your platform name inside the - * various "case" constructs. - * - */ - -#include "apr.h" -#include "apr_dso.h" -#include "apr_strings.h" -#include "apr_errno.h" - -#define CORE_PRIVATE -#include "ap_config.h" -#include "httpd.h" -#include "http_config.h" -#include "http_log.h" -#include "ap_config.h" - -module AP_MODULE_DECLARE_DATA so_module; - - -/* - * Server configuration to keep track of actually - * loaded modules and the corresponding module name. - */ - -typedef struct moduleinfo { - const char *name; - module *modp; -} moduleinfo; - -typedef struct so_server_conf { - apr_array_header_t *loaded_modules; -} so_server_conf; - -static void *so_sconf_create(apr_pool_t *p, server_rec *s) -{ - so_server_conf *soc; - - soc = (so_server_conf *)apr_pcalloc(p, sizeof(so_server_conf)); - soc->loaded_modules = apr_array_make(p, DYNAMIC_MODULE_LIMIT, - sizeof(moduleinfo)); - - return (void *)soc; -} - -#ifndef NO_DLOPEN - -/* - * This is the cleanup for a loaded shared object. It unloads the module. - * This is called as a cleanup function from the core. - */ - -static apr_status_t unload_module(void *data) -{ - moduleinfo *modi = (moduleinfo*)data; - - /* only unload if module information is still existing */ - if (modi->modp == NULL) - return APR_SUCCESS; - - /* remove the module pointer from the core structure */ - ap_remove_loaded_module(modi->modp); - - /* destroy the module information */ - modi->modp = NULL; - modi->name = NULL; - 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, - const char *modname, const char *filename) -{ - apr_dso_handle_t *modhandle; - apr_dso_handle_sym_t modsym; - module *modp; - const char *szModuleFile = ap_server_root_relative(cmd->pool, filename); - so_server_conf *sconf; - moduleinfo *modi; - moduleinfo *modie; - int i; - - /* we need to setup this value for dummy to make sure that we don't try - * to add a non-existant tree into the build when we return to - * execute_now. - */ - *(ap_directive_t **)dummy = NULL; - - if (!szModuleFile) { - return apr_pstrcat(cmd->pool, "Invalid LoadModule path ", - filename, NULL); - } - - /* - * check for already existing module - * If it already exists, we have nothing to do - * Check both dynamically-loaded modules and statically-linked modules. - */ - 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) { - ap_log_perror(APLOG_MARK, APLOG_WARNING, 0, - cmd->pool, "module %s is already loaded, skipping", - modname); - return NULL; - } - } - - for (i = 0; ap_preloaded_modules[i]; i++) { - const char *preload_name; - apr_size_t preload_len; - apr_size_t thismod_len; - - modp = ap_preloaded_modules[i]; - - /* make sure we're comparing apples with apples - * make sure name of preloaded module is mod_FOO.c - * make sure name of structure being loaded is FOO_module - */ - - if (memcmp(modp->name, "mod_", 4)) { - continue; - } - - preload_name = modp->name + strlen("mod_"); - preload_len = strlen(preload_name) - 2; - - if (strlen(modname) <= strlen("_module")) { - continue; - } - thismod_len = strlen(modname) - strlen("_module"); - if (strcmp(modname + thismod_len, "_module")) { - continue; - } - - if (thismod_len != preload_len) { - continue; - } - - if (!memcmp(modname, preload_name, preload_len)) { - return apr_pstrcat(cmd->pool, "module ", modname, - " is built-in and can't be loaded", - NULL); - } - } - - modi = apr_array_push(sconf->loaded_modules); - modi->name = modname; - - /* - * Load the file into the Apache address space - */ - if (apr_dso_load(&modhandle, szModuleFile, cmd->pool) != APR_SUCCESS) { - char my_error[256]; - - return apr_pstrcat(cmd->pool, "Cannot load ", szModuleFile, - " into server: ", - apr_dso_error(modhandle, my_error, sizeof(my_error)), - NULL); - } - ap_log_perror(APLOG_MARK, APLOG_DEBUG, 0, cmd->pool, - "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 (apr_dso_sym(&modsym, modhandle, modname) != APR_SUCCESS) { - char my_error[256]; - - return apr_pstrcat(cmd->pool, "Can't locate API module structure `", - modname, "' in file ", szModuleFile, ": ", - apr_dso_error(modhandle, my_error, sizeof(my_error)), - NULL); - } - modp = (module*) modsym; - modp->dynamic_load_handle = (apr_dso_handle_t *)modhandle; - modi->modp = modp; - - /* - * Make sure the found module structure is really a module structure - * - */ - if (modp->magic != MODULE_MAGIC_COOKIE) { - return apr_psprintf(cmd->pool, "API module structure '%s' in file %s " - "is garbled - expected signature %08lx but saw " - "%08lx - perhaps this is not an Apache module DSO, " - "or was compiled for a different Apache version?", - modname, szModuleFile, - MODULE_MAGIC_COOKIE, modp->magic); - } - - /* - * Add this module to the Apache core structures - */ - ap_add_loaded_module(modp, cmd->pool); - - /* - * Register a cleanup in the config apr_pool_t (normally pconf). When - * we do a restart (or shutdown) this cleanup will cause the - * shared object to be unloaded. - */ - apr_pool_cleanup_register(cmd->pool, modi, unload_module, apr_pool_cleanup_null); - - /* - * 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, const char *filename) -{ - apr_dso_handle_t *handle; - const char *file; - - file = ap_server_root_relative(cmd->pool, filename); - - if (!file) { - return apr_pstrcat(cmd->pool, "Invalid LoadFile path ", - filename, NULL); - } - - if (apr_dso_load(&handle, file, cmd->pool) != APR_SUCCESS) { - char my_error[256]; - - return apr_pstrcat(cmd->pool, "Cannot load ", filename, - " into server: ", - apr_dso_error(handle, my_error, sizeof(my_error)), - NULL); - } - - ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, NULL, - "loaded file %s", filename); - - return NULL; -} - -#else /* not NO_DLOPEN */ - -static const char *load_file(cmd_parms *cmd, void *dummy, const char *filename) -{ - ap_log_perror(APLOG_MARK, APLOG_STARTUP, 0, cmd->pool, - "WARNING: LoadFile not supported on this platform"); - return NULL; -} - -static const char *load_module(cmd_parms *cmd, void *dummy, - const char *modname, const char *filename) -{ - ap_log_perror(APLOG_MARK, APLOG_STARTUP, 0, cmd->pool, - "WARNING: LoadModule not supported on this platform"); - return NULL; -} - -#endif /* NO_DLOPEN */ - -static const command_rec so_cmds[] = { - AP_INIT_TAKE2("LoadModule", load_module, NULL, RSRC_CONF | EXEC_ON_READ, - "a module name and the name of a shared object file to load it from"), - AP_INIT_ITERATE("LoadFile", load_file, NULL, RSRC_CONF | EXEC_ON_READ, - "shared object file or library to load into the server at runtime"), - { NULL } -}; - -module AP_MODULE_DECLARE_DATA 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 apr_table_t */ - NULL /* register hooks */ -}; |