ZMQ_INIT(3)

📦
version 4.3.5 · 2 versions
, in arch rolling

💖 ZMQ_INIT(3) — 0MQ Manual 💖

🌸 NAME 🌸

zmq_init — the function that initialises a 0MQ context 💅

✨ SYNOPSIS ✨

void *zmq_init (int io_threads);

🦋 DESCRIPTION 🦋

Okay so zmq_init() initialises a 0MQ context. That's the whole mission, bestie. ✨

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. No extra locks, no stress — it's giving shareable. 🫶

Heads up: this function is deprecated by zmq_ctx_new(3). So this is the deprecated one, bestie. 😭

🌈 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. Successful vibe: opaque handle. Not successful vibe: NULL plus errno. 💀

🍓 ERRORS 🍓

  • EINVAL — an invalid number of io_threads was requested. Not me asking for a weird thread count 🙈.

🎀 SEE ALSO 🎀

👑 AUTHORS 👑

This page was written by the 0MQ community. To make a change please read the 0MQ Contribution Policy at http://www.zeromq.org/docs:contributing. 💜

okay bye bestie — this iconic little page is from 0MQ 4.3.5, dated 02/15/2026. periodt. 💅✨

📦 where this page comes from