NN_BIND(3) nanomsg manual NN_BIND(3)NAMEnn_bind - add a local endpoint to the socket
SYNOPSIS
#include <nanomsg/nn.h>
int nn_bind (int s, const char *addr);
DESCRIPTION
Adds a local endpoint to the socket s. The endpoint can be then used by
other applications to connect to.
The addr argument consists of two parts as follows:
transport://address. The transport specifies the underlying transport
protocol to use. The meaning of the address part is specific to the
underlying transport protocol.
For the list of available transport protocols check the list on
nanomsg(7) manual page.
Maximum length of the addr parameter is specified by NN_SOCKADDR_MAX
defined in <nanomsg/nn.h> header file.
Note that nn_bind and nn_connect(3) may be called multiple times on the
same socket thus allowing the socket to communicate with multiple
heterogeneous endpoints.
RETURN VALUE
If the function succeeds positive endpoint ID is returned. Endpoint ID
can be later used to remove the endpoint from the socket via
nn_shutdown(3) function.
If the function fails, then -1 is returned and errno is set to to one
of the values defined below.
ERRORS
EBADF
The provided socket is invalid.
EMFILE
Maximum number of active endpoints was reached.
EINVAL
The syntax of the supplied address is invalid.
ENAMETOOLONG
The supplied address is too long.
EPROTONOSUPPORT
The requested transport protocol is not supported.
EADDRNOTAVAIL
The requested endpoint is not local.
ENODEV
Address specifies a nonexistent interface.
EADDRINUSE
The requested local endpoint is already in use.
ETERM
The library is terminating.
EXAMPLE
s = nn_socket (AF_SP, NN_PUB);
eid1 = nn_bind (s, "inproc://test");
eid2 = nn_bind (s, "tcp://127.0.0.1:5560");
SEE ALSOnn_inproc(7)nn_ipc(7)nn_tcp(7)nn_socket(3)nn_connect(3)nn_shutdown(3)nanomsg(7)AUTHORS
Martin Sustrik <sustrik@250bpm.com[1]>
NOTES
1. sustrik@250bpm.com
mailto:sustrik@250bpm.com
nanomsg Unknown 12/23/2015 NN_BIND(3)
