NAME

       io_close - close a file descriptor

SYNTAX

       #include <libowfat/io.h>

       void io_close(int64 fd);

DESCRIPTION

       io_close eliminates the descriptor numbered fd. This usually does not mean eliminating the
       object that the descriptor is talking to.  (For example, if a descriptor writes to a named
       disk  file,  closing the descriptor will not remove the file; it simply removes one way of
       writing to the file. On the other hand, a pipe disappears as soon as no descriptors  refer
       to it.)

       io_close  has  no return value; it always succeeds in deallocating the memory used for the
       descriptor.  If fd is not the number of a descriptor, io_close has no effect.

       io_close() is like close(), but it also removes the descriptor from the internal io_wait()
       data  structures.   If you called io_fd on a descriptor, you need to use io_close to close
       it, not just close().

SEE ALSO

       io_wait(3), io_canwrite(3)

                                                                                      io_close(3)