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;