Struct ByteBudget 

pub struct ByteBudget {
    pub us_per_page: f64,
    pub gb_per_sec: f64,
    pub page_size: usize,
}

Performance budget for byte-oriented operations (compression, I/O). Use this for trueno-zram, disk I/O, network throughput, etc.

PMAT-452: Serializable for hardware.toml export.

Fields

us_per_page: f64

Latency budget per page (microseconds)

gb_per_sec: f64

Throughput target (GB/s)

page_size: usize

Page size in bytes (default 4096)

Implementations

impl ByteBudget

pub fn from_throughput(gb_per_sec: f64) -> Self

Create budget from throughput target (GB/s). 25 GB/s = 0.16µs per 4KB page

pub fn from_latency(us_per_page: f64) -> Self

Create budget from latency target (µs per page).

pub fn with_page_size(self, page_size: usize) -> Self

Set custom page size (e.g., 64KB for huge pages).

pub fn to_token_budget(&self) -> TokenBudget

Convert to TokenBudget (1 token = 1 page). Useful for integrating byte workloads with token-centric monitoring.

pub fn is_met(&self, actual_us_per_page: f64) -> bool

Check if actual performance meets budget.

pub fn utilization(&self, actual_us_per_page: f64) -> f64

Calculate budget utilization.

pub fn throughput_from_latency(us_per_page: f64, page_size: usize) -> f64

Calculate actual throughput from latency.

Trait Implementations

impl Clone for ByteBudget

fn clone(&self) -> ByteBudget

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ByteBudget

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

Formats the value using the given formatter.

impl Default for ByteBudget

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ByteBudget

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ByteBudget

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for ByteBudget