kdb_getchar(9)

🌸 kdb_getchar(9) 🌸

okay bestie, welcome to the Kernel API Manual — yes, the actual kernel one, and yes, you're gonna get it. this page is about kdb_getchar, and honestly? she's a little diva with a lot going on under the hood. let's get into it 💅

---

✨ NAME ✨

kdb_getchar — read a single character from a kdb console (or consoles). that's it. that's the job. one (1) character. she's not greedy 💖

---

🎀 SYNOPSIS 🎀

char kdb_getchar (void );

---

🦋 ARGUMENTS 🦋

• void — no arguments. nothing. zero. she takes no notes and needs no input, she simply is 🫶

---

💜 DESCRIPTION 💜

so besides polling the various consoles that are currently enabled (yes, plural, she's got options), most of the work this function does is dealing with escape sequences. and bestie, that is where the drama lives 😭

here's the situation: an escape key could be the start of a vt100 control sequence such as \[D (that's the left arrow, iykyk), or it could just be a character in its own right. same key, two completely different identities. main character energy, honestly.

the standard method for detecting the difference is to wait for 2 seconds to see if there are any other characters. two whole seconds. an eternity. a vibe check with a timer.

and kdb is complicated by:

• the lack of a timer service (interrupts are off 😳 — yeah, off off)
• multiple input sources

so escape sequence processing has to be done as states in the polling loop. not vibes-based. states-based. we love structure 🧚

ngl this is one of those "the constraints are the whole personality" situations — no timer, no interrupts, several places for input to come from, and she still has to figure out whether you meant "escape" or "left arrow." iconic behavior, fr fr.

---

👑 RETURN 👑

the key pressed, or a control code derived from an escape sequence. that's the tea. you get the key, or you get the ✨transformed✨ version of it 🍓

---

🌈 SEE ALSO 🌈

• Kernel file ./kernel/debug/kdb/kdb_io.c
• kdb_handle_escape(9)
• kdb_position_cursor(9)

go read those next, bestie, they're literally the same friend group 💖

---

and that's the page!! 💅✨

cute little sign-off moment: this one lives in ./kernel/debug/kdb, and the date on her birth certificate says October 2026. slay, periodt, see you in the group chat 🌸🦋💜