summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMartin Sustrik <sustrik@250bpm.com>2011-03-03 12:15:08 +0100
committerMartin Sustrik <sustrik@250bpm.com>2011-03-03 12:15:08 +0100
commit97add1ec2f75858ee950fa19b266396147efa224 (patch)
tree8171ca80fa678bdf8853c54211081c3d8e592099 /doc
parent18b9ebea32fbf4a4552b0435c8759e5e5c6fe219 (diff)
Documentation wrt thread-safety cleaned up.
Signed-off-by: Martin Sustrik <sustrik@250bpm.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/zmq_init.txt5
-rw-r--r--doc/zmq_socket.txt13
2 files changed, 8 insertions, 10 deletions
diff --git a/doc/zmq_init.txt b/doc/zmq_init.txt
index 04bbbc8..4f1def1 100644
--- a/doc/zmq_init.txt
+++ b/doc/zmq_init.txt
@@ -20,6 +20,11 @@ The 'io_threads' argument specifies the size of the 0MQ thread pool to handle
I/O operations. If your application is using only the 'inproc' transport for
messaging you may set this to zero, otherwise set it to at least one.
+.Thread safety
+A 0MQ 'context' is thread safe and may be shared among as many application
+threads as necessary, without any additional locking required on the part of
+the caller.
+
RETURN VALUE
------------
diff --git a/doc/zmq_socket.txt b/doc/zmq_socket.txt
index da41ad7..99fe7ad 100644
--- a/doc/zmq_socket.txt
+++ b/doc/zmq_socket.txt
@@ -47,16 +47,9 @@ incoming connections *from multiple endpoints* bound to the socket using
_zmq_bind()_, thus allowing many-to-many relationships.
.Thread safety
-A 0MQ 'context' is thread safe and may be shared among as many application
-threads as necessary, without any additional locking required on the part of
-the caller.
-
-Individual 0MQ 'sockets' are _not_ thread safe except in the case where full
-memory barriers are issued when migrating a socket from one thread to another.
-In practice this means applications can create a socket in one thread with
-_zmq_socket()_ and then pass it to a _newly created_ thread as part of thread
-initialization, for example via a structure passed as an argument to
-_pthread_create()_.
+0MQ 'sockets' are _not_ thread safe. Applications MUST NOT use a socket
+from multiple threads except after migrating a socket from one thread to
+another with a "full fence" memory barrier.
.Socket types
The following sections present the socket types defined by 0MQ, grouped by the