#include <nng/nng.h>
#include <nng/supplemental/util/platform.h>
int nng_socket_pair(int fds[2]);
This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. 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. |