Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
io_fd(3)		   Library Functions Manual		      io_fd(3)

NAME
       io_fd - prepare descriptor for io_wait

SYNTAX
       #include	<libowfat/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  de-
       scriptors you are interested in.	io_fd()	informs	io_wait() that you are
       interested in this fd.

       If  you know that the descriptor	is writable, call io_fd_canwrite() in-
       stead. Most fresh descriptors  are  writable,  e.g.  if	it  came  from
       pipe(2) or socketpair(2)	or accept(2). This will	save one syscall.

       io_pipe and io_socketpair already call io_fd_canwrite() 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_fd_canwrite(3), io_wait(3),  io_wantread(3),	io_canread(3),	io_ea-
       gain(3),	io_nonblock(3)

								      io_fd(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libowfat_io_fd&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help