菜鸟nginx源代码剖析数据结构篇(八) 缓冲区链表 ngx_chain_t
Author:Echo Chen(陈斌)
Email:chenb19870707@gmail.com
Blog:Blog.csdn.net/chen19870707
Date:Nov 6th, 2014
1.缓冲区链表结构ngx_chain_t和ngx_buf_tnginx的缓冲区链表例如以下图所看到的。ngx_chain_t为链表。ngx_buf_t为缓冲区结点:
2.源码位置头文件:
源文件:
3.数据结构定义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: * 当前缓冲区的影子缓冲区。该成员非常少用到。当缓冲区转发上游server的响应时才使用了shadow成员, 34: * 这是由于nginx太节约内存了。分配一块内存并使用ngx_buf_t表示接收到的上游server响应后, 35: * 在向下游client转发时可能会把这块内存存储到文件里,也可能直接向下游发送,此时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: }