linux-kernel - Re: [PATCH linux next] Docs/zh_CN: Translate vxlan.rst to Simplified Chinese

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <63cbb800-0040-4f41-8a82-90251da6914e@linux.dev>
Date: Fri, 30 May 2025 11:37:55 +0800
From: Yanteng Si <si.yanteng@...ux.dev>
To: jiang.kun2@....com.cn, alexs@...nel.org, dzm91@...t.edu.cn,
 corbet@....net, linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Cc: xu.xin16@....com.cn, yang.yang29@....com.cn, fan.yu9@....com.cn,
 qiu.yutan@....com.cn, wang.yaxin@....com.cn
Subject: Re: [PATCH linux next] Docs/zh_CN: Translate vxlan.rst to Simplified
 Chinese


在 5/30/25 11:32 AM, jiang.kun2@....com.cn 写道:
> From: Qiu Yutan <qiu.yutan@....com.cn>
>
> translate the "vxlan.rst" into Simplified Chinese
>
> Update to commit 33a1aaf82bcf("docs: vxlan: add info
> about device features")
>
> Signed-off-by: Qiu Yutan <qiu.yutan@....com.cn>
> Signed-off-by: Fan Yu <fan.yu9@....com.cn>
> Signed-off-by: Jiang Kun <jiang.kun2@....com.cn>
> Signed-off-by: xu xin <xu.xin16@....com.cn>

Reviewed-by: Yanteng Si <si.yanteng@...ux.dev>


Thanks,

Yanteng

> ---
>   .../translations/zh_CN/networking/index.rst   |  2 +-
>   .../translations/zh_CN/networking/vxlan.rst   | 85 +++++++++++++++++++
>   2 files changed, 86 insertions(+), 1 deletion(-)
>   create mode 100644 Documentation/translations/zh_CN/networking/vxlan.rst
>
> diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
> index d07dd69f980b..ed62950c6a1b 100644
> --- a/Documentation/translations/zh_CN/networking/index.rst
> +++ b/Documentation/translations/zh_CN/networking/index.rst
> @@ -21,6 +21,7 @@
>      :maxdepth: 1
>
>      msg_zerocopy
> +   vxlan.rst
>
>   Todolist:
>
> @@ -142,7 +143,6 @@ Todolist:
>   *   tuntap
>   *   udplite
>   *   vrf
> -*   vxlan
>   *   x25
>   *   x25-iface
>   *   xfrm_device
> diff --git a/Documentation/translations/zh_CN/networking/vxlan.rst b/Documentation/translations/zh_CN/networking/vxlan.rst
> new file mode 100644
> index 000000000000..b1a67d2e7b8e
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/networking/vxlan.rst
> @@ -0,0 +1,85 @@
> +.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/networking/vxlan.rst
> +
> +:翻译:
> +
> + 范雨 Fan Yu <fan.yu9@....com.cn>
> +
> +:校译:
> +
> + - 邱禹潭 Qiu Yutan <qiu.yutan@....com.cn>
> + - 徐鑫 xu xin <xu.xin16@....com.cn>
> +
> +==========================
> +虚拟扩展本地局域网协议文档
> +==========================
> +
> +VXLAN 协议是一种隧道协议，旨在解决 IEEE 802.1q 中 VLAN ID（4096）有限的问题。
> +VXLAN 将标识符的大小扩展到 24 位（16777216）。
> +
> +VXLAN 在 IETF RFC 7348 中进行了描述，并已由多家供应商设计实现。
> +该协议通过 UDP 协议运行，并使用特定目的端口。
> +本文档介绍了 Linux 内核隧道设备，Openvswitch 也有单独的 VXLAN 实现。
> +
> +与大多数隧道不同，VXLAN 是 1 对 N 的网络，而不仅仅是点对点网络。
> +VXLAN 设备可以通过类似于学习桥接器的方式动态学习另一端点的 IP 地址，也可以利用静态配置的转发条目。
> +
> +VXLAN 的管理方式与它的两个近邻 GRE 和 VLAN 相似。
> +配置 VXLAN 需要 iproute2 的版本与 VXLAN 首次向上游合并的内核版本相匹配。
> +
> +1. 创建 vxlan 设备::
> +
> +	# ip link add vxlan0 type vxlan id 42 group 239.1.1.1 dev eth1 dstport 4789
> +
> +这将创建一个名为 vxlan0 的网络设备，该设备通过 eth1 使用组播组 239.1.1.1 处理转发表中没有条目的流量。
> +目标端口号设置为 IANA 分配的值 4789，VXLAN 的 Linux 实现早于 IANA 选择标准目的端口号的时间。
> +因此默认使用 Linux 选择的值，以保持向后兼容性。
> +
> +2. 删除 vxlan 设备::
> +
> +	# ip link delete vxlan0
> +
> +3. 查看 vxlan 设备信息::
> +
> +	# ip -d link show vxlan0
> +
> +使用新的 bridge 命令可以创建、销毁和显示 vxlan 转发表。
> +
> +1. 创建vxlan转发表项::
> +
> +	# bridge fdb add to 00:17:42:8a:b4:05 dst 192.19.0.2 dev vxlan0
> +
> +2. 删除vxlan转发表项::
> +
> +	# bridge fdb delete 00:17:42:8a:b4:05 dev vxlan0
> +
> +3. 显示vxlan转发表项::
> +
> +	# bridge fdb show dev vxlan0
> +
> +以下网络接口控制器特性可能表明对 UDP 隧道相关的卸载支持（最常见的是 VXLAN 功能，
> +但是对特定封装协议的支持取决于网络接口控制器）：
> +
> + - `tx-udp_tnl-segmentation`
> + - `tx-udp_tnl-csum-segmentation`
> +    对 UDP 封装帧执行 TCP 分段卸载的能力
> +
> + - `rx-udp_tunnel-port-offload`
> +    在接收端解析 UDP 封装帧，使网络接口控制器能够执行协议感知卸载，
> +    例如内部帧的校验和验证卸载（只有不带协议感知卸载的网络接口控制器才需要）
> +
> +对于支持 `rx-udp_tunnel-port-offload` 的设备，可使用 `ethtool` 查询当前卸载端口的列表::
> +
> +  $ ethtool --show-tunnels eth0
> +  Tunnel information for eth0:
> +    UDP port table 0:
> +      Size: 4
> +      Types: vxlan
> +      No entries
> +    UDP port table 1:
> +      Size: 4
> +      Types: geneve, vxlan-gpe
> +      Entries (1):
> +          port 1230, vxlan-gpe