From 495840658e437117bbae298e6e72e057b333e426 Mon Sep 17 00:00:00 2001 From: Brian Paul Date: Mon, 24 Apr 2017 12:57:14 -0600 Subject: [PATCH] gallium/util: add some comments in u_debug_flush.c Trivial. Reviewed-by: Charmaine Lee --- src/gallium/auxiliary/util/u_debug_flush.c | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/src/gallium/auxiliary/util/u_debug_flush.c b/src/gallium/auxiliary/util/u_debug_flush.c index 06d0cfa..fe96e09 100644 --- a/src/gallium/auxiliary/util/u_debug_flush.c +++ b/src/gallium/auxiliary/util/u_debug_flush.c @@ -266,6 +266,12 @@ debug_flush_unmap(struct debug_flush_buf *fbuf) mtx_unlock(&fbuf->mutex); } + +/** + * Add the given buffer to the list of active buffers. Active buffers + * are those which are referenced by the command buffer currently being + * constructed. + */ void debug_flush_cb_reference(struct debug_flush_ctx *fctx, struct debug_flush_buf *fbuf) @@ -333,6 +339,10 @@ debug_flush_might_flush_cb(void *key, void *value, void *data) return PIPE_OK; } +/** + * Called when we're about to possibly flush a command buffer. + * We check if any active buffers are in a mapped state. If so, print an alert. + */ void debug_flush_might_flush(struct debug_flush_ctx *fctx) { @@ -356,6 +366,11 @@ debug_flush_flush_cb(void *key, void *value, void *data) } +/** + * Called when we flush a command buffer. Two things are done: + * 1. Check if any of the active buffers are currently mapped (alert if so). + * 2. Discard/unreference all the active buffers. + */ void debug_flush_flush(struct debug_flush_ctx *fctx) { -- 2.7.4