ZMQ_CTX_SHUTDOWN(3)

📦
version 4.3.5 · 10 versions
, in epel 10, fedora 43, fedora 44, opensuse-leap 16.0

ZMQ_CTX_SHUTDOWN 💅

okay bestie, so this is the 0MQ Manual page for zmq_ctx_shutdown — yes it's a C function in the ZeroMQ library, and yes it's lowkey iconic. sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

zmq_ctx_shutdown — shutdown a 0MQ context

🎀 SYNOPSIS 🎀

int zmq_ctx_shutdown (void *context);

💖 DESCRIPTION 💖

so the zmq_ctx_shutdown() function shall shutdown the 0MQ context context. that's it, that's the whole vibe. ✨

context shutdown will cause any blocking operations currently in progress on sockets open within context to return immediately with an error code of ETERM. like, no waiting around, no "give me one more sec", just instant. 😭

with the exception of zmq_close(), any further operations on sockets open within context shall fail with an error code of ETERM. and listen — no further sockets can be created using zmq_socket() on a context for which zmq_ctx_shutdown() has been called. it will return and set errno to ETERM. so like... the door is closed, babe. 🚪

also important bestie: this function is optional. client code is still required to call the zmq_ctx_term(3) function to free all resources allocated by zeromq. shutting down ≠ cleaning up. don't skip the cleanup, that's not the move. 🧹

🌸 RETURN VALUE 🌸

  • the zmq_ctx_shutdown() function shall return zero if successful 😌
  • otherwise it shall return -1 and set errno to one of the values defined below 💀

🦋 ERRORS 🦋

  • EFAULT — the provided context was invalid. bestie... that's not a real context. 🙈

⭐ 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. they're literally so giving 🫶

okay that's the whole page, no cap. this was 0MQ 4.3.5, dated 10/09/2023 — periodt, go free your resources 💜🌈

📦 where this page comes from