drivers/infiniband/hw/hfi1/ipoib.h

File Facts

System

Linux kernel

Corpus path

drivers/infiniband/hw/hfi1/ipoib.h

Extension

.h

Size

4399 bytes

Lines

172

Domain

Driver Families

Bucket

drivers/infiniband

Inferred role

Driver Families: operation-table or driver-model contract

Status

pattern 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.
• Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/types.h
• linux/stddef.h
• linux/atomic.h
• linux/netdevice.h
• linux/slab.h
• linux/skbuff.h
• linux/list.h
• linux/if_infiniband.h
• hfi.h
• iowait.h
• netdev.h
• rdma/ib_verbs.h

Detected Declarations

• struct hfi1_ipoib_dev_priv
• struct ipoib_txreq
• struct hfi1_ipoib_circ_buf
• struct hfi1_ipoib_txq
• struct hfi1_ipoib_dev_priv
• struct hfi1_ipoib_rdma_netdev
• function hfi1_ipoib_priv

Annotated Snippet

const struct net_device_ops *netdev_ops;
	struct rvt_qp *qp;
	u32 qkey;
	u16 pkey;
	u16 pkey_index;
	u8 port_num;
};

/* hfi1 ipoib rdma netdev's private data structure */
struct hfi1_ipoib_rdma_netdev {
	struct rdma_netdev rn;  /* keep this first */
	/* followed by device private data */
	struct hfi1_ipoib_dev_priv dev_priv;
};

static inline struct hfi1_ipoib_dev_priv *
hfi1_ipoib_priv(const struct net_device *dev)
{
	return &((struct hfi1_ipoib_rdma_netdev *)netdev_priv(dev))->dev_priv;
}

int hfi1_ipoib_send(struct net_device *dev,
		    struct sk_buff *skb,
		    struct ib_ah *address,
		    u32 dqpn);

int hfi1_ipoib_txreq_init(struct hfi1_ipoib_dev_priv *priv);
void hfi1_ipoib_txreq_deinit(struct hfi1_ipoib_dev_priv *priv);

int hfi1_ipoib_rxq_init(struct net_device *dev);
void hfi1_ipoib_rxq_deinit(struct net_device *dev);

void hfi1_ipoib_napi_tx_enable(struct net_device *dev);
void hfi1_ipoib_napi_tx_disable(struct net_device *dev);

struct sk_buff *hfi1_ipoib_prepare_skb(struct hfi1_netdev_rxq *rxq,
				       int size, void *data);

int hfi1_ipoib_rn_get_params(struct ib_device *device,
			     u32 port_num,
			     enum rdma_netdev_t type,
			     struct rdma_netdev_alloc_params *params);

void hfi1_ipoib_tx_timeout(struct net_device *dev, unsigned int q);

#endif /* _IPOIB_H */

Annotation

• Immediate include surface: `linux/types.h`, `linux/stddef.h`, `linux/atomic.h`, `linux/netdevice.h`, `linux/slab.h`, `linux/skbuff.h`, `linux/list.h`, `linux/if_infiniband.h`.
• Detected declarations: `struct hfi1_ipoib_dev_priv`, `struct ipoib_txreq`, `struct hfi1_ipoib_circ_buf`, `struct hfi1_ipoib_txq`, `struct hfi1_ipoib_dev_priv`, `struct hfi1_ipoib_rdma_netdev`, `function hfi1_ipoib_priv`.
• Atlas domain: Driver Families / drivers/infiniband.
• Implementation status: pattern implementation candidate.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.

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.