1PSTATES()                                                            PSTATES()
2
3
4

Command 'pstates'

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

Properties

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       (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()
Impressum