drivers/scsi/isci/isci.h

File Facts

System

Linux kernel

Corpus path

drivers/scsi/isci/isci.h

Extension

.h

Size

18504 bytes

Lines

531

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.
• 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/interrupt.h
• linux/types.h

Detected Declarations

• struct sci_timer
• struct sci_base_state_machine
• struct sci_base_state
• enum sci_status
• enum sci_io_status
• enum sci_task_status
• function check_sizes
• function swab32
• function sci_init_timer
• function sci_mod_timer
• function sci_del_timer

Annotated Snippet

struct sci_timer {
	struct timer_list	timer;
	bool			cancel;
};

static inline
void sci_init_timer(struct sci_timer *tmr, void (*fn)(struct timer_list *t))
{
	tmr->cancel = false;
	timer_setup(&tmr->timer, fn, 0);
}

static inline void sci_mod_timer(struct sci_timer *tmr, unsigned long msec)
{
	tmr->cancel = false;
	mod_timer(&tmr->timer, jiffies + msecs_to_jiffies(msec));
}

static inline void sci_del_timer(struct sci_timer *tmr)
{
	tmr->cancel = true;
	timer_delete(&tmr->timer);
}

struct sci_base_state_machine {
	const struct sci_base_state *state_table;
	u32 initial_state_id;
	u32 current_state_id;
	u32 previous_state_id;
};

typedef void (*sci_state_transition_t)(struct sci_base_state_machine *sm);

struct sci_base_state {
	sci_state_transition_t enter_state;	/* Called on state entry */
	sci_state_transition_t exit_state;	/* Called on state exit */
};

extern void sci_init_sm(struct sci_base_state_machine *sm,
			const struct sci_base_state *state_table,
			u32 initial_state);
extern void sci_change_state(struct sci_base_state_machine *sm, u32 next_state);
#endif  /* __ISCI_H__ */

Annotation

• Immediate include surface: `linux/interrupt.h`, `linux/types.h`.
• Detected declarations: `struct sci_timer`, `struct sci_base_state_machine`, `struct sci_base_state`, `enum sci_status`, `enum sci_io_status`, `enum sci_task_status`, `function check_sizes`, `function swab32`, `function sci_init_timer`, `function sci_mod_timer`.
• Atlas domain: Driver Families / drivers/scsi.
• 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.