[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <20250722171809277Jlr4qfL1GzzrOlzJGPIht@zte.com.cn>
Date: Tue, 22 Jul 2025 17:18:09 +0800 (CST)
From: <wang.yaxin@....com.cn>
To: <wang.yaxin@....com.cn>
Cc: <alexs@...nel.org>, <si.yanteng@...ux.dev>, <corbet@....net>,
<linux-doc@...r.kernel.org>, <linux-kernel@...r.kernel.org>,
<xu.xin16@....com.cn>, <yang.yang29@....com.cn>, <fan.yu9@....com.cn>,
<he.peilin@....com.cn>, <tu.qiang35@....com.cn>,
<qiu.yutan@....com.cn>, <zhang.yunkai@....com.cn>,
<sun.yuxi@....com.cn>, <jiang.kun2@....com.cn>
Subject: [PATCH 3/4 linux-next] Docs/zh_CN: Translate generic-hdlc.rst to Simplified
Chinese
From: Sun yuxi <sun.yuxi@....com.cn>
translate the "generic-hdlc.rst" into Simplified Chinese.
Update the translation through commit 16128ad8f927
("docs: networking: convert generic-hdlc.txt to ReST")
Signed-off-by: Wang Yaxin <wang.yaxin@....com.cn>
Signed-off-by: Sun yuxi <sun.yuxi@....com.cn>
---
.../zh_CN/networking/generic-hdlc.rst | 176 ++++++++++++++++++
.../translations/zh_CN/networking/index.rst | 2 +-
2 files changed, 177 insertions(+), 1 deletion(-)
create mode 100644 Documentation/translations/zh_CN/networking/generic-hdlc.rst
diff --git a/Documentation/translations/zh_CN/networking/generic-hdlc.rst b/Documentation/translations/zh_CN/networking/generic-hdlc.rst
new file mode 100644
index 000000000000..da6ebe4a34c6
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/generic-hdlc.rst
@@ -0,0 +1,176 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/generic-hdlc.rst
+
+:翻译:
+
+ 王亚鑫 Wang Yaxin <wang.yaxin@....com.cn>
+
+==========
+通用HDLC层
+==========
+
+Krzysztof Halasa <khc@...waw.pl>
+
+
+通用HDLC层当前支持以下协议:
+
+1. 帧中继(支持ANSI、CCITT、Cisco及无LMI模式)
+
+ - 常规(路由)接口和以太网桥接(以太网设备仿真)接口
+ 可共享同一条PVC。
+ - 支持ARP(内核暂不支持InARP,但可通过实验性用户空间守护程序实现,
+ 下载地址:http://www.kernel.org/pub/linux/utils/net/hdlc/)。
+
+2. 原始HDLC —— 支持IP(IPv4)接口或以太网设备仿真
+3. Cisco HDLC
+4. PPP
+5. X.25(使用X.25协议栈)
+
+通用HDLC仅作为协议驱动 - 必须配合具体硬件的底层驱动
+才能运行。
+
+以太网设备仿真(使用HDLC或帧中继PVC)兼容IEEE 802.1Q(VLAN)和
+802.1D(以太网桥接)。
+
+
+请确保已加载 hdlc.o 和硬件驱动程序。系统将为每个WAN端口创建一个
+"hdlc"网络设备(如hdlc0等)。您需要使用"sethdlc"工具,可从以下
+地址获取:
+
+ http://www.kernel.org/pub/linux/utils/net/hdlc/
+
+编译 sethdlc.c 工具::
+
+ gcc -O2 -Wall -o sethdlc sethdlc.c
+
+请确保使用与您内核版本匹配的 sethdlc 工具。
+
+使用 sethdlc 工具设置物理接口、时钟频率、HDLC 模式,
+若使用帧中继还需添加所需的 PVC。
+通常您需要执行类似以下命令::
+
+ sethdlc hdlc0 clock int rate 128000
+ sethdlc hdlc0 cisco interval 10 timeout 25
+
+或::
+
+ sethdlc hdlc0 rs232 clock ext
+ sethdlc hdlc0 fr lmi ansi
+ sethdlc hdlc0 create 99
+ ifconfig hdlc0 up
+ ifconfig pvc0 localIP pointopoint remoteIP
+
+在帧中继模式下,请先启用主hdlc设备(不分配IP地址),再
+使用pvc设备。
+
+
+接口设置选项:
+
+* v35 | rs232 | x21 | t1 | e1
+ - 当网卡支持软件可选接口时,可为指定端口设置物理接口
+ loopback
+ - 启用硬件环回(仅用于测试)
+* clock ext
+ - RX与TX时钟均使用外部时钟源
+* clock int
+ - RX与TX时钟均使用内部时钟源
+* clock txint
+ - RX时钟使用外部时钟源,TX时钟使用内部时钟源
+* clock txfromrx
+ - RX时钟使用外部时钟源,TX时钟从RX时钟派生
+* rate
+ - 设置时钟速率(仅适用于"int"或"txint"时钟模式)
+
+
+设置协议选项:
+
+* hdlc - 设置原始HDLC模式(仅支持IP协议)
+
+ nrz / nrzi / fm-mark / fm-space / manchester - 传输编码选项
+
+ no-parity / crc16 / crc16-pr0 (预设零值的CRC16) / crc32-itu
+
+ crc16-itu (使用ITU-T多项式的CRC16) / crc16-itu-pr0 - 校验方式选项
+
+* hdlc-eth - 使用HDLC进行以太网设备仿真. 校验和编码方式同上
+ as above.
+
+* cisco - 设置Cisco HDLC模式(支持IP、IPv6和IPX协议)
+
+ interval - 保活数据包发送间隔(秒)
+
+ timeout - 未收到保活数据包的超时时间(秒),超过此时长将判定
+ 链路断开
+
+* ppp - 设置同步PPP模式
+
+* x25 - 设置X.25模式
+
+* fr - 帧中继模式
+
+ lmi ansi / ccitt / cisco / none - LMI(链路管理)类型
+
+ dce - 将帧中继设置为DCE(网络侧)LMI模式(默认为DTE用户侧)。
+
+ 此设置与时钟无关!
+
+ - t391 - 链路完整性验证轮询定时器(秒)- 用户侧
+ - t392 - 轮询验证定时器(秒)- 网络侧
+ - n391 - 全状态轮询计数器 - 用户侧
+ - n392 - 错误阈值 - 用户侧和网络侧共用
+ - n393 - 监控事件计数 - 用户侧和网络侧共用
+
+帧中继专用命令:
+
+* create n | delete n - 添加/删除DLCI编号为n的PVC接口。
+ 新创建的接口将命名为pvc0、pvc1等。
+
+* create ether n | delete ether n - 添加/删除用于以太网
+ 桥接帧的设备设备将命名为pvceth0、pvceth1等。
+
+
+
+
+板卡特定问题
+------------
+
+n2.o 和 c101.o 驱动模块需要参数才能工作::
+
+ insmod n2 hw=io,irq,ram,ports[:io,irq,...]
+
+示例::
+
+ insmod n2 hw=0x300,10,0xD0000,01
+
+或::
+
+ insmod c101 hw=irq,ram[:irq,...]
+
+示例::
+
+ insmod c101 hw=9,0xdc000
+
+若直接编译进内核,这些驱动需要通过内核(命令行)参数配置::
+
+ n2.hw=io,irq,ram,ports:...
+
+或::
+
+ c101.hw=irq,ram:...
+
+
+
+若您的N2、C101或PLX200SYN板卡出现问题,可通过"private"
+命令查看端口数据包描述符环(显示在内核日志中)
+
+ sethdlc hdlc0 private
+
+硬件驱动需使用#define DEBUG_RINGS编译选项构建。
+在提交错误报告时附上这些信息将很有帮助。如在使用过程中遇
+到任何问题,请随时告知。
+
+获取补丁和其他信息,请访问:
+<http://www.kernel.org/pub/linux/utils/net/hdlc/>.
\ No newline at end of file
diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index e03b5d5d39ee..e0494346fa8c 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -29,6 +29,7 @@
alias
mptcp-sysctl
skbuff
+ generic-hdlc
Todolist:
@@ -78,7 +79,6 @@ Todolist:
* eql
* fib_trie
* filter
-* generic-hdlc
* generic_netlink
* netlink_spec/index
* gen_stats
--
2.25.1
<div class="zcontentRow"><p>From: Sun yuxi <sun.yuxi@....com.cn></p><p><br></p><p>translate the "generic-hdlc.rst" into Simplified Chinese.</p><p><br></p><p>Update the translation through commit 16128ad8f927</p><p>("docs: networking: convert generic-hdlc.txt to ReST")</p><p><br></p><p>Signed-off-by: Wang Yaxin <wang.yaxin@....com.cn></p><p>Signed-off-by: Sun yuxi <sun.yuxi@....com.cn></p><p>---</p><p> .../zh_CN/networking/generic-hdlc.rst | 176 ++++++++++++++++++</p><p> .../translations/zh_CN/networking/index.rst | 2 +-</p><p> 2 files changed, 177 insertions(+), 1 deletion(-)</p><p> create mode 100644 Documentation/translations/zh_CN/networking/generic-hdlc.rst</p><p><br></p><p>diff --git a/Documentation/translations/zh_CN/networking/generic-hdlc.rst b/Documentation/translations/zh_CN/networking/generic-hdlc.rst</p><p>new file mode 100644</p><p>index 000000000000..da6ebe4a34c6</p><p>--- /dev/null</p><p>+++ b/Documentation/translations/zh_CN/networking/generic-hdlc.rst</p><p>@@ -0,0 +1,176 @@</p><p>+.. SPDX-License-Identifier: GPL-2.0</p><p>+</p><p>+.. include:: ../disclaimer-zh_CN.rst</p><p>+</p><p>+:Original: Documentation/networking/generic-hdlc.rst</p><p>+</p><p>+:翻译:</p><p>+</p><p>+ 王亚鑫 Wang Yaxin <wang.yaxin@....com.cn></p><p>+</p><p>+==========</p><p>+通用HDLC层</p><p>+==========</p><p>+</p><p>+Krzysztof Halasa <khc@...waw.pl></p><p>+</p><p>+</p><p>+通用HDLC层当前支持以下协议:</p><p>+</p><p>+1. 帧中继(支持ANSI、CCITT、Cisco及无LMI模式)</p><p>+</p><p>+ - 常规(路由)接口和以太网桥接(以太网设备仿真)接口</p><p>+ 可共享同一条PVC。</p><p>+ - 支持ARP(内核暂不支持InARP,但可通过实验性用户空间守护程序实现,</p><p>+ 下载地址:http://www.kernel.org/pub/linux/utils/net/hdlc/)。</p><p>+</p><p>+2. 原始HDLC —— 支持IP(IPv4)接口或以太网设备仿真</p><p>+3. Cisco HDLC</p><p>+4. PPP</p><p>+5. X.25(使用X.25协议栈)</p><p>+</p><p>+通用HDLC仅作为协议驱动 - 必须配合具体硬件的底层驱动</p><p>+才能运行。</p><p>+</p><p>+以太网设备仿真(使用HDLC或帧中继PVC)兼容IEEE 802.1Q(VLAN)和</p><p>+802.1D(以太网桥接)。</p><p>+</p><p>+</p><p>+请确保已加载 hdlc.o 和硬件驱动程序。系统将为每个WAN端口创建一个</p><p>+"hdlc"网络设备(如hdlc0等)。您需要使用"sethdlc"工具,可从以下</p><p>+地址获取:</p><p>+</p><p>+<span style="white-space:pre"> </span>http://www.kernel.org/pub/linux/utils/net/hdlc/</p><p>+</p><p>+编译 sethdlc.c 工具::</p><p>+</p><p>+<span style="white-space:pre"> </span>gcc -O2 -Wall -o sethdlc sethdlc.c</p><p>+</p><p>+请确保使用与您内核版本匹配的 sethdlc 工具。</p><p>+</p><p>+使用 sethdlc 工具设置物理接口、时钟频率、HDLC 模式,</p><p>+若使用帧中继还需添加所需的 PVC。</p><p>+通常您需要执行类似以下命令::</p><p>+</p><p>+<span style="white-space:pre"> </span>sethdlc hdlc0 clock int rate 128000</p><p>+<span style="white-space:pre"> </span>sethdlc hdlc0 cisco interval 10 timeout 25</p><p>+</p><p>+或::</p><p>+</p><p>+<span style="white-space:pre"> </span>sethdlc hdlc0 rs232 clock ext</p><p>+<span style="white-space:pre"> </span>sethdlc hdlc0 fr lmi ansi</p><p>+<span style="white-space:pre"> </span>sethdlc hdlc0 create 99</p><p>+<span style="white-space:pre"> </span>ifconfig hdlc0 up</p><p>+<span style="white-space:pre"> </span>ifconfig pvc0 localIP pointopoint remoteIP</p><p>+</p><p>+在帧中继模式下,请先启用主hdlc设备(不分配IP地址),再</p><p>+使用pvc设备。</p><p>+</p><p>+</p><p>+接口设置选项:</p><p>+</p><p>+* v35 | rs232 | x21 | t1 | e1</p><p>+ - 当网卡支持软件可选接口时,可为指定端口设置物理接口</p><p>+ loopback</p><p>+ - 启用硬件环回(仅用于测试)</p><p>+* clock ext</p><p>+ - RX与TX时钟均使用外部时钟源</p><p>+* clock int</p><p>+ - RX与TX时钟均使用内部时钟源</p><p>+* clock txint</p><p>+ - RX时钟使用外部时钟源,TX时钟使用内部时钟源</p><p>+* clock txfromrx</p><p>+ - RX时钟使用外部时钟源,TX时钟从RX时钟派生</p><p>+* rate</p><p>+ - 设置时钟速率(仅适用于"int"或"txint"时钟模式)</p><p>+</p><p>+</p><p>+设置协议选项:</p><p>+</p><p>+* hdlc - 设置原始HDLC模式(仅支持IP协议)</p><p>+</p><p>+ nrz / nrzi / fm-mark / fm-space / manchester - 传输编码选项</p><p>+</p><p>+ no-parity / crc16 / crc16-pr0 (预设零值的CRC16) / crc32-itu</p><p>+</p><p>+ crc16-itu (使用ITU-T多项式的CRC16) / crc16-itu-pr0 - 校验方式选项</p><p>+</p><p>+* hdlc-eth - 使用HDLC进行以太网设备仿真. 校验和编码方式同上</p><p>+ as above.</p><p>+</p><p>+* cisco - 设置Cisco HDLC模式(支持IP、IPv6和IPX协议)</p><p>+</p><p>+ interval - 保活数据包发送间隔(秒)</p><p>+</p><p>+ timeout - 未收到保活数据包的超时时间(秒),超过此时长将判定</p><p>+<span style="white-space:pre"> </span> 链路断开</p><p>+</p><p>+* ppp - 设置同步PPP模式</p><p>+</p><p>+* x25 - 设置X.25模式</p><p>+</p><p>+* fr - 帧中继模式</p><p>+</p><p>+ lmi ansi / ccitt / cisco / none - LMI(链路管理)类型</p><p>+</p><p>+ dce - 将帧中继设置为DCE(网络侧)LMI模式(默认为DTE用户侧)。</p><p>+</p><p>+ 此设置与时钟无关!</p><p>+</p><p>+ - t391 - 链路完整性验证轮询定时器(秒)- 用户侧</p><p>+ - t392 - 轮询验证定时器(秒)- 网络侧</p><p>+ - n391 - 全状态轮询计数器 - 用户侧</p><p>+ - n392 - 错误阈值 - 用户侧和网络侧共用</p><p>+ - n393 - 监控事件计数 - 用户侧和网络侧共用</p><p>+</p><p>+帧中继专用命令:</p><p>+</p><p>+* create n | delete n - 添加/删除DLCI编号为n的PVC接口。</p><p>+ 新创建的接口将命名为pvc0、pvc1等。</p><p>+</p><p>+* create ether n | delete ether n - 添加/删除用于以太网</p><p>+ 桥接帧的设备设备将命名为pvceth0、pvceth1等。</p><p>+</p><p>+</p><p>+</p><p>+</p><p>+板卡特定问题</p><p>+------------</p><p>+</p><p>+n2.o 和 c101.o 驱动模块需要参数才能工作::</p><p>+</p><p>+<span style="white-space:pre"> </span>insmod n2 hw=io,irq,ram,ports[:io,irq,...]</p><p>+</p><p>+示例::</p><p>+</p><p>+<span style="white-space:pre"> </span>insmod n2 hw=0x300,10,0xD0000,01</p><p>+</p><p>+或::</p><p>+</p><p>+<span style="white-space:pre"> </span>insmod c101 hw=irq,ram[:irq,...]</p><p>+</p><p>+示例::</p><p>+</p><p>+<span style="white-space:pre"> </span>insmod c101 hw=9,0xdc000</p><p>+</p><p>+若直接编译进内核,这些驱动需要通过内核(命令行)参数配置::</p><p>+</p><p>+<span style="white-space:pre"> </span>n2.hw=io,irq,ram,ports:...</p><p>+</p><p>+或::</p><p>+</p><p>+<span style="white-space:pre"> </span>c101.hw=irq,ram:...</p><p>+</p><p>+</p><p>+</p><p>+若您的N2、C101或PLX200SYN板卡出现问题,可通过"private"</p><p>+命令查看端口数据包描述符环(显示在内核日志中)</p><p>+</p><p>+<span style="white-space:pre"> </span>sethdlc hdlc0 private</p><p>+</p><p>+硬件驱动需使用#define DEBUG_RINGS编译选项构建。</p><p>+在提交错误报告时附上这些信息将很有帮助。如在使用过程中遇</p><p>+到任何问题,请随时告知。</p><p>+</p><p>+获取补丁和其他信息,请访问:</p><p>+<http://www.kernel.org/pub/linux/utils/net/hdlc/>.</p><p>\ No newline at end of file</p><p>diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst</p><p>index e03b5d5d39ee..e0494346fa8c 100644</p><p>--- a/Documentation/translations/zh_CN/networking/index.rst</p><p>+++ b/Documentation/translations/zh_CN/networking/index.rst</p><p>@@ -29,6 +29,7 @@</p><p> alias</p><p> mptcp-sysctl</p><p> skbuff</p><p>+ generic-hdlc</p><p> </p><p> Todolist:</p><p> </p><p>@@ -78,7 +79,6 @@ Todolist:</p><p> * eql</p><p> * fib_trie</p><p> * filter</p><p>-* generic-hdlc</p><p> * generic_netlink</p><p> * netlink_spec/index</p><p> * gen_stats</p><p>-- </p><p>2.25.1</p></div>
Powered by blists - more mailing lists