Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NN_CONNECT(3)			 nanomsg 1.0.0			 NN_CONNECT(3)

NAME
       nn_connect - add	a remote endpoint to the socket

SYNOPSIS
       #include	<nanomsg/nn.h>

       int nn_connect (int s, const char *addr);

DESCRIPTION
       Adds a remote endpoint to the socket s. The library would then try to
       connect to the specified	remote endpoint.

       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_connect and	nn_bind(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 negative value 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.

       ENODEV
	   Address specifies a nonexistent interface.

       ETERM
	   The library is terminating.

EXAMPLE
	   s = nn_socket (AF_SP, NN_PUB);
	   eid1	= nn_connect (s, "ipc:///tmp/test.ipc");
	   eid2	= nn_connect (s, "tcp://server001:5560");

SEE ALSO
       nn_inproc(7) nn_ipc(7) nn_tcp(7)	nn_socket(3) nn_bind(3)	nn_shutdown(3)
       nanomsg(7)

AUTHORS
       Martin Sustrik <sustrik@250bpm.com>

				  2016-06-10			 NN_CONNECT(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nn_connect&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help