#include <nanomsg/nn.h>
int nn_connect(int sock, const char *url)
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. |
nn_connect(3compat)
NAME
nn_connect - connect to remote peer (compatible API)
SYNOPSIS
DESCRIPTION
The nn_connect()
function arranges for the socket sock to
initiate connection to a peer at the address specified by url.
An identifier for this socket’s association with the url is
returned to the caller on success.
This identifier can be used with
nn_shutdown()
to
remove the association later.
This function is provided for API compatibility with legacy libnanomsg. Consider using the relevant modern API instead. |
The connect operation is performed asynchronously, and may not have completed before this function returns control to the caller. |
Only transports supported by legacy libnanomsg may be
used with this function.
In particular, only the schemes tcp:// , ipc:// , inproc:// , and ws:// are
supported with this function.
(Use the modern API to use other schemes.)
|
RETURN VALUES
This function returns a positive identifier success, and -1 on error.
ERRORS
ECONNREFUSED
|
The connection attempt was refused. |
EBADF
|
The socket sock is not open. |
EINVAL
|
An invalid url was supplied. |