Enum ClientRequest 

pub enum ClientRequest {
    GetPowercapTree {
        responder: ClientGetPowercapTreeResponder,
    },
    GetPowerLimit {
        node_id: u64,
        responder: ClientGetPowerLimitResponder,
    },
    SetPowerLimit {
        node_id: u64,
        power_limit_uw: u64,
        responder: ClientSetPowerLimitResponder,
    },
    GetPowerLimitBypass {
        node_id: u64,
        responder: ClientGetPowerLimitBypassResponder,
    },
    SetPowerLimitBypass {
        node_id: u64,
        bypass_time_ms: u64,
        responder: ClientSetPowerLimitBypassResponder,
    },
    #[non_exhaustive]
    _UnknownMethod {
        ordinal: u64,
        control_handle: ClientControlHandle,
        method_type: MethodType,
    },
}

Protocol used by Starnix to build and interact with the /sys/class/powercap hierarchy backed by Power Manager’s PowercapController.

Variants

GetPowercapTree

Retrieves the static powercap zone topology at container initialization.

Fields

responder: ClientGetPowercapTreeResponder

GetPowerLimit

Reads the current constraint_0_power_limit_uw for node_id.

Before SetPowerLimit is called, returns the zone’s initial unthrottled limit (max_power_uw, or the highest entry in power_levels_uw if max_power_uw is omitted, or 0 if neither is configured).

Returns PowercapError.INVALID_ARGUMENTS if node_id is unknown or refers to an unconstrained container zone.

Fields

node_id: u64

responder: ClientGetPowerLimitResponder

SetPowerLimit

Writes constraint_0_power_limit_uw for node_id (in microwatts).

Returns PowercapError.INVALID_ARGUMENTS if node_id is unknown or refers to an unconstrained container zone.

Fields

node_id: u64

power_limit_uw: u64

responder: ClientSetPowerLimitResponder

GetPowerLimitBypass

Reads the remaining bypass duration in milliseconds (power_limit_bypass_msec). Returns 0 if no bypass is currently active.

Returns PowercapError.INVALID_ARGUMENTS if node_id is unknown or if supports_bypass is not enabled on the target zone.

Fields

node_id: u64

responder: ClientGetPowerLimitBypassResponder

SetPowerLimitBypass

Sets or clears the power limit bypass timer (power_limit_bypass_msec).

A value of 0 immediately cancels any active bypass and restores the cached thermal power limit. Setting a non-zero bypass_time_ms while a bypass is already active replaces the active timer deadline with a new deadline bypass_time_ms from now.

Returns PowercapError.INVALID_ARGUMENTS if node_id is unknown or if supports_bypass is not enabled on the target zone.

Fields

node_id: u64

bypass_time_ms: u64

responder: ClientSetPowerLimitBypassResponder

#[non_exhaustive]

_UnknownMethod

An interaction was received which does not match any known method.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

ordinal: u64

Ordinal of the method that was called.

control_handle: ClientControlHandle

method_type: MethodType

Implementations

impl ClientRequest

pub fn into_get_powercap_tree(self) -> Option<ClientGetPowercapTreeResponder>

pub fn into_get_power_limit(self) -> Option<(u64, ClientGetPowerLimitResponder)>

pub fn into_set_power_limit( self, ) -> Option<(u64, u64, ClientSetPowerLimitResponder)>

pub fn into_get_power_limit_bypass( self, ) -> Option<(u64, ClientGetPowerLimitBypassResponder)>

pub fn into_set_power_limit_bypass( self, ) -> Option<(u64, u64, ClientSetPowerLimitBypassResponder)>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for ClientRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.