1 ====================
2 The struct taskstats
3 ====================
4
5 This document contains an explanation of the s
6
7 There are three different groups of fields in
8
9 1) Common and basic accounting fields
10 If CONFIG_TASKSTATS is set, the taskstats
11 the common fields and basic accounting fie
12 delivery at do_exit() of a task.
13 2) Delay accounting fields
14 These fields are placed between::
15
16 /* Delay accounting fields start */
17
18 and::
19
20 /* Delay accounting fields end */
21
22 Their values are collected if CONFIG_TASK_
23 3) Extended accounting fields
24 These fields are placed between::
25
26 /* Extended accounting fields start */
27
28 and::
29
30 /* Extended accounting fields end */
31
32 Their values are collected if CONFIG_TASK_
33
34 4) Per-task and per-thread context switch coun
35
36 5) Time accounting for SMT machines
37
38 6) Extended delay accounting fields for memory
39
40 Future extension should add fields to the end
41 should not change the relative position of eac
42
43 ::
44
45 struct taskstats {
46
47 1) Common and basic accounting fields::
48
49 /* The version number of this struct.
50 * TAKSTATS_VERSION, which is defined
51 * Each time the struct is changed, th
52 */
53 __u16 version;
54
55 /* The exit code of a task. */
56 __u32 ac_exitcode; /* Exi
57
58 /* The accounting flags of a task as d
59 * Defined values are AFORK, ASU, ACOM
60 */
61 __u8 ac_flag; /* Rec
62
63 /* The value of task_nice() of a task.
64 __u8 ac_nice; /* tas
65
66 /* The name of the command that starte
67 char ac_comm[TS_COMM_LEN]; /* Com
68
69 /* The scheduling discipline as set in
70 __u8 ac_sched; /* Sch
71
72 __u8 ac_pad[3];
73 __u32 ac_uid; /* Use
74 __u32 ac_gid; /* Gro
75 __u32 ac_pid; /* Pro
76 __u32 ac_ppid; /* Par
77
78 /* The time when a task begins, in [se
79 __u32 ac_btime; /* Beg
80
81 /* The elapsed time of a task, in [use
82 __u64 ac_etime; /* Ela
83
84 /* The user CPU time of a task, in [us
85 __u64 ac_utime; /* Use
86
87 /* The system CPU time of a task, in [
88 __u64 ac_stime; /* Sys
89
90 /* The minor page fault count of a tas
91 __u64 ac_minflt; /* Min
92
93 /* The major page fault count of a tas
94 __u64 ac_majflt; /* Maj
95
96
97 2) Delay accounting fields::
98
99 /* Delay accounting fields start
100 *
101 * All values, until the comment "Dela
102 * available only if delay accounting
103 * few fields are not delays
104 *
105 * xxx_count is the number of delay va
106 * xxx_delay_total is the correspondin
107 *
108 * xxx_delay_total wraps around to zer
109 * xxx_count incremented regardless of
110 */
111
112 /* Delay waiting for cpu, while runnab
113 * count, delay_total NOT updated atom
114 */
115 __u64 cpu_count;
116 __u64 cpu_delay_total;
117
118 /* Following four fields atomically up
119
120 /* Delay waiting for synchronous block
121 * does not account for delays in I/O
122 */
123 __u64 blkio_count;
124 __u64 blkio_delay_total;
125
126 /* Delay waiting for page fault I/O (s
127 __u64 swapin_count;
128 __u64 swapin_delay_total;
129
130 /* cpu "wall-clock" running time
131 * On some architectures, value will a
132 * from the kernel in involuntary wait
133 * Value is cumulative, in nanoseconds
134 * and wraps around to zero silently o
135 */
136 __u64 cpu_run_real_total;
137
138 /* cpu "virtual" running time
139 * Uses time intervals seen by the ker
140 * for kernel's involuntary waits due
141 * Value is cumulative, in nanoseconds
142 * and wraps around to zero silently o
143 */
144 __u64 cpu_run_virtual_total;
145 /* Delay accounting fields end */
146 /* version 1 ends here */
147
148
149 3) Extended accounting fields::
150
151 /* Extended accounting fields start */
152
153 /* Accumulated RSS usage in duration o
154 * The current rss usage is added to t
155 * a tick is charged to a task's syste
156 * will have memory usage multiplied b
157 * average usage per system time unit
158 */
159 __u64 coremem; /* acc
160
161 /* Accumulated virtual memory usage in
162 * Same as acct_rss_mem1 above except
163 */
164 __u64 virtmem; /* acc
165
166 /* High watermark of RSS usage in dura
167 __u64 hiwater_rss; /* Hig
168
169 /* High watermark of VM usage in dura
170 __u64 hiwater_vm; /* Hig
171
172 /* The following four fields are I/O s
173 __u64 read_char; /* byt
174 __u64 write_char; /* byt
175 __u64 read_syscalls; /* rea
176 __u64 write_syscalls; /* wri
177
178 /* Extended accounting fields end */
179
180 4) Per-task and per-thread statistics::
181
182 __u64 nvcsw; /* Con
183 __u64 nivcsw; /* Con
184
185 5) Time accounting for SMT machines::
186
187 __u64 ac_utimescaled; /* uti
188 __u64 ac_stimescaled; /* sti
189 __u64 cpu_scaled_run_real_total; /*
190
191 6) Extended delay accounting fields for memory
192
193 /* Delay waiting for memory reclaim */
194 __u64 freepages_count;
195 __u64 freepages_delay_total;
196
197 ::
198
199 }
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.