zmq_init man page

zmq_init — initialise 0MQ context


void *zmq_init (int io_threads);


The zmq_init() function initialises a 0MQ context.

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

The zmq_init() function shall return an opaque handle to the initialised context if successful. Otherwise it shall return NULL and set errno to one of the values defined below.



An invalid number of io_threads was requested.

See Also

zmq(7) zmq_term(3)


This manual page was written by the 0MQ community.

Referenced By

zmq(7), zmq_cpp(7), zmq_ctx_destroy(3), zmq_ctx_new(3), zmq_ctx_shutdown(3), zmq_ctx_term(3), zmq_getsockopt(3), zmq_inproc(7), zmq_setsockopt(3), zmq_socket(3), zmq_term(3).

Explore man page connections for zmq_init(3).

0MQ 2.2.0 04/04/2012