vfio_ap_free_aqic_resources(9)

💅 vfio_ap_free_aqic_resources(9)

okay so bestie, we're in the Kernel API Manual today (yes, that (9) at the end is the manual name, it's giving "section 9, kernel internals, don't panic" ✨) and the function we're stanning is vfio_ap_free_aqic_resources. buckle up, it's a cleanup girlie and she ATE 💖

---

🌸 NAME 🌸

vfio_ap_free_aqic_resources — free vfio_ap_queue resources 🧚

✨ SYNOPSIS ✨

void vfio_ap_free_aqic_resources (struct vfio_ap_queue *q );

like literally that's the whole signature, no return value, she just does the thing and leaves, periodt 💅

🎀 ARGUMENTS 🎀

• q — The vfio_ap_queue. that's the queue bestie, the one we're about to tidy up. main character energy, honestly 🫶

🦋 DESCRIPTION 🦋

okay so here's the tea, this function does the big cleanup and it does it in three iconic steps:

• Unregisters the ISC in the GIB when the saved ISC is not invalid — no cap, if that ISC is still valid it's getting unregistered, we do not leave that hanging 🙈
• Unpins the guest's page holding the NIB when it exists. if there's no NIB page, there's nothing to unpin, so she moves on, lowkey efficient 💀
• Resets saved_iova and saved_isc to invalid values — reset and refresh era, we're not carrying that state into the next chapter ⭐

so yeah, it's a cleanup function, it frees the resources, it slays, and it returns void because she does not need validation from anyone 😌

🫶 SEE ALSO 🫶

The kernel file where the magic lives:

• ./drivers/s390/crypto/vfio_ap_ops.c 👑

and the whole friend group, all of them, no one gets left out of the group chat:

• 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_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)

---

and that's the whole page bestie, iykyk 💖

this little love letter came out of ./drivers/s390/crypto, dated October 2026, and yes it is still vfio_ap_free_aqic_resources(9) — same icon, same queen, see u next time 🎀🦋✨