ngx_pool_cleanup_add

1 定义ngx_pool_cleanup_add 函数 定义在 ./nginx-1.24.0/src/core/ngx_palloc.cngx_pool_cleanup_t*ngx_pool_cleanup_add(ngx_pool_t*p,size_tsize){ngx_pool_cleanup_t*c;cngx_palloc(p,sizeof(ngx_pool_cleanup_t));if(cNULL){returnNULL;}if(size){c-datangx_palloc(p,size);if(c-dataNULL){returnNULL;}}else{c-dataNULL;}c-handlerNULL;c-nextp-cleanup;p-cleanupc;ngx_log_debug1(NGX_LOG_DEBUG_ALLOC,p-log,0,add cleanup: %p,c);returnc;}ngx_pool_cleanup_add 函数的作用是 向指定的内存池注册一个资源清理节点并返回该节点指针。 调用者可以设置节点中的清理回调函数与上下文数据 当内存池被销毁时该回调会被自动调用以释放关联的外部资源2 详解1 函数签名ngx_pool_cleanup_t*ngx_pool_cleanup_add(ngx_pool_t*p,size_tsize)返回值 函数返回一个指向新分配的 ngx_pool_cleanup_t 节点的指针。 调用者通过该指针设置具体的清理函数c-handler和上下文数据c-data。 若分配失败如内存池空间不足则返回 NULL。 ngx_pool_cleanup_t 是 Nginx 内部定义的清理节点结构体 包含三个字段 handler清理函数指针、data自定义数据指针、next指向下一个清理节点的指针参数1 ngx_pool_t *p 明确指定当前清理节点归属于哪个内存池 当这个内存池被销毁时才会触发该节点的清理回调 参数2 size_t size 表示额外数据块的大小字节数 若 size 0函数会额外从同一个池 p 中分配一块大小为 size 的内存 并将其地址赋给清理节点的 data 字段。2 逻辑流程1 局部变量 2 分配节点内存 3 初始化节点 4 返回新分配的清理节点指针1 局部变量{ngx_pool_cleanup_t*c;声明局部指针变量 c用于指向新分配的清理节点。 在函数内暂存节点地址后续操作围绕 c 展开。2 分配节点内存cngx_palloc(p,sizeof(ngx_pool_cleanup_t));if(cNULL){returnNULL;}从内存池 p 中分配一个 ngx_pool_cleanup_t 结构大小的内存并将地址赋给 c3 初始化节点if(size){c-datangx_palloc(p,size);if(c-dataNULL){returnNULL;}}else{c-dataNULL;}如果 size 0从池中额外分配 size 字节的内存并将 c-data 指向这块内存 若 size 0将 c-data 置为 NULLc-handlerNULL;c-nextp-cleanup;p-cleanupc;ngx_log_debug1(NGX_LOG_DEBUG_ALLOC,p-log,0,add cleanup: %p,c);#1 初始化清理回调函数指针为 NULL #2 将新清理节点插入到内存池现有清理链表的头部 #3 将池的 cleanup 指针指向新节点 #4 输出 调试日志4 返回新分配的清理节点指针returnc;}