STRUCT VFIO_AP_QUEUE(9)

💖 NAME 💖

Okay so bestie, this is the Kernel API Manual page for struct vfio_ap_queue(9) — yes, the whole page, and it's giving “lil struct with a big job” energy. This struct contains the data associated with a queue bound to the vfio_ap device driver. Slay. 💅

🦋 SYNOPSIS 🦋

Here's the struct, exactly as it is — no edits, no vibes-based refactoring, periodt:

       struct vfio_ap_queue {
           struct ap_matrix_mdev *matrix_mdev;
           dma_addr_t saved_iova;
           int apqn;
         #define VFIO_AP_ISC_INVALID 0xff;
           unsigned char saved_isc;
           struct hlist_node mdev_qnode;
           struct list_head reset_qnode;
           struct ap_queue_status reset_status;
           struct work_struct reset_work;
        };

And yes, #define VFIO_AP_ISC_INVALID 0xff; is right there in the struct definition — iconic, honestly. ✨

🫶 Members 🫶

• matrix_mdev — the matrix mediated device 🫶
• saved_iova — the notification indicator byte (nib) address 📍
• apqn — the APQN of the AP queue device 🔢
• saved_isc — the guest ISC registered with the GIB interface 🧚
• mdev_qnode — allows the vfio_ap_queue struct to be added to a hashtable 🗂️
• reset_qnode — allows the vfio_ap_queue struct to be added to a list of queues that need to be reset 🔁
• reset_status — the status from the last reset of the queue 📊
• reset_work — work to wait for queue reset to complete ⏳

🌈 SEE ALSO 🌈

If you wanna snoop more, these are the refs to check out, bestie:

• Kernel file ./drivers/s390/crypto/vfio_ap_private.h
• struct ap_matrix_dev(9)
• struct ap_matrix(9)
• struct ap_queue_table(9)
• struct ap_matrix_mdev(9)

Signed, sealed, and delivered from source ./drivers/s390/crypto, dated October 2026, and it's all about struct vfio_ap_queue(9) — byeee, mwah 💋✨