From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f41.google.com (mail-wr1-f41.google.com [209.85.221.41]) (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 E164D397B1B for ; Wed, 12 Aug 2026 06:59:29 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.41 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786517971; cv=none; b=X8pnsSNMHnLgrWs0tHL7Yv8WOtzUypiVpuzROIOAvoCEcXNbjveLrMOp4Auyo6+XEl0oRvXgNpdaruRByuk0IXgAkQkmOnJHT3gVAjcCzV5SMT2UDO4cUtpQR7KSY69Ks4KIpLOret58iZ0oUy+ZjZ2vbtScT/wovnkNBISO5U8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786517971; c=relaxed/simple; bh=B3epYLxfoVoXfinQU6yOnyaTqA1uv7xJ3fU2PNRA69A=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=a20ipnCUKMkG/hg2YGSBJxqFzd0kB/fOWcbrA6m0iFL/K0GGHPpSHHKYmt567HKeMdz6YokJS66DnqPgzJ2lf6CKWDVdXqBV0wbX2VYcB/YSdvQ7m/SWJPTXMW5M9S3yG4DbBRkrI6pI0S3Mr+WtSChV0PeRx1a54NHYDGKBOE0= 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=oaWCQZm5; arc=none smtp.client-ip=209.85.221.41 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="oaWCQZm5" Received: by mail-wr1-f41.google.com with SMTP id ffacd0b85a97d-47f502ff678so64074f8f.0 for ; Tue, 11 Aug 2026 23:59:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786517968; x=1787122768; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:references :in-reply-to:message-id:date:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to:content-type; bh=zz4SgHtAmy0qQncUtL+GMZmlzcvWPiSx3o95/DRT6g4=; b=oaWCQZm5PFaFgqJeXPhLgkDOwkSu5whQf8y8rj+LzmXsPppatQBFj9wGdD8m/oZK2/ ptfkOtRWdxSOcxtr6JLIAs78KOTm5CmRDhJoGwavvWRYKPS3oc4s43tQcDaiaPE4LQ6X 8abKmJf1S5M5usI0OUCTmrYqETMQwQikiyF4zNPQW58JXQ0qNf43oGh55eQQpe/8+T7K co1Whbe6je+5vaIGjUmcAlyB6f6lysH1RcdGMT8EAS8mGmGKFmmSEZZJ9nd3PAir8RL4 ln1t/ium+uBPVt3ABV1zKG7y5BlBdevgm3k7lv9Mij9EmmZ2fMnGdJf7fZseVJyUXvQB ONQQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786517968; x=1787122768; h=content-transfer-encoding:content-type: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 :content-type; bh=zz4SgHtAmy0qQncUtL+GMZmlzcvWPiSx3o95/DRT6g4=; b=IRIY4V6ZeMrc0tQmgK0Qbkh0xZqJusxmM+4pwsAtVFLYMRJGKqCMQWFUnjGTMdvRcz BH+gj2Xyw3G2il644qpcizEgWuHEau1eFRUEe7wm9KSHD9vZ6p/w1JCXlrZgPwqj4ShB SQTIHW/x9GjKfcCe8HNt8tLLEn55YwvTavCfteOYVYGTaUjm+O4vl7qGRawwT0ShawiZ Ue3Cs3pUqxqKrl6MEyJdhUuUTScw+MegeuI4Wbe5yW4KYnjLG3rh8ehwZw2i5f/qDrxu r9iKi3Pp9+TxTL0YKyuUjsAkiLKYy0YSEbSJCWoSy3SfLt3mQkYcUno8HjqnZTtLjp5y HBqQ== X-Forwarded-Encrypted: i=1; AHgh+Rp4aoukdzS6uy577O/IiaD08TOJQQ819UlyT7uyQZ0w66WY5MJKu84xdS/+6rr30kGF1aeLt+z5d0X+76I=@vger.kernel.org X-Gm-Message-State: AOJu0YzZZkCNThoA5k0LQD6STyeW/JiixW6AI/SQkOW3y+ZY6U+s96gj mr3m/QHvcGxg+HOhYTLJzJ4f2req3GUU5+HOmDxufQmrW8a0UyB8ykds X-Gm-Gg: AR+sD13qVLiqrXse/qKS50ZLG8uTHB8b7u9s5HlwS/cZ9ilGVzeMbBXCug/XOEOjEq/ G+vsdRWEosP/dHJ6bAOpc7ofqo5tsxHtLkZKL68mOeNgdWZdTT3GcQMqHe5XarGb241WHcgOtbU fd6kkwQC9lXZT38SxpJ9GhN8ueSzqzZXwOmMKIOBk9F/XKqA5PerwOKy+lZA1t47kNhhcUa4XJD u6Fpx/OvD79Wm2kXhcBqZ/O7AsR1akwSzOI7wzOn6hMTpqCCgeTdAuZkGKFvvfG/byLwXfgiqOf 7+K9gLMGA8aLSzKoTA82s0J+Afjnm41XDszJ5hj1LoUO9LR9U+lh3NXlEsYYwsM7CMfTc3ctDWx KbK14R6pCH9cNGoOKMnuVN45fA4yEt+HIOaX2sZbsSxIJNejeLWojbV1JSsqkqG+oUPK/gB8v6Q x7Hv9A33rz6tRGgrsC3FX9tp1SP/yphbfEcVyvXf+Uxrd3aaaIw7UlkZSQMlXd/cpkgWALm7qEj UmdWqhXHI7fxh+HtJxc6Y3QlLfNqBAE1Ka3DQkfRjzfrfDKx+JAAMtcv85ZDBC2uLpPc6lfCZ9u xq0YyxEhhqVvxtTdn1VdUYAmsTQIAB9eQAO9mA6F0a3+gQ== X-Received: by 2002:a05:600c:1c25:b0:498:1371:660c with SMTP id 5b1f17b1804b1-4997bf8879dmr16236365e9.0.1786517967920; Tue, 11 Aug 2026 23:59:27 -0700 (PDT) Received: from doehyun-dev.pradel.rg.cispa.de (x06.xlate.fw.cispa.de. [195.37.157.6]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4997b15b807sm73628005e9.7.2026.08.11.23.59.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 11 Aug 2026 23:59:27 -0700 (PDT) From: Doehyun Baek To: Alex Shi , Yanteng Si Cc: Doehyun Baek , Dongliang Mu , SJ Park , Jonathan Corbet , Shuah Khan , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v7 2/7] docs/zh_CN: add DAMON_STAT usage translation Date: Wed, 12 Aug 2026 06:59:06 +0000 Message-ID: <20260812065914.3071433-3-doehyunbaek@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260812065914.3071433-1-doehyunbaek@gmail.com> References: <20260812065914.3071433-1-doehyunbaek@gmail.com> 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 .../admin-guide/mm/damon/stat.rst into Chinese. Update the translation through commit c9380cdd949d ("Docs/{admin-guide,mm}/damon: fix DAMON documentation details"). Signed-off-by: Doehyun Baek --- .../zh_CN/admin-guide/mm/damon/stat.rst | 94 +++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 Documentation/translations/zh_CN/admin-guide/mm/damon/stat.rst diff --git a/Documentation/translations/zh_CN/admin-guide/mm/damon/stat.rst b/Documentation/translations/zh_CN/admin-guide/mm/damon/stat.rst new file mode 100644 index 000000000000..129748a5ea1f --- /dev/null +++ b/Documentation/translations/zh_CN/admin-guide/mm/damon/stat.rst @@ -0,0 +1,94 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../../disclaimer-zh_CN.rst + +:Original: Documentation/admin-guide/mm/damon/stat.rst + +:翻译: + + Doehyun Baek + +==================== +数据访问监测结果统计 +==================== + +数据访问监测结果统计(DAMON_STAT)是一个静态内核模块,旨在用于简单的 +访问模式监测。它使用 DAMON 监测系统整个物理内存上的访问,并提供简化的 +访问监测结果统计,即空闲时间百分位数和估计的内存带宽。 + +.. _damon_stat_monitoring_accuracy_overhead_zh_CN: + +监测精度和开销 +============== + +DAMON_STAT 使用监测间隔 +:ref:`自动调优 ` 来提高 +精度并最小化开销。它会自动调优间隔,目标是在每个快照中捕获 4 % 的 +可观测访问事件,同时将得到的采样间隔限制在最小 5 毫秒、最大 10 秒。 +在少数生产服务器系统上,它的结果是只消耗 0.x % 的单个 CPU 时间,同时 +捕获质量合理的访问模式。调优得到的间隔可以通过 +``aggr_interval_us`` :ref:`参数 ` 获取。 + +接口:模块参数 +============== + +要使用这个功能,首先应确保你的系统运行在构建时启用了 +``CONFIG_DAMON_STAT=y`` 的内核上。通过将 +``CONFIG_DAMON_STAT_ENABLED_DEFAULT`` 设置为 true,可以在构建时默认 +启用该功能。 + +为了让系统管理员在启动时和/或运行时启用或禁用它,并读取监测结果, +DAMON_STAT 提供了模块参数。下面的章节描述这些参数。 + +enabled +------- + +启用或禁用 DAMON_STAT。 + +你可以将该参数的值设置为 ``Y`` 来启用 DAMON_STAT。设置为 ``N`` 会 +禁用 DAMON_STAT。默认值由 ``CONFIG_DAMON_STAT_ENABLED_DEFAULT`` 构建 +配置选项设置。 + +请注意,该模块(damon_stat)不能与其他基于 DAMON 的专用模块同时运行。 +更多细节请参考 :ref:`DAMON 设计文档的专用模块互斥性 `。 + +.. _damon_stat_aggr_interval_us_zh_CN: + +aggr_interval_us +---------------- + +自动调优后的聚集时间间隔,单位是微秒。 + +用户可以读取 DAMON_STAT 使用的 DAMON 实例的聚集间隔。它会被 +:ref:`自动调优 `,因此该值 +会动态变化。 + +estimated_memory_bandwidth +-------------------------- + +系统的估计内存带宽消耗(字节/秒)。 + +DAMON_STAT 读取当前 DAMON 结果快照上的观测访问事件,并将其转换为以 +字节/秒为单位的内存带宽消耗估计。得到的指标通过这个只读参数向用户 +公开。由于 DAMON 使用采样,所以这只是访问强度的估计,而不是精确的 +内存带宽。 + +memory_idle_ms_percentiles +-------------------------- + +系统的逐字节空闲时间(毫秒)百分位数。 + +DAMON_STAT 基于当前 DAMON 结果快照,计算内存中每个字节到现在为止未被 +访问的时间(空闲时间)。对于访问频率(nr_accesses)大于零的区域,当前 +访问频率水平保持的时间乘以 ``-1``,就是该区域每个字节的空闲时间。如果 +某个区域的访问频率(nr_accesses)为零,则该区域保持零访问频率的时间 +(age)就是该区域每个字节的空闲时间。然后,DAMON_STAT 通过这个只读参数 +公开空闲时间值的百分位数。读取该参数会返回 101 个以毫秒为单位、用逗号 +分隔的空闲时间值。每个值分别表示第 0、第 1、第 2、第 3、……、第 99 和 +第 100 百分位的空闲时间。 + +kdamond_pid +----------- + +DAMON 线程的 PID。 + +如果 DAMON_STAT 已启用,这将成为工作线程的 PID。否则为 -1。 -- 2.43.0