relay_destroy_channel(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’– relay_destroy_channel(9) β€” the kernel API manual, but make it cute πŸŽ€

okay so bestie, welcome to the Kernel API Manual entry for relay_destroy_channel(9) β€” yes the (9) is giving "section 9, kernel developer era" and honestly? iconic. this is the whole page, no skips, no cuts, we're doing the full read 🫢


✨ NAME ✨

relay_destroy_channel β€” literally just frees the channel struct. that's the whole vibe. one job, does it, periodt πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

void relay_destroy_channel (struct kref *kref );

like yes, that's the entire signature. void return because it doesn't report back to you, it just does the thing and dips 😌


🌸 ARGUMENTS 🌸

  • kref β€” the target kernel reference that contains the relay channel πŸ’– this is the struct you're handing over, and it's the kernel reference wrapping your relay channel, so like… know which one you're passing, okay? πŸ™ˆ

πŸ‘‘ DESCRIPTION πŸ‘‘

okay so here's the tea: relay_destroy_channel frees the channel struct. that's it, that's the function.

but β€” and this is the important part, bestie β€” it should only be called from kref_put. not "you could also call it from here," not "maybe from there," no. only from kref_put. this is not a suggestion, this is the rule 🌈

πŸ’€ fr fr do not go calling this from random places, the manpage said only from kref_put and we respect the manpage in this house

⭐ SEE ALSO ⭐

the whole relay.c cinematic universe, bestie β€” grab a snack, there's a lot:

Kernel file ./kernel/relay.c and then: relay_mmap_prepare_buf(9), relay_alloc_buf(9), relay_create_buf(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)

that's the full guest list, no plus-ones, everyone named gets an invite πŸ’Œ


okay that's the page!! mwah πŸ’‹ this one lives in ./kernel, it's dated October 2026, and it's filed under relay_destroy_channel(9) β€” go free that channel struct responsibly bestie, and remember: kref_put only πŸ”₯βœ¨πŸŽ€

πŸ“¦ where this page comes from