pm: cpupower: Add install and uninstall options to bindings makefile

Installs the .so and .py files generated by SWIG to system's site packages
directory. This allows the Python bindings to be used

pm: cpupower: Add install and uninstall options to bindings makefile

Installs the .so and .py files generated by SWIG to system's site packages
directory. This allows the Python bindings to be used system wide. This
commit also includes documentation on setting up and installing the Python
bindings.

Link: https://lore.kernel.org/r/[email protected]
Signed-off-by: "John B. Wyatt IV" <[email protected]>
Signed-off-by: "John B. Wyatt IV" <[email protected]>
Signed-off-by: Shuah Khan <[email protected]>

show more ...

pm: cpupower: rename raw_pylibcpupower.i

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

We can reproduce the error by performing the following steps:
cd linux-next
make mrpro

pm: cpupower: rename raw_pylibcpupower.i

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 <[email protected]>
Reviewed-by: John B. Wyatt IV <[email protected]>
Tested-by: John B. Wyatt IV <[email protected]>
Tested-by: John B. Wyatt IV <[email protected]>
Signed-off-by: Min-Hua Chen <[email protected]>
Signed-off-by: Shuah Khan <[email protected]>

show more ...

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

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 e

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

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 <[email protected]>
Signed-off-by: John B. Wyatt IV <[email protected]>
Signed-off-by: John B. Wyatt IV <[email protected]>
Signed-off-by: Shuah Khan <[email protected]>

show more ...

pm:cpupower: Add SWIG bindings files for libcpupower

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,

pm:cpupower: Add SWIG bindings files for libcpupower

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 <[email protected]>
Signed-off-by: John B. Wyatt IV <[email protected]>
Signed-off-by: John B. Wyatt IV <[email protected]>
Signed-off-by: Shuah Khan <[email protected]>

show more ...