asyncmsg_connect_detach()

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


Caution: 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

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

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