Logo

The Linux Kernel

6.19.0-rc6

Quick search

Contents

  • Development process
  • Submitting patches
  • Code of conduct
  • Maintainer handbook
  • All development-process docs
  • Core API
  • Driver APIs
  • Subsystems
    • Core subsystems
    • Human interfaces
    • Networking interfaces
      • Networking
      • NetLabel
      • InfiniBand
      • ISDN
      • MHI
    • Storage interfaces
    • Other subsystems
  • Locking
  • Licensing rules
  • Writing documentation
  • Development tools
  • Testing guide
  • Hacking guide
  • Tracing
  • Fault injection
  • Livepatching
  • Rust
  • Administration
  • Build system
  • Reporting issues
  • Userspace tools
  • Userspace API
  • Firmware
  • Firmware and Devicetree
  • CPU architectures
  • Unsorted documentation
  • Translations

This Page

  • Show Source

Family dev-energymodel netlink specification¶

Contents

  • Family dev-energymodel netlink specification

    • Summary

    • Operations

      • get-perf-domains

      • get-perf-table

      • perf-domain-created

      • perf-domain-updated

      • perf-domain-deleted

    • Multicast groups

    • Definitions

      • perf-state-flags

      • perf-domain-flags

    • Attribute sets

      • perf-domain

      • perf-table

      • perf-state

Summary¶

Energy model netlink interface to notify its changes.

Operations¶

get-perf-domains¶

Get the list of information for all performance domains.

attribute-set:

perf-domain

do:
request
attributes:

[perf-domain-id]

reply
attributes:

[pad, perf-domain-id, flags, cpus]

dump:
reply
attributes:

[pad, perf-domain-id, flags, cpus]

get-perf-table¶

Get the energy model table of a performance domain.

attribute-set:

perf-table

do:
request
attributes:

[perf-domain-id]

reply
attributes:

[perf-domain-id, perf-state]

perf-domain-created¶

A performance domain is created.

notify:

get-perf-table

mcgrp:

event

perf-domain-updated¶

A performance domain is updated.

notify:

get-perf-table

mcgrp:

event

perf-domain-deleted¶

A performance domain is deleted.

attribute-set:

perf-table

mcgrp:

event

event:
attributes:

[perf-domain-id]

Multicast groups¶

  • event

Definitions¶

perf-state-flags¶

type:

flags

entries:
perf-state-inefficient:

The performance state is inefficient. There is in this perf-domain, another performance state with a higher frequency but a lower or equal power cost.

perf-domain-flags¶

type:

flags

entries:
perf-domain-microwatts:

The power values are in micro-Watts or some other scale.

perf-domain-skip-inefficiencies:

Skip inefficient states when estimating energy consumption.

perf-domain-artificial:

The power values are artificial and might be created by platform missing real power information.

Attribute sets¶

perf-domain¶

Information on a single performance domains.

pad (pad)¶

perf-domain-id (u32)¶

doc:

A unique ID number for each performance domain.

flags (u64)¶

doc:

Bitmask of performance domain flags.

enum:

perf-domain-flags

cpus (u64)¶

multi-attr:

True

doc:

CPUs that belong to this performance domain.

perf-table¶

Performance states table.

perf-domain-id (u32)¶

doc:

A unique ID number for each performance domain.

perf-state (nest)¶

nested-attributes:

perf-state

multi-attr:

True

perf-state¶

Performance state of a performance domain.

pad (pad)¶

performance (u64)¶

doc:

CPU performance (capacity) at a given frequency.

frequency (u64)¶

doc:

The frequency in KHz, for consistency with CPUFreq.

power (u64)¶

doc:

The power consumed at this level (by 1 CPU or by a registered device). It can be a total power: static and dynamic.

cost (u64)¶

doc:

The cost coefficient associated with this level, used during energy calculation. Equal to: power * max_frequency / frequency.

flags (u64)¶

doc:

Bitmask of performance state flags.

enum:

perf-state-flags

©The kernel development community. | Powered by Sphinx 5.3.0 & Alabaster 0.7.16 | Page source