This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.7.3. See the documentation for v1.7.3 for the most up-to-date information.

nng_iov(5)

NAME

nng_iov - scatter/gather element

SYNOPSIS

#include <nng/nng.h>

typedef struct {
    void * iov_buf;
    size_t iov_len;
} nng_iov;

DESCRIPTION

An nng_iov structure represents a single element in a scatter/gather array. Some operations can use arrays of these to access different regions of memory in a single operation. For example, it may be useful to send a message with header data from one part of memory, and a user payload from another.

The operations that do this typically store an array of these in an nng_aio structure using the nng_aio_set_iov() function.

The following structure members are present:

iov_buf

This is a pointer to the first byte within the memory being referenced by this scatter/gather element.

iov_len

This is the size in bytes of this scatter/gather element.

SEE ALSO