Struct ResourceAllocator 

pub struct ResourceAllocator {
    pub gsi_legacy_allocator: IdAllocator,
    pub gsi_msi_allocator: IdAllocator,
    pub mmio32_memory: AddressAllocator,
    pub mmio64_memory: AddressAllocator,
    pub past_mmio64_memory: AddressAllocator,
    pub system_memory: AddressAllocator,
}

A resource manager for (de)allocating interrupt lines (GSIs) and guest memory

At the moment, we support:

• GSIs for legacy x86_64 devices
• GSIs for MMIO devicecs
• Memory allocations in the MMIO address space

Fields

gsi_legacy_allocator: IdAllocator

Allocator for legacy device interrupt lines

gsi_msi_allocator: IdAllocator

Allocator for PCI device GSIs

mmio32_memory: AddressAllocator

Allocator for memory in the 32-bit MMIO address space

mmio64_memory: AddressAllocator

Allocator for memory in the 64-bit MMIO address space

past_mmio64_memory: AddressAllocator

Allocator for memory after the 64-bit MMIO address space

system_memory: AddressAllocator

Memory allocator for system data

Implementations

impl ResourceAllocator

pub fn new() -> Self

Create a new resource allocator for Firecracker devices

pub fn allocate_gsi_legacy(&mut self, gsi_count: u32) -> Result<Vec<u32>, Error>

Allocate a number of legacy GSIs

Arguments

• gsi_count - The number of legacy GSIs to allocate

pub fn allocate_gsi_msi(&mut self, gsi_count: u32) -> Result<Vec<u32>, Error>

Allocate a number of GSIs for MSI

Arguments

• gsi_count - The number of GSIs to allocate

pub fn allocate_32bit_mmio_memory( &mut self, size: u64, alignment: u64, policy: AllocPolicy, ) -> Result<u64, Error>

Allocate a memory range in 32-bit MMIO address space

If it succeeds, it returns the first address of the allocated range

Arguments

• size - The size in bytes of the memory to allocate
• alignment - The alignment of the address of the first byte
• policy - A vm_allocator::AllocPolicy variant for determining the allocation policy

pub fn allocate_64bit_mmio_memory( &mut self, size: u64, alignment: u64, policy: AllocPolicy, ) -> Result<u64, Error>

Allocate a memory range in 64-bit MMIO address space

If it succeeds, it returns the first address of the allocated range

Arguments

• size - The size in bytes of the memory to allocate
• alignment - The alignment of the address of the first byte
• policy - A vm_allocator::AllocPolicy variant for determining the allocation policy

pub fn allocate_system_memory( &mut self, size: u64, alignment: u64, policy: AllocPolicy, ) -> Result<u64, Error>

Allocate a memory range for system data

If it succeeds, it returns the first address of the allocated range

Arguments

• size - The size in bytes of the memory to allocate
• alignment - The alignment of the address of the first byte
• policy - A vm_allocator::AllocPolicy variant for determining the allocation policy

Trait Implementations

impl Clone for ResourceAllocator

fn clone(&self) -> ResourceAllocator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResourceAllocator

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

Formats the value using the given formatter.

impl Default for ResourceAllocator

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ResourceAllocator

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> Persist<'a> for ResourceAllocator

type State = ResourceAllocator

The type of the object representing the state of the component.

type ConstructorArgs = ()

The type of the object holding the constructor arguments.

type Error = Infallible

The type of the error that can occur while constructing the object.

fn save(&self) -> Self::State

Returns the current state of the component.

fn restore( _constructor_args: Self::ConstructorArgs, state: &Self::State, ) -> Result<Self, Self::Error>

Constructs a component from a specified state.

impl Serialize for ResourceAllocator

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

where __S: Serializer,

Serialize this value into the given Serde serializer.