Examine or change connection attributes for asynchronous messaging
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_attr (
int coid,
struct _asyncmsg_connection_attr *old_attr,
const struct _asyncmsg_connection_attr *new_attr);
Arguments:
- coid
- The connection ID.
- old_attr
- NULL, or a pointer to a
_asyncmsg_connection_attr
structure where the function can store the current attributes for the
connection.
- new_attr
- NULL, or a pointer to a
_asyncmsg_connection_attr structure that specifies
the attributes to set for the connection.
Library:
libasyncmsg
Use the -l asyncmsg option to
qcc
to link against this library.
Description:
You can use asyncmsg_connect_attr() to get or set the attributes
to the connection used for asynchronous messaging:
- If old_attr isn't NULL, the function stores
the current connection attributes in the structure that it points to.
- If new_attr isn't NULL, the function sets the connection
attributes to the contents of the buffer it points to.
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 |