Skip to content
  • Paul Menage's avatar
    cgroups: update documentation of cgroups tasks and procs files · 7823da36
    Paul Menage authored
    
    
    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: default avatarPaul Menage <menage@google.com>
    Reviewed-by: default avatarLi Zefan <lizf@cn.fujitsu.com>
    Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
    Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
    7823da36