From 3079d4aa9bbbca02c36dcb7ff6a3f6d24bd21189 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Fri, 9 Nov 2018 19:59:29 -0800 Subject: man page updates for 1.1.0 --- man/v1.1.0/nn_allocmsg.3compat.html | 636 ++++++++++++++++++++++++++++++++++++ 1 file changed, 636 insertions(+) create mode 100644 man/v1.1.0/nn_allocmsg.3compat.html (limited to 'man/v1.1.0/nn_allocmsg.3compat.html') diff --git a/man/v1.1.0/nn_allocmsg.3compat.html b/man/v1.1.0/nn_allocmsg.3compat.html new file mode 100644 index 00000000..f40b91a7 --- /dev/null +++ b/man/v1.1.0/nn_allocmsg.3compat.html @@ -0,0 +1,636 @@ +--- +version: 1.1.0 +layout: refman +--- + + + + + + + +nn_allocmsg(3compat) + + + + + + + +
+
+

SYNOPSIS

+
+
+
+
#include <nanomsg/nn.h>
+
+void *nn_allocmsg(size_t size, int type);
+
+
+
+
+
+

DESCRIPTION

+
+
+

The nn_allocmsg() allocates a message structure of size size, and is +primarily used to support zero-copy send operations, making use of the +NNG_MSG special size indicator. +The value returned is a pointer to the start of the message payload buffer.

+
+
+

The value of size must be positive, and small enough to hold reasonable +message data plus book-keeping information.

+
+
+ + + + + +
+ + +This function is provided for API +compatibility with legacy libnanomsg. +Consider using the relevant modern API instead. +
+
+
+

The value of type must be zero. +(This argument was reserved to support different kinds of memory spaces +for RDMA devices, but this was never developed in the legacy API.)

+
+
+

The returned message must be disposed of by either +nn_freemsg() or +nn_send() when the caller is finished with it.

+
+
+
+
+

RETURN VALUES

+
+
+

This function returns a pointer to message buffer space, or NULL +on failure.

+
+
+
+
+

ERRORS

+
+
+ + + + + + + + + + + + + +
+ENOMEM + +

Insufficient memory is available.

+
+EINVAL + +

An invalid size or type was specified.

+
+ETERM + +

The library is shutting down.

+
+
+
+
+
+

SEE ALSO

+
+
+

nn_errno(3compat), +nn_freemsg(3compat), +nn_reallocmsg(3compat), +nn_send(3compat), +nng_compat(3compat), +nng(7)

+
+
+
+
+ + -- cgit v1.2.3-70-g09d2