ha_ConnectAttach(), ha_ConnectAttach_r()
Create a connection and attach it to the HA lib
Synopsis:
#include <ha/neutrino.h>
int ha_ConnectAttach(uint32_t *nd,
pid_t pid,
int chid,
unsigned index,
unsigned flags,
RFp rfn,
void *rhdl,
unsigned haflags);
int ha_ConnectAttach_r(uint32_t *nd,
pid_t pid,
int chid,
unsigned index,
unsigned flags,
RFp rfn,
void *rhdl,
unsigned haflags);
Library:
libha
Description:
The ha_ConnectAttach() and
ha_ConnectDetach_r() functions are identical
except in the way they return errors. (For details, see the
Returns
section.)
In addition to creating the connection using the standard ConnectAttach|_r() call, these convenience functions also call ha_attach() with the connection returned by the ConnectAttach() call.
The parameters rfn(), and rhdl(), and haflags() are passed to the ha_attach() call along with the connection ID returned by the ConnectAttach() call.
The remaining parameters are passed to the corresponding parameters in the ConnectAttach() call in their appropriate positions.
Returns:
The only difference between these functions is the way they indicate errors:
- ha_ConnectAttach()
- A connection ID that's used by the message primitives. If an error occurs, -1 is returned and errno is set.
- ha_ConnectAttach_r()
- A connection ID that's used by the message primitives. This function does NOT set errno. If an error occurs, the negative of a value from the errors returned by either the underlying ConnectAttach() call or the ha_attach() call.
Errors:
The ha_ConnectAttach|_r() call returns errors as returned by either the underlying ConnectAttach() call or the ha_attach() call.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | No |
| Signal handler | No |
| Thread | Yes |