lpfc : Correct kdoc syntax errors in lpfc_mbox.c/mem.c/scsi.c
Subsystems (2)
PATCH 5/5 lpfc : Correct kdoc syntax errors in lpfc_mbox.c/mem.c/scsi.c
Signed-off-by James Smart <[email protected]>
---
lpfc_mbox.c | 62 ++++++++++++++++++++++---------------------- lpfc_mem.c | 23 +++++++--------- lpfc_scsi.c | 83 +++++++++++++++++++++++++++--------------------------------- 3 files changed, 80 insertions(+), 88 deletions(-)
drivers/scsi/lpfc/lpfc_mbox.c +31 -31
@@ -39,7 +39,7 @@#include "lpfc_compat.h" /** -* lpfc_dump_mem: Prepare a mailbox command for retrieving HBA's VPD memory. +* 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.
@@ -77,7 +77,7 @@ lpfc_dump_mem(struct lpfc_hba * phba, LP }/** -* lpfc_dump_mem: Prepare a mailbox command for retrieving wakeup params. +* lpfc_dump_mem - Prepare a mailbox command for retrieving wakeup params * @phba: pointer to lpfc hba data structure. * @pmb: pointer to the driver internal queue element for mailbox command. * This function create a dump memory mailbox command to dump wake up
@@ -109,7 +109,7 @@ lpfc_dump_wakeup_param(struct lpfc_hba * }/** -* lpfc_read_nv: Prepare a mailbox command for reading HBA's NVRAM param. +* 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. *
@@ -132,7 +132,7 @@ lpfc_read_nv(struct lpfc_hba * phba, LPF }/** -* lpfc_config_async: Prepare a mailbox command for enabling HBA async event. +* 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.
@@ -159,7 +159,7 @@ lpfc_config_async(struct lpfc_hba * phba }/** -* lpfc_heart_beat: Prepare a mailbox command for heart beat. +* 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. *
@@ -184,7 +184,7 @@ lpfc_heart_beat(struct lpfc_hba * phba, }/** -* lpfc_read_la: Prepare a mailbox command for reading HBA link attention. +* 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.
@@ -228,7 +228,7 @@ lpfc_read_la(struct lpfc_hba * phba, LPF }/** -* lpfc_clear_la: Prepare a mailbox command for clearing HBA link attention. +* 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. *
@@ -257,7 +257,7 @@ lpfc_clear_la(struct lpfc_hba * phba, LP }/** -* lpfc_config_link: Prepare a mailbox command for configuring link on a HBA. +* 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. *
@@ -305,7 +305,7 @@ lpfc_config_link(struct lpfc_hba * phba, }/** -* lpfc_config_msi: Prepare a mailbox command for configuring msi-x. +* lpfc_config_msi - Prepare a mailbox command for configuring msi-x * @phba: pointer to lpfc hba data structure. * @pmb: pointer to the driver internal queue element for mailbox command. *
@@ -383,7 +383,7 @@ lpfc_config_msi(struct lpfc_hba *phba, L }/** -* lpfc_init_link: Prepare a mailbox command for initialize link on a HBA. +* 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.
@@ -463,7 +463,7 @@ lpfc_init_link(struct lpfc_hba * phba, }/** -* lpfc_read_sparam: Prepare a mailbox command for reading HBA parameters. +* 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.
@@ -523,7 +523,7 @@ lpfc_read_sparam(struct lpfc_hba *phba, }/** -* lpfc_unreg_did: Prepare a mailbox command for unregistering DID. +* 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.
@@ -555,7 +555,7 @@ lpfc_unreg_did(struct lpfc_hba * phba, u }/** -* lpfc_read_config: Prepare a mailbox command for reading HBA configuration. +* 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. *
@@ -581,7 +581,7 @@ lpfc_read_config(struct lpfc_hba * phba, }/** -* lpfc_read_lnk_stat: Prepare a mailbox command for reading HBA link stats. +* 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. *
@@ -606,7 +606,7 @@ lpfc_read_lnk_stat(struct lpfc_hba * phb }/** -* lpfc_reg_login: Prepare a mailbox command for registering remote login. +* 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.
@@ -677,7 +677,7 @@ lpfc_reg_login(struct lpfc_hba *phba, ui }/** -* lpfc_unreg_login: Prepare a mailbox command for unregistering remote login. +* 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
@@ -709,7 +709,7 @@ lpfc_unreg_login(struct lpfc_hba *phba, }/** -* lpfc_reg_vpi: Prepare a mailbox command for registering vport identifier. +* 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).
@@ -741,7 +741,7 @@ lpfc_reg_vpi(struct lpfc_hba *phba, uint }/** -* lpfc_unreg_vpi: Prepare a mailbox command for unregistering vport id. +* 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.
@@ -771,7 +771,7 @@ lpfc_unreg_vpi(struct lpfc_hba *phba, ui }/** -* lpfc_config_pcb_setup: Set up IOCB rings in the Port Control Block (PCB) +* 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
@@ -835,7 +835,7 @@ lpfc_config_pcb_setup(struct lpfc_hba * }/** -* lpfc_read_rev: Prepare a mailbox command for reading HBA revision. +* 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. *
@@ -861,7 +861,7 @@ lpfc_read_rev(struct lpfc_hba * phba, LP }/** -* lpfc_build_hbq_profile2: Set up the HBQ Selection Profile 2. +* 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. *
@@ -880,7 +880,7 @@ lpfc_build_hbq_profile2(struct config_hb }/** -* lpfc_build_hbq_profile3: Set up the HBQ Selection Profile 3. +* 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. *
@@ -902,7 +902,7 @@ lpfc_build_hbq_profile3(struct config_hb }/** -* lpfc_build_hbq_profile5: Set up the HBQ Selection Profile 5. +* 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. *
@@ -925,7 +925,7 @@ lpfc_build_hbq_profile5(struct config_hb }/** -* lpfc_config_hbq: Prepare a mailbox command for configuring an HBQ. +* 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.
@@ -999,7 +999,7 @@ lpfc_config_hbq(struct lpfc_hba *phba, u }/** -* lpfc_config_ring: Prepare a mailbox command for configuring an IOCB ring. +* 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.
@@ -1057,7 +1057,7 @@ lpfc_config_ring(struct lpfc_hba * phba, }/** -* lpfc_config_port: Prepare a mailbox command for configuring port. +* 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. *
@@ -1227,7 +1227,7 @@ lpfc_config_port(struct lpfc_hba *phba, }/** -* lpfc_kill_board: Prepare a mailbox command for killing board. +* 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. *
@@ -1253,7 +1253,7 @@ lpfc_kill_board(struct lpfc_hba * phba, }/** -* lpfc_mbox_put: Put a mailbox cmd into the tail of driver's mailbox queue. +* 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. *
@@ -1277,7 +1277,7 @@ lpfc_mbox_put(struct lpfc_hba * phba, LP }/** -* lpfc_mbox_get: Remove a mailbox cmd from the head of driver's mailbox queue. +* 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
@@ -1304,7 +1304,7 @@ lpfc_mbox_get(struct lpfc_hba * phba) }/** -* lpfc_mbox_cmpl_put: Put mailbox command into mailbox command complete list. +* 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. *
@@ -1327,7 +1327,7 @@ lpfc_mbox_cmpl_put(struct lpfc_hba * phb }/** -* lpfc_mbox_tmo_val: Retrieve mailbox command timeout value. +* lpfc_mbox_tmo_val - Retrieve mailbox command timeout value * @phba: pointer to lpfc hba data structure. * @cmd: mailbox command code. *
drivers/scsi/lpfc/lpfc_mem.c +11 -12
@@ -41,7 +41,7 @@/** -* lpfc_mem_alloc: create and allocate all PCI and memory pools +* 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,
@@ -136,12 +136,12 @@ lpfc_mem_alloc(struct lpfc_hba * phba) }/** -* lpfc_mem_free: Frees all PCI and memory allocated by lpfc_mem_alloc +* 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. +* lpfc_nodelist. Also frees the VPI bitmask * * Returns: None **/
@@ -212,7 +212,7 @@ lpfc_mem_free(struct lpfc_hba * phba) }/** -* lpfc_mbuf_alloc: Allocate an mbuf from the lpfc_mbuf_pool PCI pool +* 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
@@ -249,7 +249,7 @@ lpfc_mbuf_alloc(struct lpfc_hba *phba, i }/** -* __lpfc_mem_free: Free an mbuf from the lpfc_mbuf_pool PCI pool (locked) +* __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
@@ -258,7 +258,7 @@ lpfc_mbuf_alloc(struct lpfc_hba *phba, i* 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. +* lpfc_mbuf_safety_pool * * Returns: None **/
@@ -278,7 +278,7 @@ __lpfc_mbuf_free(struct lpfc_hba * phba, }/** -* lpfc_mem_free: Free an mbuf from the lpfc_mbuf_pool PCI pool (unlocked) +* 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
@@ -291,7 +291,6 @@ __lpfc_mbuf_free(struct lpfc_hba * phba,* Returns: None **/ void -lpfc_mbuf_free (struct lpfc_hba * phba,void *virt,dma_addr_t dma) {unsigned long iflags;
@@ -303,7 +302,7 @@ lpfc_mbuf_free(struct lpfc_hba * phba, v }/** -* lpfc_els_hbq_alloc: Allocate an HBQ buffer +* 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
@@ -335,12 +334,12 @@ lpfc_els_hbq_alloc(struct lpfc_hba *phba }/** -* lpfc_mem_hbq_free: Frees an HBQ buffer allocated with lpfc_els_hbq_alloc +* 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. +* lpfc_els_hbq_alloc * * Notes: Can be called with or without locks held. *
@@ -355,7 +354,7 @@ lpfc_els_hbq_free(struct lpfc_hba *phba, }/** -* lpfc_in_buf_free: Free a DMA buffer +* lpfc_in_buf_free - Free a DMA buffer * @phba: HBA buffer is associated with * @mp: Buffer to free *
drivers/scsi/lpfc/lpfc_scsi.c +38 -45
297 lines not on this page · raw message