apache2 模块编写

本文将介绍以下三种库：
1）动态连接库（动态加载模式）
2）动态连接库（预先加载模式）
3）静态库（编译时连接模式）

模块的函数调用流程：


static const cmd_rec my_cmds[] = {
AP_INIT_TAKE1("MyFirstDirective", my_first_cmd_func, my_ptr, OR_ALL,
"This is My First Directive"),
/* more directives as applicable */
{ NULL }
} ;

module MODULE_VAR_EXPORT module_name_module  =
{
    STANDARD20_MODULE_STUFF,
     /*  create per-directory config structures  */
     /*  merge per-directory config structures   */
     /*  create per-server config structures     */
     /*  merge per-server config structures      */
     /*  command handlers  */
     /*  handlers  */
     /*  register hooks  */
};

 

 

/*  *
 * filename :ap_config.h
 * Apache Core dso variables are declared with AP_MODULE_DECLARE_DATA.
 * This assures the appropriate indirection is invoked at compile time.
 *
 * @note AP_DECLARE_DATA extern type apr_variable; syntax is required for
 * declarations within headers to properly import the variable.
 * @code
 * AP_DECLARE_DATA type apr_variable
 * @endcode
  */
#define  AP_DECLARE_DATA             __declspec(dllexport)

 

 

 

/* *
 * file http_config.h 
 * Module structures.  Just about everything is dispatched through
 * these, directly or indirectly (through the command and handler
 * tables).
  */
typedef  struct  module_struct module;
struct  module_struct {
     /* * API version, *not* module version; check that module is 
     * compatible with this version of the server.
      */
     int  version;
     /* * API minor version. Provides API feature milestones. Not checked 
     *  during module init  */
     int  minor_version;
     /* * Index to this modules structures in config vectors.   */
     int  module_index;

     /* * The name of the module's C file  */
     const   char   * name;
     /* * The handle for the DSO.  Internal use only  */
     void   * dynamic_load_handle;

     /* * A pointer to the next module in the list
     *  @defvar module_struct *next  */
     struct  module_struct  * next;

     /* * Magic Cookie to identify a module structure;  It's mainly 
     *  important for the DSO facility (see also mod_so).   */
    unsigned  long  magic;

     /* * Function to allow MPMs to re-write command line arguments.  This
     *  hook is only available to MPMs.
     *  @param The process that the server is running in.
      */
     void  ( * rewrite_args) (process_rec  * process);
     /* * Function to allow all modules to create per directory configuration
     *  structures.
     *  @param p The pool to use for all allocations.
     *  @param dir The directory currently being processed.
     *  @return The per-directory structure created
      */
     void   * ( * create_dir_config) (apr_pool_t  * p,  char   * dir);
     /* * Function to allow all modules to merge the per directory configuration
     *  structures for two directories.
     *  @param p The pool to use for all allocations.
     *  @param base_conf The directory structure created for the parent directory.
     *  @param new_conf The directory structure currently being processed.
     *  @return The new per-directory structure created
      */
     void   * ( * merge_dir_config) (apr_pool_t  * p,  void   * base_conf,  void   * new_conf);
     /* * Function to allow all modules to create per server configuration
     *  structures.
     *  @param p The pool to use for all allocations.
     *  @param s The server currently being processed.
     *  @return The per-server structure created
      */
     void   * ( * create_server_config) (apr_pool_t  * p, server_rec  * s);
     /* * Function to allow all modules to merge the per server configuration
     *  structures for two servers.
     *  @param p The pool to use for all allocations.
     *  @param base_conf The directory structure created for the parent directory.
     *  @param new_conf The directory structure currently being processed.
     *  @return The new per-directory structure created
      */
     void   * ( * merge_server_config) (apr_pool_t  * p,  void   * base_conf, 
                                   void   * new_conf);

     /* * A command_rec table that describes all of the directives this module
     * defines.  */
     const  command_rec  * cmds;

     /* * A hook to allow modules to hook other points in the request processing.
     *  In this function, modules should call the ap_hook_*() functions to
     *  register an interest in a specific step in processing the current
     *  request.
     *  @param p the pool to use for all allocations
      */
     void  ( * register_hooks) (apr_pool_t  * p);
};

 

 

 

 

 

 

    ap_mod_list  * ml;
ap_cfg_getline( char   * buf, size_t bufsize, ap_configfile_t  * cfp)；

调用堆栈：
     libhttpd.dll ! load_module(cmd_parms_struct  *  cmd = 0x0006fd0c ,  void   *  dummy = 0x0006fb24 ,  const   char   *  modname = 0x009fb940 ,  const   char   *  filename = 0x009fb958 )  行158    C
     libhttpd.dll ! invoke_cmd( const  command_struct  *  cmd = 0x6ff3cee8 , cmd_parms_struct  *  parms = 0x0006fd0c ,  void   *  mconfig = 0x0006fb24 ,  const   char   *  args = 0x009f5834 )  行800  +   0x18  字节    C
>     libhttpd.dll ! execute_now( char   *  cmd_line = 0x009fb8d0 ,  const   char   *  args = 0x009f580b , cmd_parms_struct  *  parms = 0x0006fd0c , apr_pool_t  *  p = 0x0090b940 , apr_pool_t  *  ptemp = 0x009e2680 , ap_directive_t  *   *  sub_tree = 0x0006fb24 , ap_directive_t  *  parent = 0x00000000 )  行1441  +   0x15  字节    C
     libhttpd.dll ! ap_build_config_sub(apr_pool_t  *  p = 0x0090b940 , apr_pool_t  *  temp_pool = 0x009e2680 ,  const   char   *  l = 0x009f5800 , cmd_parms_struct  *  parms = 0x0006fd0c , ap_directive_t  *   *  current = 0x0006fb74 , ap_directive_t  *   *  curr_parent = 0x0006fb78 , ap_directive_t  *   *  conftree = 0x6ff5178c )  行1013  +   0x23  字节    C
     libhttpd.dll ! ap_build_config(cmd_parms_struct  *  parms = 0x0006fd0c , apr_pool_t  *  p = 0x0090b940 , apr_pool_t  *  temp_pool = 0x009e2680 , ap_directive_t  *   *  conftree = 0x6ff5178c )  行1225  +   0x21  字节    C
     libhttpd.dll ! process_resource_config_nofnmatch(server_rec  *  s = 0x009b7b10 ,  const   char   *  fname = 0x009e8490 , ap_directive_t  *   *  conftree = 0x6ff5178c , apr_pool_t  *  p = 0x0090b940 , apr_pool_t  *  ptemp = 0x009e2680 , unsigned  int  depth = 0x00000000 )  行1634  +   0x15  字节    C
     libhttpd.dll ! ap_process_resource_config(server_rec  *  s = 0x009b7b10 ,  const   char   *  fname = 0x009e8490 , ap_directive_t  *   *  conftree = 0x6ff5178c , apr_pool_t  *  p = 0x0090b940 , apr_pool_t  *  ptemp = 0x009e2680 )  行1667  +   0x1b  字节    C
     libhttpd.dll ! ap_read_config(process_rec  *  process = 0x009b30d0 , apr_pool_t  *  ptemp = 0x009e2680 ,  const   char   *  filename = 0x00404d10 , ap_directive_t  *   *  conftree = 0x6ff5178c )  行2026  +   0x19  字节    C
     httpd.exe ! main( int  argc = 0x00000001 ,  const   char   *   const   *  argv = 0x00908b90 )  行632  +   0x19  字节    C
     httpd.exe ! __tmainCRTStartup()  行586  +   0x19  字节    C
     httpd.exe ! mainCRTStartup()  行403    C

 

 

ap_config_hash

静态组件的编译和调用：

// modules.c
AP_DECLARE_DATA module  * ap_prelinked_modules[]  =  {
   & core_module,
   & win32_module,
   & mpm_winnt_module,
   & http_module,
   & so_module,
  NULL
};

ap_module_symbol_t ap_prelinked_module_symbols[]  =  {
  { " core_module " ,  & core_module},
  { " win32_module " ,  & win32_module},
  { " mpm_winnt_module " ,  & mpm_winnt_module},
  { " http_module " ,  & http_module},
  { " so_module " ,  & so_module},
  {NULL, NULL}
};

AP_DECLARE_DATA module  * ap_preloaded_modules[]  =  {
   & core_module,
   & win32_module,
   & mpm_winnt_module,
   & http_module,
   & so_module,
  NULL
};

转载于:https://www.cnblogs.com/diylab/archive/2010/12/24/1916262.html