菜鸟nginx源代码剖析数据结构篇(八) 缓冲区链表ngx_chain_t

菜鸟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_t

nginx的缓冲区链表例如以下图所看到的。ngx_chain_t为链表。ngx_buf_t为缓冲区结点:

image

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: }

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zzzpgz.html