io_dontwantread(3)

💖 io_dontwantread(3) 💖

okay bestie, so this one lives in the Library Functions Manual and it's literally called io_dontwantread — yes that's the whole vibe of the page, we're in the libowfat/io.h cinematic universe now 🦋

✨ NAME ✨

io_dontwantread — the little function that says "not right now, babe" to a descriptor 💅

🌸 SYNTAX 🌸

#include <libowfat/io.h>

void io_dontwantread(int64 fd);

🎀 DESCRIPTION 🎀

so io_dontwantread is you telling the next io_wait() that you do not want to read from this descriptor for now. like, respectfully, not today. 🙈

changed your mind? iconic. just call io_wantread() again and we're so back 💖

before any of this works tho, you have to have called io_fd on the descriptor first — and ngl, io_pipe and io_socketpair already do that for you, so they're the besties who handle it 🫶

⚠️ real talk: waiting on descriptors only works for sockets, fifos and pipes. it may also work on devices and TTYs, but that is platform dependent — you should not rely on that. no cap, don't build your whole personality on it 💀

👑 SEE ALSO 👑

• io_wait(3)
• io_canread(3)
• io_wantread(3)
• io_fd(3)

and that's the whole page, bestie ✨ this was io_dontwantread(3) from the Library Functions Manual — slay, go tell your descriptors how you feel 💅🌸🎀