nn_freemsg - Man Page

deallocate a message

Synopsis

#include <nanomsg/nn.h>

int nn_freemsg (void *msg);

Description

Deallocates a message allocated using nn_allocmsg(3) function or received via nn_recv(3) or nn_recvmsg(3) function. While nn_recv(3) and nn_recvmsg(3) allow to receive data into arbitrary buffers, using library-allocated buffers can be more efficient for large messages as it allows for using zero-copy techniques.

Return Value

If the function succeeds zero is returned. Otherwise, -1 is returned and errno is set to to one of the values defined below.

Errors

EFAULT

The message pointer is invalid.

Example

void *buf;
nn_recv (s, &buf, NN_MSG, 0);
nn_freemsg (buf);

See Also

nn_allocmsg(3) nn_reallocmsg(3) nn_recv(3) nn_recvmsg(3) nanomsg(7)

Authors

Martin Sustrik

Referenced By

nanomsg(7), nn_allocmsg(3), nn_reallocmsg(3), nn_recv(3), nn_recvmsg(3), nn_sendmsg(3).

2024-01-25 nanomsg 1.1.5