asyncmsg_connect_detach()

Break a connection used for asynchronous messages between a process and a channel

---

Asynchronous messaging is an experimental feature; for information about the use of experimental software, see the Commercial Software License Agreement (CSLA) or Partner Software License Agreement (PSLA) in the Licensing area of our website, http://www.qnx.com/legal/licensing/.

---

Synopsis:

#include <sys/asyncmsg.h> 

int asyncmsg_connect_detach( int coid );

Arguments:

coid

The connection ID of the connection you want to break.

Library:

libasyncmsg

Use the -l asyncmsg option to qcc to link against this library.

Description:

The asyncmsg_connect_detach() function breaks the connection specified by the connection ID coid argument. All the messages buffered on the sender side will be discarded. If you want to ensure that all the messages sent have been delivered, call asyncmsg_flush() before calling this function.

Returns:

EOK, or -1 if an error occurred (errno is set).

Errors:

EINVAL

The connection specified by coid doesn't exist.

Classification:

QNX Neutrino

See also:

asyncmsg_channel_create(), asyncmsg_channel_destroy(), asyncmsg_connect_attach(), asyncmsg_connect_attr(), asyncmsg_flush(), asyncmsg_free(), asyncmsg_get(), asyncmsg_malloc(), asyncmsg_put(), asyncmsg_putv()

ConnectDetach()

Asynchronous Messaging Technote