summaryrefslogtreecommitdiff
path: root/doc/zmq_close.txt
blob: 9964d361f44e77991ad5f919826acae19ad053a8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
zmq_close(3)
============


NAME
----
zmq_close - destroys 0MQ socket


SYNOPSIS
--------
'int zmq_close (void *s);'


DESCRIPTION
-----------
Destroys 0MQ socket (one created using
'zmq_socket' function). All sockets have to be properly closed before the
application terminates, otherwise memory leaks will occur. Note that any
outbound messages that haven't been psuhed to the network yet and any inbound
messages that haven't been received by the application yet will be dropped on
the socket shutdown.


RETURN VALUE
------------
In case of success the function returns zero. Otherwise it returns -1 and
sets 'errno' to the appropriate value.


ERRORS
------
No errors are defined.


EXAMPLE
-------
----
int rc = zmq_close (s);
assert (rc == 0);
----


SEE ALSO
--------
linkzmq:zmq_socket[3]
linkzmq:zmq_term[3]


AUTHOR
------
Martin Sustrik <sustrik at 250bpm dot com>