xs_shutdown (3)

int xs_shutdown (void *socket, int how);

This function partially closes the socket. It disconnects or unbinds an endpoint previously connected or bound by xs_bind() or xs_connect(). how parameter is the endpoint ID as returned by xs_bind() or xs_connect().

Endpoint shutdown honours linger socket option. I.e. if there are any pending outbound messages, Crossroads will try to push them to the network for the specified amount of time before giving up.

Note: inproc endpoints don\(cqt support partial shutdown at the moment.

The xs_shutdown() function shall return zero if successful. Otherwise it shall return -1 and set errno to one of the values defined below.

EINVAL

The endpoint ID supplied doesn\(cqt correspond to any active endpoint.

ENOTSUP

Specified endpoint doesn\(cqt support partial shutdown.

ETERM

The context associated with the specified socket was terminated.

ENOTSOCK

The provided socket was invalid.

Binding socket to an endpoint, then unbinding it.

/* Create a socket */
void *socket = xs_socket (context, XS_PUB);
assert (socket);
/* Bind it to a TCP endpoint */
int id = xs_bind (socket, "tcp://*:5555");
assert (id != -1);
/* Unbind the socket from the endpoint */
rc = xs_shutdown (socket, id);
assert (rc == 0);

xs_connect(3) xs_bind(3) xs(7)

This manual page was written by Martin Sustrik <\m[blue][email protected]\m[]\s-2\u[1]\d\s+2>.

1.

[email protected]

mailto:[email protected]