__acquires_shared(9)

💖 __acquires_shared(9) — Kernel API Manual 💖

🌸 NAME 🌸

__acquires_shared is a function attribute — and it declares that the function acquires the given context lock instance(s) with shared access. That's the whole name-drop, bestie. ✨

✨ SYNOPSIS ✨

__acquires_shared (... );

🎀 ARGUMENTS 🎀

• ... — variable arguments. literally ..., variable arguments, no cap.

🦋 DESCRIPTION 🦋

Okay so __acquires_shared is a function attribute. It declares that the function acquires the given context lock instance(s) with shared access — but it does not release them. It's giving "i'm the one grabbing the shared lock," not "i'm the one letting it go." 🫶 That's it. That's the lore. 💅

👀 SEE ALSO 👀

Kernel file: ./include/linux/compiler-context-analysis.h — go read these, iykyk:

• __guarded_by(9)
• __pt_guarded_by(9)
• context_lock_struct(9)
• disable_context_analysis(9)
• enable_context_analysis(9)
• __no_context_analysis(9)
• context_unsafe(9)
• __context_unsafe(9)
• context_unsafe_alias(9)
• token_context_lock(9)
• token_context_lock_instance(9)
• __must_hold(9)
• __must_not_hold(9)
• __acquires(9)
• __cond_acquires(9)
• __releases(9)
• __cond_releases(9)
• __acquire(9)
• __release(9)
• __must_hold_shared(9)
• __cond_acquires_shared(9)
• __releases_shared(9)
• __acquire_shared(9)
• __release_shared(9)
• __acquire_ret(9)
• __acquire_shared_ret(9)

mwah 💋 — source/version ./include/linux, date October 2026, page __acquires_shared(9). bye bestie! 🫶