1PSTATES() PSTATES()
2
3
4
6 General options
7 -h Show a short help message and exit.
8
9 -q Be quiet.
10
11 -d Print debugging information.
12
13 --version
14 Print version and exit.
15
16 -H HOSTNAME, --host HOSTNAME
17 Name of the host to run the command on.
18
19 -U USERNAME, --username USERNAME
20 Name of the user to use for logging into the remote host over
21 SSH. The default user name is 'root'.
22
23 -K PRIVKEY, --priv-key PRIVKEY
24 Path to the private SSH key that should be used for logging into
25 the remote host. By default the key is automatically found from
26 standard paths like '$HOME/.ssh'.
27
28 -T TIMEOUT, --timeout TIMEOUT
29 SSH connection timeout in seconds, default is 8.
30
31 -D DATASET, --dataset DATASET
32 This option is for debugging and testing purposes only, it de‐
33 fines the dataset that will be used to emulate a host for run‐
34 ning the command on. This option is typically used when running
35 'pepc' from the source directory, which includes datasets for
36 many different systems.
37
38 The argument can be the dataset path, 'all' to specify all
39 available dataset or name in which case the following locations
40 will be searched for.
41
42 1. './tests/data', in the directory of the running program
43
44 2. '$PEPC_DATA_PATH/tests/data'
45
46 3. '$HOME/.local/share/pepc/tests/data'
47
48 4. '/usr/local/share/pepc/tests/data'
49
50 5. '/usr/share/pepc/tests/data'
51
52 --force-color
53 Force coloring of the text output.
54
55 Subcommand 'info'
56 Get P-states information for specified CPUs. By default, prints all
57 information for all CPUs.
58
59 --cpus CPUS
60 List of CPUs to get information about. The list can include in‐
61 dividual CPU numbers and CPU number ranges. For exam‐
62 ple,'1-4,7,8,10-12' would mean CPUs 1 to 4, CPUs 7, 8, and 10 to
63 12. Use the special keyword 'all' to specify all CPUs.
64
65 --cores CORES
66 List of cores to get information about. The list can include
67 individual core numbers and core number ranges. For example,
68 '1-4,7,8,10-12' would mean cores 1 to 4, cores 7, 8, and 10 to
69 1. Use the special keyword 'all' to specify all cores. This
70 option has to be accompanied by '--package' option, because core
71 numbers are per-package.
72
73 --packages PACKAGES
74 List of packages to get information about. The list can include
75 individual package numbers and package number ranges. For exam‐
76 ple, '0,2-4' would mean package 0 and packages 2 to 4. Use the
77 special keyword 'all' to specify all packages.
78
79 --core-siblings CORE_SIBLINGS
80 List of core sibling indices to get information about. The list
81 can include individual core sibling indices or index ranges.
82 For example, core x includes CPUs 3 and 4, '0' would mean CPU 3
83 and '1' would mean CPU 4. This option can only be used to ref‐
84 erence online CPUs, because Linux does not provide topology in‐
85 formation for offline CPUs. In the previous example if CPU 3
86 was offline, then '0' would mean CPU 4.
87
88 --yaml Print information in YAML format.
89
90 --override-cpu-model
91 This option is for debugging and testing purposes only. Provide
92 the CPU model number which the tool treats the target system CPU
93 as. For example, use 0x8F to treat the target system as Sap‐
94 phire Rapids Xeon.
95
96 --min-freq
97 Get minimum CPU frequency (details in 'min_freq').
98
99 --max-freq
100 Get maximum CPU frequency (details in 'max_freq').
101
102 --min-freq-limit
103 Get minimum supported CPU frequency (details in 'min_freq_lim‐
104 it').
105
106 --max-freq-limit
107 Get maximum supported CPU frequency (details in 'max_freq_lim‐
108 it').
109
110 --base-freq
111 Get base CPU frequency (details in 'base_freq').
112
113 --min-freq-hw
114 Get minimum CPU frequency (OS bypass) (details in
115 'min_freq_hw').
116
117 --max-freq-hw
118 Get maximum CPU frequency (OS bypass) (details in
119 'max_freq_hw').
120
121 --bus-clock
122 Get bus clock speed (details in 'bus_clock').
123
124 --min-oper-freq
125 Get minimum CPU operating frequency (details in 'min_op‐
126 er_freq').
127
128 --max-eff-freq
129 Get maximum CPU efficiency frequency (details in
130 'max_eff_freq').
131
132 --turbo
133 Get current setting for turbo (details in 'turbo').
134
135 --max-turbo-freq
136 Get maximum CPU turbo frequency (details in 'max_turbo_freq').
137
138 --min-uncore-freq
139 Get minimum uncore frequency (details in 'min_uncore_freq').
140
141 --max-uncore-freq
142 Get maximum uncore frequency (details in 'max_uncore_freq').
143
144 --min-uncore-freq-limit
145 Get minimum supported uncore frequency (details in 'min_un‐
146 core_freq_limit').
147
148 --max-uncore-freq-limit
149 Get maximum supported uncore frequency (details in 'max_un‐
150 core_freq_limit').
151
152 --hwp Get current setting for hardware power management (details in
153 'hwp').
154
155 --epp Get EPP via sysfs (details in 'epp').
156
157 --epp-hw
158 Get EPP via MSR (details in 'epp_hw').
159
160 --epb Get EPB via sysfs (details in 'epb').
161
162 --epb-hw
163 Get EPB via MSR (details in 'epb_hw').
164
165 --driver
166 Get CPU frequency driver (details in 'driver').
167
168 --intel-pstate-mode
169 Get operation mode of 'intel_pstate' driver (details in 'in‐
170 tel_pstate_mode').
171
172 --governor
173 Get CPU frequency governor (details in 'governor').
174
175 --governors
176 Get list of available CPU frequency governors (details in 'gov‐
177 ernors').
178
179 Subcommand 'config'
180 Configure P-states on specified CPUs. All options can be used without
181 a parameter, in which case the currently configured value(s) will be
182 printed.
183
184 --cpus CPUS
185 List of CPUs to configure P-States on. The list can include in‐
186 dividual CPU numbers and CPU number ranges. For exam‐
187 ple,'1-4,7,8,10-12' would mean CPUs 1 to 4, CPUs 7, 8, and 10 to
188 12. Use the special keyword 'all' to specify all CPUs.
189
190 --cores CORES
191 List of cores to configure P-States on. The list can include
192 individual core numbers and core number ranges. For example,
193 '1-4,7,8,10-12' would mean cores 1 to 4, cores 7, 8, and 10 to
194 12. Use the special keyword 'all' to specify all cores. This
195 option has to be accompanied by '--package' option, because core
196 numbers are per-package.
197
198 --packages PACKAGES
199 List of packages to configure P-States on. The list can include
200 individual package numbers and package number ranges. For exam‐
201 ple, '0,2-4' would mean package 0 and packages 2 to 4. Use the
202 special keyword 'all' to specify all packages.
203
204 --core-siblings CORE_SIBLINGS
205 List of core sibling indices to configure P-States on. The list
206 can include individual core sibling indices or index ranges.
207 For example, core x includes CPUs 3 and 4, '0' would mean CPU 3
208 and '1' would mean CPU 4. This option can only be used to ref‐
209 erence online CPUs, because Linux does not provide topology in‐
210 formation for offline CPUs. In the previous example if CPU 3
211 was offline, then '0' would mean CPU 4.
212
213 --override-cpu-model
214 This option is for debugging and testing purposes only. Provide
215 the CPU model number which the tool treats the target system CPU
216 as. For example, use 0x8F to treat the target system as Sap‐
217 phire Rapids Xeon.
218
219 --min-freq [MIN_FREQ]
220 Set minimum CPU frequency (details in 'min_freq').
221
222 --max-freq [MAX_FREQ]
223 Set maximum CPU frequency (details in 'max_freq').
224
225 --min-freq-hw [MIN_FREQ_HW]
226 Set minimum CPU frequency (OS bypass) (details in 'min_freq_lim‐
227 it').
228
229 --max-freq-hw [MAX_FREQ_HW]
230 Set maximum CPU frequency (OS bypass) (details in 'max_freq_lim‐
231 it').
232
233 --turbo [TURBO]
234 Enable or disable turbo (details in 'turbo').
235
236 --min-uncore-freq [MIN_UNCORE_FREQ]
237 Set minimum uncore frequency (details in 'min_uncore_freq').
238
239 --max-uncore-freq [MAX_UNCORE_FREQ]
240 Set maximum uncore frequency (details in 'max_uncore_freq').
241
242 --epp [EPP]
243 Set EPP via sysfs (details in 'epp').
244
245 --epp-hw [EPP_HW]
246 Set EPP via MSR (details in 'epp_hw').
247
248 --epb [EPB]
249 Set EPB via sysfs (details in 'epb').
250
251 --epb-hw [EPB_HW]
252 Set EPB via MSR (details in 'epb_hw').
253
254 --intel-pstate-mode [INTEL_PSTATE_MODE]
255 Set operation mode of 'intel_pstate' driver (details in 'in‐
256 tel_pstate_mode').
257
258 --governor [GOVERNOR]
259 Set CPU frequency governor (details in 'governor').
260
261 Subcommand 'save'
262 Save all the modifiable P-state settings into a file. This file can
263 later be used for restoring P-state settings with the 'pepc pstates re‐
264 store' command.
265
266 --cpus CPUS
267 List of CPUs to save P-state information about. The list can
268 include individual CPU numbers and CPU number ranges. For exam‐
269 ple,'1-4,7,8,10-12' would mean CPUs 1 to 4, CPUs 7, 8, and 10 to
270 12. Use the special keyword 'all' to specify all CPUs.
271
272 --cores CORES
273 List of cores to save P-state information about. The list can
274 include individual core numbers and core number ranges. For ex‐
275 ample, '1-4,7,8,10-12' would mean cores 1 to 4, cores 7, 8, and
276 10 to 12. Use the special keyword 'all' to specify all cores.
277 This option has to be accompanied by '--package' option, because
278 core numbers are per-package.
279
280 --packages PACKAGES
281 List of packages to save P-state information about. The list
282 can include individual package numbers and package number
283 ranges. For example, '0,2-4' would mean package 0 and packages
284 2 to 4. Use the special keyword 'all' to specify all packages.
285
286 --core-siblings CORE_SIBLINGS
287 List of core sibling indices to save P-state information about.
288 The list can include individual core sibling indices or index
289 ranges. For example, core x includes CPUs 3 and 4, '0' would
290 mean CPU 3 and '1' would mean CPU 4. This option can only be
291 used to reference online CPUs, because Linux does not provide
292 topology information for offline CPUs. In the previous example
293 if CPU 3 was offline, then '0' would mean CPU 4.
294
295 -o OUTFILE, --outfile OUTFILE
296 Name of the file to save the settings to (printed to standard
297 output by default).
298
299 Subcommand 'restore'
300 Restore P-state settings from a file previously created with the 'pepc
301 pstates save' command.
302
303 -f INFILE, --from INFILE
304 Name of the file from which to restore the settings from, use
305 "-" to read from the standard output.
306
307 * * * * *
308
310 min_freq
311 min_freq - Minimum CPU frequency
312
313 Synopsis
314 pepc pstates info [--min-freq]
315 pepc pstates config [--min-freq=<value>]
316
317 Description
318 Minimum CPU frequency is the lowest frequency the OS configured the CPU
319 to run at, via sysfs knobs.
320
321 The default unit is "Hz", but "kHz", "MHz", and "GHz" can also be used
322 (for example "900MHz").
323
324 The following special values are supported:
325
326 "min" Minimum CPU frequency supported (see 'min_freq_limit').
327
328 "max" Maximum CPU frequency supported (see 'max_freq_limit').
329
330 "base", "hfm", "P1"
331 Base CPU frequency (see 'base_freq').
332
333 "eff", "lfm", "Pn"
334 Maximum CPU efficiency frequency (see 'max_eff_freq').
335
336 "Pm" Minimum CPU operating frequency (see 'min_oper_freq').
337
338 Source
339 "/sys/devices/system/cpu/policy0/scaling_min_freq", '0' is replaced
340 with desired CPU number.
341
342 Scope
343 This property has CPU scope.
344
345 * * * * *
346
347 max_freq
348 max_freq - Maximum CPU frequency
349
350 Synopsis
351 pepc pstates info [--max-freq]
352 pepc pstates config [--max-freq=<value>]
353
354 Description
355 Maximum CPU frequency is the lowest frequency the OS configured the CPU
356 to run at, via sysfs knobs.
357
358 The default unit is "Hz", but "kHz", "MHz", and "GHz" can also be used
359 (for example "900MHz").
360
361 The following special values are supported:
362
363 "min" Minimum CPU frequency supported (see 'min_freq_limit').
364
365 "max" Maximum CPU frequency supported (see 'max_freq_limit').
366
367 "base", "hfm", "P1"
368 Base CPU frequency (see 'base_freq').
369
370 "eff", "lfm", "Pn"
371 Maximum CPU efficiency frequency (see 'max_eff_freq').
372
373 "Pm" Minimum CPU operating frequency (see 'min_oper_freq').
374
375 Source
376 "/sys/devices/system/cpu/policy0/scaling_max_freq", '0' is replaced
377 with desired CPU number.
378
379 Scope
380 This property has CPU scope.
381
382 * * * * *
383
384 min_freq_limit
385 min_freq_limit - Minimum supported CPU frequency
386
387 Synopsis
388 pepc pstates info [--min-freq-limit]
389
390 Description
391 Minimum supported CPU frequency is the minimum CPU frequency supported
392 by the OS.
393
394 Source
395 "/sys/devices/system/cpu/policy0/cpuinfo_min_freq", '0' is replaced
396 with desired CPU number.
397
398 Scope
399 This property has CPU scope.
400
401 * * * * *
402
403 max_freq_limit
404 max_freq_limit - Maximum supported CPU frequency
405
406 Synopsis
407 pepc pstates info [--min-freq-limit]
408
409 Description
410 Maximum supported CPU frequency is the maximum CPU frequency supported
411 by the OS.
412
413 Source
414 "/sys/devices/system/cpu/policy0/cpuinfo_max_freq", '0' is replaced
415 with desired CPU number.
416
417 Scope
418 This property has CPU scope.
419
420 * * * * *
421
422 base_freq
423 base_freq - Base CPU frequency
424
425 Synopsis
426 pepc pstates info [--base-freq]
427
428 Description
429 Base CPU frequency is the highest sustainable CPU frequency. This fre‐
430 quency is also referred to as "guaranteed frequency", HFM (High Fre‐
431 quency Mode), or P1.
432
433 The base frequency is acquired from a sysfs file or from an MSR regis‐
434 ter, if the sysfs file does not exist.
435
436 Source
437 "/sys/devices/system/cpu/policy0/base_frequency", '0' is replaced with
438 desired CPU number.
439
440 If the sysfs path does not exists, falls back to MSR_PLATFORM_INFO
441 [1m(0xCE), bits 15:8.
442
443 Scope
444 This property has CPU scope.
445
446 * * * * *
447
448 min_freq_hw
449 min_freq_hw - Minimum CPU frequency
450
451 Synopsis
452 pepc pstates info [--min-freq-hw]
453 pepc pstates config [--min-freq-hw=<value>]
454
455 Description
456 Minimum frequency the CPU is configured to run at. This value is read
457 directly from the MSR, bypassing the OS.
458
459 The default unit is "Hz", but "kHz", "MHz", and "GHz" can also be used
460 (for example "900MHz").
461
462 The following special values are supported:
463
464 "min" Minimum CPU frequency supported (see 'min_freq_limit').
465
466 "max" Maximum CPU frequency supported (see 'max_freq_limit').
467
468 "base", "hfm", "P1"
469 Base CPU frequency (see 'base_freq').
470
471 "eff", "lfm", "Pn"
472 Maximum CPU efficiency frequency (see 'max_eff_freq').
473
474 "Pm" Minimum CPU operating frequency (see 'min_oper_freq').
475
476 Source
477 MSR_HWP_REQUEST (0x774), bits 7:0.
478
479 Scope
480 This property has CPU scope.
481
482 * * * * *
483
484 max_freq_hw
485 max_freq_hw - Maximum CPU frequency
486
487 Synopsis
488 pepc pstates info [--max-freq-hw]
489 pepc pstates config [--max-freq-hw=<value>]
490
491 Description
492 Maximum frequency the CPU is configured to run at. This value is read
493 directly from the MSR, bypassing the OS.
494
495 The default unit is "Hz", but "kHz", "MHz", and "GHz" can also be used
496 (for example "900MHz").
497
498 The following special values are supported:
499
500 "min" Minimum CPU frequency supported (see 'min_freq_limit').
501
502 "max" Maximum CPU frequency supported (see 'max_freq_limit').
503
504 "base", "hfm", "P1"
505 Base CPU frequency (see 'base_freq').
506
507 "eff", "lfm", "Pn"
508 Maximum CPU efficiency frequency (see 'max_eff_freq').
509
510 "Pm" Minimum CPU operating frequency (see 'min_oper_freq').
511
512 Source
513 MSR_HWP_REQUEST (0x774), bits 15:8.
514
515 Scope
516 This property has CPU scope.
517
518 * * * * *
519
520 bus_clock
521 bus_clock - Bus clock speed.
522
523 Synopsis
524 pepc pstates info [--bus-clock]
525
526 Description
527 Bus clock refers to how quickly the system bus can move data from one
528 computer component to the other.
529
530 Source
531 MSR_FSB_FREQ (0xCD), bits 2:0. For platforms that don't support
532 MSR_FSB_FREQ, 100.0MHz is used.
533
534 Scope
535 This property has package scope. With the following exception, Silver‐
536 monts and Airmonts have module scope.
537
538 * * * * *
539
540 min_oper_freq
541 min_oper_freq - Minimum CPU operating frequency
542
543 Synopsis
544 pepc pstates info [--min-oper-freq]
545
546 Description
547 Minimum operating frequency is the lowest possible frequency the CPU
548 can operate at. Depending on the CPU model, this frequency may or may
549 not be directly available to the OS, but the platform may use it in
550 certain situations (e.g., in some C-states). This frequency is also
551 referred to as Pm.
552
553 Source
554 MSR_PLATFORM_INFO (0xCE), bits 55:48.
555
556 Scope
557 This property has CPU scope.
558
559 * * * * *
560
561 max_eff_freq
562 max_eff_freq - Maximum CPU efficiency frequency
563
564 Synopsis
565 pepc pstates info [--max-eff-freq]
566
567 Description
568 Maximum efficiency frequency is the most energy efficient CPU frequen‐
569 cy. This frequency is also referred to as LFM (Low Frequency Mode) or
570 Pn.
571
572 Source
573 MSR_PLATFORM_INFO (0xCE), bits 47:40.
574
575 Scope
576 This property has CPU scope.
577
578 * * * * *
579
580 turbo
581 turbo - Turbo
582
583 Synopsis
584 pepc pstates info [--turbo]
585 pepc pstates config [--turbo=<value>]
586
587 Description
588 When turbo is enabled, the CPUs can automatically run at a frequency
589 greater than base frequency.
590
591 Source
592 Location of the turbo knob in sysfs depends on the CPU frequency driv‐
593 er.
594
595 intel_pstate - "/sys/devices/system/cpu/intel_pstate/no_turbo"
596
597 acpi-cpufreq - "/sys/devices/system/cpu/cpufreq/boost"
598
599 Scope
600 This property has global scope.
601
602 * * * * *
603
604 max_turbo_freq
605 max_turbo_freq - Maximum CPU turbo frequency
606
607 Synopsis
608 pepc pstates info [--max-eff-freq]
609
610 Description
611 Maximum 1-core turbo frequency is the highest frequency a single CPU
612 can operate at. This frequency is also referred to as max. 1-core
613 turbo and P01.
614
615 Source
616 MSR_TURBO_RATIO_LIMIT (0x1AD), bits 7:0.
617
618 Scope
619 This property has CPU scope.
620
621 * * * * *
622
623 min_uncore_freq
624 min_uncore_freq - Minimum uncore frequency
625
626 Synopsis
627 pepc pstates info [--min-uncore-freq]
628 pepc pstates config [--min-uncore-freq=<value>]
629
630 Description
631 Minimum CPU frequency is the lowest frequency the OS configured the CPU
632 to run at, via sysfs knobs.
633
634 The default unit is "Hz", but "kHz", "MHz", and "GHz" can also be used
635 (for example "900MHz").
636
637 The following special values are supported:
638
639 "min" Minimum CPU frequency supported (see 'min_freq_limit').
640
641 "max" Maximum CPU frequency supported (see 'max_freq_limit').
642
643 Source
644 "/sys/devices/system/cpu/intel_uncore_frequency/pack‐
645 age_00_die_01/min_freq_khz", '00' is replaced with desired package num‐
646 ber and '01' with desired die number.
647
648 Scope
649 This property has die scope.
650
651 * * * * *
652
653 max_uncore_freq
654 max_uncore_freq - Maximum uncore frequency
655
656 Synopsis
657 pepc pstates info [--max-uncore-freq]
658 pepc pstates config [--max-uncore-freq=<value>]
659
660 Description
661 Maximum CPU frequency is the highest frequency the OS configured the
662 CPU to run at, via sysfs knobs.
663
664 The default unit is "Hz", but "kHz", "MHz", and "GHz" can also be used
665 (for example "900MHz").
666
667 The following special values are supported:
668
669 "min" Minimum CPU frequency supported (see 'min_freq_limit').
670
671 "max" Maximum CPU frequency supported (see 'max_freq_limit').
672
673 Source
674 "/sys/devices/system/cpu/intel_uncore_frequency/pack‐
675 age_00_die_01/max_freq_khz", '00' is replaced with desired package num‐
676 ber and '01' with desired die number.
677
678 Scope
679 This property has die scope.
680
681 * * * * *
682
683 min_uncore_freq_limit
684 min_uncore_freq_limit - Minimum supported uncore frequency
685
686 Synopsis
687 pepc pstates info [--min-uncore-freq-limit]
688
689 Description
690 Minimum supported uncore frequency is the lowest uncore frequency sup‐
691 ported by the OS.
692
693 Source
694 "/sys/devices/system/cpu/intel_uncore_frequency/package_00_die_01/ini‐
695 tial_min_freq_khz", '00' is replaced with desired package number and
696 '01' with desired die number.
697
698 Scope
699 This property has die scope.
700
701 * * * * *
702
703 max_uncore_freq_limit
704 max_uncore_freq_limit - Maximum supported uncore frequency
705
706 Synopsis
707 pepc pstates info [--max-uncore-freq-limit]
708
709 Description
710 Maximum supported uncore frequency is the highest uncore frequency sup‐
711 ported by the OS.
712
713 Source
714 "/sys/devices/system/cpu/intel_uncore_frequency/package_00_die_01/ini‐
715 tial_max_freq_khz", '00' is replaced with desired package number and
716 '01' with desired die number.
717
718 Scope
719 This property has die scope.
720
721 * * * * *
722
723 hwp
724 hwp - Hardware power management
725
726 Synopsis
727 pepc pstates info [--hwp]
728
729 Description
730 When hardware power management is enabled, CPUs can automatically scale
731 their frequency without active OS involvement.
732
733 Source
734 MSR_PM_ENABLE (0x770), bit 0.
735
736 Scope
737 This property has global scope.
738
739 * * * * *
740
741 epp
742 epp - Energy Performance Preference
743
744 Synopsis
745 pepc pstates info [--epp]
746 pepc pstates config [--epp=<value>]
747
748 Description
749 Energy Performance Preference is a hint to the CPU on energy efficiency
750 vs performance. EPP value is a number in range of 0-255 (maximum ener‐
751 gy efficiency to maximum performance), or a policy name.
752
753 Source
754 "/sys/devices/system/cpu/cpufreq/policy0/energy_performance_prefer‐
755 ence", '0' is replaced with desired CPU number.
756
757 Scope
758 This property has CPU scope.
759
760 * * * * *
761
762 epp_hw
763 epp_hw - Energy Performance Preference
764
765 Synopsis
766 pepc pstates info [--epp-hw]
767 pepc pstates config [--epp-hw=<value>]
768
769 Description
770 Energy Performance Preference is a hint to the CPU on energy efficiency
771 vs performance. EPP value is a number in range of 0-255 (maximum ener‐
772 gy efficiency to maximum performance).
773
774 When package control is enabled the value is read from MSR_HWP_RE‐
775 QUEST_PKG 0x772, but when written package control is disabled and value
776 is written to MSR_HWP_REQUEST 0x774, both require the 'msr' Linux ker‐
777 nel driver.
778
779 Source
780 MSR_HWP_REQUEST (0x774), bits 31:24.
781
782 Scope
783 This property has CPU scope.
784
785 * * * * *
786
787 epb
788 epb - Energy Performance Bias
789
790 Synopsis
791 pepc pstates info [--epb]
792 pepc pstates config [--epb=<value>]
793
794 Description
795 Energy Performance Bias is a hint to the CPU on energy efficiency vs
796 performance. EBP value is a number in range of 0-15 (maximum perfor‐
797 mance to maximum energy efficiency), or a policy name.
798
799 Source
800 "/sys/devices/system/cpu/cpu0/power/energy_perf_bias", '0' is replaced
801 with desired CPU number.
802
803 Scope
804 This property has CPU scope.
805
806 * * * * *
807
808 epb_hw
809 epb_hw - Energy Performance Preference
810
811 Synopsis
812 pepc pstates info [--epb-hw]
813 pepc pstates config [--epb-hw=<value>]
814
815 Description
816 Energy Performance Bias is a hint to the CPU on energy efficiency vs
817 performance. EBP value is a number in range of 0-15 (maximum perfor‐
818 mance to maximum energy efficiency).
819
820 Source
821 MSR_ENERGY_PERF_BIAS (0x1B0), bits 3:0.
822
823 Scope
824 This property has CPU scope. With the following exceptions, Silver‐
825 monts have core scope, Westmeres and Sandybridges have package scope.
826
827 * * * * *
828
829 driver
830 driver - CPU frequency driver
831
832 Synopsis
833 pepc pstates info [--driver]
834
835 Description
836 CPU frequency driver enumerates and requests the P-states available on
837 the platform.
838
839 Source
840 "/sys/devices/system/cpu/cpufreq/policy0/scaling_driver", '0' is re‐
841 placed with desired CPU number.
842
843 Scope
844 This property has global scope.
845
846 * * * * *
847
848 intel_pstate_mode
849 intel_pstate_mode - Operation mode of 'intel_pstate' driver
850
851 Synopsis
852 pepc pstates info [--intel-pstate-mode]
853 pepc pstates config [--intel-pstate-mode=<value>]
854
855 Description
856 The 'intel_pstate' driver has 3 operation modes: 'active', 'passive'
857 and 'off'. The main difference between the active and passive mode is
858 in which frequency governors are used - the generic Linux governors
859 (passive mode) or the custom, built-in 'intel_pstate' driver governors
860 (active mode).
861
862 Source
863 "/sys/devices/system/cpu/intel_pstate/status"
864
865 Scope
866 This property has global scope.
867
868 * * * * *
869
870 governor
871 governor - CPU frequency governor
872
873 Synopsis
874 pepc pstates info [--governor]
875 pepc pstates config [--governor=<value>]
876
877 Description
878 CPU frequency governor decides which P-state to select on a CPU depend‐
879 ing on CPU business and other factors.
880
881 Source
882 "/sys/devices/system/cpu/cpufreq/policy0/scaling_governor", '0' is re‐
883 placed with desired CPU number.
884
885 Scope
886 This property has CPU scope.
887
888 * * * * *
889
890 governors
891 governors - Available CPU frequency governors
892
893 Synopsis
894 pepc pstates info [--governors]
895
896 Description
897 CPU frequency governors decide which P-state to select on a CPU depend‐
898 ing on CPU business and other factors. Different governors implement
899 different selection policy.
900
901 Source
902 "/sys/devices/system/cpu/cpufreq/policy0/scaling_available_governors",
903 '0' is replaced with desired CPU number.)
904
905 Scope
906 This property has global scope.
907
908
909
910 09-03-2023 PSTATES()