Documentation/translations/zh_CN/accounting/taskstats.rst

Source file repositories/reference/linux-study-clean/Documentation/translations/zh_CN/accounting/taskstats.rst

File Facts

System
Linux kernel
Corpus path
Documentation/translations/zh_CN/accounting/taskstats.rst
Extension
.rst
Size
7182 bytes
Lines
146
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. include:: ../disclaimer-zh_CN.rst

:Original: Documentation/accounting/taskstats.rst

:Translator: Yang Yang <yang.yang29@zte.com.cn>

================
每任务的统计接口
================

Taskstats是一个基于netlink的接口，用于从内核向用户空间发送每任务及每进程的
统计信息。

Taskstats设计目的：

- 在任务生命周期内和退出时高效的提供统计信息
- 统一不同计数子系统的接口
- 支持未来计数系统的扩展

术语
----

“pid”、“tid”、“任务”互换使用，用于描述由struct task_struct定义的标准
Linux任务。“每pid的统计数据”等价于“每任务的统计数据”。

“tgid”、“进程”、“线程组”互换使用，用于描述共享mm_struct的任务集，
也就是传统的Unix进程。尽管使用了tgid这个词，即使一个任务是线程组组长，
对它的处理也没有什么不同。只要一个进程还有任何归属它的任务，它就被认为
活着。

用法
----

为了在任务生命周期内获得统计信息，用户空间需打开一个单播的netlink套接字
（NETLINK_GENERIC族）然后发送指定pid或tgid的命令。响应消息中包含单个
任务的统计信息（若指定了pid）或进程所有任务汇总的统计信息（若指定了tgid）。

为了在任务退出时获取统计信息，用户空间的监听者发送一个指定cpu掩码的注册命令。
cpu掩码内的cpu上有任务退出时，每pid的统计信息将发送给注册成功的监听者。使用
cpu掩码可以限制一个监听者收到的数据，并有助于对netlink接口进行流量控制，后文
将进行更详细的解释。

如果正在退出的任务是线程组中最后一个退出的线程，额外一条包含每tgid统计信息的
记录也将发送给用户空间。后者包含线程组中所有线程（包括过去和现在）的每pid统计
信息总和。

getdelays.c是一个简单的示例，用以演示如何使用taskstats接口获取延迟统计信息。
用户可注册cpu掩码、发送命令和处理响应、监听每tid/tgid退出数据、将收到的数据
写入文件、通过增大接收缓冲区进行基本的流量控制。

接口
----

内核用户接口封装在include/linux/taskstats.h。

为避免本文档随着接口的演进而过期，本文仅给出当前版本的概要。当本文与taskstats.h
不一致时，以taskstats.h为准。

struct taskstats是每pid和每tgid数据共用的计数结构体。它是版本化的，可在内核新增
计数子系统时进行扩展。taskstats.h中定义了各字段及语义。

用户、内核空间的数据交换是属于NETLINK_GENERIC族的netlink消息，使用netlink属性
接口。消息格式如下::

    +----------+- - -+-------------+-------------------+
    | nlmsghdr | Pad |  genlmsghdr | taskstats payload |
    +----------+- - -+-------------+-------------------+

Taskstats载荷有三种类型：

Annotation

Implementation Notes