drivers/net/ethernet/pensando/ionic/ionic_if.h

File Facts

System

Linux kernel

Corpus path

drivers/net/ethernet/pensando/ionic/ionic_if.h

Extension

.h

Size

97297 bytes

Lines

3365

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.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• 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

• No C-style include directives detected by the generator.

Detected Declarations

• struct ionic_admin_cmd
• struct ionic_admin_comp
• struct ionic_nop_cmd
• struct ionic_nop_comp
• struct ionic_dev_init_cmd
• struct ionic_dev_init_comp
• struct ionic_dev_reset_cmd
• struct ionic_dev_reset_comp
• struct ionic_dev_identify_cmd
• struct ionic_dev_identify_comp
• struct ionic_lif_identify_cmd
• struct ionic_lif_identify_comp
• struct ionic_lif_logical_qtype
• struct ionic_lif_init_cmd
• struct ionic_lif_init_comp
• struct ionic_q_identify_cmd
• struct ionic_q_identify_comp
• struct ionic_q_init_cmd
• struct ionic_q_init_comp
• struct ionic_txq_desc
• struct ionic_txq_sg_elem
• struct ionic_txq_sg_desc
• struct ionic_txq_sg_desc_v1
• struct ionic_txq_comp
• struct ionic_rxq_desc
• struct ionic_rxq_sg_elem
• struct ionic_rxq_sg_desc
• struct ionic_rxq_comp
• struct ionic_q_control_cmd
• struct ionic_xcvr_status
• struct ionic_port_status
• struct ionic_port_identify_cmd
• struct ionic_port_identify_comp
• struct ionic_port_init_cmd
• struct ionic_port_init_comp
• struct ionic_port_reset_cmd
• struct ionic_port_reset_comp
• struct ionic_port_setattr_cmd
• struct ionic_port_setattr_comp
• struct ionic_port_getattr_cmd
• struct ionic_port_getattr_comp
• struct ionic_lif_status
• struct ionic_lif_reset_cmd
• struct ionic_dev_setattr_cmd
• struct ionic_dev_setattr_comp
• struct ionic_dev_getattr_cmd
• struct ionic_dev_getattr_comp
• struct ionic_lif_setattr_cmd

Annotated Snippet

struct ionic_admin_cmd {
	u8     opcode;
	u8     rsvd;
	__le16 lif_index;
	u8     cmd_data[60];
};

/**
 * struct ionic_admin_comp - General admin command completion format
 * @status:     Status of the command (enum ionic_status_code)
 * @rsvd:       reserved byte(s)
 * @comp_index: Index in the descriptor ring for which this is the completion
 * @cmd_data:   Command-specific bytes
 * @color:      Color bit (Always 0 for commands issued to the
 *              Device Cmd Registers)
 */
struct ionic_admin_comp {
	u8     status;
	u8     rsvd;
	__le16 comp_index;
	u8     cmd_data[11];
	u8     color;
#define IONIC_COMP_COLOR_MASK  0x80
};

static inline u8 color_match(u8 color, u8 done_color)
{
	return (!!(color & IONIC_COMP_COLOR_MASK)) == done_color;
}

/**
 * struct ionic_nop_cmd - NOP command
 * @opcode: opcode
 * @rsvd:   reserved byte(s)
 */
struct ionic_nop_cmd {
	u8 opcode;
	u8 rsvd[63];
};

/**
 * struct ionic_nop_comp - NOP command completion
 * @status: Status of the command (enum ionic_status_code)
 * @rsvd:   reserved byte(s)
 */
struct ionic_nop_comp {
	u8 status;
	u8 rsvd[15];
};

/**
 * struct ionic_dev_init_cmd - Device init command
 * @opcode:    opcode
 * @type:      Device type
 * @rsvd:      reserved byte(s)
 */
struct ionic_dev_init_cmd {
	u8     opcode;
	u8     type;
	u8     rsvd[62];
};

/**
 * struct ionic_dev_init_comp - Device init command completion
 * @status: Status of the command (enum ionic_status_code)
 * @rsvd:   reserved byte(s)
 */
struct ionic_dev_init_comp {
	u8 status;
	u8 rsvd[15];
};

/**
 * struct ionic_dev_reset_cmd - Device reset command
 * @opcode: opcode
 * @rsvd:   reserved byte(s)
 */
struct ionic_dev_reset_cmd {
	u8 opcode;
	u8 rsvd[63];
};

/**
 * struct ionic_dev_reset_comp - Reset command completion
 * @status: Status of the command (enum ionic_status_code)
 * @rsvd:   reserved byte(s)
 */
struct ionic_dev_reset_comp {
	u8 status;
	u8 rsvd[15];

Annotation

• Detected declarations: `struct ionic_admin_cmd`, `struct ionic_admin_comp`, `struct ionic_nop_cmd`, `struct ionic_nop_comp`, `struct ionic_dev_init_cmd`, `struct ionic_dev_init_comp`, `struct ionic_dev_reset_cmd`, `struct ionic_dev_reset_comp`, `struct ionic_dev_identify_cmd`, `struct ionic_dev_identify_comp`.
• Atlas domain: Driver Families / drivers/net.
• Implementation status: source implementation candidate.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
• 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.