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()