[PATCH] Docs/cgroup: update the cgroup-v1 docs

[PATCH] Docs/cgroup: update the cgroup-v1 docs

[Hui Su]

Since 'commit 69d0206c793a ("cgroup: bring some sanity to
naming around cg_cgroup_link")', 'cg_cgroup_link' has been
changed to 'cgrp_cset_link'.
so as its element 'cgrp_link_list' and 'cg_link_list'.

Since commit 47cfcd092245 ("cgroup: kill cgroup_[un]lock()"),
cgroup_lock/cgroup_unlock have been killed.

So update the cgroup-v1 Docs.

Signed-off-by: Hui Su <sh_def@163.com>
---
 Documentation/admin-guide/cgroup-v1/cgroups.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/Documentation/admin-guide/cgroup-v1/cgroups.rst b/Documentation/admin-guide/cgroup-v1/cgroups.rst
index b0688011ed06..c28316a7dd28 100644
--- a/Documentation/admin-guide/cgroup-v1/cgroups.rst
+++ b/Documentation/admin-guide/cgroup-v1/cgroups.rst
@@ -270,10 +270,10 @@ css_set is allocated. The appropriate existing css_set is located by
 looking into a hash table.
 
 To allow access from a cgroup to the css_sets (and hence tasks)
-that comprise it, a set of cg_cgroup_link objects form a lattice;
-each cg_cgroup_link is linked into a list of cg_cgroup_links for
-a single cgroup on its cgrp_link_list field, and a list of
-cg_cgroup_links for a single css_set on its cg_link_list.
+that comprise it, a set of cgrp_cset_link objects form a lattice;
+each cgrp_cset_link is linked into a list of cgrp_cset_links for
+a single cgroup on its cset_link field, and a list of
+cgrp_cset_links for a single css_set on its cgrp_link.
 
 Thus the set of tasks in a cgroup can be listed by iterating over
 each css_set that references the cgroup, and sub-iterating over
@@ -523,10 +523,7 @@ cgroup. It may also be taken to prevent cgroups from being
 modified, but more specific locks may be more appropriate in that
 situation.
 
-See kernel/cgroup.c for more details.
-
-Subsystems can take/release the cgroup_mutex via the functions
-cgroup_lock()/cgroup_unlock().
+See kernel/cgroup/cgroup.c for more details.
 
 Accessing a task's cgroup pointer may be done in the following ways:
 - while holding cgroup_mutex
-- 
2.29.0

Re: [PATCH] Docs/cgroup: update the cgroup-v1 docs

[Tejun Heo]

On Mon, Nov 02, 2020 at 11:21:16PM +0800, Hui Su wrote:
> Since 'commit 69d0206c793a ("cgroup: bring some sanity to
> naming around cg_cgroup_link")', 'cg_cgroup_link' has been
> changed to 'cgrp_cset_link'.
> so as its element 'cgrp_link_list' and 'cg_link_list'.
> 
> Since commit 47cfcd092245 ("cgroup: kill cgroup_[un]lock()"),
> cgroup_lock/cgroup_unlock have been killed.
> 
> So update the cgroup-v1 Docs.
> 
> Signed-off-by: Hui Su <sh_def@163.com>

Applied to cgroup/for-5.10-fixes.

Thanks.

-- 
tejun