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/.
Note:
Asynchronous messaging support is in its own kernel module.
In order to use it, you must add [module=async] to the procnto
line of your mkifs buildfile.
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 |