ZMQ\_MSG\_INIT\_BUFFER(3) 0MQ Manual ZMQ\_MSG\_INIT\_BUFFER(3)

# [NAME](#NAME)

zmq\_msg\_init\_buffer - initialise 0MQ message with buffer copy

# [SYNOPSIS](#SYNOPSIS)

**int zmq\_msg\_init\_buffer (zmq\_msg\_t \*msg, const void \*buf, size\_t size);**

# [DESCRIPTION](#DESCRIPTION)

The *zmq\_msg\_init\_buffer()* function shall allocate any resources required to store a message *size* bytes long and initialise the message object referenced by *msg* to represent a copy of the buffer referenced by the *buf* and *size* arguments.

The implementation shall choose whether to store message content on the stack (small messages) or on the heap (large messages).

**Caution**

Never access *zmq\_msg\_t* members directly, instead always use the *zmq\_msg* family of functions.

**Caution**

The functions *zmq\_msg\_init()*, *zmq\_msg\_init\_data()*, *zmq\_msg\_init\_buffer()* and *zmq\_msg\_init\_buffer()* are mutually exclusive. Never initialise the same *zmq\_msg\_t* twice.

# [RETURN VALUE](#RETURN_VALUE)

The *zmq\_msg\_init\_buffer()* function shall return zero if successful. Otherwise it shall return -1 and set *errno* to one of the values defined below.

# [ERRORS](#ERRORS)

**ENOMEM**

Insufficient storage space is available.

# [SEE ALSO](#SEE_ALSO)

[**zmq\_msg\_init\_data**(3)](/man/os/zeromq/zmq_msg_init_data.3) [**zmq\_msg\_init\_size**(3)](/man/os/zeromq/zmq_msg_init_size.3) [**zmq\_msg\_init**(3)](/man/os/zeromq/zmq_msg_init.3) [**zmq\_msg\_close**(3)](/man/os/zeromq/zmq_msg_close.3) [**zmq\_msg\_data**(3)](/man/os/zeromq/zmq_msg_data.3) [**zmq\_msg\_size**(3)](/man/os/zeromq/zmq_msg_size.3) [**zmq**(7)](/man/os/zeromq/zmq.7)

# [AUTHORS](#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**.

10/26/2026 0MQ 4.3.5

---

Document: zmq_msg_init_buffer(3) from zeromq 4.3.5-r15 (Chainguard OS)
Source: https://github.com/zeromq/libzmq