prb_init(9)

💖 prb_init(9) — Kernel API Manual glow-up ✨

okay bestie, welcome to prb_init(9) from the Kernel API Manual! This is the page for prb_init, and it's giving “set up your ringbuffer with buffers you brought from home” energy. Let's go 💅

🌸 NAME

prb_init — Initialize a ringbuffer to use provided external buffers. Periodt. 🎀

✨ SYNOPSIS

void prb_init (struct printk_ringbuffer *rb , char *text_buf , unsigned
       int textbits , struct prb_desc *descs , unsigned int descbits , struct
       printk_info *infos );

🧚 ARGUMENTS

• rb — the ringbuffer to initialize. that's the main character you're setting up 💖
• text_buf — the data buffer for text data. it's where the text lives, no cap.
• textbits — the size of text_buf as a power-of-2 value. yes, power-of-2, not vibes.
• descs — the descriptor buffer for ringbuffer records. iconic.
• descbits — the count of descs items as a power-of-2 value. keep that power-of-2 energy ✨
• infos — the printk_info buffer for ringbuffer records. slay.

🔥 DESCRIPTION

This is the public function available to writers to setup a ringbuffer during runtime using provided buffers. literally the public-facing setup era 💅

This must match the initialization of DEFINE_PRINTKRB. no cap, it has to match — don't freestyle this part. 👑

🦋 CONTEXT

Any context. that's it. any. context. 🫶

🌈 SEE ALSO

• Kernel file ./kernel/printk/printk_ringbuffer.c and printk_ringbuffer overview(9) — bestie, it's right there in the tree.
• prb_reserve_in_last(9)
• prb_reserve(9)
• prb_commit(9)
• prb_final_commit(9)
• prb_next_reserve_seq(9)
• prb_read_valid(9)
• prb_read_valid_info(9)
• prb_first_valid_seq(9)
• prb_next_seq(9)
• prb_record_text_space(9)

byeee bestie 🫶 — source/version ./kernel/printk, dated October 2026, page prb_init(9). mwah 💋✨