This is an automated email from the ASF dual-hosted git repository. xiaoxiang781216 pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit b96c08c97cccd8105fdaac958a23a34aa11c3bfc Author: Bowen Wang <[email protected]> AuthorDate: Tue Apr 21 21:29:02 2026 +0800 include/ring: add zero-copy enqueue/dequeue start/finish API Add ring_buf_s descriptor and two-phase zero-copy operations: - enqueue: start (get writable pointers) + copy + finish (publish) - dequeue: start (get readable pointers) + copy + finish (release) Unify enqueue/dequeue to use ring_buf_s internally via shared ring_buf_fill, ring_copy_from, ring_copy_to helpers, eliminating the old ring_copy_from/ring_copy_to that duplicated wrap-around logic. Signed-off-by: Bowen Wang <[email protected]> --- include/nuttx/ring.h | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/include/nuttx/ring.h b/include/nuttx/ring.h index d9dfbf36b63..632eb475c0f 100644 --- a/include/nuttx/ring.h +++ b/include/nuttx/ring.h @@ -193,6 +193,54 @@ #define ring_mpsc_dequeue_skip(r, count) \ ring_sc_dequeue_skip(RING_BASE(r), count) +#define ring_spsc_enqueue_start(r, count, elem_size, b) \ + ring_sp_start(RING_BASE(r), count, elem_size, b) + +#define ring_spsc_enqueue_finish(r, b) \ + ring_sp_finish(RING_BASE(r), b) + +#define ring_spsc_dequeue_start(r, count, elem_size, b) \ + ring_sc_start(RING_BASE(r), count, elem_size, b) + +#define ring_spsc_dequeue_finish(r, b) \ + ring_sc_finish(RING_BASE(r), b) + +#define ring_mpmc_enqueue_start(r, count, elem_size, b) \ + ring_mp_start(RING_BASE(r), count, elem_size, b) + +#define ring_mpmc_enqueue_finish(r, b) \ + ring_mp_finish(RING_BASE(r), b) + +#define ring_mpmc_dequeue_start(r, count, elem_size, b) \ + ring_mc_start(RING_BASE(r), count, elem_size, b) + +#define ring_mpmc_dequeue_finish(r, b) \ + ring_mc_finish(RING_BASE(r), b) + +#define ring_spmc_enqueue_start(r, count, elem_size, b) \ + ring_sp_start(RING_BASE(r), count, elem_size, b) + +#define ring_spmc_enqueue_finish(r, b) \ + ring_sp_finish(RING_BASE(r), b) + +#define ring_spmc_dequeue_start(r, count, elem_size, b) \ + ring_mc_start(RING_BASE(r), count, elem_size, b) + +#define ring_spmc_dequeue_finish(r, b) \ + ring_mc_finish(RING_BASE(r), b) + +#define ring_mpsc_enqueue_start(r, count, elem_size, b) \ + ring_mp_start(RING_BASE(r), count, elem_size, b) + +#define ring_mpsc_enqueue_finish(r, b) \ + ring_mp_finish(RING_BASE(r), b) + +#define ring_mpsc_dequeue_start(r, count, elem_size, b) \ + ring_sc_start(RING_BASE(r), count, elem_size, b) + +#define ring_mpsc_dequeue_finish(r, b) \ + ring_sc_finish(RING_BASE(r), b) + /**************************************************************************** * Public Types ****************************************************************************/
