lpfc : Correct kdoc syntax errors in lpfc_debugfs.c/hbadisc.c/init.c/vport.c
Subsystems (2)
PATCH 4/5 lpfc : Correct kdoc syntax errors in lpfc_debugfs.c/hbadisc.c/init.c/vport.c
Signed-off-by James Smart <[email protected]>
---
lpfc_debugfs.c | 47 ++++++++++++-------------- lpfc_hbadisc.c | 8 ++-- lpfc_init.c | 101 ++++++++++++++++++++++++++++----------------------------- lpfc_vport.c | 10 ++--- 4 files changed, 81 insertions(+), 85 deletions(-)
drivers/scsi/lpfc/lpfc_debugfs.c +23 -24
@@ -47,7 +47,7 @@#include "lpfc_debugfs.h" #ifdef CONFIG_SCSI_LPFC_DEBUG_FS -/** +/* * debugfs interface * * To access this interface the user should:
@@ -62,7 +62,7 @@* Debugging services available per vport: * 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. +* 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: * lpfc_debugfs_enable=1 Turns on lpfc debugfs filesystem support
@@ -73,13 +73,12 @@* * 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. +* 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 ; +*/ static int lpfc_debugfs_enable =1 ;module_param (lpfc_debugfs_enable, int,0 );MODULE_PARM_DESC (lpfc_debugfs_enable,"Enable debugfs services" );
@@ -127,7 +126,7 @@ static atomic_t lpfc_debugfs_seq_trc_cntstatic unsigned long lpfc_debugfs_start_time =0L ;/** -* lpfc_debugfs_disc_trc_data - Dump discovery logging to a buffer. +* 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.
@@ -187,7 +186,7 @@ lpfc_debugfs_disc_trc_data(struct lpfc_v }/** -* lpfc_debugfs_slow_ring_trc_data - Dump slow ring logging to a buffer. +* 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.
@@ -250,7 +249,7 @@ lpfc_debugfs_slow_ring_trc_data(struct lstatic int lpfc_debugfs_last_hbq =-1 ;/** -* lpfc_debugfs_hbqinfo_data - Dump host buffer queue info to a buffer. +* 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.
@@ -369,7 +368,7 @@ skipit:static int lpfc_debugfs_last_hba_slim_off;/** -* lpfc_debugfs_dumpHBASlim_data - Dump HBA SLIM info to a buffer. +* 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.
@@ -426,7 +425,7 @@ lpfc_debugfs_dumpHBASlim_data(struct lpf }/** -* lpfc_debugfs_dumpHostSlim_data - Dump host SLIM info to a buffer. +* 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.
@@ -501,7 +500,7 @@ lpfc_debugfs_dumpHostSlim_data(struct lp }/** -* lpfc_debugfs_nodelist_data - Dump target node list to a buffer. +* 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.
@@ -599,7 +598,7 @@ lpfc_debugfs_nodelist_data(struct lpfc_v#endif /** -* lpfc_debugfs_disc_trc - Store discovery trace log. +* 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.
@@ -643,7 +642,7 @@ lpfc_debugfs_disc_trc(struct lpfc_vport }/** -* lpfc_debugfs_slow_ring_trc - Store slow ring trace log. +* 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.
@@ -682,7 +681,7 @@ lpfc_debugfs_slow_ring_trc(struct lpfc_h#ifdef CONFIG_SCSI_LPFC_DEBUG_FS /** -* lpfc_debugfs_disc_trc_open - Open the discovery trace log. +* 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. *
@@ -732,7 +731,7 @@ out: }/** -* lpfc_debugfs_slow_ring_trc_open - Open the Slow Ring trace log. +* 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. *
@@ -782,7 +781,7 @@ out: }/** -* lpfc_debugfs_hbqinfo_open - Open the hbqinfo debugfs buffer. +* 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. *
@@ -824,7 +823,7 @@ out: }/** -* lpfc_debugfs_dumpHBASlim_open - Open the Dump HBA SLIM debugfs buffer. +* 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. *
@@ -866,7 +865,7 @@ out: }/** -* lpfc_debugfs_dumpHostSlim_open - Open the Dump Host SLIM debugfs buffer. +* 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. *
@@ -993,7 +992,7 @@ lpfc_debugfs_dumpDataDif_write(struct fi/** -* lpfc_debugfs_nodelist_open - Open the nodelist debugfs file. +* 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. *
@@ -1035,7 +1034,7 @@ out: }/** -* lpfc_debugfs_lseek - Seek through a debugfs file. +* 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.
@@ -1073,7 +1072,7 @@ lpfc_debugfs_lseek(struct file *file, lo }/** -* lpfc_debugfs_read - Read a debugfs file. +* 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.
@@ -1098,7 +1097,7 @@ lpfc_debugfs_read(struct file *file, cha }/** -* lpfc_debugfs_release - Release the buffer used to store debugfs file data. +* 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. *
@@ -1210,7 +1209,7 @@ static atomic_t lpfc_debugfs_hba_count;#endif /** -* lpfc_debugfs_initialize - Initialize debugfs for a vport. +* lpfc_debugfs_initialize - Initialize debugfs for a vport * @vport: The vport pointer to initialize. * * Description:
@@ -1434,7 +1433,7 @@ debug_failed: }/** -* lpfc_debugfs_terminate - Tear down debugfs infrastructure for this vport. +* lpfc_debugfs_terminate - Tear down debugfs infrastructure for this vport * @vport: The vport pointer to remove from debugfs. * * Description:
drivers/scsi/lpfc/lpfc_hbadisc.c +4 -4
@@ -276,7 +276,7 @@ lpfc_dev_loss_tmo_handler(struct lpfc_no }/** -* lpfc_alloc_fast_evt: Allocates data structure for posting event. +* lpfc_alloc_fast_evt - Allocates data structure for posting event * @phba: Pointer to hba context object. * * This function is called from the functions which need to post
@@ -303,7 +303,7 @@ lpfc_alloc_fast_evt(struct lpfc_hba *phb }/** -* lpfc_free_fast_evt: Frees event data structure. +* lpfc_free_fast_evt - Frees event data structure * @phba: Pointer to hba context object. * @evt: Event object which need to be freed. *
@@ -319,7 +319,7 @@ lpfc_free_fast_evt(struct lpfc_hba *phba }/** -* lpfc_send_fastpath_evt: Posts events generated from fast path. +* lpfc_send_fastpath_evt - Posts events generated from fast path * @phba: Pointer to hba context object. * @evtp: Event data structure. *
@@ -1858,7 +1858,7 @@ lpfc_disable_node(struct lpfc_vport *vpo NLP_STE_UNUSED_NODE); }/** -* lpfc_initialize_node: Initialize all fields of node object. +* lpfc_initialize_node - Initialize all fields of node object * @vport: Pointer to Virtual Port object. * @ndlp: Pointer to FC node object. * @did: FC_ID of the node.
drivers/scsi/lpfc/lpfc_init.c +50 -51
401 lines not on this page · raw message
drivers/scsi/lpfc/lpfc_vport.c +4 -6
@@ -206,7 +206,7 @@ lpfc_unique_wwpn(struct lpfc_hba *phba, }/** -* lpfc_discovery_wait: Wait for driver discovery to quiesce. +* lpfc_discovery_wait - Wait for driver discovery to quiesce * @vport: The virtual port for which this call is being executed. * * This driver calls this routine specifically from lpfc_vport_delete
@@ -741,7 +741,7 @@ lpfc_destroy_vport_work_array(struct lpf/** -* lpfc_vport_reset_stat_data: Reset the statistical data for the vport. +* lpfc_vport_reset_stat_data - Reset the statistical data for the vport * @vport: Pointer to vport object. * * This function resets the statistical data for the vport. This function
@@ -763,8 +763,7 @@ lpfc_vport_reset_stat_data(struct lpfc_v/** -* lpfc_alloc_bucket: Allocate data buffer required for collecting -* statistical data. +* lpfc_alloc_bucket - Allocate data buffer required for statistical data * @vport: Pointer to vport object. * * This function allocates data buffer required for all the FC
@@ -797,8 +796,7 @@ lpfc_alloc_bucket(struct lpfc_vport *vpo }/** -* lpfc_free_bucket: Free data buffer required for collecting -* statistical data. +* lpfc_free_bucket - Free data buffer required for statistical data * @vport: Pointer to vport object. * * Th function frees statistical data buffer of all the FC