STRUCT AP_QUEUE_STATUS(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’– struct ap_queue_status(9) πŸ’–

okay bestie, welcome to the Kernel API Manual page for struct ap_queue_status β€” yes, the whole page is literally about one status word, and she is iconic. no cap, this is the AP queue status vibe check. πŸ’…


✨ NAME ✨

struct ap_queue_status β€” holds the AP queue status. 🫢


🧚 SYNOPSIS 🧚

okay so here's the whole struct, bestie β€” every colon, brace and anonymous little guy stays exactly where it was:

struct ap_queue_status {
    union {
      unsigned int value                      : 32;
      struct {
        unsigned int status_bits        : 8;
        unsigned int rc                 : 8;
        unsigned int                    : 16;
      };
      struct {
        unsigned int queue_empty        : 1;
        unsigned int replies_waiting    : 1;
        unsigned int queue_full         : 1;
        unsigned int                    : 3;
        unsigned int async              : 1;
        unsigned int irq_enabled        : 1;
        unsigned int response_code      : 8;
        unsigned int                    : 16;
      };
    };
 };

that's the whole shape. periodt. πŸŽ€


πŸ’… Members πŸ’…

the Members section is giving very specific, so here's every entry with its exact label:

  • {unnamed_union} β€” anonymous πŸ‘»
  • {unnamed_struct} β€” anonymous πŸ‘»
  • {unnamed_struct} β€” anonymous πŸ‘»
  • queue_empty β€” shows if queue is empty 🫧
  • replies_waiting β€” waiting replies ⏳
  • queue_full β€” is 1 if the queue is full 😀
  • irq_enabled β€” shows if interrupts are enabled for the AP ⚑
  • response_code β€” holds the 8 bit response code πŸ”’

not me listing anonymous members but go off. πŸ’€


🌈 Description 🌈

the AP queue status word is returned by all three AP functions: PQAP, NQAP and DQAP. literally all three, bestie β€” it's giving group-chat energy. there's a set of flags in the first byte, followed by a 1 byte response code. πŸ’–

for convenience, the value field is a 32 bit access of the whole status. meanwhile the status_bits and rc fields comprise the leftmost 8 status bits and the response_code. yes, it's a little bit-packing moment. ✨


πŸ”₯ SEE ALSO πŸ”₯

okay so the kernel file is here, and the whole see-also friend group is:


mwah πŸ’‹ β€” source/version: ./arch/s390/include/asm; date: October 2026; page: struct ap_queue_status(9). that's the whole footer, folded into a lil sign-off. πŸŽ€

πŸ“¦ where this page comes from