Commit c6804c6a authored by Bagas Sanjaya's avatar Bagas Sanjaya Committed by Jonathan Corbet
Browse files

Documentation: taskstats: Reindent payload kinds list 



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: default avatarBagas Sanjaya <bagasdotme@gmail.com>
Reviewed-by: default avatarRandy Dunlap <rdunlap@infradead.org>
Tested-by: default avatarRandy Dunlap <rdunlap@infradead.org>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
Message-ID: <20251104130751.22755-1-bagasdotme@gmail.com>
parent 1f37cae5

Documentation/accounting/taskstats.rst

+28 −26
Original line number Diff line number Diff line
@@ -85,19 +85,19 @@ consist of one attribute, of type 
   TASKSTATS_CMD_ATTR_REGISTER/DEREGISTER_CPUMASK and contain a cpumask in the

   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

the cpumask would be "1-3,5,7-8". If userspace forgets to deregister interest

in cpus before closing the listening socket, the kernel cleans up its interest

set over time. However, for the sake of efficiency, an explicit deregistration

is advisable.

   the cpumask would be "1-3,5,7-8". If userspace forgets to deregister

   interest in cpus before closing the listening socket, the kernel cleans up

   its interest set over time. However, for the sake of efficiency, an explicit

   deregistration is advisable.



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:



a) TASKSTATS_TYPE_AGGR_PID/TGID : attribute containing no payload but indicates

a pid/tgid will be followed by some stats.

   a) TASKSTATS_TYPE_AGGR_PID/TGID: attribute containing no payload but

      indicates a pid/tgid will be followed by some stats.



b) TASKSTATS_TYPE_PID/TGID: attribute whose payload is the pid/tgid whose stats

are being returned.

   b) TASKSTATS_TYPE_PID/TGID: attribute whose payload is the pid/tgid whose

      stats are being returned.



   c) TASKSTATS_TYPE_STATS: attribute with a struct taskstats as payload. The

      same structure is used for both per-pid and per-tgid stats.
@@ -108,9 +108,11 @@ same structure is used for both per-pid and per-tgid stats. 
   a) TASKSTATS_TYPE_AGGR_PID: indicates next two attributes will be pid+stats

   b) TASKSTATS_TYPE_PID: contains exiting task's pid

   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

      tgid+stats

   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

   f) TASKSTATS_TYPE_STATS: contains the per-tgid stats for exiting task's

      process





per-tgid stats