scsi/lpfc/lpfc_els.c

75  * This routine checks whether there is an outstanding host link
150  * This routine is used for allocating a lpfc-IOCB data structure from
152  * passed into the routine for discovery state machine to issue an Extended
154  * and preparation routine that is used by all the discovery state machine
156  * the individual discovery machine routines after calling this routine
337  * This routine issues a fabric registration login for a @vport. An
339  * The routine invokes two mailbox commands to carry out fabric registration
398 	 * for the callback routine.  in lpfc_issue_fabric_reglogin()
433  * This routine issues a REG_VFI mailbox for the vfi, vpi, fcfi triplet for
510  * This routine issues a UNREG_VFI mailbox with the vfi, vpi, fcfi triplet for
555  * This routine is called from FLOGI/FDISC completion handler functions.
609  * This routine is invoked by the lpfc_cmpl_els_flogi() completion callback
614  * the previously assigned Destination ID (DID), the lpfc_unreg_rpi() routine
791  * This routine is invoked by the lpfc_cmpl_els_flogi() completion callback
907  * This routine is the top-level completion callback function for issuing
909  * the lpfc_els_retry() routine shall be invoked to retry the FLOGI. If
920  * point-to-point topology. The routine lpfc_cmpl_els_flogi_fabric() or
1256  * This routine issues a Fabric Login (FLOGI) Request ELS command
1259  * to lpfc_cmpl_els_flogi() routine is put to the IOCB completion callback
1260  * function field. The lpfc_issue_fabric_iocb routine is invoked to send
1450  * This routine aborts all the outstanding Fabric Login (FLOGI) IOCBs
1451  * with a @phba. This routine walks all the outstanding IOCBs on the txcmplq
1509  * This routine issues an initial Fabric Login (FLOGI) for the @vport
1513  * it will just be enabled and made active. The lpfc_issue_els_flogi() routine
1562  * This routine issues an initial Fabric Discover (FDISC) for the @vport
1566  * it will just be enabled and made active. The lpfc_issue_els_fdisc() routine
1611  * This routine checks whether there are more remaining Port Logins
1612  * (PLOGI) to be issued for the @vport. If so, it will invoke the routine
1645  * This routine checks and indicates whether the WWPN of an N_Port, retrieved
1746 	/* At this point in this routine, we know new_ndlp will be  in lpfc_plogi_confirm_nport()
1902  * This routine checks whether more Registration State Change
1904  * the FC_RSCN_MODE. If so, the lpfc_els_handle_rscn() routine will be
1932  * This routine will call the clear rrq function to free the rrq and
1990  * This routine is the completion callback function for issuing the Port
1996  * retry shall be attempted by invoking the lpfc_els_retry() routine.
1997  * Otherwise, the lpfc_plogi_confirm_nport() routine shall be invoked on
2001  * PLOGI. If so, the lpfc_more_plogi() routine is invoked to issue addition
2182  * This routine issues a Port Login (PLOGI) command to a remote N_Port
2185  * This routine constructs the proper fields of the PLOGI IOCB and invokes
2186  * the lpfc_sli_issue_iocb() routine to send out PLOGI ELS command.
2312  * This routine is the completion callback function for a Process Login
2315  * by invoking the lpfc_els_retry() routine. Otherwise, the state
2454  * This routine issues a Process Login (PRLI) ELS command for the
2456  * PRLI Request command and the pointer to lpfc_cmpl_els_prli() routine
2458  * routine lpfc_sli_issue_iocb() to send out PRLI command.
2493 	/* This routine will issue 1 or 2 PRLIs, so zero all the ndlp  in lpfc_issue_els_prli()
2650  * This routine performs Registration State Change Notification (RSCN)
2654  * the lpfc_els_disc_plogi() routine, the lpfc_end_rscn() routine shall be
2704 		 * routine guarantees to call the state machine and  in lpfc_adisc_done()
2741  * This routine determines whether there are more ndlps on a @vport
2743  * invoke the lpfc_els_disc_adisc() routine to issue ADISC on the @vport's
2775  * This routine is the completion function for issuing the Address Discover
2781  * the lpfc_els_retry() routine. Otherwise, if no error was reported in
2896  * This routine issues an Address Discover (ADISC) for an @ndlp on a
2898  * and states of the ndlp, and invokes the lpfc_sli_issue_iocb() routine
2976  * This routine is the completion function for issuing the ELS Logout (LOGO)
3134  * This routine constructs and issues an ELS Logout (LOGO) iocb command
3137  * lpfc_sli_issue_iocb() routine to send out the LOGO ELS command.
3143  * Callers of this routine are expected to unregister the RPI first
3223  * This routine is a generic completion callback function for ELS commands.
3227  * Address Resolution Protocol Response (FARPR) routine, lpfc_issue_els_farpr().
3229  * lpfc_els_chk_latt() routine to check whether link went down during the
3277  * This routine registers the rpi assigned to the fabric controller
3281  * This routine is single out because the fabric controller node
3282  * does not receive a PLOGI.  This routine is consumed by the
3360  * This routine is a generic completion callback function for Discovery ELS cmd.
3484  * This routine issues a State Change Request (SCR) to a fabric node
3489  * routine is invoked to send the SCR IOCB.
3575  * This routine issues a RSCN to the Fabric Controller (DID 0xFFFFFD)
3672  * This routine issues a Fibre Channel Address Resolution Response
3677  * lpfc_sli_issue_iocb() routine is invoked to send the FARPR ELS command.
3754 		 * lpfc_els_free_iocb routine to trigger the release of  in lpfc_issue_els_farpr()
3773  * This routine issues an ELS RDF to the Fabric Controller to register
3861   * functions.  This routine sends LS_ACC and then has the Nx_Port issue a new
3896  * This helper routine determines the least capable setting for
3898  * congestion detection descriptor in the EDC rsp.  The routine
3980  * This routine is the completion callback function for issuing the Exchange
3983  * routine parses the FPort's response and decides on the least common
4201 	/* We are assuming cgd was zero'ed before calling this routine */  in lpfc_format_edc_cgn_desc()
4266   * This routine issues an ELS EDC to the F-Port Controller to communicate
4270   * Note: This routine does not check if one or more signals are
4355 		 * lpfc_els_free_iocb routine to trigger the rlease of  in lpfc_issue_els_edc()
4375  * This routine cancels the timer with a delayed IOCB-command retry for
4427  * This routine is invoked by the ndlp delayed-function timer to check
4431  * lpfc_worker_wake_up() routine to wake up worker thread to process the
4469  * This routine is the worker-thread handler for processing the @ndlp delayed
4470  * event(s), posted by the lpfc_els_retry_delay() routine. It simply retrieves
4541  * This routine performs link reset by sending INIT_LINK mailbox command.
4599  * This routine makes a retry decision on an ELS command IOCB, which has
4788 			 * uses a single routine to issue both PRLI FC4 types.  in lpfc_els_retry()
5088  * This routine releases the lpfc DMA (Direct Memory Access) buffer(s)
5120  * This routine releases the lpfc Direct Memory Access (DMA) buffer
5140  * This routine frees a command IOCB and its associated resources. The
5151  * set, it invokes the lpfc_els_free_data() routine to release the Direct
5155  * lpfc_els_free_bpl() routine is invoked to release the DMA memory
5156  * associated with BPL. Finally, the lpfc_sli_release_iocbq() routine is
5219  * This routine is the completion callback function to the Logout (LOGO)
5220  * Accept (ACC) Response ELS command. This routine is invoked to indicate
5222  * this routine unregisters the RPI if it is still registered. The
5287  * This routine is the completion callback function for unregister default
5332  * This routine is the completion callback function for ELS Response IOCB
5336  * be send out, and then invokes the lpfc_els_free_iocb() routine to release
5502  * This routine prepares and issues an Accept (ACC) response IOCB
5505  * lpfc_sli_issue_iocb() routine to send out ACC response IOCB. If a
5779  * This routine prepares and issue an Reject (RJT) response IOCB
5883   * This routine issues an EDC ACC RSP to the F-Port Controller to communicate
5984  * This routine prepares and issues an Accept (ACC) response to Address
5986  * and invokes the lpfc_sli_issue_iocb() routine to send out the command.
6081  * This routine prepares and issues an Accept (ACC) response to Process
6083  * and invokes the lpfc_sli_issue_iocb() routine to send out the command.
6274  * This routine issues a Request Node Identification Data (RNID) Accept
6276  * the proper @format and then calls the lpfc_sli_issue_iocb() routine to
6519  * This routine issues Address Discover (ADISC) ELS commands to those
6522  * lpfc_issue_els_adisc() routine, the per @vport number of discover count
6585  * This routine issues Port Login (PLOGI) ELS commands to all the N_Ports
6587  * ADISC PLOGI IOCB is issued by invoking the lpfc_issue_els_plogi() routine,
7400  * This routine processes an unsolicited RDP(Read Diagnostic Parameters)
7714  * This routine processes an unsolicited LCB(LINK CABLE BEACON) IOCB.
7805  * This routine cleans up any Registration State Change Notification
7846  * This routine checks whether there is any pending Registration State
7922  * This routine sends recovery (NLP_EVT_DEVICE_RECOVERY) event to the
8012  * This routine processes an unsolicited RSCN (Registration State Change
8014  * to invoke fc_host_post_event() routine to the FC transport layer. If the
8020  * lpfc_rscn_recovery_check() routine is invoked to send recovery event for
8022  * routine is invoked to handle the RSCN event.
8176 				 * routine will not try to free it.  in lpfc_els_rcv_rscn()
8212 	 * If we zero, cmdiocb->cmd_dmabuf, the calling routine will  in lpfc_els_rcv_rscn()
8228  * This routine handles the Registration State Configuration Notification
8233  * issued, the lpfc_els_flush_rscn() routine shall be invoked to clean up any
8314  * This routine processes Fabric Login (FLOGI) IOCB received as an ELS
8318  * lpfc_check_sparm() routine is invoked to check the parameters in the
8319  * unsolicited FLOGI. If parameters validation failed, the routine
8327  * and then the lpfc_els_rsp_acc() routine is invoked to accept the FLOGI.
8500  * This routine processes Request Node Identification Data (RNID) IOCB
8503  * present, this routine will invoke the lpfc_els_rsp_rnid_acc() routine to
8505  * rejected by invoking the lpfc_els_rsp_reject() routine.
8575  * This routine processes a Link Incident Report Registration(LIRR) IOCB
8577  * the lpfc_els_rsp_reject() routine to reject the LIRR IOCB unconditionally.
8603  * This routine processes a Reinstate Recovery Qualifier (RRQ) IOCB
8627  * This routine is the completion callback function for the MBX_READ_LNK_STAT
8632  * collected, and then invokes the lpfc_sli_issue_iocb() routine to send ACC
8736  * This routine processes Read Link Status (RLS) IOCB received as an
8739  * state, it invokes the lpfc_els_rsl_reject() routine to send the reject
8799  * This routine processes Read Timout Value (RTV) IOCB received as an
8802  * state, it invokes the lpfc_els_rsl_reject() routine to send the reject
8978  * This routine will call the lpfc_issue_els_rrq if the rrq is
9007  * This routine issuees an Accept (ACC) Read Port List (RPL) ELS command.
9008  * It is to be called by the lpfc_els_rcv_rpl() routine to accept the RPL.
9098  * This routine processes Read Port List (RPL) IOCB received as an ELS
9101  * invokes the lpfc_els_rsp_reject() routine to send reject response.
9102  * Otherwise, this routine then invokes the lpfc_els_rsp_rpl_acc() routine
9156  * This routine processes Fibre Channel Address Resolution Protocol
9165  * FARP request IOCB Response Flag, the lpfc_issue_els_farpr() routine is
9169  * routine is invoked to log into the remote port first.
9237  * This routine processes Fibre Channel Address Resolution Protocol
9239  * invokes the lpfc_els_rsp_acc() routine to the remote node to accept
9268  * This routine processes a Fabric Address Notification (FAN) IOCB
9273  * different, the lpfc_initial_flogi() routine is invoked to initialize
9275  * if both of those are identical, the lpfc_issue_fabric_reglogin() routine
9453  * This routine is invoked by the ELS timer after timeout. It posts the ELS
9455  * event bitmap and then invokes the lpfc_worker_wake_up() routine to wake
9456  * up the worker thread. It is for the worker thread to invoke the routine
9483  * This routine is the actual handler function that processes an ELS timeout
9486  * invoking the lpfc_sli_issue_abort_iotag() routine.
9594  * This routine is used to clean up all the outstanding ELS commands on a
9596  * routine. After that, it walks the ELS transmit queue to remove all the
9606  * lpfc_sli_issue_abort_iotag() routine. Note that this function issues the
9666 			 * change the compl routine to just clean up the iocb  in lpfc_els_flush_cmd()
9755  * This routine is used to clean up all the outstanding ELS commands on a
9757  * routine. After that, it walks the ELS transmit queue to remove all the
9766  * out to HBA by invoking the lpfc_sli_issue_abort_iotag() routine.
9951  * This routine is called by LI and PC descriptors.
10117  * could be an Alarm or Warning.  This routine feeds that data into driver's
10338  * This routine is used for processing the IOCB associated with a unsolicited
10342  * IOCB is then used to invoke the proper routine and to set up proper state
10821  * This routine is used to process an unsolicited event received from a SLI
10823  * associated with the unsolicited event is done by invoking the routine
10948  * This routine issues a Port Login (PLOGI) to the Name Server with
10949  * State Change Request (SCR) for a @vport. This routine will create an
10952  * lpfc_issue_els_plogi() routine. If Fabric-Device Management Interface
10954  * the PLOGI to FDMI is issued by invoking lpfc_issue_els_plogi() routine.
11012  * This routine is the completion callback function to register new vport
11130  * This routine registers the @vport as a new virtual port with a HBA.
11179  * This routine cancels the retry delay timers to all the vports.
11211  * This routine abort all pending discovery commands and
11243  * This routine checks if a FLOGI is reguired for FDISC
11267  * This routine is the completion callback function to a Fabric Discover
11277  * routine is invoked to register new vport with the HBA. Otherwise, the
11278  * lpfc_do_scr_ns_plogi() routine is invoked to issue a PLOGI to the Name
11421  * This routine prepares and issues a Fabric Discover (FDISC) IOCB to
11423  * routine to issue the IOCB, which makes sure only one outstanding fabric
11531  * This routine is the completion callback function to the issuing of a LOGO
11535  * lpfc_els_free_iocb() routine decrements the ndlp reference held for this
11601  * This routine issues a LOGO ELS command to an @ndlp off a @vport.
11668  * This routine is invoked by the fabric iocb block timer after
11671  * lpfc_worker_wake_up() routine to wake up the worker thread. It is for
11697  * This routine issues one fabric iocb from the driver internal list to
11701  * lpfc_sli_issue_iocb() routine to send the fabric iocb to the HBA.
11751  * This routine unblocks the  issuing fabric iocb command. The function
11752  * will clear the fabric iocb block bit and then invoke the routine
11769  * This routine blocks the issuing fabric iocb for a specified amount of
11794  * This routine is the callback function that is put to the fabric iocb's
11798  * and then invokes the lpfc_resume_fabric_iocbs() routine to issue the next
11851  * This routine is used as the top-level API for issuing a fabric iocb command
11863  * such, it is possible a fabric IOCB issued by this routine might be "jump"
11917  * This routine aborts all the IOCBs associated with a @vport from the
11950  * This routine aborts all the IOCBs associated with an @ndlp from the
11988  * This routine aborts all the IOCBs currently on the driver internal
12012  * This routine is invoked by the vport cleanup for deletions and the cleanup
12053  * This routine is invoked by the worker thread to process a SLI4 slow-path
12117  * The driver calls this routine in response to an SLI4 XRI ABORT CQE