From ca19907be08a885afed14a97b5e3d0a4d31761b1 Mon Sep 17 00:00:00 2001 From: yinbin Date: Fri, 6 Dec 2024 15:59:15 +0800 Subject: [PATCH] update Gazelle.md --- docs/zh/docs/Gazelle/Gazelle.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/zh/docs/Gazelle/Gazelle.md b/docs/zh/docs/Gazelle/Gazelle.md index c85268551..750f0cd32 100644 --- a/docs/zh/docs/Gazelle/Gazelle.md +++ b/docs/zh/docs/Gazelle/Gazelle.md @@ -139,7 +139,7 @@ GAZELLE_BIND_PROCNAME=test LD_PRELOAD=/usr/lib64/liblstack.so ./test |选项|参数格式|说明| |:---|:---|:---| -|dpdk_args|--socket-mem（必需）
--huge-dir（必需）
--proc-type（必需）
--legacy-mem
--map-perfect
-d|dpdk初始化参数，参考dpdk说明
--map-perfect为扩展特性，用于防止dpdk占用多余的地址空间，保证ltran有额外的地址空间分配给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占用多余的地址空间，保证ltran有额外的地址空间分配给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。| @@ -156,6 +156,8 @@ GAZELLE_BIND_PROCNAME=test LD_PRELOAD=/usr/lib64/liblstack.so ./test |rpc_number|4|设置为正整数，表示每次协议栈循环中rpc消息处理的个数。| |nic_read_num|128|设置为正整数，表示每次协议栈循环中从网卡读取的数据包的个数。| |mbuf_pool_size|1024000|设置为小于5120000的正整数，表示初始化时申请的mbuf地址池大小，需要根据网卡硬件支持进行合理配置，配置过小会启动失败。| +|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示例： @@ -311,6 +313,9 @@ gazelle使用的网卡由dpdk接管，因此普通的tcpdump无法抓到gazelle - ltran的bond1主备模式，只支持链路层故障主备切换（例如网线断开），不支持物理层故障主备切换（例如网卡下电、拔网卡）。 - 虚拟机网卡不支持多队列。 - 使能UDP协议时需要开启kni，除非网卡驱动同时支持用户态和内核态，比如mlx5网卡。 +- 中断模式：容器场景，仅支持ipvlan网口，使用xdp模式进行收发包；不支持共线程模式。性能优化效果下降。 +- XDP模式：仅支持ipvlan的l2模式网口，仅支持单网口单队列，需要内核开启xdp支持。 +- 容器资源自动化部署：需开启xdp，不支持多队列。 ### 操作约束 -- Gitee