n_hdlc_buf_return(9)

✨ n_hdlc_buf_return — put the HDLC buffer after the head of the specified list ✨

okay so this is a page from the Kernel API Manual, bestie, and it's a tiny little function with a very specific job. Let's get into it 💅

🌸 SYNOPSIS 🌸

void n_hdlc_buf_return (struct n_hdlc_buf_list *buf_list , struct n_hdlc_buf *buf );

literally that's it. no return value, no drama, just vibes and two pointers 🫶

🎀 ARGUMENTS 🎀

• buf_list — pointer to the buffer list. this is the list you're messing with, she's the main character here 👑
• buf — pointer to the buffer. the little guy getting yeeted back into place ✨

🦋 SEE ALSO 🦋

Kernel file ./drivers/tty/n_hdlc.c plus the whole n_hdlc friend group, all linked up and thriving:

• struct n_hdlc(9)
• n_hdlc_tty_close(9)
• n_hdlc_tty_open(9)
• n_hdlc_send_frames(9)
• n_hdlc_tty_write_work(9)
• n_hdlc_tty_wakeup(9)
• n_hdlc_tty_receive(9)
• n_hdlc_tty_read(9)
• n_hdlc_tty_write(9)
• n_hdlc_tty_ioctl(9)
• n_hdlc_tty_poll(9)
• n_hdlc_alloc(9)
• n_hdlc_buf_put(9)
• n_hdlc_buf_get(9)

iykyk, it's a whole ecosystem 💀

ngl there's not a ton to say about this one — the NAME line is the whole personality: it puts the HDLC buffer after the head of the specified list. that's the assignment and she ate 🔥

and that's the whole page, bestie 💖 this little writeup lives over in ./drivers/tty and it's dated October 2026 — manual name Kernel API Manual, page n_hdlc_buf_return(9), and yes she's short but she's iconic. periodt 🌈⭐