Commit 71b1c990 authored by Anna Karas's avatar Anna Karas Committed by Chris Wilson

drm/i915/perf: Describe structure members in documentation

Add missing descriptions of i915_perf_stream structure members
to documentation.

Cc: Umesh Nerlige Ramappa <umesh.nerlige.ramappa@intel.com>
Cc: Lionel Landwerlin <lionel.g.landwerlin@intel.com>
Cc: Robert Bragg <robert@sixbynine.org>
Signed-off-by: default avatarAnna Karas <anna.karas@intel.com>
Reviewed-by: default avatarLionel Landwerlin <lionel.g.landwerlin@intel.com>
Signed-off-by: default avatarChris Wilson <chris@chris-wilson.co.uk>
Link: https://patchwork.freedesktop.org/patch/msgid/20191022101338.17048-1-anna.karas@intel.com
parent 2871ea85
...@@ -199,14 +199,43 @@ struct i915_perf_stream { ...@@ -199,14 +199,43 @@ struct i915_perf_stream {
* @pinned_ctx: The OA context specific information. * @pinned_ctx: The OA context specific information.
*/ */
struct intel_context *pinned_ctx; struct intel_context *pinned_ctx;
/**
* @specific_ctx_id: The id of the specific context.
*/
u32 specific_ctx_id; u32 specific_ctx_id;
/**
* @specific_ctx_id_mask: The mask used to masking specific_ctx_id bits.
*/
u32 specific_ctx_id_mask; u32 specific_ctx_id_mask;
/**
* @poll_check_timer: High resolution timer that will periodically
* check for data in the circular OA buffer for notifying userspace
* (e.g. during a read() or poll()).
*/
struct hrtimer poll_check_timer; struct hrtimer poll_check_timer;
/**
* @poll_wq: The wait queue that hrtimer callback wakes when it
* sees data ready to read in the circular OA buffer.
*/
wait_queue_head_t poll_wq; wait_queue_head_t poll_wq;
/**
* @pollin: Whether there is data available to read.
*/
bool pollin; bool pollin;
/**
* @periodic: Whether periodic sampling is currently enabled.
*/
bool periodic; bool periodic;
/**
* @period_exponent: The OA unit sampling frequency is derived from this.
*/
int period_exponent; int period_exponent;
/** /**
...@@ -276,7 +305,7 @@ struct i915_perf_stream { ...@@ -276,7 +305,7 @@ struct i915_perf_stream {
} oa_buffer; } oa_buffer;
/** /**
* A batch buffer doing a wait on the GPU for the NOA logic to be * @noa_wait: A batch buffer doing a wait on the GPU for the NOA logic to be
* reprogrammed. * reprogrammed.
*/ */
struct i915_vma *noa_wait; struct i915_vma *noa_wait;
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment