vfio_ap_mdev_unlink_adapter(9)
π vfio_ap_mdev_unlink_adapter(9) β the Kernel API Manual, bestie edition π
okay so picture this: you're deep in the vfio_ap corner of the kernel (yes, it's the 9 section, we love a kernel-API moment β¨) and this little function is the one that does the breakup duties. It's called vfio_ap_mdev_unlink_adapter, and it lives in the Kernel API Manual. Buckle up π¦
β¨ NAME β¨
vfio_ap_mdev_unlink_adapter β literally unlinks all the queues that are associated with an unassigned adapter from the matrix mdev that the adapter used to be assigned to. It's giving "you don't sit with us anymore" but make it queue management π
πΈ SYNOPSIS πΈ
void vfio_ap_mdev_unlink_adapter (struct ap_matrix_mdev *matrix_mdev ,
unsigned long apid , struct list_head *qlist );
no cap, that's the whole signature β it returns void, so no return-value drama here π
π ARGUMENTS π
matrix_mdevβ the matrix mediated device to which the adapter was assigned. like, the mdev in question, the main character πapidβ the APID of the unassigned adapter. the glow-up-to-glow-down id, iykyk π₯qlistβ the list for storing queues associated with the unassigned adapter that need to be reset. think of it as the little basket π§Ί where the queues that need a reset go to be dealt with later.
π¦ SEE ALSO π¦
the whole friend group π«Ά β go say hi to:
Kernel file ./drivers/s390/crypto/vfio_ap_ops.cβ the source file itself, the mothership πget_update_locks_for_kvm(9)release_update_locks_for_kvm(9)get_update_locks_for_mdev(9)release_update_locks_for_mdev(9)get_update_locks_by_apqn(9)get_update_locks_for_queue(9)vfio_ap_mdev_get_queue(9)vfio_ap_wait_for_irqclear(9)vfio_ap_free_aqic_resources(9)vfio_ap_irq_disable(9)vfio_ap_validate_nib(9)ensure_nib_shared(9)vfio_ap_irq_enable(9)vfio_ap_le_guid_to_be_uuid(9)handle_pqap(9)vfio_ap_mdev_verify_no_sharing(9)vfio_ap_mdev_validate_masks(9)assign_adapter_store(9)unassign_adapter_store(9)assign_domain_store(9)unassign_domain_store(9)assign_control_domain_store(9)unassign_control_domain_store(9)vfio_ap_mdev_set_kvm(9)vfio_ap_mdev_unset_kvm(9)vfio_ap_mdev_resource_in_use(9)vfio_ap_mdev_hot_unplug_cfg(9)vfio_ap_mdev_cfg_remove(9)vfio_ap_mdev_on_cfg_remove(9)vfio_ap_filter_apid_by_qtype(9)vfio_ap_mdev_cfg_add(9)vfio_ap_mdev_on_cfg_add(9)vfio_ap_on_cfg_changed(9)
π friendly reminder: the manpage gives you no return value because there is none β void is void, periodt. Don't go looking for an errno that isn't there.
alright bestie, that's the whole page π mwah π β brought to you by the fine folks at ./drivers/s390/crypto, dated October 2026, and yeah, the page is literally named vfio_ap_mdev_unlink_adapter(9) (we're nothing if not consistent). go unlink those queues, you're gonna slay πβ¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms