summaryrefslogtreecommitdiff
path: root/doc/zmq_flush.txt
blob: 83ba32c409e5981613e3b3e3fdcc4bcde616801a (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
53
54
55
zmq_flush(3)
============


NAME
----
zmq_flush - flush messages queued on a socket


SYNOPSIS
--------
*int zmq_flush (void '*socket');*


DESCRIPTION
-----------
The _zmq_flush()_ function shall flush messages previously queued on the socket
referenced by the 'socket' argument. The _zmq_flush()_ function only affects
messages that have been queued on the _message queue_ associated with 'socket'
using the 'ZMQ_NOFLUSH' flag to the _zmq_send()_ function. If no such messages
exist, the function has no effect.

CAUTION: A successful invocation of _zmq_flush()_ does not indicate that the
flushed messages have been transmitted to the network, or even that such a
transmission has been initiated by 0MQ. This function exists merely as a way
for the application programmer to supply a hint to the 0MQ infrastructure that
the queued messages *may* be flushed as a single batch.


RETURN VALUE
------------
The _zmq_flush()_ function shall return zero if successful. Otherwise it shall
return `-1` and set 'errno' to one of the values defined below.


ERRORS
------
*ENOTSUP*::
The _zmq_flush()_ operation is not supported by this socket type.
*EFSM*::
The _zmq_flush()_ operation cannot be performed on this socket at the moment
due to the socket not being in the appropriate state.


SEE ALSO
--------
linkzmq:zmq_send[3]
linkzmq:zmq_socket[3]
linkzmq:zmq[7]


AUTHOR
------
The 0MQ documentation was written by Martin Sustrik <sustrik@250bpm.com> and
Martin Lucina <mato@kotelna.sk>.