nginx的数据结构集合（随时更新）

在学习nginx的时候，因为其数据结构略多，看过后一般就忘记了。所以边学习边记录在这里吧，方便以后查看。

ngx_buf_t：缓冲区结点

   1： typedef struct ngx_buf_s    ngx_buf_t;
   2: typedef void  *ngx_buf_tag_t;
   3: struct ngx_buf_s {
   4:     /*
   5:      * pos通常是用来告诉使用者本次应该从pos这个位置开始处理内存中的数据，这样设置是因为同一个
   6:      * ngx_buf_t可能被多次反复处理。当然，pos的含义是由使用它的模板定义的
   7:      */
   8:     u_char  *pos;
   9:
  10:     /* last通常表示有效的内容到此为止，注意，pos与last之间的内存是希望nginx处理的内容 */
  11:     u_char  *last;
  12:
  13:     /*
  14:      * 处理文件时，file_pos与file_last的含义与处理内存时的pos与last相同，
  15:      * file_pos表示将要处理的文件位置，file_last表示截至的文件位置。
  16:      */
  17:     off_t   file_pos;
  18:     off_t   file_last;
  19:
  20:     /* 如果ngx_buf_t缓冲区用于内存，那么start指向这段内存的起始地址 */
  21:     u_char  *start;
  22:
  23:     /* 与start成员对应，指向缓冲区内存的末尾 */
  24:     u_char  *end;
  25:
  26:     /* 表示当前缓冲区的类型，例如由哪个模块使用就指向这个模块ngx_module_t变量的地址 */
  27:     ngx_buf_tag_t  tag;
  28:
  29:     /* 引用的文件 */
  30:     ngx_file_t  *file;
  31:
  32:     /*
  33:      * 当前缓冲区的影子缓冲区，该成员很少用到。当缓冲区转发上游服务器的响应时才使用了shadow成员，
  34:      * 这是因为nginx太节约内存了，分配一块内存并使用ngx_buf_t表示接收到的上游服务器响应后，
  35:      * 在向下游客户端转发时可能会把这块内存存储到文件中，也可能直接向下游发送，此时nginx绝对不会
  36:      * 重新复制一份内存用于新的目的，而是再次建立一个ngx_buf_t结构体指向原内存，这样多个ngx_buf_t
  37:      * 结构体指向了同一份内存，它们之间的关系就通过shadow成员来引用，一般不建议使用。
  38:      */
  39:     ngx_buf_t   *shadow;
  40:
  41:     /* 临时内存标志位，为1时表示数据在内存中且这段内存可以修改 */
  42:     unsigned    temporay:1;
  43:
  44:     /* 标志位，为1时表示数据在内存中且这段内存不可以修改 */
  45:     unsigned    memory:1;
  46:
  47:     /* 标志位，为1时表示这段内存是用nmap系统调用映射过来的，不可以修改 */
  48:     unsigned    mmap:1;
  49:
  50:     /* 标志位，为1时表示可回收 */
  51:     unsigned    recycled:1;
  52:
  53:     /* 标志位，为1时表示这段缓冲区处理的是文件而不是内存 */
  54:     unsigned    in_file:1;
  55:
  56:     /* 标志位，为1时表示需要执行flush操作 */
  57:     unsigned    flush:1;
  58:
  59:     /*
  60:      * 标志位，对于操作这块缓冲区时是否使用同步方式，需谨慎考虑，这可能会阻塞nginx进程，nginx中所有
  61:      * 操作几乎都是异步的，这是它支持高并发的关键。有些框架代码在sync为1时可能会有阻塞的方式进行I/O
  62:      * 操作，它的意义视使用它的nginx模块而定。
  63:      */
  64:     unsigned    sync:1;
  65:
  66:     /*
  67:      * 标志位，表示是否是最后一块缓冲区，因为ngx_buf_t可以由ngx_chain_t链表串联起来，因此为1时，
  68:      * 表示当前是最后一块待处理的缓冲区。
  69:      */
  70:     unsigned    last_buf:1;
  71:
  72:     /* 标志位，表示是否是ngx_chain_t中的最后一块缓冲区 */
  73:     unsigned    last_in_chain:1;
  74:
  75:     /* 标志位，表示是否是最后一个影子缓冲区，与shadow域配合使用。通常不建议使用它 */
  76:     unsigned    last_shadow:1;
  77:
  78:     /* 标志位，表示当前缓冲区是否属于临时文件 */
  79:     unsigned    temp_file:1;
  80: }

ngx_chain_t：缓冲区链表

  typedef struct ngx_chain_s       ngx_chain_t;
   struct ngx_chain_s
    {
       ngx_buf_t    *buf; //buf指向当前的ngx_buf_t缓冲区
      ngx_chain_t  *next; //next则用来指向下一个ngx_chain_t，如果这是最后一个ngx_chain_t，则需要把next置为NULL。
   };

ngx_http_upstream_t:设置upstream的限制性参数

typedef struct{
...
//连接上游服务器的超时时间，单位为毫秒
ngx_msec_t connect_timeout;
//发送TCP包到上游服务器的超时时间，单位为毫秒
ngx_msec_t connect_timeout;
//接收TCP包到上游服务器的超时时间，单位为毫秒
ngx_msec_t connect_timeout;
...
}ngx_http_upstream_conf_t;