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