QNX Developer Support
|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Break a connection between a process and a channel
#include <sys/neutrino.h> int ConnectDetach( int coid ); int ConnectDetach_r( int coid );
- The connection ID of the connection you want to break.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The ConnectDetach() and ConnectDetach_r() kernel calls detach the connection specified by the coid argument. If any threads are blocked on the connection (MsgSendv()) at the time the connection is detached, the send fails and returns with an error.
These functions are identical except in the way they indicate errors. See the Returns section for details.
These calls don't block.
The only difference between these functions is the way they indicate errors:
- If an error occurs, the function returns -1 and sets errno. Any other value returned indicates success.
- EOK is returned on success. This function does NOT set errno. If an error occurs, the function returns a value in the Errors section.
- The connection specified by coid doesn't exist.