lpfc_els_rcv_farp(9)

📦 version 7.3.1, in nixpkgs unstable

✨ NAME ✨

okay so bestie, you're looking at lpfc_els_rcv_farp(9) from the Kernel API Manual, and its whole thing is processing an unsolicited farp request els command. no cap, that's the name. 💅

🎀 SYNOPSIS 🎀

int lpfc_els_rcv_farp (struct lpfc_vport *vport , struct lpfc_iocbq
       *cmdiocb , struct lpfc_nodelist *ndlp );

🦋 ARGUMENTS 🦋

  • vport — pointer to a virtual N_Port data structure. 🫶
  • cmdiocb — pointer to lpfc command iocb data structure.
  • ndlp — pointer to a node-list data structure.

💖 DESCRIPTION 💖

Okay so here's the tea: this routine processes a Fibre Channel Address Resolution Protocol (FARP) Request IOCB received as an ELS unsolicited event. ✨

Right now the lpfc driver only supports matching on WWPN or WWNN for FARP. So the vibe check is: the FARP_MATCH_PORT flag and FARP_MATCH_NODE flag are checked against the Match Flag in the FARP request IOCB. If FARP_MATCH_PORT is set, the remote PortName is compared against the FC PortName stored in the vport data structure. If FARP_MATCH_NODE is set, the remote NodeName is compared against the FC NodeName stored in the vport data structure. 🌸

If any of these matches and the FARP_REQUEST_FARPR flag is set in the FARP request IOCB Response Flag, the lpfc_issue_els_farpr routine is invoked to send out a FARP Response to the remote node. 🫶 Before sending the FARP Response, though, the FARP_REQUEST_PLOGI flag is checked in the FARP request IOCB Response Flag — and if it's set, the lpfc_issue_els_plogi routine is invoked to log into the remote port first. 😭

Return code 0 — either the FARP Match Mode not supported or successfully processed. That's the whole return-code moment. 💀

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/lpfc/lpfc_els.c — and honestly the whole ELS friend group is here: lpfc_els_chk_latt(9), lpfc_prep_els_iocb(9), lpfc_issue_fabric_reglogin(9), lpfc_issue_reg_vfi(9), lpfc_issue_unreg_vfi(9), lpfc_check_clean_addr_bit(9), lpfc_cmpl_els_flogi_fabric(9), lpfc_cmpl_els_flogi_nport(9), lpfc_cmpl_els_flogi(9), lpfc_cmpl_els_link_down(9), lpfc_issue_els_flogi(9), lpfc_els_abort_flogi(9), lpfc_initial_flogi(9), lpfc_initial_fdisc(9), lpfc_more_plogi(9), lpfc_plogi_confirm_nport(9), lpfc_end_rscn(9), lpfc_cmpl_els_rrq(9), lpfc_check_encryption(9), lpfc_cmpl_els_plogi(9), lpfc_issue_els_plogi(9), lpfc_cmpl_els_prli(9), lpfc_issue_els_prli(9), lpfc_rscn_disc(9), lpfc_adisc_done(9), lpfc_more_adisc(9), lpfc_cmpl_els_adisc(9), lpfc_issue_els_adisc(9), lpfc_cmpl_els_logo(9), lpfc_issue_els_logo(9), lpfc_cmpl_els_cmd(9), lpfc_reg_fab_ctrl_node(9), lpfc_cmpl_els_disc_cmd(9), lpfc_issue_els_scr(9), lpfc_issue_els_rscn(9), lpfc_issue_els_farpr(9), lpfc_issue_els_rdf(9), lpfc_least_capable_settings(9), lpfc_cmpl_els_edc(9), lpfc_cancel_retry_delay_tmo(9), lpfc_els_retry_delay(9), lpfc_els_retry_delay_handler(9), lpfc_link_reset(9), lpfc_els_retry(9), lpfc_els_free_data(9), lpfc_els_free_bpl(9), lpfc_els_free_iocb(9), lpfc_cmpl_els_logo_acc(9), lpfc_mbx_cmpl_dflt_rpi(9), lpfc_cmpl_els_rsp(9), lpfc_els_rsp_acc(9), lpfc_els_rsp_reject(9), lpfc_els_rsp_adisc_acc(9), lpfc_els_rsp_prli_acc(9), lpfc_els_rsp_rnid_acc(9), lpfc_els_clear_rrq(9), lpfc_els_rsp_echo_acc(9), lpfc_els_disc_adisc(9), lpfc_els_disc_plogi(9), lpfc_els_rcv_lcb(9), lpfc_els_flush_rscn(9), lpfc_rscn_payload_check(9), lpfc_rscn_recovery_check(9), lpfc_send_rscn_event(9), lpfc_els_rcv_rscn(9), lpfc_els_handle_rscn(9), lpfc_els_rcv_flogi(9), lpfc_els_rcv_rnid(9), lpfc_els_rcv_echo(9), lpfc_els_rcv_lirr(9), lpfc_els_rcv_rrq(9), lpfc_els_rsp_rls_acc(9), lpfc_els_rcv_rls(9), lpfc_els_rcv_rtv(9), lpfc_send_rrq(9), lpfc_els_rsp_rpl_acc(9), lpfc_els_rcv_rpl(9), lpfc_els_rcv_farpr(9), lpfc_els_rcv_fan(9), lpfc_els_rcv_edc(9), lpfc_els_timeout(9), lpfc_els_timeout_handler(9), lpfc_els_flush_cmd(9), lpfc_els_flush_all_cmd(9), lpfc_send_els_failure_event(9), lpfc_send_els_event(9), lpfc_display_fpin_wwpn(9), lpfc_els_rcv_fpin_li(9), lpfc_els_rcv_fpin_del(9), lpfc_els_rcv_fpin_peer_cgn(9), lpfc_els_rcv_fpin_cgn(9), lpfc_els_unsol_buffer(9), lpfc_els_unsol_event(9), lpfc_do_scr_ns_plogi(9), lpfc_cmpl_reg_new_vport(9), lpfc_register_new_vport(9), lpfc_cancel_all_vport_retry_delay_timer(9), lpfc_retry_pport_discovery(9), lpfc_fabric_login_reqd(9), lpfc_cmpl_els_fdisc(9), lpfc_issue_els_fdisc(9), lpfc_cmpl_els_npiv_logo(9), lpfc_issue_els_npiv_logo(9), lpfc_fabric_block_timeout(9), lpfc_resume_fabric_iocbs(9), lpfc_unblock_fabric_iocbs(9), lpfc_block_fabric_iocbs(9), lpfc_cmpl_fabric_iocb(9), lpfc_issue_fabric_iocb(9), lpfc_fabric_abort_vport(9), lpfc_fabric_abort_nport(9), lpfc_fabric_abort_hba(9), lpfc_sli4_vport_delete_els_xri_aborted(9), lpfc_sli4_els_xri_aborted(9).

xoxo, from ./drivers/scsi/lpfc — October 2026. stay slay, bestie 💅✨

📦 where this page comes from