void gre_io_close(
gre_io_t * handle
)
Close an io connection. Any pending clients will return with an error on
their pending actions. This call should be serialized with other clients that
are referencing the same gre_io_t handle to avoid race conditions.
A common technique for closing handles where a receiving thread may be blocked
on the handle is to generate a termination event and have the receiving thread
perform the close and channel cleanup.
Parameters:
handle A valid handle created with gre_io_open()