datagram_poll_queue(9)

📦 version 7.3.1, in nixpkgs unstable

🦋 datagram_poll_queue(9) 🦋

okay so bestie, welcome to the Kernel API Manual — this one's a lil function called datagram_poll_queue and it is literally the group-chat lurker of the socket world. let's get into it 💅

✨ NAME ✨

datagram_poll_queue — it's giving same as datagram_poll, but it does the whole thing on a specific receive queue instead of the default one. no cap. 🫶

✨ SYNOPSIS ✨

__poll_t datagram_poll_queue (struct file *file , struct socket *sock ,
poll_table *wait , struct sk_buff_head *rcv_queue );

like, that's the whole signature, she's not hiding anything 🌸

✨ ARGUMENTS ✨

  • file — the file struct. yes. that one. the file. 🎀
  • sock — the socket. the main character of this whole operation fr fr 👑
  • wait — the poll table. it's the VIP list for who's waiting on what 🔥
  • rcv_queue — the receive queue you actually wanna poll. this one. not the other one. 💅

✨ DESCRIPTION ✨

so what does she actually do? datagram_poll_queue performs polling on the given receive queue — and while she's at it she's handling shutdown, error, and connection state too, because she's multitasking like that 💖

and why would you even need this? bc some protocols are extra 💀 — they deliver userspace-bound packets through a custom queue instead of sk->sk_receive_queue. so if your protocol refuses to use the standard-issue queue, this is the function for you. iykyk 🧚

✨ RETURN ✨

returns a poll bitmask indicating the socket's current state. that's the vibe check result, delivered straight to you ✨

✨ SEE ALSO ✨

okay these are all the siblings, the whole extended family, look at them go 😭 all of these are in the Kernel file ./net/core/datagram.c:

lowkey important: this page lives in ./net/core and it's dated October 2026 — so yeah, from the future, slay 🦋

and that's the whole page bestie, mwah, go poll something 💜🎀🌈

📦 where this page comes from