qla4xxx_find...e_chap_index(9)

✨ qla4xxx_find_free_chap_index(9) — Kernel API Manual ✨

okay bestie, welcome to the Kernel API Manual, section 9, and today's main character is qla4xxx_find_free_chap_index. it's a little SCSI driver function and honestly it's giving "quietly doing its job" energy 🎀

---

💖 NAME 💖

qla4xxx_find_free_chap_index — literally just find the first free chap index 🦋

---

🌸 SYNOPSIS 🌸

int qla4xxx_find_free_chap_index (struct scsi_qla_host *ha , uint16_t
*chap_index );

that's the whole vibe. takes two things, gives you back an int. slay ✨

---

🎀 ARGUMENTS 🎀

• ha — pointer to adapter structure. that's your adapter, bestie, the whole host situation 🫶
• chap_index — CHAP index to be returned. it comes back out through here, so like... it's the output, not the input. iykyk 💅

---

👑 DESCRIPTION 👑

Find the first free chap index available in the chap table ⭐

that's it, that's the function. it goes looking through the chap table and grabs you the first free slot. no cap, that's the entire job 🔥

---

💀 NOTE 💀

Caller should acquire the chap lock before getting here. 🔒

fr fr, do not skip this. the lock is your responsibility, not this function's. it will not hold your hand. lock first, then call. periodt 💅

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/qla4xxx/ql4_os.c — and here's the whole friend group, all of them in (9):

• qla4xxx_create_chap_list(9)
• qla4xxx_set_chap_entry(9)
• qla4xxx_mark_all_devices_missing(9)
• qla4xxx_queuecommand(9)
• qla4xxx_mem_free(9)
• qla4xxx_mem_alloc(9)
• qla4_8xxx_check_temp(9)
• qla4_8xxx_check_fw_alive(9)
• qla4_8xxx_watchdog(9)
• qla4xxx_timer(9)
• qla4xxx_cmd_wait(9)
• qla4xxx_soft_reset(9)
• qla4xxx_abort_active_cmds(9)
• qla4xxx_recover_adapter(9)
• qla4xxx_do_dpc(9)
• qla4xxx_free_adapter(9)
• qla4xxx_get_bidi_chap(9)
• qla4xxx_check_existing_isid(9)
• qla4xxx_update_isid(9)
• qla4xxx_should_update_isid(9)
• qla4xxx_is_flash_ddb_exists(9)
• qla4xxx_remove_failed_ddb(9)
• qla4xxx_sysfs_ddb_is_non_persistent(9)
• qla4xxx_sysfs_ddb_tgt_create(9)
• qla4xxx_sysfs_ddb_add(9)
• qla4xxx_sysfs_ddb_apply(9)
• qla4xxx_sysfs_ddb_login(9)
• qla4xxx_sysfs_ddb_logout_sid(9)
• qla4xxx_sysfs_ddb_logout(9)
• qla4xxx_sysfs_ddb_set_param(9)
• qla4xxx_sysfs_ddb_delete(9)
• qla4xxx_sysfs_ddb_export(9)
• qla4xxx_build_ddb_list(9)
• qla4xxx_wait_login_resp_boot_tgt(9)
• qla4xxx_probe_adapter(9)
• qla4xxx_prevent_other_port_reinit(9)
• qla4xxx_remove_adapter(9)
• qla4xxx_config_dma_addressing(9)
• qla4xxx_del_from_active_array(9)
• qla4xxx_eh_wait_on_command(9)
• qla4xxx_wait_for_hba_online(9)
• qla4xxx_eh_wait_for_commands(9)
• qla4xxx_eh_abort(9)
• qla4xxx_eh_device_reset(9)
• qla4xxx_eh_target_reset(9)
• qla4xxx_is_eh_active(9)
• qla4xxx_eh_host_reset(9)
• qla4xxx_pci_mmio_enabled(9)

---

and that's the page!! mwah 💋 this came from the ./drivers/scsi/qla4xxx source directory, dated October 2026, and it's page qla4xxx_find...e_chap_index(9) uwu. go forth and lock your chap table before calling, bestie 🧚💜