[PATCH v4 0/6] cpupower: fix various man pages issues

[PATCH v4 0/6] cpupower: fix various man pages issues

[Roberto Ricci]

This patch series fixes a few issues with the cpupower manual pages,
such as missing or incorrect options and trailing whitespace.

Signed-off-by: Roberto Ricci <io@r-ricci.it>

---
Changes in v4:
- Remove Fixes tags from commit messages
- Fix issues reported by scripts/checkpatch.pl
- Add patches to trim whitespace from some files
- Add cover letter
  Link to v3: https://lore.kernel.org/linux-pm/20260312102029.14980-1-io@r-ricci.it/

Changes in v3:
- Resend because v2 patches have been incorrectly sent as replies to
  individual v1 messages.
  Links to v2:
  - https://lore.kernel.org/linux-pm/abH7pF9p8KxAsHIE@desktop0a/
  - https://lore.kernel.org/linux-pm/abH9KsKbvyi-iceb@desktop0a/
  - https://lore.kernel.org/linux-pm/abH9rMVuy8wmzgkG@desktop0a/
  - https://lore.kernel.org/linux-pm/abH9_Jk-ckkJvsGb@desktop0a/

Changes in v2:
- More descriptive commit messages
  Links to v1:
  - https://lore.kernel.org/linux-pm/abHAZj9xwfDf5JVZ@desktop0a/
  - https://lore.kernel.org/linux-pm/abHAdH-ggaxUugCy@desktop0a/
  - https://lore.kernel.org/linux-pm/abHAhAg-6gaK0Qn7@desktop0a/
  - https://lore.kernel.org/linux-pm/abHAkgiPg8VDpDoV@desktop0a/
---

Roberto Ricci (6):
  cpupower-frequency-set.1: trim trailing whitespace
  cpupower-idle-info.1: fix short option names
  cpupower-frequency-info.1: trim trailing whitespace
  cpupower-frequency-info.1: use the proper name of the --perf option
  cpupower-frequency-info.1: document --boost and --epp options
  cpupower-info.1: describe the --perf-bias option

 .../cpupower/man/cpupower-frequency-info.1    | 64 ++++++++++---------
 .../cpupower/man/cpupower-frequency-set.1     | 42 ++++++------
 tools/power/cpupower/man/cpupower-idle-info.1 |  4 +-
 tools/power/cpupower/man/cpupower-info.1      |  9 ++-
 4 files changed, 66 insertions(+), 53 deletions(-)

-- 
2.53.0

[PATCH v4 1/6] cpupower-frequency-set.1: trim trailing whitespace

[Roberto Ricci]

Remove useless spaces at the end of some lines in cpupower-frequency-set.1.

Signed-off-by: Roberto Ricci <io@r-ricci.it>
---
 .../cpupower/man/cpupower-frequency-set.1     | 42 +++++++++----------
 1 file changed, 21 insertions(+), 21 deletions(-)

diff --git a/tools/power/cpupower/man/cpupower-frequency-set.1 b/tools/power/cpupower/man/cpupower-frequency-set.1
index b50570221a5b..fded317c8c51 100644
--- a/tools/power/cpupower/man/cpupower-frequency-set.1
+++ b/tools/power/cpupower/man/cpupower-frequency-set.1
@@ -1,52 +1,52 @@
 .TH "CPUPOWER\-FREQUENCY\-SET" "1" "0.1" "" "cpupower Manual"
 .SH "NAME"
-.LP 
+.LP
 cpupower\-frequency\-set \- A small tool which allows to modify cpufreq settings.
 .SH "SYNTAX"
-.LP 
+.LP
 cpupower [ \-c cpu ] frequency\-set [\fIoptions\fP]
 .SH "DESCRIPTION"
-.LP 
+.LP
 cpupower frequency\-set allows you to modify cpufreq settings without having to type e.g. "/sys/devices/system/cpu/cpu0/cpufreq/scaling_set_speed" all the time.
 .SH "OPTIONS"
-.LP 
-.TP 
+.LP
+.TP
 \fB\-d\fR \fB\-\-min\fR <FREQ>
 new minimum CPU frequency the governor may select.
-.TP 
+.TP
 \fB\-u\fR \fB\-\-max\fR <FREQ>
 new maximum CPU frequency the governor may select.
-.TP 
+.TP
 \fB\-g\fR \fB\-\-governor\fR <GOV>
 new cpufreq governor.
-.TP 
+.TP
 \fB\-f\fR \fB\-\-freq\fR <FREQ>
 specific frequency to be set. Requires userspace governor to be available and loaded.
-.TP 
+.TP
 \fB\-r\fR \fB\-\-related\fR
 modify all hardware-related CPUs at the same time
-.TP 
+.TP
 .SH "REMARKS"
-.LP 
+.LP
 By default values are applied on all cores. How to modify single core
 configurations is described in the cpupower(1) manpage in the \-\-cpu option section.
-.LP 
+.LP
 The \-f FREQ, \-\-freq FREQ parameter cannot be combined with any other parameter.
-.LP 
+.LP
 FREQuencies can be passed in Hz, kHz (default), MHz, GHz, or THz by postfixing the value with the wanted unit name, without any space (frequency in kHz =^ Hz * 0.001 =^ MHz * 1000 =^ GHz * 1000000).
-.LP 
+.LP
 On Linux kernels up to 2.6.29, the \-r or \-\-related parameter is ignored.
-.SH "FILES" 
+.SH "FILES"
 .nf
-\fI/sys/devices/system/cpu/cpu*/cpufreq/\fP  
-\fI/proc/cpufreq\fP (deprecated) 
+\fI/sys/devices/system/cpu/cpu*/cpufreq/\fP
+\fI/proc/cpufreq\fP (deprecated)
 \fI/proc/sys/cpu/\fP (deprecated)
-.fi 
+.fi
 .SH "AUTHORS"
-.nf 
-Dominik Brodowski <linux@brodo.de> \- author 
+.nf
+Dominik Brodowski <linux@brodo.de> \- author
 Mattia Dongili<malattia@gmail.com> \- first autolibtoolization
 .fi
 .SH "SEE ALSO"
-.LP 
+.LP
 cpupower\-frequency\-info(1), cpupower(1)
-- 
2.53.0

Re: [PATCH v4 1/6] cpupower-frequency-set.1: trim trailing whitespace

[Shuah Khan]

On 3/23/26 19:35, Roberto Ricci wrote:
> Remove useless spaces at the end of some lines in cpupower-frequency-set.1.

Why are the spaces useless and what happens if you don't
remove them?

> 
> Signed-off-by: Roberto Ricci <io@r-ricci.it>
> ---
>   .../cpupower/man/cpupower-frequency-set.1     | 42 +++++++++----------
>   1 file changed, 21 insertions(+), 21 deletions(-)
> 
> diff --git a/tools/power/cpupower/man/cpupower-frequency-set.1 b/tools/power/cpupower/man/cpupower-frequency-set.1
> index b50570221a5b..fded317c8c51 100644
> --- a/tools/power/cpupower/man/cpupower-frequency-set.1
> +++ b/tools/power/cpupower/man/cpupower-frequency-set.1
> @@ -1,52 +1,52 @@
>   .TH "CPUPOWER\-FREQUENCY\-SET" "1" "0.1" "" "cpupower Manual"
>   .SH "NAME"
> -.LP
> +.LP

thanks,
-- Shuah

Re: [PATCH v4 1/6] cpupower-frequency-set.1: trim trailing whitespace

[Roberto Ricci]

On 2026-03-24 13:59 -0600, Shuah Khan wrote:
> On 3/23/26 19:35, Roberto Ricci wrote:
> > Remove useless spaces at the end of some lines in cpupower-frequency-set.1.
> 
> Why are the spaces useless and what happens if you don't
> remove them?

The trailing spaces seem to be both useless and harmless, since the
output is identical regardless of their presence. I trimmed them from
cpupower-frequency-set.1 for consistency with cpupower-frequency-info.1.
See also my reply to your question about patch 3/6 in this series.

[PATCH v4 2/6] cpupower-idle-info.1: fix short option names

[Roberto Ricci]

The cpupower-idle-info(1) man page describes '-f' as the short form of the
'--silent' option and '-e' as the short form of the '--proc' option.
But they are not correct:

$ cpupower idle-info -f
idle-info: invalid option -- 'f'
invalid or unknown argument
$ cpupower idle-info -e
idle-info: invalid option -- 'e'
invalid or unknown argument

The short form of '--silent' is actually '-s' and the short form of
'--proc' is actually '-o':

cpuidle-info.c:
	{"silent", no_argument, NULL, 's'},
	{"proc", no_argument, NULL, 'o'},

Signed-off-by: Roberto Ricci <io@r-ricci.it>
---
 tools/power/cpupower/man/cpupower-idle-info.1 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tools/power/cpupower/man/cpupower-idle-info.1 b/tools/power/cpupower/man/cpupower-idle-info.1
index 20b6345c53ad..b2f92aba5f5b 100644
--- a/tools/power/cpupower/man/cpupower-idle-info.1
+++ b/tools/power/cpupower/man/cpupower-idle-info.1
@@ -11,10 +11,10 @@ A tool which prints out per cpu idle information helpful to developers and inter
 .SH "OPTIONS"
 .LP
 .TP
-\fB\-f\fR \fB\-\-silent\fR
+\fB\-s\fR \fB\-\-silent\fR
 Only print a summary of all available C-states in the system.
 .TP
-\fB\-e\fR \fB\-\-proc\fR
+\fB\-o\fR \fB\-\-proc\fR
 deprecated.
 Prints out idle information in old /proc/acpi/processor/*/power format. This
 interface has been removed from the kernel for quite some time, do not let
-- 
2.53.0

[PATCH v4 3/6] cpupower-frequency-info.1: trim trailing whitespace

[Roberto Ricci]

Remove useless spaces at the end of some lines in
cpupower-frequency-info.1.

Signed-off-by: Roberto Ricci <io@r-ricci.it>
---
 .../cpupower/man/cpupower-frequency-info.1    | 56 +++++++++----------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/tools/power/cpupower/man/cpupower-frequency-info.1 b/tools/power/cpupower/man/cpupower-frequency-info.1
index 47fdd7218748..e4173417b7c6 100644
--- a/tools/power/cpupower/man/cpupower-frequency-info.1
+++ b/tools/power/cpupower/man/cpupower-frequency-info.1
@@ -1,80 +1,80 @@
 .TH "CPUPOWER\-FREQUENCY\-INFO" "1" "0.1" "" "cpupower Manual"
 .SH "NAME"
-.LP 
+.LP
 cpupower\-frequency\-info \- Utility to retrieve cpufreq kernel information
 .SH "SYNTAX"
-.LP 
+.LP
 cpupower [ \-c cpulist ] frequency\-info [\fIoptions\fP]
 .SH "DESCRIPTION"
-.LP 
+.LP
 A small tool which prints out cpufreq information helpful to developers and interested users.
 .SH "OPTIONS"
-.LP 
-.TP  
+.LP
+.TP
 \fB\-e\fR \fB\-\-debug\fR
 Prints out debug information.
-.TP  
+.TP
 \fB\-f\fR \fB\-\-freq\fR
 Get frequency the CPU currently runs at, according to the cpufreq core.
-.TP  
+.TP
 \fB\-w\fR \fB\-\-hwfreq\fR
 Get frequency the CPU currently runs at, by reading it from hardware (only available to root).
-.TP  
+.TP
 \fB\-l\fR \fB\-\-hwlimits\fR
 Determine the minimum and maximum CPU frequency allowed.
-.TP  
+.TP
 \fB\-d\fR \fB\-\-driver\fR
 Determines the used cpufreq kernel driver.
-.TP  
+.TP
 \fB\-p\fR \fB\-\-policy\fR
 Gets the currently used cpufreq policy.
-.TP  
+.TP
 \fB\-g\fR \fB\-\-governors\fR
 Determines available cpufreq governors.
-.TP  
+.TP
 \fB\-r\fR \fB\-\-related\-cpus\fR
 Determines which CPUs run at the same hardware frequency.
-.TP  
+.TP
 \fB\-a\fR \fB\-\-affected\-cpus\fR
 Determines which CPUs need to have their frequency coordinated by software.
-.TP  
+.TP
 \fB\-s\fR \fB\-\-stats\fR
 Shows cpufreq statistics if available.
-.TP  
+.TP
 \fB\-y\fR \fB\-\-latency\fR
 Determines the maximum latency on CPU frequency changes.
-.TP  
+.TP
 \fB\-o\fR \fB\-\-proc\fR
 Prints out information like provided by the /proc/cpufreq interface in 2.4. and early 2.6. kernels.
-.TP  
+.TP
 \fB\-m\fR \fB\-\-human\fR
 human\-readable output for the \-f, \-w, \-s and \-y parameters.
-.TP  
+.TP
 \fB\-n\fR \fB\-\-no-rounding\fR
 Output frequencies and latencies without rounding off values.
-.TP  
+.TP
 \fB\-c\fR \fB\-\-perf\fR
 Get performances and frequencies capabilities of CPPC, by reading it from hardware (only available on the hardware with CPPC).
 .TP
 .SH "REMARKS"
-.LP 
+.LP
 By default only values of core zero are displayed. How to display settings of
 other cores is described in the cpupower(1) manpage in the \-\-cpu option section.
-.LP 
+.LP
 You can't specify more than one of the output specific options \-o \-e \-a \-g \-p \-d \-l \-w \-f \-y.
-.LP 
+.LP
 You also can't specify the \-o option combined with the \-c option.
 .SH "FILES"
-.nf 
-\fI/sys/devices/system/cpu/cpu*/cpufreq/\fP  
-\fI/proc/cpufreq\fP (deprecated) 
+.nf
+\fI/sys/devices/system/cpu/cpu*/cpufreq/\fP
+\fI/proc/cpufreq\fP (deprecated)
 \fI/proc/sys/cpu/\fP (deprecated)
-.fi 
+.fi
 .SH "AUTHORS"
 .nf
-Dominik Brodowski <linux@brodo.de> \- author 
+Dominik Brodowski <linux@brodo.de> \- author
 Mattia Dongili<malattia@gmail.com> \- first autolibtoolization
 .fi
 .SH "SEE ALSO"
-.LP 
+.LP
 cpupower\-frequency\-set(1), cpupower(1)
-- 
2.53.0

Re: [PATCH v4 3/6] cpupower-frequency-info.1: trim trailing whitespace

[Shuah Khan]

On 3/23/26 19:35, Roberto Ricci wrote:
> Remove useless spaces at the end of some lines in
> cpupower-frequency-info.1.
> 

Why are the spaces useless and what happens if you don't
remove them?

thanks,
-- Shuah

Re: [PATCH v4 3/6] cpupower-frequency-info.1: trim trailing whitespace

[Roberto Ricci]

On 2026-03-24 14:00 -0600, Shuah Khan wrote:
> On 3/23/26 19:35, Roberto Ricci wrote:
> > Remove useless spaces at the end of some lines in
> > cpupower-frequency-info.1.
> 
> Why are the spaces useless and what happens if you don't
> remove them?

They seem to be both useless and harmless. With or without trailing
spaces, the output is identical (tested with both mandoc and groff).
Since I added the new options by copy-pasting the existing ones and
changing the text, my patch added lines with trailing whitespace and
checkpatch.pl complained about this. Removing these spaces from just the
new lines fixes the error, but I decided to remove them from all the
lines in the file for consistency.

Re: [PATCH v4 3/6] cpupower-frequency-info.1: trim trailing whitespace

[Shuah Khan]

On 3/24/26 16:04, Roberto Ricci wrote:
> On 2026-03-24 14:00 -0600, Shuah Khan wrote:
>> On 3/23/26 19:35, Roberto Ricci wrote:
>>> Remove useless spaces at the end of some lines in
>>> cpupower-frequency-info.1.
>>
>> Why are the spaces useless and what happens if you don't
>> remove them?
> 
> They seem to be both useless and harmless. With or without trailing
> spaces, the output is identical (tested with both mandoc and groff).
> Since I added the new options by copy-pasting the existing ones and
> changing the text, my patch added lines with trailing whitespace and
> checkpatch.pl complained about this. Removing these spaces from just the
> new lines fixes the error, but I decided to remove them from all the
> lines in the file for consistency.

Right - I ran these through mandoc - Since they don't change anything,
I would rather not take these whitespace removal patches.

Is there a dependency between the whitespace ones and the other patches?
Can you drop the whitespace ones and send me just the fix patches?

thanks,
-- Shuah

[PATCH v4 4/6] cpupower-frequency-info.1: use the proper name of the --perf option

[Roberto Ricci]

The cpupower-frequency-info(1) man page describes a '--perf' option.
Even though this form is accepted by the program, its proper name is
'--performance'.

cpufreq-info.c:
	{"performance", no_argument,	 NULL,	 'c'},

Signed-off-by: Roberto Ricci <io@r-ricci.it>
---
 tools/power/cpupower/man/cpupower-frequency-info.1 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/power/cpupower/man/cpupower-frequency-info.1 b/tools/power/cpupower/man/cpupower-frequency-info.1
index e4173417b7c6..7fce2b2e0506 100644
--- a/tools/power/cpupower/man/cpupower-frequency-info.1
+++ b/tools/power/cpupower/man/cpupower-frequency-info.1
@@ -53,7 +53,7 @@ human\-readable output for the \-f, \-w, \-s and \-y parameters.
 \fB\-n\fR \fB\-\-no-rounding\fR
 Output frequencies and latencies without rounding off values.
 .TP
-\fB\-c\fR \fB\-\-perf\fR
+\fB\-c\fR \fB\-\-performance\fR
 Get performances and frequencies capabilities of CPPC, by reading it from hardware (only available on the hardware with CPPC).
 .TP
 .SH "REMARKS"
-- 
2.53.0

[PATCH v4 5/6] cpupower-frequency-info.1: document --boost and --epp options

[Roberto Ricci]

`cpupower frequency-info` supports the '--boost' option since the program
was first added with commit 7fe2f6399a84 ("cpupowerutils - cpufrequtils
extended with quite some features"), but the man page lacks it.

'--epp' has been added with commit 5f567afc283f ("cpupower: Add support for
showing energy performance preference") but it has never been added to the
man page.

cpufreq-info.c:
	{"boost",	 no_argument,		 NULL,	 'b'},
	...
	{"epp",		 no_argument,		 NULL,	 'z'},

Signed-off-by: Roberto Ricci <io@r-ricci.it>
---
 tools/power/cpupower/man/cpupower-frequency-info.1 | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tools/power/cpupower/man/cpupower-frequency-info.1 b/tools/power/cpupower/man/cpupower-frequency-info.1
index 7fce2b2e0506..346c2a6e40f4 100644
--- a/tools/power/cpupower/man/cpupower-frequency-info.1
+++ b/tools/power/cpupower/man/cpupower-frequency-info.1
@@ -32,6 +32,12 @@ Gets the currently used cpufreq policy.
 \fB\-g\fR \fB\-\-governors\fR
 Determines available cpufreq governors.
 .TP
+\fB\-b\fR \fB\-\-boost\fR
+Gets the current boost state support.
+.TP
+\fB\-z\fR \fB\-\-epp\fR
+Gets the current EPP (energy performance preference).
+.TP
 \fB\-r\fR \fB\-\-related\-cpus\fR
 Determines which CPUs run at the same hardware frequency.
 .TP
-- 
2.53.0

[PATCH v4 6/6] cpupower-info.1: describe the --perf-bias option

[Roberto Ricci]

The cpupower-info(1) man page only mentions the short form of the
'--perf-bias' option in the synopsys, but the long form is not documented
and its effect is not explained.

cpupower-info.c:
     {"perf-bias", optional_argument, NULL, 'b'},

Signed-off-by: Roberto Ricci <io@r-ricci.it>
---
 tools/power/cpupower/man/cpupower-info.1 | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/tools/power/cpupower/man/cpupower-info.1 b/tools/power/cpupower/man/cpupower-info.1
index 340bcd0be7de..1f42d8c388a0 100644
--- a/tools/power/cpupower/man/cpupower-info.1
+++ b/tools/power/cpupower/man/cpupower-info.1
@@ -3,7 +3,7 @@
 cpupower\-info \- Shows processor power related kernel or hardware configurations
 .SH SYNOPSIS
 .ft B
-.B cpupower info [ \-b ]
+.B cpupower info [\fIoptions\fP]
 
 .SH DESCRIPTION
 \fBcpupower info \fP shows kernel configurations or processor hardware
@@ -13,6 +13,13 @@ Some options are platform wide, some affect single cores. By default values
 of core zero are displayed only. cpupower --cpu all cpuinfo will show the
 settings of all cores, see cpupower(1) how to choose specific cores.
 
+.SH "OPTIONS"
+.LP
+.TP
+\fB\-b\fR \fB\-\-perf-bias\fR
+Gets the current performance bias value.
+.TP
+
 .SH "SEE ALSO"
 Options are described in detail in:
 
-- 
2.53.0