Header file documentation changes; cgroup_create_cgroup() and
cgroup_create_cgroup_from_parent() return ECGROUPNOTEQUAL when create
is successful, but not all controller parameters are successfully
copied.

Signed-off-by: Eric Brower <[email protected]>

diff --git a/include/libcgroup/groups.h b/include/libcgroup/groups.h
index 29cde70..ba71e28 100644
--- a/include/libcgroup/groups.h
+++ b/include/libcgroup/groups.h
@@ -175,6 +175,8 @@ void cgroup_free_controllers(struct cgroup *cgroup);
  * @param ignore_ownership When nozero, all errors are ignored when setting
  *     owner of the group and/or its tasks file.
  *     @todo what is ignore_ownership good for?
+ * @retval #ECGROUPNOTEQUAL if not all specified controller parameters
+ *      were successfully set.
  */
 int cgroup_create_cgroup(struct cgroup *cgroup, int ignore_ownership);

@@ -196,6 +198,8 @@ int cgroup_create_cgroup(struct cgroup *cgroup,
int ignore_ownership);
  * @param ignore_ownership When nozero, all errors are ignored when setting
  *     owner of the group and/or its tasks file.
  *     @todo what is ignore_ownership good for?
+ * @retval #ECGROUPNOTEQUAL if not all inherited controller parameters
+ *      were successfully set (this is expected).
  */
 int cgroup_create_cgroup_from_parent(struct cgroup *cgroup,
                int ignore_ownership);

-- 
E

------------------------------------------------------------------------------
This SF.net email is sponsored by Sprint
What will you do first with EVO, the first 4G phone?
Visit sprint.com/first -- http://p.sf.net/sfu/sprint-com-first
_______________________________________________
Libcg-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/libcg-devel

Reply via email to