Blame view

Documentation/cgroups/cpuacct.txt 1.93 KB
934352f21   Bharata B Rao   sched: add hierar...
1
2
3
4
5
6
7
8
9
10
11
  CPU Accounting Controller
  -------------------------
  
  The CPU accounting controller is used to group tasks using cgroups and
  account the CPU usage of these groups of tasks.
  
  The CPU accounting controller supports multi-hierarchy groups. An accounting
  group accumulates the CPU usage of all of its child groups and the tasks
  directly present in its group.
  
  Accounting groups can be created by first mounting the cgroup filesystem.
f6e07d380   Jörg Sommer   Documentation: up...
12
13
14
15
16
17
18
  # mount -t cgroup -ocpuacct none /sys/fs/cgroup
  
  With the above step, the initial or the parent accounting group becomes
  visible at /sys/fs/cgroup. At bootup, this group includes all the tasks in
  the system. /sys/fs/cgroup/tasks lists the tasks in this cgroup.
  /sys/fs/cgroup/cpuacct.usage gives the CPU time (in nanoseconds) obtained
  by this group which is essentially the CPU time obtained by all the tasks
934352f21   Bharata B Rao   sched: add hierar...
19
  in the system.
f6e07d380   Jörg Sommer   Documentation: up...
20
  New accounting groups can be created under the parent group /sys/fs/cgroup.
934352f21   Bharata B Rao   sched: add hierar...
21

f6e07d380   Jörg Sommer   Documentation: up...
22
  # cd /sys/fs/cgroup
934352f21   Bharata B Rao   sched: add hierar...
23
  # mkdir g1
e47f9d84e   Wanlong Gao   Documentation: fi...
24
  # echo $$ > g1/tasks
934352f21   Bharata B Rao   sched: add hierar...
25
26
27
28
  
  The above steps create a new group g1 and move the current shell
  process (bash) into it. CPU time consumed by this bash and its children
  can be obtained from g1/cpuacct.usage and the same is accumulated in
f6e07d380   Jörg Sommer   Documentation: up...
29
  /sys/fs/cgroup/cpuacct.usage also.
ef12fefab   Bharata B Rao   cpuacct: add per-...
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
  
  cpuacct.stat file lists a few statistics which further divide the
  CPU time obtained by the cgroup into user and system times. Currently
  the following statistics are supported:
  
  user: Time spent by tasks of the cgroup in user mode.
  system: Time spent by tasks of the cgroup in kernel mode.
  
  user and system are in USER_HZ unit.
  
  cpuacct controller uses percpu_counter interface to collect user and
  system times. This has two side effects:
  
  - It is theoretically possible to see wrong values for user and system times.
    This is because percpu_counter_read() on 32bit systems isn't safe
    against concurrent writes.
  - It is possible to see slightly outdated values for user and system times
    due to the batch processing nature of percpu_counter.