Re: [PATCH] docs/zh_CN: Add sched-stats Chinese translation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Tang Yizhou <tangyizhou@xxxxxxxxxx> 于2022年3月8日周二 09:33写道:
>
> Translate scheduler/sched-stats.rst into Chinese.
>
> Signed-off-by: Tang Yizhou <tangyizhou@xxxxxxxxxx>
> ---
>  .../translations/zh_CN/scheduler/index.rst    |   3 +-
>  .../zh_CN/scheduler/sched-stats.rst           | 156 ++++++++++++++++++
>  2 files changed, 157 insertions(+), 2 deletions(-)
>  create mode 100644 Documentation/translations/zh_CN/scheduler/sched-stats.rst
>
> diff --git a/Documentation/translations/zh_CN/scheduler/index.rst b/Documentation/translations/zh_CN/scheduler/index.rst
> index ab7925980266..c020f8382785 100644
> --- a/Documentation/translations/zh_CN/scheduler/index.rst
> +++ b/Documentation/translations/zh_CN/scheduler/index.rst
> @@ -25,14 +25,13 @@ Linux调度器
>      sched-domains
>      sched-capacity
>      sched-energy
> -
> +    sched-stats
>
>  TODOList:
>
>      sched-deadline
>      sched-nice-design
>      sched-rt-group
> -    sched-stats
>
>      text_files
>
> diff --git a/Documentation/translations/zh_CN/scheduler/sched-stats.rst b/Documentation/translations/zh_CN/scheduler/sched-stats.rst
> new file mode 100644
> index 000000000000..c958630e23db
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/scheduler/sched-stats.rst
> @@ -0,0 +1,156 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/scheduler/sched-stats.rst
> +
> +:翻译:
> +
> +  唐艺舟 Tang Yizhou <tangyeechou@xxxxxxxxx>
> +
> +==============
> +调度器统计数据
> +==============
> +
> +第15版schedstats去掉了sched_yield的一些计数器:yld_exp_empty,yld_act_empty
> +和yld_both_empty。在其它方面和第14版完全相同。
> +
> +第14版schedstats包括对sched_domains(译注:调度域)的支持,该特性进入内核
> +主线2.6.20,不过这一版schedstats与2.6.13-2.6.19内核的版本12的统计数据是完全
> +相同的(内核未发布第13版)。有些计数器按每个运行队列统计更有意义,其它则是按
> +每个调度域统计更有意义。注意,调度域(以及它们的附属信息)仅在开启CONFIG_SMP
> +的机器上相关和可用。
的机器上是相关的和可使用的。 pertinent and available are adj.

how about:
pertinent -> 有意义的?

for others.
Reviewed-by: Yanteng Si <siyanteng@xxxxxxxxxxx>

Thanks,
Yanteng
> +
> +在第14版schedstat中,每个被列出的CPU至少会有一级域统计数据,且很可能有一个
> +以上的域。在这个实现中,域没有特别的名字,但是编号最高的域通常在机器上所有的
> +CPU上仲裁平衡,而domain0是最紧密聚焦的域,有时仅在一对CPU之间进行平衡。此时,
> +没有任何体系结构需要3层以上的域。域统计数据中的第一个字段是一个位图,表明哪些
> +CPU受该域的影响。
> +
> +这些字段是计数器,而且只能递增。使用这些字段的程序将需要从基线观测开始,然后在
> +后续每一个观测中计算出计数器的变化。一个能以这种方式处理其中很多字段的perl脚本
> +可见
> +
> +    http://eaglet.pdxhosts.com/rick/linux/schedstat/
> +
> +请注意,任何这样的脚本都必须是特定于版本的,改变版本的主要原因是输出格式的变化。
> +对于那些希望编写自己的脚本的人,可以参考这里描述的各个字段。
> +
> +CPU统计数据
> +-----------
> +cpu<N> 1 2 3 4 5 6 7 8 9
> +
> +第一个字段是sched_yield()的统计数据:
> +
> +     1) sched_yield()被调用了#次
> +
> +接下来的三个是schedule()的统计数据:
> +
> +     2) 这个字段是一个过时的数组过期计数,在O(1)调度器中使用。为了ABI兼容性,
> +       我们保留了它,但它总是被设置为0。
> +     3) schedule()被调用了#次
> +     4) 调用schedule()导致处理器变为空闲了#次
> +
> +接下来的两个是try_to_wake_up()的统计数据:
> +
> +     5) try_to_wake_up()被调用了#次
> +     6) 调用try_to_wake_up()导致本地CPU被唤醒了#次
> +
> +接下来的三个统计数据描述了调度延迟:
> +
> +     7) 本处理器运行任务的总时间,单位是jiffies
> +     8) 本处理器任务等待运行的时间,单位是jiffies
> +     9) 本CPU运行了#个时间片
> +
> +域统计数据
> +----------
> +
> +对于每个被描述的CPU,和它相关的每一个调度域均会产生下面一行数据(注意,如果
> +CONFIG_SMP没有被定义,那么*没有*调度域被使用,这些行不会出现在输出中)。
> +
> +domain<N> <cpumask> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36
> +
> +第一个字段是一个位掩码,表明该域在操作哪些CPU。
> +
> +接下来的24个字段是load_balance()函数的各个统计数据,按空闲类型分组(空闲,
> +繁忙,新空闲):
> +
> +
> +    1)  当CPU空闲时,load_balance()在这个调度域中被调用了#次
> +    2)  当CPU空闲时,load_balance()在这个调度域中被调用,但是发现负载无需
> +        均衡#次
> +    3)  当CPU空闲时,load_balance()在这个调度域中被调用,试图迁移1个或更多
> +        任务且失败了#次
> +    4)  当CPU空闲时,load_balance()在这个调度域中被调用,发现不均衡(如果有)
> +        #次
> +    5)  当CPU空闲时,pull_task()在这个调度域中被调用#次
> +    6)  当CPU空闲时,尽管目标任务是热缓存状态,pull_task()依然被调用#次
> +    7)  当CPU空闲时,load_balance()在这个调度域中被调用,未能找到更繁忙的
> +        队列#次
> +    8)  当CPU空闲时,在调度域中找到了更繁忙的队列,但未找到更繁忙的调度组
> +        #次
> +    9)  当CPU繁忙时,load_balance()在这个调度域中被调用了#次
> +    10) 当CPU繁忙时,load_balance()在这个调度域中被调用,但是发现负载无需
> +        均衡#次
> +    11) 当CPU繁忙时,load_balance()在这个调度域中被调用,试图迁移1个或更多
> +        任务且失败了#次
> +    12) 当CPU繁忙时,load_balance()在这个调度域中被调用,发现不均衡(如果有)
> +        #次
> +    13) 当CPU繁忙时,pull_task()在这个调度域中被调用#次
> +    14) 当CPU繁忙时,尽管目标任务是热缓存状态,pull_task()依然被调用#次
> +    15) 当CPU繁忙时,load_balance()在这个调度域中被调用,未能找到更繁忙的
> +        队列#次
> +    16) 当CPU繁忙时,在调度域中找到了更繁忙的队列,但未找到更繁忙的调度组
> +        #次
> +    17) 当CPU新空闲时,load_balance()在这个调度域中被调用了#次
> +    18) 当CPU新空闲时,load_balance()在这个调度域中被调用,但是发现负载无需
> +        均衡#次
> +    19) 当CPU新空闲时,load_balance()在这个调度域中被调用,试图迁移1个或更多
> +        任务且失败了#次
> +    20) 当CPU新空闲时,load_balance()在这个调度域中被调用,发现不均衡(如果有)
> +        #次
> +    21) 当CPU新空闲时,pull_task()在这个调度域中被调用#次
> +    22) 当CPU新空闲时,尽管目标任务是热缓存状态,pull_task()依然被调用#次
> +    23) 当CPU新空闲时,load_balance()在这个调度域中被调用,未能找到更繁忙的
> +        队列#次
> +    24) 当CPU新空闲时,在调度域中找到了更繁忙的队列,但未找到更繁忙的调度组
> +        #次
> +
> +接下来的3个字段是active_load_balance()函数的各个统计数据:
> +
> +    25) active_load_balance()被调用了#次
> +    26) active_load_balance()被调用,试图迁移1个或更多任务且失败了#次
> +    27) active_load_balance()被调用,成功迁移了#次任务
> +
> +接下来的3个字段是sched_balance_exec()函数的各个统计数据:
> +
> +    28) sbe_cnt不再被使用
> +    29) sbe_balanced不再被使用
> +    30) sbe_pushed不再被使用
> +
> +接下来的3个字段是sched_balance_fork()函数的各个统计数据:
> +
> +    31) sbf_cnt不再被使用
> +    32) sbf_balanced不再被使用
> +    33) sbf_pushed不再被使用
> +
> +接下来的3个字段是try_to_wake_up()函数的各个统计数据:
> +
> +    34) 在这个调度域中调用try_to_wake_up()唤醒任务时,任务在调度域中一个
> +        和上次运行不同的新CPU上运行了#次
> +    35) 在这个调度域中调用try_to_wake_up()唤醒任务时,任务被迁移到发生唤醒
> +        的CPU次数为#,因为该任务在原CPU是冷缓存状态
> +    36) 在这个调度域中调用try_to_wake_up()唤醒任务时,引发被动负载均衡#次
> +
> +/proc/<pid>/schedstat
> +---------------------
> +schedstats还添加了一个新的/proc/<pid>/schedstat文件,来提供一些进程级的
> +相同信息。这个文件中,有三个字段与该进程相关:
> +
> +     1) 在CPU上运行花费的时间
> +     2) 在运行队列上等待的时间
> +     3) 在CPU上运行了#个时间片
> +
> +可以很容易地编写一个程序,利用这些额外的字段来报告一个特定的进程或一组进程在
> +调度器策略下的表现如何。这样的程序的一个简单版本可在下面的链接找到
> +
> +    http://eaglet.pdxhosts.com/rick/linux/schedstat/v12/latency.c
> --
> 2.17.1
>




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux