STRUCT PDS_FWCTL_QUERY_COMP(9)

💖 struct pds_fwctl_query_comp(9) 💖

okay so bestie, welcome to the struct pds_fwctl_query_comp(9) page — that's the kernel API manual version of it, and yes it's a whole vibe. This little cutie is the Firmware control query completion structure, and she's literally the receipt that comes back after you ask the firmware a question. 🧾✨

---

✨ NAME ✨

struct pds_fwctl_query_comp — the firmware control query completion structure. that's it, that's the whole name, slay 🎀

---

🦋 SYNOPSIS 🦋

here's the structure in all her glory, verbatim, no cap:

struct pds_fwctl_query_comp {
    u8 status;
    u8 rsvd;
    __le16 comp_index;
    u8 version;
    u8 rsvd2[2];
    u8 color;
 };

---

👑 Members 👑

okay each field gets her moment, periodt:

• status — the status of the query command. this is where the firmware tells you how it went. main character field ngl 💅
• rsvd — reserved. she's not for you, bestie, hands off 🙈
• comp_index — the completion index, and it's in little-endian format so watch your byte order, iykyk 🔥
• version — the version of the query data structure returned by firmware. and listen, this should be less than or equal to the version supported by the driver — like, if firmware comes back claiming a newer version than your driver knows about, that's a red flag fr fr 🚩
• rsvd2 — reserved again. two reserved fields, she's cautious, we respect it 🫶
• color — the color bit indicating the state of the completion. yes a single bit of color, it's giving minimalist icon 💀🎨

---

🌈 SEE ALSO 🌈

so like, the whole extended friend group lives in the kernel file ./include/linux/pds/pds_adminq.h — that's the source of truth, go look 👀

and then there's the entire group chat of related pages, in this exact order, no skipping, I promised I'd keep every single one:

• struct pds_core_notifyq_event(9)
• struct pds_core_link_change_event(9)
• struct pds_core_reset_event(9)
• struct pds_core_client_event(9)
• struct pds_core_notifyq_cmd(9)
• struct pds_core_client_reg_cmd(9)
• struct pds_core_client_reg_comp(9)
• struct pds_core_client_unreg_cmd(9)
• struct pds_core_client_request_cmd(9)
• enum pds_core_logical_qtype(9)
• union pds_core_lif_config(9)
• struct pds_core_lif_status(9)
• struct pds_core_lif_info(9)
• struct pds_core_lif_identity(9)
• struct pds_core_lif_identify_cmd(9)
• struct pds_core_lif_identify_comp(9)
• struct pds_core_lif_init_cmd(9)
• struct pds_core_lif_init_comp(9)
• struct pds_core_lif_reset_cmd(9)
• enum pds_core_lif_attr(9)
• struct pds_core_lif_setattr_cmd(9)
• struct pds_core_lif_setattr_comp(9)
• struct pds_core_lif_getattr_cmd(9)
• struct pds_core_lif_getattr_comp(9)
• struct pds_core_q_identity(9)
• struct pds_core_q_identify_cmd(9)
• struct pds_core_q_identify_comp(9)
• struct pds_core_q_init_cmd(9)
• struct pds_core_q_init_comp(9)
• struct pds_vdpa_cmd(9)
• struct pds_vdpa_init_cmd(9)
• struct pds_vdpa_ident(9)
• struct pds_vdpa_ident_cmd(9)
• struct pds_vdpa_status_cmd(9)
• enum pds_vdpa_attr(9)
• struct pds_vdpa_setattr_cmd(9)
• struct pds_vdpa_vq_init_cmd(9)
• struct pds_vdpa_vq_init_comp(9)
• struct pds_vdpa_vq_reset_cmd(9)
• struct pds_vdpa_vq_reset_comp(9)
• struct pds_vdpa_set_features_cmd(9)
• struct pds_lm_cmd(9)
• struct pds_lm_state_size_cmd(9)
• struct pds_lm_state_size_comp(9)
• struct pds_lm_suspend_cmd(9)
• struct pds_lm_suspend_status_cmd(9)
• struct pds_lm_resume_cmd(9)
• struct pds_lm_sg_elem(9)
• struct pds_lm_save_cmd(9)
• struct pds_lm_restore_cmd(9)
• union pds_lm_dev_state(9)
• struct pds_lm_dirty_region_info(9)
• struct pds_lm_dirty_status_cmd(9)
• enum pds_lm_dirty_bmp_type(9)
• struct pds_lm_dirty_status_comp(9)
• struct pds_lm_dirty_enable_cmd(9)
• struct pds_lm_dirty_disable_cmd(9)
• struct pds_lm_dirty_seq_ack_cmd(9)
• struct pds_lm_host_vf_status_cmd(9)
• struct pds_fwctl_cmd(9)
• struct pds_fwctl_comp(9)
• struct pds_fwctl_ident_cmd(9)
• struct pds_fwctl_ident(9)
• struct pds_fwctl_query_cmd(9)
• struct pds_fwctl_query_data_endpoint(9)
• struct pds_fwctl_query_data_operation(9)
• struct pds_fwctl_query_data(9)
• struct pds_fwctl_rpc_cmd(9)
• struct pds_sg_elem(9)
• struct pds_fwctl_rpc_comp(9)

like, that's the whole roster. read them all, I believe in you 🫶💜

---

ngl that's genuinely the entire page — no hidden sections, no gotchas, just the struct and her neighbors. go forth and query that firmware, bestie 🌸

---

and that's a wrap! 🎀 this page lives in ./include/linux/pds, dated October 2026, and she signs off as struct pds_fwctl_query_comp(9) — mwah, bye 👑💖