drivers/net/ethernet/alibaba/eea/eea_pci.h

File Facts

System

Linux kernel

Corpus path

drivers/net/ethernet/alibaba/eea/eea_pci.h

Extension

.h

Size

1505 bytes

Lines

74

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.

• 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.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/pci.h
• eea_net.h
• eea_ring.h

Detected Declarations

• struct eea_irq_blk
• struct eea_pci_cap
• struct eea_pci_reset_reg
• struct eea_pci_device
• struct eea_device
• enum eea_pci_status

Annotated Snippet

struct eea_pci_cap {
	__u8 cap_vndr;
	__u8 cap_next;
	__u8 cap_len;
	__u8 cfg_type;
};

struct eea_pci_reset_reg {
	struct eea_pci_cap cap;
	__le16 driver;
	__le16 device;
};

struct eea_pci_device;

struct eea_device {
	struct eea_pci_device *ep_dev;
	struct device         *dma_dev;
	struct eea_net        *enet;

	u64 features;

	enum eea_pci_status status;
	bool ha_reset_netdev_running;

	/* ha lock for the race between ha work and pci remove */
	struct mutex ha_lock;

	u32 rx_num;
	u32 tx_num;
	u32 db_blk_size;
};

const char *eea_pci_name(struct eea_device *edev);
int eea_pci_domain_nr(struct eea_device *edev);
u16 eea_pci_bdf(struct eea_device *edev);

int eea_device_reset(struct eea_device *dev);
int eea_pci_set_aq_up(struct eea_device *dev);
int eea_pci_active_aq(struct eea_ring *ering, int msix_vec);

int eea_pci_request_irq(struct eea_device *edev, struct eea_irq_blk *blk,
			irqreturn_t (*callback)(int irq, void *data));
void eea_pci_free_irq(struct eea_irq_blk *blk);

u64 eea_pci_device_ts(struct eea_device *edev);

void __iomem *eea_pci_db_addr(struct eea_device *edev, u32 off);
#endif

Annotation

• Immediate include surface: `linux/pci.h`, `eea_net.h`, `eea_ring.h`.
• Detected declarations: `struct eea_irq_blk`, `struct eea_pci_cap`, `struct eea_pci_reset_reg`, `struct eea_pci_device`, `struct eea_device`, `enum eea_pci_status`.
• Atlas domain: Driver Families / drivers/net.
• Implementation status: source implementation candidate.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.