---
name: "io_wantwrite"
section: "3"
platform: "linux"
package: "libowfat-dev"
version: "0.32-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/io_wantwrite"
---

# io\_wantwrite(3)

signal that you want to write to a descriptor

## NAME

io\_wantwrite - signal that you want to write to a descriptor

## SYNTAX

**#include \<libowfat/io.h\>**

void **io\_wantwrite**(int64 fd);

## DESCRIPTION

io\_wantwrite tells the next io\_wait() that you want to write to this descriptor.  Call io\_dontwantwrite() again if you change your mind.

The next time you call io\_wait(), it will look whether this descriptor becomes writeable, too.  You can then use io\_canwrite() to check whether the descriptor has become writable.

You have to have called io\_fd on the descriptor first (io\_pipe and io\_socketpair do this for you).  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.

## SEE ALSO

[io\_wait(3)](/io_wait/3.md), [io\_canwrite(3)](/io_canwrite/3.md), [io\_wantwrite(3)](/io_wantwrite/3.md), [io\_fd(3)](/io_fd/3.md)
