Skip to contentSkip to conversation

docs/zh_CN: add scsi.rst translation

PATCH In review haodongdong 2 participants 3 messages Jul 8, 2025 – Jul 15, 2025

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 2/7 docs/zh_CN: add scsi.rst translation

Translate .../scsi/scsi.rst into Chinese.
Add scsi into .../scsi/index.rst.

---
 .../translations/zh_CN/scsi/index.rst         | 95 +++++++++++++++++++
 .../translations/zh_CN/scsi/scsi.rst          | 48 ++++++++++
 2 files changed, 143 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/scsi/index.rst
 create mode 100644 Documentation/translations/zh_CN/scsi/scsi.rst
Documentation/translations/zh_CN/scsi/index.rst new file +95 -0
new file mode 100644
index 000000000000..4e9577f2c9c6
@@ -0,0 +1,95 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/scsi/index.rst
+
+:翻译:
+
+ 郝栋栋 Dongdong Hao <[email protected]>
+
+:校译:
+
+
+
+==========
+SCSI子系统
+==========
+
+.. toctree::
+   :maxdepth: 1
+
+简介
+====
+
+.. toctree::
+   :maxdepth: 1
+
+   scsi
+
+SCSI驱动接口
+============
+
+.. toctree::
+   :maxdepth: 1
+
+Todolist:
+
+* scsi_mid_low_api
+* scsi_eh
+
+SCSI驱动参数
+============
+
+.. toctree::
+   :maxdepth: 1
+
+Todolist:
+
+* scsi-parameters
+* link_power_management_policy
+
+SCSI主机适配器驱动
+==================
+
+.. toctree::
+   :maxdepth: 1
+
+Todolist:
+
+* sd-parameters
+* 53c700
+* aacraid
+* advansys
+* aha152x
+* aic79xx
+* aic7xxx
+* arcmsr_spec
+* bfa
+* bnx2fc
+* BusLogic
+* cxgb3i
+* dc395x
+* dpti
+* FlashPoint
+* g_NCR5380
+* hpsa
+* hptiop
+* libsas
+* lpfc
+* megaraid
+* ncr53c8xx
+* NinjaSCSI
+* ppa
+* qlogicfas
+* scsi-changer
+* scsi_fc_transport
+* scsi-generic
+* smartpqi
+* st
+* sym53c500_cs
+* sym53c8xx_2
+* tcm_qla2xxx
+* ufs
+* wd719x
+
+* scsi_transport_srp/figures
Documentation/translations/zh_CN/scsi/scsi.rst new file +48 -0

49 lines not on this page · raw message

Signature · 1 line
2.25.1
maintainer
#1 lore raw
Quoted 102 lines · haodongdong

Translate .../scsi/scsi.rst into Chinese.
Add scsi into .../scsi/index.rst.

---
  .../translations/zh_CN/scsi/index.rst         | 95 +++++++++++++++++++
  .../translations/zh_CN/scsi/scsi.rst          | 48 ++++++++++
  2 files changed, 143 insertions(+)

create mode 100644 Documentation/translations/zh_CN/scsi/index.rst create mode 100644 Documentation/translations/zh_CN/scsi/scsi.rst

Documentation/translations/zh_CN/scsi/index.rst new file +85 -0
new file mode 100644
index 000000000000..4e9577f2c9c6
@@ -0,0 +1,95 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/scsi/index.rst
+
+:翻译:
+
+ 郝栋栋 Dongdong Hao <[email protected]>
+
+:校译:
+
+
+
+==========
+SCSI子系统
+==========
+
+.. toctree::
+   :maxdepth: 1
+
+简介
+====
+
+.. toctree::
+   :maxdepth: 1
+
+   scsi
+
+SCSI驱动接口
+============
+
+.. toctree::
+   :maxdepth: 1
+
+Todolist:
+
+* scsi_mid_low_api
+* scsi_eh
+
+SCSI驱动参数
+============
+
+.. toctree::
+   :maxdepth: 1
+
+Todolist:
+
+* scsi-parameters
+* link_power_management_policy
+
+SCSI主机适配器驱动
+==================
+
+.. toctree::
+   :maxdepth: 1
+
+Todolist:
+
+* sd-parameters
+* 53c700
+* aacraid
+* advansys
+* aha152x
+* aic79xx
+* aic7xxx
+* arcmsr_spec
+* bfa
+* bnx2fc
+* BusLogic
+* cxgb3i
+* dc395x
+* dpti
+* FlashPoint
+* g_NCR5380
+* hpsa
+* hptiop
+* libsas
+* lpfc
+* megaraid
+* ncr53c8xx
+* NinjaSCSI
+* ppa
+* qlogicfas
+* scsi-changer
+* scsi_fc_transport

Documentation/translations/zh_CN/scsi/index.rst line 95

Quoted 10 lines
Documentation/translations/zh_CN/scsi/index.rst new file +10 -0
+* scsi-generic
+* smartpqi
+* st
+* sym53c500_cs
+* sym53c8xx_2
+* tcm_qla2xxx
+* ufs
+* wd719x
+
+* scsi_transport_srp/figures

I think you can merge this part with the first patch to serve as the first patch. Of course, you need to move "scsi" to the todolist.

Quoted 45 lines
Documentation/translations/zh_CN/scsi/scsi.rst new file +39 -0
new file mode 100644
index 000000000000..874ad34ae8aa
@@ -0,0 +1,48 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/scsi/scsi.rst
+
+:翻译:
+
+ 郝栋栋 Dongdong Hao <[email protected]>
+
+:校译:
+
+
+
+==============
+SCSI子系统文档
+==============
+
+Linux文档项目(LDP)维护了一份描述Linux内核(lk) 2.4中SCSI
+子系统的文档。请参考:
+https://www.tldp.org/HOWTO/SCSI-2.4-HOWTO 。LDP提供单页和
+多页的HTML版本,以及PostScript与PDF格式的文档。
+
+在SCSI子系统中使用模块的注意事项
+================================
+Linux内核中的SCSI支持可以根据终端用户的需求以不同的方式模块
+化。为了理解你的选择,我们首先需要定义一些术语。
+
+scsi-core(也被称为“中间层”)包含SCSI支持的核心。没有他你将
+无法使用任何其他SCSI驱动程序。SCSI核心支持可以是一个模块(
+scsi_mod.o),也可以编译进内核。如果SCSI核心是一个模块,那么
+他必须是第一个被加载的SCSI模块,如果你将卸载该模块,那么他必
+须是最后一个被卸载的模块。实际上,modprobe和rmmod命令将确保
+SCSI子系统中模块加载与卸载的正确顺序。
+
+一旦SCSI核心存在于内核中(无论是编译进内核还是作为模块加载),
+独立的上层驱动和底层驱动可以按照任意顺序加载。磁盘驱动程序
+(sd_mod.o)、光盘驱动程序(sr_mod.o)、磁带驱动程序 [1]_
+(st.o)以及SCSI通用驱动程序(sg.o)代表了上层驱动,用于控制
+相应的各种设备。例如,你可以加载磁带驱动程序来使用磁带驱动器,

Documentation/translations/zh_CN/scsi/scsi.rst line 48

Quoted 10 lines
Documentation/translations/zh_CN/scsi/scsi.rst new file +9 -0
+然后在不需要该驱动程序时卸载他(并释放相关内存)。
+
+底层驱动程序用于支持您所运行硬件平台支持的不同主机卡。这些不同
+的主机卡通常被称为主机总线适配器(HBAs)。例如,aic7xxx.o驱动
+程序被用于控制Adaptec所属的所有最新的SCSI控制器。几乎所有的底
+层驱动都可以被编译为模块或直接编译进内核。
+
+.. [1] 磁带驱动程序有一个变种用于控制OnStream磁带设备。其模块
+	   名称为osst.o 。
\ No newline at end of file

need a blackline.

Thanks,

Yanteng

author
#2 lore raw
Quoted 338 lines

From: "Yanteng Si"<[email protected]>
Date:  Wed, Jul 9, 2025, 09:39
Subject:  Re: [PATCH 2/7] docs/zh_CN: add scsi.rst translation
To: "haodongdong"<[email protected]>, <[email protected]>
Cc: <[email protected]>, <[email protected]>, <[email protected]>

Quoted 213 lines · haodongdong

Translate .../scsi/scsi.rst into Chinese.

Add scsi into .../scsi/index.rst.

---

  .../translations/zh_CN/scsi/index.rst         | 95 +++++++++++++++++++

  .../translations/zh_CN/scsi/scsi.rst          | 48 ++++++++++

  2 files changed, 143 insertions(+)

  create mode 100644 Documentation/translations/zh_CN/scsi/index.rst

  create mode 100644 Documentation/translations/zh_CN/scsi/scsi.rst

Documentation/translations/zh_CN/scsi/index.rst +0 -0

new file mode 100644

index 000000000000..4e9577f2c9c6

--- /dev/null

+++ b/Documentation/translations/zh_CN/scsi/index.rst

Documentation/translations/zh_CN/scsi/index.rst +90 -0
@@ -0,0 +1,95 @@
 
+.. SPDX-License-Identifier: GPL-2.0
 
+.. include:: ../disclaimer-zh_CN.rst
 
+
 
+:Original: Documentation/scsi/index.rst
 
+
 
+:翻译:
 
+
 
+ 郝栋栋 Dongdong Hao <[email protected]>
 
+
 
+:校译:
 
+
 
+
 
+
 
+==========
 
+SCSI子系统
 
+==========
 
+
 
+.. toctree::
 
+   :maxdepth: 1
 
+
 
+简介
 
+====
 
+
 
+.. toctree::
 
+   :maxdepth: 1
 
+
 
+   scsi
 
+
 
+SCSI驱动接口
 
+============
 
+
 
+.. toctree::
 
+   :maxdepth: 1
 
+
 
+Todolist:
 
+
 
+* scsi_mid_low_api
 
+* scsi_eh
 
+
 
+SCSI驱动参数
 
+============
 
+
 
+.. toctree::
 
+   :maxdepth: 1
 
+
 
+Todolist:
 
+
 
+* scsi-parameters
 
+* link_power_management_policy
 
+
 
+SCSI主机适配器驱动
 
+==================
 
+
 
+.. toctree::
 
+   :maxdepth: 1
 
+
 
+Todolist:
 
+
 
+* sd-parameters
 
+* 53c700
 
+* aacraid
 
+* advansys
 
+* aha152x
 
+* aic79xx
 
+* aic7xxx
 
+* arcmsr_spec
 
+* bfa
 
+* bnx2fc
 
+* BusLogic
 
+* cxgb3i
 
+* dc395x
 
+* dpti
 
+* FlashPoint
 
+* g_NCR5380
 
+* hpsa
 
+* hptiop
 
+* libsas
 
+* lpfc
 
+* megaraid
 
+* ncr53c8xx
 
+* NinjaSCSI
 
+* ppa
 
+* qlogicfas
 
+* scsi-changer
 
+* scsi_fc_transport
 
+* scsi-generic
 
+* smartpqi
 
+* st
 
+* sym53c500_cs
 
+* sym53c8xx_2

Documentation/translations/zh_CN/scsi/index.rst line 95

Quoted 10 lines
Documentation/translations/zh_CN/scsi/index.rst +5 -0
 
+* tcm_qla2xxx
 
+* ufs
 
+* wd719x
 
+
 
+* scsi_transport_srp/figures

I think you can merge this part with the first patch to serve as the first patch. Of course, you need to move "scsi" to the todolist.

Quoted 103 lines
Documentation/translations/zh_CN/scsi/scsi.rst +0 -0

new file mode 100644

index 000000000000..874ad34ae8aa

--- /dev/null

+++ b/Documentation/translations/zh_CN/scsi/scsi.rst

Documentation/translations/zh_CN/scsi/scsi.rst +46 -0
@@ -0,0 +1,48 @@
 
+.. SPDX-License-Identifier: GPL-2.0
 
+.. include:: ../disclaimer-zh_CN.rst
 
+
 
+:Original: Documentation/scsi/scsi.rst
 
+
 
+:翻译:
 
+
 
+ 郝栋栋 Dongdong Hao <[email protected]>
 
+
 
+:校译:
 
+
 
+
 
+
 
+==============
 
+SCSI子系统文档
 
+==============
 
+
 
+Linux文档项目(LDP)维护了一份描述Linux内核(lk) 2.4中SCSI
 
+子系统的文档。请参考:
 
+https://www.tldp.org/HOWTO/SCSI-2.4-HOWTO 。LDP提供单页和
 
+多页的HTML版本,以及PostScript与PDF格式的文档。
 
+
 
+在SCSI子系统中使用模块的注意事项
 
+================================
 
+Linux内核中的SCSI支持可以根据终端用户的需求以不同的方式模块
 
+化。为了理解你的选择,我们首先需要定义一些术语。
 
+
 
+scsi-core(也被称为“中间层”)包含SCSI支持的核心。没有他你将
 
+无法使用任何其他SCSI驱动程序。SCSI核心支持可以是一个模块(
 
+scsi_mod.o),也可以编译进内核。如果SCSI核心是一个模块,那么
 
+他必须是第一个被加载的SCSI模块,如果你将卸载该模块,那么他必
 
+须是最后一个被卸载的模块。实际上,modprobe和rmmod命令将确保
 
+SCSI子系统中模块加载与卸载的正确顺序。
 
+
 
+一旦SCSI核心存在于内核中(无论是编译进内核还是作为模块加载),
 
+独立的上层驱动和底层驱动可以按照任意顺序加载。磁盘驱动程序
 
+(sd_mod.o)、光盘驱动程序(sr_mod.o)、磁带驱动程序 [1]_
 
+(st.o)以及SCSI通用驱动程序(sg.o)代表了上层驱动,用于控制
 
+相应的各种设备。例如,你可以加载磁带驱动程序来使用磁带驱动器,
 
+然后在不需要该驱动程序时卸载他(并释放相关内存)。
 
+
 
+底层驱动程序用于支持您所运行硬件平台支持的不同主机卡。这些不同
 
+的主机卡通常被称为主机总线适配器(HBAs)。例如,aic7xxx.o驱动
 
+程序被用于控制Adaptec所属的所有最新的SCSI控制器。几乎所有的底
 
+层驱动都可以被编译为模块或直接编译进内核。
 
+
Quoted 8 lines
Quoted 5 lines

+.. [1] 磁带驱动程序有一个变种用于控制OnStream磁带设备。其模块

+           名称为osst.o 。

\ No newline at end of file


need a blackline.

Thank you for pointing this out. I’ve added the missing newline at EOF in v3.

Quoted 7 lines



Thanks,


Yanteng

Best regards,
Dongdong Hao