drivers/gpu/drm/nouveau/nvkm/engine/fifo/ucgrp.c

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/nouveau/nvkm/engine/fifo/ucgrp.c

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/nouveau/nvkm/engine/fifo/ucgrp.c
Extension
.c
Size
3393 bytes
Lines
126
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 nvkm_ucgrp {
	struct nvkm_object object;
	struct nvkm_cgrp *cgrp;
};

static int
nvkm_ucgrp_chan_new(const struct nvkm_oclass *oclass, void *argv, u32 argc,
		    struct nvkm_object **pobject)
{
	struct nvkm_cgrp *cgrp = nvkm_ucgrp(oclass->parent)->cgrp;

	return nvkm_uchan_new(cgrp->runl->fifo, cgrp, oclass, argv, argc, pobject);
}

static int
nvkm_ucgrp_sclass(struct nvkm_object *object, int index, struct nvkm_oclass *oclass)
{
	struct nvkm_cgrp *cgrp = nvkm_ucgrp(object)->cgrp;
	struct nvkm_fifo *fifo = cgrp->runl->fifo;
	const struct nvkm_fifo_func_chan *chan = &fifo->func->chan;
	int c = 0;

	/* *_CHANNEL_GPFIFO_* */
	if (chan->user.oclass) {
		if (c++ == index) {
			oclass->base = chan->user;
			oclass->ctor = nvkm_ucgrp_chan_new;
			return 0;
		}
	}

	return -EINVAL;
}

static void *
nvkm_ucgrp_dtor(struct nvkm_object *object)
{
	struct nvkm_ucgrp *ucgrp = nvkm_ucgrp(object);

	nvkm_cgrp_unref(&ucgrp->cgrp);
	return ucgrp;
}

static const struct nvkm_object_func
nvkm_ucgrp = {
	.dtor = nvkm_ucgrp_dtor,
	.sclass = nvkm_ucgrp_sclass,
};

int
nvkm_ucgrp_new(struct nvkm_fifo *fifo, const struct nvkm_oclass *oclass, void *argv, u32 argc,
	       struct nvkm_object **pobject)
{
	union nvif_cgrp_args *args = argv;
	struct nvkm_runl *runl;
	struct nvkm_vmm *vmm;
	struct nvkm_ucgrp *ucgrp;
	int ret;

	if (argc < sizeof(args->v0) || args->v0.version != 0)
		return -ENOSYS;
	argc -= sizeof(args->v0);

	if (args->v0.namelen != argc)
		return -EINVAL;

	/* Lookup objects referenced in args. */
	runl = nvkm_runl_get(fifo, args->v0.runlist, 0);
	if (!runl)
		return -EINVAL;

	vmm = nvkm_uvmm_search(oclass->client, args->v0.vmm);
	if (IS_ERR(vmm))
		return PTR_ERR(vmm);

	/* Allocate channel group. */
	if (!(ucgrp = kzalloc_obj(*ucgrp))) {
		ret = -ENOMEM;
		goto done;
	}

	nvkm_object_ctor(&nvkm_ucgrp, oclass, &ucgrp->object);
	*pobject = &ucgrp->object;

	ret = nvkm_cgrp_new(runl, args->v0.name, vmm, true, &ucgrp->cgrp);
	if (ret)
		goto done;

	/* Return channel group info to caller. */
	args->v0.cgid = ucgrp->cgrp->id;

Annotation

Implementation Notes