#include <nng/nng.h>
#include <nng/supplemental/util/platform.h>
int nng_socket_pair(int fds[2]);
This documentation is for version v1.7.2 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
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. |