From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f172.google.com (mail-pl1-f172.google.com [209.85.214.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C96D72192FA for ; Thu, 18 Dec 2025 23:17:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.172 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766099838; cv=none; b=MuZg2hKwADleoCjkDT+dyidANqMn43UZI9vo97+DPkUvz9W5yBZlnxiNuu+nOTxnmW0kMF0LMNhqdj0uv0j2nihiMexkTsPPo4ZwFUkvlQ2vUlb6WXs6DJZS0jUHk/Di2HjH/h9ScXdXi2NAyOpkmmexEDgCYFPqdGC7CLG+b40= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766099838; c=relaxed/simple; bh=mEh9y4VH0mMCx+1a9mm5mwO/8pSQbC83R7DVFpL2xG0=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version:Content-Type; b=YxT6Jnwf/4i5RJeG1HLeZwyO/ucR5sgQ5mHG9WGocOqpAigNjRVQcFY1PKs6xtQsTKSTD05vldSMWtMd8hU7+KII8xA1O4M3jVjelO4os+Jo1p63LkIJRnOUNMj6F/wAQSIfUaxTHJC6669nlYCuvgddof7TjJ8+yRc3fsc90Gw= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=VOewc5tw; arc=none smtp.client-ip=209.85.214.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="VOewc5tw" Received: by mail-pl1-f172.google.com with SMTP id d9443c01a7336-2a0c20ee83dso14771045ad.2 for ; Thu, 18 Dec 2025 15:17:15 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766099835; x=1766704635; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=wiGyNwgOgMnEqrQlv4A6WrZ42YqulQyoDVifi9M5msw=; b=VOewc5twlG0XnIxxJcEogwY28TqcknVZAfGzQhZKVngoiBEieyFqEUwuL56o9z+x0c YCTGMs+hG1Mi743EsC8/2ogrUMcUvKEC6u3ALkn74udhxE5yOnc4Z1Ms0Kp9Yf+hdPoW eQOGAT7dVP8xIKn7mVRY/nMZ4kUlXLXWh3EJOra5fPV/Tj046wJEENWOtzZf7+9R3Kyo V/dTFVGogZKcf05Pehx7l7F1/iOqFfTBLnQkEBaS18ejUlWSY9CoL0/VUeM5QQeQ1RGg eUXKO/Hjy2+t6WRmfWWMarTYPs0xnmku5BGgOAw3M97BcYmtG3e947TMD92dKHi8BgoG 9HXQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766099835; x=1766704635; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=wiGyNwgOgMnEqrQlv4A6WrZ42YqulQyoDVifi9M5msw=; b=KATlRw8SB3gOTbXOg5xdoSnmQXxXNWNr7Pu4oyN5JzOy2rzNhudC+mBQdNriDQZeO9 mH4nSlXYvhUBeRvL6zEdWXRH6Uy0NHyDTfAXHju0ZGzBd3SWDjyW+1bFZKm6a+c/IdBK JLNSnxIPFN5uWP4HYuDI94gVvxCM8EjAi9sOPQrnC6A1ctSBBP/D/HBMeRInACVtWkTx 2hRwZEjTkDnbEGEimbfF3l/6HumEQjos78TlIxQ/OseNWaNXI+3flHoOlbyZNN9wMfWF vlYZ45VQm7Xh2EQuVf8IUjgq2xyMg/7y+bUGwe7zCO9e46nPNLYq9pRsuCqicgmXel8K zcUg== X-Forwarded-Encrypted: i=1; AJvYcCX+7pnkQLjIEyjHs4GgInhuA/o96p9+HkDSQyoq05Q88BV7MI+5SIfICIdM6lPUbSPCP10UhjJTuby38Dg=@vger.kernel.org X-Gm-Message-State: AOJu0YyfjAZUx0OhbHp5RnJHKpt+nVawUluesZ6pLDOeFGmJKRQVYo7r B6lg8J3V2NkgtkpBMas/+k/++zBXpNgA60YWX4OfyaFCgYcNM84wmVhK X-Gm-Gg: AY/fxX5qMRq1rPCnYN6sopLCTBTWIMBG83QQbY+4CkwoJ7R1r4e8W1Dj/F4GLXBsuHE SEMn9ihP929A8Xkn4qhDdffUakmb7PHBpBrIT+X2eKFRRO96BTveX9xtUdtPH6oQieS7JysXp5q GaA7ihaYH4jzy3RQV6CfBcoEoejZQfmnwHYeXhjZqsCpZw7XD0mWaM6lqEbGGsvve1HKkys8CPF +g4KRg+MkF/rxLQFW5+bNA4TjSRvKqo1FTTt+Hv68yfZcaWcVahmwmCptx0+KEb0GaCfH2iEkGK MqOPZ1XxJXPOBPaY89y2Hux5UxRKdLQpiMoAY9jWgwUuflE+f3fPLVVjKshNwmj4+kAzY/ew8is IZ8UUq1fVv2FDfI/UFTa9HdJtuQd5VXu3yucAPbWNT/QdiQZK/UgBBuoakc50arKPkxHurEhua+ h6mg0sdxKJdnRcRW/VMcSY9zM5oHrDA4TNNo2hyv2kJOU+7Q== X-Google-Smtp-Source: AGHT+IHddA93QPjFEZpQ7SryIGfGGAfKAX9S6eMSeC8sjxyGKKUaofFtL43A32MWoexCxRbRRK3hdA== X-Received: by 2002:a17:902:f60b:b0:2a0:b44e:9ab6 with SMTP id d9443c01a7336-2a2f222aedcmr8416655ad.7.1766099834716; Thu, 18 Dec 2025 15:17:14 -0800 (PST) Received: from Lingbou.localdomain ([113.225.44.231]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2a2f3d4cb48sm3311955ad.64.2025.12.18.15.17.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 18 Dec 2025 15:17:14 -0800 (PST) From: Xingqiu Xu To: alexs@kernel.org, si.yanteng@linux.dev Cc: dzm91@hust.edu.cn, corbet@lwn.net, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Xingqiu Xu Subject: [PATCH 5/7] docs/zh_CN: Translate timers/highres.rst Date: Fri, 19 Dec 2025 07:16:47 +0800 Message-Id: <55557a6d914e941b3b018599b0e017fc93ef5c50.1766099040.git.hilbertanjou83@gmail.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .../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.rst new file mode 100644 index 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 + +========================================== +高分辨率定时器和动态时钟刻度设计笔记 +========================================== + +可以在 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.rst index 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