ngx_listening_s

<code><span>typedef</span><span>struct</span> ngx_listening_s ngx_listening_t;

<span>struct</span> ngx_listening_s {
    <span>//socket套接字句柄</span>
    ngx_socket_t        fd;
    <span>//监听sockaddr地址</span><span>struct</span> sockaddr *sockaddr;
    <span>//sockaddr地址长度</span>
    socklen_t           socklen;
    <span>/* 存储IP地址的字符串addr_text最大长度，即指定了addr_text所分配的内存大小 */</span>
    size_t          addr_text_max_len;
    <span>//以字符串形式储存IP地址</span>
    ngx_str_t           addr_text;
    <span>//套接字类型</span><span>int</span>                 type;
    <span>/* TCP实现监听时的backlog队列，它表示允许正在通过三次握手建立连接但还未任何进程开始处理连接的最大数 */</span><span>int</span>                 backlog;
    <span>//内核中对于这个套接字的接收缓冲区大小</span><span>int</span>                 rcvbuf;
    <span>//内核中对这个套接字的发送缓冲区大小</span><span>int</span>                 sndbuf;
    <span>//新的TCP连接成功后的处理方法</span>
    ngx_connection_handler_pt   handler;
    <span>/* 保存当前监听端口对应的所有主机名 */</span><span>void</span>                *servers;
    <span>//log和logp都是可用日志对象指针</span>
    ngx_log_t           <span>log</span>;
    ngx_log_t           *logp;
    <span>//为新的TCP连接创建内存池的大小</span>
    size_t              pool_size;
    <span>//TCP连接建立后，在post_accept_timeout秒之后仍然没有收到用户数据，则内核直接丢弃连接</span>
    ngx_msec_t      post_accept_timeout;
    <span>//指向前一个ngx_listening_t结构</span>
    ngx_listening_t *previous;
    <span>//当前监听句柄对应着的ngx_connection_t结构体</span>
    ngx_connection_t    *connection;
    <span>//1：当前监听句柄有效；0：正常关闭</span><span>unsigned</span>            open:<span>1</span>;
    <span>//1:用已有的ngx_cycle_t来初始化ngx_cycle_t结构体时，不关闭监听端口，对于运行中升级有用</span><span>unsigned</span>            remain:<span>1</span>;
    <span>//1:跳过设置当前ngx_listening_t结构体中的套接字；0：正常初始化</span><span>unsigned</span>            ignore:<span>1</span>;
    <span>//表示是否以绑定</span><span>unsigned</span>            bound:<span>1</span>;
    <span>//1：当前监听句柄来自前一个进程</span><span>unsigned</span>            inherited:<span>1</span>;
    <span>//未使用</span><span>unsigned</span>            nonblocking_accept:<span>1</span>;
    <span>//1：已开始监听</span><span>unsigned</span>            listen:<span>1</span>;
    <span>//表示是否阻塞</span><span>unsigned</span>            nonblocking:<span>1</span>;
    <span>//无意义</span><span>unsigned</span>            share:<span>1</span>;
    <span>//1：Nginx将网络地址转变为字符串形式的地址</span><span>unsigned</span>            addr_ntop:<span>1</span>;
};

<span>//在监听端口上成功建立新的TCP连接后，回调handler方法</span><span>typedef</span><span>void</span> (*ngx_connection_handler_pt)(ngx_connection_t *c);</code>