nng_socket_pair - create a connected pair of BSD sockets

NAME SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO

NAME

nng_socket_pair − create a connected pair of BSD sockets

SYNOPSIS

#include <nng/nng.h>

int nng_socket_pair(int fds[2]);

DESCRIPTION

The nng_socket_pair() function creates a pair of connected BSD sockets. These sockets, which are returned in the fds array, are suitable for use with the socket transport.

On POSIX platforms, this is a thin wrapper around the standard socketpair() function, using the AF_UNIX family and the SOCK_STREAM socket type.

Note

At present only POSIX platforms implementing socketpair() are supported with this function.

Tip

This function may be useful for creating a shared connection between a parent process and a child process on UNIX platforms, without requiring a shared filesystem or TCP connection.

RETURN VALUES

This function returns 0 on success, and non−zero otherwise.

ERRORS

NNG_ENOMEM

Insufficient memory exists.

NNG_ENOTSUP

This platform does not support socket pairs.