lkml.org 
[lkml]   [2016]   [Jun]   [23]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH 2/2] docs: cgroup/pids: update documentation to include pids.events
    Date
    So that users know what the interface and meaning of the keyed values
    are. In addition, mention that the only time that since=0 is when the
    limit was changed.

    Signed-off-by: Aleksa Sarai <asarai@suse.de>
    ---
    Documentation/cgroup-v1/pids.txt | 18 ++++++++++++++++++
    1 file changed, 18 insertions(+)

    diff --git a/Documentation/cgroup-v1/pids.txt b/Documentation/cgroup-v1/pids.txt
    index 1a078b5d281a..a9bb7b964c6f 100644
    --- a/Documentation/cgroup-v1/pids.txt
    +++ b/Documentation/cgroup-v1/pids.txt
    @@ -33,6 +33,11 @@ limit in the hierarchy is followed).
    pids.current tracks all child cgroup hierarchies, so parent/pids.current is a
    superset of parent/child/pids.current.

    +pids.events shows information about the number of failed forks in a particular
    +cgroup, both overall (since the cgroup was created) and recently (since the
    +last limit reset). Userspace is notified of each time a process failed to fork
    +in a cgroup.
    +
    Example
    -------

    @@ -83,3 +88,16 @@ sh: fork: Resource temporary unavailable
    # /bin/echo "We can't even spawn a single process now."
    sh: fork: Resource temporary unavailable
    #
    +
    +We can also see how many times a particular cgroup has failed to fork. For an
    +example cgroup:
    +
    +# cat /sys/fs/cgroup/pids/some_cgroup/pids.events
    +since 1
    +total 12
    +#
    +
    +This cgroup has had 12 associated process fail to fork throughout its lifetime,
    +and has had 1 process fail to fork since the limit was last set. On setting the
    +limit, the since counter becomes 0 and userspace is notified (this is the only
    +case where since will be 0 and userspace will get a notification).
    --
    2.8.4
    \
     
     \ /
      Last update: 2016-06-24 05:21    [W:3.318 / U:0.284 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site