nng_socket_pair(3supp)

NNG_SOCKET_PAIR(3supp)

NNG Reference Manual

NNG_SOCKET_PAIR(3supp)

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.