tree 81fb412dfcfe62faa3d1cef4c4d76d63108d1ec1
parent e39b58f0450bcbc7df60167d758e2dd31c11025a
author Willy Tarreau <w@1wt.eu> 1558702506 +0200
committer Willy Tarreau <w@1wt.eu> 1558855619 +0200
encoding latin1

MINOR: buffer: add a new buffer ring API to manipulate rings of buffers

The purpose is to manipulate rings made of series of buffers so that
it is possible to continue to work on a next buffer once one is full.
This will be used by muxes to deal with contention between multiple
streams and a single output buffer. No data is expected to span over
multiple buffers, all of them will be used like a regular buffer. This
will significantly limit the amount of changes and the code complexity
while still supporting larger output buffering.

The ring is made of a head and a tail indexes both of which point to a
buffer descriptor. At least one descriptor is always valid, so it could
be seen as a form of pagination always presenting one buffer. The root
of the ring is itself stored into a buffer descriptor so that the user
only has to declare a buffer array and to call br_init() on it in order
to use it.