This documentation is for version v1.7.1 of NNG, but the latest released version is v1.8.0. see the documentation for v1.8.0 for the most up-to-date information.

nng_socket_pair(3supp)

NAME

nng_socket_pair - create a connected pair of BSD sockets

SYNOPSIS

#include <nng/nng.h>
#include <nng/supplemental/util/platform.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.

At present only POSIX platforms implementing socketpair() are supported with this function.
This function may be useful for creating a shared connection between a parent process and a child process on UNIX platforms, without requiring the processes use 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.

SEE ALSO