drivers/scsi/megaraid/megaraid_sas.h

File Facts

System

Linux kernel

Corpus path

drivers/scsi/megaraid/megaraid_sas.h

Extension

.h

Size

67101 bytes

Lines

2765

Domain

Driver Families

Bucket

drivers/scsi

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

• scsi/scsi_cmnd.h

Detected Declarations

• struct MR_PD_PROGRESS
• struct MR_PD_INFO
• struct MR_TARGET_PROPERTIES
• struct MR_PD_ADDRESS
• struct MR_PD_LIST
• struct megasas_pd_list
• struct MR_LD_LIST
• struct MR_LD_TARGETID_LIST
• struct MR_HOST_DEVICE_LIST_ENTRY
• struct MR_HOST_DEVICE_LIST
• struct megasas_ctrl_prop
• struct megasas_ctrl_info
• struct megasas_register_set
• struct megasas_sge32
• struct megasas_sge64
• struct megasas_sge_skinny
• struct megasas_header
• struct megasas_init_frame
• struct megasas_init_queue_info
• struct megasas_io_frame
• struct megasas_pthru_frame
• struct megasas_dcmd_frame
• struct megasas_abort_frame
• struct megasas_smp_frame
• struct megasas_stp_frame
• struct MR_PRIV_DEVICE
• struct megasas_cmd
• struct megasas_evt_log_info
• struct megasas_progress
• struct megasas_evtarg_ld
• struct megasas_evtarg_pd
• struct megasas_evt_detail
• struct megasas_aen_event
• struct megasas_irq_context
• struct MR_DRV_SYSTEM_INFO
• struct megasas_instance
• struct MR_LD_VF_MAP
• struct MR_LD_VF_AFFILIATION
• struct IOV_111
• struct MR_LD_VF_MAP_111
• struct MR_LD_VF_AFFILIATION_111
• struct MR_CTRL_HB_HOST_MEM
• struct megasas_instance_template
• struct megasas_cmd
• struct megasas_cmd_priv
• struct megasas_iocpacket
• struct megasas_aen
• struct compat_megasas_iocpacket

Annotated Snippet

struct MR_PD_PROGRESS {
	struct {
#ifndef __BIG_ENDIAN_BITFIELD
		u32     rbld:1;
		u32     patrol:1;
		u32     clear:1;
		u32     copyBack:1;
		u32     erase:1;
		u32     locate:1;
		u32     reserved:26;
#else
		u32     reserved:26;
		u32     locate:1;
		u32     erase:1;
		u32     copyBack:1;
		u32     clear:1;
		u32     patrol:1;
		u32     rbld:1;
#endif
	} active;
	union MR_PROGRESS     rbld;
	union MR_PROGRESS     patrol;
	union {
		union MR_PROGRESS     clear;
		union MR_PROGRESS     erase;
	};

	struct {
#ifndef __BIG_ENDIAN_BITFIELD
		u32     rbld:1;
		u32     patrol:1;
		u32     clear:1;
		u32     copyBack:1;
		u32     erase:1;
		u32     reserved:27;
#else
		u32     reserved:27;
		u32     erase:1;
		u32     copyBack:1;
		u32     clear:1;
		u32     patrol:1;
		u32     rbld:1;
#endif
	} pause;

	union MR_PROGRESS     reserved[3];
} __packed;

struct  MR_PD_INFO {
	union MR_PD_REF	ref;
	u8 inquiryData[96];
	u8 vpdPage83[64];
	u8 notSupported;
	u8 scsiDevType;

	union {
		u8 connectedPortBitmap;
		u8 connectedPortNumbers;
	};

	u8 deviceSpeed;
	u32 mediaErrCount;
	u32 otherErrCount;
	u32 predFailCount;
	u32 lastPredFailEventSeqNum;

	u16 fwState;
	u8 disabledForRemoval;
	u8 linkSpeed;
	union MR_PD_DDF_TYPE state;

	struct {
		u8 count;
#ifndef __BIG_ENDIAN_BITFIELD
		u8 isPathBroken:4;
		u8 reserved3:3;
		u8 widePortCapable:1;
#else
		u8 widePortCapable:1;
		u8 reserved3:3;
		u8 isPathBroken:4;
#endif

		u8 connectorIndex[2];
		u8 reserved[4];
		u64 sasAddr[2];
		u8 reserved2[16];
	} pathInfo;

	u64 rawSize;

Annotation

• Immediate include surface: `scsi/scsi_cmnd.h`.
• Detected declarations: `struct MR_PD_PROGRESS`, `struct MR_PD_INFO`, `struct MR_TARGET_PROPERTIES`, `struct MR_PD_ADDRESS`, `struct MR_PD_LIST`, `struct megasas_pd_list`, `struct MR_LD_LIST`, `struct MR_LD_TARGETID_LIST`, `struct MR_HOST_DEVICE_LIST_ENTRY`, `struct MR_HOST_DEVICE_LIST`.
• Atlas domain: Driver Families / drivers/scsi.
• 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.