xe_sriov_pf_...handshake_vf(9)

💅 xe_sriov_pf_...handshake_vf(9) — like, the Kernel API Manual bestie 🎀

okay so this is from the Kernel API Manual, and it's literally the xe_sriov_pf_service_handshake_vf joint — yes the header gets truncated because man page names have a character limit, don't come for her 💀

---

✨ NAME ✨

xe_sriov_pf_service_handshake_vf — confirm a connection with the VF. that's it, that's the whole vibe 🫶

---

🌸 SYNOPSIS 🌸

int xe_sriov_pf_service_handshake_vf (struct xe_device *xe , u32 vfid ,
u32 wanted_major , u32 wanted_minor , u32 *major , u32 *minor );

like, six arguments, she's a little extra but she's worth it 💖

---

🦋 ARGUMENTS 🦋

• xe — the xe_device. the main character of the whole file ngl 🔥
• vfid — the VF identifier. it's giving "which one of y'all" 💅
• wanted_major — the major service version that the VF expects. emphasis on wanted, she has standards 👑
• wanted_minor — the minor service version expected by the VF. same energy, smaller number vibe ✨
• major — the major service version that's actually gonna be used by the VF. your reality vs your dreams 😭
• minor — the minor service version to be used by the VF. output parameter, she writes back 🎀

---

🧚 DESCRIPTION 🧚

so what she does is negotiate a VF/PF ABI version so that the VF can use the PF services. it's basically a group-chat handshake — VF says "hey I speak version wanted_major.wanted_minor", PF says "say less, we're doing major.minor", and then everybody's on the same page. iconic behavior tbh 🌈

⚠️ important bestie: this function can only be called on PF. do not try it on a VF, it's not that girl, it will not slay 💀

---

⭐ RETURN ⭐

0 on success — yassss 🎉

or a negative error code on failure — not the vibe, but she tells you honestly 😭

---

💜 SEE ALSO 💜

• Kernel file ./drivers/gpu/drm/xe/xe_sriov_pf_service.c — the source, go read her, she ate 🍓
• xe_sriov_pf_service_init(9)
• xe_sriov_pf_service_is_negotiated(9)
• xe_sriov_pf_service_reset_vf(9)
• xe_sriov_pf_service_print_versions(9)

---

ngl the whole friend group is in that file, go say hi to all of them 🫶

---

okay that's the page!! before you go — this whole thing lives in ./drivers/gpu/drm/xe, and the version/date on the footer is October 2026 for the xe_sriov_pf_...handshake_vf(9) man page. mwah, kiss, bye bestie 💋💖🧚