vrb_give(3)

vrb_give3

Create a new virtual ring buffer

Usage

#include <vrb.h>

vrb_p vrb_give(vrb_p vrb, size_t size);

Library

-lvrb

Overview

vrb_give specifies how much data has been placed into the empty portion of the virtual ring buffer by the caller.

The caller will have called vrb_empty_len(3) and vrb_empty_ptr(3) to get the length of empty space in the buffer and a pointer to it, and having placed some data into that space, starting from the pointer obtained and placing no more that the length obtained.

Arguments

vrb_p vrb
specifies which virtual ring buffer.

size_t size
specifies the length of data that has been placed into the virtual ring buffer empty space by the caller.

Return value

int
On success, 0 is returned. On error, -1 is returned.

Errors

If an error is returned, then errno will have one of the following values:

EINVAL

An invalid virtual ring buffer pointer was specified.

ENOSPC

The specified length is greater than the empty space in the virtual ring buffer.

Releases

Unchanged in 2 releases since Debian 6.0 (Squeeze).

  1. 6.0–7

From libvrb0-dev 0.5.1-5.1 in Debian 7 (Wheezy). Parsed by carta from the page's man source.