Destroy an asynchronous message 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_channel_destroy( int chid );
Arguments:
- chid
- The ID of the channel to destroy.
Library:
libasyncmsg
Use the -l asyncmsg option to
qcc
to link against this library.
Description:
The asyncmsg_channel_destroy() function destroys the asynchronous message channel
specified by chid.
If you provided a callback function when you called
asyncmsg_channel_create(),
asyncmsg_channel_destroy() invokes the callback to free any
outstanding receive buffers; otherwise, asyncmsg_channel_destroy()
uses
free().
Returns:
EOK, or -1 if an error occurred
(errno is set).
Errors:
- EINVAL
- The channel specified by chid doesn't exist.
Classification:
QNX Neutrino
Safety: |
|
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |