dc395x_init_one(9)

💅 dc395x_init_one(9) — the Kernel API Manual glow-up ✨

ok so picture this: we're in the dc395x SCSI driver, and this little function is the meet-cute between the kernel and one single adapter instance. it's giving "first day of school" energy, except the school is the PCI subsystem and the new kid is a SCSI card. she's the main character and this is her intro arc 🎀

---

✨ NAME ✨

dc395x_init_one — literally just: initialise one (1) single instance of the adapter. that's it. that's the whole job. no cap 💅

---

🌸 SYNOPSIS 🌸

int dc395x_init_one (struct pci_dev *dev , const struct pci_device_id *id );

---

🦋 ARGUMENTS 🦋

• dev — the PCI device we're supposed to initialize. this is the one, bestie. the actual card. the whole reason we're here 🫶
• id — ok so this one looks like a pointer to the entry in our pci device table that was actually matched by the PCI subsystem. like the match that made this whole thing happen. it's giving "how we met" story 😭

---

💜 DESCRIPTION 💜

okay so here's the vibe: the PCI layer is gonna call this thing once for each instance of the adapter that it finds lurking in the system. so if you've got multiple cards, she gets multiple calls. no shortcuts, no "just do it once and call it a day" — one call per instance, periodt 💅

and the pci_dev structure? that's how we know which instance we're being called from. it's the caller ID, basically. you pick up and go "oh hey, it's you" ✨

returns 0 on success 🎉 … or an error code (that's a negative one, hence the -ve notation) on failure 💀 so yeah, check your return values, bestie, that's the whole game.

---

👑 SEE ALSO 👑

the kernel file ./drivers/scsi/dc395x.c has a whole friend group and honestly we gotta shout out every single one of them, so buckle up bestie, here's the roster 🌈:

• set_safe_settings(9)
• fix_settings(9)
• eeprom_index_to_delay(9)
• delay_to_eeprom_index(9)
• eeprom_override(9)
• dc395x_queue_command_lck(9)
• dc395x_handle_interrupt(9)
• device_alloc(9)
• adapter_add_device(9)
• adapter_remove_device(9)
• adapter_remove_and_free_device(9)
• adapter_remove_and_free_all_devices(9)
• dc395x_sdev_init(9)
• dc395x_sdev_destroy(9)
• trms1040_wait_30us(9)
• trms1040_write_cmd(9)
• trms1040_set_data(9)
• trms1040_write_all(9)
• trms1040_get_data(9)
• trms1040_read_all(9)
• check_eeprom(9)
• print_eeprom_settings(9)
• adapter_print_config(9)
• adapter_init_params(9)
• adapter_init_scsi_host(9)
• adapter_init_chip(9)
• adapter_init(9)
• adapter_uninit_chip(9)
• adapter_uninit(9)
• dc395x_remove_one(9)

like, that's a lot of cousins, but we love them all equally 🧚 and yeah — dc395x_remove_one(9) is the one who shows up at the end to say goodbye. iconic symmetry, honestly.

---

and that's the page!! mwah 💋 this came from the ./drivers/scsi section, dated October 2026, and it's filed under dc395x_init_one(9) — go forth and initialise responsibly, bestie 🌟