Method adopt_group

crates/openshell-vfio/src/pci.rs:85–104

Adopt ownership of a complete IOMMU group already bound to `vfio-pci`. This is the restart-reconciliation counterpart to [`prepare_pci_group_for_passthrough`]. It validates that `bdfs` is the complete IOMMU group, that every declared device is already bound to `vfio-pci`, and then returns a guard that restores every declared device on drop. It does not write `driver_override`, `new_id`, or `drive

(sysfs: &SysfsRoot, bdfs: &[&str])

    /// on drop. It does not write `driver_override`, `new_id`, or
    /// `drivers_probe`.
    pub fn adopt_group(sysfs: &SysfsRoot, bdfs: &[&str]) -> Result<Self, VfioError> {
        validate_pci_group_for_passthrough(sysfs, bdfs)?;

        for bdf in bdfs {
            ensure_bound_to_vfio(sysfs, bdf)?;
        }

        let (primary, companions) = bdfs
            .split_first()
            .expect("validate_pci_group_for_passthrough rejects empty slices");
        let vfio_id = crate::bind::vfio_id_string(sysfs, primary);
        let companion_bdfs: Vec<String> = companions.iter().map(|s| (*s).to_string()).collect();

        Ok(Self::new_armed(
            (*primary).to_string(),
            companion_bdfs,
            sysfs.clone(),
            vfio_id,
        ))
    }

    pub(crate) fn new_armed(
        bdf: String,