nbcon_braille_try_acquire(9)

💖 nbcon_braille_try_acquire(9) — Kernel API Manual 💖

okay so bestie, we're in the Kernel API Manual today and the star of the show is nbcon_braille_try_acquire. yes it's a mouthful, yes it slays, let's get into it 🎀

---

✨ NAME ✨

nbcon_braille_try_acquire — like the name says, it tries to acquire the nbcon console for braille_write(). no cap, that's the whole bit 🫶

---

🌸 SYNOPSIS 🌸

bool nbcon_braille_try_acquire (struct console *con , struct
nbcon_write_context *wctxt );

look at that signature, it's giving "short but powerful" 💅

---

🦋 ARGUMENTS 🦋

• con — the nbcon console you're tryna acquire. the main character of this whole function, honestly 👑
• wctxt — the nbcon write context, and it only gets used if the acquisition actually succeeds. no success, no context, iykyk ✨

---

🌈 CONTEXT 🌈

where does this even get called from? it's braille_write, specifically when it's emitting a single buffer on the Braille console. that's the vibe check on the context, periodt 💜

---

⭐ RETURN ⭐

• True — the console was acquired, we ate, we won 🎉
• False — it wasn't, and that's also fine, better luck next time 🙈

---

🧚 DESCRIPTION 🧚

so here's the tea bestie ☕ — the Braille console is not registered as a proper printk console. nope, not even close. instead, it's integrated with the graphical virtual terminal. that's just how it lives its life.

and what is this function doing? it's gonna synchronize the Braille write against other operations on the serial port being used. the way that matters is: that same port can also be used for user input — but printk won't emit messages there directly, so don't even worry about that. basically, those other operations get synchronized using nbcon_device_try_acquire. that's the whole mechanism, and honestly? iconic 🔥

---

💀 SEE ALSO 💀

the home base is the kernel file ./kernel/printk/nbcon.c, and then we have the extended fam — every single one of these cuties:

• nbcon_state_set(9)
• nbcon_state_read(9)
• nbcon_state_try_cmpxchg(9)
• nbcon_seq_read(9)
• nbcon_seq_force(9)
• nbcon_seq_try_update(9)
• nbcon_context_try_acquire_direct(9)
• nbcon_context_try_acquire_requested(9)
• nbcon_context_try_acquire_handover(9)
• nbcon_context_try_acquire_hostile(9)
• nbcon_context_try_acquire(9)
• nbcon_context_release(9)
• nbcon_context_can_proceed(9)
• nbcon_can_proceed(9)
• __nbcon_context_update_unsafe(9)
• nbcon_enter_unsafe(9)
• nbcon_exit_unsafe(9)
• nbcon_reacquire_nobuf(9)
• nbcon_emit_next_record(9)
• nbcon_kthread_should_wakeup(9)
• nbcon_kthread_func(9)
• nbcon_irq_work(9)
• nbcon_kthreads_wake(9)
• nbcon_kthread_create(9)
• nbcon_get_cpu_emergency_nesting(9)
• nbcon_get_default_prio(9)
• nbcon_allow_unsafe_takeover(9)
• nbcon_legacy_emit_next_record(9)
• __nbcon_atomic_flush_pending_con(9)
• nbcon_atomic_flush_pending_con(9)
• __nbcon_atomic_flush_pending(9)
• nbcon_atomic_flush_pending(9)
• nbcon_atomic_flush_unsafe(9)
• nbcon_cpu_emergency_enter(9)
• nbcon_cpu_emergency_exit(9)
• nbcon_alloc(9)
• nbcon_free(9)
• nbcon_device_try_acquire(9)
• nbcon_device_release(9)
• nbcon_kdb_try_acquire(9)
• nbcon_kdb_release(9)
• nbcon_write_context_is_braille(9)
• nbcon_braille_release(9)

---

✨ and that's the whole page, bestie ✨ this one lives in ./kernel/printk, dated October 2026, and it's forever known as nbcon_braille_try_acquire(9) — go forth and acquire responsibly 💅🎀🦋