Struct devices::virtcpufreq_v2::VirtCpufreqV2

pub struct VirtCpufreqV2 {

    vcpu_freq_table: Vec<u32>,
    pcpu_fmax: u32,
    pcpu_capacity: u32,
    pcpu: u32,
    util_factor: u32,
    freqtbl_sel: u32,
    vcpu_domain: u32,
    domain_uclamp_min: Option<File>,
    domain_uclamp_max: Option<File>,
    vcpu_fmax: u32,
    vcpu_capacity: u32,
    vcpu_relative_capacity: u32,
    worker: Option<WorkerThread<()>>,
    timer: Arc<Mutex<Timer>>,
    vm_ctrl: Arc<Mutex<Tube>>,
    pcpu_min_cap: u32,
    largest_pcpu_idx: usize,
    shared_domain_vcpus: Vec<usize>,
    shared_domain_perf: Arc<AtomicU32>,
}

Upstream linux compatible version of the virtual cpufreq interface

Fields

vcpu_freq_table: Vec<u32>

pcpu_fmax: u32

pcpu_capacity: u32

pcpu: u32

util_factor: u32

freqtbl_sel: u32

vcpu_domain: u32

domain_uclamp_min: Option<File>

domain_uclamp_max: Option<File>

vcpu_fmax: u32

vcpu_capacity: u32

vcpu_relative_capacity: u32

worker: Option<WorkerThread<()>>

timer: Arc<Mutex<Timer>>

vm_ctrl: Arc<Mutex<Tube>>

pcpu_min_cap: u32

largest_pcpu_idx: usize

The largest(or the last) pCPU index to be used by all the vCPUs. This index is used to figure out the proper placement of the throttle workers which are placed on pCPUs right after the last pCPU being used the vCPUs. Throttle workers require their own exclusive pCPU allocation and this ensure that the workers are placed contiguously and makes it easier for user to manage pCPU allocations when running multiple instances on a large server.

shared_domain_vcpus: Vec<usize>

shared_domain_perf: Arc<AtomicU32>

Implementations

impl VirtCpufreqV2

pub fn new( pcpu: u32, vcpu_freq_table: Vec<u32>, vcpu_domain_path: Option<PathBuf>, vcpu_domain: u32, vcpu_capacity: u32, largest_pcpu_idx: usize, vm_ctrl: Arc<Mutex<Tube>>, shared_domain_vcpus: Vec<usize>, shared_domain_perf: Arc<AtomicU32> ) -> Self

Trait Implementations

impl BusDevice for VirtCpufreqV2

fn device_id(&self) -> DeviceId

Returns a unique id per device type suitable for metrics gathering.

fn debug_label(&self) -> String

Returns a label suitable for debug output.

fn read(&mut self, info: BusAccessInfo, data: &mut [u8])

Reads at offset from this device

fn write(&mut self, info: BusAccessInfo, data: &[u8])

Writes at offset into this device

fn config_register_write( &mut self, reg_idx: usize, offset: u64, data: &[u8] ) -> ConfigWriteResult

Sets a register in the configuration space. Only used by PCI.

fn config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the configuration space. Only used by PCI.

fn init_pci_config_mapping( &mut self, shmem: &SharedMemory, base: usize, len: usize ) -> bool

Provides a memory region to back MMIO access to the configuration space. If the device can keep the memory region up to date, then it should return true, after which no more calls to config_register_read will be made. Otherwise the device should return false.

fn virtual_config_register_write(&mut self, reg_idx: usize, value: u32)

Sets a register in the virtual config space. Only used by PCI.

fn virtual_config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the virtual config space. Only used by PCI.

fn on_sandboxed(&mut self)

Invoked when the device is sandboxed.

fn get_ranges(&self) -> Vec<(BusRange, BusType)>

Gets a list of all ranges registered by this BusDevice.

fn destroy_device(&mut self)

Invoked when the device is destroyed

fn is_bridge(&self) -> Option<u8>

Returns the secondary bus number if this bus device is pci bridge

impl Suspendable for VirtCpufreqV2

fn snapshot(&mut self) -> Result<Value>

Save the device state in an image that can be restored.

fn restore(&mut self, _data: Value) -> Result<()>

Load a saved snapshot of an image.

fn sleep(&mut self) -> Result<()>

Stop all threads related to the device. Sleep should be idempotent.

fn wake(&mut self) -> Result<()>

Create/Resume all threads related to the device. Wake should be idempotent.