drm/imagination/pvr_context.h

30  * struct pvr_context - Context data
33 	/** @ref_count: Refcount for context. */
39 	/** @vm_ctx: Pointer to associated VM context. */
42 	/** @type: Type of context. */
45 	/** @flags: Context flags. */
48 	/** @priority: Context priority*/
51 	/** @fw_obj: FW object representing FW-side context data. */
54 	/** @data: Pointer to local copy of FW context data. */
57 	/** @data_size: Size of FW context data, in bytes. */
60 	/** @ctx_id: FW context ID. */
64 	 * @faulty: Set to 1 when the context queues had unfinished job when
67 	 * In that case, the context is in an inconsistent state and can't be
89 	/** @file_link: pvr_file PVR context list link. */
111  * pvr_context_get() - Take additional reference on context.
112  * @ctx: Context pointer.
117  *  * The requested context on success, or
118  *  * %NULL if no context pointer passed.
131  * referenced context.
132  * @ctx: Context pointer.
138  *  * false if no context pointer passed, or the context wasn't still
148  * pvr_context_lookup() - Lookup context pointer from handle and file.
150  * @handle: Context handle.
152  * Takes reference on context. Call pvr_context_put() to release.
155  *  * The requested context on success, or
156  *  * %NULL on failure (context does not exist, or does not belong to @pvr_file).
163 	/* Take the array lock to protect against context removal.  */  in pvr_context_lookup()
172  * pvr_context_lookup_id() - Lookup context pointer from ID.
174  * @id: FW context ID.
176  * Takes reference on context. Call pvr_context_put() to release.
179  *  * The requested context on success, or
180  *  * %NULL on failure (context does not exist).
187 	/* Take the array lock to protect against context removal.  */  in pvr_context_lookup_id()
190 	/* Contexts are removed from the ctx_ids set in the context release path,  in pvr_context_lookup_id()
192 	 * to make sure we're not trying to acquire a context that's being  in pvr_context_lookup_id()