drivers/hwtracing/intel_th/msu-sink.c

Source file repositories/reference/linux-study-clean/drivers/hwtracing/intel_th/msu-sink.c

File Facts

System
Linux kernel
Corpus path
drivers/hwtracing/intel_th/msu-sink.c
Extension
.c
Size
2500 bytes
Lines
121
Domain
Driver Families
Bucket
drivers/hwtracing
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 msu_sink_private {
	struct device	*dev;
	struct sg_table **sgts;
	unsigned int	nr_sgts;
};

static void *msu_sink_assign(struct device *dev, int *mode)
{
	struct msu_sink_private *priv;

	priv = kzalloc_obj(*priv);
	if (!priv)
		return NULL;

	priv->sgts = kcalloc(MAX_SGTS, sizeof(void *), GFP_KERNEL);
	if (!priv->sgts) {
		kfree(priv);
		return NULL;
	}

	priv->dev = dev;
	*mode = MSC_MODE_MULTI;

	return priv;
}

static void msu_sink_unassign(void *data)
{
	struct msu_sink_private *priv = data;

	kfree(priv->sgts);
	kfree(priv);
}

/* See also: msc.c: __msc_buffer_win_alloc() */
static int msu_sink_alloc_window(void *data, struct sg_table **sgt, size_t size)
{
	struct msu_sink_private *priv = data;
	unsigned int nents;
	struct scatterlist *sg_ptr;
	void *block;
	int ret, i;

	if (priv->nr_sgts == MAX_SGTS)
		return -ENOMEM;

	nents = DIV_ROUND_UP(size, PAGE_SIZE);

	ret = sg_alloc_table(*sgt, nents, GFP_KERNEL);
	if (ret)
		return -ENOMEM;

	priv->sgts[priv->nr_sgts++] = *sgt;

	for_each_sg((*sgt)->sgl, sg_ptr, nents, i) {
		block = dma_alloc_coherent(priv->dev->parent->parent,
					   PAGE_SIZE, &sg_dma_address(sg_ptr),
					   GFP_KERNEL);
		if (!block)
			return -ENOMEM;

		sg_set_buf(sg_ptr, block, PAGE_SIZE);
	}

	return nents;
}

/* See also: msc.c: __msc_buffer_win_free() */
static void msu_sink_free_window(void *data, struct sg_table *sgt)
{
	struct msu_sink_private *priv = data;
	struct scatterlist *sg_ptr;
	int i;

	for_each_sg(sgt->sgl, sg_ptr, sgt->nents, i) {
		dma_free_coherent(priv->dev->parent->parent, PAGE_SIZE,
				  sg_virt(sg_ptr), sg_dma_address(sg_ptr));
	}

	sg_free_table(sgt);
	priv->nr_sgts--;
}

static int msu_sink_ready(void *data, struct sg_table *sgt, size_t bytes)
{
	struct msu_sink_private *priv = data;

	intel_th_msc_window_unlock(priv->dev, sgt);

	return 0;

Annotation

Implementation Notes