lpfc_bg_scsi...p_dma_buf_s3(9)

✨ NAME ✨

okay bestie, welcome to the lpfc_bg_scsi...p_dma_buf_s3(9) page from the Kernel API Manual — yes, the manual name is part of the vibe now 💖. The star of the show is lpfc_bg_scsi_prep_dma_buf_s3 — DMA mapping for scsi buffer to SLI3 IF spec. periodt.

🧚 SYNOPSIS 🧚

int lpfc_bg_scsi_prep_dma_buf_s3 (struct lpfc_hba *phba , struct
       lpfc_io_buf *lpfc_cmd );

🌸 ARGUMENTS 🌸

• phba — The Hba for which this call is being executed. 🫶
• lpfc_cmd — The scsi buffer which is going to be prep'ed. ✨

💅 DESCRIPTION 💅

This is the protection/DIF aware version of lpfc_scsi_prep_dma_buf. The page literally says it may be a good idea to combine the two functions eventually, but for now, it's here — and honestly? iconic little “for now” energy. 🦋

RETURNS 0 - SUCCESS, 1 - Failed DMA map, retry. 2 - Invalid scsi cmd or prot-type. Do not rety.

lowkey important: 2 means invalid scsi cmd or prot-type, and the page says Do not rety — so do not retry it, bestie. 💀

🎀 SEE ALSO 🎀

Kernel file: ./drivers/scsi/lpfc/lpfc_scsi.c — that’s the file ref, no cap. The whole SEE ALSO squad is here:

• Kernel file: ./drivers/scsi/lpfc/lpfc_scsi.c
• 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_bg_err_inject(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_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)

okay that’s the page bestie 🫶 source/version: ./drivers/scsi/lpfc — date: October 2026 — page: lpfc_bg_scsi...p_dma_buf_s3(9). mwah 💋