Struct resources::system_allocator::SystemAllocator

pub struct SystemAllocator {
    io_address_space: Option<AddressAllocator>,
    mmio_address_spaces: [AddressAllocator; 2],
    mmio_platform_address_spaces: Option<AddressAllocator>,
    reserved_region: Option<AddressRange>,
    pci_allocator: BTreeMap<u8, AddressAllocator>,
    irq_allocator: AddressAllocator,
    gpe_allocator: AddressAllocator,
    next_anon_id: usize,
}

Fields

io_address_space: Option<AddressAllocator>

mmio_address_spaces: [AddressAllocator; 2]

mmio_platform_address_spaces: Option<AddressAllocator>

reserved_region: Option<AddressRange>

pci_allocator: BTreeMap<u8, AddressAllocator>

irq_allocator: AddressAllocator

gpe_allocator: AddressAllocator

next_anon_id: usize

Implementations

impl SystemAllocator

pub fn new( config: SystemAllocatorConfig, reserve_region_size: Option<u64>, mmio_address_ranges: &[AddressRange] ) -> Result<Self>

Creates a new SystemAllocator for managing addresses and irq numbers. Will return an error if base + size overflows u64 (or allowed maximum for the specific type), or if alignment isn’t a power of two.

If reserve_region_size is not None, then a region is reserved from the start of config.high_mmio before the mmio allocator is created.

If mmio_address_ranges is not empty, then config.low_mmio and config.high_mmio are intersected with the ranges specified.

pub fn allocate_irq(&mut self) -> Option<u32>

Reserves the next available system irq number.

pub fn release_irq(&mut self, irq: u32)

release irq to system irq number pool

pub fn reserve_irq(&mut self, irq: u32) -> bool

Reserves the next available system irq number.

pub fn allocate_gpe(&mut self) -> Option<u32>

Reserve the next available system GPE number

fn get_pci_allocator_mut(&mut self, bus: u8) -> Option<&mut AddressAllocator>

pub fn pci_bus_empty(&self, bus: u8) -> bool

pub fn allocate_pci(&mut self, bus: u8, tag: String) -> Option<Alloc>

Allocate PCI slot location.

pub fn reserve_pci(&mut self, alloc: Alloc, tag: String) -> bool

Reserve PCI slot location.

pub fn release_pci(&mut self, bus: u8, dev: u8, func: u8) -> bool

release PCI slot location.

pub fn allocate_mmio( &mut self, size: u64, alloc: Alloc, tag: String, opts: &AllocOptions ) -> Result<u64>

Allocate a memory-mapped I/O region with properties requested in opts.

fn allocate_mmio_internal( &mut self, size: u64, alloc: Alloc, tag: String, opts: &AllocOptions, mmio_type: MmioType ) -> Result<u64>

pub fn reserve_mmio(&mut self, range: AddressRange) -> Result<()>

Reserve specified range from pci mmio, get the overlap of specified range with mmio pools, exclude the overlap from mmio allocator.

If any part of the specified range has been allocated, return Error.

pub fn mmio_platform_allocator(&mut self) -> Option<&mut AddressAllocator>

Gets an allocator to be used for platform device MMIO allocation.

pub fn io_allocator(&mut self) -> Option<&mut AddressAllocator>

Gets an allocator to be used for IO memory.

pub fn mmio_allocator(&mut self, mmio_type: MmioType) -> &mut AddressAllocator

Gets an allocator to be used for MMIO allocation. MmioType::Low: low mmio allocator MmioType::High: high mmio allocator

pub fn mmio_allocator_any(&mut self) -> AddressAllocatorSet<'_>

Gets a set of allocators to be used for MMIO allocation. The set of allocators will try the low and high MMIO allocators, in that order.

pub fn mmio_pools(&self) -> Vec<&AddressRange>

Gets the pools of all mmio allocators.

pub fn reserved_region(&self) -> Option<AddressRange>

Gets the reserved address space region.

pub fn get_anon_alloc(&mut self) -> Alloc

Gets a unique anonymous allocation

Trait Implementations

impl Debug for SystemAllocator

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

Formats the value using the given formatter.