linux/Documentation/cgroups
Paul Menage 7823da36ce cgroups: update documentation of cgroups tasks and procs files
Update documentation of cgroups tasks and procs files

Document the cgroup.procs file.

Clarify the semantics of the cgroup.procs and tasks files.  Although the
current cgroup.procs interface returns a sorted and uniqified list of
pids, potential future performance enhancements could result in those
properties being removed - explicitly document this aspect of the API.

There are no existing users of cgroup.procs, so compatibility isn't an
issue.  There are users of the "tasks" file, but none that would appear to
break in the event of the sorted property being broken.  The standard
"libcpuset" explicitly sorts the results of reading from the tasks file,
and "libcg" and other users don't appear to care about ordering.

Signed-off-by: Paul Menage <menage@google.com>
Reviewed-by: Li Zefan <lizf@cn.fujitsu.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2009-10-08 07:36:39 -07:00
..
00-INDEX
cgroups.txt cgroups: update documentation of cgroups tasks and procs files 2009-10-08 07:36:39 -07:00
cpuacct.txt
cpusets.txt cpusets: document adding/removing cpus to cpuset elaborately 2009-06-30 18:56:01 -07:00
devices.txt
freezer-subsystem.txt
memcg_test.txt
memory.txt memory controller: soft limit documentation 2009-09-24 07:20:59 -07:00
resource_counter.txt