Re: [PATCH] zh_CN:translation for block queue into Chinese
Hi, Jonathan I didn't mean to translate it into markdown, I just feel it looks better in markdown. I pay more attention on the contents but not the format and I just want to translate all block module docs into Chinese. I'll convert the format into plain text format and resend. Thanks for your advice, Norman On 2018/7/23 23:36, Jonathan Corbet wrote: On Fri, 20 Jul 2018 10:27:06 +0800 Norman wrote: Translate block/queue-sysfs.txt into Chinese Signed-off-by: Norman Kern --- .../translations/zh_CN/block/queue-sysfs.md | 205 + So...are you translating this into markdown format? Please don't do that, we don't need another documentation format in the kernel. If you want to convert this document to structured markup, the ideal approach would be to convert the source document to RST first, then translate the result. Thanks, jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
Re: [PATCH] zh_CN:translation for block queue into Chinese
On Fri, 20 Jul 2018 10:27:06 +0800 Norman wrote: > Translate block/queue-sysfs.txt into Chinese > > Signed-off-by: Norman Kern > --- > .../translations/zh_CN/block/queue-sysfs.md | 205 > + So...are you translating this into markdown format? Please don't do that, we don't need another documentation format in the kernel. If you want to convert this document to structured markup, the ideal approach would be to convert the source document to RST first, then translate the result. Thanks, jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
[PATCH] zh_CN:translation for block queue into Chinese
Translate block/queue-sysfs.txt into Chinese Signed-off-by: Norman Kern --- .../translations/zh_CN/block/queue-sysfs.md | 205 + 1 file changed, 205 insertions(+) create mode 100644 Documentation/translations/zh_CN/block/queue-sysfs.md diff --git a/Documentation/translations/zh_CN/block/queue-sysfs.md b/Documentation/translations/zh_CN/block/queue-sysfs.md new file mode 100644 index 000..54bccba --- /dev/null +++ b/Documentation/translations/zh_CN/block/queue-sysfs.md @@ -0,0 +1,205 @@ +**Chinese translated version of Documentation/block/queue-sysfs.txt** + +If you have any comment or update to the content, please contact the +original document maintainer directly. However, if you have a problem +communicating in English you can also ask the Chinese maintainer for +help. Contact the Chinese maintainer if this translation is outdated +or if there is a problem with the translation. + +- +Documentation/block/queue-sysfs.txt 的中文翻译 + +如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文 +交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻 +译存在问题，请联系中文版维护者。 + +英文版维护者： Jens Axboe +中文版维护者： 项男 Norman Kern +中文版翻译者： 项男 Norman Kern +中文版校译者： 项男 Norman Kern + +以下为正文 + + + +队列 sysfs 文件 + +这个文件将会详细描述位于每个块设备sysfs目录树下的队列文件。注意，堆叠设备典型地不会 + +导出任何设置，因为它们的队列只起到重新映射目标的作用。这些文件可以在/sys/block/xxx/queue/目录下找到。 + +使用RO后缀标记的文件是只读文件，RW后缀意为可读写文件。 + +add_random (RW) + +这个文件允许关闭磁盘熵贡献。文件默认值是１（开启）。 + +dax (RO) + +这个文件表明设备是否支持直接访问（DAX），CPU可寻址的存储使用它绕开页缓存。 + +真时显示‘１’，否则显示‘０’。 + +discard_granularity (RO) + +如果设备报告这项信息，它显示磁盘的内部分配大小（以字节为单位）。 + +‘０’值表示设备不支持discard功能。 + +discard_max_hw_bytes (RO) + +支持discard功能的设备可能包含在单个操作中能够削减或解映射的内部限制字节数。 + +discard_max_bytes参数被设备驱动设置成在单次操作中能够被丢弃的最大字节数。 + +发送给设备的discard请求数不允许超出这个限制。 + +discard_max_bytes值为0意味着设备不支持discard功能。 + +discard_max_bytes (RW) + +discard_max_hw_bytes是设备的硬件限制，而这个设置是软件限制。 + +当大量discard请求被发出时，一些设备表现出高延迟； + +调低这一数值会使Linux发送较小的discard请求，这可能帮助降低大量discard操作引入的延迟。 + +hw_sector_size (RO) + +这是设备的硬件扇区大小（以字节为单位）。 + +io_poll (RW) + +读取该文件时，它的内容显示启用（１）或禁用（０）轮询。将‘０’写入该文件将禁用设备的轮询。 + +写任何非０值都将启用该特性。 + +io_poll_delay (RW) + +如果启用轮询，该参数控制执行哪种类型的轮询。默认值为-1，传统轮询。 + +在这种模式下，CPU将会不放弃任何时间反复地询问完成情况。 + +如果设置为０，将使用混合的轮询模式，内核将会尝试根据训练猜测何时IO完成。基于这一猜测， + +在进入一次传统轮询循环前，内核将发出IO请求的进程置成睡眠状态一段时间。 + +这种模式可能比纯传统的轮询模式慢一些，但它可能更高效。 + +如果这个值设置大于０，在进入传统轮询前，内核将设置发出IO请求的进程睡眠这么多的微秒。 + +iostats (RW) + +这个文件用于控制（打开/关闭）磁盘的I/O状态统计。 + +logical_block_size (RO) + +设备的逻辑块大小（以字节为单位） + +max_hw_sectors_kb (RO) + +这是单个数据传输的最大千字节数 + +max_integrity_segments (RO) + +读取这个文件时，它的内容显示显示硬件控制器能够处理的完整段的最大限制，与块层设置一致。 + +max_sectors_kb (RW) + +块层允许一个文件系统请求最大千字节数。它必须小于等于硬件允许的最大大小。 + +max_segments (RO) + +设备的段数最大值。 + +max_segment_size (RO) + +设备的最大段大小。 + +minimum_io_size (RO) + +设备报告的最小首选IO大小。 + +nomerges (RW) + +它允许用户禁用涉及块层IO合并请求的查找逻辑。默认（０）启用所有合并。 + +当设置为１时，仅简单的one-hit合并会被尝试。当设置为２时， + +不会尝试任何合并算法（包括one-hit或更复杂的树/哈希查找）。 + +nr_requests (RW) + +它控制在块层可以为读或写请求分配的请求数量。注意，累计分配的数量可能是当前值的双倍， + +因为它仅适用于读或写（而不是累加和）。 + +为了通过请求饥饿避免优先级倒置，当启用CONFIG_BLK_CGROUP， + +一个请求队列为每个cgroup管理一个单独的请求池，并且这个参数适用于每一个per-block-cgroup请求池。 + +换句话说，如果有N个块cgroups，每一个请求队列可能有多达N个请求池，每个请求池被nr_requests单独管理。 + +optimal_io_size (RO) + +设备报告的最佳IO大小。 + +physical_block_size (RO) + +设备物理块大小（以字节为单位） +
