torvalds/linux
3
0
Fork 0
mirror of git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git synced 2026-03-22 07:27:12 +08:00
Code Issues Packages Projects Releases Wiki Activity

Documentation: taskstats: Reindent payload kinds list

Browse Source 
Payload kinds list text is indented at the first text column, rather
than aligned to the list number. As an effect, the third item becomes
sublist of second item's third sublist item (TASKTYPE_TYPE_STATS).

Reindent the list text.

Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20251104130751.22755-1-bagasdotme@gmail.com>
This commit is contained in:
Bagas Sanjaya
2025-11-04 20:07:50 +07:00
committed by Jonathan Corbet
parent 1f37cae5d1
commit c6804c6af9
1 changed files with 27 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
Documentation/accounting/taskstats.rst
View File

@@ -76,41 +76,43 @@ The messages are in the format::
The taskstats payload is one of the following three kinds: The taskstats payload is one of the following three kinds:
1. Commands: Sent from user to kernel. Commands to get data on 1. Commands: Sent from user to kernel. Commands to get data on
a pid/tgid consist of one attribute, of type TASKSTATS_CMD_ATTR_PID/TGID, a pid/tgid consist of one attribute, of type TASKSTATS_CMD_ATTR_PID/TGID,
containing a u32 pid or tgid in the attribute payload. The pid/tgid denotes containing a u32 pid or tgid in the attribute payload. The pid/tgid denotes
the task/process for which userspace wants statistics. the task/process for which userspace wants statistics.
Commands to register/deregister interest in exit data from a set of cpus Commands to register/deregister interest in exit data from a set of cpus
consist of one attribute, of type consist of one attribute, of type
TASKSTATS_CMD_ATTR_REGISTER/DEREGISTER_CPUMASK and contain a cpumask in the TASKSTATS_CMD_ATTR_REGISTER/DEREGISTER_CPUMASK and contain a cpumask in the
attribute payload. The cpumask is specified as an ascii string of attribute payload. The cpumask is specified as an ascii string of
comma-separated cpu ranges e.g. to listen to exit data from cpus 1,2,3,5,7,8 comma-separated cpu ranges e.g. to listen to exit data from cpus 1,2,3,5,7,8
the cpumask would be "1-3,5,7-8". If userspace forgets to deregister interest the cpumask would be "1-3,5,7-8". If userspace forgets to deregister
in cpus before closing the listening socket, the kernel cleans up its interest interest in cpus before closing the listening socket, the kernel cleans up
set over time. However, for the sake of efficiency, an explicit deregistration its interest set over time. However, for the sake of efficiency, an explicit
is advisable. deregistration is advisable.
2. Response for a command: sent from the kernel in response to a userspace 2. Response for a command: sent from the kernel in response to a userspace
command. The payload is a series of three attributes of type: command. The payload is a series of three attributes of type:
a) TASKSTATS_TYPE_AGGR_PID/TGID : attribute containing no payload but indicates a) TASKSTATS_TYPE_AGGR_PID/TGID: attribute containing no payload but
a pid/tgid will be followed by some stats. indicates a pid/tgid will be followed by some stats.
b) TASKSTATS_TYPE_PID/TGID: attribute whose payload is the pid/tgid whose stats b) TASKSTATS_TYPE_PID/TGID: attribute whose payload is the pid/tgid whose
are being returned. stats are being returned.
c) TASKSTATS_TYPE_STATS: attribute with a struct taskstats as payload. The c) TASKSTATS_TYPE_STATS: attribute with a struct taskstats as payload. The
same structure is used for both per-pid and per-tgid stats. same structure is used for both per-pid and per-tgid stats.
3. New message sent by kernel whenever a task exits. The payload consists of a 3. New message sent by kernel whenever a task exits. The payload consists of a
series of attributes of the following type: series of attributes of the following type:
a) TASKSTATS_TYPE_AGGR_PID: indicates next two attributes will be pid+stats a) TASKSTATS_TYPE_AGGR_PID: indicates next two attributes will be pid+stats
b) TASKSTATS_TYPE_PID: contains exiting task's pid b) TASKSTATS_TYPE_PID: contains exiting task's pid
c) TASKSTATS_TYPE_STATS: contains the exiting task's per-pid stats c) TASKSTATS_TYPE_STATS: contains the exiting task's per-pid stats
d) TASKSTATS_TYPE_AGGR_TGID: indicates next two attributes will be tgid+stats d) TASKSTATS_TYPE_AGGR_TGID: indicates next two attributes will be
e) TASKSTATS_TYPE_TGID: contains tgid of process to which task belongs tgid+stats
f) TASKSTATS_TYPE_STATS: contains the per-tgid stats for exiting task's process e) TASKSTATS_TYPE_TGID: contains tgid of process to which task belongs
f) TASKSTATS_TYPE_STATS: contains the per-tgid stats for exiting task's
process
per-tgid stats per-tgid stats