]> git.ipfire.org Git - thirdparty/libcgroup.git/log
thirdparty/libcgroup.git
3 years agocgsnapshot.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:37:43 +0000 (21:07 +0530)] 
cgsnapshot.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 1 errors, 39 warnings, 847 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocgset.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:36:34 +0000 (21:06 +0530)] 
cgset.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 1 errors, 16 warnings, 284 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocgget.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:32:16 +0000 (21:02 +0530)] 
cgget.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 2 errors, 13 warnings, 772 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocgexec.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:25:09 +0000 (20:55 +0530)] 
cgexec.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 2 errors, 8 warnings, 178 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocgdelete.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:24:30 +0000 (20:54 +0530)] 
cgdelete.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 1 errors, 6 warnings, 303 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocgcreate.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:23:50 +0000 (20:53 +0530)] 
cgcreate.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 0 errors, 10 warnings, 247 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocgconfig.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:22:59 +0000 (20:52 +0530)] 
cgconfig.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 0 errors, 11 warnings, 213 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocgclassify.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 16 Mar 2022 15:22:23 +0000 (20:52 +0530)] 
cgclassify.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO and NEW_TYPEDEFS types.  It
also introduces reverse xmas tree local variable declarations and header
file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 2 errors, 10 warnings, 203 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years ago.checkpatch.conf: add NEW_TYPEDEFS to ignore-list
Kamalesh Babulal [Mon, 14 Mar 2022 10:35:06 +0000 (16:05 +0530)] 
.checkpatch.conf: add NEW_TYPEDEFS to ignore-list

There are tools/files, that introduce new typdefs and checkpatch.pl is
unhappy about it. It takes some re-work on removing and for now let's
teach checkpatch to ignore it.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoAdopt SPDX License tag for files missing license information
Kamalesh Babulal [Mon, 14 Mar 2022 04:38:44 +0000 (10:08 +0530)] 
Adopt SPDX License tag for files missing license information

Adopt SPDX license tag for all the source files, those missing License
information.  All the files in the project fall under project license,
hence explicitly adding LGPL-2.1-only identifier to them.  The SPDX
license identifier is added for the files, reported by checkpatch.pl.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoAdopt SPDX License tag
Kamalesh Babulal [Mon, 14 Mar 2022 04:35:01 +0000 (10:05 +0530)] 
Adopt SPDX License tag

Adopt SPDX license tag for all the source files, those already have
LGPL 2.1 bolierplate in them.  Adopting SPDX license helps the
compliance tools to determine the license and also helps in reducing the
repetitive license boilerplate across source files.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosamples/c: drop the test suites
Kamalesh Babulal [Fri, 11 Mar 2022 14:54:43 +0000 (07:54 -0700)] 
samples/c: drop the test suites

samples/c contains test cases, those do serve as good examples on how to
use some APIs, but there are also very elaborate test cases, which are
test suites in themselves.  Let's drop these examples and allow users to
look at gunit/ftests for how to contribute to test cases.  This patch
also modifies the Makefile to help users to build the examples, in case
they want to give it a quick try.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agolog: add log level string prefix to logging functions
Kamalesh Babulal [Fri, 11 Mar 2022 14:51:09 +0000 (07:51 -0700)] 
log: add log level string prefix to logging functions

Usage of cgroup_{err, warn, info} functions, expects the log level to be
prefixed to the message like: cgroup_warn("Warning: ...").  This patch
removes this need to prefix and automatically adds the desired prefix to
the logger function, so the usage becomes cgroup_warn("...").  This
helps in readability and avoiding typos in setting the right log level
string to the message.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agocheckpatch.conf: introduce checkpatch.pl configuration
Kamalesh Babulal [Wed, 9 Mar 2022 11:52:35 +0000 (17:22 +0530)] 
checkpatch.conf: introduce checkpatch.pl configuration

Introduce checkpatch.conf, which defines the rules those are exempted in
libcgroup when running scripts/checkpatch.pl from Linux Kernel sources.

This helps us in introducing a coding standard and stay close to already
well defined and debated coding style that of the Linux Kernel.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/abstraction-map.c: re-arrange the header files
Kamalesh Babulal [Wed, 9 Mar 2022 11:51:33 +0000 (17:21 +0530)] 
src/abstraction-map.c: re-arrange the header files

Re-arrange the headers files, in the following order:
1. Header files that declare the functions, are defined in this file.
2. Other header files from the libcgroup.
3. Standard header file.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/abstraction-cpuset.c: re-arrange the header files
Kamalesh Babulal [Wed, 9 Mar 2022 11:49:42 +0000 (17:19 +0530)] 
src/abstraction-cpuset.c: re-arrange the header files

Re-arrange the headers files, in the following order:
1. Header files that declare the functions, are defined in this file.
2. Other header files from the libcgroup.
3. Standard header file.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/abstraction-cpu.c: re-arrange the header files
Kamalesh Babulal [Wed, 9 Mar 2022 11:46:32 +0000 (17:16 +0530)] 
src/abstraction-cpu.c: re-arrange the header files

Re-arrange the headers files, in the following order:
1. Header files that declare the functions, are defined in this file.
2. Other header files from the libcgroup.
3. Standard header file.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/api.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 9 Mar 2022 13:59:57 +0000 (19:29 +0530)] 
src/api.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO types.  It also introduces
reverse xmas tree local variable declarations and header file
reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 26 errors, 204 warnings, 5855 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/wrapper.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 9 Mar 2022 10:09:49 +0000 (15:39 +0530)] 
src/wrapper.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO types.  It also introduces
reverse xmas tree local variable declarations and header file
reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 0 errors, 55 warnings, 743 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/log.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 9 Mar 2022 10:03:41 +0000 (15:33 +0530)] 
src/log.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO types.  It also introduces
reverse xmas tree local variable declarations and header file
reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 0 errors, 3 warnings, 96 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/config.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 9 Mar 2022 07:54:35 +0000 (13:24 +0530)] 
src/config.c: fix checkpatch.pl warnings

Fix most of the warnings/errors reported by Linux Kernel's
checkpatch.pl, except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO types.
It also introduces reverse xmas tree local variable declarations
and header file reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 4 errors, 36 warnings, 1899 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/libcgroup-internal.h: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 9 Mar 2022 13:58:31 +0000 (19:28 +0530)] 
src/libcgroup-internal.h: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO types.  It also introduces
reverse xmas tree local variable declarations and header file
reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 5 errors, 2 warnings, 438 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/abstraction-common.h: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 9 Mar 2022 07:11:03 +0000 (12:41 +0530)] 
src/abstraction-common.h: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO types.  It also introduces
reverse xmas tree local variable declarations and header file
reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 0 errors, 4 warnings, 150 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agosrc/abstraction-common.c: fix checkpatch.pl warnings
Kamalesh Babulal [Wed, 9 Mar 2022 06:54:27 +0000 (12:24 +0530)] 
src/abstraction-common.c: fix checkpatch.pl warnings

Fix all of the warnings/errors reported by Linux Kernel's checkpatch.pl,
except SPDX_LICENSE_TAG, USE_NEGATIVE_ERRNO types.  It also introduces
reverse xmas tree local variable declarations and header file
reordering.

In summary, this patch fixes the following checkpatch.pl
recommendations:
total: 0 errors, 7 warnings, 320 lines checked

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agotools/lssubsys: fix strncpy() warning
Kamalesh Babulal [Mon, 28 Feb 2022 14:11:43 +0000 (19:41 +0530)] 
tools/lssubsys: fix strncpy() warning

GCC complains about string truncations in
print_all_controllers_in_hierarchy:

In function 'print_all_controllers_in_hierarchy',
    inlined from 'cgroup_list_all_controllers' at lssubsys.c:226:9,
    inlined from 'main' at lssubsys.c:294:8:
lssubsys.c:127:25: warning: 'strncpy' output may be truncated copying 4095 bytes from a string of length 4095 [-Wstringop-truncation]
  127 |                         strncpy(cont_name, info.name, FILENAME_MAX-1);
      |                         ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
lssubsys.c:131:25: warning: 'strncpy' output may be truncated copying 4095 bytes from a string of length 4095 [-Wstringop-truncation]
  131 |                         strncpy(cont_names, info.name, FILENAME_MAX-1);
      |                         ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

this warning seems to be a little odd when the current code is already
explicitly truncating the string. Digging deeper, it looks like the
memset(), followed by strncpy() with -O >= 2 triggers this warning on
GCC 11. A simple and safe fix would be removing the memset(). As per
the standard's strncpy() will fill the destination string with '\0', if
the source string length is lesser than that of the destination.  This
fix, take this approach.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoapi: fix strncpy() warning in cgroup_process_v2_mnt
Kamalesh Babulal [Mon, 28 Feb 2022 14:07:20 +0000 (19:37 +0530)] 
api: fix strncpy() warning in cgroup_process_v2_mnt

Fix a GCC warning about un-truncated strncpy() in
cgroup_process_v2_mnt():

In function 'cgroup_process_v2_mnt',
    inlined from 'cgroup_init' at api.c:1387:10:
api.c:1205:9: warning: 'strncpy' specified bound 4096 equals destination size [-Wstringop-truncation]
 1205 |         strncpy(cg_cgroup_v2_mount_path, ent->mnt_dir, FILENAME_MAX);
      |         ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoapi.c: Allow creation of a v2 cgroup with no controllers 102/head
Tom Hromatka [Thu, 17 Feb 2022 21:17:15 +0000 (14:17 -0700)] 
api.c: Allow creation of a v2 cgroup with no controllers

Commit 498530a1d744 ("cgcreate, tools: Allow cgroup creation with
no controllers attached") attempted to add support to allow the
creation of a cgroup v2 cgroup with no controllers attached.  This
patch did create the requested cgroup, but it still required there
to be at least one valid controller _available_ to attach to.

Rework the aforementioned logic so that the cgroup can be created
if there's a valid cgroup v2 mount - even if there are no v2
controllers available.

Fixes: 498530a1d744 ("cgcreate, tools: Allow cgroup creation with no controllers attached")
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agosamples: Add C samples
Tom Hromatka [Wed, 23 Feb 2022 15:01:38 +0000 (08:01 -0700)] 
samples: Add C samples

Move the legacy tests from libcgroup-tests [1] to the
samples/c/ directory.  While these files are no longer
being run as automated tests, they provide helpful insight
into how to utilize the libcgroup C APIs.

[1] https://github.com/libcgroup/libcgroup-tests/

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agosamples: Move the config examples to samples/config/
Tom Hromatka [Wed, 23 Feb 2022 15:01:03 +0000 (08:01 -0700)] 
samples: Move the config examples to samples/config/

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoconfigure: Delete legacy test artifacts
Tom Hromatka [Wed, 23 Feb 2022 15:00:29 +0000 (08:00 -0700)] 
configure: Delete legacy test artifacts

The legacy tests (now located in the libcgroup-tests)
repository have been moved to
https://github.com/libcgroup/libcgroup-tests/tree/main/examples
and are no longer being run.  Remove all references to
the tests from the configure.ac file.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agopython/setup.py: make it PEP8 compliant
Kamalesh Babulal [Thu, 17 Feb 2022 19:39:43 +0000 (12:39 -0700)] 
python/setup.py: make it PEP8 compliant

Make setup.py PEP-8 compliant, it fixes the following two issues
reported by flake8:
- E128 continuation line under-indented for visual indent
- E251 unexpected spaces around keyword/parameter equals

also, adopt single quotes for strings.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoREADME.md: Add python code quality badge
Tom Hromatka [Wed, 16 Feb 2022 19:27:05 +0000 (12:27 -0700)] 
README.md: Add python code quality badge

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoREADME.md: Update the LGTM link
Tom Hromatka [Mon, 14 Feb 2022 15:25:15 +0000 (08:25 -0700)] 
README.md: Update the LGTM link

The LGTM badge linked to a comparison of libcgroup with
other open source projects.  Change the link to go directly
to libcgroup's alerts.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoapi.c: Fix TOCTOU race cgroup_get_cg_type()
Kamalesh Babulal [Mon, 14 Feb 2022 15:11:56 +0000 (08:11 -0700)] 
api.c: Fix TOCTOU race cgroup_get_cg_type()

Fix a TOCTOU race condition, that checks for file existence versus file
open in cgroup_get_cg_type() by opening the file and check for errno for
file existence.

Reported-by: LGTM
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoapi.c: fix a comparison error in cgroup_delete_cgroup_ext()
Kamalesh Babulal [Mon, 14 Feb 2022 15:11:39 +0000 (08:11 -0700)] 
api.c: fix a comparison error in cgroup_delete_cgroup_ext()

Fix a comparison logic in the first_errno assignment, that would
never get executed in the case of first_errno == ECGNONEMPTY in
cgroup_delete_cgroup_ext().

Reported-by: LGTM
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoapi: make cgroup_get_subsys_mount_point_end() more useful
Kamalesh Babulal [Mon, 14 Feb 2022 15:11:25 +0000 (08:11 -0700)] 
api: make cgroup_get_subsys_mount_point_end() more useful

Currently cgroup_get_subsys_mount_point_end(), does nothing more than
returning zero, it was caught by LGTM altering:
"This expression has no effect (because
cgroup_get_subsys_mount_point_end has no external side effects)."

make the function more useful like other *_end() functions by including
the check for cgroup_initialized and assigning NULL to the handle used
for iterating over controller mount points.

Reported-by: LGTM
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agowrapper: remove false checks for snprintf
Kamalesh Babulal [Mon, 14 Feb 2022 15:11:08 +0000 (08:11 -0700)] 
wrapper: remove false checks for snprintf

LGTM, reported that the negative value checks for snprintf() will
always be false.  The reason being the snprintf() are used to print
into a character buffer, hence chances of stream error or wide
characters encoding error are not valid here. Remove the negative
return value check across the file done after snprintf().

Reported-by: LGTM
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agotools/cgsnapshot: rename FILE *of to output_f
Kamalesh Babulal [Mon, 14 Feb 2022 15:10:43 +0000 (08:10 -0700)] 
tools/cgsnapshot: rename FILE *of to output_f

LGTM, complained about using FILE *of as shorthand for the output file
and recommended using something descriptive. Rename usage of with
output_f, to keep it happy.

Reported-by: LGTM
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoIntroduce vim modeline for python sources
Kamalesh Babulal [Mon, 14 Feb 2022 14:54:19 +0000 (07:54 -0700)] 
Introduce vim modeline for python sources

Introduce vim modeline to python source files. This sets up the
vim editor to PEP-8 recommend editing style. The vim modeline added:
"# vim: set et ts=4 sw=4:"

'et' converts the tabs to spaces, 'ts' set the tabs indentation/tabstop
to 4 characters and 'sw' sets the shiftwidth to 4 characters.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agodocs: add library version updates to release process
Kamalesh Babulal [Thu, 10 Feb 2022 21:49:29 +0000 (14:49 -0700)] 
docs: add library version updates to release process

Add step to update Major, Minor and Release versions in configure.ac to
both release documents.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoMerge pull request #94 from drakenclimber/issues/emptycgcreate
Tom Hromatka [Thu, 10 Feb 2022 21:39:43 +0000 (14:39 -0700)] 
Merge pull request #94 from drakenclimber/issues/emptycgcreate

Add support for creating an empty cgroup v2 cgroup

3 years agopython: Add support to create a cgroup on-disk 94/head
Tom Hromatka [Wed, 9 Feb 2022 19:28:57 +0000 (12:28 -0700)] 
python: Add support to create a cgroup on-disk

Add support to the python bindings to create a cgroup
on disk.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agocgcreate, tools: Allow cgroup creation with no controllers attached
Tom Hromatka [Wed, 9 Feb 2022 19:28:44 +0000 (12:28 -0700)] 
cgcreate, tools: Allow cgroup creation with no controllers attached

Add support for creating a cgroup with no controllers attached.  This
is only supported on cgroup v2.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoapi.c: Refactor cgroup_create_cgroup()
Tom Hromatka [Wed, 9 Feb 2022 19:27:43 +0000 (12:27 -0700)] 
api.c: Refactor cgroup_create_cgroup()

Non-functional change to refactor cgroup_create_cgroup().  Move
the contents of this "for" loop to its own function:
for (k = 0; k < cgroup->index; k++)

This will be used as a building block for the next commit to allow
the creation of cgroups with no controllers attached.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoapi.c: fix the buffer size to read /proc/cgroups
Kamalesh Babulal [Tue, 8 Feb 2022 16:44:50 +0000 (09:44 -0700)] 
api.c: fix the buffer size to read /proc/cgroups

In cgroup_init(), the first line/header of /proc/cgroups helps in
interpreting the values in the remaining of the file.  We are interested
in the rest of the file and a temporary buffer of size FILENAME_MAX is
allocated/deallocated after reading the header. The length of the header
is only 56 characters in length, excluding the newline. This patch
reduces it to LL_MAX a.k.a 100 characters.

LL_MAX is used instead of introducing another new length macro.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agolibcgroup-internal.h: remove FIXME comment
Kamalesh Babulal [Tue, 8 Feb 2022 16:44:36 +0000 (09:44 -0700)] 
libcgroup-internal.h: remove FIXME comment

As per Linux Kernel uidgid.h file, that represents internal Kernel types
for uids/gids. Initialized invalid uids/gids to -1:

  #define INVALID_UID KUIDT_INIT(-1)
  #define INVALID_GID KGIDT_INIT(-1)

initializing them to -1 is a valid, remove the FIXME comment that says
otherwise.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoapi.c: add return value check for strdup()
Kamalesh Babulal [Tue, 8 Feb 2022 16:44:19 +0000 (09:44 -0700)] 
api.c: add return value check for strdup()

In function cg_build_path_locked(), check for return value from
strdup(). This fixes, one of the long pending FIXME.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoerror.h: make errno number reading easier
Kamalesh Babulal [Tue, 8 Feb 2022 16:15:13 +0000 (09:15 -0700)] 
error.h: make errno number reading easier

Trying to match error number with enum requires manual effort. Make it
easier by adding a comment with errno for every enum value.

Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agogit: tools: Ignore cgxget and cgxset
Tom Hromatka [Wed, 15 Dec 2021 21:27:39 +0000 (21:27 +0000)] 
git: tools: Ignore cgxget and cgxset

Git ignore the executables cgxget and cgxset

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agogithub: Add a code coverage action
Tom Hromatka [Wed, 15 Dec 2021 21:27:26 +0000 (21:27 +0000)] 
github: Add a code coverage action

Add a code coverage action to the Github workflow.  As part
of this code coverage action, ignore the C file that is
auto-generated from the Cython code.  Also ignore a couple Python
header files that were confusing lcov.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agopython: Add python bindings using Cython
Tom Hromatka [Wed, 15 Dec 2021 21:26:02 +0000 (21:26 +0000)] 
python: Add python bindings using Cython

Add python bindings via the --enable-python configure flag.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agolibcgroup.so: Add a function to get the library version
Tom Hromatka [Wed, 15 Dec 2021 21:22:20 +0000 (21:22 +0000)] 
libcgroup.so: Add a function to get the library version

Add a function, cgroup_version(), that returns the current
version of the libcgroup library.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agocgxset: libcgroup.so: Add cgroup_cgxset() to library
Tom Hromatka [Fri, 28 Jan 2022 21:29:44 +0000 (14:29 -0700)] 
cgxset: libcgroup.so: Add cgroup_cgxset() to library

Add cgroup_cgxset() to libcgroup.so.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agocgxget: libcgroup.so: Add cgroup_cgxget() to library
Tom Hromatka [Fri, 28 Jan 2022 21:28:57 +0000 (14:28 -0700)] 
cgxget: libcgroup.so: Add cgroup_cgxget() to library

Add cgroup_cgxget() to libcgroup.so.  Create a new header
file, libcgroup/tools.h, to hold C APIs that are exported
from the tools folder.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agopython: Delete old python bindings
Tom Hromatka [Wed, 15 Dec 2021 21:04:06 +0000 (21:04 +0000)] 
python: Delete old python bindings

Remove the old python bindings.  They will be replaced with Cython
bindings in a subsequent commit.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agogithub: Skip test 38 (cpuset) on VMs hosted by Github Actions
Tom Hromatka [Wed, 15 Dec 2021 21:03:28 +0000 (21:03 +0000)] 
github: Skip test 38 (cpuset) on VMs hosted by Github Actions

Skip test #38 - 038-cgxget-cpuset_settings.py - on servers hosted
by Github Actions.  Test #38 sets/clears the cpuset exclusive bit
and this is not allowed on Github's servers.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction-map: Add unmappable cpuset cgroup v1 settings
Tom Hromatka [Mon, 31 Jan 2022 16:35:15 +0000 (09:35 -0700)] 
abstraction-map: Add unmappable cpuset cgroup v1 settings

Add several unmappable cpuset settings.  As the name implies, these
settings have no equivalent in cgroup v2:
cpuset.mem_exclusive
cpuset.mem_hardwall
cpuset.memory_migrate
cpuset.memory_pressure
cpuset.mem_pressure_enabled
cpuset.memory_spread_page
cpuset.memory_spread_slab
cpuset.sched_load_balance
cpuset.sched_relax_domain_level

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agocgxset: Add a flag to ignore settings that can't be converted
Tom Hromatka [Mon, 31 Jan 2022 15:21:00 +0000 (08:21 -0700)] 
cgxset: Add a flag to ignore settings that can't be converted

Add a flag, "-i", to cgxset to ignore settings that can't be
converted from cgroup v1 to cgroup v2 or vice versa.

Some cgroup v1 settings, e.g. cpuset.sched_relax_domain_level,
don't have a cgroup v2 equivalent and likely never will.  This
flag allows users to ignore errors from these unconvertable
settings.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agocgxget: Add a flag to ignore settings that can't be converted
Tom Hromatka [Fri, 28 Jan 2022 21:22:53 +0000 (14:22 -0700)] 
cgxget: Add a flag to ignore settings that can't be converted

Add a flag, "-i", to cgxget to ignore settings that can't be
converted from cgroup v1 to cgroup v2 or vice versa.

Some cgroup v1 settings, e.g. cpuset.sched_relax_domain_level,
don't have a cgroup v2 equivalent and likely never will.  This
flag allows users to ignore errors from these unconvertable
settings.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction-map: Add (currently) unmappable cpu.stat
Tom Hromatka [Mon, 31 Jan 2022 16:30:56 +0000 (09:30 -0700)] 
abstraction-map: Add (currently) unmappable cpu.stat

Add an unmappable mapping for the cpu.stat setting.  While
the filename, cpu.stat, maps perfectly from v1 <-> v2, the
contents do not.  At this time, let's set this as unmappable
and revisit it when we've thought through the best way to
map the contents.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction: Add support for unmappable settings
Tom Hromatka [Wed, 15 Dec 2021 21:13:29 +0000 (21:13 +0000)] 
abstraction: Add support for unmappable settings

Add a function to explicitly handle settings that cannot
be mapped from v1 to v2 or vice versa.  This function returns
ECGNOVERSIONCONVERT which cgxget, cgxset, etc. can then
monitor and if requested by the user, ignore.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction-map: Add cpuset.cpu_exclusive <-> cpuset.cpus.partition mapping
Tom Hromatka [Fri, 28 Jan 2022 17:23:55 +0000 (10:23 -0700)] 
abstraction-map: Add cpuset.cpu_exclusive <-> cpuset.cpus.partition mapping

Add custom functions to map cpuset.cpu_exclusive <->
cpuset.cpus.partition.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction-map: Add cpuset.{cpus,mems} <-> cpuset.{cpus,mems} mapping
Tom Hromatka [Wed, 15 Dec 2021 20:48:56 +0000 (20:48 +0000)] 
abstraction-map: Add cpuset.{cpus,mems} <-> cpuset.{cpus,mems} mapping

Add a passthrough mapping for:
cpuset.cpus <-> cpuset.cpus
cpuset.mems <-> cpuset.mems

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction-map: Add cpuset.effective_{cpus,mems} <-> cpuset.{cpus,mems}.effective...
Tom Hromatka [Wed, 15 Dec 2021 20:48:31 +0000 (20:48 +0000)] 
abstraction-map: Add cpuset.effective_{cpus,mems} <-> cpuset.{cpus,mems}.effective mapping

Add a name-only mapping to convert:
cpuset.effective_cpus <-> cpuset.cpus.effective
cpuset.effective_mems <-> cpuset.mems.effective

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction-map: Add cpu.cfs_{quota,period}_us <-> cpu.max mapping
Tom Hromatka [Mon, 31 Jan 2022 16:21:54 +0000 (09:21 -0700)] 
abstraction-map: Add cpu.cfs_{quota,period}_us <-> cpu.max mapping

Add custom functions to map cpu.cfs_quota_us <-> cpu.max and
cpu.cfs_period_us <-> cpu.max.  These mappings can be 1->N or
N->1 and utilize custom values for limits, "-1" in cgroup v1
and "max" in cgroup v2.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agowrapper: Add function to remove name/value pair from a controller
Tom Hromatka [Wed, 15 Dec 2021 20:39:52 +0000 (20:39 +0000)] 
wrapper: Add function to remove name/value pair from a controller

Add a function to remove a name/value settings pair from
a cgroup_controller instance.  As part of this change, I did a small
refactor on cgroup_free_controllers() to make the code more reusable
throughout libcgroup.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoapi.c: Add const qualifier to parameters in cgroup_read_value_begin()
Tom Hromatka [Wed, 15 Dec 2021 20:39:22 +0000 (20:39 +0000)] 
api.c: Add const qualifier to parameters in cgroup_read_value_begin()

Make two string parameters passed into cgroup_read_value_begin()
fully constant, i.e. const char * const.  These parameters,
controller and name, are only used as read-only variables
within cgroup_read_value_begin() and are not intended to be
modified.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoapi.c/wrapper/abstraction: Save previous setting name in control_value
Tom Hromatka [Wed, 15 Dec 2021 20:37:37 +0000 (20:37 +0000)] 
api.c/wrapper/abstraction: Save previous setting name in control_value

When there's an N->1 mapping, the abstraction layer needs
to know which "1" setting to map back to.  Add a field to
struct control_value that saves off the original setting,
so that the abstraction layer can know how to map back from
an N->1 setting.

A good example of this is cpu.max/cpu.cfs_quota_us.  The
abstraction layer will map cpu.cfs_quota_us to cpu.max.
During the return conversion, the abstraction layer needs
to know whether to map cpu.max to cfs_quota_us or
cfs_period_us.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction: Add passthrough function
Tom Hromatka [Wed, 15 Dec 2021 21:12:09 +0000 (21:12 +0000)] 
abstraction: Add passthrough function

Add a passthrough function for settings/values that require
no conversion.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction: Add name conversion function
Tom Hromatka [Wed, 15 Dec 2021 21:11:28 +0000 (21:11 +0000)] 
abstraction: Add name conversion function

Add a function to the abstraction layer that can convert from
one cgroup setting name to another setting name.  The values are
not adjusted by this function.  For example, this can be used for
conversions like cpuset.effective_cpus to cpuset.cpus.effective.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agocgxset: Introduce cgxset
Tom Hromatka [Fri, 28 Jan 2022 17:22:49 +0000 (10:22 -0700)] 
cgxset: Introduce cgxset

Add a new libcgroup tool - cgxset.  cgxset is based upon cgset,
but it supports converting from cgroup version to another.

For example, a request like the following will work on a system
running the cgroup v1 cpu controller or the cgroup v2 cpu
controller.
            $ cgxset -2 -r cpu.weight=42 MyCgroup

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agocgxget: Introduce cgxget
Tom Hromatka [Fri, 28 Jan 2022 17:22:11 +0000 (10:22 -0700)] 
cgxget: Introduce cgxget

Add a new libcgroup tool - cgxget.  cgxget is based upon cgget,
but it supports converting from cgroup version to another.

For example, a request like the following will work on a system
running the cgroup v1 cpu controller or the cgroup v2 cpu controller.
$ cgxget -2 -r cpu.weight MyCgroup

The return value to the user will match the cgroup version requested.
If the user requests a v1 setting, the return value will be a cgroup
v1 setting.  If the user requests a v2 setting, the return value will
be a cgroup v2 setting.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction-map: Add cpu.shares <-> cpu.weight mapping
Tom Hromatka [Wed, 15 Dec 2021 20:19:23 +0000 (20:19 +0000)] 
abstraction-map: Add cpu.shares <-> cpu.weight mapping

Add a mapping from cpu.shares <-> cpu.weight.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction: Add function to convert from one cgroup version to another
Tom Hromatka [Wed, 15 Dec 2021 20:18:54 +0000 (20:18 +0000)] 
abstraction: Add function to convert from one cgroup version to another

Add a function - cgroup_convert_cgroup() - that can convert from
one cgroup version to another.  This function will be the building
block for the libcgroup abstraction layer.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction: Add integer conversion function
Tom Hromatka [Wed, 15 Dec 2021 20:14:11 +0000 (20:14 +0000)] 
abstraction: Add integer conversion function

Add a function to the abstraction layer that can convert from
one integer setting to another.  For example, this can be used
for simple conversions like cpu.shares to cpu.weight and vice
versa.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction: Add mapping tables
Tom Hromatka [Fri, 28 Jan 2022 17:21:10 +0000 (10:21 -0700)] 
abstraction: Add mapping tables

Add a table for cgroup v1 to v2 conversions -
cgroup_v1_to_v2_map[]

Add a table for cgroup v2 to v1 conversions -
cgroup_v2_to_v1_map[]

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoabstraction: Add cgroup_strtol()
Tom Hromatka [Fri, 28 Jan 2022 17:20:38 +0000 (10:20 -0700)] 
abstraction: Add cgroup_strtol()

Add two new files, abstraction-common.[ch], and within them add
a function, cgroup_strtol(), that can convert a string to a long.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoapi.c: Remove static from cgroup_copy_controller_values()
Tom Hromatka [Wed, 15 Dec 2021 19:37:36 +0000 (19:37 +0000)] 
api.c: Remove static from cgroup_copy_controller_values()

Remove static from cgroup_copy_controller_values() in api.c
so that other files within libcgroup can invoke it.  It will
be used by the abstraction layer code in a subsequent commit.

Also, declare *dst as a const pointer and *src as a const *
const pointer.  Subsequent abstraction layer checkins make
heavy use of const and without these changes, warnings (which
continuous integration converts to errors) are thrown.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agowrapper.c: Store the version in struct cgroup_controller
Tom Hromatka [Wed, 15 Dec 2021 19:30:30 +0000 (19:30 +0000)] 
wrapper.c: Store the version in struct cgroup_controller

Store the cgroup version in struct cgroup_controller.  Each
controller can be mounted separately, and thus the cgroup
version is applicable at the controller level.

Note that this commit requires cgroup_init() to be called by
cgconfigparser.  Storing the version in the cgroup_controller
struct requires the cg_mount_table[] to be populated.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agogroups.h: Move cg_version_t to groups.h
Tom Hromatka [Wed, 15 Dec 2021 19:27:19 +0000 (19:27 +0000)] 
groups.h: Move cg_version_t to groups.h

Move cg_version_t to libcgroup/groups.h from libcgroup-internal.h.
Introduce CGROUP_DISK version to indicate the cgroup version in
sysfs.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoautomake: Don't go over 80-character lines
Tom Hromatka [Fri, 28 Jan 2022 17:17:34 +0000 (10:17 -0700)] 
automake: Don't go over 80-character lines

Nonfunctional change to line wrap lines that were 80+
characters long.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoconfigure: set version numbers for releases only
Kamalesh Babulal [Thu, 3 Feb 2022 14:59:20 +0000 (07:59 -0700)] 
configure: set version numbers for releases only

Let's set the version for releases only and set the development/main
branch version to 0.0.0, that differentiate between development and
releases.

Suggested-by: Tom Hromatka <tom.hromatka@oracle.com>
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoMerge pull request #92 from drakenclimber/issues/finalize
Tom Hromatka [Wed, 2 Feb 2022 23:20:34 +0000 (16:20 -0700)] 
Merge pull request #92 from drakenclimber/issues/finalize

On some pull requests, I have observed that the coveralls summary sometimes runs before all the jobs have completed.  Let's see if this fixes it.

3 years agogithub: Always run the finalize job 92/head
Tom Hromatka [Wed, 2 Feb 2022 22:44:11 +0000 (15:44 -0700)] 
github: Always run the finalize job

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoapi.c: add support for cgroup.threads
Kamalesh Babulal [Thu, 27 Jan 2022 19:33:52 +0000 (12:33 -0700)] 
api.c: add support for cgroup.threads

cgroup_build_tasks_procs_path(), that builds the proc path for moving
the tid, doesn't check for the cgroup type and appends cgroup.procs for
both cgroup v1/v2.  With cgroup v2, this results in building a wrong
proc path if the cgroup type is threaded. This patch adds support to
check for the cgroup v2 type and build the proc path according to the
below table:

cgroup.type     | proc file      | Description                        |
----------------+----------------+------------------------------------+
domain          | cgroup.procs   | regular cgroup, all threads gets   |
                |                | moved to the cgroup.               |
domain threaded | cgroup.procs   | root of threaded subtree, all      |
                |                | threads gets moved to the cgroup.  |
threaded        | cgroup.threads | cgroup under threaded subtree,     |
|  | single threads with matching tid,  |
|  | gets moved to the cgroup.          |
domain invalid  | N/A            | invalid state of a cgroup under the|
                |                | threaded subtree.                  |

Closes: https://github.com/libcgroup/libcgroup/issues/64
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoMerge pull request #86 from drakenclimber/issues/lgtm
Tom Hromatka [Thu, 20 Jan 2022 22:26:10 +0000 (15:26 -0700)] 
Merge pull request #86 from drakenclimber/issues/lgtm

ENH: Add LGTM badge to README.md

3 years agoREADME.md: Add LGTM badge 86/head
Tom Hromatka [Wed, 12 Jan 2022 21:32:25 +0000 (14:32 -0700)] 
README.md: Add LGTM badge

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoMerge pull request #85 from drakenclimber/issues/codeql
Tom Hromatka [Wed, 19 Jan 2022 17:42:49 +0000 (10:42 -0700)] 
Merge pull request #85 from drakenclimber/issues/codeql

ENH: Add Security Features

3 years agoapi.c: Fix TOCTOU race in cgroup_get_procs() 85/head
Tom Hromatka [Wed, 19 Jan 2022 17:03:28 +0000 (10:03 -0700)] 
api.c: Fix TOCTOU race in cgroup_get_procs()

codeql flagged a potential race between the time-of-check
and time-of-use (CWE-367) of the cgroup.procs file in
cgroup_get_procs().

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agogithub: Add a code security scan
Tom Hromatka [Wed, 12 Jan 2022 19:32:22 +0000 (12:32 -0700)] 
github: Add a code security scan

Add a code security scan, CodeQL to the Github Actions
continuous integration.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoSECURITY.md: Add security file
Tom Hromatka [Wed, 12 Jan 2022 19:30:44 +0000 (12:30 -0700)] 
SECURITY.md: Add security file

Add a SECURITY.md file that outlines the process for handling
security-related vulnerabilities.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoapi.c: cache cgrules with CGFLAG_USECACHE flag
Kamalesh Babulal [Tue, 18 Jan 2022 15:22:13 +0000 (08:22 -0700)] 
api.c: cache cgrules with CGFLAG_USECACHE flag

pam_cgroup.so plugin uses /etc/cgrules.conf to assign processes
to the requested cgroup.  This works well with active
cgrulesengd but in the instances where cgrulesengd is disabled,
the rules are not read and cached by default. Fix this is by
reloading and caching the rules when called with CGFLAG_USECACHE
flag.

Fixes: https://github.com/libcgroup/libcgroup/issues/84
Reported-by: Kent Overstreet <kent.overstreet@gmail.com>
Signed-off-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
TJH: Minor commit comment changes

3 years agoMerge pull request #83 from drakenclimber/issues/doxygen_badge
Tom Hromatka [Mon, 3 Jan 2022 15:08:50 +0000 (08:08 -0700)] 
Merge pull request #83 from drakenclimber/issues/doxygen_badge

README.md: Add Doxygen badge

3 years agoREADME.md: Add Doxygen badge 83/head
Tom Hromatka [Mon, 20 Dec 2021 15:18:35 +0000 (08:18 -0700)] 
README.md: Add Doxygen badge

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal kamalesh.babulal@oracle.com
3 years agogithub: Move Doxygen Folder
Tom Hromatka [Fri, 17 Dec 2021 22:30:07 +0000 (15:30 -0700)] 
github: Move Doxygen Folder

After Doxygen is built, move the html folder under doc/.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoMerge pull request #79 from drakenclimber/issues/doxygen
Tom Hromatka [Fri, 17 Dec 2021 22:19:25 +0000 (15:19 -0700)] 
Merge pull request #79 from drakenclimber/issues/doxygen

github: Add Doxyfile and github doxygen action

3 years agogithub: Add Doxyfile and github doxygen action 79/head
Tom Hromatka [Tue, 14 Dec 2021 21:50:33 +0000 (14:50 -0700)] 
github: Add Doxyfile and github doxygen action

Add a default Doxyfile and a doxygen action.

Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>
3 years agoInitialize cgroup version for named V1 hierarchy
Ingo van Lil [Thu, 16 Dec 2021 20:32:23 +0000 (13:32 -0700)] 
Initialize cgroup version for named V1 hierarchy

Commit 3aac9889 added the 'version' field in cg_mount_table_s and
initializes it in cgroup_process_v1_mnt(). The same initialization is
required in a second place dealing with named hierarchies.

Signed-off-by: Ingo van Lil <inguin@gmx.de>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
3 years agoMerge pull request #74 from drakenclimber/issues/73
Tom Hromatka [Tue, 14 Dec 2021 21:13:07 +0000 (14:13 -0700)] 
Merge pull request #74 from drakenclimber/issues/73

api.c: Allow reading/writing from cgroup.* files in cgroup v2

3 years agoapi.c: Allow reading/writing from cgroup.* files in cgroup v2 74/head
Tom Hromatka [Mon, 6 Dec 2021 21:53:01 +0000 (14:53 -0700)] 
api.c: Allow reading/writing from cgroup.* files in cgroup v2

Allow reading/writing from cgroup.* files (such as cgroup.type
and cgroup.procs) on cgroup v2 filesystems.

Closes: https://github.com/libcgroup/libcgroup/issues/73
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
Reviewed-by: Kamalesh Babulal <kamalesh.babulal@oracle.com>