drivers/scsi/mpi3mr/mpi3mr.h

File Facts

System

Linux kernel

Corpus path

drivers/scsi/mpi3mr/mpi3mr.h

Extension

.h

Size

51350 bytes

Lines

1630

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

• linux/blkdev.h
• linux/blk-mq.h
• linux/delay.h
• linux/dmapool.h
• linux/errno.h
• linux/init.h
• linux/io.h
• linux/interrupt.h
• linux/kernel.h
• linux/miscdevice.h
• linux/module.h
• linux/pci.h
• linux/aer.h
• linux/poll.h
• linux/sched.h
• linux/slab.h
• linux/types.h
• linux/uaccess.h
• linux/utsname.h
• linux/workqueue.h
• linux/unaligned.h
• scsi/scsi.h
• scsi/scsi_cmnd.h
• scsi/scsi_dbg.h
• scsi/scsi_device.h
• scsi/scsi_host.h
• scsi/scsi_tcq.h
• uapi/scsi/scsi_bsg_mpi3mr.h
• scsi/scsi_transport_sas.h
• mpi/mpi30_transport.h
• mpi/mpi30_cnfg.h
• mpi/mpi30_image.h

Detected Declarations

• struct mpi3mr_nvme_pt_sge
• struct mpi3mr_buf_map
• struct mpi3mr_compimg_ver
• struct mpi3mr_ioc_facts
• struct segments
• struct op_req_qinfo
• struct op_reply_qinfo
• struct mpi3mr_intr_info
• struct mpi3mr_throttle_group_info
• struct mpi3mr_hba_port
• struct mpi3mr_sas_port
• struct mpi3mr_sas_phy
• struct mpi3mr_sas_node
• struct mpi3mr_enclosure_node
• struct tgt_dev_sas_sata
• struct tgt_dev_pcie
• struct tgt_dev_vd
• struct mpi3mr_tgt_dev
• struct mpi3mr_stgt_priv_data
• struct mpi3mr_sdev_priv_data
• struct mpi3mr_drv_cmd
• struct trigger_event_data
• struct diag_buffer_desc
• struct dma_memory_desc
• struct chain_element
• struct scmd_priv
• struct mpi3mr_ioc
• struct mpi3mr_fwevt
• struct delayed_dev_rmhs_node
• struct delayed_evt_ack_node
• enum mpi3mr_iocstate
• enum mpi3mr_reset_reason
• enum queue_type
• enum mpi3mr_dev_state
• function mpi3mr_tgtdev_get
• function mpi3mr_free_tgtdev
• function mpi3mr_tgtdev_put

Annotated Snippet

bool device_add);
void mpi3mr_refresh_sas_ports(struct mpi3mr_ioc *mrioc);
void mpi3mr_refresh_expanders(struct mpi3mr_ioc *mrioc);
void mpi3mr_add_event_wait_for_device_refresh(struct mpi3mr_ioc *mrioc);
void mpi3mr_flush_drv_cmds(struct mpi3mr_ioc *mrioc);
void mpi3mr_flush_cmds_for_unrecovered_controller(struct mpi3mr_ioc *mrioc);
void mpi3mr_free_enclosure_list(struct mpi3mr_ioc *mrioc);
int mpi3mr_process_admin_reply_q(struct mpi3mr_ioc *mrioc);
void mpi3mr_expander_node_remove(struct mpi3mr_ioc *mrioc,
	struct mpi3mr_sas_node *sas_expander);
void mpi3mr_alloc_diag_bufs(struct mpi3mr_ioc *mrioc);
int mpi3mr_post_diag_bufs(struct mpi3mr_ioc *mrioc);
int mpi3mr_issue_diag_buf_release(struct mpi3mr_ioc *mrioc,
	struct diag_buffer_desc *diag_buffer);
void mpi3mr_release_diag_bufs(struct mpi3mr_ioc *mrioc, u8 skip_rel_action);
void mpi3mr_set_trigger_data_in_hdb(struct diag_buffer_desc *hdb,
	u8 type, union mpi3mr_trigger_data *trigger_data, bool force);
int mpi3mr_refresh_trigger(struct mpi3mr_ioc *mrioc, u8 page_type);
struct diag_buffer_desc *mpi3mr_diag_buffer_for_type(struct mpi3mr_ioc *mrioc,
	u8 buf_type);
int mpi3mr_issue_diag_buf_post(struct mpi3mr_ioc *mrioc,
	struct diag_buffer_desc *diag_buffer);
void mpi3mr_set_trigger_data_in_all_hdb(struct mpi3mr_ioc *mrioc,
	u8 type, union mpi3mr_trigger_data *trigger_data, bool force);
void mpi3mr_reply_trigger(struct mpi3mr_ioc *mrioc, u16 iocstatus,
	u32 iocloginfo);
void mpi3mr_hdb_trigger_data_event(struct mpi3mr_ioc *mrioc,
	struct trigger_event_data *event_data);
void mpi3mr_scsisense_trigger(struct mpi3mr_ioc *mrioc, u8 senseky, u8 asc,
	u8 ascq);
void mpi3mr_event_trigger(struct mpi3mr_ioc *mrioc, u8 event);
void mpi3mr_global_trigger(struct mpi3mr_ioc *mrioc, u64 trigger_data);
void mpi3mr_hdbstatuschg_evt_th(struct mpi3mr_ioc *mrioc,
	struct mpi3_event_notification_reply *event_reply);
#endif /*MPI3MR_H_INCLUDED*/

Annotation

• Immediate include surface: `linux/blkdev.h`, `linux/blk-mq.h`, `linux/delay.h`, `linux/dmapool.h`, `linux/errno.h`, `linux/init.h`, `linux/io.h`, `linux/interrupt.h`.
• Detected declarations: `struct mpi3mr_nvme_pt_sge`, `struct mpi3mr_buf_map`, `struct mpi3mr_compimg_ver`, `struct mpi3mr_ioc_facts`, `struct segments`, `struct op_req_qinfo`, `struct op_reply_qinfo`, `struct mpi3mr_intr_info`, `struct mpi3mr_throttle_group_info`, `struct mpi3mr_hba_port`.
• 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.