relay_alloc_buf(9)

💅 relay_alloc_buf(9) 💅

okay so welcome to the Kernel API Manual, bestie — this is the relay_alloc_buf(9) entry, and it’s giving “tiny but important allocation moment.” ✨

🌸 NAME 🌸

relay_alloc_buf — allocate a channel buffer. that’s the whole vibe 🎀

✨ SYNOPSIS ✨

void * relay_alloc_buf (struct rchan_buf *buf , size_t *size );

🎀 ARGUMENTS 🎀

• buf — the buffer struct. the struct we’re working with, periodt 💖
• size — total size of the buffer. total total, not “ish” 😌

💖 DESCRIPTION 💖

Returns a pointer to the resulting buffer, and NULL if unsuccessful. no cap, NULL is the “it didn’t work” signal 😭

The passed in size will get page aligned, if it isn’t already. so if it’s already page aligned, iconic; if not, it gets page aligned. that’s the rule ✨

lowkey important: unsuccessful means you get NULL back — that’s the failure state, bestie 💀

🦋 SEE ALSO 🦋

Kernel file ./kernel/relay.c — go look at the source, you gorgeous nerd 👑

• relay_mmap_prepare_buf(9)
• relay_create_buf(9)
• relay_destroy_channel(9)
• relay_destroy_buf(9)
• relay_remove_buf(9)
• relay_buf_empty(9)
• relay_buf_full(9)
• wakeup_readers(9)
• __relay_reset(9)
• relay_reset(9)
• relay_close_buf(9)
• relay_open(9)
• relay_switch_subbuf(9)
• relay_subbufs_consumed(9)
• relay_close(9)
• relay_flush(9)
• relay_stats(9)
• relay_file_open(9)
• relay_file_mmap_prepare(9)
• relay_file_poll(9)
• relay_file_release(9)
• relay_file_read_subbuf_avail(9)
• relay_file_read_start_pos(9)
• relay_file_read_end_pos(9)

mwah 💋 this page is from ./kernel, dated October 2026, and it’s the relay_alloc_buf(9) manual. bye bestie, go be iconic with your buffers 🫶🌈