qed_dbg_grc_dump(9)

💅 qed_dbg_grc_dump — like, the whole vibe

okay so bestie, welcome to the Kernel API Manual entry for qed_dbg_grc_dump ✨. Yes this is a section 9 (kernel API) page, yes it's a whole function, and yes we're gonna get through it together because honestly? It's giving "dump the GRC data into a buffer" and nothing more chaotic than that. 🫶

---

🌸 NAME 🌸

qed_dbg_grc_dump — literally dumps GRC data into the buffer you hand it. That's the whole job. Main character energy, minimal plot. 💅

---

✨ SYNOPSIS ✨

enum dbg_status qed_dbg_grc_dump (struct qed_hwfn *p_hwfn , struct
qed_ptt *p_ptt , u32 *dump_buf , u32 buf_size_in_dwords , u32
*num_dumped_dwords );

Five args, returns an enum dbg_status, no cap. Let's go through every single one because we don't skip. 🎀

---

🦋 ARGUMENTS 🦋

• p_hwfn — the HW device data. like, the hardware's whole personality file. 👑
• p_ptt — the Ptt window used for writing the registers. your little window into register-land. 🪟
• dump_buf — pointer to write the collected GRC data into. this is the bucket, bestie. put the GRC data in the bucket. 🪣
• buf_size_in_dwords — the size of the specified buffer, measured in dwords. yes, in dwords. not bytes. do not come at it with bytes. 🙈
• num_dumped_dwords — (OUT) number of dumped dwords. it tells you how much actually made it into the bucket. ⭐

---

🔥 RETURN 🔥

So it returns an error if one of the following holds — pay attention, this is the vibe check 🧚:

• The version wasn't set. 😭 (set your version, girl.)
• The specified dump buffer is too small. 💀

Otherwise? It returns ok. Slay. ✅

no cap: if your buffer is tiny, this whole thing is not gonna work out. size it correctly before you call.

---

🌈 SEE ALSO 🌈

the kernel file it lives near:

./drivers/net/ethernet/qlogic/qed/qed_dbg_hsi.h

and, like, the entire extended friend group of debug functions — every single one, we're listing them all because they're all iconic in their own way 💜:

qed_dbg_set_bin_ptr(9), qed_read_regs(9), qed_read_fw_info(9), qed_dbg_grc_config(9), qed_dbg_grc_set_params_default(9), qed_dbg_grc_get_dump_buf_size(9), qed_dbg_idle_chk_get_dump_buf_size(9), qed_dbg_idle_chk_dump(9), qed_dbg_mcp_trace_get_dump_buf_size(9), qed_dbg_mcp_trace_dump(9), qed_dbg_reg_fifo_get_dump_buf_size(9), qed_dbg_reg_fifo_dump(9), qed_dbg_igu_fifo_get_dump_buf_size(9), qed_dbg_igu_fifo_dump(9), qed_dbg_protection_override_get_dump_buf_size(9), qed_dbg_protection_override_dump(9), qed_dbg_fw_asserts_get_dump_buf_size(9), qed_dbg_fw_asserts_dump(9), qed_dbg_read_attn(9), qed_dbg_print_attn(9), qed_dbg_user_set_bin_ptr(9), qed_dbg_alloc_user_data(9), qed_dbg_get_status_str(9), qed_get_idle_chk_results_buf_size(9), qed_print_idle_chk_results(9), qed_dbg_mcp_trace_set_meta_data(9), qed_get_mcp_trace_results_buf_size(9), qed_print_mcp_trace_results(9), qed_mcp_trace_free_meta_data(9), qed_get_reg_fifo_results_buf_size(9), qed_print_reg_fifo_results(9), qed_get_igu_fifo_results_buf_size(9), qed_print_igu_fifo_results(9), qed_get_protection_override_results_buf_size(9), qed_print_protection_override_results(9), qed_get_fw_asserts_results_buf_size(9), qed_print_fw_asserts_results(9), qed_dbg_parse_attn(9)

go read them. iykyk. 📚

---

anyway that's the whole page, mwah 💋 — this came to you from the source tree at ./drivers/net/ethernet/qlogic/qed, dated October 2026, and it's qed_dbg_grc_dump(9) forever, periodt. 🎀💖✨