lpfc_bg_err_inject(9)

💖 lpfc_bg_err_inject(9) 💖

okay so bestie, this is a page from the Kernel API Manual — it's lpfc_bg_err_inject(9), and literally the whole job of this function is deciding whether we should inject an error. yes, on purpose. we're being messy intentionally ✨

---

🎀 NAME 🎀

lpfc_bg_err_inject — Determine if we should inject an error

like, it's a vibe check for errors: are we throwing one today or not 🙈

---

🦋 SYNOPSIS 🦋

int lpfc_bg_err_inject (struct lpfc_hba *phba , struct scsi_cmnd *sc ,
uint32_t *reftag , uint16_t *apptag , uint32_t new_guard );

---

🌸 ARGUMENTS 🌸

• phba — The Hba for which this call is being executed. it's the main character of this whole operation, fr fr.
• sc — The SCSI command to examine. we're looking at it. respectfully. 👀
• reftag — (out) BlockGuard reference tag for transmitted data. it's an out param, so this baby gets written to, not read from.
• apptag — (out) BlockGuard application tag for transmitted data. also out. also getting filled in. matching energy 💅
• new_guard — (in) Value to replace CRC with if needed. this one's an in — you hand it over, no take-backs.

---

💜 DESCRIPTION 💜

Returns BG_ERR_* bit mask or 0 if request ignored.

that's it, that's the whole deal. either you get a BG_ERR_* bit mask back, or a straight-up 0 meaning the request got ignored. no in-between, no maybes — very decisive of it 👑

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/lpfc/lpfc_scsi.c — that's where the magic lives, iykyk.

and now the full friend-group roll call, because everyone gets mentioned:

• lpfc_sli4_set_rsp_sgl_last(9)
• lpfc_rampdown_queue_depth(9)
• lpfc_ramp_down_queue_handler(9)
• lpfc_scsi_dev_block(9)
• lpfc_new_scsi_buf_s3(9)
• lpfc_sli4_vport_delete_fcp_xri_aborted(9)
• lpfc_sli4_io_xri_aborted(9)
• lpfc_get_scsi_buf_s3(9)
• lpfc_get_scsi_buf_s4(9)
• lpfc_get_scsi_buf(9)
• lpfc_release_scsi_buf_s3(9)
• lpfc_release_scsi_buf_s4(9)
• lpfc_release_scsi_buf(9)
• lpfc_fcpcmd_to_iocb(9)
• lpfc_scsi_prep_dma_buf_s3(9)
• lpfc_sc_to_bg_opcodes(9)
• lpfc_bg_err_opcodes(9)
• lpfc_bg_setup_bpl(9)
• lpfc_bg_setup_bpl_prot(9)
• lpfc_bg_setup_sgl(9)
• lpfc_bg_setup_sgl_prot(9)
• lpfc_prot_group_type(9)
• lpfc_bg_scsi_adjust_dl(9)
• lpfc_bg_scsi_prep_dma_buf_s3(9)
• lpfc_scsi_prep_dma_buf_s4(9)
• lpfc_bg_scsi_prep_dma_buf_s4(9)
• lpfc_scsi_prep_dma_buf(9)
• lpfc_bg_scsi_prep_dma_buf(9)
• lpfc_scsi_prep_cmnd_buf(9)
• lpfc_send_scsi_error_event(9)
• lpfc_scsi_unprep_dma_buf(9)
• lpfc_unblock_requests(9)
• lpfc_block_requests(9)
• lpfc_update_cmf_cmpl(9)
• lpfc_update_cmf_cmd(9)
• lpfc_handle_fcp_err(9)
• lpfc_fcp_io_cmd_wqe_cmpl(9)
• lpfc_scsi_cmd_iocb_cmpl(9)
• lpfc_scsi_prep_cmnd_buf_s3(9)
• lpfc_scsi_prep_cmnd_buf_s4(9)
• lpfc_scsi_prep_cmnd(9)
• lpfc_scsi_prep_task_mgmt_cmd_s3(9)
• lpfc_scsi_prep_task_mgmt_cmd_s4(9)
• lpfc_scsi_api_table_setup(9)
• lpfc_tskmgmt_def_cmpl(9)
• lpfc_check_pci_resettable(9)
• lpfc_info(9)
• lpfc_poll_rearm_timer(9)
• lpfc_poll_start_timer(9)
• lpfc_poll_timeout(9)
• lpfc_queuecommand(9)
• lpfc_abort_handler(9)
• lpfc_check_fcp_rsp(9)
• lpfc_send_taskmgmt(9)
• lpfc_chk_tgt_mapped(9)
• lpfc_reset_flush_io_context(9)
• lpfc_device_reset_handler(9)
• lpfc_target_reset_handler(9)
• lpfc_host_reset_handler(9)
• lpfc_sdev_init(9)
• lpfc_sdev_configure(9)
• lpfc_sdev_destroy(9)
• lpfc_create_device_data(9)
• lpfc_delete_device_data(9)
• __lpfc_get_device_data(9)
• lpfc_find_next_oas_lun(9)
• lpfc_enable_oas_lun(9)
• lpfc_disable_oas_lun(9)

like, that is a stacked guest list. everybody showed up 💀

---

lowkey important reminder: reftag and apptag are out params and new_guard is an in param — don't mix them up or it's giving undefined chaos 🫶

---

mwah, that's the whole page 🎀 this lil gem comes from ./drivers/scsi/lpfc, dated October 2026, and it's filed under lpfc_bg_err_inject(9) — go inject some errors responsibly bestie 💅✨