k3_ringacc_ring_pop_tail(9)
π k3_ringacc_ring_pop_tail β like, the whole page
okay so real talk, this is a page out of the Kernel API Manual, and it's about one tiny little function that pops a thing off the tail end of a ring. yes. that's the whole plot. but it's iconic and we're gonna learn it π
β¨ NAME β¨
k3_ringacc_ring_pop_tail β pop element from the ring tail π
πΈ SYNOPSIS πΈ
int k3_ringacc_ring_pop_tail (struct k3_ring *ring , void *elem );
π¦ ARGUMENTS π¦
ringβ pointer on ring. yes bestie, it's a pointer on the ring, that's the wording, we don't argue with the wording π«Άelemβ pointer on ring element buffer. this is where the popped element ends up, so hand it somewhere real to live.
π₯ DESCRIPTION π₯
Push one ring element from the ring tail. (no bc that is literally what the page says, and I am not out here editing the docs, iykyk ππ)
The size of the ring element is determined by the ring configuration struct k3_ring_cfg β specifically its elm_size field. so like, the ring already knows how big its elements are, you don't gotta tell it. main character energy fr β¨
It returns 0 on success, or errno otherwise. ngl, errno on a bad day. π
β οΈ Not Supported by ring modes: K3_RINGACC_RING_MODE_RING. if your ring is in that mode, this function is not it. hard pass. π
π SEE ALSO π
the whole friend group, no cap π:
Kernel file ./include/linux/soc/ti/k3-ringacc.henum k3_ring_mode(9)enum k3_ring_size(9)of_k3_ringacc_get_by_phandle(9)k3_ringacc_request_ring(9)k3_ringacc_ring_reset(9)k3_ringacc_ring_free(9)k3_ringacc_get_ring_id(9)k3_ringacc_get_ring_irq_num(9)k3_ringacc_ring_cfg(9)k3_ringacc_ring_get_size(9)k3_ringacc_ring_get_free(9)k3_ringacc_ring_get_occ(9)k3_ringacc_ring_is_full(9)k3_ringacc_ring_push(9)k3_ringacc_ring_pop(9)k3_ringacc_ring_push_head(9)
okay that's the page!! πβ¨ shoutout to the source over at ./include/linux/soc/ti and the October 2026 date stamp β that's the version vibe, periodt. go pop some tails bestie, ily, drink water ππ¦πΈ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms