vbg_acquire_...capabilities(9)

💅 vbg_acquire_...capabilities(9) 💅

okay so this is a page from the Kernel API Manual, section 9 (yes, the big-kid kernel-functions section, we love her 👑). Buckle up bestie, we're grabbing exclusive access to guest capabilities and it's gonna be iconic.

---

✨ NAME ✨

vbg_acquire_session_capabilities — the function that acquires (as in: gets exclusive access to, no sharing, no tag-teaming 🙅‍♀️) the guest capabilities for a session.

---

🌸 SYNOPSIS 🌸

int vbg_acquire_session_capabilities (struct vbg_dev *gdev , struct
vbg_session *session , u32 or_mask , u32 not_mask , u32 flags , bool
session_termination );

literally the whole signature, copied exactly, no notes 💖

---

🎀 ARGUMENTS 🎀

• gdev — the Guest extension device. that's the whole vibe, she's the device. 👑
• session — the session. the main character, honestly. ⭐
• or_mask — the capabilities you wanna add. get them in there 🫶
• not_mask — the capabilities you wanna remove. bye bestie 👋
• flags — flags, and the flags are VBGL_IOC_AGC_FLAGS_XXX. that's the canonical spelling, don't come for me 😭
• session_termination — set this if we're being called by the session cleanup code. it tweaks the error handling so we do a proper session cleanup even if the host misbehaves 🙈 like, host acting up? doesn't matter, we clean up correctly anyway. periodt.

---

🦋 DESCRIPTION 🦋

Takes the session mutex. that's it. that's the description. she's short and she knows it 💅✨

ngl the whole description is one line and honestly? iconic of her. but fr fr: the thing it does is take the session mutex. don't read more into it than that.

---

🌈 RETURN 🌈

0 or a negative errno value. slay if it's 0, and if it's negative… well, negative errno is giving "something went sideways" 💀 but at least it's honest.

---

🔥 SEE ALSO 🔥

Kernel file ./drivers/virt/vboxguest/vboxguest_core.c — go read the source, it's right there 🍓

and the whole friend group, in the exact order they were introduced:

• vbg_guest_mappings_init(9)
• vbg_guest_mappings_exit(9)
• vbg_report_guest_info(9)
• vbg_report_driver_status(9)
• vbg_balloon_inflate(9)
• vbg_balloon_deflate(9)
• vbg_heartbeat_host_config(9)
• vbg_heartbeat_init(9)
• vbg_heartbeat_exit(9)
• vbg_track_bit_usage(9)
• vbg_reset_host_event_filter(9)
• vbg_set_session_event_filter(9)
• vbg_reset_host_capabilities(9)
• vbg_set_host_capabilities(9)
• vbg_set_session_capabilities(9)
• vbg_query_host_version(9)
• vbg_core_init(9)
• vbg_core_exit(9)
• vbg_core_open_session(9)
• vbg_core_close_session(9)
• vbg_req_allowed(9)
• vbg_core_ioctl(9)
• vbg_core_set_mouse_status(9)

---

💜 the sign-off 💜

this page lives at ./drivers/virt/vboxguest, dated October 2026, and it's filed under vbg_acquire_...capabilities(9) in the Kernel API Manual. ok that's the whole page, go take the mutex bestie, ily 🧚‍♀️💖✨