drivers/gpu/drm/i915/i915_gem_ww.h

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/i915/i915_gem_ww.h

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/i915/i915_gem_ww.h
Extension
.h
Size
1047 bytes
Lines
42
Domain
Driver Families
Bucket
drivers/gpu
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

struct i915_gem_ww_ctx {
	struct ww_acquire_ctx ctx;
	struct list_head obj_list;
	struct drm_i915_gem_object *contended;
	bool intr;
};

void i915_gem_ww_ctx_init(struct i915_gem_ww_ctx *ctx, bool intr);
void i915_gem_ww_ctx_fini(struct i915_gem_ww_ctx *ctx);
int __must_check i915_gem_ww_ctx_backoff(struct i915_gem_ww_ctx *ctx);
void i915_gem_ww_unlock_single(struct drm_i915_gem_object *obj);

/* Internal function used by the inlines! Don't use. */
static inline int __i915_gem_ww_fini(struct i915_gem_ww_ctx *ww, int err)
{
	if (err == -EDEADLK) {
		err = i915_gem_ww_ctx_backoff(ww);
		if (!err)
			err = -EDEADLK;
	}

	if (err != -EDEADLK)
		i915_gem_ww_ctx_fini(ww);

	return err;
}

#define for_i915_gem_ww(_ww, _err, _intr)			  \
	for (i915_gem_ww_ctx_init(_ww, _intr), (_err) = -EDEADLK; \
	     (_err) == -EDEADLK;				  \
	     (_err) = __i915_gem_ww_fini(_ww, _err))
#endif

Annotation

Implementation Notes