nginx的数据结构集合(随时更新)

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

   1typedef 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;
posted @ 2015-08-12 18:32  sigma0  阅读(257)  评论(0编辑  收藏  举报