lpfc_config_hbq(9)

💖 lpfc_config_hbq(9) 💖

okay bestie, welcome to the Kernel API Manual — today we're doing lpfc_config_hbq(9) and it's giving deep kernel driver lore, but make it cute. no cap, we're covering every single detail, so grab a strawberry 🍓 and let's go.

---

✨ NAME ✨

lpfc_config_hbq — prepare a mailbox command for configuring an HBQ. that's it, that's the name, short and iconic. 💅

🌸 SYNOPSIS 🌸

void lpfc_config_hbq (struct lpfc_hba *phba , uint32_t id , struct
       lpfc_hbq_init *hbq_desc , uint32_t hbq_entry_index , LPFC_MBOXQ_t *pmb
       );

look at her. five parameters, all accounted for, zero skips. 🫶

🦋 ARGUMENTS 🦋

• phba — pointer to the lpfc hba data structure. this is the main character adapter struct, the whole HBA's lore in one pointer. 👑
• id — HBQ identifier. it's the label that says which HBQ we're talking about, iykyk.
• hbq_desc — pointer to the HBA descriptor data structure. the desc bestie holding the deets. 🎀
• hbq_entry_index — index of the HBQ entry data structures. literally just the index, bestie, no cap.
• pmb — pointer to the driver internal queue element for mailbox command. this is the queue element the mailbox command rolls with. 💌

💜 DESCRIPTION 💜

okay so real talk: the configure HBQ — that's Host Buffer Queue, keep up — mailbox command is used to configure an HBQ. that's the assignment. 💅

what the configuration does is bind events that require buffers to a particular ring and HBQ, based on a selection profile. so events that need buffers get matched up to a specific ring + HBQ combo, and the selection profile is the matchmaker. 🌈

and this routine? it prepares the mailbox command for configuring an HBQ. it's the prep girlie — gets the mbox command ready so the configuring can happen. periodt. ✨

💀 SEE ALSO 💀

the SEE ALSO section is literally a whole group chat, and I'm not leaving a single bestie out. every reference, in order, no skips: 🫶

• kernel file: ./drivers/scsi/lpfc/lpfc_mbox.c — the source file where this lives, iconic.
• lpfc_mbox_rsrc_prep(9), lpfc_mbox_rsrc_cleanup(9), lpfc_dump_static_vport(9), lpfc_down_link(9), lpfc_dump_mem(9), lpfc_dump_wakeup_param(9), lpfc_read_nv(9), lpfc_config_async(9), lpfc_heart_beat(9)
• lpfc_read_topology(9), lpfc_clear_la(9), lpfc_config_link(9), lpfc_config_msi(9), lpfc_init_link(9), lpfc_read_sparam(9), lpfc_unreg_did(9), lpfc_read_config(9), lpfc_read_lnk_stat(9), lpfc_reg_rpi(9), lpfc_unreg_login(9), lpfc_sli4_unreg_all_rpis(9)
• lpfc_reg_vpi(9), lpfc_unreg_vpi(9), lpfc_config_pcb_setup(9), lpfc_read_rev(9), lpfc_build_hbq_profile2(9), lpfc_build_hbq_profile3(9), lpfc_build_hbq_profile5(9)
• lpfc_config_ring(9), lpfc_config_port(9), lpfc_kill_board(9), lpfc_mbox_put(9), lpfc_mbox_get(9), __lpfc_mbox_cmpl_put(9), lpfc_mbox_cmpl_put(9), lpfc_mbox_cmd_check(9), lpfc_mbox_dev_check(9), lpfc_mbox_tmo_val(9)
• lpfc_sli4_mbx_sge_set(9), lpfc_sli4_mbx_sge_get(9), lpfc_sli4_mbox_cmd_free(9), lpfc_sli4_config(9), lpfc_sli4_mbox_rsrc_extent(9), lpfc_sli_config_mbox_subsys_get(9), lpfc_sli_config_mbox_opcode_get(9), lpfc_sli4_mbx_read_fcf_rec(9)
• lpfc_request_features(9), lpfc_init_vfi(9), lpfc_reg_vfi(9), lpfc_init_vpi(9), lpfc_unreg_vfi(9), lpfc_sli4_dump_cfg_rg23(9), lpfc_reg_fcfi(9), lpfc_reg_fcfi_mrq(9), lpfc_unreg_fcfi(9), lpfc_resume_rpi(9)

okay that's everyone, and yes I counted. 😭

---

source-verse check: this page is from ./drivers/scsi/lpfc, dated October 2026, and it's lpfc_config_hbq(9) forever. mwah, bestie 💋