Table of Contents
gfs_new_handle - Create and return a gfs_handle
#include <gfs.h>
gfs_handle gfs_new_handle();
gfs_new_handle returns a gfs_handle that will be used in
non-blocking calls. Each handle may have at most one
outstanding non-blocking call, and handles may be reused.
While most non-blocking I/O interfaces use some form of
handle, our approach is slightly different. Most interfaces
return a handle to the user when a non-blocking call is
issued, and the handle disappears once the call is
completed. Galley's non-blocking I/O is based on reusable
handles for efficiency. Creating and destroying a handle
takes a fair amount of work, so an application that issued a
lot of non-blocking calls could spend a noticable amount of
time just performing this overhead.
gfs_new_handle returns the new handle, or NULL if a handle
could not be created.
Table of Contents