STRUCT PDS_LM_DIRTY_STATUS_CMD(9)

💅 struct pds_lm_dirty_status_cmd(9) 💅

Kernel API Manual alert 🚨 — bestie, we're decoding the DIRTY_STATUS command struct, and honestly? She's giving "small struct, big responsibilities." 🎀 Every field stays, no skips, no cap. ✨

✨ NAME ✨

struct pds_lm_dirty_status_cmd — the DIRTY_STATUS command 💖

🦋 SYNOPSIS 🦋

       struct pds_lm_dirty_status_cmd {
           u8 opcode;
           u8 rsvd;
           __le16 vf_id;
           u8 max_regions;
           u8 rsvd2[3];
           __le64 regions_dma;
        };

🧚 Members 🧚

• opcode — Opcode PDS_LM_CMD_DIRTY_STATUS ✨
• rsvd — Word boundary padding 🎀
• vf_id — VF id 💅
• max_regions — Capacity of the region info buffer 🫶
• rsvd2 — Word boundary padding 🌈
• regions_dma — DMA address of the region info buffer 💖

🔥 Description 🔥

The minimum of max_regions (from the command) and num_regions (from the completion) of struct pds_lm_dirty_region_info will be written to regions_dma. That's the whole assignment, bestie — the smaller number gets written, periodt. 😭

The max_regions may be zero, in which case regions_dma is ignored. In that case, the completion will only report the maximum number of regions supported by the device, and the number of regions currently enabled. So zero is valid, but then regions_dma is literally ignored — don't expect region info to show up there. 💀

👑 SEE ALSO 👑

Kernel file: ./include/linux/pds/pds_adminq.h — now the whole friend group, in order:

• 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)
• 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_comp(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)

That's the whole page, bestie 💖 — the footer’s source/version bit is ./include/linux/pds, its date is October 2026, and its header tag is struct pds_l...y_status_cmd(9). Periodt. 🫶👑