release_upda...ocks_for_kvm(9)
okay bestie, welcome to the Kernel API Manual page for release_update_locks_for_kvm(9) β yes that's the real name, the header truncates it as release_upda...ocks_for_kvm(9) but we don't do that to ourselves π
π NAME
release_update_locks_for_kvm β releases the locks you used to dynamically update a KVM guest's APCB, and it does it in the proper order. no cap, the order is the whole point π₯
β¨ SYNOPSIS
void release_update_locks_for_kvm (struct kvm *kvm );
π¦ ARGUMENTS
kvmβ a pointer to astruct kvmobject that contains the KVM guest's APCB. that's it, that's the whole argument, she's simple like that π«Ά
π DESCRIPTION
okay so when you're dynamically updating a KVM guest's APCB, you grabbed a bunch of locks, right? this function is the "and now we let go" moment. but bestie, you can't just release them in any order β there's a proper unlocking order and it is literally this, in this exact sequence:
matrix_dev->mdevs_lockkvm->arch.crypto.pqap_hook_rwsemkvm->lockmatrix_dev->guests_lock
lowkey iconic how tidy that is. follow the order, don't freestyle π
β NOTE
ifkvmisNULL, then the KVM lock andpqap_hook_rwsemwill not be released. so like, know what you're passing, bestie π
π SEE ALSO
the source lives in this kernel file:
./drivers/s390/crypto/vfio_ap_ops.c
and here's the full squad β every single one of these, no skips π:
get_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)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 page!! πβ¨ this lil beauty ships from ./drivers/s390/crypto, dated October 2026, under the Kernel API Manual umbrella. go forth and release your locks in order, queen ππ
π
π¦ 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