logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

powercap-info - get information from the Linux power capping framework

Authors

       Connor Imes <connor.k.imes@gmail.com>

Bugs

       Report bugs upstream at <https://github.com/powercap/powercap>

Description

       Prints configurations for powercap control types.

       Output can be filtered by specifying a control type NAME and OPTION flags.

       A control type NAME must not be empty or contain a '.' or '/'.

Examples

powercap-info
              Print all zones for all control types.

       powercap-infointel-rapl
              Print all zones for the intel-rapl control type.

       powercap-infointel-rapl-z0
              Print only zone 0 for the intel-rapl control type.

       powercap-infointel-rapl-z0:1
              Print zone 0, subzone 1 for the intel-rapl control type.

       powercap-infointel-rapl-z0-c1
              Print zone 0, constraint 1 for the intel-rapl control type.

       powercap-infointel-rapl-z0-j
              Print the energy counter for zone 0 for the intel-rapl control type.

       powercap-infointel-rapl-z1:0-c0-l
              Print the power limit for zone 1, subzone 0, constraint 0 for the intel-rapl control type.

Files

/sys/devices/virtual/powercap/*/sys/class/powercap/*

Name

       powercap-info - get information from the Linux power capping framework

Options

-h,--help
              Prints the help screen

       -v,--verbose
              Print errors when files cannot be read

       -p,--control-type=NAME
              Deprecated, provide NAME as the first positional argument instead.

       All remaining options below require a control type NAME:

       -z,--zone=ZONE(S)
              The  zone/subzone  numbers  in  the control type's powercap tree (control type's root by default).
              Separate zones/subzones with a colon.  E.g., for zone 0, subzone 2:
              -z0:2
              Ending with a colon prevents output for subzones.  E.g., for zone 0, but not subzones:
              -z0:-c,--constraint=CONSTRAINT
              The constraint number

       All remaining options below are mutually exclusive:

       -E,--enabled
              Print control type enabled/disabled status

       -n,--nzones
              Print the number of zones (control type's root by default; within the -z/--zone level, if set)

       The following are zone-level arguments and require -z/--zone:

       -N,--nconstraints
              Print the number of zone constraints

       -j,--z-energy
              Print zone energy counter

       -J,--z-max-energy-range
              Print zone maximum energy counter range

       -w,--z-power
              Print zone current power

       -W,--z-max-power-range
              Print zone maximum current power range

       -e,--z-enabled
              Print zone enabled/disabled status

       -x,--z-name
              Print zone name

       The following are constraint-level arguments and require -z/--zone and -c/--constraint:

       -l,--c-power-limit
              Print constraint power limit

       -s,--c-time-window
              Print constraint time window

       -U,--c-max-power
              Print constraint maximum allowed power

       -u,--c-min-power
              Print constraint minimum allowed power

       -T,--c-max-time-window
              Print constraint maximum allowed time window

       -t,--c-min-time-window
              Print constraint minimum allowed time window

       -y,--c-name
              Print constraint name

Remarks

       Some fields are optional and/or may require administrative (super-user) privileges to read.
       Fields will only be printed if they are available and readable, unless -v/--verbose is set.
       If no subzone/constraint-specific outputs are requested, all available  zones  and  constraints  will  be
       shown.

       Energy units: microjoules (uJ)
       Power units: microwatts (uW)
       Time units: microseconds (us)

See Also

powercap-set(1)

powercap                                           2021-12-12                                   POWERCAP-INFO(1)

Synposis

powercap-info [NAME [OPTION]...] [-hv]

See Also