drivers/net/ethernet/fungible/funcore/fun_queue.h

Source file repositories/reference/linux-study-clean/drivers/net/ethernet/fungible/funcore/fun_queue.h

File Facts

System
Linux kernel
Corpus path
drivers/net/ethernet/fungible/funcore/fun_queue.h
Extension
.h
Size
3991 bytes
Lines
175
Domain
Driver Families
Bucket
drivers/net
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 fun_rq_info {
	dma_addr_t dma;
	struct page *page;
};

/* A queue group consisting of an SQ, a CQ, and an optional RQ. */
struct fun_queue {
	struct fun_dev *fdev;
	spinlock_t sq_lock;

	dma_addr_t cq_dma_addr;
	dma_addr_t sq_dma_addr;
	dma_addr_t rq_dma_addr;

	u32 __iomem *cq_db;
	u32 __iomem *sq_db;
	u32 __iomem *rq_db;

	void *cqes;
	void *sq_cmds;
	struct fun_eprq_rqbuf *rqes;
	struct fun_rq_info *rq_info;

	u32 cqid;
	u32 sqid;
	u32 rqid;

	u32 cq_depth;
	u32 sq_depth;
	u32 rq_depth;

	u16 cq_head;
	u16 sq_tail;
	u16 rq_tail;

	u8 cqe_size_log2;
	u8 sqe_size_log2;

	u16 cqe_info_offset;

	u16 rq_buf_idx;
	int rq_buf_offset;
	u16 num_rqe_to_fill;

	u8 cq_intcoal_usec;
	u8 cq_intcoal_nentries;
	u8 sq_intcoal_usec;
	u8 sq_intcoal_nentries;

	u16 cq_flags;
	u16 sq_flags;
	u16 rq_flags;

	/* SQ head writeback */
	u16 sq_comp;

	volatile __be64 *sq_head;

	cq_callback_t cq_cb;
	void *cb_data;

	irq_handler_t irq_handler;
	void *irq_data;
	s16 cq_vector;
	u8 cq_phase;

	/* I/O q index */
	u16 qid;

	char irqname[24];
};

static inline void *fun_sqe_at(const struct fun_queue *funq, unsigned int pos)
{
	return funq->sq_cmds + (pos << funq->sqe_size_log2);
}

static inline void funq_sq_post_tail(struct fun_queue *funq, u16 tail)
{
	if (++tail == funq->sq_depth)
		tail = 0;
	funq->sq_tail = tail;
	writel(tail, funq->sq_db);
}

static inline struct fun_cqe_info *funq_cqe_info(const struct fun_queue *funq,
						 void *cqe)
{
	return cqe + funq->cqe_info_offset;
}

Annotation

Implementation Notes