diff --git a/docs/zh/docs/Gazelle/Gazelle.md b/docs/zh/docs/Gazelle/Gazelle.md index 7dfbbbf4875468a244369c9b5453fe57c8781a74..cd15638f8509de3b5bb886f8f523d76887a001e3 100644 --- a/docs/zh/docs/Gazelle/Gazelle.md +++ b/docs/zh/docs/Gazelle/Gazelle.md @@ -129,7 +129,7 @@ gcc test.c -o test ${LSTACK_LIBS} |选项|参数格式|说明| |:---|:---|:---| -|dpdk_args|--socket-mem(必需)
--huge-dir(必需)
--proc-type(必需)
--legacy-mem
--map-perfect
-d|dpdk初始化参数,参考dpdk说明
--map-perfect为扩展特性,用于防止dpdk占用多余的地址空间,保证有额外的地址空间分配给lstack。
-d参数加载指定so库文件| +|dpdk_args|--socket-mem(必需)
--huge-dir(必需)
--proc-type(必需)
--legacy-mem
--map-perfect
-d
"--vdev","net_af_xdp,iface=ipvlan0,queue_count=1"|dpdk初始化参数,参考dpdk说明
--map-perfect为扩展特性,用于防止dpdk占用多余的地址空间,保证有额外的地址空间分配给lstack。
-d参数加载指定so库文件
"net_af_xdp,iface=ipvlan0,queue_count=1"用于支持使用native xdp的方式接管网口流量,将数据包输送给用户态,"ipvlan0"为需要挂在xdp进行流量收发的网卡名| |listen_shadow| 0/1 | 是否使用影子fd监听。单listen线程,多协议栈线程时是能| |use_ltran| 0/1 | 是否使用ltran ,功能已衰退,不再支持| |num_cpus|"0,2,4 ..."|lstack线程绑定的cpu编号,编号的数量为lstack线程个数(小于等于网卡多队列数量)。可按NUMA选择cpu| @@ -152,6 +152,8 @@ gcc test.c -o test ${LSTACK_LIBS} |nic_vlan_mode|-1|是否开启vlan模式,默认值-1关闭,取值范围-1~4095,0和4095是业界通用预留id无实际效果| |tcp_conn_count|1500|tcp的最大连接数,该参数乘以mbuf_count_per_conn是初始化时申请的mbuf池大小,配置过小会启动失败,tcp_conn_count * mbuf_count_per_conn * 2048字节不能大于大页大小 | |mbuf_count_per_conn|170|每个tcp连接需要的mbuf个数,该参数乘以tcp_conn_count是初始化时申请的mbuf地址池大小,配置过小会启动失败,tcp_conn_count * mbuf_count_per_conn * 2048字节不能大于大页大小| +|stack_interrupt|0/1|是否开启中断模式,默认为0(关闭),置为1,则开启中断模式。| +|stack_num|0/1|容器自动化部署,1为开启,0为关闭。使用该参数会根据tcp_conn_count、mbuf_count_per_conn等参数自动计算大页内存,自动配置host_arrd、mask_addr、gateway_addr、devices等。当前只支持xdp模式| lstack.conf示例: @@ -251,7 +253,10 @@ lstack启动时可以通过指定环境变量GAZELLE_THREAD_NAME来指定lstack - 当前仅支持TCP、ICMP、ARP、IPv4、UDP 协议。 - 在对端ping Gazelle时,要求指定报文长度小于等于14000B。 - 不支持使用透明大页。 -- 虚拟机网卡不支持多队列。 +- 虚拟机网卡不支持多队列。 +- 中断模式:容器场景,仅支持ipvlan网口,使用xdp模式进行收发包;不支持共线程模式。性能优化效果下降。 +- XDP模式:仅支持ipvlan的l2模式网口,仅支持单网口单队列,需要内核开启xdp支持。 +- 容器资源自动化部署:需开启xdp,不支持多队列。 ### 操作约束