[PATCH 5/7] docs/zh_CN: Translate timers/highres.rst

Patch content 2 changed files

Translate .../timers/highres.rst into Chinese.Update timers/index.rst to include the translated file. Update translation through commit 458f69ef3665("docs: timers: convert docs to ReST and rename to *.rst") Signed-off-by: Xingqiu Xu <hilbertanjou83@gmail.com>--- .../translations/zh_CN/timers/highres.rst     | 271 ++++++++++++++++++ .../translations/zh_CN/timers/index.rst       |   2 +- 2 files changed, 272 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/timers/highres.rst diff --git a/Documentation/translations/zh_CN/timers/highres.rst b/Documentation/translations/zh_CN/timers/highres.rstnew file mode 100644index 000000000000..a26ae1e13fd0--- /dev/null+++ b/Documentation/translations/zh_CN/timers/highres.rst@@ -0,0 +1,271 @@+.. SPDX-License-Identifier: GPL-2.0++.. include:: ../disclaimer-zh_CN.rst++:Original: Documentation/timers/highres.rst++:翻译:++  徐兴球 Xingqiu Xu <hilbertanjou83@gmail.com>++==========================================+高分辨率定时器和动态时钟刻度设计笔记+==========================================++可以在 OLS 2006 演讲"hrtimers 及其超越"的+论文中找到更多信息。该论文是 OLS 2006 论文+集第 1 卷的一部分，可以在 OLS 网站上找到：+https://www.kernel.org/doc/ols/2006/ols2006v1-pages-333-346.pdf++该演讲的幻灯片可从以下网址获得：+http://www.cs.columbia.edu/~nahum/w6998/papers/ols2006-hrtimers-slides.pdf++幻灯片包含五个图（第 2、15、18、20、22 页），+说明了 Linux 时间(r)相关子系统的变化。图 #1+（第 2 页）显示了在 hrtimers 和其他构建块合+并到主线之前 Linux 时间(r)系统的设计。++注意：论文和幻灯片讨论的是"时钟事件源"，而我+们同时切换到了名称"时钟事件设备"。++该设计包含以下基本构建块：++- hrtimer 基础设施+- 时间日期和时钟源管理+- 时钟事件管理+- 高分辨率定时器功能+- 动态时钟刻度+++hrtimer 基础设施+----------------++hrtimer 基础设施已合并到 2.6.16 内核中。基+本实现的详细信息包含在+Documentation/timers/hrtimers.rst 中。另请+参见图 #2（OLS 幻灯片第 15 页）++与保存已武装的 timer_list 类型定时器的定时+器轮的主要区别是：++       - 按时间顺序入队到红黑树中+       - 独立于时钟节拍（处理基于纳秒）+++时间日期和时钟源管理+--------------------++John Stultz 的通用时间日期（GTOD）框架将+大部分代码从特定于架构的区域移动到通用管理+框架中，如图 #3（OLS 幻灯片第 18 页）所示。+特定于架构的部分被简化为时钟源的低级硬件细+节，这些时钟源在框架中注册并根据基于质量的+决策进行选择。低级代码提供硬件设置和读出例+程，并初始化数据结构，通用时间保持代码使用+这些数据结构将时钟刻度转换为基于纳秒的时间+值。所有其他与时间保持相关的功能都移到了通+用代码中。GTOD 基础补丁已合并到 2.6.18 内+核中。++有关通用时间日期框架的更多信息，请参见 OLS+2005 论文集第 1 卷：++	http://www.linuxsymposium.org/2005/linuxsymposium_procv1.pdf++论文"We Are Not Getting Any Younger: A New+Approach to Time and Timers"由 J. Stultz、+D.V. Hart 和 N. Aravamudan 撰写。++图 #3（OLS 幻灯片第 18 页）说明了这一转变。+++时钟事件管理+------------++虽然时钟源提供对单调递增时间值的读访问，但+时钟事件设备用于调度下一个事件中断。下一个+事件当前定义为周期性的，其周期在编译时定义。+事件设备的设置和选择用于各种事件驱动功能被+硬编码到依赖于架构的代码中。这导致所有架构+都有重复代码，并且使得更改系统配置以使用除+已内置到架构中的事件中断设备之外的其他设备+变得极其困难。当前设计的另一个含义是，为了+提供诸如高分辨率定时器或动态时钟刻度之类的+新功能，必须触及所有特定于架构的实现。++时钟事件子系统试图通过提供通用解决方案来管+理时钟事件设备及其用于各种时钟事件驱动的内+核功能来解决此问题。时钟事件子系统的目标是+将时钟事件相关的依赖于架构的代码最小化为纯+硬件相关的处理，并允许轻松添加和利用新的时+钟事件设备。它还最小化了跨架构的重复代码，+因为它提供了从中断服务处理程序向下的通用功+能，这几乎本质上是硬件依赖的。++时钟事件设备由依赖于架构的引导代码或在模块+插入时注册。每个时钟事件设备填充一个数据结+构，其中包含时钟特定的属性参数和回调函数。+时钟事件管理通过使用指定的属性参数决定时钟+事件设备将用于支持的系统功能集。这包括区分+每 CPU 和每系统全局事件设备。++系统级全局事件设备用于 Linux 周期时钟刻度。+每 CPU 事件设备用于提供本地 CPU 功能，例如+进程记账、分析和高分辨率定时器。++管理层为时钟事件设备分配以下一个或多个功能：++      - 系统全局周期时钟刻度（jiffies 更新）+      - cpu 本地 update_process_times+      - cpu 本地分析+      - cpu 本地下一个事件中断（非周期模式）++时钟事件设备将这些定时器中断相关功能的选择+完全委托给管理层。时钟管理层在设备描述结构+中存储一个函数指针，必须从硬件级处理程序调+用该指针。这从特定于架构的定时器中断处理程+序中删除了大量重复代码，并将对时钟事件设备+的控制以及定时器中断相关功能的分配交给核心+代码。++时钟事件层 API 相当小。除了时钟事件设备注+册接口外，它还提供用于调度下一个事件中断、+时钟事件设备通知服务以及对挂起和恢复的支持+的函数。++该框架添加了大约 700 行代码，这导致内核二+进制大小增加 2KB。i386 的转换删除了大约+100 行代码。二进制大小减少约 400 字节。我+们认为，灵活性的增加和跨架构的重复代码的避+免证明了二进制大小的轻微增加是合理的。++架构的转换没有功能影响，但允许在不更改时钟+事件设备和定时器中断代码的情况下利用高分辨+率和动态时钟刻度功能。转换后，只需将+kernel/time/Kconfig 文件添加到特定于架构+的 Kconfig 并将动态时钟刻度特定调用添加到+空闲例程（总共向空闲函数和 Kconfig 文件添+加 3 行）即可简单地提供高分辨率定时器和动+态时钟刻度的启用。++图 #4（OLS 幻灯片第 20 页）说明了这一转变。+++高分辨率定时器功能+------------------++在系统引导期间无法使用高分辨率定时器功能，+虽然实现这一功能会很困难且没有实际用途。必+须完成时钟事件设备框架、时钟源框架（GTOD）+和 hrtimers 本身的初始化，并且必须注册适当+的时钟源和时钟事件设备，然后高分辨率功能才+能工作。直到 hrtimers 初始化完成之前，系统+以通常的低分辨率周期模式工作。+时钟源和时钟事件设备层提供通知功能，通知+hrtimers 有关新硬件的可用性。hrtimers 在+切换到高分辨率模式之前验证已注册时钟源和时+钟事件设备的可用性。这也确保了配置为高分辨+率定时器的内核可以在缺乏必要硬件支持的系统+上运行。++高分辨率定时器代码不支持仅具有全局时钟事件+设备的 SMP 机器。对此类硬件的支持将涉及中+断发生时的 IPI 调用。开销将远大于收益。这+就是为什么我们目前在 i386 SMP 系统上禁用+高分辨率和动态时钟刻度，这些系统在 C3 电+源状态下停止本地 APIC。解决方法作为想法可+用，但尚未解决该问题。++定时器的时间排序插入提供了所有基础设施，以+在添加定时器时决定是否必须重新编程事件设备。+该决定是按定时器基础做出的，并在支持函数中+跨每 CPU 定时器基础同步。该设计允许系统为+每 CPU 定时器基础使用单独的每 CPU 时钟事+件设备，但当前每个 CPU 仅使用一个可重新编+程的时钟事件设备。++当定时器中断发生时，从时钟事件分发代码调用+下一个事件中断处理函数，并将过期的定时器从+红黑树移动到单独的双向链表，并调用软中断处+理函数。hrtimer 结构中的额外模式字段允许+系统直接从下一个事件中断处理函数执行回调函+数。这仅限于可以在硬中断上下文中安全执行的+代码。例如，这适用于 nanosleep 使用的唤醒+函数的常见情况。在中断上下文中执行处理函数+的优点是避免了多达两次上下文切换——从中断的+上下文到软中断以及到被过期定时器唤醒的任务。++一旦系统切换到高分辨率模式，周期时钟节拍就+会关闭。这会禁用系统级全局周期时钟事件设备+——例如 i386 SMP 系统上的 PIT。++周期时钟节拍功能由每 CPU hrtimer 提供。回+调函数在下一个事件中断上下文中执行，并更新+jiffies 并调用 update_process_times 和分+析。基于 hrtimer 的周期时钟节拍的实现旨在+扩展动态时钟节拍功能。这允许使用单个时钟事+件设备在 UP 系统上调度高分辨率定时器和周期+事件（jiffies 时钟节拍、分析、进程记账）。+这已被证明可以在 i386 上的 PIT 和 PPC 上+的增量器上工作。++用于运行 hrtimer 队列和执行回调的软中断已+从时钟节拍绑定的定时器软中断中分离出来，以+允许准确传递 itimer 和 POSIX 间隔定时器使+用的高分辨率定时器信号。此软中断的执行仍可+能被其他软中断延迟，但这种分离已显著改善了+总体延迟。++图 #5（OLS 幻灯片第 22 页）说明了这一转变。+++动态时钟节拍+------------++动态时钟节拍是基于 hrtimer 的周期时钟节拍+替换（sched_tick）的逻辑结果。sched_tick+hrtimer 的功能由三个函数扩展：++- hrtimer_stop_sched_tick+- hrtimer_restart_sched_tick+- hrtimer_update_jiffies++当 CPU 进入空闲状态时调用+hrtimer_stop_sched_tick()。该代码评估下一+个预定的定时器事件（来自 hrtimers 和定时+器轮），如果下一个事件比下一个时钟节拍更远，+它会将 sched_tick 重新编程到这个未来事件，+以允许更长的空闲睡眠，而不会受到周期时钟节+拍的无用中断。当空闲期间发生中断但不会导致+重新调度时，也会调用该函数。该调用是必要的，+因为中断处理函数可能已经启动了一个新定时器，+其到期时间早于在上一次调用+hrtimer_stop_sched_tick 时识别的最近事件+的时间。++当 CPU 在调用 schedule() 之前离开空闲状态+时，调用 hrtimer_restart_sched_tick()。+hrtimer_restart_sched_tick() 恢复周期时+钟节拍，该节拍保持活动状态直到下次调用+hrtimer_stop_sched_tick()。++从 irq_enter() 调用 hrtimer_update_jiffies()+当空闲期间发生中断时，以确保 jiffies 是最+新的，并且中断处理函数不必处理可能过时的+jiffy 值。++动态时钟节拍功能提供统计值，这些值通过+/proc/stat 导出到用户空间，并可用于增强的+电源管理控制。++该实现为进一步开发留下了空间，例如完全无节+拍系统，其中时间片由调度程序控制、可变频率+分析以及将来完全删除 jiffies。+++除了当前 i386 支持的初始提交外，补丁集已经+扩展到 x86_64 和 ARM。MIPS 和 PowerPC 的+初始（正在进行的工作）支持也可用。++	  Thomas, Ingo+diff --git a/Documentation/translations/zh_CN/timers/index.rst b/Documentation/translations/zh_CN/timers/index.rstindex 513143c5222d..101341d1033c 100644--- a/Documentation/translations/zh_CN/timers/index.rst+++ b/Documentation/translations/zh_CN/timers/index.rst@@ -15,13 +15,13 @@ .. toctree::     :maxdepth: 1 +    highres     hpet     hrtimers     timekeeping  TODOList: -* highres * no_hz * delay_sleep_functions -- 2.34.1