linux.git/tools/power/cpupower/bindings/python, branch for-next

pm: cpupower: bindings: Add test to confirm cpu state is disabled

2024-10-02T20:50:23+00:00

Add a simple test to confirm and print out the cpu state.

Signed-off-by: "John B. Wyatt IV" 
Signed-off-by: "John B. Wyatt IV" 
Signed-off-by: Shuah Khan

pm: cpupower: bindings: Improve disable c_state block

2024-10-02T20:50:17+00:00

This commit fixes a bad comment, removes an unneeded code block, and
catches a few more states that cpuidle_state_disable with the test
script. Part of the motivation for this commit was I kept forgetting to
use sudo.

Signed-off-by: "John B. Wyatt IV" 
Signed-off-by: "John B. Wyatt IV" 
Signed-off-by: Shuah Khan

pm: cpupower: Clean up bindings gitignore

2024-09-23T15:06:03+00:00

Add SPDX identifier to the gitignore. Remove the comment and .i file
since the file it references was removed in another patch. This patch
depends on Min-Hua Chen's 'pm: cpupower: rename raw_pylibcpupower.i'.

Signed-off-by: John B. Wyatt IV 
Signed-off-by: John B. Wyatt IV 
Signed-off-by: Shuah Khan

pm: cpupower: rename raw_pylibcpupower.i

2024-09-13T20:24:16+00:00

The raw_pylibcpupower.i is removed unexpectedly after 'make mrproper'

We can reproduce the error by performing the following steps:
cd linux-next
make mrproper
cd tools/power/cpupower/bindings/python
make

We will get an error message:
make: *** No rule to make target 'raw_pylibcpupower.i', needed by 'raw_pylibcpupower_wrap.c'.  Stop.

The root cause:

The *.i files are already used for pre-processor output files and
the kernel removes all the *.i files by 'make mrproper'.

That explains why the raw_pylibcpupower.i is removed by 'make mrproper'.

To fix it, Follow John's suggestion to rename raw_pylibcpupower.i to
raw_pylibcpupower.swg.

See:
https://www.swig.org/Doc4.2/SWIG.html

Reviewed-by: John B. Wyatt IV 
Reviewed-by: John B. Wyatt IV 
Tested-by: John B. Wyatt IV 
Tested-by: John B. Wyatt IV 
Signed-off-by: Min-Hua Chen 
Signed-off-by: Shuah Khan

pm:cpupower: Add error warning when SWIG is not installed

2024-09-06T16:58:35+00:00

Add error message to better explain to the user when SWIG and
python-config is missing from the path. Makefile was cleaned up
and unneeded elements were removed.

Suggested-by: Shuah Khan 
Signed-off-by: John B. Wyatt IV 
Signed-off-by: John B. Wyatt IV 
Signed-off-by: Shuah Khan

pm:cpupower: Include test_raw_pylibcpupower.py

2024-09-06T00:50:07+00:00

This script demonstrates how to make use of, and tests, the bindings.

In the future, this script could become part of a larger test suite to
test the bindings and libcpupower.

Signed-off-by: John B. Wyatt IV 
Signed-off-by: John B. Wyatt IV 
Signed-off-by: Shuah Khan

pm:cpupower: Add SWIG bindings files for libcpupower

2024-09-06T00:50:07+00:00

SWIG is a tool packaged in Fedora and other distros that can generate
bindings from C and C++ code for several languages including Python,
Perl, and Go.

These bindings allows users to easily write scripts that use and extend
libcpupower's functionality. Currently, only Python is provided in the
makefile, but additional languages may be added if there is demand.

Added suggestions from Shuah Khan for the README and license discussion.

Note that while SWIG itself is GPL v3+ licensed; the resulting output,
the bindings code, is permissively licensed + the license of the .o
files. Please see
https://swig.org/legal.html and [1] for more details.

[1]
https://lore.kernel.org/linux-pm/Zqv9BOjxLAgyNP5B@hatbackup/

Suggested-by: Shuah Khan 
Signed-off-by: John B. Wyatt IV 
Signed-off-by: John B. Wyatt IV 
Signed-off-by: Shuah Khan