zmq_init

Langue: en

Autres versions - même langue

Version: 03/16/2010 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

NAME

zmq_init - initialise 0MQ context

SYNOPSIS

void *zmq_init (int app_threads, int io_threads, int flags);

DESCRIPTION

The zmq_init() function initialises a 0MQ context with app_threads application threads and io_threads I/O threads.

The app_threads argument specifies the maximum number of application threads that will be using 0MQ sockets in this context. As a guide, set this to the number of threads in your application.

The io_threads argument specifies the size of the 0MQ thread pool to handle I/O operations. If your application is using inproc messaging exclusively you may set this to zero, otherwise set it to at least one.

The flags argument is a combination of the flags defined below:

ZMQ_POLL

Specifies that sockets within this context should support multiplexing using zmq_poll(). Enabling this functionality may add a small amount of latency to message transfers compared to leaving it disabled.

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.

ERRORS

EINVAL

The number of app_threads requested is less than one, or the number of io_threads requested is negative.

SEE ALSO

zmq(7) zmq_term(3)

AUTHORS

The 0MQ documentation was written by Martin Sustrik <m[blue]sustrik@250bpm.comm[][1]> and Martin Lucina <m[blue]mato@kotelna.skm[][2]>.

NOTES

1.
sustrik@250bpm.com
mailto:sustrik@250bpm.com
2.
mato@kotelna.sk
mailto:mato@kotelna.sk