intel_ctx_cfg_for_engine ()

intel_ctx_cfg_t
intel_ctx_cfg_for_engine (unsigned int class,
                          unsigned int inst);

Returns an intel_ctx_cfg_t containing exactly one engine.

intel_ctx_cfg_all_physical ()

intel_ctx_cfg_t
intel_ctx_cfg_all_physical (int fd);

Returns an intel_ctx_cfg_t containing all physical engines. On kernels without the engines API, a default context configuration will be returned.

intel_ctx_cfg_for_gt ()

intel_ctx_cfg_t
intel_ctx_cfg_for_gt (int fd,
                      int gt);

Returns an intel_ctx_cfg_t containing all physical engines belonging to gt

intel_ctx_cfg_engine_class ()

int
intel_ctx_cfg_engine_class (const intel_ctx_cfg_t *cfg,
                            unsigned int engine);

Returns the class for the given engine.

intel_ctx_create ()

const intel_ctx_t *
intel_ctx_create (int i915,
                  const intel_ctx_cfg_t *cfg);

Creates a new intel_ctx_t with the given config. If cfg is NULL, a default context is created.

intel_ctx_0 ()

const intel_ctx_t *
intel_ctx_0 (int fd);

Returns an intel_ctx_t representing the default context.

intel_ctx_create_for_engine ()

const intel_ctx_t *
intel_ctx_create_for_engine (int fd,
                             unsigned int class,
                             unsigned int inst);

Returns an intel_ctx_t containing the specified engine.

intel_ctx_create_all_physical ()

const intel_ctx_t *
intel_ctx_create_all_physical (int fd);

Creates an intel_ctx_t containing all physical engines. On kernels without the engines API, the created context will be the same as intel_ctx_0() except that it will be a new GEM context. On kernels or hardware which do not support contexts, it is the same as intel_ctx_0().

intel_ctx_create_for_gt ()

const intel_ctx_t *
intel_ctx_create_for_gt (int fd,
                         int gt);

Creates an intel_ctx_t containing all physical engines belonging to gt

intel_ctx_destroy ()

void
intel_ctx_destroy (int fd,
                   const intel_ctx_t *ctx);

Destroys an intel_ctx_t.

intel_ctx_engine_class ()

unsigned int
intel_ctx_engine_class (const intel_ctx_t *ctx,
                        unsigned int engine);

Returns the class for the given engine.

intel_ctx_xe ()

intel_ctx_t *
intel_ctx_xe (int fd,
              uint32_t vm,
              uint32_t exec_queue,
              uint32_t sync_in,
              uint32_t sync_bind,
              uint32_t sync_out);

Returns an intel_ctx_t representing the xe context.

intel_ctx_xe_exec ()

void
intel_ctx_xe_exec (const intel_ctx_t *ctx,
                   uint64_t ahnd,
                   uint64_t bb_offset);

intel_ctx_xe_sync ()

int
intel_ctx_xe_sync (intel_ctx_t *ctx,
                   bool reset_syncs);

GEM_MAX_ENGINES

#define GEM_MAX_ENGINES		I915_EXEC_RING_MASK + 1

intel_ctx_cfg_t

typedef struct {
	uint32_t flags;
	uint32_t vm;
	bool nopersist;
	bool load_balance;
	bool parallel;
	unsigned int num_engines;
	unsigned int width;
	struct i915_engine_class_instance engines[GEM_MAX_ENGINES];
} intel_ctx_cfg_t;

Represents the full configuration of an intel_ctx.

num_engines not only specifies the number of engines in the context but also how engine information should be communicated to execbuf. With the engines API, every context has two modes:

intel_ctx_t

typedef struct {
	uint32_t id;
	intel_ctx_cfg_t cfg;

	/* Xe */
	int fd;
	uint32_t vm;
	uint32_t exec_queue;
	uint32_t sync_in;
	uint32_t sync_bind;
	uint32_t sync_out;
} intel_ctx_t;

Represents the full configuration of an intel_ctx.