nng_aio_set_iov()

NAME

nng_aio_set_iov — set scatter/gather vector

SYNOPSIS

#include <nng/nng.h>

int nng_aio_set_iov(nng_aio *aio, unsigned int niov, nng_iov *iov);

DESCRIPTION

The nng_aio_set_iov() function sets a scatter/gather vector iov on the handle aio.

The iov is a pointer to an array of niov nng_iov structures, which have the following definition:

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

The iov is copied into storage in the aio itself, so that callers may use stack allocated nng_iov structures. The values pointed to by the iov_buf members are not copied by this function though.

A maximum of four (4) nng_iov members may be supplied.

RETURN VALUES

This function returns 0 on success, and non-zero otherwise.

ERRORS

  • NNG_EINVAL: Value of specified niov is too large.

SEE ALSO

nng_aio, nng_iov