Hello Roman, I wish to add documentation to cgroups(7) for the cgroup.stat file that you added in Linux 4.14. I wrote some text based on your text added to the cgroup-v2.txt file, but added some pieces, and also have a question (see below). The plain-text version for (easy review) is shown below. Could you please review this text? (Please note the FIXME!) The branch containing the pending cgroups(7) changes can be found at : https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/log/?h=draft_cgroup_updates [[ Cgroups v2 cgroup.stat file Each cgroup in the v2 hierarchy contains a read-only cgroup.stat file (first introduced in Linux 4.14) that consists of lines containing key-value pairs. The following keys cur‐ rently appear in this file: nr_descendants This is the total number of visible (i.e., living) descendant cgroups underneath this cgroup. ┌─────────────────────────────────────────────────────┐ │FIXME │ ├─────────────────────────────────────────────────────┤ │For the following text on nr_dying_descendants, it │ │would I think be helpful to describe a condrete │ │example of when one might see nr_dying_descendants a │ │nonzero value for this key. Ideally, the example │ │would be one that the reader could easily reproduce. │ │Is there such an example? │ └─────────────────────────────────────────────────────┘ nr_dying_descendants This is the total number of dying descendant cgroups underneath this cgroup. A cgroup enters the dying state after being deleted. It remains in that state for an undefined period (which will depend on system load) before being destroyed. A process can't be made a member of a dying cgroup, and a dying cgroup can't be brought back to life. ]] Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
