xe_guc_relay_send_to_pf(9)

💅 xe_guc_relay_send_to_pf(9) — ur girl's guide to this Kernel API Manual moment

okay so bestie, welcome to the Kernel API Manual, and today's main character is xe_guc_relay_send_to_pf. yes the name is a mouthful, yes I say it in one breath at parties, no I will not be taking questions 💅

---

✨ NAME ✨

xe_guc_relay_send_to_pf — literally just sending a message to the PF. that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

int xe_guc_relay_send_to_pf (struct xe_guc_relay *relay , const u32 *msg
, u32 len , u32 *buf , u32 buf_size );

---

🦋 ARGUMENTS 🦋

• relay — the xe_guc_relay that's gonna do the sending. she's the messenger, she's booked and busy 💌
• msg — the request message you're sending out. the actual content, the whole point, the moment 🔥
• len — length of the message, in dwords. and no, it can't be 0, so don't even try it 🙈
• buf — placeholder for the response message. waiting room for the reply, basically 🫶
• buf_size — size of that response placeholder, also in dwords. know ur limits bestie ✨

---

👑 DESCRIPTION 👑

fr fr, this function can only be used by a driver running in SR-IOV VF mode. like, that's the whole eligibility criteria. if ur not in VF mode, this is not ur function, no cap 💀

---

⭐ RETURN ⭐

you get back a non-negative response length (in dwords) — slay — or a negative error code if it went wrong 😭

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guc_relay.c
• struct relay_transaction(9)
• xe_guc_relay_init(9)
• xe_guc_relay_send_to_vf(9)
• xe_guc_relay_process_guc2vf(9)
• xe_guc_relay_process_guc2pf(9)

go read those too, I'll wait 🧚

---

ok that's the whole page, every last detail intact, nothing dropped, we ate and left no crumbs 💖

and that's a wrap! this iconic little manpage lives in ./drivers/gpu/drm/xe, stamped October 2026, and it's the xe_guc_relay_send_to_pf(9) entry in the Kernel API Manual. mwah, bye bestie 🍓💜