Nginx源码初探之数据结构 - cycle数据结构

ngx_cycle_t介绍

        ngx_cycle_t是Nginx的私有结构体，换句话说是Nginx的业务结构体。在Nginx系统中，Nginx的大部分初始化工作主要围绕一个类型为ngx_cycle_t类型的全局变量(cycle)展开。

1.数据结构

struct ngx_cycle_s {
    void                  ****conf_ctx;/*模块配置项，它是一个数组，保存着所有模块的配置项*/
    ngx_pool_t               *pool;/*内存池 */

    ngx_log_t                *log;
    ngx_log_t                 new_log;

    ngx_uint_t                log_use_stderr;  /* unsigned  log_use_stderr:1; */

    ngx_connection_t        **files;/*所有连接的指针数组*/
    ngx_connection_t         *free_connections;/*空闲连接池 */
    ngx_uint_t                free_connection_n;/*空闲连接池数量 */

    ngx_module_t            **modules;
    ngx_uint_t                modules_n;
    ngx_uint_t                modules_used;    /* unsigned  modules_used:1; */

    ngx_queue_t               reusable_connections_queue;
    ngx_uint_t                reusable_connections_n;

    ngx_array_t               listening;/*存放监听socket的数组，元素类型为ngx_listening_t结构体*/
    ngx_array_t               paths;/*ngx_path_t结构体数组，主要操作目录*/

    ngx_array_t               config_dump;
    ngx_rbtree_t              config_dump_rbtree;
    ngx_rbtree_node_t         config_dump_sentinel;

    ngx_list_t                open_files;/*打开的文件描述符列表*/
    ngx_list_t                shared_memory;

    ngx_uint_t                connection_n;/*Nginx当前建立的链接数量*/
    ngx_uint_t                files_n;/*打开的文件个数*/

    ngx_connection_t         *connections;/*当前进程中所有的连接*/
    ngx_event_t              *read_events;/*所有读事件*/
    ngx_event_t              *write_events;/*所有写事件*/

    ngx_cycle_t              *old_cycle;/**/

    ngx_str_t                 conf_file;/*配置文件名*/
    ngx_str_t                 conf_param;/*读取配置文件时需要特殊处理的参数*/
    ngx_str_t                 conf_prefix;/*配置文件目录*/
    ngx_str_t                 prefix;/*Nginx安装目录*/
    ngx_str_t                 lock_file;/*文件锁名称*/
    ngx_str_t                 hostname;/*Nginx程序运行所在主机名*/
};

         从结构体看，ngx_cycle_s结构体管理的信息包含内存池，日志，网络链接，事件，配置文件，锁文件和模块信息，监听信息。Nginx运行过程中也是在反复的维护这个结构体的全局变量。