17  * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT, ARE      *
20  * more details, a copy of which can be found in the file COPYING  *
68 /* Used when mapping IRQ vectors in a driver centric manner */
256 		/* dump mem may return a zero when finished or we got a  in lpfc_config_port_prep()
307  * into a human readable string and store it in OptionROMVersion.
328 	/* Decode the Option rom version word to a readable string */  in lpfc_dump_wakeup_param_cmpl()
356 	 * If the name is empty or there exists a soft name  in lpfc_update_vport_wwn()
730  * structure for use as a delayed link up mechanism with the
751  * structure for use as a delayed link up mechanism with the
1185  * this timer fires, a HBA timeout event shall be posted to the lpfc driver
1219  * this timer fires, a RRQ timeout event shall be posted to the lpfc driver
1315 		 * From there, the idle time stat can be calculated as a  in lpfc_idle_stat_delay_work()
1442  * If a HB mbox is not already in progrees, this routine will allocate
1443  * a LPFC_MBOXQ_t, populate it with a MBX_HEARTBEAT (0x31) command,
1452 	/* Is a Heartbeat mbox already in progress */  in lpfc_issue_hb_mbox()
1479  * flag is set, it will force a MBX_HEARTBEAT mbox command, regardless
1482  * try to issue a MBX_HEARTBEAT mbox command.
1503  * is configured and there is no heart-beat mailbox command outstanding, a
1505  * has been a heart-beat mailbox command outstanding, the HBA shall be put
1553 	/* If there is no heart beat outstanding, issue a heartbeat command */  in lpfc_hb_timeout_handler()
1555 		/* If IOs are completing, no need to issue a MBX_HEARTBEAT */  in lpfc_hb_timeout_handler()
1569 		/* Check if a MBX_HEARTBEAT is already in progress */  in lpfc_hb_timeout_handler()
1573 			 * we need to give the hb mailbox cmd a chance to  in lpfc_hb_timeout_handler()
1606 		/* Check to see if we want to force a MBX_HEARTBEAT */  in lpfc_hb_timeout_handler()
1654  * This routine is called to bring a SLI4 HBA offline when HBA hardware error
1718 	 * There was a firmware error. Take the hba offline and then  in lpfc_handle_deferred_eratt()
1739 	 * This is to ptrotect against a race condition in which  in lpfc_handle_deferred_eratt()
1833 		 * There was a firmware error.  Take the hba offline and then  in lpfc_handle_eratt_s3()
1871 		 * failure is a value other than FFER6. Do not call the offline  in lpfc_handle_eratt_s3()
2180  * This routine is invoked from the worker thread to handle a HBA host
2518 	int oneConnect = 0; /* default is not a oneConnect */  in lpfc_get_hba_model_desc()
2771  * lpfc_sli3_post_buffer - Post IOCB(s) with DMA buffer descriptor(s) to a IOCB ring
2773  * @pring: pointer to a IOCB ring.
2776  * This routine posts a given number of IOCBs with the associated DMA buffer
2929 	uint32_t A, B, C, D, E;  in lpfc_sha_iterate()  local
2939 	A = HashResultPointer[0];  in lpfc_sha_iterate()
2955 		TEMP += S(5, A) + E + HashWorkingPointer[t];  in lpfc_sha_iterate()
2959 		B = A;  in lpfc_sha_iterate()
2960 		A = TEMP;  in lpfc_sha_iterate()
2963 	HashResultPointer[0] += A;  in lpfc_sha_iterate()
3017  * lpfc_cleanup - Performs vport cleanups before deleting a vport
3018  * @vport: pointer to a virtual N_Port data structure.
3066 	/* This is a special case flush to return all  in lpfc_cleanup()
3068 	 * two points in the code where a flush is  in lpfc_cleanup()
3071 	 * (this prevents a crash) and the other is  in lpfc_cleanup()
3073 	 * a crash). Both of these exceptions are  in lpfc_cleanup()
3113  * lpfc_stop_vport_timers - Stop all the timers associated with a vport
3114  * @vport: pointer to a virtual N_Port data structure.
3116  * This routine stops all the timers associated with a @vport. This function
3117  * is invoked before disabling or deleting a @vport. Note that the physical
3231 	/* This is a signal to firmware to sync up CMF BW with link speed */  in lpfc_cmf_signal_init()
3295  * This routine stops all the timers associated with a HBA. This function is
3296  * invoked before either putting a HBA offline or unloading the driver.
3335  * lpfc_block_mgmt_io - Mark a HBA's management interface as blocked
3339  * This routine marks a HBA's management interface as blocked. Once the HBA's
3416 						 "0099 RPI alloc error for "  in lpfc_sli4_node_rpi_restore()
3439  * This routine moves a batch of XRIs from lpfc_io_buf_list_put of HWQ 0
3675  * lpfc_online - Initialize and bring a HBA online
3678  * This routine initializes the HBA and brings a HBA online. During this
3764  * lpfc_unblock_mgmt_io - Mark a HBA's management interface to be not blocked
3767  * This routine marks a HBA's management interface as not blocked. Once the
3785  * lpfc_offline_prep - Prepare a HBA to be brought offline
3789  * This routine is invoked to prepare a HBA to be brought offline. It performs
3871  * lpfc_offline - Bring a HBA offline
3874  * This routine actually brings a HBA offline. It stops all the timers
4299 	 * This is because POST_SGL takes a sequential range of XRIs  in lpfc_io_buf_flush()
4455  * them on a list, it post them to the port by using SGL block post.
4459  *   0 = failure, less than num_to_alloc is a partial failure.
4545 		/* add the nvme buffer to a post list */  in lpfc_new_io_buf()
4663  * @instance: a unique integer ID to this FC port.
4666  * This routine creates a FC port for the upper layer protocol. The FC port
4667  * can be created on top of either a physical port or a virtual port provided
4668  * by the HBA. This routine also allocates a SCSI host data structure (shost)
4719 				/* template is for a no reset SCSI Host */  in lpfc_create_port()
4792 		/* SLI-3 has a limited number of hardware queues (3),  in lpfc_create_port()
4860  * This routine destroys a FC port from the upper layer protocol. All the
4882  * lpfc_get_instance - Get a unique integer ID
4884  * This routine allocates a unique integer ID from lpfc_hba_index pool. It
4888  *   instance - a unique integer ID allocated as the new instance.
4905  * This routine is called by the SCSI layer with a SCSI host to determine
4996  * lpfc_host_attrib_init - Initialize SCSI host attributes on a FC port
4999  * This routine initializes a given SCSI host attributes on a FC port. The
5000  * SCSI host can be either on top of a physical port or a virtual port.
5124  * wait period, a new FCF event shall be added to the FCOE async event
5154  * This routine is invoked when there is no I/O on by a VM for the specified
5165 	/* check if there is a need to issue QFPA */  in lpfc_vmid_poll()
5603 	/* Make sure we have a congestion info buffer */  in lpfc_cgn_update_stat()
5692 	/* Make sure we have a congestion info buffer */  in lpfc_cmf_stats_timer()
5846 		 * Collapse all hours into a day. Rotate days  in lpfc_cmf_stats_timer()
5920 	/* This routine works on a ms granularity so sec and usec are  in lpfc_calc_cmf_latency()
6027 		 * a full LPFC_CMF_INTERVAL.  in lpfc_cmf_timer()
6213  * that the event was received and then issue a read_topology mailbox command so
6535 			/* firmware is reporting a status we don't know about */  in lpfc_sli4_async_sli_evt()
6582 		 * Event Data1 - N.A, Event Data2 - N.A  in lpfc_sli4_async_sli_evt()
6629 		/* May be accompanied by a temperature event */  in lpfc_sli4_async_sli_evt()
6651  * lpfc_sli4_perform_vport_cvl - Perform clear virtual link on a vport
6654  * This routine is to perform Clear Virtual Link (CVL) on a vport in
6655  * response to a CVL event.
6674 		/* Cannot find existing Fabric ndlp, so allocate a new one */  in lpfc_sli4_perform_vport_cvl()
6705  * response to a FCF dead event.
6834 		 * table for a fast recovery from case that the current FCF  in lpfc_sli4_async_fip_evt()
6859 			 * as a link down to FCF registration.  in lpfc_sli4_async_fip_evt()
6866 			 * Handling fast FCF failover to a DEAD FCF event is  in lpfc_sli4_async_fip_evt()
6919 			 * the entire FCF table for a fast recovery  in lpfc_sli4_async_fip_evt()
6989  * This routine is to handle the SLI4 asynchronous grp5 event. A grp5 event
6990  * is an asynchronous notified of a logical link speed change.  The Port
7014  * This routine is to handle the SLI4 asynchronous cmstat event. A cmstat event
7015  * is an asynchronous notification of a request to reset CM stats.
7056  * lpfc_cgn_params_parse - Process a FW cong parm change event
7058  * @p_cgn_param: pointer to a data buffer with the FW cong params.
7201  * This routine issues a read_object mailbox command to
7218 	/* Find out if the FW has a new set of congestion parameters. */  in lpfc_sli4_cgn_params_read()
7226 	/* 0 means no data.  A negative means error.  A positive means  in lpfc_sli4_cgn_params_read()
7254  * lpfc_sli4_cgn_parm_chg_evt - Process a FW congestion param change event
7259  * indicates a change to the FW maintained congestion parameters.
7261  * This routine executes a Read_Object mailbox call to obtain the
7282 	/* If the event is claiming an empty object, it's ok.  A write  in lpfc_sli4_cgn_parm_chg_evt()
7283 	 * could have cleared it.  Only error is a negative return  in lpfc_sli4_cgn_parm_chg_evt()
7464  * lpfc_enable_pci_dev - Enable a generic PCI device.
7510  * lpfc_disable_pci_dev - Disable a generic PCI device.
7534  * lpfc_reset_hba - Reset a hba
7537  * This routine is invoked to reset a hba device. It brings the HBA
7538  * offline, performs a board restart, and then brings the board back
7558 			/* Perform a PCI function reset to start from clean */  in lpfc_reset_hba()
7582  * This function enables the PCI SR-IOV virtual functions to a physical
7604  * lpfc_sli_probe_sriov_nr_virtfn - Enable a number of sr-iov virtual functions
7608  * This function enables the PCI SR-IOV virtual functions to a physical
7787 		 * The scsi_buf for a T10-DIF I/O will hold the FCP cmnd,  in lpfc_sli_driver_resource_setup()
7788 		 * the FCP rsp, and a BDE for each. Sice we have no control  in lpfc_sli_driver_resource_setup()
7806 		 * The scsi_buf for a regular I/O will hold the FCP cmnd,  in lpfc_sli_driver_resource_setup()
7807 		 * the FCP rsp, a BDE for each, and a BDE for up to  in lpfc_sli_driver_resource_setup()
7982 	 * we will associate a new ring, for each EQ/CQ/WQ tuple.  in lpfc_sli4_driver_resource_setup()
8080 		 * firmware will try FLOGI before the driver gets a link up.  in lpfc_sli4_driver_resource_setup()
8081 		 * If it fails, the driver should get a MISCONFIGURED async  in lpfc_sli4_driver_resource_setup()
8144 				phba->nvmet_support = 1; /* a match */  in lpfc_sli4_driver_resource_setup()
8227 		 * The scsi_buf for a T10-DIF I/O holds the FCP cmnd,  in lpfc_sli4_driver_resource_setup()
8228 		 * the FCP rsp, and a SGE. Sice we have no control  in lpfc_sli4_driver_resource_setup()
8253 		 * The scsi_buf for a regular I/O holds the FCP cmnd,  in lpfc_sli4_driver_resource_setup()
8254 		 * the FCP rsp, a SGE for each, and a SGE for up to  in lpfc_sli4_driver_resource_setup()
8714  * lpfc_free_sgl_list - Free a given sgl list.
8718  * This routine is invoked to free a give sgl list and memory.
8812  * This is just a place holder for now.
8850  * posts a PAGE_SIZE memory region to the port to hold up to
8885  * This routine is invoked to allocate a single 4KB memory region to
8891  *   A valid rpi hdr on success.
8892  *   A NULL pointer on any failure.
8917 	 * rpi is normalized to a zero base because the physical rpi is  in lpfc_sli4_create_rpi_hdr()
8929 	 * port expects a 4KB DMA-mapped memory region that is 4K aligned.  in lpfc_sli4_create_rpi_hdr()
9005  * lpfc_hba_alloc - Allocate driver hba data structure for a device.
9046  * lpfc_hba_free - Free driver hba data structure with a device.
9103  * This routine is invoked to create HBA physical port and associate a SCSI
9304 	/* Map HBA SLIM to a kernel virtual address. */  in lpfc_sli_pci_mem_setup()
9312 	/* Map HBA Control Registers to a kernel virtual address. */  in lpfc_sli_pci_mem_setup()
9430 			/* Port has a fatal POST error, break out */  in lpfc_sli4_post_status_check()
9441 	 * If there was a port error during POST, then don't proceed with  in lpfc_sli4_post_status_check()
9774 	 * as two 30-bit addresses.  The other data is a bit marking whether  in lpfc_create_bootstrap_mbox()
10531 		/* Get a ptr to the Hardware Queue associated with this CPU */  in lpfc_sli4_queue_create()
11505  * This routine is invoked to allocate and set up a pool of completion queue
11506  * events. The body of the completion queue event is a completion queue entry
11560  * __lpfc_sli4_cq_event_alloc - Allocate a completion-queue event from free pool
11563  * This routine is the lock free version of the API invoked to allocate a
11580  * lpfc_sli4_cq_event_alloc - Allocate a completion-queue event from free pool
11583  * This routine is the lock version of the API invoked to allocate a
11602  * __lpfc_sli4_cq_event_release - Release a completion-queue event to free pool
11606  * This routine is the lock free version of the API invoked to release a
11617  * lpfc_sli4_cq_event_release - Release a completion-queue event to free pool
11621  * This routine is the lock version of the API invoked to release a
11673  * This routine is invoked to request a PCI function reset. It will destroys
11793 	/* Catch the not-ready port failure after a port reset. */  in lpfc_pci_function_reset()
11864 		 * Map SLI4 PCI Config Space Register base to a kernel virtual  in lpfc_sli4_pci_mem_setup()
11900 			 * Map SLI4 if type 0 HBA Control Register base to a  in lpfc_sli4_pci_mem_setup()
11928 		 * Map SLI4 if type 6 HBA Doorbell Register base to a kernel  in lpfc_sli4_pci_mem_setup()
11949 			 * a kernel virtual address and setup the registers.  in lpfc_sli4_pci_mem_setup()
11978 		 * Map SLI4 if type 6 HBA DPP Register base to a kernel  in lpfc_sli4_pci_mem_setup()
12171  * request_irq() to register MSI vector with a interrupt the handler, which
12482 	 * entries to a IRQ on the same phys_id.  in lpfc_cpu_affinity_check()
12495 			/* If so, find a new_cpup that is on the SAME  in lpfc_cpu_affinity_check()
12512 			/* We found a matching phys_id, so copy the IRQ info */  in lpfc_cpu_affinity_check()
12530 	/* Set any unassigned cpu map entries to a IRQ on any phys_id */  in lpfc_cpu_affinity_check()
12541 			/* If so, find a new_cpup thats on ANY phys_id  in lpfc_cpu_affinity_check()
12585 		/* Only FIRST IRQs get a hdwq index assignment. */  in lpfc_cpu_affinity_check()
12589 		/* 1 to 1, the first LPFC_CPU_FIRST_IRQ cpus to a unique hdwq */  in lpfc_cpu_affinity_check()
12598 	/* Associate a hdwq with each cpu_map entry  in lpfc_cpu_affinity_check()
12626 		/* Not a First CPU and all hdw_queues are used.  Reuse a  in lpfc_cpu_affinity_check()
12643 		 * settle for just a phys_id match.  in lpfc_cpu_affinity_check()
12672 	 * a cpu is hot-added. Perform a simple hdwq round robin assignment.  in lpfc_cpu_affinity_check()
12879 		/* Found a valid CPU */  in lpfc_irq_rebalance()
12969  * allocated without requesting OS affinity mapping.  A vector will be
13056 			/* If found a neighboring online cpu, set affinity */  in lpfc_sli4_enable_msix()
13089 				 * each vector receives a place in cpu_map.  in lpfc_sli4_enable_msix()
13136  * calling the request_irq() to register MSI vector with a interrupt the
13311  * a device with SLI-3 interface spec.
13836 	 * accommodate 512K and 1M IOs in a single nvme buf.  in lpfc_get_sli4_parameters()
13924  * This routine is to be called to attach a device with SLI-3 interface spec
14017 		/* Put device to a known state before enabling interrupt */  in lpfc_pci_probe_one_s3()
14091  * This routine is to be called to disattach a device with SLI-3 interface
14193  * minimum PM requirements to a power-aware driver's PM support for the
14232  * driver implements the minimum PM requirements to a power-aware driver's
14370  * subsystem after a PCI bus error affecting this device has been detected.
14415  * reset to restart the PCI card from scratch, as if from a cold-boot.
14435 	dev_printk(KERN_INFO, &pdev->dev, "recovering from a slot reset.\n");  in lpfc_io_slot_reset_s3()
14577 				"by a system configuration setting on "  in lpfc_log_write_firmware_error()
14596  * lpfc_write_firmware - attempt to write a firmware image to the port
14816 	/* Put device to a known state before enabling interrupt */  in lpfc_pci_probe_one_s4()
14878 	 * FC4 type making a check for nvme_support unnecessary.  in lpfc_pci_probe_one_s4()
15024  * requirements to a power-aware driver's PM support for suspend/resume -- all
15064  * implements the minimum PM requirements to a power-aware driver's PM for
15202  * after a PCI bus error affecting this device has been detected. When this
15256  * restart the PCI card from scratch, as if from a cold-boot. During the
15277 	dev_printk(KERN_INFO, &pdev->dev, "recovering from a slot reset.\n");  in lpfc_io_slot_reset_s4()
15498  * function is called by the PCI subsystem after a PCI bus error affecting
15540  * from scratch, as if from a cold-boot. When this routine is invoked, it