io_fd(3) [debian man page]

io_fd(3)						     Library Functions Manual							  io_fd(3)

NAME

       io_fd - prepare descriptor for io_wait

SYNTAX

       #include <io.h>

       int io_fd(int64 fd);

DESCRIPTION

       If  you	want to use io_canread() and io_canwrite() on a descriptor, you have to use io_wait() on it first, and io_wait() has to know which
       descriptors you are interested in.  Use io_fd() for this.

       io_pipe and io_socketpair already call io_fd 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.  It does not work on files.

RETURN VALUE

       io_fd returns 1 on success, 0 on error.

SEE ALSO

       io_wait(3), io_wantread(3), io_canread(3), io_eagain(3), io_nonblock(3)

																	  io_fd(3)

io_wait(3)						     Library Functions Manual							io_wait(3)

NAME

       io_wait - wait for events

SYNTAX

       #include <io.h>

       void io_wait();

DESCRIPTION

       io_wait()  checks  the  descriptors  that  the  program	is  interested in to see whether any of them are ready. If none of them are ready,
       io_wait() tries to pause until one of them is ready, so that it does not take time away from other programs running on the same computer.

       io_wait pays attention to timeouts: if a descriptor reaches its timeout, and the program is interested in reading or writing that  descrip-
       tor, io_wait will return promptly.

       Under  some  circumstances,  io_wait will return even though no interesting descriptors are ready. Do not assume that a descriptor is ready
       merely because io_wait has returned.

       io_wait is not interrupted by the delivery of a signal. Programs that expect interruption are unreliable: they will block if the same  sig-
       nal is delivered a moment before io_wait. The correct way to handle signals is with the self-pipe trick.

SEE ALSO

       io_waituntil(3), io_check(3), io_wantread(3), io_wantwrite(3), io_fd(3)

																	io_wait(3)