用CPP做apache的module

July 15th, 2006 | Posted in Apache   1 Comment

有三个地方要改

  1. 首先注释掉include/ap_config_auto.h里面的
    #define AP_HAVE_DESIGNATED_INITIALIZER 1
  2. 然后在ap_config.h里面增加这几行
    #if (defined(__GNUC__) && !defined(__cplusplus))                   \
    || (defined(__STDC_VERSION) && __STDC_VERSION__ > 199901L)
    #define AP_HAVE_DESIGNATED_INITIALIZER 1
    #endif
  3. 再到http_config.h里面修改
    typedef const char *(*cmd_func) ();

    #if (defined(__GNUC__) && !defined(__cplusplus))                \
    || (defined(__STDC_VERSION) && __STDC_VERSION__ > 199901L)
    typedef const char *(*cmd_func) ();
    #else
    typedef const char *(*cmd_func) (cmd_parms*, void*, const char*);
    #endif

apache module中取post数据

April 30th, 2006 | Posted in Apache   Add Comment

一共使用三个函数

  1. ap_setup_client_block(r, REQUEST_CHUNKED_DECHUNK)
    Apache里面说Setup the client to allow Apache to read the request body. 差不多意思就是初始化,第二个参数可以取以下三个值。

    1. REQUEST_NO_BODY
      意为如果request必须没有body,如果有就发一个413错误
    2. REQUEST_CHUNKED_ERROR
      意为request必须不可为chunked,如果有就发一个411错误
    3. REQUEST_CHUNKED_DECHUNK
      意思为如果chunked了,则dechunk。

    对于我们要读取post的数据,只能取后面两个,而chunked则是对长连接的选项了,使用哪个视情况而定。

  2. ap_should_client_block(r)
    检查是否有数据,对于chunked的话会发送一个100 continue的命令让客户端继续发送数据。
  3. ap_get_client_block(r, pBuff, size)
    读取数据

apache及其module的调试

April 30th, 2006 | Posted in Apache   1 Comment
  1. gdb httpd
    用gdb加载httpd进程
  2. (gdb) b break-point
    设置断点,可以设置函数名、行数等……
  3. (gdb) run -X -d /usr/local/apache
    执行httpd,这个是关键的,-X参数会让httpd以debug模式运行,debug模式是单进程的,这样才好调试。-d /usr/local/apache是设置运行的目录。

另外,gdb httpd pid可以attach一个正在运行的httpd来调试。

About module struct in Apache

April 4th, 2006 | Posted in Apache   Add Comment

在写apache模块的时候,会用到module这个结构体。module这个结构体实际上是module_struct,后面附上了定义。使用的时候通常都是定义一个这个结构体的变量并赋初值,如:

module AP_MODULE_DECLARE_DATA proxy_module =
{
STANDARD20_MODULE_STUFF,
create_proxy_dir_config,    /* create per-directory config structure */
merge_proxy_dir_config,     /* merge per-directory config structures */
create_proxy_config,        /* create per-server config structure */
merge_proxy_config,         /* merge per-server config structures */
proxy_cmds,                 /* command table */
register_hooks
};

其中STANDARD20_MODULE_STUFF这个宏为module_struct中的API version, minor version, module index, name, danamic load handle, next, magic, rewrite_args赋了初值。随后是per-directory configuration structure的初始化、合并函数和per-server configuration structure的初始化、合并函数。command table是command_rec结构的一个数组,依然是宏展开,描述这个模块在配置文件里面的信息。最后的register_hooks指向用于注册hook的函数。

typedef struct module_struct module;
/**
* Module structures.  Just about everything is dispatched through
* these, directly or indirectly (through the command and handler
* tables).
*/
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);
};

Apache中的挂钩剖析

April 4th, 2006 | Posted in Apache   Add Comment

From http://fanqiang.chinaunix.net/app/web/2006-02-21/4009.shtml,作者:张中庆。