scsi/lpfc/lpfc_init.c

111  * This routine will do LPFC initialization prior to issuing the CONFIG_PORT
407  * This routine will do LPFC initialization after the CONFIG_PORT mailbox
728  * This routine will issue the INIT_LINK mailbox command call.
749  * This routine will issue the INIT_LINK mailbox command call.
830  * lpfc_hba_down_link - this routine downs the FC link
834  * This routine will issue the DOWN_LINK mailbox command call.
877  * This routine will do LPFC uninitialization before the HBA is reset when
915  * This routine will cleanup completed slow path events after HBA is reset
957  * This routine will cleanup posted ELS buffers after the HBA is reset
1000  * This routine will cleanup the txcmplq after the HBA is reset when bringing
1057  * This routine will do uninitialization after the HBA is reset when bring
1076  * This routine will do uninitialization after the HBA is reset when bring
1164  * lpfc_hba_down_post - Wrapper func for hba down post routine
1167  * This routine wraps the actual SLI3 or SLI4 routine for performing
1188  * handler routine, lpfc_hb_timeout_handler. Any periodical operations will
1222  * handler routine, lpfc_rrq_handler. Any periodical operations will
1277  * This routine tracks per-eq idle_stat and determines polling decisions.
1415  * For each heartbeat, this routine does some heuristic methods to adjust
1442  * If a HB mbox is not already in progrees, this routine will allocate
1481  * If lpfc_enable_hba_heartbeat is set, the timeout routine will always
1625  * This routine is called to bring the HBA offline when HBA hardware error
1654  * This routine is called to bring a SLI4 HBA offline when HBA hardware error
1680  * This routine is invoked to handle the deferred HBA hardware error
1770  * This routine is invoked to handle the following HBA hardware error
1896  * This routine is invoked to perform an SLI4 port PCI function reset in
1974  * This routine is invoked to handle the SLI4 HBA hardware error attention
2162  * This routine wraps the actual SLI3 or SLI4 hba error attention handling
2163  * routine from the API jump table function pointer from the lpfc_hba struct.
2179  * This routine is invoked from the worker thread to handle a HBA host
2352  * This routine parses the Vital Product Data (VPD). The VPD is treated as
2353  * an array of characters. In this routine, the ModelName, ProgramType, and
2420  * This routine retrieves HBA's description based on its registered PCI device
2504  * This routine retrieves HBA's description based on its registered PCI device
2775  * This routine posts a given number of IOCBs with the associated DMA buffer
2875  * This routine posts initial receive IOCB buffers to the ELS ring. The
2900  * This routine sets up the initial values to the array of hash table entries
2918  * This routine iterates an initial hash table pointed by @HashResultPointer
2975  * This routine calculates the working hash array referred by @HashWorking
2991  * This routine performs the special handling for LC HBA initialization.
3019  * This routine performs the necessary cleanups before deleting the @vport.
3114  * This routine stops all the timers associated with a @vport. This function
3131  * This routine stops the SLI4 FCF rediscover wait timer if it's on. The
3132  * caller of this routine should already hold the host lock.
3148  * This routine stops the SLI4 FCF rediscover wait timer if it's on. It
3293  * This routine stops all the timers associated with a HBA. This function is
3337  * This routine marks a HBA's management interface as blocked. Once the HBA's
3431  * This routine moves a batch of XRIs from lpfc_io_buf_list_put of HWQ 0
3466  * This routine returns XRIs from expedite pool to lpfc_io_buf_list_put
3498  * This routine initialize public, private per HWQ. Then, move XRIs from
3587  * This routine returns XRIs from public/private to lpfc_io_buf_list_put.
3670  * This routine initializes the HBA and brings a HBA online. During this
3759  * This routine marks a HBA's management interface as not blocked. Once the
3781  * This routine is invoked to prepare a HBA to be brought offline. It performs
3889  * This routine actually brings a HBA offline. It stops all the timers
3949  * This routine is to free all the SCSI buffers and IOCBs from the driver
3993  * This routine is to free all the IO buffers and IOCBs from the driver
4045  * This routine first calculates the sizes of the current els and allocated
4163  * This routine first calculates the sizes of the current els and allocated
4383  * This routine first calculates the sizes of the current els and allocated
4467  * This routine allocates nvme buffers for device with SLI-4 interface spec,
4631  * This routine allocated the resources needed for the VMID.
4681  * This routine creates a FC port for the upper layer protocol. The FC port
4683  * by the HBA. This routine also allocates a SCSI host data structure (shost)
4875  * This routine destroys a FC port from the upper layer protocol. All the
4899  * This routine allocates a unique integer ID from lpfc_hba_index pool. It
4920  * This routine is called by the SCSI layer with a SCSI host to determine
5014  * This routine initializes a given SCSI host attributes on a FC port. The
5059  * This routine is invoked to stop an SLI3 device port, it stops the device
5082  * This routine is invoked to stop an SLI4 device port, it stops the device
5100  * This routine wraps the actual SLI3 or SLI4 hba stop port routine from
5116  * This routine starts the timer waiting for the FCF rediscovery to complete.
5137  * This routine is invoked when waiting for FCF table rediscover has been
5169  * This routine is invoked when there is no I/O on by a VM for the specified
5206  * This routine is to parse the SLI4 link-attention link fault code.
5240  * This routine is to parse the SLI4 link attention type and translate it
5277  * This routine is to get an SLI3 FC port's link speed in Mbps.
5328  * This routine is to parse the giving SLI4 async event link speed code into
5423  * This routine is to handle the SLI4 asynchronous FCoE link event.
5507 	 * the READ_TOPOLOGY completion routine to continue without actually  in lpfc_sli4_async_link_evt()
5547  * This routine is to parse the giving SLI4 async event link speed code into
5716 	/* We should get to this point in the routine on 1 minute intervals */  in lpfc_cmf_stats_timer()
5923  * The routine calculates the latency from the beginning of the CMF timer
5935 	/* This routine works on a ms granularity so sec and usec are  in lpfc_calc_cmf_latency()
5992 	/* Do not block SCSI IO while in the timer routine since  in lpfc_cmf_timer()
6227  * This routine is to handle the SLI4 asynchronous FC event. It will simply log
6413  * This routine is to handle the SLI4 asynchronous SLI events.
6669  * This routine is to perform Clear Virtual Link (CVL) on a vport in
6719  * This routine is to perform Clear Virtual Link (CVL) on all vports in
6740  * This routine is to handle the SLI4 asynchronous fcoe event.
6989  * This routine is to handle the SLI4 asynchronous dcbx event.
7006  * This routine is to handle the SLI4 asynchronous grp5 event. A grp5 event
7031  * This routine is to handle the SLI4 asynchronous cmstat event. A cmstat event
7047  * This routine validates the congestion parameters passed
7078  * This routine validates the congestion management buffer signature
7120 		 * by this routine.  No need to fail.  in lpfc_cgn_params_parse()
7218  * This routine issues a read_object mailbox command to
7274  * The FW generated Async ACQE SLI event calls this routine when
7278  * This routine executes a Read_Object mailbox call to obtain the
7319  * This routine is invoked by the worker thread to process all the pending
7381  * This routine is invoked by the worker thread to process FCF table
7412  * This routine is invoked to set up the per HBA PCI-Device group function
7454  * This routine it invoked to log the currently used active interrupt mode
7484  * This routine is invoked to enable the PCI device that is common to all
7530  * This routine is invoked to disable the PCI device that is common to all
7554  * This routine is invoked to reset a hba device. It brings the HBA
7672  * This routine is invoked to set up the driver internal resources before the
7753  * This routine is invoked to set up the driver internal resources specific to
7903  * This routine is invoked to unset the driver internal resources set up
7919  * This routine is invoked to set up the driver internal resources specific to
8509  * This routine is invoked to unset the driver internal resources set up
8574  * This routine sets up the device INIT interface API function jump table
8609  * This routine is invoked to set up the driver internal resources after the
8636  * This routine is invoked to unset the driver internal resources set up after
8657  * This routine is invoked to free the driver's IOCB list and memory.
8681  * This routine is invoked to allocate and initizlize the driver's IOCB
8735  * This routine is invoked to free a give sgl list and memory.
8753  * This routine is invoked to free the driver's els sgl list and memory.
8773  * This routine is invoked to free the driver's nvmet sgl list and memory.
8806  * This routine is invoked to allocate the driver's active sgl memory.
8827  * This routine is invoked to walk through the array of active sglq entries
8841  * This routine is invoked to allocate and initizlize the driver's sgl
8865  * This routine is invoked to post rpi header templates to the
8866  * port for those SLI4 ports that do not support extents.  This routine
8868  * PAGE_SIZE modulo 64 rpi context headers.  This is an initialization routine
8902  * This routine is invoked to allocate a single 4KB memory region to
8995  * This routine is invoked to remove all memory resources allocated
8996  * to support rpis for SLI4 ports not supporting extents. This routine
9025  * This routine is invoked to allocate the driver hba data structure for an
9066  * This routine is invoked to free the driver hba data structure with an
9090  * This routine is will setup initial FDMI attribute masks for
9120  * This routine is invoked to create HBA physical port and associate a SCSI
9172  * This routine is invoked to destroy HBA physical port and the associated
9191  * This routine sets up the local Block guard protocol settings for @shost.
9192  * This routine also allocates memory for debugging bg buffers.
9242  * This routine is invoked to perform all the necessary post initialization
9285  * This routine is invoked to set up the PCI device memory space for device
9393  * This routine is invoked to unset the PCI device memory space for device
9424  * This routine is invoked to wait for SLI4 device Power On Self Test (POST)
9571  * This routine is invoked to set up SLI4 BAR0 PCI config space register
9661  * This routine is invoked to set up SLI4 BAR1 register memory map.
9705  * This routine is invoked to set up SLI4 BAR2 doorbell register memory map
9737  * This routine is invoked to create the bootstrap mailbox
9739  * routine allocates all memory necessary to communicate
9742  * this routine.
9812  * This routine is invoked to teardown the bootstrap mailbox
9813  * region and release all host resources. This routine requires
9816  * before calling this routine.
9849  * This routine is invoked to map the topology values as read
9912  * This routine is invoked to read the configuration parameters from the HBA.
10277  * This routine is invoked to setup the port-side endian order when
10278  * the port if_type is 0.  This routine has no function for other
10336  * This routine is invoked to check the user settable queue counts for EQs.
10337  * After this routine is called the counts will be set to valid values that
10435  * This routine is invoked to allocate all the SLI4 queues for the FCoE HBA
10879  * This routine is invoked to release all the SLI4 queues with the FCoE HBA
11045  * This routine will populate the cq_lookup table by all
11077  * This routine is invoked to set up all the SLI4 queues for the FCoE HBA
11437  * This routine is invoked to unset all the SLI4 queues with the FCoE HBA
11525  * This routine is invoked to allocate and set up a pool of completion queue
11527  * CQE. For now, this pool is used for the interrupt service routine to queue
11561  * This routine is invoked to free the pool of completion queue events at
11563  * cleanup routine to free all the outstanding completion-queue events
11564  * allocated from this pool back into the pool before invoking this routine
11583  * This routine is the lock free version of the API invoked to allocate a
11603  * This routine is the lock version of the API invoked to allocate a
11626  * This routine is the lock free version of the API invoked to release a
11641  * This routine is the lock version of the API invoked to release a
11658  * This routine is to free all the pending completion-queue events to the
11693  * This routine is invoked to request a PCI function reset. It will destroys
11828  * This routine is invoked to set up the PCI device memory space for device
12049  * This routine is invoked to unset the PCI device memory space for device
12087  * This routine is invoked to enable the MSI-X interrupt vectors to device
12188  * This routine is invoked to enable the MSI interrupt mode to device with
12228  * This routine is invoked to enable device interrupt and associate driver's
12289  * This routine is invoked to disable device interrupt and disassociate the
12381  * The routine assigns eq info into vector_map structure
12402  * The routine initializes the cpu_map array structure
12428  * The routine initializes the hba_eq_hdl array structure
12448  * The routine will figure out the CPU affinity assignment for every
12983  * This routine is invoked to enable the MSI-X interrupt vectors to device
13153  * This routine is invoked to enable the MSI interrupt mode to device with
13216  * This routine is invoked to enable device interrupt and associate driver's
13296  * This routine is invoked to disable device interrupt and disassociate
13330  * This routine is invoked to unset the HBA device initialization steps to
13452  * function. The caller is not required to hold any lock. This routine
13569  * The routine corresponds with the algorithm the HBA firmware
13742  * for the completion.  The expectation is that this routine is called
13743  * typically from probe_one or from the online routine.
13942  * This routine is to be called to attach a device with SLI-3 interface spec
13947  * invokes this routine. If this routine determines it can claim the HBA, it
14109  * This routine is to be called to disattach a device with SLI-3 interface
14206  * This routine is to be called from the kernel's PCI subsystem to support
14246  * This routine is to be called from the kernel's PCI subsystem to support
14310  * This routine is called to prepare the SLI3 device for PCI slot recover. It
14330  * This routine is called to prepare the SLI3 device for PCI slot reset. It
14361  * This routine is called to prepare the SLI3 device for PCI slot permanently
14386  * This routine is called from the PCI subsystem for I/O error handling to
14431  * This routine is called from the PCI subsystem for error handling to
14436  * recovery and then call this routine before calling the .resume method
14500  * This routine is called from the PCI subsystem for error handling to device
14723  * This routine is called to perform Linux generic firmware upgrade on device
14761  * This routine is called from the kernel's PCI subsystem to device with
14766  * core invokes this routine. If this routine determines it can claim the HBA,
14952  * This routine is called from the kernel's PCI subsystem to device with
15037  * This routine is called from the kernel's PCI subsystem to support system
15078  * This routine is called from the kernel's PCI subsystem to support system
15138  * This routine is called to prepare the SLI4 device for PCI slot recover. It
15157  * This routine is called to prepare the SLI4 device for PCI slot reset. It
15193  * This routine is called to prepare the SLI4 device for PCI slot permanently
15218  * This routine is called from the PCI subsystem for error handling to device
15272  * This routine is called from the PCI subsystem for error handling to device
15277  * recovery and then call this routine before calling the .resume method to
15344  * This routine is called from the PCI subsystem for error handling to device
15375  * This routine is to be registered to the kernel's PCI subsystem. When an
15379  * successful, the driver core invokes this routine. This routine dispatches
15380  * the action to the proper SLI-3 or SLI-4 device probing routine, which will
15410  * This routine is to be registered to the kernel's PCI subsystem. When an
15411  * Emulex HBA is removed from PCI bus, the driver core invokes this routine.
15412  * This routine dispatches the action to the proper SLI-3 or SLI-4 device
15413  * remove routine, which will perform all the necessary cleanup for the
15442  * This routine is to be registered to the kernel's PCI subsystem to support
15444  * the action to the proper SLI-3 or SLI-4 device suspend routine, which will
15478  * This routine is to be registered to the kernel's PCI subsystem to support
15480  * the action to the proper SLI-3 or SLI-4 device resume routine, which will
15515  * This routine is registered to the PCI subsystem for error handling. This
15517  * this device has been detected. When this routine is invoked, it dispatches
15519  * routine, which will perform the proper error detected operation.
15556  * This routine is registered to the PCI subsystem for error handling. This
15558  * from scratch, as if from a cold-boot. When this routine is invoked, it
15560  * routine, which will perform the proper device reset.
15593  * This routine is registered to the PCI subsystem for error handling. It
15596  * this routine is invoked, it dispatches the action to the proper SLI-3
15597  * or SLI-4 device io_resume routine, which will resume the device operation.
15625  * This routine checks to see if OAS is supported for this adapter. If
15653  * This routine checks to see if RAS is supported by the adapter. Check the
15709  * lpfc_init - lpfc module initialization routine
15711  * This routine is to be invoked when the lpfc module is loaded into the
15713  * role of this routine to the kernel as lpfc module entry point.
15858  * lpfc_exit - lpfc module removal routine
15860  * This routine is invoked when the lpfc module is removed from the kernel.
15862  * this routine to the kernel as lpfc module exit point.