From: Kevin Rogovin <kevin.rogovin@xxxxxxxxx> Note: I want to make a one or two follow-up series that provide narration and potentially additional documentation for GUC submission and the breadcrumbs. v3: More documentation: emphasize that handling of batchbuffer requests creates a request struct that is added to the dependency tree and that the inform to the hardware that there is new data on a ringbuffer is deferred until dependencies are satsified. Break patch into more digestable chunks. v2: More documentation: intel_ringbuffer, sequence number. Expose to i915.rst existing documentation Call out GEM_EXECBUFFER as deprecated. Place code detailed documentation in source files. Call out INTEL_EXEC_RENDER. Reorder text to make it more readable. Refer to Command Buffer Parser instead of Batchbuffer Parser. (suggested by Joonas Lahtinen) Kevin Rogovin (6): i915.rst: Narration overview on GEM + minor reorder to improve narration i915.rst: rename section Batchbuffer Parsing to Command Buffer Parsing i915: add documentation of what happens at the bottom of submitting a batchbuffer i915: add documentation for a bit on batchbuffer submission backend i915: add doc for synchronization i915.rst: narration for batchbuffer submission + links to source code doc entries on the subject Documentation/gpu/i915.rst | 189 ++++++++++++++++++++++++++------ drivers/gpu/drm/i915/i915_request.h | 28 +++++ drivers/gpu/drm/i915/i915_vma.h | 10 +- drivers/gpu/drm/i915/intel_ringbuffer.h | 71 ++++++++++++ 4 files changed, 262 insertions(+), 36 deletions(-) -- 2.16.2 _______________________________________________ Intel-gfx mailing list Intel-gfx@xxxxxxxxxxxxxxxxxxxxx https://lists.freedesktop.org/mailman/listinfo/intel-gfx