xe_guc_relay_send_to_vf(9)

💖 xe_guc_relay_send_to_vf — like, the whole vibe 💖

okay bestie, so this is a page straight out of the Kernel API Manual, and it's all about xe_guc_relay_send_to_vf(9) — yes that's the whole title, we're not retyping it as a header line, we're folding it in like a lil intro. Slay. Let's get into it ✨

---

🌸 NAME 🌸

xe_guc_relay_send_to_vf — send a message to the VF. That's it. That's the whole job. 💌

---

🦋 SYNOPSIS 🦋

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

look at her. iconic signature. no notes. 👑

---

🎀 ARGUMENTS 🎀

• relay — the xe_guc_relay that's gonna do the sending, like the main character of this whole operation 🫶
• target — the target VF number. who we're sending it to, basically 💅
• msg — the request message to be sent. the actual content, the moment, the drama ✨
• len — length of the request message (in dwords). and listen — it can't be 0. not up for debate, fr fr 🙈
• buf — placeholder for the response message. it's where the reply goes to chill 🌸
• buf_size — size of the response message placeholder (in dwords). know your limits bestie 💀

---

💜 DESCRIPTION 💜

okay so this is the important bit: this function can only be used by the driver running in the SR-IOV PF mode.

no cap, that's a real restriction, not a suggestion. if you're not in SR-IOV PF mode, this is not your function, bestie. 🚫

---

⭐ RETURN ⭐

you get either:

• a non-negative response length (in dwords) — the good ending 🥳
• or a negative error code on failure — the sad ending 😭

---

🧚 SEE ALSO 🧚

go read these next, iykyk:

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

---

and that's the page!! 💖 big kiss, mwah 🫶 this lil masterpiece lives in ./drivers/gpu/drm/xe, dated October 2026, and it's filed under xe_guc_relay_send_to_vf(9) — so if you forget where you found it, now you know. go forth and relay those messages, bestie 🦋✨👑