serial_core_add_one_port(9)

💖 serial_core_add_one_port(9) 💖

okay so bestie, welcome to the Kernel API Manual, section 9 — this one's all about attaching a driver-defined port structure and honestly? it's giving backstage-pass energy 🎟️✨

---

✨ NAME ✨

serial_core_add_one_port — attach a driver-defined port structure 🫶

---

🌸 SYNOPSIS 🌸

int serial_core_add_one_port (struct uart_driver *drv , struct uart_port
*uport );

---

🎀 ARGUMENTS 🎀

• drv — pointer to the uart low level driver structure for this port 👑
• uport — uart port structure to use for this port 💅

---

🦋 CONTEXT 🦋

task context, might sleep 😴 — like, literally, this thing is allowed to nap, so don't go calling it from somewhere spicy where sleeping is a crime, ngl.

---

⭐ DESCRIPTION ⭐

so the whole vibe here is this: this lets the driver drv register its own uart_port structure with the core driver. that's the entire main character moment 💫

the main purpose? it lets the low level uart drivers expand uart_port instead of having, like, yet more levels of structures piled on top of each other 😭 (we been knew, enough layering already).

🙈 heads up bestie — the caller must hold port_mutex. no cap, that's not optional, that's the rule.

---

🌈 SEE ALSO 🌈

kernel file ./drivers/tty/serial/serial_core.c and, like, the whole friend group:

• uart_write_wakeup(9)
• uart_update_timeout(9)
• uart_get_baud_rate(9)
• uart_get_divisor(9)
• uart_get_lsr_info(9)
• uart_console_write(9)
• uart_parse_earlycon(9)
• uart_parse_options(9)
• uart_set_options(9)
• uart_change_pm(9)
• uart_register_driver(9)
• uart_unregister_driver(9)
• serial_core_remove_one_port(9)
• uart_match_port(9)
• uart_handle_dcd_change(9)
• uart_handle_cts_change(9)
• uart_insert_char(9)
• uart_try_toggle_sysrq(9)
• uart_get_rs485_mode(9)

---

and that's the whole page, bestie 💜 go forth and register those ports responsibly ✨

sign-off cuteness: this lil masterpiece lives in ./drivers/tty/serial, dropped October 2026, and it's filed under serial_core_add_one_port(9) 🎀💖 mwah, ily, happy hacking 🧚‍♀️