[SCSI] lpfc 8.2.8 : Add kernel-doc function headers
Signed-off-by: James Smart <james.smart@emulex.com> Signed-off-by: James Bottomley <James.Bottomley@HansenPartnership.com>
This commit is contained in:
parent
4a27446f3e
commit
e59058c440
7 changed files with 4556 additions and 256 deletions
File diff suppressed because it is too large
Load diff
|
@ -1,7 +1,7 @@
|
|||
/*******************************************************************
|
||||
* This file is part of the Emulex Linux Device Driver for *
|
||||
* Fibre Channel Host Bus Adapters. *
|
||||
* Copyright (C) 2007 Emulex. All rights reserved. *
|
||||
* Copyright (C) 2007-2008 Emulex. All rights reserved. *
|
||||
* EMULEX and SLI are trademarks of Emulex. *
|
||||
* www.emulex.com *
|
||||
* *
|
||||
|
@ -46,13 +46,14 @@
|
|||
#include "lpfc_debugfs.h"
|
||||
|
||||
#ifdef CONFIG_LPFC_DEBUG_FS
|
||||
/* debugfs interface
|
||||
/**
|
||||
* debugfs interface
|
||||
*
|
||||
* To access this interface the user should:
|
||||
* # mkdir /debug
|
||||
* # mount -t debugfs none /debug
|
||||
*
|
||||
* The lpfc debugfs directory hierachy is:
|
||||
* The lpfc debugfs directory hierarchy is:
|
||||
* lpfc/lpfcX/vportY
|
||||
* where X is the lpfc hba unique_id
|
||||
* where Y is the vport VPI on that hba
|
||||
|
@ -61,14 +62,21 @@
|
|||
* discovery_trace
|
||||
* This is an ACSII readable file that contains a trace of the last
|
||||
* lpfc_debugfs_max_disc_trc events that happened on a specific vport.
|
||||
* See lpfc_debugfs.h for different categories of
|
||||
* discovery events. To enable the discovery trace, the following
|
||||
* module parameters must be set:
|
||||
* See lpfc_debugfs.h for different categories of discovery events.
|
||||
* To enable the discovery trace, the following module parameters must be set:
|
||||
* lpfc_debugfs_enable=1 Turns on lpfc debugfs filesystem support
|
||||
* lpfc_debugfs_max_disc_trc=X Where X is the event trace depth for
|
||||
* EACH vport. X MUST also be a power of 2.
|
||||
* lpfc_debugfs_mask_disc_trc=Y Where Y is an event mask as defined in
|
||||
* lpfc_debugfs.h .
|
||||
*
|
||||
* slow_ring_trace
|
||||
* This is an ACSII readable file that contains a trace of the last
|
||||
* lpfc_debugfs_max_slow_ring_trc events that happened on a specific HBA.
|
||||
* To enable the slow ring trace, the following module parameters must be set:
|
||||
* lpfc_debugfs_enable=1 Turns on lpfc debugfs filesystem support
|
||||
* lpfc_debugfs_max_slow_ring_trc=X Where X is the event trace depth for
|
||||
* the HBA. X MUST also be a power of 2.
|
||||
*/
|
||||
static int lpfc_debugfs_enable = 1;
|
||||
module_param(lpfc_debugfs_enable, int, 0);
|
||||
|
@ -117,6 +125,25 @@ struct lpfc_debug {
|
|||
static atomic_t lpfc_debugfs_seq_trc_cnt = ATOMIC_INIT(0);
|
||||
static unsigned long lpfc_debugfs_start_time = 0L;
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_disc_trc_data - Dump discovery logging to a buffer.
|
||||
* @vport: The vport to gather the log info from.
|
||||
* @buf: The buffer to dump log into.
|
||||
* @size: The maximum amount of data to process.
|
||||
*
|
||||
* Description:
|
||||
* This routine gathers the lpfc discovery debugfs data from the @vport and
|
||||
* dumps it to @buf up to @size number of bytes. It will start at the next entry
|
||||
* in the log and process the log until the end of the buffer. Then it will
|
||||
* gather from the beginning of the log and process until the current entry.
|
||||
*
|
||||
* Notes:
|
||||
* Discovery logging will be disabled while while this routine dumps the log.
|
||||
*
|
||||
* Return Value:
|
||||
* This routine returns the amount of bytes that were dumped into @buf and will
|
||||
* not exceed @size.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_disc_trc_data(struct lpfc_vport *vport, char *buf, int size)
|
||||
{
|
||||
|
@ -125,7 +152,6 @@ lpfc_debugfs_disc_trc_data(struct lpfc_vport *vport, char *buf, int size)
|
|||
struct lpfc_debugfs_trc *dtp;
|
||||
char buffer[LPFC_DEBUG_TRC_ENTRY_SIZE];
|
||||
|
||||
|
||||
enable = lpfc_debugfs_enable;
|
||||
lpfc_debugfs_enable = 0;
|
||||
|
||||
|
@ -159,6 +185,25 @@ lpfc_debugfs_disc_trc_data(struct lpfc_vport *vport, char *buf, int size)
|
|||
return len;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_slow_ring_trc_data - Dump slow ring logging to a buffer.
|
||||
* @phba: The HBA to gather the log info from.
|
||||
* @buf: The buffer to dump log into.
|
||||
* @size: The maximum amount of data to process.
|
||||
*
|
||||
* Description:
|
||||
* This routine gathers the lpfc slow ring debugfs data from the @phba and
|
||||
* dumps it to @buf up to @size number of bytes. It will start at the next entry
|
||||
* in the log and process the log until the end of the buffer. Then it will
|
||||
* gather from the beginning of the log and process until the current entry.
|
||||
*
|
||||
* Notes:
|
||||
* Slow ring logging will be disabled while while this routine dumps the log.
|
||||
*
|
||||
* Return Value:
|
||||
* This routine returns the amount of bytes that were dumped into @buf and will
|
||||
* not exceed @size.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_slow_ring_trc_data(struct lpfc_hba *phba, char *buf, int size)
|
||||
{
|
||||
|
@ -203,6 +248,25 @@ lpfc_debugfs_slow_ring_trc_data(struct lpfc_hba *phba, char *buf, int size)
|
|||
|
||||
static int lpfc_debugfs_last_hbq = -1;
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_hbqinfo_data - Dump host buffer queue info to a buffer.
|
||||
* @phba: The HBA to gather host buffer info from.
|
||||
* @buf: The buffer to dump log into.
|
||||
* @size: The maximum amount of data to process.
|
||||
*
|
||||
* Description:
|
||||
* This routine dumps the host buffer queue info from the @phba to @buf up to
|
||||
* @size number of bytes. A header that describes the current hbq state will be
|
||||
* dumped to @buf first and then info on each hbq entry will be dumped to @buf
|
||||
* until @size bytes have been dumped or all the hbq info has been dumped.
|
||||
*
|
||||
* Notes:
|
||||
* This routine will rotate through each configured HBQ each time called.
|
||||
*
|
||||
* Return Value:
|
||||
* This routine returns the amount of bytes that were dumped into @buf and will
|
||||
* not exceed @size.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_hbqinfo_data(struct lpfc_hba *phba, char *buf, int size)
|
||||
{
|
||||
|
@ -303,6 +367,24 @@ skipit:
|
|||
|
||||
static int lpfc_debugfs_last_hba_slim_off;
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_dumpHBASlim_data - Dump HBA SLIM info to a buffer.
|
||||
* @phba: The HBA to gather SLIM info from.
|
||||
* @buf: The buffer to dump log into.
|
||||
* @size: The maximum amount of data to process.
|
||||
*
|
||||
* Description:
|
||||
* This routine dumps the current contents of HBA SLIM for the HBA associated
|
||||
* with @phba to @buf up to @size bytes of data. This is the raw HBA SLIM data.
|
||||
*
|
||||
* Notes:
|
||||
* This routine will only dump up to 1024 bytes of data each time called and
|
||||
* should be called multiple times to dump the entire HBA SLIM.
|
||||
*
|
||||
* Return Value:
|
||||
* This routine returns the amount of bytes that were dumped into @buf and will
|
||||
* not exceed @size.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_dumpHBASlim_data(struct lpfc_hba *phba, char *buf, int size)
|
||||
{
|
||||
|
@ -342,6 +424,21 @@ lpfc_debugfs_dumpHBASlim_data(struct lpfc_hba *phba, char *buf, int size)
|
|||
return len;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_dumpHostSlim_data - Dump host SLIM info to a buffer.
|
||||
* @phba: The HBA to gather Host SLIM info from.
|
||||
* @buf: The buffer to dump log into.
|
||||
* @size: The maximum amount of data to process.
|
||||
*
|
||||
* Description:
|
||||
* This routine dumps the current contents of host SLIM for the host associated
|
||||
* with @phba to @buf up to @size bytes of data. The dump will contain the
|
||||
* Mailbox, PCB, Rings, and Registers that are located in host memory.
|
||||
*
|
||||
* Return Value:
|
||||
* This routine returns the amount of bytes that were dumped into @buf and will
|
||||
* not exceed @size.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_dumpHostSlim_data(struct lpfc_hba *phba, char *buf, int size)
|
||||
{
|
||||
|
@ -430,6 +527,21 @@ lpfc_debugfs_dumpHostSlim_data(struct lpfc_hba *phba, char *buf, int size)
|
|||
return len;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_nodelist_data - Dump target node list to a buffer.
|
||||
* @vport: The vport to gather target node info from.
|
||||
* @buf: The buffer to dump log into.
|
||||
* @size: The maximum amount of data to process.
|
||||
*
|
||||
* Description:
|
||||
* This routine dumps the current target node list associated with @vport to
|
||||
* @buf up to @size bytes of data. Each node entry in the dump will contain a
|
||||
* node state, DID, WWPN, WWNN, RPI, flags, type, and other useful fields.
|
||||
*
|
||||
* Return Value:
|
||||
* This routine returns the amount of bytes that were dumped into @buf and will
|
||||
* not exceed @size.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_nodelist_data(struct lpfc_vport *vport, char *buf, int size)
|
||||
{
|
||||
|
@ -513,7 +625,22 @@ lpfc_debugfs_nodelist_data(struct lpfc_vport *vport, char *buf, int size)
|
|||
}
|
||||
#endif
|
||||
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_disc_trc - Store discovery trace log.
|
||||
* @vport: The vport to associate this trace string with for retrieval.
|
||||
* @mask: Log entry classification.
|
||||
* @fmt: Format string to be displayed when dumping the log.
|
||||
* @data1: 1st data parameter to be applied to @fmt.
|
||||
* @data2: 2nd data parameter to be applied to @fmt.
|
||||
* @data3: 3rd data parameter to be applied to @fmt.
|
||||
*
|
||||
* Description:
|
||||
* This routine is used by the driver code to add a debugfs log entry to the
|
||||
* discovery trace buffer associated with @vport. Only entries with a @mask that
|
||||
* match the current debugfs discovery mask will be saved. Entries that do not
|
||||
* match will be thrown away. @fmt, @data1, @data2, and @data3 are used like
|
||||
* printf when displaying the log.
|
||||
**/
|
||||
inline void
|
||||
lpfc_debugfs_disc_trc(struct lpfc_vport *vport, int mask, char *fmt,
|
||||
uint32_t data1, uint32_t data2, uint32_t data3)
|
||||
|
@ -542,6 +669,19 @@ lpfc_debugfs_disc_trc(struct lpfc_vport *vport, int mask, char *fmt,
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_slow_ring_trc - Store slow ring trace log.
|
||||
* @phba: The phba to associate this trace string with for retrieval.
|
||||
* @fmt: Format string to be displayed when dumping the log.
|
||||
* @data1: 1st data parameter to be applied to @fmt.
|
||||
* @data2: 2nd data parameter to be applied to @fmt.
|
||||
* @data3: 3rd data parameter to be applied to @fmt.
|
||||
*
|
||||
* Description:
|
||||
* This routine is used by the driver code to add a debugfs log entry to the
|
||||
* discovery trace buffer associated with @vport. @fmt, @data1, @data2, and
|
||||
* @data3 are used like printf when displaying the log.
|
||||
**/
|
||||
inline void
|
||||
lpfc_debugfs_slow_ring_trc(struct lpfc_hba *phba, char *fmt,
|
||||
uint32_t data1, uint32_t data2, uint32_t data3)
|
||||
|
@ -568,6 +708,21 @@ lpfc_debugfs_slow_ring_trc(struct lpfc_hba *phba, char *fmt,
|
|||
}
|
||||
|
||||
#ifdef CONFIG_LPFC_DEBUG_FS
|
||||
/**
|
||||
* lpfc_debugfs_disc_trc_open - Open the discovery trace log.
|
||||
* @inode: The inode pointer that contains a vport pointer.
|
||||
* @file: The file pointer to attach the log output.
|
||||
*
|
||||
* Description:
|
||||
* This routine is the entry point for the debugfs open file operation. It gets
|
||||
* the vport from the i_private field in @inode, allocates the necessary buffer
|
||||
* for the log, fills the buffer from the in-memory log for this vport, and then
|
||||
* returns a pointer to that log in the private_data field in @file.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns zero if successful. On error it will return an negative
|
||||
* error value.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_disc_trc_open(struct inode *inode, struct file *file)
|
||||
{
|
||||
|
@ -585,7 +740,7 @@ lpfc_debugfs_disc_trc_open(struct inode *inode, struct file *file)
|
|||
if (!debug)
|
||||
goto out;
|
||||
|
||||
/* Round to page boundry */
|
||||
/* Round to page boundary */
|
||||
size = (lpfc_debugfs_max_disc_trc * LPFC_DEBUG_TRC_ENTRY_SIZE);
|
||||
size = PAGE_ALIGN(size);
|
||||
|
||||
|
@ -603,6 +758,21 @@ out:
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_slow_ring_trc_open - Open the Slow Ring trace log.
|
||||
* @inode: The inode pointer that contains a vport pointer.
|
||||
* @file: The file pointer to attach the log output.
|
||||
*
|
||||
* Description:
|
||||
* This routine is the entry point for the debugfs open file operation. It gets
|
||||
* the vport from the i_private field in @inode, allocates the necessary buffer
|
||||
* for the log, fills the buffer from the in-memory log for this vport, and then
|
||||
* returns a pointer to that log in the private_data field in @file.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns zero if successful. On error it will return an negative
|
||||
* error value.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_slow_ring_trc_open(struct inode *inode, struct file *file)
|
||||
{
|
||||
|
@ -620,7 +790,7 @@ lpfc_debugfs_slow_ring_trc_open(struct inode *inode, struct file *file)
|
|||
if (!debug)
|
||||
goto out;
|
||||
|
||||
/* Round to page boundry */
|
||||
/* Round to page boundary */
|
||||
size = (lpfc_debugfs_max_slow_ring_trc * LPFC_DEBUG_TRC_ENTRY_SIZE);
|
||||
size = PAGE_ALIGN(size);
|
||||
|
||||
|
@ -638,6 +808,21 @@ out:
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_hbqinfo_open - Open the hbqinfo debugfs buffer.
|
||||
* @inode: The inode pointer that contains a vport pointer.
|
||||
* @file: The file pointer to attach the log output.
|
||||
*
|
||||
* Description:
|
||||
* This routine is the entry point for the debugfs open file operation. It gets
|
||||
* the vport from the i_private field in @inode, allocates the necessary buffer
|
||||
* for the log, fills the buffer from the in-memory log for this vport, and then
|
||||
* returns a pointer to that log in the private_data field in @file.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns zero if successful. On error it will return an negative
|
||||
* error value.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_hbqinfo_open(struct inode *inode, struct file *file)
|
||||
{
|
||||
|
@ -649,7 +834,7 @@ lpfc_debugfs_hbqinfo_open(struct inode *inode, struct file *file)
|
|||
if (!debug)
|
||||
goto out;
|
||||
|
||||
/* Round to page boundry */
|
||||
/* Round to page boundary */
|
||||
debug->buffer = kmalloc(LPFC_HBQINFO_SIZE, GFP_KERNEL);
|
||||
if (!debug->buffer) {
|
||||
kfree(debug);
|
||||
|
@ -665,6 +850,21 @@ out:
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_dumpHBASlim_open - Open the Dump HBA SLIM debugfs buffer.
|
||||
* @inode: The inode pointer that contains a vport pointer.
|
||||
* @file: The file pointer to attach the log output.
|
||||
*
|
||||
* Description:
|
||||
* This routine is the entry point for the debugfs open file operation. It gets
|
||||
* the vport from the i_private field in @inode, allocates the necessary buffer
|
||||
* for the log, fills the buffer from the in-memory log for this vport, and then
|
||||
* returns a pointer to that log in the private_data field in @file.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns zero if successful. On error it will return an negative
|
||||
* error value.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_dumpHBASlim_open(struct inode *inode, struct file *file)
|
||||
{
|
||||
|
@ -676,7 +876,7 @@ lpfc_debugfs_dumpHBASlim_open(struct inode *inode, struct file *file)
|
|||
if (!debug)
|
||||
goto out;
|
||||
|
||||
/* Round to page boundry */
|
||||
/* Round to page boundary */
|
||||
debug->buffer = kmalloc(LPFC_DUMPHBASLIM_SIZE, GFP_KERNEL);
|
||||
if (!debug->buffer) {
|
||||
kfree(debug);
|
||||
|
@ -692,6 +892,21 @@ out:
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_dumpHostSlim_open - Open the Dump Host SLIM debugfs buffer.
|
||||
* @inode: The inode pointer that contains a vport pointer.
|
||||
* @file: The file pointer to attach the log output.
|
||||
*
|
||||
* Description:
|
||||
* This routine is the entry point for the debugfs open file operation. It gets
|
||||
* the vport from the i_private field in @inode, allocates the necessary buffer
|
||||
* for the log, fills the buffer from the in-memory log for this vport, and then
|
||||
* returns a pointer to that log in the private_data field in @file.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns zero if successful. On error it will return an negative
|
||||
* error value.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_dumpHostSlim_open(struct inode *inode, struct file *file)
|
||||
{
|
||||
|
@ -703,7 +918,7 @@ lpfc_debugfs_dumpHostSlim_open(struct inode *inode, struct file *file)
|
|||
if (!debug)
|
||||
goto out;
|
||||
|
||||
/* Round to page boundry */
|
||||
/* Round to page boundary */
|
||||
debug->buffer = kmalloc(LPFC_DUMPHOSTSLIM_SIZE, GFP_KERNEL);
|
||||
if (!debug->buffer) {
|
||||
kfree(debug);
|
||||
|
@ -719,6 +934,21 @@ out:
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_nodelist_open - Open the nodelist debugfs file.
|
||||
* @inode: The inode pointer that contains a vport pointer.
|
||||
* @file: The file pointer to attach the log output.
|
||||
*
|
||||
* Description:
|
||||
* This routine is the entry point for the debugfs open file operation. It gets
|
||||
* the vport from the i_private field in @inode, allocates the necessary buffer
|
||||
* for the log, fills the buffer from the in-memory log for this vport, and then
|
||||
* returns a pointer to that log in the private_data field in @file.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns zero if successful. On error it will return an negative
|
||||
* error value.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_nodelist_open(struct inode *inode, struct file *file)
|
||||
{
|
||||
|
@ -730,7 +960,7 @@ lpfc_debugfs_nodelist_open(struct inode *inode, struct file *file)
|
|||
if (!debug)
|
||||
goto out;
|
||||
|
||||
/* Round to page boundry */
|
||||
/* Round to page boundary */
|
||||
debug->buffer = kmalloc(LPFC_NODELIST_SIZE, GFP_KERNEL);
|
||||
if (!debug->buffer) {
|
||||
kfree(debug);
|
||||
|
@ -746,6 +976,23 @@ out:
|
|||
return rc;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_lseek - Seek through a debugfs file.
|
||||
* @file: The file pointer to seek through.
|
||||
* @off: The offset to seek to or the amount to seek by.
|
||||
* @whence: Indicates how to seek.
|
||||
*
|
||||
* Description:
|
||||
* This routine is the entry point for the debugfs lseek file operation. The
|
||||
* @whence parameter indicates whether @off is the offset to directly seek to,
|
||||
* or if it is a value to seek forward or reverse by. This function figures out
|
||||
* what the new offset of the debugfs file will be and assigns that value to the
|
||||
* f_pos field of @file.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns the new offset if successful and returns a negative
|
||||
* error if unable to process the seek.
|
||||
**/
|
||||
static loff_t
|
||||
lpfc_debugfs_lseek(struct file *file, loff_t off, int whence)
|
||||
{
|
||||
|
@ -767,6 +1014,22 @@ lpfc_debugfs_lseek(struct file *file, loff_t off, int whence)
|
|||
return (pos < 0 || pos > debug->len) ? -EINVAL : (file->f_pos = pos);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_read - Read a debugfs file.
|
||||
* @file: The file pointer to read from.
|
||||
* @buf: The buffer to copy the data to.
|
||||
* @nbytes: The number of bytes to read.
|
||||
* @ppos: The position in the file to start reading from.
|
||||
*
|
||||
* Description:
|
||||
* This routine reads data from from the buffer indicated in the private_data
|
||||
* field of @file. It will start reading at @ppos and copy up to @nbytes of
|
||||
* data to @buf.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns the amount of data that was read (this could be less
|
||||
* than @nbytes if the end of the file was reached) or a negative error value.
|
||||
**/
|
||||
static ssize_t
|
||||
lpfc_debugfs_read(struct file *file, char __user *buf,
|
||||
size_t nbytes, loff_t *ppos)
|
||||
|
@ -776,6 +1039,18 @@ lpfc_debugfs_read(struct file *file, char __user *buf,
|
|||
debug->len);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_release - Release the buffer used to store debugfs file data.
|
||||
* @inode: The inode pointer that contains a vport pointer. (unused)
|
||||
* @file: The file pointer that contains the buffer to release.
|
||||
*
|
||||
* Description:
|
||||
* This routine frees the buffer that was allocated when the debugfs file was
|
||||
* opened.
|
||||
*
|
||||
* Returns:
|
||||
* This function returns zero.
|
||||
**/
|
||||
static int
|
||||
lpfc_debugfs_release(struct inode *inode, struct file *file)
|
||||
{
|
||||
|
@ -845,6 +1120,16 @@ static struct dentry *lpfc_debugfs_root = NULL;
|
|||
static atomic_t lpfc_debugfs_hba_count;
|
||||
#endif
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_initialize - Initialize debugfs for a vport.
|
||||
* @vport: The vport pointer to initialize.
|
||||
*
|
||||
* Description:
|
||||
* When Debugfs is configured this routine sets up the lpfc debugfs file system.
|
||||
* If not already created, this routine will create the lpfc directory, and
|
||||
* lpfcX directory (for this HBA), and vportX directory for this vport. It will
|
||||
* also create each file used to access lpfc specific debugfs information.
|
||||
**/
|
||||
inline void
|
||||
lpfc_debugfs_initialize(struct lpfc_vport *vport)
|
||||
{
|
||||
|
@ -1033,7 +1318,17 @@ debug_failed:
|
|||
#endif
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* lpfc_debugfs_terminate - Tear down debugfs infrastructure for this vport.
|
||||
* @vport: The vport pointer to remove from debugfs.
|
||||
*
|
||||
* Description:
|
||||
* When Debugfs is configured this routine removes debugfs file system elements
|
||||
* that are specific to this vport. It also checks to see if there are any
|
||||
* users left for the debugfs directories associated with the HBA and driver. If
|
||||
* this is the last user of the HBA directory or driver directory then it will
|
||||
* remove those from the debugfs infrastructure as well.
|
||||
**/
|
||||
inline void
|
||||
lpfc_debugfs_terminate(struct lpfc_vport *vport)
|
||||
{
|
||||
|
@ -1096,5 +1391,3 @@ lpfc_debugfs_terminate(struct lpfc_vport *vport)
|
|||
#endif
|
||||
return;
|
||||
}
|
||||
|
||||
|
||||
|
|
File diff suppressed because it is too large
Load diff
|
@ -52,17 +52,20 @@ static struct scsi_transport_template *lpfc_transport_template = NULL;
|
|||
static struct scsi_transport_template *lpfc_vport_transport_template = NULL;
|
||||
static DEFINE_IDR(lpfc_hba_index);
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_config_port_prep */
|
||||
/* This routine will do LPFC initialization prior to the */
|
||||
/* CONFIG_PORT mailbox command. This will be initialized */
|
||||
/* as a SLI layer callback routine. */
|
||||
/* This routine returns 0 on success or -ERESTART if it wants */
|
||||
/* the SLI layer to reset the HBA and try again. Any */
|
||||
/* other return value indicates an error. */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_config_port_prep: Perform lpfc initialization prior to config port.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine will do LPFC initialization prior to issuing the CONFIG_PORT
|
||||
* mailbox command. It retrieves the revision information from the HBA and
|
||||
* collects the Vital Product Data (VPD) about the HBA for preparing the
|
||||
* configuration of the HBA.
|
||||
*
|
||||
* Return codes:
|
||||
* 0 - success.
|
||||
* -ERESTART - requests the SLI layer to reset the HBA and try again.
|
||||
* Any other value - indicates an error.
|
||||
**/
|
||||
int
|
||||
lpfc_config_port_prep(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -214,7 +217,16 @@ out_free_mbox:
|
|||
return 0;
|
||||
}
|
||||
|
||||
/* Completion handler for config async event mailbox command. */
|
||||
/**
|
||||
* lpfc_config_async_cmpl: Completion handler for config async event mbox cmd.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmboxq: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* This is the completion handler for driver's configuring asynchronous event
|
||||
* mailbox command to the device. If the mailbox command returns successfully,
|
||||
* it will set internal async event support flag to 1; otherwise, it will
|
||||
* set internal async event support flag to 0.
|
||||
**/
|
||||
static void
|
||||
lpfc_config_async_cmpl(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmboxq)
|
||||
{
|
||||
|
@ -226,16 +238,19 @@ lpfc_config_async_cmpl(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmboxq)
|
|||
return;
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_config_port_post */
|
||||
/* This routine will do LPFC initialization after the */
|
||||
/* CONFIG_PORT mailbox command. This will be initialized */
|
||||
/* as a SLI layer callback routine. */
|
||||
/* This routine returns 0 on success. Any other return value */
|
||||
/* indicates an error. */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_config_port_post: Perform lpfc initialization after config port.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine will do LPFC initialization after the CONFIG_PORT mailbox
|
||||
* command call. It performs all internal resource and state setups on the
|
||||
* port: post IOCB buffers, enable appropriate host interrupt attentions,
|
||||
* ELS ring timers, etc.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - success.
|
||||
* Any other value - error.
|
||||
**/
|
||||
int
|
||||
lpfc_config_port_post(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -450,16 +465,17 @@ lpfc_config_port_post(struct lpfc_hba *phba)
|
|||
return (0);
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_hba_down_prep */
|
||||
/* This routine will do LPFC uninitialization before the */
|
||||
/* HBA is reset when bringing down the SLI Layer. This will be */
|
||||
/* initialized as a SLI layer callback routine. */
|
||||
/* This routine returns 0 on success. Any other return value */
|
||||
/* indicates an error. */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_hba_down_prep: Perform lpfc uninitialization prior to HBA reset.
|
||||
* @phba: pointer to lpfc HBA data structure.
|
||||
*
|
||||
* This routine will do LPFC uninitialization before the HBA is reset when
|
||||
* bringing down the SLI Layer.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - success.
|
||||
* Any other value - error.
|
||||
**/
|
||||
int
|
||||
lpfc_hba_down_prep(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -481,15 +497,17 @@ lpfc_hba_down_prep(struct lpfc_hba *phba)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_hba_down_post */
|
||||
/* This routine will do uninitialization after the HBA is reset */
|
||||
/* when bringing down the SLI Layer. */
|
||||
/* This routine returns 0 on success. Any other return value */
|
||||
/* indicates an error. */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_hba_down_post: Perform lpfc uninitialization after HBA reset.
|
||||
* @phba: pointer to lpfc HBA data structure.
|
||||
*
|
||||
* This routine will do uninitialization after the HBA is reset when bring
|
||||
* down the SLI Layer.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - sucess.
|
||||
* Any other value - error.
|
||||
**/
|
||||
int
|
||||
lpfc_hba_down_post(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -548,7 +566,18 @@ lpfc_hba_down_post(struct lpfc_hba *phba)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/* HBA heart beat timeout handler */
|
||||
/**
|
||||
* lpfc_hb_timeout: The HBA-timer timeout handler.
|
||||
* @ptr: unsigned long holds the pointer to lpfc hba data structure.
|
||||
*
|
||||
* This is the HBA-timer timeout handler registered to the lpfc driver. When
|
||||
* this timer fires, a HBA timeout event shall be posted to the lpfc driver
|
||||
* work-port-events bitmap and the worker thread is notified. This timeout
|
||||
* event will be used by the worker thread to invoke the actual timeout
|
||||
* handler routine, lpfc_hb_timeout_handler. Any periodical operations will
|
||||
* be performed in the timeout handler and the HBA timeout event bit shall
|
||||
* be cleared by the worker thread after it has taken the event bitmap out.
|
||||
**/
|
||||
static void
|
||||
lpfc_hb_timeout(unsigned long ptr)
|
||||
{
|
||||
|
@ -568,6 +597,22 @@ lpfc_hb_timeout(unsigned long ptr)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_hb_mbox_cmpl: The lpfc heart-beat mailbox command callback function.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmboxq: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* This is the callback function to the lpfc heart-beat mailbox command.
|
||||
* If configured, the lpfc driver issues the heart-beat mailbox command to
|
||||
* the HBA every LPFC_HB_MBOX_INTERVAL (current 5) seconds. At the time the
|
||||
* heart-beat mailbox command is issued, the driver shall set up heart-beat
|
||||
* timeout timer to LPFC_HB_MBOX_TIMEOUT (current 30) seconds and marks
|
||||
* heart-beat outstanding state. Once the mailbox command comes back and
|
||||
* no error conditions detected, the heart-beat mailbox command timer is
|
||||
* reset to LPFC_HB_MBOX_INTERVAL seconds and the heart-beat outstanding
|
||||
* state is cleared for the next heart-beat. If the timer expired with the
|
||||
* heart-beat outstanding state set, the driver will put the HBA offline.
|
||||
**/
|
||||
static void
|
||||
lpfc_hb_mbox_cmpl(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmboxq)
|
||||
{
|
||||
|
@ -586,6 +631,22 @@ lpfc_hb_mbox_cmpl(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmboxq)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_hb_timeout_handler: The HBA-timer timeout handler.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This is the actual HBA-timer timeout handler to be invoked by the worker
|
||||
* thread whenever the HBA timer fired and HBA-timeout event posted. This
|
||||
* handler performs any periodic operations needed for the device. If such
|
||||
* periodic event has already been attended to either in the interrupt handler
|
||||
* or by processing slow-ring or fast-ring events within the HBA-timer
|
||||
* timeout window (LPFC_HB_MBOX_INTERVAL), this handler just simply resets
|
||||
* the timer for the next timeout period. If lpfc heart-beat mailbox command
|
||||
* is configured and there is no heart-beat mailbox command outstanding, a
|
||||
* heart-beat mailbox is issued and timer set properly. Otherwise, if there
|
||||
* has been a heart-beat mailbox command outstanding, the HBA shall be put
|
||||
* to offline.
|
||||
**/
|
||||
void
|
||||
lpfc_hb_timeout_handler(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -684,6 +745,13 @@ lpfc_hb_timeout_handler(struct lpfc_hba *phba)
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_offline_eratt: Bring lpfc offline on hardware error attention.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine is called to bring the HBA offline when HBA hardware error
|
||||
* other than Port Error 6 has been detected.
|
||||
**/
|
||||
static void
|
||||
lpfc_offline_eratt(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -704,14 +772,16 @@ lpfc_offline_eratt(struct lpfc_hba *phba)
|
|||
return;
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_handle_eratt */
|
||||
/* This routine will handle processing a Host Attention */
|
||||
/* Error Status event. This will be initialized */
|
||||
/* as a SLI layer callback routine. */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_handle_eratt: The HBA hardware error handler.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine is invoked to handle the following HBA hardware error
|
||||
* conditions:
|
||||
* 1 - HBA error attention interrupt
|
||||
* 2 - DMA ring index out of range
|
||||
* 3 - Mailbox command came back as unknown
|
||||
**/
|
||||
void
|
||||
lpfc_handle_eratt(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -810,14 +880,13 @@ lpfc_handle_eratt(struct lpfc_hba *phba)
|
|||
}
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_handle_latt */
|
||||
/* This routine will handle processing a Host Attention */
|
||||
/* Link Status event. This will be initialized */
|
||||
/* as a SLI layer callback routine. */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_handle_latt: The HBA link event handler.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine is invoked from the worker thread to handle a HBA host
|
||||
* attention link event.
|
||||
**/
|
||||
void
|
||||
lpfc_handle_latt(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -898,12 +967,20 @@ lpfc_handle_latt_err_exit:
|
|||
return;
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_parse_vpd */
|
||||
/* This routine will parse the VPD data */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_parse_vpd: Parse VPD (Vital Product Data).
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @vpd: pointer to the vital product data.
|
||||
* @len: length of the vital product data in bytes.
|
||||
*
|
||||
* This routine parses the Vital Product Data (VPD). The VPD is treated as
|
||||
* an array of characters. In this routine, the ModelName, ProgramType, and
|
||||
* ModelDesc, etc. fields of the phba data structure will be populated.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - pointer to the VPD passed in is NULL
|
||||
* 1 - success
|
||||
**/
|
||||
static int
|
||||
lpfc_parse_vpd(struct lpfc_hba *phba, uint8_t *vpd, int len)
|
||||
{
|
||||
|
@ -1040,6 +1117,18 @@ lpfc_parse_vpd(struct lpfc_hba *phba, uint8_t *vpd, int len)
|
|||
return(1);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_get_hba_model_desc: Retrieve HBA device model name and description.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @mdp: pointer to the data structure to hold the derived model name.
|
||||
* @descp: pointer to the data structure to hold the derived description.
|
||||
*
|
||||
* This routine retrieves HBA's description based on its registered PCI device
|
||||
* ID. The @descp passed into this function points to an array of 256 chars. It
|
||||
* shall be returned with the model name, maximum speed, and the host bus type.
|
||||
* The @mdp passed into this function points to an array of 80 chars. When the
|
||||
* function returns, the @mdp will be filled with the model name.
|
||||
**/
|
||||
static void
|
||||
lpfc_get_hba_model_desc(struct lpfc_hba *phba, uint8_t *mdp, uint8_t *descp)
|
||||
{
|
||||
|
@ -1190,14 +1279,18 @@ lpfc_get_hba_model_desc(struct lpfc_hba *phba, uint8_t *mdp, uint8_t *descp)
|
|||
m.name, m.max_speed, m.bus);
|
||||
}
|
||||
|
||||
/**************************************************/
|
||||
/* lpfc_post_buffer */
|
||||
/* */
|
||||
/* This routine will post count buffers to the */
|
||||
/* ring with the QUE_RING_BUF_CN command. This */
|
||||
/* allows 3 buffers / command to be posted. */
|
||||
/* Returns the number of buffers NOT posted. */
|
||||
/**************************************************/
|
||||
/**
|
||||
* lpfc_post_buffer: Post IOCB(s) with DMA buffer descriptor(s) to a IOCB ring.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pring: pointer to a IOCB ring.
|
||||
* @cnt: the number of IOCBs to be posted to the IOCB ring.
|
||||
*
|
||||
* This routine posts a given number of IOCBs with the associated DMA buffer
|
||||
* descriptors specified by the cnt argument to the given IOCB ring.
|
||||
*
|
||||
* Return codes
|
||||
* The number of IOCBs NOT able to be posted to the IOCB ring.
|
||||
**/
|
||||
int
|
||||
lpfc_post_buffer(struct lpfc_hba *phba, struct lpfc_sli_ring *pring, int cnt)
|
||||
{
|
||||
|
@ -1287,12 +1380,17 @@ lpfc_post_buffer(struct lpfc_hba *phba, struct lpfc_sli_ring *pring, int cnt)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_post_rcv_buf */
|
||||
/* This routine post initial rcv buffers to the configured rings */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_post_rcv_buf: Post the initial receive IOCB buffers to ELS ring.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine posts initial receive IOCB buffers to the ELS ring. The
|
||||
* current number of initial IOCB buffers specified by LPFC_BUF_RING0 is
|
||||
* set to 64 IOCBs.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - success (currently always success)
|
||||
**/
|
||||
static int
|
||||
lpfc_post_rcv_buf(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -1307,11 +1405,13 @@ lpfc_post_rcv_buf(struct lpfc_hba *phba)
|
|||
|
||||
#define S(N,V) (((V)<<(N))|((V)>>(32-(N))))
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_sha_init */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_sha_init: Set up initial array of hash table entries.
|
||||
* @HashResultPointer: pointer to an array as hash table.
|
||||
*
|
||||
* This routine sets up the initial values to the array of hash table entries
|
||||
* for the LC HBAs.
|
||||
**/
|
||||
static void
|
||||
lpfc_sha_init(uint32_t * HashResultPointer)
|
||||
{
|
||||
|
@ -1322,11 +1422,16 @@ lpfc_sha_init(uint32_t * HashResultPointer)
|
|||
HashResultPointer[4] = 0xC3D2E1F0;
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_sha_iterate */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_sha_iterate: Iterate initial hash table with the working hash table.
|
||||
* @HashResultPointer: pointer to an initial/result hash table.
|
||||
* @HashWorkingPointer: pointer to an working hash table.
|
||||
*
|
||||
* This routine iterates an initial hash table pointed by @HashResultPointer
|
||||
* with the values from the working hash table pointeed by @HashWorkingPointer.
|
||||
* The results are putting back to the initial hash table, returned through
|
||||
* the @HashResultPointer as the result hash table.
|
||||
**/
|
||||
static void
|
||||
lpfc_sha_iterate(uint32_t * HashResultPointer, uint32_t * HashWorkingPointer)
|
||||
{
|
||||
|
@ -1374,22 +1479,29 @@ lpfc_sha_iterate(uint32_t * HashResultPointer, uint32_t * HashWorkingPointer)
|
|||
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_challenge_key */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_challenge_key: Create challenge key based on WWPN of the HBA.
|
||||
* @RandomChallenge: pointer to the entry of host challenge random number array.
|
||||
* @HashWorking: pointer to the entry of the working hash array.
|
||||
*
|
||||
* This routine calculates the working hash array referred by @HashWorking
|
||||
* from the challenge random numbers associated with the host, referred by
|
||||
* @RandomChallenge. The result is put into the entry of the working hash
|
||||
* array and returned by reference through @HashWorking.
|
||||
**/
|
||||
static void
|
||||
lpfc_challenge_key(uint32_t * RandomChallenge, uint32_t * HashWorking)
|
||||
{
|
||||
*HashWorking = (*RandomChallenge ^ *HashWorking);
|
||||
}
|
||||
|
||||
/************************************************************************/
|
||||
/* */
|
||||
/* lpfc_hba_init */
|
||||
/* */
|
||||
/************************************************************************/
|
||||
/**
|
||||
* lpfc_hba_init: Perform special handling for LC HBA initialization.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @hbainit: pointer to an array of unsigned 32-bit integers.
|
||||
*
|
||||
* This routine performs the special handling for LC HBA initialization.
|
||||
**/
|
||||
void
|
||||
lpfc_hba_init(struct lpfc_hba *phba, uint32_t *hbainit)
|
||||
{
|
||||
|
@ -1412,6 +1524,15 @@ lpfc_hba_init(struct lpfc_hba *phba, uint32_t *hbainit)
|
|||
kfree(HashWorking);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_cleanup: Performs vport cleanups before deleting a vport.
|
||||
* @vport: pointer to a virtual N_Port data structure.
|
||||
*
|
||||
* This routine performs the necessary cleanups before deleting the @vport.
|
||||
* It invokes the discovery state machine to perform necessary state
|
||||
* transitions and to release the ndlps associated with the @vport. Note,
|
||||
* the physical port is treated as @vport 0.
|
||||
**/
|
||||
void
|
||||
lpfc_cleanup(struct lpfc_vport *vport)
|
||||
{
|
||||
|
@ -1498,6 +1619,14 @@ lpfc_cleanup(struct lpfc_vport *vport)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_stop_vport_timers: Stop all the timers associated with a vport.
|
||||
* @vport: pointer to a virtual N_Port data structure.
|
||||
*
|
||||
* This routine stops all the timers associated with a @vport. This function
|
||||
* is invoked before disabling or deleting a @vport. Note that the physical
|
||||
* port is treated as @vport 0.
|
||||
**/
|
||||
void
|
||||
lpfc_stop_vport_timers(struct lpfc_vport *vport)
|
||||
{
|
||||
|
@ -1507,6 +1636,13 @@ lpfc_stop_vport_timers(struct lpfc_vport *vport)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_stop_phba_timers: Stop all the timers associated with an HBA.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine stops all the timers associated with a HBA. This function is
|
||||
* invoked before either putting a HBA offline or unloading the driver.
|
||||
**/
|
||||
static void
|
||||
lpfc_stop_phba_timers(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -1519,6 +1655,16 @@ lpfc_stop_phba_timers(struct lpfc_hba *phba)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_block_mgmt_io: Mark a HBA's management interface as blocked.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine marks a HBA's management interface as blocked. Once the HBA's
|
||||
* management interface is marked as blocked, all the user space access to
|
||||
* the HBA, whether they are from sysfs interface or libdfc interface will
|
||||
* all be blocked. The HBA is set to block the management interface when the
|
||||
* driver prepares the HBA interface for online or offline.
|
||||
**/
|
||||
static void
|
||||
lpfc_block_mgmt_io(struct lpfc_hba * phba)
|
||||
{
|
||||
|
@ -1529,6 +1675,18 @@ lpfc_block_mgmt_io(struct lpfc_hba * phba)
|
|||
spin_unlock_irqrestore(&phba->hbalock, iflag);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_online: Initialize and bring a HBA online.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine initializes the HBA and brings a HBA online. During this
|
||||
* process, the management interface is blocked to prevent user space access
|
||||
* to the HBA interfering with the driver initialization.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - successful
|
||||
* 1 - failed
|
||||
**/
|
||||
int
|
||||
lpfc_online(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -1574,6 +1732,17 @@ lpfc_online(struct lpfc_hba *phba)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_unblock_mgmt_io: Mark a HBA's management interface to be not blocked.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine marks a HBA's management interface as not blocked. Once the
|
||||
* HBA's management interface is marked as not blocked, all the user space
|
||||
* access to the HBA, whether they are from sysfs interface or libdfc
|
||||
* interface will be allowed. The HBA is set to block the management interface
|
||||
* when the driver prepares the HBA interface for online or offline and then
|
||||
* set to unblock the management interface afterwards.
|
||||
**/
|
||||
void
|
||||
lpfc_unblock_mgmt_io(struct lpfc_hba * phba)
|
||||
{
|
||||
|
@ -1584,6 +1753,14 @@ lpfc_unblock_mgmt_io(struct lpfc_hba * phba)
|
|||
spin_unlock_irqrestore(&phba->hbalock, iflag);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_offline_prep: Prepare a HBA to be brought offline.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine is invoked to prepare a HBA to be brought offline. It performs
|
||||
* unregistration login to all the nodes on all vports and flushes the mailbox
|
||||
* queue to make it ready to be brought offline.
|
||||
**/
|
||||
void
|
||||
lpfc_offline_prep(struct lpfc_hba * phba)
|
||||
{
|
||||
|
@ -1633,6 +1810,14 @@ lpfc_offline_prep(struct lpfc_hba * phba)
|
|||
lpfc_sli_flush_mbox_queue(phba);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_offline: Bring a HBA offline.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine actually brings a HBA offline. It stops all the timers
|
||||
* associated with the HBA, brings down the SLI layer, and eventually
|
||||
* marks the HBA as in offline state for the upper layer protocol.
|
||||
**/
|
||||
void
|
||||
lpfc_offline(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -1670,12 +1855,17 @@ lpfc_offline(struct lpfc_hba *phba)
|
|||
lpfc_destroy_vport_work_array(phba, vports);
|
||||
}
|
||||
|
||||
/******************************************************************************
|
||||
* Function name: lpfc_scsi_free
|
||||
*
|
||||
* Description: Called from lpfc_pci_remove_one free internal driver resources
|
||||
*
|
||||
******************************************************************************/
|
||||
/**
|
||||
* lpfc_scsi_free: Free all the SCSI buffers and IOCBs from driver lists.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine is to free all the SCSI buffers and IOCBs from the driver
|
||||
* list back to kernel. It is called from lpfc_pci_remove_one to free
|
||||
* the internal resources before the device is removed from the system.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - successful (for now, it always returns 0)
|
||||
**/
|
||||
static int
|
||||
lpfc_scsi_free(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -1704,6 +1894,22 @@ lpfc_scsi_free(struct lpfc_hba *phba)
|
|||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_create_port: Create an FC port.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @instance: a unique integer ID to this FC port.
|
||||
* @dev: pointer to the device data structure.
|
||||
*
|
||||
* This routine creates a FC port for the upper layer protocol. The FC port
|
||||
* can be created on top of either a physical port or a virtual port provided
|
||||
* by the HBA. This routine also allocates a SCSI host data structure (shost)
|
||||
* and associates the FC port created before adding the shost into the SCSI
|
||||
* layer.
|
||||
*
|
||||
* Return codes
|
||||
* @vport - pointer to the virtual N_Port data structure.
|
||||
* NULL - port create failed.
|
||||
**/
|
||||
struct lpfc_vport *
|
||||
lpfc_create_port(struct lpfc_hba *phba, int instance, struct device *dev)
|
||||
{
|
||||
|
@ -1777,6 +1983,13 @@ out:
|
|||
return NULL;
|
||||
}
|
||||
|
||||
/**
|
||||
* destroy_port: Destroy an FC port.
|
||||
* @vport: pointer to an lpfc virtual N_Port data structure.
|
||||
*
|
||||
* This routine destroys a FC port from the upper layer protocol. All the
|
||||
* resources associated with the port are released.
|
||||
**/
|
||||
void
|
||||
destroy_port(struct lpfc_vport *vport)
|
||||
{
|
||||
|
@ -1797,6 +2010,16 @@ destroy_port(struct lpfc_vport *vport)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_get_instance: Get a unique integer ID.
|
||||
*
|
||||
* This routine allocates a unique integer ID from lpfc_hba_index pool. It
|
||||
* uses the kernel idr facility to perform the task.
|
||||
*
|
||||
* Return codes:
|
||||
* instance - a unique integer ID allocated as the new instance.
|
||||
* -1 - lpfc get instance failed.
|
||||
**/
|
||||
int
|
||||
lpfc_get_instance(void)
|
||||
{
|
||||
|
@ -1810,11 +2033,21 @@ lpfc_get_instance(void)
|
|||
return instance;
|
||||
}
|
||||
|
||||
/*
|
||||
* Note: there is no scan_start function as adapter initialization
|
||||
* will have asynchronously kicked off the link initialization.
|
||||
*/
|
||||
|
||||
/**
|
||||
* lpfc_scan_finished: method for SCSI layer to detect whether scan is done.
|
||||
* @shost: pointer to SCSI host data structure.
|
||||
* @time: elapsed time of the scan in jiffies.
|
||||
*
|
||||
* This routine is called by the SCSI layer with a SCSI host to determine
|
||||
* whether the scan host is finished.
|
||||
*
|
||||
* Note: there is no scan_start function as adapter initialization will have
|
||||
* asynchronously kicked off the link initialization.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - SCSI host scan is not over yet.
|
||||
* 1 - SCSI host scan is over.
|
||||
**/
|
||||
int lpfc_scan_finished(struct Scsi_Host *shost, unsigned long time)
|
||||
{
|
||||
struct lpfc_vport *vport = (struct lpfc_vport *) shost->hostdata;
|
||||
|
@ -1858,6 +2091,13 @@ finished:
|
|||
return stat;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_host_attrib_init: Initialize SCSI host attributes on a FC port.
|
||||
* @shost: pointer to SCSI host data structure.
|
||||
*
|
||||
* This routine initializes a given SCSI host attributes on a FC port. The
|
||||
* SCSI host can be either on top of a physical port or a virtual port.
|
||||
**/
|
||||
void lpfc_host_attrib_init(struct Scsi_Host *shost)
|
||||
{
|
||||
struct lpfc_vport *vport = (struct lpfc_vport *) shost->hostdata;
|
||||
|
@ -1906,6 +2146,25 @@ void lpfc_host_attrib_init(struct Scsi_Host *shost)
|
|||
spin_unlock_irq(shost->host_lock);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_enable_msix: Enable MSI-X interrupt mode.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine is invoked to enable the MSI-X interrupt vectors. The kernel
|
||||
* function pci_enable_msix() is called to enable the MSI-X vectors. Note that
|
||||
* pci_enable_msix(), once invoked, enables either all or nothing, depending
|
||||
* on the current availability of PCI vector resources. The device driver is
|
||||
* responsible for calling the individual request_irq() to register each MSI-X
|
||||
* vector with a interrupt handler, which is done in this function. Note that
|
||||
* later when device is unloading, the driver should always call free_irq()
|
||||
* on all MSI-X vectors it has done request_irq() on before calling
|
||||
* pci_disable_msix(). Failure to do so results in a BUG_ON() and a device
|
||||
* will be left with MSI-X enabled and leaks its vectors.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - sucessful
|
||||
* other values - error
|
||||
**/
|
||||
static int
|
||||
lpfc_enable_msix(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -1935,6 +2194,13 @@ lpfc_enable_msix(struct lpfc_hba *phba)
|
|||
return error;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_disable_msix: Disable MSI-X interrupt mode.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine is invoked to release the MSI-X vectors and then disable the
|
||||
* MSI-X interrupt mode.
|
||||
**/
|
||||
static void
|
||||
lpfc_disable_msix(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -1942,6 +2208,23 @@ lpfc_disable_msix(struct lpfc_hba *phba)
|
|||
pci_disable_msix(phba->pcidev);
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_pci_probe_one: lpfc PCI probe func to register device to PCI subsystem.
|
||||
* @pdev: pointer to PCI device
|
||||
* @pid: pointer to PCI device identifier
|
||||
*
|
||||
* This routine is to be registered to the kernel's PCI subsystem. When an
|
||||
* Emulex HBA is presented in PCI bus, the kernel PCI subsystem looks at
|
||||
* PCI device-specific information of the device and driver to see if the
|
||||
* driver state that it can support this kind of device. If the match is
|
||||
* successful, the driver core invokes this routine. If this routine
|
||||
* determines it can claim the HBA, it does all the initialization that it
|
||||
* needs to do to handle the HBA properly.
|
||||
*
|
||||
* Return code
|
||||
* 0 - driver can claim the device
|
||||
* negative value - driver can not claim the device
|
||||
**/
|
||||
static int __devinit
|
||||
lpfc_pci_probe_one(struct pci_dev *pdev, const struct pci_device_id *pid)
|
||||
{
|
||||
|
@ -2262,6 +2545,14 @@ out:
|
|||
return error;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_pci_remove_one: lpfc PCI func to unregister device from PCI subsystem.
|
||||
* @pdev: pointer to PCI device
|
||||
*
|
||||
* This routine is to be registered to the kernel's PCI subsystem. When an
|
||||
* Emulex HBA is removed from PCI bus. It perform all the necessary cleanup
|
||||
* for the HBA device to be removed from the PCI subsystem properly.
|
||||
**/
|
||||
static void __devexit
|
||||
lpfc_pci_remove_one(struct pci_dev *pdev)
|
||||
{
|
||||
|
@ -2336,13 +2627,21 @@ lpfc_pci_remove_one(struct pci_dev *pdev)
|
|||
}
|
||||
|
||||
/**
|
||||
* lpfc_io_error_detected - called when PCI error is detected
|
||||
* @pdev: Pointer to PCI device
|
||||
* @state: The current pci conneection state
|
||||
* lpfc_io_error_detected: Driver method for handling PCI I/O error detected.
|
||||
* @pdev: pointer to PCI device.
|
||||
* @state: the current PCI connection state.
|
||||
*
|
||||
* This function is called after a PCI bus error affecting
|
||||
* this device has been detected.
|
||||
*/
|
||||
* This routine is registered to the PCI subsystem for error handling. This
|
||||
* function is called by the PCI subsystem after a PCI bus error affecting
|
||||
* this device has been detected. When this function is invoked, it will
|
||||
* need to stop all the I/Os and interrupt(s) to the device. Once that is
|
||||
* done, it will return PCI_ERS_RESULT_NEED_RESET for the PCI subsystem to
|
||||
* perform proper recovery as desired.
|
||||
*
|
||||
* Return codes
|
||||
* PCI_ERS_RESULT_NEED_RESET - need to reset before recovery
|
||||
* PCI_ERS_RESULT_DISCONNECT - device could not be recovered
|
||||
**/
|
||||
static pci_ers_result_t lpfc_io_error_detected(struct pci_dev *pdev,
|
||||
pci_channel_state_t state)
|
||||
{
|
||||
|
@ -2376,10 +2675,21 @@ static pci_ers_result_t lpfc_io_error_detected(struct pci_dev *pdev,
|
|||
}
|
||||
|
||||
/**
|
||||
* lpfc_io_slot_reset - called after the pci bus has been reset.
|
||||
* @pdev: Pointer to PCI device
|
||||
* lpfc_io_slot_reset: Restart a PCI device from scratch.
|
||||
* @pdev: pointer to PCI device.
|
||||
*
|
||||
* Restart the card from scratch, as if from a cold-boot.
|
||||
* This routine is registered to the PCI subsystem for error handling. This is
|
||||
* called after PCI bus has been reset to restart the PCI card from scratch,
|
||||
* as if from a cold-boot. During the PCI subsystem error recovery, after the
|
||||
* driver returns PCI_ERS_RESULT_NEED_RESET, the PCI subsystem will perform
|
||||
* proper error recovery and then call this routine before calling the .resume
|
||||
* method to recover the device. This function will initialize the HBA device,
|
||||
* enable the interrupt, but it will just put the HBA to offline state without
|
||||
* passing any I/O traffic.
|
||||
*
|
||||
* Return codes
|
||||
* PCI_ERS_RESULT_RECOVERED - the device has been recovered
|
||||
* PCI_ERS_RESULT_DISCONNECT - device could not be recovered
|
||||
*/
|
||||
static pci_ers_result_t lpfc_io_slot_reset(struct pci_dev *pdev)
|
||||
{
|
||||
|
@ -2440,11 +2750,13 @@ static pci_ers_result_t lpfc_io_slot_reset(struct pci_dev *pdev)
|
|||
}
|
||||
|
||||
/**
|
||||
* lpfc_io_resume - called when traffic can start flowing again.
|
||||
* @pdev: Pointer to PCI device
|
||||
* lpfc_io_resume: Resume PCI I/O operation.
|
||||
* @pdev: pointer to PCI device
|
||||
*
|
||||
* This callback is called when the error recovery driver tells us that
|
||||
* its OK to resume normal operation.
|
||||
* This routine is registered to the PCI subsystem for error handling. It is
|
||||
* called when kernel error recovery tells the lpfc driver that it is ok to
|
||||
* resume normal PCI operation after PCI bus error recovery. After this call,
|
||||
* traffic can start to flow from this device again.
|
||||
*/
|
||||
static void lpfc_io_resume(struct pci_dev *pdev)
|
||||
{
|
||||
|
@ -2540,6 +2852,18 @@ static struct pci_driver lpfc_driver = {
|
|||
.err_handler = &lpfc_err_handler,
|
||||
};
|
||||
|
||||
/**
|
||||
* lpfc_init: lpfc module initialization routine.
|
||||
*
|
||||
* This routine is to be invoked when the lpfc module is loaded into the
|
||||
* kernel. The special kernel macro module_init() is used to indicate the
|
||||
* role of this routine to the kernel as lpfc module entry point.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - successful
|
||||
* -ENOMEM - FC attach transport failed
|
||||
* all others - failed
|
||||
*/
|
||||
static int __init
|
||||
lpfc_init(void)
|
||||
{
|
||||
|
@ -2573,6 +2897,13 @@ lpfc_init(void)
|
|||
return error;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_exit: lpfc module removal routine.
|
||||
*
|
||||
* This routine is invoked when the lpfc module is removed from the kernel.
|
||||
* The special kernel macro module_exit() is used to indicate the role of
|
||||
* this routine to the kernel as lpfc module exit point.
|
||||
*/
|
||||
static void __exit
|
||||
lpfc_exit(void)
|
||||
{
|
||||
|
|
|
@ -37,10 +37,20 @@
|
|||
#include "lpfc_crtn.h"
|
||||
#include "lpfc_compat.h"
|
||||
|
||||
/**********************************************/
|
||||
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_dump_mem: Prepare a mailbox command for retrieving HBA's VPD memory.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
* @offset: offset for dumping VPD memory mailbox command.
|
||||
*
|
||||
* The dump mailbox command provides a method for the device driver to obtain
|
||||
* various types of information from the HBA device.
|
||||
*
|
||||
* This routine prepares the mailbox command for dumping HBA Vital Product
|
||||
* Data (VPD) memory. This mailbox command is to be used for retrieving a
|
||||
* portion (DMP_RSP_SIZE bytes) of a HBA's VPD from the HBA at an address
|
||||
* offset specified by the offset parameter.
|
||||
**/
|
||||
void
|
||||
lpfc_dump_mem(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb, uint16_t offset)
|
||||
{
|
||||
|
@ -65,10 +75,17 @@ lpfc_dump_mem(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb, uint16_t offset)
|
|||
return;
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_read_nv Issue a READ NVPARAM */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_read_nv: Prepare a mailbox command for reading HBA's NVRAM param.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The read NVRAM mailbox command returns the HBA's non-volatile parameters
|
||||
* that are used as defaults when the Fibre Channel link is brought on-line.
|
||||
*
|
||||
* This routine prepares the mailbox command for reading information stored
|
||||
* in the HBA's NVRAM. Specifically, the HBA's WWNN and WWPN.
|
||||
**/
|
||||
void
|
||||
lpfc_read_nv(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -81,10 +98,19 @@ lpfc_read_nv(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_config_async Issue a */
|
||||
/* MBX_ASYNC_EVT_ENABLE mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_config_async: Prepare a mailbox command for enabling HBA async event.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
* @ring: ring number for the asynchronous event to be configured.
|
||||
*
|
||||
* The asynchronous event enable mailbox command is used to enable the
|
||||
* asynchronous event posting via the ASYNC_STATUS_CN IOCB response and
|
||||
* specifies the default ring to which events are posted.
|
||||
*
|
||||
* This routine prepares the mailbox command for enabling HBA asynchronous
|
||||
* event support on a IOCB ring.
|
||||
**/
|
||||
void
|
||||
lpfc_config_async(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb,
|
||||
uint32_t ring)
|
||||
|
@ -99,10 +125,19 @@ lpfc_config_async(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb,
|
|||
return;
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_heart_beat Issue a HEART_BEAT */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_heart_beat: Prepare a mailbox command for heart beat.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The heart beat mailbox command is used to detect an unresponsive HBA, which
|
||||
* is defined as any device where no error attention is sent and both mailbox
|
||||
* and rings are not processed.
|
||||
*
|
||||
* This routine prepares the mailbox command for issuing a heart beat in the
|
||||
* form of mailbox command to the HBA. The timely completion of the heart
|
||||
* beat mailbox command indicates the health of the HBA.
|
||||
**/
|
||||
void
|
||||
lpfc_heart_beat(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -115,10 +150,26 @@ lpfc_heart_beat(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_read_la Issue a READ LA */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_read_la: Prepare a mailbox command for reading HBA link attention.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
* @mp: DMA buffer memory for reading the link attention information into.
|
||||
*
|
||||
* The read link attention mailbox command is issued to read the Link Event
|
||||
* Attention information indicated by the HBA port when the Link Event bit
|
||||
* of the Host Attention (HSTATT) register is set to 1. A Link Event
|
||||
* Attention occurs based on an exception detected at the Fibre Channel link
|
||||
* interface.
|
||||
*
|
||||
* This routine prepares the mailbox command for reading HBA link attention
|
||||
* information. A DMA memory has been set aside and address passed to the
|
||||
* HBA through @mp for the HBA to DMA link attention information into the
|
||||
* memory as part of the execution of the mailbox command.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - Success (currently always return 0)
|
||||
**/
|
||||
int
|
||||
lpfc_read_la(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb, struct lpfc_dmabuf *mp)
|
||||
{
|
||||
|
@ -143,10 +194,21 @@ lpfc_read_la(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb, struct lpfc_dmabuf *mp)
|
|||
return (0);
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_clear_la Issue a CLEAR LA */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_clear_la: Prepare a mailbox command for clearing HBA link attention.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The clear link attention mailbox command is issued to clear the link event
|
||||
* attention condition indicated by the Link Event bit of the Host Attention
|
||||
* (HSTATT) register. The link event attention condition is cleared only if
|
||||
* the event tag specified matches that of the current link event counter.
|
||||
* The current event tag is read using the read link attention event mailbox
|
||||
* command.
|
||||
*
|
||||
* This routine prepares the mailbox command for clearing HBA link attention
|
||||
* information.
|
||||
**/
|
||||
void
|
||||
lpfc_clear_la(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -161,10 +223,20 @@ lpfc_clear_la(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/**************************************************/
|
||||
/* lpfc_config_link Issue a CONFIG LINK */
|
||||
/* mailbox command */
|
||||
/**************************************************/
|
||||
/**
|
||||
* lpfc_config_link: Prepare a mailbox command for configuring link on a HBA.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The configure link mailbox command is used before the initialize link
|
||||
* mailbox command to override default value and to configure link-oriented
|
||||
* parameters such as DID address and various timers. Typically, this
|
||||
* command would be used after an F_Port login to set the returned DID address
|
||||
* and the fabric timeout values. This command is not valid before a configure
|
||||
* port command has configured the HBA port.
|
||||
*
|
||||
* This routine prepares the mailbox command for configuring link on a HBA.
|
||||
**/
|
||||
void
|
||||
lpfc_config_link(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -199,10 +271,20 @@ lpfc_config_link(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_init_link Issue an INIT LINK */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_init_link: Prepare a mailbox command for initialize link on a HBA.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
* @topology: the link topology for the link to be initialized to.
|
||||
* @linkspeed: the link speed for the link to be initialized to.
|
||||
*
|
||||
* The initialize link mailbox command is used to initialize the Fibre
|
||||
* Channel link. This command must follow a configure port command that
|
||||
* establishes the mode of operation.
|
||||
*
|
||||
* This routine prepares the mailbox command for initializing link on a HBA
|
||||
* with the specified link topology and speed.
|
||||
**/
|
||||
void
|
||||
lpfc_init_link(struct lpfc_hba * phba,
|
||||
LPFC_MBOXQ_t * pmb, uint32_t topology, uint32_t linkspeed)
|
||||
|
@ -269,10 +351,27 @@ lpfc_init_link(struct lpfc_hba * phba,
|
|||
return;
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_read_sparam Issue a READ SPARAM */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_read_sparam: Prepare a mailbox command for reading HBA parameters.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
* @vpi: virtual N_Port identifier.
|
||||
*
|
||||
* The read service parameter mailbox command is used to read the HBA port
|
||||
* service parameters. The service parameters are read into the buffer
|
||||
* specified directly by a BDE in the mailbox command. These service
|
||||
* parameters may then be used to build the payload of an N_Port/F_POrt
|
||||
* login request and reply (LOGI/ACC).
|
||||
*
|
||||
* This routine prepares the mailbox command for reading HBA port service
|
||||
* parameters. The DMA memory is allocated in this function and the addresses
|
||||
* are populated into the mailbox command for the HBA to DMA the service
|
||||
* parameters into.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - Success
|
||||
* 1 - DMA memory allocation failed
|
||||
**/
|
||||
int
|
||||
lpfc_read_sparam(struct lpfc_hba *phba, LPFC_MBOXQ_t *pmb, int vpi)
|
||||
{
|
||||
|
@ -312,10 +411,21 @@ lpfc_read_sparam(struct lpfc_hba *phba, LPFC_MBOXQ_t *pmb, int vpi)
|
|||
return (0);
|
||||
}
|
||||
|
||||
/********************************************/
|
||||
/* lpfc_unreg_did Issue a UNREG_DID */
|
||||
/* mailbox command */
|
||||
/********************************************/
|
||||
/**
|
||||
* lpfc_unreg_did: Prepare a mailbox command for unregistering DID.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @vpi: virtual N_Port identifier.
|
||||
* @did: remote port identifier.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The unregister DID mailbox command is used to unregister an N_Port/F_Port
|
||||
* login for an unknown RPI by specifying the DID of a remote port. This
|
||||
* command frees an RPI context in the HBA port. This has the effect of
|
||||
* performing an implicit N_Port/F_Port logout.
|
||||
*
|
||||
* This routine prepares the mailbox command for unregistering a remote
|
||||
* N_Port/F_Port (DID) login.
|
||||
**/
|
||||
void
|
||||
lpfc_unreg_did(struct lpfc_hba * phba, uint16_t vpi, uint32_t did,
|
||||
LPFC_MBOXQ_t * pmb)
|
||||
|
@ -333,10 +443,19 @@ lpfc_unreg_did(struct lpfc_hba * phba, uint16_t vpi, uint32_t did,
|
|||
return;
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_read_nv Issue a READ CONFIG */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_read_config: Prepare a mailbox command for reading HBA configuration.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The read configuration mailbox command is used to read the HBA port
|
||||
* configuration parameters. This mailbox command provides a method for
|
||||
* seeing any parameters that may have changed via various configuration
|
||||
* mailbox commands.
|
||||
*
|
||||
* This routine prepares the mailbox command for reading out HBA configuration
|
||||
* parameters.
|
||||
**/
|
||||
void
|
||||
lpfc_read_config(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -350,10 +469,18 @@ lpfc_read_config(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/*************************************************/
|
||||
/* lpfc_read_lnk_stat Issue a READ LINK STATUS */
|
||||
/* mailbox command */
|
||||
/*************************************************/
|
||||
/**
|
||||
* lpfc_read_lnk_stat: Prepare a mailbox command for reading HBA link stats.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The read link status mailbox command is used to read the link status from
|
||||
* the HBA. Link status includes all link-related error counters. These
|
||||
* counters are maintained by the HBA and originated in the link hardware
|
||||
* unit. Note that all of these counters wrap.
|
||||
*
|
||||
* This routine prepares the mailbox command for reading out HBA link status.
|
||||
**/
|
||||
void
|
||||
lpfc_read_lnk_stat(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -367,10 +494,30 @@ lpfc_read_lnk_stat(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/********************************************/
|
||||
/* lpfc_reg_login Issue a REG_LOGIN */
|
||||
/* mailbox command */
|
||||
/********************************************/
|
||||
/**
|
||||
* lpfc_reg_login: Prepare a mailbox command for registering remote login.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @vpi: virtual N_Port identifier.
|
||||
* @did: remote port identifier.
|
||||
* @param: pointer to memory holding the server parameters.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
* @flag: action flag to be passed back for the complete function.
|
||||
*
|
||||
* The registration login mailbox command is used to register an N_Port or
|
||||
* F_Port login. This registration allows the HBA to cache the remote N_Port
|
||||
* service parameters internally and thereby make the appropriate FC-2
|
||||
* decisions. The remote port service parameters are handed off by the driver
|
||||
* to the HBA using a descriptor entry that directly identifies a buffer in
|
||||
* host memory. In exchange, the HBA returns an RPI identifier.
|
||||
*
|
||||
* This routine prepares the mailbox command for registering remote port login.
|
||||
* The function allocates DMA buffer for passing the service parameters to the
|
||||
* HBA with the mailbox command.
|
||||
*
|
||||
* Return codes
|
||||
* 0 - Success
|
||||
* 1 - DMA memory allocation failed
|
||||
**/
|
||||
int
|
||||
lpfc_reg_login(struct lpfc_hba *phba, uint16_t vpi, uint32_t did,
|
||||
uint8_t *param, LPFC_MBOXQ_t *pmb, uint32_t flag)
|
||||
|
@ -418,10 +565,20 @@ lpfc_reg_login(struct lpfc_hba *phba, uint16_t vpi, uint32_t did,
|
|||
return (0);
|
||||
}
|
||||
|
||||
/**********************************************/
|
||||
/* lpfc_unreg_login Issue a UNREG_LOGIN */
|
||||
/* mailbox command */
|
||||
/**********************************************/
|
||||
/**
|
||||
* lpfc_unreg_login: Prepare a mailbox command for unregistering remote login.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @vpi: virtual N_Port identifier.
|
||||
* @rpi: remote port identifier
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The unregistration login mailbox command is used to unregister an N_Port
|
||||
* or F_Port login. This command frees an RPI context in the HBA. It has the
|
||||
* effect of performing an implicit N_Port/F_Port logout.
|
||||
*
|
||||
* This routine prepares the mailbox command for unregistering remote port
|
||||
* login.
|
||||
**/
|
||||
void
|
||||
lpfc_unreg_login(struct lpfc_hba *phba, uint16_t vpi, uint32_t rpi,
|
||||
LPFC_MBOXQ_t * pmb)
|
||||
|
@ -440,10 +597,21 @@ lpfc_unreg_login(struct lpfc_hba *phba, uint16_t vpi, uint32_t rpi,
|
|||
return;
|
||||
}
|
||||
|
||||
/**************************************************/
|
||||
/* lpfc_reg_vpi Issue a REG_VPI */
|
||||
/* mailbox command */
|
||||
/**************************************************/
|
||||
/**
|
||||
* lpfc_reg_vpi: Prepare a mailbox command for registering vport identifier.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @vpi: virtual N_Port identifier.
|
||||
* @sid: Fibre Channel S_ID (N_Port_ID assigned to a virtual N_Port).
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The registration vport identifier mailbox command is used to activate a
|
||||
* virtual N_Port after it has acquired an N_Port_ID. The HBA validates the
|
||||
* N_Port_ID against the information in the selected virtual N_Port context
|
||||
* block and marks it active to allow normal processing of IOCB commands and
|
||||
* received unsolicited exchanges.
|
||||
*
|
||||
* This routine prepares the mailbox command for registering a virtual N_Port.
|
||||
**/
|
||||
void
|
||||
lpfc_reg_vpi(struct lpfc_hba *phba, uint16_t vpi, uint32_t sid,
|
||||
LPFC_MBOXQ_t *pmb)
|
||||
|
@ -461,10 +629,22 @@ lpfc_reg_vpi(struct lpfc_hba *phba, uint16_t vpi, uint32_t sid,
|
|||
|
||||
}
|
||||
|
||||
/**************************************************/
|
||||
/* lpfc_unreg_vpi Issue a UNREG_VNPI */
|
||||
/* mailbox command */
|
||||
/**************************************************/
|
||||
/**
|
||||
* lpfc_unreg_vpi: Prepare a mailbox command for unregistering vport id.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @vpi: virtual N_Port identifier.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The unregistration vport identifier mailbox command is used to inactivate
|
||||
* a virtual N_Port. The driver must have logged out and unregistered all
|
||||
* remote N_Ports to abort any activity on the virtual N_Port. The HBA will
|
||||
* unregisters any default RPIs associated with the specified vpi, aborting
|
||||
* any active exchanges. The HBA will post the mailbox response after making
|
||||
* the virtual N_Port inactive.
|
||||
*
|
||||
* This routine prepares the mailbox command for unregistering a virtual
|
||||
* N_Port.
|
||||
**/
|
||||
void
|
||||
lpfc_unreg_vpi(struct lpfc_hba *phba, uint16_t vpi, LPFC_MBOXQ_t *pmb)
|
||||
{
|
||||
|
@ -479,6 +659,13 @@ lpfc_unreg_vpi(struct lpfc_hba *phba, uint16_t vpi, LPFC_MBOXQ_t *pmb)
|
|||
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_config_pcb_setup: Set up IOCB rings in the Port Control Block (PCB)
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* This routine sets up and initializes the IOCB rings in the Port Control
|
||||
* Block (PCB).
|
||||
**/
|
||||
static void
|
||||
lpfc_config_pcb_setup(struct lpfc_hba * phba)
|
||||
{
|
||||
|
@ -536,6 +723,20 @@ lpfc_config_pcb_setup(struct lpfc_hba * phba)
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_read_rev: Prepare a mailbox command for reading HBA revision.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The read revision mailbox command is used to read the revision levels of
|
||||
* the HBA components. These components include hardware units, resident
|
||||
* firmware, and available firmware. HBAs that supports SLI-3 mode of
|
||||
* operation provide different response information depending on the version
|
||||
* requested by the driver.
|
||||
*
|
||||
* This routine prepares the mailbox command for reading HBA revision
|
||||
* information.
|
||||
**/
|
||||
void
|
||||
lpfc_read_rev(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -548,6 +749,16 @@ lpfc_read_rev(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_build_hbq_profile2: Set up the HBQ Selection Profile 2.
|
||||
* @hbqmb: pointer to the HBQ configuration data structure in mailbox command.
|
||||
* @hbq_desc: pointer to the HBQ selection profile descriptor.
|
||||
*
|
||||
* The Host Buffer Queue (HBQ) Selection Profile 2 specifies that the HBA
|
||||
* tests the incoming frames' R_CTL/TYPE fields with works 10:15 and performs
|
||||
* the Sequence Length Test using the fields in the Selection Profile 2
|
||||
* extension in words 20:31.
|
||||
**/
|
||||
static void
|
||||
lpfc_build_hbq_profile2(struct config_hbq_var *hbqmb,
|
||||
struct lpfc_hbq_init *hbq_desc)
|
||||
|
@ -557,6 +768,16 @@ lpfc_build_hbq_profile2(struct config_hbq_var *hbqmb,
|
|||
hbqmb->profiles.profile2.seqlenoff = hbq_desc->seqlenoff;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_build_hbq_profile3: Set up the HBQ Selection Profile 3.
|
||||
* @hbqmb: pointer to the HBQ configuration data structure in mailbox command.
|
||||
* @hbq_desc: pointer to the HBQ selection profile descriptor.
|
||||
*
|
||||
* The Host Buffer Queue (HBQ) Selection Profile 3 specifies that the HBA
|
||||
* tests the incoming frame's R_CTL/TYPE fields with words 10:15 and performs
|
||||
* the Sequence Length Test and Byte Field Test using the fields in the
|
||||
* Selection Profile 3 extension in words 20:31.
|
||||
**/
|
||||
static void
|
||||
lpfc_build_hbq_profile3(struct config_hbq_var *hbqmb,
|
||||
struct lpfc_hbq_init *hbq_desc)
|
||||
|
@ -569,6 +790,17 @@ lpfc_build_hbq_profile3(struct config_hbq_var *hbqmb,
|
|||
sizeof(hbqmb->profiles.profile3.cmdmatch));
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_build_hbq_profile5: Set up the HBQ Selection Profile 5.
|
||||
* @hbqmb: pointer to the HBQ configuration data structure in mailbox command.
|
||||
* @hbq_desc: pointer to the HBQ selection profile descriptor.
|
||||
*
|
||||
* The Host Buffer Queue (HBQ) Selection Profile 5 specifies a header HBQ. The
|
||||
* HBA tests the initial frame of an incoming sequence using the frame's
|
||||
* R_CTL/TYPE fields with words 10:15 and performs the Sequence Length Test
|
||||
* and Byte Field Test using the fields in the Selection Profile 5 extension
|
||||
* words 20:31.
|
||||
**/
|
||||
static void
|
||||
lpfc_build_hbq_profile5(struct config_hbq_var *hbqmb,
|
||||
struct lpfc_hbq_init *hbq_desc)
|
||||
|
@ -581,6 +813,20 @@ lpfc_build_hbq_profile5(struct config_hbq_var *hbqmb,
|
|||
sizeof(hbqmb->profiles.profile5.cmdmatch));
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_config_hbq: Prepare a mailbox command for configuring an HBQ.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @id: HBQ identifier.
|
||||
* @hbq_desc: pointer to the HBA descriptor data structure.
|
||||
* @hbq_entry_index: index of the HBQ entry data structures.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The configure HBQ (Host Buffer Queue) mailbox command is used to configure
|
||||
* an HBQ. The configuration binds events that require buffers to a particular
|
||||
* ring and HBQ based on a selection profile.
|
||||
*
|
||||
* This routine prepares the mailbox command for configuring an HBQ.
|
||||
**/
|
||||
void
|
||||
lpfc_config_hbq(struct lpfc_hba *phba, uint32_t id,
|
||||
struct lpfc_hbq_init *hbq_desc,
|
||||
|
@ -641,8 +887,23 @@ lpfc_config_hbq(struct lpfc_hba *phba, uint32_t id,
|
|||
return;
|
||||
}
|
||||
|
||||
|
||||
|
||||
/**
|
||||
* lpfc_config_ring: Prepare a mailbox command for configuring an IOCB ring.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @ring:
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The configure ring mailbox command is used to configure an IOCB ring. This
|
||||
* configuration binds from one to six of HBA RC_CTL/TYPE mask entries to the
|
||||
* ring. This is used to map incoming sequences to a particular ring whose
|
||||
* RC_CTL/TYPE mask entry matches that of the sequence. The driver should not
|
||||
* attempt to configure a ring whose number is greater than the number
|
||||
* specified in the Port Control Block (PCB). It is an error to issue the
|
||||
* configure ring command more than once with the same ring number. The HBA
|
||||
* returns an error if the driver attempts this.
|
||||
*
|
||||
* This routine prepares the mailbox command for configuring IOCB ring.
|
||||
**/
|
||||
void
|
||||
lpfc_config_ring(struct lpfc_hba * phba, int ring, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -684,6 +945,20 @@ lpfc_config_ring(struct lpfc_hba * phba, int ring, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_config_port: Prepare a mailbox command for configuring port.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The configure port mailbox command is used to identify the Port Control
|
||||
* Block (PCB) in the driver memory. After this command is issued, the
|
||||
* driver must not access the mailbox in the HBA without first resetting
|
||||
* the HBA. The HBA may copy the PCB information to internal storage for
|
||||
* subsequent use; the driver can not change the PCB information unless it
|
||||
* resets the HBA.
|
||||
*
|
||||
* This routine prepares the mailbox command for configuring port.
|
||||
**/
|
||||
void
|
||||
lpfc_config_port(struct lpfc_hba *phba, LPFC_MBOXQ_t *pmb)
|
||||
{
|
||||
|
@ -839,6 +1114,21 @@ lpfc_config_port(struct lpfc_hba *phba, LPFC_MBOXQ_t *pmb)
|
|||
sizeof(PCB_t));
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_kill_board: Prepare a mailbox command for killing board.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @pmb: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* The kill board mailbox command is used to tell firmware to perform a
|
||||
* graceful shutdown of a channel on a specified board to prepare for reset.
|
||||
* When the kill board mailbox command is received, the ER3 bit is set to 1
|
||||
* in the Host Status register and the ER Attention bit is set to 1 in the
|
||||
* Host Attention register of the HBA function that received the kill board
|
||||
* command.
|
||||
*
|
||||
* This routine prepares the mailbox command for killing the board in
|
||||
* preparation for a graceful shutdown.
|
||||
**/
|
||||
void
|
||||
lpfc_kill_board(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
||||
{
|
||||
|
@ -850,6 +1140,16 @@ lpfc_kill_board(struct lpfc_hba * phba, LPFC_MBOXQ_t * pmb)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mbox_put: Put a mailbox cmd into the tail of driver's mailbox queue.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @mbq: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* Driver maintains a internal mailbox command queue implemented as a linked
|
||||
* list. When a mailbox command is issued, it shall be put into the mailbox
|
||||
* command queue such that they shall be processed orderly as HBA can process
|
||||
* one mailbox command at a time.
|
||||
**/
|
||||
void
|
||||
lpfc_mbox_put(struct lpfc_hba * phba, LPFC_MBOXQ_t * mbq)
|
||||
{
|
||||
|
@ -864,6 +1164,20 @@ lpfc_mbox_put(struct lpfc_hba * phba, LPFC_MBOXQ_t * mbq)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mbox_get: Remove a mailbox cmd from the head of driver's mailbox queue.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
*
|
||||
* Driver maintains a internal mailbox command queue implemented as a linked
|
||||
* list. When a mailbox command is issued, it shall be put into the mailbox
|
||||
* command queue such that they shall be processed orderly as HBA can process
|
||||
* one mailbox command at a time. After HBA finished processing a mailbox
|
||||
* command, the driver will remove a pending mailbox command from the head of
|
||||
* the mailbox command queue and send to the HBA for processing.
|
||||
*
|
||||
* Return codes
|
||||
* pointer to the driver internal queue element for mailbox command.
|
||||
**/
|
||||
LPFC_MBOXQ_t *
|
||||
lpfc_mbox_get(struct lpfc_hba * phba)
|
||||
{
|
||||
|
@ -877,6 +1191,17 @@ lpfc_mbox_get(struct lpfc_hba * phba)
|
|||
return mbq;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mbox_cmpl_put: Put mailbox command into mailbox command complete list.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @mbq: pointer to the driver internal queue element for mailbox command.
|
||||
*
|
||||
* This routine put the completed mailbox command into the mailbox command
|
||||
* complete list. This routine is called from driver interrupt handler
|
||||
* context.The mailbox complete list is used by the driver worker thread
|
||||
* to process mailbox complete callback functions outside the driver interrupt
|
||||
* handler.
|
||||
**/
|
||||
void
|
||||
lpfc_mbox_cmpl_put(struct lpfc_hba * phba, LPFC_MBOXQ_t * mbq)
|
||||
{
|
||||
|
@ -887,6 +1212,17 @@ lpfc_mbox_cmpl_put(struct lpfc_hba * phba, LPFC_MBOXQ_t * mbq)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mbox_tmo_val: Retrieve mailbox command timeout value.
|
||||
* @phba: pointer to lpfc hba data structure.
|
||||
* @cmd: mailbox command code.
|
||||
*
|
||||
* This routine retrieves the proper timeout value according to the mailbox
|
||||
* command code.
|
||||
*
|
||||
* Return codes
|
||||
* Timeout value to be used for the given mailbox command
|
||||
**/
|
||||
int
|
||||
lpfc_mbox_tmo_val(struct lpfc_hba *phba, int cmd)
|
||||
{
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
/*******************************************************************
|
||||
* This file is part of the Emulex Linux Device Driver for *
|
||||
* Fibre Channel Host Bus Adapters. *
|
||||
* Copyright (C) 2004-2006 Emulex. All rights reserved. *
|
||||
* Copyright (C) 2004-2008 Emulex. All rights reserved. *
|
||||
* EMULEX and SLI are trademarks of Emulex. *
|
||||
* www.emulex.com *
|
||||
* Portions Copyright (C) 2004-2005 Christoph Hellwig *
|
||||
|
@ -39,7 +39,21 @@
|
|||
#define LPFC_MEM_POOL_SIZE 64 /* max elem in non-DMA safety pool */
|
||||
|
||||
|
||||
|
||||
/**
|
||||
* lpfc_mem_alloc: create and allocate all PCI and memory pools
|
||||
* @phba: HBA to allocate pools for
|
||||
*
|
||||
* Description: Creates and allocates PCI pools lpfc_scsi_dma_buf_pool,
|
||||
* lpfc_mbuf_pool, lpfc_hbq_pool. Creates and allocates kmalloc-backed mempools
|
||||
* for LPFC_MBOXQ_t and lpfc_nodelist. Also allocates the VPI bitmask.
|
||||
*
|
||||
* Notes: Not interrupt-safe. Must be called with no locks held. If any
|
||||
* allocation fails, frees all successfully allocated memory before returning.
|
||||
*
|
||||
* Returns:
|
||||
* 0 on success
|
||||
* -ENOMEM on failure (if any memory allocations fail)
|
||||
**/
|
||||
int
|
||||
lpfc_mem_alloc(struct lpfc_hba * phba)
|
||||
{
|
||||
|
@ -120,6 +134,16 @@ lpfc_mem_alloc(struct lpfc_hba * phba)
|
|||
return -ENOMEM;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mem_free: Frees all PCI and memory allocated by lpfc_mem_alloc
|
||||
* @phba: HBA to free memory for
|
||||
*
|
||||
* Description: Frees PCI pools lpfc_scsi_dma_buf_pool, lpfc_mbuf_pool,
|
||||
* lpfc_hbq_pool. Frees kmalloc-backed mempools for LPFC_MBOXQ_t and
|
||||
* lpfc_nodelist. Also frees the VPI bitmask.
|
||||
*
|
||||
* Returns: None
|
||||
**/
|
||||
void
|
||||
lpfc_mem_free(struct lpfc_hba * phba)
|
||||
{
|
||||
|
@ -181,12 +205,29 @@ lpfc_mem_free(struct lpfc_hba * phba)
|
|||
phba->lpfc_scsi_dma_buf_pool = NULL;
|
||||
phba->lpfc_mbuf_pool = NULL;
|
||||
|
||||
/* Free the iocb lookup array */
|
||||
/* Free the iocb lookup array */
|
||||
kfree(psli->iocbq_lookup);
|
||||
psli->iocbq_lookup = NULL;
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mbuf_alloc: Allocate an mbuf from the lpfc_mbuf_pool PCI pool
|
||||
* @phba: HBA which owns the pool to allocate from
|
||||
* @mem_flags: indicates if this is a priority (MEM_PRI) allocation
|
||||
* @handle: used to return the DMA-mapped address of the mbuf
|
||||
*
|
||||
* Description: Allocates a DMA-mapped buffer from the lpfc_mbuf_pool PCI pool.
|
||||
* Allocates from generic pci_pool_alloc function first and if that fails and
|
||||
* mem_flags has MEM_PRI set (the only defined flag), returns an mbuf from the
|
||||
* HBA's pool.
|
||||
*
|
||||
* Notes: Not interrupt-safe. Must be called with no locks held. Takes
|
||||
* phba->hbalock.
|
||||
*
|
||||
* Returns:
|
||||
* pointer to the allocated mbuf on success
|
||||
* NULL on failure
|
||||
**/
|
||||
void *
|
||||
lpfc_mbuf_alloc(struct lpfc_hba *phba, int mem_flags, dma_addr_t *handle)
|
||||
{
|
||||
|
@ -206,6 +247,20 @@ lpfc_mbuf_alloc(struct lpfc_hba *phba, int mem_flags, dma_addr_t *handle)
|
|||
return ret;
|
||||
}
|
||||
|
||||
/**
|
||||
* __lpfc_mem_free: Free an mbuf from the lpfc_mbuf_pool PCI pool (locked)
|
||||
* @phba: HBA which owns the pool to return to
|
||||
* @virt: mbuf to free
|
||||
* @dma: the DMA-mapped address of the lpfc_mbuf_pool to be freed
|
||||
*
|
||||
* Description: Returns an mbuf lpfc_mbuf_pool to the lpfc_mbuf_safety_pool if
|
||||
* it is below its max_count, frees the mbuf otherwise.
|
||||
*
|
||||
* Notes: Must be called with phba->hbalock held to synchronize access to
|
||||
* lpfc_mbuf_safety_pool.
|
||||
*
|
||||
* Returns: None
|
||||
**/
|
||||
void
|
||||
__lpfc_mbuf_free(struct lpfc_hba * phba, void *virt, dma_addr_t dma)
|
||||
{
|
||||
|
@ -221,7 +276,21 @@ __lpfc_mbuf_free(struct lpfc_hba * phba, void *virt, dma_addr_t dma)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mem_free: Free an mbuf from the lpfc_mbuf_pool PCI pool (unlocked)
|
||||
* @phba: HBA which owns the pool to return to
|
||||
* @virt: mbuf to free
|
||||
* @dma: the DMA-mapped address of the lpfc_mbuf_pool to be freed
|
||||
*
|
||||
* Description: Returns an mbuf lpfc_mbuf_pool to the lpfc_mbuf_safety_pool if
|
||||
* it is below its max_count, frees the mbuf otherwise.
|
||||
*
|
||||
* Notes: Takes phba->hbalock. Can be called with or without other locks held.
|
||||
*
|
||||
* Returns: None
|
||||
**/
|
||||
void
|
||||
|
||||
lpfc_mbuf_free(struct lpfc_hba * phba, void *virt, dma_addr_t dma)
|
||||
{
|
||||
unsigned long iflags;
|
||||
|
@ -232,6 +301,19 @@ lpfc_mbuf_free(struct lpfc_hba * phba, void *virt, dma_addr_t dma)
|
|||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_els_hbq_alloc: Allocate an HBQ buffer
|
||||
* @phba: HBA to allocate HBQ buffer for
|
||||
*
|
||||
* Description: Allocates a DMA-mapped HBQ buffer from the lpfc_hbq_pool PCI
|
||||
* pool along a non-DMA-mapped container for it.
|
||||
*
|
||||
* Notes: Not interrupt-safe. Must be called with no locks held.
|
||||
*
|
||||
* Returns:
|
||||
* pointer to HBQ on success
|
||||
* NULL on failure
|
||||
**/
|
||||
struct hbq_dmabuf *
|
||||
lpfc_els_hbq_alloc(struct lpfc_hba *phba)
|
||||
{
|
||||
|
@ -251,6 +333,18 @@ lpfc_els_hbq_alloc(struct lpfc_hba *phba)
|
|||
return hbqbp;
|
||||
}
|
||||
|
||||
/**
|
||||
* lpfc_mem_hbq_free: Frees an HBQ buffer allocated with lpfc_els_hbq_alloc
|
||||
* @phba: HBA buffer was allocated for
|
||||
* @hbqbp: HBQ container returned by lpfc_els_hbq_alloc
|
||||
*
|
||||
* Description: Frees both the container and the DMA-mapped buffer returned by
|
||||
* lpfc_els_hbq_alloc.
|
||||
*
|
||||
* Notes: Can be called with or without locks held.
|
||||
*
|
||||
* Returns: None
|
||||
**/
|
||||
void
|
||||
lpfc_els_hbq_free(struct lpfc_hba *phba, struct hbq_dmabuf *hbqbp)
|
||||
{
|
||||
|
@ -259,7 +353,18 @@ lpfc_els_hbq_free(struct lpfc_hba *phba, struct hbq_dmabuf *hbqbp)
|
|||
return;
|
||||
}
|
||||
|
||||
/* This is ONLY called for the LPFC_ELS_HBQ */
|
||||
/**
|
||||
* lpfc_in_buf_free: Free a DMA buffer
|
||||
* @phba: HBA buffer is associated with
|
||||
* @mp: Buffer to free
|
||||
*
|
||||
* Description: Frees the given DMA buffer in the appropriate way given if the
|
||||
* HBA is running in SLI3 mode with HBQs enabled.
|
||||
*
|
||||
* Notes: Takes phba->hbalock. Can be called with or without other locks held.
|
||||
*
|
||||
* Returns: None
|
||||
**/
|
||||
void
|
||||
lpfc_in_buf_free(struct lpfc_hba *phba, struct lpfc_dmabuf *mp)
|
||||
{
|
||||
|
|
File diff suppressed because it is too large
Load diff
Reference in a new issue