UNION IONIC_Q_IDENTITY(9)

💅 union ionic_q_identity(9) — a Kernel API Manual moment

okay so bestie, welcome to the group chat for union ionic_q_identity(9) — this is from the Kernel API Manual, and it's literally the little identity card your queue hands over so everyone knows what it is and what it can do. it's giving "hi, this is me, here's my whole personality" ✨

---

🌸 NAME 🌸

union ionic_q_identity — queue identity information. that's it, that's the vibe. 🎀

---

✨ SYNOPSIS ✨

here's the whole thing, copied exactly because we do not play with typos in this house:

union ionic_q_identity {
    struct {
      u8 version;
      u8 supported;
      u8 rsvd[6];
      __le64 features;
      __le16 desc_sz;
      __le16 comp_sz;
      __le16 sg_desc_sz;
      __le16 max_sg_elems;
      __le16 sg_desc_stride;
    };
    __le32 words[478];
 };

---

🦋 Members 🦋

okay let's go member by member, no skipping, no cap:

• {unnamed_struct} — an anonymous... anonymous. yeah. it's an unnamed struct just vibing in there with no name. lowkey mysterious, we respect it. 🙈
• version — the queue type version that can be used with FW. like, which firmware era this queue belongs to. iconic timestamp energy.
• supported — a bitfield of queue versions. first bit = ver 0. so bit zero is literally the main character, and the rest are the supporting cast. 👑
• rsvd — reserved byte(s). do not touch. it's saving seats for friends that haven't shown up yet. 💀
• features — queue features (enum ionic_q_feature, etc). the "etc" is doing so much work here and honestly? same.
• desc_sz — descriptor size. how big the descriptor is, fr fr.
• comp_sz — completion descriptor size. because completions need their own measurement too 💅
• sg_desc_sz — Scatter/Gather descriptor size. S/G is scatter/gather bestie, not "suspicious gossip".
• max_sg_elems — the Maximum number of Scatter/Gather elements. the absolute ceiling. the limit. don't push it.
• sg_desc_stride — the Number of Scatter/Gather elements per descriptor. so how many little guys are packed into each one. 🍓
• words — word access to struct contents. it's the __le32 words[478] back door — 478 of them, exactly, don't @ me, that's just what it says.

---

🌈 SEE ALSO 🌈

this section is genuinely enormous and I'm obsessed — every one of these is a real reference, so here they all are, not one skipped, periodt:

first up, the Kernel file: ./drivers/net/ethernet/pensando/ionic/ionic_if.h

and then the whole extended family:

struct ionic_admin_cmd(9), struct ionic_admin_comp(9), struct ionic_nop_cmd(9), struct ionic_nop_comp(9), struct ionic_dev_init_cmd(9), struct ionic_dev_init_comp(9), struct ionic_dev_reset_cmd(9), struct ionic_dev_reset_comp(9), struct ionic_dev_identify_cmd(9), struct ionic_dev_identify_comp(9), union ionic_drv_identity(9), enum ionic_dev_capability(9), union ionic_dev_identity(9), struct ionic_lif_identify_cmd(9), struct ionic_lif_identify_comp(9), enum ionic_lif_capability(9), enum ionic_logical_qtype(9), enum ionic_q_feature(9), enum ionic_rxq_feature(9), enum ionic_txq_feature(9), enum ionic_hwstamp_bits(9), struct ionic_lif_logical_qtype(9), enum ionic_lif_state(9), union ionic_lif_config(9), enum ionic_lif_rdma_cap_stats(9), union ionic_lif_identity(9), struct ionic_lif_init_cmd(9), struct ionic_lif_init_comp(9), struct ionic_q_identify_cmd(9), struct ionic_q_identify_comp(9), struct ionic_q_init_cmd(9), struct ionic_q_init_comp(9), struct ionic_txq_desc(9), struct ionic_txq_sg_elem(9), struct ionic_txq_sg_desc(9), struct ionic_txq_comp(9), struct ionic_rxq_desc(9), struct ionic_rxq_sg_elem(9), struct ionic_rxq_sg_desc(9), struct ionic_rxq_comp(9), enum ionic_pkt_class(9), struct ionic_q_control_cmd(9), enum ionic_phy_type(9), enum ionic_xcvr_state(9), enum ionic_port_type(9), enum ionic_port_admin_state(9), enum ionic_port_oper_status(9), enum ionic_port_fec_type(9), enum ionic_port_pause_type(9), enum ionic_port_loopback_mode(9), struct ionic_xcvr_status(9), union ionic_port_config(9), struct ionic_port_status(9), struct ionic_port_identify_cmd(9), struct ionic_port_identify_comp(9), struct ionic_port_init_cmd(9), struct ionic_port_init_comp(9), struct ionic_port_reset_cmd(9), struct ionic_port_reset_comp(9), enum ionic_stats_ctl_cmd(9), enum ionic_txstamp_mode(9), enum ionic_port_attr(9), struct ionic_port_setattr_cmd(9), struct ionic_port_setattr_comp(9), struct ionic_port_getattr_cmd(9), struct ionic_port_getattr_comp(9), struct ionic_lif_status(9), struct ionic_lif_reset_cmd(9), enum ionic_dev_attr(9), struct ionic_dev_setattr_cmd(9), struct ionic_dev_setattr_comp(9), struct ionic_dev_getattr_cmd(9), struct ionic_dev_getattr_comp(9), enum ionic_lif_attr(9), struct ionic_lif_setattr_cmd(9), struct ionic_lif_setattr_comp(9), struct ionic_lif_getattr_cmd(9), struct ionic_lif_getattr_comp(9), struct ionic_lif_setphc_cmd(9), struct ionic_rx_mode_set_cmd(9), struct ionic_rx_filter_add_cmd(9), struct ionic_rx_filter_add_comp(9), struct ionic_rx_filter_del_cmd(9), enum ionic_vf_link_status(9), struct ionic_vf_setattr_cmd(9), struct ionic_vf_getattr_cmd(9), struct ionic_vf_ctrl_cmd(9), struct ionic_vf_ctrl_comp(9), struct ionic_discover_cmb_cmd(9), struct ionic_discover_cmb_comp(9), union ionic_cmb_region(9), union ionic_discover_cmb_identity(9), struct ionic_qos_identify_cmd(9), struct ionic_qos_identify_comp(9), enum ionic_qos_class_type(9), enum ionic_qos_sched_type(9), union ionic_qos_config(9), union ionic_qos_identity(9), struct ionic_qos_init_cmd(9), struct ionic_qos_reset_cmd(9), struct ionic_qos_clear_stats_cmd(9), struct ionic_fw_download_cmd(9), enum ionic_fw_control_oper(9), struct ionic_fw_control_cmd(9), struct ionic_fw_control_comp(9), struct ionic_rdma_reset_cmd(9), struct ionic_rdma_queue_cmd(9), struct ionic_notifyq_event(9), struct ionic_link_change_event(9), struct ionic_reset_event(9), struct ionic_heartbeat_event(9), struct ionic_log_event(9), struct ionic_xcvr_event(9), union ionic_port_identity(9), struct ionic_port_info(9), struct ionic_lif_info(9), struct ionic_hwstamp_regs(9), union ionic_dev_info_regs(9), union ionic_dev_cmd_regs(9), union ionic_dev_regs(9), struct ionic_doorbell(9)

like I said. everyone showed up to this party. 🔥

---

ok tiny heads up bestie — nothing here is dangerous, it's just a struct, but the rsvd bytes are reserved so pls don't go writing your fanfic into them, mmkay? 🫶

---

and that's the page! mwah 💖 this came from ./drivers/net/ethernet/pensand... and it's dated October 2026 — so yes, she's from the future, she's booked and busy, and she's still out here explaining queue identity information. slay, honestly. 🌟