lpfc_unreg_vpi(9)

🎀 NAME 🎀

lpfc_unreg_vpi(9) — okay bestie, this one is literally “Prepare a mailbox command for unregistering vport id.” And yes, we’re in the Kernel API Manual now, so grab your iced coffee and let’s get into it 💅

---

✨ SYNOPSIS ✨

void lpfc_unreg_vpi (struct lpfc_hba *phba , uint16_t vpi , LPFC_MBOXQ_t *pmb );

Return type is void, so no return value is coming back to you — it’s giving “do the prep, no receipts” energy 🫶

---

💅 ARGUMENTS 💅

• phba — pointer to lpfc hba data structure. Yep, the hba said “that’s me.”
• vpi — virtual N_Port identifier. This is the vport-id bestie in question 🦋
• pmb — pointer to the driver internal queue element for mailbox command. It’s the little mailbox vessel that carries the command 💌

---

🦋 DESCRIPTION 🦋

Okay so the unregistration vport identifier mailbox command is used to inactivate a virtual N_Port. That’s the whole vibe: this command makes that virtual N_Port go inactive.

⚠️ Important caveat, no cap: the driver must have logged out and unregistered all remote N_Ports to abort any activity on the virtual N_Port. So handle that first, bestie. Don’t skip the prerequisites.

The HBA will unregister any default RPIs associated with the specified vpi, aborting any active exchanges. It will also post the mailbox response after making the virtual N_Port inactive. So the HBA does its thing, then reports back — iconic behavior honestly 👑

This routine prepares the mailbox command for unregistering a virtual N_Port. It’s the setup step, the “get the mailbox ready” moment, the pre-game if you will ✨

---

🌸 SEE ALSO 🌸

Kernel file: ./drivers/scsi/lpfc/lpfc_mbox.c — home of the mailbox lore 🧚

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

---

Signing off with source/version ./drivers/scsi/lpfc, date October 2026, and page lpfc_unreg_vpi(9) energy — slay, bestie, go prepare that mailbox command 💖🎀✨