From: Oscar Mateo Date: Thu, 3 Jul 2014 15:28:01 +0000 (+0100) Subject: drm/i915: Add kerneldoc comments to the intel_context struct X-Git-Tag: v4.14-rc1~7068^2~49^2~46 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=31b7a88d354e5d7f7d2e68818e4bd8f115ab1ba6;p=platform%2Fkernel%2Flinux-rpi.git drm/i915: Add kerneldoc comments to the intel_context struct A bit of background on the context elements. Cc: Jesse Barnes Signed-off-by: Oscar Mateo Reviewed-by: Chris Wilson [danvet: Appease checkpatch.] Signed-off-by: Daniel Vetter --- diff --git a/drivers/gpu/drm/i915/i915_drv.h b/drivers/gpu/drm/i915/i915_drv.h index dcef38b..8fa8172 100644 --- a/drivers/gpu/drm/i915/i915_drv.h +++ b/drivers/gpu/drm/i915/i915_drv.h @@ -586,6 +586,23 @@ struct i915_ctx_hang_stats { /* This must match up with the value previously used for execbuf2.rsvd1. */ #define DEFAULT_CONTEXT_HANDLE 0 +/** + * struct intel_context - as the name implies, represents a context. + * @ref: reference count. + * @user_handle: userspace tracking identity for this context. + * @remap_slice: l3 row remapping information. + * @file_priv: filp associated with this context (NULL for global default + * context). + * @hang_stats: information about the role of this context in possible GPU + * hangs. + * @vm: virtual memory space used by this context. + * @legacy_hw_ctx: render context backing object and whether it is correctly + * initialized (legacy ring submission mechanism only). + * @link: link in the global list of contexts. + * + * Contexts are memory images used by the hardware to store copies of their + * internal state. + */ struct intel_context { struct kref ref; int user_handle;