.\"  Automatically generated man page, do not edit
.TH QB_RB_CHUNK_PEEK 3 2020-10-31 "LIBQB" "libqb Programmer's Manual"
.SH NAME
qb_rb_chunk_peek \- Read (without reclaiming) the last chunk. 

.SH SYNOPSIS
.nf
.B #include <qb/qbrb.h>
.sp
\fBssize_t qb_rb_chunk_peek\fP(
    \fBqb_ringbuffer_t   *\fP\fIrb\fP,
    \fBvoid             **\fP\fIdata_out\fP,
    \fBint32_t            \fP\fIms_timeout\fP
);
.fi
.SH PARAMS
\fBrb         \fP\fIringbuffer instance \fP
.PP
\fBdata_out   \fP\fI(out) a pointer to the next chunk to read (not copied). \fP
.PP
\fBms_timeout \fP\fI(in) time to wait for new data.\fP
.PP
.SH DESCRIPTION
.PP
This function is a way of accessing the next chunk without a memcpy(). You can read the chunk data in place.
.RE
.SH RETURN VALUE
.PP
the size of the chunk (0 if buffer empty). 
.PP
.SH NOTE
.PP
This function will not "pop" the chunk, you will need to call \fIqb_rb_chunk_reclaim()\fR. 
.SH SEE ALSO
.PP
.nh
.ad l
\fIqb_rb_close\fR(3), \fIqb_rb_refcount_get\fR(3), \fIqb_rb_chmod\fR(3), \fIqb_rb_chown\fR(3), \fIqb_rb_open\fR(3), \fIqb_rb_write_to_file\fR(3), \fIqb_rb_create_from_file\fR(3), \fIqb_rb_chunks_used\fR(3), \fIqb_rb_chunk_reclaim\fR(3), \fIqb_rb_space_used\fR(3), \fIqb_rb_chunk_write\fR(3), \fIqb_rb_shared_user_data_get\fR(3), \fIqb_rb_chunk_commit\fR(3), \fIqb_rb_space_free\fR(3), \fIqb_rb_name_get\fR(3), \fIqb_rb_chunk_alloc\fR(3), \fIqb_rb_chunk_read\fR(3)
.ad
.hy
.SH "COPYRIGHT"
.PP
Copyright (C) 2010-2020 Red Hat, Inc. All rights reserved.