lpfc_heart_beat(9)

💓 NAME 💓

lpfc_heart_beat — Prepare a mailbox command for heart beat

okay so first things first, bestie: this is a page from the Kernel API Manual, section 9 (that's the kernel-API gal, iykyk). It's all about one lil function that keeps an eye on your HBA's pulse. Slay. 💅

---

✨ SYNOPSIS ✨

void lpfc_heart_beat (struct lpfc_hba * phba , LPFC_MBOXQ_t * pmb );

two args, no return, no drama. periodt.

---

🎀 ARGUMENTS 🎀

• phba — pointer to the lpfc_hba data structure. that's your hba's whole vibe, its data home base, its little profile page 🫶
• pmb — pointer to the driver internal queue element for the mailbox command. lowkey the envelope this heart beat gets mailed in ✉️

---

🦋 DESCRIPTION 🦋

so like. the heart beat mailbox command is the thing that detects an unresponsive HBA. and the manual is very specific about what "unresponsive" means, no cap: it's any device where no error attention is sent AND both mailbox and rings are not processed. both. they gotta be doing nothing at all for it to count as flatlining 😭

This routine prepares the mailbox command for issuing a heart beat in the form of mailbox command to the HBA. Basically it gets the whole thing ready to send — it's not the sending, it's the preparing, okay? 💖

And then: The timely completion of the heart beat mailbox command indicates the health of the HBA. so if it comes back in time? healthy queen. if it doesn't? 💀 that's the whole vibe check right there. it's giving cardiogram.

not me being obsessed with the fact that checking on a server card is literally just. a pulse check. iconic. 👑

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/lpfc/lpfc_mbox.c — plus literally the entire extended friend group, here they all are, in the order the original said them, no one left out:

• 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_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_hbq(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)

---

ok bestie real talk — if the heart beat doesn't come back timely, the HBA is not okay and you should be concerned. that's the entire point of this lil guy. 🩺

---

so that's the whole page! 🍓 this one ships from ./drivers/scsi/lpfc, dated October 2026, and it's filed under lpfc_heart_beat(9) — take care of your HBA and it'll keep on beating, mwah 💜🧚‍♀️✨