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 one 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
Referenced By
nanomsg(7), nn_allocmsg(3), nn_reallocmsg(3), nn_recv(3), nn_recvmsg(3), nn_sendmsg(3).
2024-09-04 nanomsg 1.2.1