vfio_ap_mdev_get_queue(9)

🎀 vfio_ap_mdev_get_queue(9) 🎀

okay so you're in the Kernel API Manual bestie, and today's main character is vfio_ap_mdev_get_queue — no cap, she's the one who fishes a queue out of the hash table 🌸

---

✨ NAME ✨

vfio_ap_mdev_get_queue — literally goes and retrieves a queue with a specific APQN from a hash table of queues assigned to a matrix mdev. that's her whole job. we stan a focused queen 💅

---

💖 SYNOPSIS 💖

struct vfio_ap_queue * vfio_ap_mdev_get_queue (struct ap_matrix_mdev
     *matrix_mdev , int apqn );

like. she takes a matrix_mdev and an apqn and hands you back a pointer. iconic signature, no notes 🫶

---

🦋 ARGUMENTS 🦋

• matrix_mdev — the matrix mdev. yes literally the matrix mdev, that's the whole description, she said what she said 😌
• apqn — the APQN of a queue device 🔥

---

⭐ RETURN ⭐

she returns the pointer to the struct vfio_ap_queue representing the queue — or NULL if the queue is not assigned to matrix_mdev. so like, vibe check your return value before you dereference it, bestie 😭🙈

fr fr: NULL is a real possible outcome here. check it. your future self will thank you 💀

---

🌈 SEE ALSO 🌈

the whole friend group, assembled 👑

• kernel file ./drivers/s390/crypto/vfio_ap_ops.c 📁
• 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_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)
• vfio_ap_mdev_unlink_adapter(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)

like… that's the entire group chat and every single one of them is invited 💜

---

and that's the page!! mwah 💋 this lil beauty lives over in ./drivers/s390/crypto, dated October 2026, and yes the man page calls itself vfio_ap_mdev_get_queue(9) — self-titled, main character energy, periodt 👑✨