Struct crosvm::crosvm::sys::unix::pci_hotplug_manager::PciHotPlugManager

pub struct PciHotPlugManager {
    ports: HashMap<u8, PortStub>,
    jail_warden: Box<dyn JailWarden>,
    rootbus_controller: Option<Sender<PciRootCommand>>,
}

PciHotPlugManager manages hotplug ports, and handles PCI device hot plug and hot removal.

Fields

ports: HashMap<u8, PortStub>

map of downstream bus number to corresponding PortStub

jail_warden: Box<dyn JailWarden>

JailWarden for jailing hotplug devices

rootbus_controller: Option<Sender<PciRootCommand>>

control channel to root bus

Implementations

impl PciHotPlugManager

pub fn new(
    guest_memory: GuestMemory,
    config: &Config,
    swap_device_helper: Option<SwapDeviceHelper>
) -> Result<Self, Error>

Constructs PciHotPlugManager.

Constructor uses forking, therefore has to be called early, before crosvm enters a multi-threaded context.

pub fn set_rootbus_controller(
    &mut self,
    rootbus_controller: Sender<PciRootCommand>
) -> Result<(), Error>

Set root bus controller. Required before any hotplug commands.

rootbus_controller cannot be intialized at PciHotPlugManager::new, which must be called in a single-threaded context. However, rootbus_controller is only available after VM boots, by which time crosvm is multi-threaded.

pub fn add_port(&mut self, port: Arc<Mutex<dyn HotPlugBus>>) -> Result<(), Error>

Adds a hotplug capable port to manage.

PciHotPlugManager assumes exclusive control for adding and removing devices to this port.

pub fn hotplug_device<V: VmArch, Vcpu: VcpuArch>(
    &mut self,
    resource_carriers: Vec<ResourceCarrier>,
    linux: &mut RunnableLinuxVm<V, Vcpu>,
    resources: &mut SystemAllocator
) -> Result<u8, Error>

hotplugs up to 8 PCI devices as “functions of a device” (in PCI Bus Device Function sense).

returns the bus number of the bus on success.

pub fn remove_hotplug_device<V: VmArch, Vcpu: VcpuArch>(
    &mut self,
    bus: u8,
    linux: &mut RunnableLinuxVm<V, Vcpu>,
    resources: &mut SystemAllocator
) -> Result<(), Error>

Removes all hotplugged devices on the hotplug bus.

fn find_empty_bus(&self) -> Result<u8, Error>

Find a bus number available for hotplug.

fn send_hotplug_signal(&self, bus: u8) -> Result<(), Error>

Sends hotplug signal on the port.

fn remove_device_from_port(&self, bus: u8) -> Result<(), Error>

Sends eject signal on the port, and removes downstream devices on the port.