drivers/scsi/arm/fas216.c
Source file repositories/reference/linux-study-clean/drivers/scsi/arm/fas216.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/scsi/arm/fas216.c- Extension
.c- Size
- 79133 bytes
- Lines
- 3040
- Domain
- Driver Families
- Bucket
- drivers/scsi
- Inferred role
- Driver Families: exported/initcall integration point
- Status
- integration 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.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- 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/module.hlinux/blkdev.hlinux/kernel.hlinux/string.hlinux/ioport.hlinux/proc_fs.hlinux/delay.hlinux/bitops.hlinux/init.hlinux/interrupt.hasm/dma.hasm/io.hasm/irq.hasm/ecard.hscsi/scsi.hscsi/scsi_cmnd.hscsi/scsi_dbg.hscsi/scsi_device.hscsi/scsi_eh.hscsi/scsi_host.hscsi/scsi_tcq.hfas216.harm_scsi.h
Detected Declarations
enum res_findfunction fas216_log_setupfunction fas216_readbfunction fas216_writebfunction fas216_dumpstatefunction print_SCpfunction fas216_dumpinfofunction __fas216_checkmagicfunction fas216_targetfunction fas216_do_logfunction fas216_log_commandfunction fas216_log_targetfunction fas216_logfunction add_debug_listfunction fas216_cmdfunction print_debug_listfunction fas216_get_last_msgfunction fas216_syncperiodfunction fas216_set_syncfunction fas216_handlesyncfunction fas216_updateptrsfunction fas216_piofunction fas216_set_stcfunction fas216_get_ctcfunction fas216_cleanuptransferfunction fas216_transferfunction fas216_stoptransferfunction fas216_aborttransferfunction fas216_disconnect_intrfunction fas216_reselected_intrfunction fas216_parse_messagefunction fas216_wait_cmdfunction fas216_get_msg_bytefunction fas216_messagefunction fas216_send_commandfunction fas216_send_messageoutfunction fas216_busservice_intrfunction STATEfunction fas216_funcdone_intrfunction fas216_bus_resetfunction fas216_intrfunction __fas216_start_commandfunction phasefunction fas216_start_commandfunction fas216_allocate_tagfunction fas216_do_bus_device_resetfunction fas216_kickfunction fas216_devicereset_done
Annotated Snippet
switch (s[0]) {
case 'a':
if (strcmp(s, "all") == 0)
level_mask |= -1;
break;
case 'b':
if (strncmp(s, "bus", 3) == 0)
level_mask |= LOG_BUSSERVICE;
if (strncmp(s, "buf", 3) == 0)
level_mask |= LOG_BUFFER;
break;
case 'c':
level_mask |= LOG_CONNECT;
break;
case 'e':
level_mask |= LOG_ERROR;
break;
case 'm':
level_mask |= LOG_MESSAGES;
break;
case 'n':
if (strcmp(s, "none") == 0)
level_mask = 0;
break;
case 's':
level_mask |= LOG_FUNCTIONDONE;
break;
}
}
return 1;
}
__setup("fas216_logging=", fas216_log_setup);
#endif
static inline unsigned char fas216_readb(FAS216_Info *info, unsigned int reg)
{
unsigned int off = reg << info->scsi.io_shift;
return readb(info->scsi.io_base + off);
}
static inline void fas216_writeb(FAS216_Info *info, unsigned int reg, unsigned int val)
{
unsigned int off = reg << info->scsi.io_shift;
writeb(val, info->scsi.io_base + off);
}
static void fas216_dumpstate(FAS216_Info *info)
{
unsigned char is, stat, inst;
is = fas216_readb(info, REG_IS);
stat = fas216_readb(info, REG_STAT);
inst = fas216_readb(info, REG_INST);
printk("FAS216: CTCL=%02X CTCM=%02X CMD=%02X STAT=%02X"
" INST=%02X IS=%02X CFIS=%02X",
fas216_readb(info, REG_CTCL),
fas216_readb(info, REG_CTCM),
fas216_readb(info, REG_CMD), stat, inst, is,
fas216_readb(info, REG_CFIS));
printk(" CNTL1=%02X CNTL2=%02X CNTL3=%02X CTCH=%02X\n",
fas216_readb(info, REG_CNTL1),
fas216_readb(info, REG_CNTL2),
fas216_readb(info, REG_CNTL3),
fas216_readb(info, REG_CTCH));
}
static void print_SCp(struct scsi_pointer *SCp, const char *prefix, const char *suffix)
{
printk("%sptr %p this_residual 0x%x buffer %p buffers_residual 0x%x%s",
prefix, SCp->ptr, SCp->this_residual, SCp->buffer,
SCp->buffers_residual, suffix);
}
#ifdef CHECK_STRUCTURE
static void fas216_dumpinfo(FAS216_Info *info)
{
static int used = 0;
int i;
if (used++)
return;
printk("FAS216_Info=\n");
printk(" { magic_start=%lX host=%p SCpnt=%p origSCpnt=%p\n",
info->magic_start, info->host, info->SCpnt,
info->origSCpnt);
printk(" scsi={ io_shift=%X irq=%X cfg={ %X %X %X %X }\n",
info->scsi.io_shift, info->scsi.irq,
Annotation
- Immediate include surface: `linux/module.h`, `linux/blkdev.h`, `linux/kernel.h`, `linux/string.h`, `linux/ioport.h`, `linux/proc_fs.h`, `linux/delay.h`, `linux/bitops.h`.
- Detected declarations: `enum res_find`, `function fas216_log_setup`, `function fas216_readb`, `function fas216_writeb`, `function fas216_dumpstate`, `function print_SCp`, `function fas216_dumpinfo`, `function __fas216_checkmagic`, `function fas216_target`, `function fas216_do_log`.
- Atlas domain: Driver Families / drivers/scsi.
- Implementation status: integration 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.