ngx_connection_t结构体

最新推荐文章于 2025-03-14 14:25:01 发布

随心而动随意而行

最新推荐文章于 2025-03-14 14:25:01 发布

阅读量6k

点赞数 1

分类专栏： Nginx

本文链接：https://blog.youkuaiyun.com/u013009575/article/details/18793817

版权

Nginx 专栏收录该内容

18 篇文章

订阅专栏

ngx_connection_t结构体是ngx_event_model模块的核心部分，它详细定义了连接对象的各种属性，如套接字句柄、事件、接收和发送方法、内存池、地址信息以及多种状态标志。结构体中的成员如recv和send用于网络数据的读写，pool表示连接相关的内存池，而addr_text存储了客户端的IP地址。此外，还包括SSL连接对象、连接状态标志（如idle、close、reusable）以及处理请求的相关计数。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

//服务器的被动连接

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
};