ngx_connection_t结构体

悠悠 2022-01-23 14:15 88阅读 0赞

# ngx\_connection\_t结构体 #

//服务器的被动连接
     
    struct ngx_connection_s {
        //连接未使用时候,data域充当连接链表中的next指针.
    	//当连接被使用时候,data域的意义由模块而定.
        void               *data;
    	//连接对应的读事件
        ngx_event_t        *read;
    	//连接对应的写事件
        ngx_event_t        *write;
     
        //套接字句柄
    	ngx_socket_t        fd;
     
        //直接接收网络字节流的方法
    	ngx_recv_pt         recv;
    	//直接放松网络字节流的方法
        ngx_send_pt         send;
    	//以ngx_chain链表为参数,接收网络字节流的方法
        ngx_recv_chain_pt   recv_chain;
    	//以ngx_chain链表为参数,发送网络字节流的方法
        ngx_send_chain_pt   send_chain;
     
        //这个链接对应的listening_t监听对象.
    	//此链接由ngx_listening_t监听的事件建立
    	ngx_listening_t    *listening;
     
        //这个连接已经发送出去的字节数
    	off_t               sent;
     
        //记录日志
    	ngx_log_t          *log;
     
        //在accept一个新连接的时候,会创建一个内存池,而这个连接结束时候,会销毁一个内存池.
    	//这里所说的连接是成功建立的tcp连接.内存池的大小由pool_size决定
    	//所有的ngx_connect_t结构体都是预分配的
    	ngx_pool_t         *pool;
     
        //连接客户端的结构体
    	struct sockaddr    *sockaddr;
        //连接客户端的结构体长度
    	socklen_t           socklen;
    	//连接客户端的ip(字符串形式)
        ngx_str_t           addr_text;
     
    #if (NGX_SSL)
        ngx_ssl_connection_t  *ssl;
    #endif
     
        //本机中监听端口对应的socketaddr结构体
    	//也就是listen监听对象中的socketaddr成员
    	struct sockaddr    *local_sockaddr;
     
        //用于接收和缓存客户端发来的字符流
    	ngx_buf_t          *buffer;
     
        //该字段表示将该连接以双向链表形式添加到cycle结构体中的
    	//reusable_connections_queen双向链表中,表示可以重用的连接.
    	ngx_queue_t         queue;
     
        //连接使用次数,每次建立一条来自客户端的连接,
    	//或者建立一条与后端服务器的连接,number+1
    	ngx_atomic_uint_t   number;
     
        //处理请求的次数
    	ngx_uint_t          requests;
     
        //
    	unsigned            buffered:8;
     
        //日志级别
    	unsigned            log_error:3;     /* ngx_connection_log_error_e */
     
        //不期待字符流结束
    	unsigned            unexpected_eof:1;
        //连接超时
    	unsigned            timedout:1;
        //连接处理过程中出现错误
    	unsigned            error:1;
        //标识此链接已经销毁,内存池,套接字等都不可用
    	unsigned            destroyed:1;
     
        //连接处于空闲状态
    	unsigned            idle:1;
        //连接可以重用
    	unsigned            reusable:1;
        //连接关闭
    	unsigned            close:1;
     
        //正在将文件中的数据法网另一端
    	unsigned            sendfile:1;
    	//连接中发送缓冲区的数据高于低潮,才发送数据.
    	//与ngx_handle_write_event方法中的lowat相对应
        unsigned            sndlowat:1;
    	//使用tcp的nodely特性
        unsigned            tcp_nodelay:2;   /* ngx_connection_tcp_nodelay_e */
        //使用tcp的nopush特性
    	unsigned            tcp_nopush:2;    /* ngx_connection_tcp_nopush_e */
     
    #if (NGX_HAVE_IOCP)
        unsigned            accept_context_updated:1;
    #endif
     
    #if (NGX_HAVE_AIO_SENDFILE)
        unsigned            aio_sendfile:1;
        ngx_buf_t          *busy_sendfile;
    #endif
     
    #if (NGX_THREADS)
        ngx_atomic_t        lock;
    #endif
    };