* [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese
@ 2025-06-16 6:51 shao.mingyin
0 siblings, 0 replies; 6+ messages in thread
From: shao.mingyin @ 2025-06-16 6:51 UTC (permalink / raw)
To: alexs
Cc: si.yanteng, dzm91, corbet, linux-doc, linux-kernel, yang.yang29,
xu.xin16, yang.tao172, ye.xingchen, wang.yaxin
From: Shao Mingyin <shao.mingyin@zte.com.cn>
translate the "ubifs.rst" into Simplified Chinese.
Update to commit 5f5cae9b0e81("Documentation: ubifs: Fix
compression idiom")
Signed-off-by: Shao Mingyin <shao.mingyin@zte.com.cn>
Signed-off-by: yang tao <yang.tao172@zte.com.cn>
---
.../translations/zh_CN/filesystems/index.rst | 1 +
.../translations/zh_CN/filesystems/ubifs.rst | 111 ++++++++++++++++++
2 files changed, 112 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/ubifs.rst
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
index 9f2a8b003778..faaa0f097223 100644
--- a/Documentation/translations/zh_CN/filesystems/index.rst
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -26,4 +26,5 @@ Linux Kernel中的文件系统
virtiofs
debugfs
tmpfs
+ ubifs
diff --git a/Documentation/translations/zh_CN/filesystems/ubifs.rst b/Documentation/translations/zh_CN/filesystems/ubifs.rst
new file mode 100644
index 000000000000..27997777f4ea
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/ubifs.rst
@@ -0,0 +1,111 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/filesystems/ubifs.rst
+
+:翻译:
+
+ 邵明寅 Shao Mingyin <shao.mingyin@zte.com.cn>
+
+:校译:
+
+ - 杨涛 yang tao <yang.tao172@zte.com.cn>
+
+===============
+UBI 文件系统
+===============
+
+简介
+============
+
+UBIFS 文件系统全称为 UBI 文件系统(UBI File System)。UBI 代表无序块镜像(Unsorted
+Block Images)。UBIFS 是一种闪存文件系统,这意味着它专为闪存设备设计。需要理解的是,UBIFS
+与 Linux 中任何传统文件系统(如 Ext2、XFS、JFS 等)完全不同。UBIFS 代表一类特殊的文件系统,
+它们工作在 MTD 设备而非块设备上。该类别的另一个 Linux 文件系统是 JFFS2。
+
+为更清晰说明,以下是 MTD 设备与块设备的简要比较:
+
+1. MTD 设备代表闪存设备,由较大尺寸的擦除块组成,通常约 128KiB。块设备由小块组成,通常 512
+ 字节。
+2. MTD 设备支持 3 种主要操作:在擦除块内偏移位置读取、在擦除块内偏移位置写入、以及擦除整个擦除
+ 块。块设备支持 2 种主要操作:读取整个块和写入整个块。
+3. 整个擦除块必须先擦除才能重写内容。块可直接重写。
+4. 擦除块在经历一定次数的擦写周期后会磨损,通常 SLC NAND 和 NOR 闪存为 100K-1G 次,MLC
+ NAND 闪存为 1K-10K 次。块设备不具备磨损特性。
+5. 擦除块可能损坏(仅限 NAND 闪存),软件需处理此问题。硬盘上的块通常不会损坏,因为硬件有坏块
+ 替换机制(至少现代 LBA 硬盘如此)。
+
+这充分说明了 UBIFS 与传统文件系统的本质差异。
+
+UBIFS 工作在 UBI 层之上。UBI 是一个独立的软件层(位于 drivers/mtd/ubi),本质上是卷管理和
+磨损均衡层。它提供称为 UBI 卷的高级抽象,比 MTD 设备更上层。UBI 设备的编程模型与 MTD 设备非
+常相似,仍由大容量擦除块组成,支持读/写/擦除操作,但 UBI 设备消除了磨损和坏块限制(上述列表的第
+4 和第 5 项)。
+
+某种意义上,UBIFS 是 JFFS2 文件系统的下一代产品,但它与 JFFS2 差异巨大且不兼容。主要区别如下:
+
+* JFFS2 工作在 MTD 设备之上,UBIFS 依赖于 UBI 并工作在 UBI 卷之上。
+* JFFS2 没有介质索引,需在挂载时构建索引,这要求全介质扫描。UBIFS 在闪存介质上维护文件系统索引
+ 信息,无需全介质扫描,因此挂载速度远快于 JFFS2。
+* JFFS2 是直写(write-through)文件系统,而 UBIFS 支持回写(write-back),这使得 UBIFS
+ 写入速度快得多。
+
+与 JFFS2 类似,UBIFS 支持实时压缩,可将大量数据存入闪存。
+
+与 JFFS2 类似,UBIFS 能容忍异常重启和断电。它不需要类似 fsck.ext2 的工具。UBIFS 会自动重放日
+志并从崩溃中恢复,确保闪存数据结构的一致性。
+
+UBIFS 具有对数级扩展性(其使用的数据结构多为树形),因此挂载时间和内存消耗不像 JFFS2 那样线性依
+赖于闪存容量。这是因为 UBIFS 在闪存介质上维护文件系统索引。但 UBIFS 依赖于线性扩展的 UBI 层,
+因此整体 UBI/UBIFS 栈仍是线性扩展。尽管如此,UBIFS/UBI 的扩展性仍显著优于 JFFS2。
+
+UBIFS 开发者认为,未来可开发同样具备对数级扩展性的 UBI2。UBI2 将支持与 UBI 相同的 API,但二进
+制不兼容。因此 UBIFS 无需修改即可使用 UBI2。
+
+挂载选项
+=============
+
+(*) 表示默认选项。
+
+==================== =======================================================
+bulk_read 批量读取以利用闪存介质的顺序读取加速特性
+no_bulk_read (*) 禁用批量读取
+no_chk_data_crc (*) 跳过数据节点的 CRC 校验以提高读取性能。 仅在闪存
+ 介质高度可靠时使用此选项。 此选项可能导致文件内容损坏无法被
+ 察觉。
+chk_data_crc 强制校验数据节点的 CRC
+compr=none 覆盖默认压缩器,设置为"none"
+compr=lzo 覆盖默认压缩器,设置为"LZO"
+compr=zlib 覆盖默认压缩器,设置为"zlib"
+auth_key= 指定用于文件系统身份验证的密钥。
+ 使用此选项将强制启用身份验证。
+ 传入的密钥必须存在于内核密钥环中, 且类型必须是'logon'
+auth_hash_name= 用于身份验证的哈希算法。同时用于哈希计算和 HMAC
+ 生成。典型值包括"sha256"或"sha512"
+==================== =======================================================
+
+快速使用指南
+========================
+
+挂载的 UBI 卷通过 "ubiX_Y" 或 "ubiX:NAME" 语法指定,其中 "X" 是 UBI 设备编号,"Y" 是 UBI
+卷编号,"NAME" 是 UBI 卷名称。
+
+将 UBI 设备 0 的卷 0 挂载到 /mnt/ubifs::
+
+ $ mount -t ubifs ubi0_0 /mnt/ubifs
+
+将 UBI 设备 0 的 "rootfs" 卷挂载到 /mnt/ubifs("rootfs" 是卷名)::
+
+ $ mount -t ubifs ubi0:rootfs /mnt/ubifs
+
+以下是内核启动参数的示例,用于将 mtd0 附加到 UBI 并挂载 "rootfs" 卷:
+ubi.mtd=0 root=ubi0:rootfs rootfstype=ubifs
+
+参考资料
+==========
+
+UBIFS 文档及常见问题解答/操作指南请访问 MTD 官网:
+
+- http://www.linux-mtd.infradead.org/doc/ubifs.html
+- http://www.linux-mtd.infradead.org/faq/ubifs.html
--
2.25.1
^ permalink raw reply related [flat|nested] 6+ messages in thread
* [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese
@ 2025-07-15 7:15 shao.mingyin
2025-07-17 1:40 ` Alex Shi
0 siblings, 1 reply; 6+ messages in thread
From: shao.mingyin @ 2025-07-15 7:15 UTC (permalink / raw)
To: alexs
Cc: si.yanteng, dzm91, corbet, linux-doc, linux-kernel, yang.yang29,
xu.xin16, yang.tao172, ye.xingchen, wang.yaxin
From: Shao Mingyin <shao.mingyin@zte.com.cn>
translate the "ubifs.rst" into Simplified Chinese.
Update to commit 5f5cae9b0e81("Documentation: ubifs: Fix
compression idiom")
Signed-off-by: Shao Mingyin <shao.mingyin@zte.com.cn>
Signed-off-by: yang tao <yang.tao172@zte.com.cn>
---
.../translations/zh_CN/filesystems/index.rst | 1 +
.../translations/zh_CN/filesystems/ubifs.rst | 111 ++++++++++++++++++
2 files changed, 112 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/ubifs.rst
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
index 9f2a8b003778..faaa0f097223 100644
--- a/Documentation/translations/zh_CN/filesystems/index.rst
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -26,4 +26,5 @@ Linux Kernel中的文件系统
virtiofs
debugfs
tmpfs
+ ubifs
diff --git a/Documentation/translations/zh_CN/filesystems/ubifs.rst b/Documentation/translations/zh_CN/filesystems/ubifs.rst
new file mode 100644
index 000000000000..27997777f4ea
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/ubifs.rst
@@ -0,0 +1,111 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/filesystems/ubifs.rst
+
+:翻译:
+
+ 邵明寅 Shao Mingyin <shao.mingyin@zte.com.cn>
+
+:校译:
+
+ - 杨涛 yang tao <yang.tao172@zte.com.cn>
+
+===============
+UBI 文件系统
+===============
+
+简介
+============
+
+UBIFS 文件系统全称为 UBI 文件系统(UBI File System)。UBI 代表无序块镜像(Unsorted
+Block Images)。UBIFS 是一种闪存文件系统,这意味着它专为闪存设备设计。需要理解的是,UBIFS
+与 Linux 中任何传统文件系统(如 Ext2、XFS、JFS 等)完全不同。UBIFS 代表一类特殊的文件系统,
+它们工作在 MTD 设备而非块设备上。该类别的另一个 Linux 文件系统是 JFFS2。
+
+为更清晰说明,以下是 MTD 设备与块设备的简要比较:
+
+1. MTD 设备代表闪存设备,由较大尺寸的擦除块组成,通常约 128KiB。块设备由小块组成,通常 512
+ 字节。
+2. MTD 设备支持 3 种主要操作:在擦除块内偏移位置读取、在擦除块内偏移位置写入、以及擦除整个擦除
+ 块。块设备支持 2 种主要操作:读取整个块和写入整个块。
+3. 整个擦除块必须先擦除才能重写内容。块可直接重写。
+4. 擦除块在经历一定次数的擦写周期后会磨损,通常 SLC NAND 和 NOR 闪存为 100K-1G 次,MLC
+ NAND 闪存为 1K-10K 次。块设备不具备磨损特性。
+5. 擦除块可能损坏(仅限 NAND 闪存),软件需处理此问题。硬盘上的块通常不会损坏,因为硬件有坏块
+ 替换机制(至少现代 LBA 硬盘如此)。
+
+这充分说明了 UBIFS 与传统文件系统的本质差异。
+
+UBIFS 工作在 UBI 层之上。UBI 是一个独立的软件层(位于 drivers/mtd/ubi),本质上是卷管理和
+磨损均衡层。它提供称为 UBI 卷的高级抽象,比 MTD 设备更上层。UBI 设备的编程模型与 MTD 设备非
+常相似,仍由大容量擦除块组成,支持读/写/擦除操作,但 UBI 设备消除了磨损和坏块限制(上述列表的第
+4 和第 5 项)。
+
+某种意义上,UBIFS 是 JFFS2 文件系统的下一代产品,但它与 JFFS2 差异巨大且不兼容。主要区别如下:
+
+* JFFS2 工作在 MTD 设备之上,UBIFS 依赖于 UBI 并工作在 UBI 卷之上。
+* JFFS2 没有介质索引,需在挂载时构建索引,这要求全介质扫描。UBIFS 在闪存介质上维护文件系统索引
+ 信息,无需全介质扫描,因此挂载速度远快于 JFFS2。
+* JFFS2 是直写(write-through)文件系统,而 UBIFS 支持回写(write-back),这使得 UBIFS
+ 写入速度快得多。
+
+与 JFFS2 类似,UBIFS 支持实时压缩,可将大量数据存入闪存。
+
+与 JFFS2 类似,UBIFS 能容忍异常重启和断电。它不需要类似 fsck.ext2 的工具。UBIFS 会自动重放日
+志并从崩溃中恢复,确保闪存数据结构的一致性。
+
+UBIFS 具有对数级扩展性(其使用的数据结构多为树形),因此挂载时间和内存消耗不像 JFFS2 那样线性依
+赖于闪存容量。这是因为 UBIFS 在闪存介质上维护文件系统索引。但 UBIFS 依赖于线性扩展的 UBI 层,
+因此整体 UBI/UBIFS 栈仍是线性扩展。尽管如此,UBIFS/UBI 的扩展性仍显著优于 JFFS2。
+
+UBIFS 开发者认为,未来可开发同样具备对数级扩展性的 UBI2。UBI2 将支持与 UBI 相同的 API,但二进
+制不兼容。因此 UBIFS 无需修改即可使用 UBI2。
+
+挂载选项
+=============
+
+(*) 表示默认选项。
+
+==================== =======================================================
+bulk_read 批量读取以利用闪存介质的顺序读取加速特性
+no_bulk_read (*) 禁用批量读取
+no_chk_data_crc (*) 跳过数据节点的 CRC 校验以提高读取性能。 仅在闪存
+ 介质高度可靠时使用此选项。 此选项可能导致文件内容损坏无法被
+ 察觉。
+chk_data_crc 强制校验数据节点的 CRC
+compr=none 覆盖默认压缩器,设置为"none"
+compr=lzo 覆盖默认压缩器,设置为"LZO"
+compr=zlib 覆盖默认压缩器,设置为"zlib"
+auth_key= 指定用于文件系统身份验证的密钥。
+ 使用此选项将强制启用身份验证。
+ 传入的密钥必须存在于内核密钥环中, 且类型必须是'logon'
+auth_hash_name= 用于身份验证的哈希算法。同时用于哈希计算和 HMAC
+ 生成。典型值包括"sha256"或"sha512"
+==================== =======================================================
+
+快速使用指南
+========================
+
+挂载的 UBI 卷通过 "ubiX_Y" 或 "ubiX:NAME" 语法指定,其中 "X" 是 UBI 设备编号,"Y" 是 UBI
+卷编号,"NAME" 是 UBI 卷名称。
+
+将 UBI 设备 0 的卷 0 挂载到 /mnt/ubifs::
+
+ $ mount -t ubifs ubi0_0 /mnt/ubifs
+
+将 UBI 设备 0 的 "rootfs" 卷挂载到 /mnt/ubifs("rootfs" 是卷名)::
+
+ $ mount -t ubifs ubi0:rootfs /mnt/ubifs
+
+以下是内核启动参数的示例,用于将 mtd0 附加到 UBI 并挂载 "rootfs" 卷:
+ubi.mtd=0 root=ubi0:rootfs rootfstype=ubifs
+
+参考资料
+==========
+
+UBIFS 文档及常见问题解答/操作指南请访问 MTD 官网:
+
+- http://www.linux-mtd.infradead.org/doc/ubifs.html
+- http://www.linux-mtd.infradead.org/faq/ubifs.html
--
2.25.1
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese
2025-07-15 7:15 [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese shao.mingyin
@ 2025-07-17 1:40 ` Alex Shi
2025-07-17 2:26 ` Dongliang Mu
0 siblings, 1 reply; 6+ messages in thread
From: Alex Shi @ 2025-07-17 1:40 UTC (permalink / raw)
To: shao.mingyin
Cc: alexs, si.yanteng, dzm91, corbet, linux-doc, linux-kernel,
yang.yang29, xu.xin16, yang.tao172, ye.xingchen, wang.yaxin
These 2 patches could be sent out as a patchset.
Thanks
<shao.mingyin@zte.com.cn> 于2025年7月15日周二 15:15写道:
>
> From: Shao Mingyin <shao.mingyin@zte.com.cn>
>
> translate the "ubifs.rst" into Simplified Chinese.
>
> Update to commit 5f5cae9b0e81("Documentation: ubifs: Fix
> compression idiom")
>
> Signed-off-by: Shao Mingyin <shao.mingyin@zte.com.cn>
> Signed-off-by: yang tao <yang.tao172@zte.com.cn>
> ---
> .../translations/zh_CN/filesystems/index.rst | 1 +
> .../translations/zh_CN/filesystems/ubifs.rst | 111 ++++++++++++++++++
> 2 files changed, 112 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/ubifs.rst
>
> diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> index 9f2a8b003778..faaa0f097223 100644
> --- a/Documentation/translations/zh_CN/filesystems/index.rst
> +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> @@ -26,4 +26,5 @@ Linux Kernel中的文件系统
> virtiofs
> debugfs
> tmpfs
> + ubifs
>
> diff --git a/Documentation/translations/zh_CN/filesystems/ubifs.rst b/Documentation/translations/zh_CN/filesystems/ubifs.rst
> new file mode 100644
> index 000000000000..27997777f4ea
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/ubifs.rst
> @@ -0,0 +1,111 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/filesystems/ubifs.rst
> +
> +:翻译:
> +
> + 邵明寅 Shao Mingyin <shao.mingyin@zte.com.cn>
> +
> +:校译:
> +
> + - 杨涛 yang tao <yang.tao172@zte.com.cn>
> +
> +===============
> +UBI 文件系统
> +===============
> +
> +简介
> +============
> +
> +UBIFS 文件系统全称为 UBI 文件系统(UBI File System)。UBI 代表无序块镜像(Unsorted
> +Block Images)。UBIFS 是一种闪存文件系统,这意味着它专为闪存设备设计。需要理解的是,UBIFS
> +与 Linux 中任何传统文件系统(如 Ext2、XFS、JFS 等)完全不同。UBIFS 代表一类特殊的文件系统,
> +它们工作在 MTD 设备而非块设备上。该类别的另一个 Linux 文件系统是 JFFS2。
> +
> +为更清晰说明,以下是 MTD 设备与块设备的简要比较:
> +
> +1. MTD 设备代表闪存设备,由较大尺寸的擦除块组成,通常约 128KiB。块设备由小块组成,通常 512
> + 字节。
> +2. MTD 设备支持 3 种主要操作:在擦除块内偏移位置读取、在擦除块内偏移位置写入、以及擦除整个擦除
> + 块。块设备支持 2 种主要操作:读取整个块和写入整个块。
> +3. 整个擦除块必须先擦除才能重写内容。块可直接重写。
> +4. 擦除块在经历一定次数的擦写周期后会磨损,通常 SLC NAND 和 NOR 闪存为 100K-1G 次,MLC
> + NAND 闪存为 1K-10K 次。块设备不具备磨损特性。
> +5. 擦除块可能损坏(仅限 NAND 闪存),软件需处理此问题。硬盘上的块通常不会损坏,因为硬件有坏块
> + 替换机制(至少现代 LBA 硬盘如此)。
> +
> +这充分说明了 UBIFS 与传统文件系统的本质差异。
> +
> +UBIFS 工作在 UBI 层之上。UBI 是一个独立的软件层(位于 drivers/mtd/ubi),本质上是卷管理和
> +磨损均衡层。它提供称为 UBI 卷的高级抽象,比 MTD 设备更上层。UBI 设备的编程模型与 MTD 设备非
> +常相似,仍由大容量擦除块组成,支持读/写/擦除操作,但 UBI 设备消除了磨损和坏块限制(上述列表的第
> +4 和第 5 项)。
> +
> +某种意义上,UBIFS 是 JFFS2 文件系统的下一代产品,但它与 JFFS2 差异巨大且不兼容。主要区别如下:
> +
> +* JFFS2 工作在 MTD 设备之上,UBIFS 依赖于 UBI 并工作在 UBI 卷之上。
> +* JFFS2 没有介质索引,需在挂载时构建索引,这要求全介质扫描。UBIFS 在闪存介质上维护文件系统索引
> + 信息,无需全介质扫描,因此挂载速度远快于 JFFS2。
> +* JFFS2 是直写(write-through)文件系统,而 UBIFS 支持回写(write-back),这使得 UBIFS
> + 写入速度快得多。
> +
> +与 JFFS2 类似,UBIFS 支持实时压缩,可将大量数据存入闪存。
> +
> +与 JFFS2 类似,UBIFS 能容忍异常重启和断电。它不需要类似 fsck.ext2 的工具。UBIFS 会自动重放日
> +志并从崩溃中恢复,确保闪存数据结构的一致性。
> +
> +UBIFS 具有对数级扩展性(其使用的数据结构多为树形),因此挂载时间和内存消耗不像 JFFS2 那样线性依
> +赖于闪存容量。这是因为 UBIFS 在闪存介质上维护文件系统索引。但 UBIFS 依赖于线性扩展的 UBI 层,
> +因此整体 UBI/UBIFS 栈仍是线性扩展。尽管如此,UBIFS/UBI 的扩展性仍显著优于 JFFS2。
> +
> +UBIFS 开发者认为,未来可开发同样具备对数级扩展性的 UBI2。UBI2 将支持与 UBI 相同的 API,但二进
> +制不兼容。因此 UBIFS 无需修改即可使用 UBI2。
> +
> +挂载选项
> +=============
> +
> +(*) 表示默认选项。
> +
> +==================== =======================================================
> +bulk_read 批量读取以利用闪存介质的顺序读取加速特性
> +no_bulk_read (*) 禁用批量读取
> +no_chk_data_crc (*) 跳过数据节点的 CRC 校验以提高读取性能。 仅在闪存
> + 介质高度可靠时使用此选项。 此选项可能导致文件内容损坏无法被
> + 察觉。
> +chk_data_crc 强制校验数据节点的 CRC
> +compr=none 覆盖默认压缩器,设置为"none"
> +compr=lzo 覆盖默认压缩器,设置为"LZO"
> +compr=zlib 覆盖默认压缩器,设置为"zlib"
> +auth_key= 指定用于文件系统身份验证的密钥。
> + 使用此选项将强制启用身份验证。
> + 传入的密钥必须存在于内核密钥环中, 且类型必须是'logon'
> +auth_hash_name= 用于身份验证的哈希算法。同时用于哈希计算和 HMAC
> + 生成。典型值包括"sha256"或"sha512"
> +==================== =======================================================
> +
> +快速使用指南
> +========================
> +
> +挂载的 UBI 卷通过 "ubiX_Y" 或 "ubiX:NAME" 语法指定,其中 "X" 是 UBI 设备编号,"Y" 是 UBI
> +卷编号,"NAME" 是 UBI 卷名称。
> +
> +将 UBI 设备 0 的卷 0 挂载到 /mnt/ubifs::
> +
> + $ mount -t ubifs ubi0_0 /mnt/ubifs
> +
> +将 UBI 设备 0 的 "rootfs" 卷挂载到 /mnt/ubifs("rootfs" 是卷名)::
> +
> + $ mount -t ubifs ubi0:rootfs /mnt/ubifs
> +
> +以下是内核启动参数的示例,用于将 mtd0 附加到 UBI 并挂载 "rootfs" 卷:
> +ubi.mtd=0 root=ubi0:rootfs rootfstype=ubifs
> +
> +参考资料
> +==========
> +
> +UBIFS 文档及常见问题解答/操作指南请访问 MTD 官网:
> +
> +- http://www.linux-mtd.infradead.org/doc/ubifs.html
> +- http://www.linux-mtd.infradead.org/faq/ubifs.html
> --
> 2.25.1
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese
2025-07-17 1:40 ` Alex Shi
@ 2025-07-17 2:26 ` Dongliang Mu
2025-07-17 3:16 ` shao.mingyin
0 siblings, 1 reply; 6+ messages in thread
From: Dongliang Mu @ 2025-07-17 2:26 UTC (permalink / raw)
To: Alex Shi
Cc: shao.mingyin, alexs, si.yanteng, dzm91, corbet, linux-doc,
linux-kernel, yang.yang29, xu.xin16, yang.tao172, ye.xingchen,
wang.yaxin
On Thu, Jul 17, 2025 at 9:41 AM Alex Shi <seakeel@gmail.com> wrote:
>
> These 2 patches could be sent out as a patchset.
>
I will explain this statement a little further. Since your two patches
both modify translations/zh_CN/filesystems/index.rst, they have their
own dependencies or orders.
In other words, this patch should be merged before the other one.
In this case, it's better to submit a patchset (patchset has internal
orders, patch 0/2, patch 1/2, patch 2/2) to reviewers and maintainers.
Dongliang Mu
> Thanks
>
> <shao.mingyin@zte.com.cn> 于2025年7月15日周二 15:15写道:
> >
> > From: Shao Mingyin <shao.mingyin@zte.com.cn>
> >
> > translate the "ubifs.rst" into Simplified Chinese.
> >
> > Update to commit 5f5cae9b0e81("Documentation: ubifs: Fix
> > compression idiom")
> >
> > Signed-off-by: Shao Mingyin <shao.mingyin@zte.com.cn>
> > Signed-off-by: yang tao <yang.tao172@zte.com.cn>
> > ---
> > .../translations/zh_CN/filesystems/index.rst | 1 +
> > .../translations/zh_CN/filesystems/ubifs.rst | 111 ++++++++++++++++++
> > 2 files changed, 112 insertions(+)
> > create mode 100644 Documentation/translations/zh_CN/filesystems/ubifs.rst
> >
> > diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> > index 9f2a8b003778..faaa0f097223 100644
> > --- a/Documentation/translations/zh_CN/filesystems/index.rst
> > +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> > @@ -26,4 +26,5 @@ Linux Kernel中的文件系统
> > virtiofs
> > debugfs
> > tmpfs
> > + ubifs
> >
> > diff --git a/Documentation/translations/zh_CN/filesystems/ubifs.rst b/Documentation/translations/zh_CN/filesystems/ubifs.rst
> > new file mode 100644
> > index 000000000000..27997777f4ea
> > --- /dev/null
> > +++ b/Documentation/translations/zh_CN/filesystems/ubifs.rst
> > @@ -0,0 +1,111 @@
> > +.. SPDX-License-Identifier: GPL-2.0
> > +
> > +.. include:: ../disclaimer-zh_CN.rst
> > +
> > +:Original: Documentation/filesystems/ubifs.rst
> > +
> > +:翻译:
> > +
> > + 邵明寅 Shao Mingyin <shao.mingyin@zte.com.cn>
> > +
> > +:校译:
> > +
> > + - 杨涛 yang tao <yang.tao172@zte.com.cn>
> > +
> > +===============
> > +UBI 文件系统
> > +===============
> > +
> > +简介
> > +============
> > +
> > +UBIFS 文件系统全称为 UBI 文件系统(UBI File System)。UBI 代表无序块镜像(Unsorted
> > +Block Images)。UBIFS 是一种闪存文件系统,这意味着它专为闪存设备设计。需要理解的是,UBIFS
> > +与 Linux 中任何传统文件系统(如 Ext2、XFS、JFS 等)完全不同。UBIFS 代表一类特殊的文件系统,
> > +它们工作在 MTD 设备而非块设备上。该类别的另一个 Linux 文件系统是 JFFS2。
> > +
> > +为更清晰说明,以下是 MTD 设备与块设备的简要比较:
> > +
> > +1. MTD 设备代表闪存设备,由较大尺寸的擦除块组成,通常约 128KiB。块设备由小块组成,通常 512
> > + 字节。
> > +2. MTD 设备支持 3 种主要操作:在擦除块内偏移位置读取、在擦除块内偏移位置写入、以及擦除整个擦除
> > + 块。块设备支持 2 种主要操作:读取整个块和写入整个块。
> > +3. 整个擦除块必须先擦除才能重写内容。块可直接重写。
> > +4. 擦除块在经历一定次数的擦写周期后会磨损,通常 SLC NAND 和 NOR 闪存为 100K-1G 次,MLC
> > + NAND 闪存为 1K-10K 次。块设备不具备磨损特性。
> > +5. 擦除块可能损坏(仅限 NAND 闪存),软件需处理此问题。硬盘上的块通常不会损坏,因为硬件有坏块
> > + 替换机制(至少现代 LBA 硬盘如此)。
> > +
> > +这充分说明了 UBIFS 与传统文件系统的本质差异。
> > +
> > +UBIFS 工作在 UBI 层之上。UBI 是一个独立的软件层(位于 drivers/mtd/ubi),本质上是卷管理和
> > +磨损均衡层。它提供称为 UBI 卷的高级抽象,比 MTD 设备更上层。UBI 设备的编程模型与 MTD 设备非
> > +常相似,仍由大容量擦除块组成,支持读/写/擦除操作,但 UBI 设备消除了磨损和坏块限制(上述列表的第
> > +4 和第 5 项)。
> > +
> > +某种意义上,UBIFS 是 JFFS2 文件系统的下一代产品,但它与 JFFS2 差异巨大且不兼容。主要区别如下:
> > +
> > +* JFFS2 工作在 MTD 设备之上,UBIFS 依赖于 UBI 并工作在 UBI 卷之上。
> > +* JFFS2 没有介质索引,需在挂载时构建索引,这要求全介质扫描。UBIFS 在闪存介质上维护文件系统索引
> > + 信息,无需全介质扫描,因此挂载速度远快于 JFFS2。
> > +* JFFS2 是直写(write-through)文件系统,而 UBIFS 支持回写(write-back),这使得 UBIFS
> > + 写入速度快得多。
> > +
> > +与 JFFS2 类似,UBIFS 支持实时压缩,可将大量数据存入闪存。
> > +
> > +与 JFFS2 类似,UBIFS 能容忍异常重启和断电。它不需要类似 fsck.ext2 的工具。UBIFS 会自动重放日
> > +志并从崩溃中恢复,确保闪存数据结构的一致性。
> > +
> > +UBIFS 具有对数级扩展性(其使用的数据结构多为树形),因此挂载时间和内存消耗不像 JFFS2 那样线性依
> > +赖于闪存容量。这是因为 UBIFS 在闪存介质上维护文件系统索引。但 UBIFS 依赖于线性扩展的 UBI 层,
> > +因此整体 UBI/UBIFS 栈仍是线性扩展。尽管如此,UBIFS/UBI 的扩展性仍显著优于 JFFS2。
> > +
> > +UBIFS 开发者认为,未来可开发同样具备对数级扩展性的 UBI2。UBI2 将支持与 UBI 相同的 API,但二进
> > +制不兼容。因此 UBIFS 无需修改即可使用 UBI2。
> > +
> > +挂载选项
> > +=============
> > +
> > +(*) 表示默认选项。
> > +
> > +==================== =======================================================
> > +bulk_read 批量读取以利用闪存介质的顺序读取加速特性
> > +no_bulk_read (*) 禁用批量读取
> > +no_chk_data_crc (*) 跳过数据节点的 CRC 校验以提高读取性能。 仅在闪存
> > + 介质高度可靠时使用此选项。 此选项可能导致文件内容损坏无法被
> > + 察觉。
> > +chk_data_crc 强制校验数据节点的 CRC
> > +compr=none 覆盖默认压缩器,设置为"none"
> > +compr=lzo 覆盖默认压缩器,设置为"LZO"
> > +compr=zlib 覆盖默认压缩器,设置为"zlib"
> > +auth_key= 指定用于文件系统身份验证的密钥。
> > + 使用此选项将强制启用身份验证。
> > + 传入的密钥必须存在于内核密钥环中, 且类型必须是'logon'
> > +auth_hash_name= 用于身份验证的哈希算法。同时用于哈希计算和 HMAC
> > + 生成。典型值包括"sha256"或"sha512"
> > +==================== =======================================================
> > +
> > +快速使用指南
> > +========================
> > +
> > +挂载的 UBI 卷通过 "ubiX_Y" 或 "ubiX:NAME" 语法指定,其中 "X" 是 UBI 设备编号,"Y" 是 UBI
> > +卷编号,"NAME" 是 UBI 卷名称。
> > +
> > +将 UBI 设备 0 的卷 0 挂载到 /mnt/ubifs::
> > +
> > + $ mount -t ubifs ubi0_0 /mnt/ubifs
> > +
> > +将 UBI 设备 0 的 "rootfs" 卷挂载到 /mnt/ubifs("rootfs" 是卷名)::
> > +
> > + $ mount -t ubifs ubi0:rootfs /mnt/ubifs
> > +
> > +以下是内核启动参数的示例,用于将 mtd0 附加到 UBI 并挂载 "rootfs" 卷:
> > +ubi.mtd=0 root=ubi0:rootfs rootfstype=ubifs
> > +
> > +参考资料
> > +==========
> > +
> > +UBIFS 文档及常见问题解答/操作指南请访问 MTD 官网:
> > +
> > +- http://www.linux-mtd.infradead.org/doc/ubifs.html
> > +- http://www.linux-mtd.infradead.org/faq/ubifs.html
> > --
> > 2.25.1
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese
2025-07-17 2:26 ` Dongliang Mu
@ 2025-07-17 3:16 ` shao.mingyin
2025-07-17 3:21 ` Dongliang Mu
0 siblings, 1 reply; 6+ messages in thread
From: shao.mingyin @ 2025-07-17 3:16 UTC (permalink / raw)
To: mudongliangabcd
Cc: seakeel, alexs, si.yanteng, dzm91, corbet, linux-doc,
linux-kernel, yang.yang29, xu.xin16, yang.tao172, ye.xingchen,
wang.yaxin
[-- Attachment #1.1.1: Type: text/plain, Size: 8795 bytes --]
> On Thu, Jul 17, 2025 at 9:41 AM Alex Shi <seakeel@gmail.com> wrote:
> >
> > These 2 patches could be sent out as a patchset.
> >
>
> I will explain this statement a little further. Since your two patches
> both modify translations/zh_CN/filesystems/index.rst, they have their
> own dependencies or orders.
> In other words, this patch should be merged before the other one.
>
> In this case, it's better to submit a patchset (patchset has internal
> orders, patch 0/2, patch 1/2, patch 2/2) to reviewers and maintainers.
>
> Dongliang Mu
>
Thanks for your feedback!
I understand your explanation.
In addition to these two documents, I also translated gfs2.rst and
gfs2-events.rst, which also require modifications to
translations/zh_CN/file systems/index.rst. Therefore, should I submit
these four patches as a patchset?
Best regards,
Mingyin
>
> > Thanks
> >
> > <shao.mingyin@zte.com.cn> 于2025年7月15日周二 15:15写道:
> > >
> > > From: Shao Mingyin <shao.mingyin@zte.com.cn>
> > >
> > > translate the "ubifs.rst" into Simplified Chinese.
> > >
> > > Update to commit 5f5cae9b0e81("Documentation: ubifs: Fix
> > > compression idiom")
> > >
> > > Signed-off-by: Shao Mingyin <shao.mingyin@zte.com.cn>
> > > Signed-off-by: yang tao <yang.tao172@zte.com.cn>
> > > ---
> > > .../translations/zh_CN/filesystems/index.rst | 1 +
> > > .../translations/zh_CN/filesystems/ubifs.rst | 111 ++++++++++++++++++
> > > 2 files changed, 112 insertions(+)
> > > create mode 100644 Documentation/translations/zh_CN/filesystems/ubifs.rst
> > >
> > > diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> > > index 9f2a8b003778..faaa0f097223 100644
> > > --- a/Documentation/translations/zh_CN/filesystems/index.rst
> > > +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> > > @@ -26,4 +26,5 @@ Linux Kernel中的文件系统
> > > virtiofs
> > > debugfs
> > > tmpfs
> > > + ubifs
> > >
> > > diff --git a/Documentation/translations/zh_CN/filesystems/ubifs.rst b/Documentation/translations/zh_CN/filesystems/ubifs.rst
> > > new file mode 100644
> > > index 000000000000..27997777f4ea
> > > --- /dev/null
> > > +++ b/Documentation/translations/zh_CN/filesystems/ubifs.rst
> > > @@ -0,0 +1,111 @@
> > > +.. SPDX-License-Identifier: GPL-2.0
> > > +
> > > +.. include:: ../disclaimer-zh_CN.rst
> > > +
> > > +:Original: Documentation/filesystems/ubifs.rst
> > > +
> > > +:翻译:
> > > +
> > > + 邵明寅 Shao Mingyin <shao.mingyin@zte.com.cn>
> > > +
> > > +:校译:
> > > +
> > > + - 杨涛 yang tao <yang.tao172@zte.com.cn>
> > > +
> > > +===============
> > > +UBI 文件系统
> > > +===============
> > > +
> > > +简介
> > > +============
> > > +
> > > +UBIFS 文件系统全称为 UBI 文件系统(UBI File System)。UBI 代表无序块镜像(Unsorted
> > > +Block Images)。UBIFS 是一种闪存文件系统,这意味着它专为闪存设备设计。需要理解的是,UBIFS
> > > +与 Linux 中任何传统文件系统(如 Ext2、XFS、JFS 等)完全不同。UBIFS 代表一类特殊的文件系统,
> > > +它们工作在 MTD 设备而非块设备上。该类别的另一个 Linux 文件系统是 JFFS2。
> > > +
> > > +为更清晰说明,以下是 MTD 设备与块设备的简要比较:
> > > +
> > > +1. MTD 设备代表闪存设备,由较大尺寸的擦除块组成,通常约 128KiB。块设备由小块组成,通常 512
> > > + 字节。
> > > +2. MTD 设备支持 3 种主要操作:在擦除块内偏移位置读取、在擦除块内偏移位置写入、以及擦除整个擦除
> > > + 块。块设备支持 2 种主要操作:读取整个块和写入整个块。
> > > +3. 整个擦除块必须先擦除才能重写内容。块可直接重写。
> > > +4. 擦除块在经历一定次数的擦写周期后会磨损,通常 SLC NAND 和 NOR 闪存为 100K-1G 次,MLC
> > > + NAND 闪存为 1K-10K 次。块设备不具备磨损特性。
> > > +5. 擦除块可能损坏(仅限 NAND 闪存),软件需处理此问题。硬盘上的块通常不会损坏,因为硬件有坏块
> > > + 替换机制(至少现代 LBA 硬盘如此)。
> > > +
> > > +这充分说明了 UBIFS 与传统文件系统的本质差异。
> > > +
> > > +UBIFS 工作在 UBI 层之上。UBI 是一个独立的软件层(位于 drivers/mtd/ubi),本质上是卷管理和
> > > +磨损均衡层。它提供称为 UBI 卷的高级抽象,比 MTD 设备更上层。UBI 设备的编程模型与 MTD 设备非
> > > +常相似,仍由大容量擦除块组成,支持读/写/擦除操作,但 UBI 设备消除了磨损和坏块限制(上述列表的第
> > > +4 和第 5 项)。
> > > +
> > > +某种意义上,UBIFS 是 JFFS2 文件系统的下一代产品,但它与 JFFS2 差异巨大且不兼容。主要区别如下:
> > > +
> > > +* JFFS2 工作在 MTD 设备之上,UBIFS 依赖于 UBI 并工作在 UBI 卷之上。
> > > +* JFFS2 没有介质索引,需在挂载时构建索引,这要求全介质扫描。UBIFS 在闪存介质上维护文件系统索引
> > > + 信息,无需全介质扫描,因此挂载速度远快于 JFFS2。
> > > +* JFFS2 是直写(write-through)文件系统,而 UBIFS 支持回写(write-back),这使得 UBIFS
> > > + 写入速度快得多。
> > > +
> > > +与 JFFS2 类似,UBIFS 支持实时压缩,可将大量数据存入闪存。
> > > +
> > > +与 JFFS2 类似,UBIFS 能容忍异常重启和断电。它不需要类似 fsck.ext2 的工具。UBIFS 会自动重放日
> > > +志并从崩溃中恢复,确保闪存数据结构的一致性。
> > > +
> > > +UBIFS 具有对数级扩展性(其使用的数据结构多为树形),因此挂载时间和内存消耗不像 JFFS2 那样线性依
> > > +赖于闪存容量。这是因为 UBIFS 在闪存介质上维护文件系统索引。但 UBIFS 依赖于线性扩展的 UBI 层,
> > > +因此整体 UBI/UBIFS 栈仍是线性扩展。尽管如此,UBIFS/UBI 的扩展性仍显著优于 JFFS2。
> > > +
> > > +UBIFS 开发者认为,未来可开发同样具备对数级扩展性的 UBI2。UBI2 将支持与 UBI 相同的 API,但二进
> > > +制不兼容。因此 UBIFS 无需修改即可使用 UBI2。
> > > +
> > > +挂载选项
> > > +=============
> > > +
> > > +(*) 表示默认选项。
> > > +
> > > +==================== =======================================================
> > > +bulk_read 批量读取以利用闪存介质的顺序读取加速特性
> > > +no_bulk_read (*) 禁用批量读取
> > > +no_chk_data_crc (*) 跳过数据节点的 CRC 校验以提高读取性能。 仅在闪存
> > > + 介质高度可靠时使用此选项。 此选项可能导致文件内容损坏无法被
> > > + 察觉。
> > > +chk_data_crc 强制校验数据节点的 CRC
> > > +compr=none 覆盖默认压缩器,设置为"none"
> > > +compr=lzo 覆盖默认压缩器,设置为"LZO"
> > > +compr=zlib 覆盖默认压缩器,设置为"zlib"
> > > +auth_key= 指定用于文件系统身份验证的密钥。
> > > + 使用此选项将强制启用身份验证。
> > > + 传入的密钥必须存在于内核密钥环中, 且类型必须是'logon'
> > > +auth_hash_name= 用于身份验证的哈希算法。同时用于哈希计算和 HMAC
> > > + 生成。典型值包括"sha256"或"sha512"
> > > +==================== =======================================================
> > > +
> > > +快速使用指南
> > > +========================
> > > +
> > > +挂载的 UBI 卷通过 "ubiX_Y" 或 "ubiX:NAME" 语法指定,其中 "X" 是 UBI 设备编号,"Y" 是 UBI
> > > +卷编号,"NAME" 是 UBI 卷名称。
> > > +
> > > +将 UBI 设备 0 的卷 0 挂载到 /mnt/ubifs::
> > > +
> > > + $ mount -t ubifs ubi0_0 /mnt/ubifs
> > > +
> > > +将 UBI 设备 0 的 "rootfs" 卷挂载到 /mnt/ubifs("rootfs" 是卷名)::
> > > +
> > > + $ mount -t ubifs ubi0:rootfs /mnt/ubifs
> > > +
> > > +以下是内核启动参数的示例,用于将 mtd0 附加到 UBI 并挂载 "rootfs" 卷:
> > > +ubi.mtd=0 root=ubi0:rootfs rootfstype=ubifs
> > > +
> > > +参考资料
> > > +==========
> > > +
> > > +UBIFS 文档及常见问题解答/操作指南请访问 MTD 官网:
> > > +
> > > +- http://www.linux-mtd.infradead.org/doc/ubifs.html
> > > +- http://www.linux-mtd.infradead.org/faq/ubifs.html
> > > --
> > > 2.25.1
[-- Attachment #1.1.2: Type: text/html , Size: 12120 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese
2025-07-17 3:16 ` shao.mingyin
@ 2025-07-17 3:21 ` Dongliang Mu
0 siblings, 0 replies; 6+ messages in thread
From: Dongliang Mu @ 2025-07-17 3:21 UTC (permalink / raw)
To: shao.mingyin, mudongliangabcd
Cc: seakeel, alexs, si.yanteng, corbet, linux-doc, linux-kernel,
yang.yang29, xu.xin16, yang.tao172, ye.xingchen, wang.yaxin
On 7/17/25 11:16 AM, shao.mingyin@zte.com.cn wrote:
>
> > On Thu, Jul 17, 2025 at 9:41 AM Alex Shi <seakeel@gmail.com> wrote:
>
> > >
>
> > > These 2 patches could be sent out as a patchset.
>
> > >
>
> >
>
> > I will explain this statement a little further. Since your two patches
>
> > both modify translations/zh_CN/filesystems/index.rst, they have their
>
> > own dependencies or orders.
>
> > In other words, this patch should be merged before the other one.
>
> >
>
> > In this case, it's better to submit a patchset (patchset has internal
>
> > orders, patch 0/2, patch 1/2, patch 2/2) to reviewers and maintainers.
>
> >
>
> > Dongliang Mu
>
> >
>
> Thanks for your feedback!
>
>
> I understand your explanation.
>
>
> In addition to these two documents, I also translated gfs2.rst and
>
> gfs2-events.rst, which also require modifications to
>
> translations/zh_CN/file systems/index.rst. Therefore, should I submit
>
> these four patches as a patchset?
>
Correct
>
>
> Best regards,
>
> Mingyin
>
> >
>
> > > Thanks
>
> > >
>
> > > <shao.mingyin@zte.com.cn> 于2025年7月15日周二 15:15写道:
>
> > > >
>
> > > > From: Shao Mingyin <shao.mingyin@zte.com.cn>
>
> > > >
>
> > > > translate the "ubifs.rst" into Simplified Chinese.
>
> > > >
>
> > > > Update to commit 5f5cae9b0e81("Documentation: ubifs: Fix
>
> > > > compression idiom")
>
> > > >
>
> > > > Signed-off-by: Shao Mingyin <shao.mingyin@zte.com.cn>
>
> > > > Signed-off-by: yang tao <yang.tao172@zte.com.cn>
>
> > > > ---
>
> > > > .../translations/zh_CN/filesystems/index.rst | 1 +
>
> > > > .../translations/zh_CN/filesystems/ubifs.rst | 111
> ++++++++++++++++++
>
> > > > 2 files changed, 112 insertions(+)
>
> > > > create mode 100644
> Documentation/translations/zh_CN/filesystems/ubifs.rst
>
> > > >
>
> > > > diff --git
> a/Documentation/translations/zh_CN/filesystems/index.rst
> b/Documentation/translations/zh_CN/filesystems/index.rst
>
> > > > index 9f2a8b003778..faaa0f097223 100644
>
> > > > --- a/Documentation/translations/zh_CN/filesystems/index.rst
>
> > > > +++ b/Documentation/translations/zh_CN/filesystems/index.rst
>
> > > > @@ -26,4 +26,5 @@ Linux Kernel中的文件系统
>
> > > > virtiofs
>
> > > > debugfs
>
> > > > tmpfs
>
> > > > + ubifs
>
> > > >
>
> > > > diff --git
> a/Documentation/translations/zh_CN/filesystems/ubifs.rst
> b/Documentation/translations/zh_CN/filesystems/ubifs.rst
>
> > > > new file mode 100644
>
> > > > index 000000000000..27997777f4ea
>
> > > > --- /dev/null
>
> > > > +++ b/Documentation/translations/zh_CN/filesystems/ubifs.rst
>
> > > > @@ -0,0 +1,111 @@
>
> > > > +.. SPDX-License-Identifier: GPL-2.0
>
> > > > +
>
> > > > +.. include:: ../disclaimer-zh_CN.rst
>
> > > > +
>
> > > > +:Original: Documentation/filesystems/ubifs.rst
>
> > > > +
>
> > > > +:翻译:
>
> > > > +
>
> > > > + 邵明寅 Shao Mingyin <shao.mingyin@zte.com.cn>
>
> > > > +
>
> > > > +:校译:
>
> > > > +
>
> > > > + - 杨涛 yang tao <yang.tao172@zte.com.cn>
>
> > > > +
>
> > > > +===============
>
> > > > +UBI 文件系统
>
> > > > +===============
>
> > > > +
>
> > > > +简介
>
> > > > +============
>
> > > > +
>
> > > > +UBIFS 文件系统全称为 UBI 文件系统(UBI File System)。UBI
> 代表无序块镜像(Unsorted
>
> > > > +Block Images)。UBIFS
> 是一种闪存文件系统,这意味着它专为闪存设备设计。需要理解的是,UBIFS
>
> > > > +与 Linux 中任何传统文件系统(如 Ext2、XFS、JFS 等)完全不同。UBIFS
> 代表一类特殊的文件系统,
>
> > > > +它们工作在 MTD 设备而非块设备上。该类别的另一个 Linux 文件系统是
> JFFS2。
>
> > > > +
>
> > > > +为更清晰说明,以下是 MTD 设备与块设备的简要比较:
>
> > > > +
>
> > > > +1. MTD 设备代表闪存设备,由较大尺寸的擦除块组成,通常约
> 128KiB。块设备由小块组成,通常 512
>
> > > > + 字节。
>
> > > > +2. MTD 设备支持 3
> 种主要操作:在擦除块内偏移位置读取、在擦除块内偏移位置写入、以及擦除整个擦除
>
> > > > + 块。块设备支持 2 种主要操作:读取整个块和写入整个块。
>
> > > > +3. 整个擦除块必须先擦除才能重写内容。块可直接重写。
>
> > > > +4. 擦除块在经历一定次数的擦写周期后会磨损,通常 SLC NAND 和 NOR
> 闪存为 100K-1G 次,MLC
>
> > > > + NAND 闪存为 1K-10K 次。块设备不具备磨损特性。
>
> > > > +5. 擦除块可能损坏(仅限 NAND
> 闪存),软件需处理此问题。硬盘上的块通常不会损坏,因为硬件有坏块
>
> > > > + 替换机制(至少现代 LBA 硬盘如此)。
>
> > > > +
>
> > > > +这充分说明了 UBIFS 与传统文件系统的本质差异。
>
> > > > +
>
> > > > +UBIFS 工作在 UBI 层之上。UBI 是一个独立的软件层(位于
> drivers/mtd/ubi),本质上是卷管理和
>
> > > > +磨损均衡层。它提供称为 UBI 卷的高级抽象,比 MTD 设备更上层。UBI
> 设备的编程模型与 MTD 设备非
>
> > > > +常相似,仍由大容量擦除块组成,支持读/写/擦除操作,但 UBI
> 设备消除了磨损和坏块限制(上述列表的第
>
> > > > +4 和第 5 项)。
>
> > > > +
>
> > > > +某种意义上,UBIFS 是 JFFS2 文件系统的下一代产品,但它与 JFFS2
> 差异巨大且不兼容。主要区别如下:
>
> > > > +
>
> > > > +* JFFS2 工作在 MTD 设备之上,UBIFS 依赖于 UBI 并工作在 UBI 卷之上。
>
> > > > +* JFFS2 没有介质索引,需在挂载时构建索引,这要求全介质扫描。UBIFS
> 在闪存介质上维护文件系统索引
>
> > > > + 信息,无需全介质扫描,因此挂载速度远快于 JFFS2。
>
> > > > +* JFFS2 是直写(write-through)文件系统,而 UBIFS
> 支持回写(write-back),这使得 UBIFS
>
> > > > + 写入速度快得多。
>
> > > > +
>
> > > > +与 JFFS2 类似,UBIFS 支持实时压缩,可将大量数据存入闪存。
>
> > > > +
>
> > > > +与 JFFS2 类似,UBIFS 能容忍异常重启和断电。它不需要类似 fsck.ext2
> 的工具。UBIFS 会自动重放日
>
> > > > +志并从崩溃中恢复,确保闪存数据结构的一致性。
>
> > > > +
>
> > > > +UBIFS
> 具有对数级扩展性(其使用的数据结构多为树形),因此挂载时间和内存消耗不像
> JFFS2 那样线性依
>
> > > > +赖于闪存容量。这是因为 UBIFS 在闪存介质上维护文件系统索引。但 UBIFS
> 依赖于线性扩展的 UBI 层,
>
> > > > +因此整体 UBI/UBIFS 栈仍是线性扩展。尽管如此,UBIFS/UBI
> 的扩展性仍显著优于 JFFS2。
>
> > > > +
>
> > > > +UBIFS 开发者认为,未来可开发同样具备对数级扩展性的 UBI2。UBI2
> 将支持与 UBI 相同的 API,但二进
>
> > > > +制不兼容。因此 UBIFS 无需修改即可使用 UBI2。
>
> > > > +
>
> > > > +挂载选项
>
> > > > +=============
>
> > > > +
>
> > > > +(*) 表示默认选项。
>
> > > > +
>
> > > > +====================
> =======================================================
>
> > > > +bulk_read 批量读取以利用闪存介质的顺序读取加速特性
>
> > > > +no_bulk_read (*) 禁用批量读取
>
> > > > +no_chk_data_crc (*) 跳过数据节点的 CRC 校验以提高读取性能。
> 仅在闪存
>
> > > > + 介质高度可靠时使用此选项。
> 此选项可能导致文件内容损坏无法被
>
> > > > + 察觉。
>
> > > > +chk_data_crc 强制校验数据节点的 CRC
>
> > > > +compr=none 覆盖默认压缩器,设置为"none"
>
> > > > +compr=lzo 覆盖默认压缩器,设置为"LZO"
>
> > > > +compr=zlib 覆盖默认压缩器,设置为"zlib"
>
> > > > +auth_key= 指定用于文件系统身份验证的密钥。
>
> > > > + 使用此选项将强制启用身份验证。
>
> > > > + 传入的密钥必须存在于内核密钥环中,
> 且类型必须是'logon'
>
> > > > +auth_hash_name= 用于身份验证的哈希算法。同时用于哈希计算和
> HMAC
>
> > > > + 生成。典型值包括"sha256"或"sha512"
>
> > > > +====================
> =======================================================
>
> > > > +
>
> > > > +快速使用指南
>
> > > > +========================
>
> > > > +
>
> > > > +挂载的 UBI 卷通过 "ubiX_Y" 或 "ubiX:NAME" 语法指定,其中 "X" 是 UBI
> 设备编号,"Y" 是 UBI
>
> > > > +卷编号,"NAME" 是 UBI 卷名称。
>
> > > > +
>
> > > > +将 UBI 设备 0 的卷 0 挂载到 /mnt/ubifs::
>
> > > > +
>
> > > > + $ mount -t ubifs ubi0_0 /mnt/ubifs
>
> > > > +
>
> > > > +将 UBI 设备 0 的 "rootfs" 卷挂载到 /mnt/ubifs("rootfs" 是卷名)::
>
> > > > +
>
> > > > + $ mount -t ubifs ubi0:rootfs /mnt/ubifs
>
> > > > +
>
> > > > +以下是内核启动参数的示例,用于将 mtd0 附加到 UBI 并挂载 "rootfs"
> 卷:
>
> > > > +ubi.mtd=0 root=ubi0:rootfs rootfstype=ubifs
>
> > > > +
>
> > > > +参考资料
>
> > > > +==========
>
> > > > +
>
> > > > +UBIFS 文档及常见问题解答/操作指南请访问 MTD 官网:
>
> > > > +
>
> > > > +- http://www.linux-mtd.infradead.org/doc/ubifs.html
>
> > > > +- http://www.linux-mtd.infradead.org/faq/ubifs.html
>
> > > > --
>
> > > > 2.25.1
>
>
>
>
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2025-07-17 3:22 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-07-15 7:15 [PATCH] Docs/zh_CN: Translate ubifs.rst to Simplified Chinese shao.mingyin
2025-07-17 1:40 ` Alex Shi
2025-07-17 2:26 ` Dongliang Mu
2025-07-17 3:16 ` shao.mingyin
2025-07-17 3:21 ` Dongliang Mu
-- strict thread matches above, loose matches on Subject: below --
2025-06-16 6:51 shao.mingyin
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).