Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ConnectFlags(), ConnectFlags_r()

Modify the flags associated with a connection

Synopsis:

#include <sys/neutrino.h>

int ConnectFlags( pid_t pid,
                  int coid, 
                  unsigned mask, 
                  unsigned bits );

int ConnectFlags_r( pid_t pid,
                    int coid, 
                    unsigned mask, 
                    unsigned bits );

Arguments:

pid
The ID of the process that the connection ID belongs to, or 0 for the current process.
coid
The ID of the connection whose flags you want to modify.
mask
A bitmap that indicates which bits are to be modified in the flags.
bits
The new value of the flags. The flags currently defined include:

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The ConnectFlags() and ConnectFlags_r() kernel calls modify flags associated with the specified connection. These kernel calls don't block.

These functions are identical except in the way they indicate errors. See the Returns section for details.

You need to initialize the bits that correspond to the flag in both the mask and bits arguments:

Returns:

The only difference between these functions is the way they indicate errors:

ConnectFlags()
The previous value of the flags associated with the connection. If an error occurs, the function returns -1 and sets errno.
ConnectFlags_r()
The previous value of the flags associated with the connection. This function does NOT set errno. If an error occurs, the negative of a value from the Errors section is returned.

Errors:

EBADF
The coid isn't a valid connection ID for the process.
ESRCH
The process ID is invalid.

Classification:

QNX Neutrino

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

See also:

ConnectAttach(), fcntl()