Skip to content

Latest commit

 

History

History
52 lines (36 loc) · 1.44 KB

nng_socket_pair.3supp.adoc

File metadata and controls

52 lines (36 loc) · 1.44 KB

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.

SEE ALSO