UbiquitousOS
/
OpenCloudOS-Kernel
mirror of https://gitee.com/OpenCloudOS/OpenCloudOS-Kernel.git
11
0
Fork 0
Code Issues Projects Releases Wiki Activity

RDMA: Fix kernel-doc compilation warnings 

This patch fixes bunch of kernel-doc compilation warnings like below:

 drivers/infiniband/hw/i40iw/i40iw_cm.c:4372: warning: expecting prototype for i40iw_ifdown_notify(). Prototype was for i40iw_if_notify() instead

Link: https://lore.kernel.org/r/20210314133908.291945-2-leon@kernel.org
Signed-off-by: Leon Romanovsky <leonro@nvidia.com>
Signed-off-by: Jason Gunthorpe <jgg@nvidia.com>
This commit is contained in:
Leon Romanovsky 2021-03-14 15:39:07 +02:00 committed by Jason Gunthorpe
parent b5486430bb
commit ae360f41b1
20 changed files with 36 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
drivers/infiniband/hw/hfi1/chip.c
View File

@ -1322,7 +1322,7 @@ CNTR_ELEM(#name, \
access_ibp_##cntr) access_ibp_##cntr)
/** /**
* hfi_addr_from_offset - return addr for readq/writeq * hfi1_addr_from_offset - return addr for readq/writeq
* @dd: the dd device * @dd: the dd device
* @offset: the offset of the CSR within bar0 * @offset: the offset of the CSR within bar0
* *
@ -8316,7 +8316,7 @@ static void is_interrupt(struct hfi1_devdata *dd, unsigned int source)
} }
/** /**
* gerneral_interrupt() - General interrupt handler * general_interrupt - General interrupt handler
* @irq: MSIx IRQ vector * @irq: MSIx IRQ vector
* @data: hfi1 devdata * @data: hfi1 devdata
* *

2
drivers/infiniband/hw/hfi1/driver.c
View File

@ -1026,7 +1026,7 @@ static bool __set_armed_to_active(struct hfi1_packet *packet)
} }
/** /**
* armed to active - the fast path for armed to active * set_armed_to_active - the fast path for armed to active
* @packet: the packet structure * @packet: the packet structure
* *
* Return true if packet processing needs to bail. * Return true if packet processing needs to bail.

6
drivers/infiniband/hw/hfi1/exp_rcv.c
View File

@ -49,7 +49,7 @@
#include "trace.h" #include "trace.h"
/** /**
* exp_tid_group_init - initialize exp_tid_set * hfi1_exp_tid_set_init - initialize exp_tid_set
* @set: the set * @set: the set
*/ */
static void hfi1_exp_tid_set_init(struct exp_tid_set *set) static void hfi1_exp_tid_set_init(struct exp_tid_set *set)
@ -70,7 +70,7 @@ void hfi1_exp_tid_group_init(struct hfi1_ctxtdata *rcd)
} }
/** /**
* alloc_ctxt_rcv_groups - initialize expected receive groups * hfi1_alloc_ctxt_rcv_groups - initialize expected receive groups
* @rcd: the context to add the groupings to * @rcd: the context to add the groupings to
*/ */
int hfi1_alloc_ctxt_rcv_groups(struct hfi1_ctxtdata *rcd) int hfi1_alloc_ctxt_rcv_groups(struct hfi1_ctxtdata *rcd)
@ -100,7 +100,7 @@ int hfi1_alloc_ctxt_rcv_groups(struct hfi1_ctxtdata *rcd)
} }
/** /**
* free_ctxt_rcv_groups - free expected receive groups * hfi1_free_ctxt_rcv_groups - free expected receive groups
* @rcd: the context to free * @rcd: the context to free
* *
* The routine dismantles the expect receive linked * The routine dismantles the expect receive linked

3
drivers/infiniband/hw/hfi1/init.c
View File

@ -1852,7 +1852,8 @@ bail:
} }
/** /**
* allocate eager buffers, both kernel and user contexts. * hfi1_setup_eagerbufs - llocate eager buffers, both kernel and user
* contexts.
* @rcd: the context we are setting up. * @rcd: the context we are setting up.
* *
* Allocate the eager TID buffers and program them into hip. * Allocate the eager TID buffers and program them into hip.

12
drivers/infiniband/hw/hfi1/msix.c
View File

@ -206,7 +206,7 @@ int msix_request_rcd_irq(struct hfi1_ctxtdata *rcd)
} }
/** /**
* msix_request_rcd_irq() - Helper function for RCVAVAIL IRQs * msix_netdev_request_rcd_irq - Helper function for RCVAVAIL IRQs
* for netdev context * for netdev context
* @rcd: valid netdev contexti * @rcd: valid netdev contexti
*/ */
@ -221,7 +221,7 @@ int msix_netdev_request_rcd_irq(struct hfi1_ctxtdata *rcd)
} }
/** /**
* msix_request_smda_ira() - Helper for getting SDMA IRQ resources * msix_request_sdma_irq - Helper for getting SDMA IRQ resources
* @sde: valid sdma engine * @sde: valid sdma engine
* *
*/ */
@ -243,7 +243,7 @@ int msix_request_sdma_irq(struct sdma_engine *sde)
} }
/** /**
* msix_request_general_irq(void) - Helper for getting general IRQ * msix_request_general_irq - Helper for getting general IRQ
* resources * resources
* @dd: valid device data * @dd: valid device data
*/ */
@ -269,7 +269,7 @@ int msix_request_general_irq(struct hfi1_devdata *dd)
} }
/** /**
* enable_sdma_src() - Helper to enable SDMA IRQ srcs * enable_sdma_srcs - Helper to enable SDMA IRQ srcs
* @dd: valid devdata structure * @dd: valid devdata structure
* @i: index of SDMA engine * @i: index of SDMA engine
*/ */
@ -349,7 +349,7 @@ void msix_free_irq(struct hfi1_devdata *dd, u8 msix_intr)
} }
/** /**
* hfi1_clean_up_msix_interrupts() - Free all MSIx IRQ resources * msix_clean_up_interrupts - Free all MSIx IRQ resources
* @dd: valid device data data structure * @dd: valid device data data structure
* *
* Free the MSIx and associated PCI resources, if they have been allocated. * Free the MSIx and associated PCI resources, if they have been allocated.
@ -372,7 +372,7 @@ void msix_clean_up_interrupts(struct hfi1_devdata *dd)
} }
/** /**
* msix_netdev_syncrhonize_irq() - netdev IRQ synchronize * msix_netdev_synchronize_irq - netdev IRQ synchronize
* @dd: valid devdata * @dd: valid devdata
*/ */
void msix_netdev_synchronize_irq(struct hfi1_devdata *dd) void msix_netdev_synchronize_irq(struct hfi1_devdata *dd)

2
drivers/infiniband/hw/hfi1/netdev_rx.c
View File

@ -464,7 +464,7 @@ void *hfi1_netdev_get_data(struct hfi1_devdata *dd, int id)
} }
/** /**
* hfi1_netdev_get_first_dat - Gets first entry with greater or equal id. * hfi1_netdev_get_first_data - Gets first entry with greater or equal id.
* *
* @dd: hfi1 dev data * @dd: hfi1 dev data
* @start_id: requested integer id up to INT_MAX * @start_id: requested integer id up to INT_MAX

2
drivers/infiniband/hw/hfi1/sdma.c
View File

@ -1285,7 +1285,7 @@ bail:
} }
/** /**
* sdma_clean() Clean up allocated memory * sdma_clean - Clean up allocated memory
* @dd: struct hfi1_devdata * @dd: struct hfi1_devdata
* @num_engines: num sdma engines * @num_engines: num sdma engines
* *

4
drivers/infiniband/hw/i40iw/i40iw_cm.c
View File

@ -905,7 +905,7 @@ static int i40iw_send_mpa_reject(struct i40iw_cm_node *cm_node,
} }
/** /**
* recv_mpa - process an IETF MPA frame * i40iw_parse_mpa - process an IETF MPA frame
* @cm_node: connection's node * @cm_node: connection's node
* @buffer: Data pointer * @buffer: Data pointer
* @type: to return accept or reject * @type: to return accept or reject
@ -4360,7 +4360,7 @@ void i40iw_cm_teardown_connections(struct i40iw_device *iwdev, u32 *ipaddr,
} }
/** /**
* i40iw_ifdown_notify - process an ifdown on an interface * i40iw_if_notify - process an ifdown on an interface
* @iwdev: device pointer * @iwdev: device pointer
* @netdev: network interface device structure * @netdev: network interface device structure
* @ipaddr: Pointer to IPv4 or IPv6 address * @ipaddr: Pointer to IPv4 or IPv6 address

4
drivers/infiniband/hw/i40iw/i40iw_hmc.c
View File

@ -285,7 +285,7 @@ static enum i40iw_status_code i40iw_hmc_finish_add_sd_reg(struct i40iw_sc_dev *d
} }
/** /**
* i40iw_create_iw_hmc_obj - allocate backing store for hmc objects * i40iw_sc_create_hmc_obj - allocate backing store for hmc objects
* @dev: pointer to the device structure * @dev: pointer to the device structure
* @info: pointer to i40iw_hmc_iw_create_obj_info struct * @info: pointer to i40iw_hmc_iw_create_obj_info struct
* *
@ -434,7 +434,7 @@ static enum i40iw_status_code i40iw_finish_del_sd_reg(struct i40iw_sc_dev *dev,
} }
/** /**
* i40iw_del_iw_hmc_obj - remove pe hmc objects * i40iw_sc_del_hmc_obj - remove pe hmc objects
* @dev: pointer to the device structure * @dev: pointer to the device structure
* @info: pointer to i40iw_hmc_del_obj_info struct * @info: pointer to i40iw_hmc_del_obj_info struct
* @reset: true if called before reset * @reset: true if called before reset

2
drivers/infiniband/hw/i40iw/i40iw_main.c
View File

@ -251,7 +251,7 @@ static void i40iw_destroy_cqp(struct i40iw_device *iwdev, bool free_hwcqp)
} }
/** /**
* i40iw_disable_irqs - disable device interrupts * i40iw_disable_irq - disable device interrupts
* @dev: hardware control device structure * @dev: hardware control device structure
* @msix_vec: msix vector to disable irq * @msix_vec: msix vector to disable irq
* @dev_id: parameter to pass to free_irq (used during irq setup) * @dev_id: parameter to pass to free_irq (used during irq setup)

2
drivers/infiniband/hw/i40iw/i40iw_puda.c
View File

@ -1000,7 +1000,7 @@ static void i40iw_ilq_putback_rcvbuf(struct i40iw_sc_qp *qp, u32 wqe_idx)
} }
/** /**
* i40iw_ieq_get_fpdu - given length return fpdu length * i40iw_ieq_get_fpdu_length - given length return fpdu length
* @length: length if fpdu * @length: length if fpdu
*/ */
static u16 i40iw_ieq_get_fpdu_length(u16 length) static u16 i40iw_ieq_get_fpdu_length(u16 length)

2
drivers/infiniband/hw/i40iw/i40iw_utils.c
View File

@ -890,7 +890,7 @@ void i40iw_terminate_done(struct i40iw_sc_qp *qp, int timeout_occurred)
} }
/** /**
* i40iw_terminate_imeout - timeout happened * i40iw_terminate_timeout - timeout happened
* @t: points to iwarp qp * @t: points to iwarp qp
*/ */
static void i40iw_terminate_timeout(struct timer_list *t) static void i40iw_terminate_timeout(struct timer_list *t)

4
drivers/infiniband/hw/i40iw/i40iw_verbs.c
View File

@ -647,7 +647,7 @@ error:
} }
/** /**
* i40iw_query - query qp attributes * i40iw_query_qp - query qp attributes
* @ibqp: qp pointer * @ibqp: qp pointer
* @attr: attributes pointer * @attr: attributes pointer
* @attr_mask: Not used * @attr_mask: Not used
@ -1846,7 +1846,7 @@ static struct ib_mr *i40iw_get_dma_mr(struct ib_pd *pd, int acc)
} }
/** /**
* i40iw_del_mem_list - Deleting pbl list entries for CQ/QP * i40iw_del_memlist - Deleting pbl list entries for CQ/QP
* @iwmr: iwmr for IB's user page addresses * @iwmr: iwmr for IB's user page addresses
* @ucontext: ptr to user context * @ucontext: ptr to user context
*/ */

2
drivers/infiniband/hw/i40iw/i40iw_virtchnl.c
View File

@ -333,7 +333,7 @@ static void pf_cqp_get_hmc_fcn_callback(struct i40iw_sc_dev *dev, void *callback
} }
/** /**
* pf_add_hmc_obj - Callback for Add HMC Object * pf_add_hmc_obj_callback - Callback for Add HMC Object
* @work_vf_dev: pointer to the VF Device * @work_vf_dev: pointer to the VF Device
*/ */
static void pf_add_hmc_obj_callback(void *work_vf_dev) static void pf_add_hmc_obj_callback(void *work_vf_dev)

5
drivers/infiniband/hw/qib/qib_file_ops.c
View File

@ -1758,7 +1758,8 @@ bail:
} }
/** /**
* unlock_exptid - unlock any expected TID entries context still had in use * unlock_expected_tids - unlock any expected TID entries context still had
* in use
* @rcd: ctxt * @rcd: ctxt
* *
* We don't actually update the chip here, because we do a bulk update * We don't actually update the chip here, because we do a bulk update
@ -2247,7 +2248,7 @@ static ssize_t qib_write_iter(struct kiocb *iocb, struct iov_iter *from)
if (!iter_is_iovec(from) || !from->nr_segs || !pq) if (!iter_is_iovec(from) || !from->nr_segs || !pq)
return -EINVAL; return -EINVAL;
return qib_user_sdma_writev(rcd, pq, from->iov, from->nr_segs); return qib_user_sdma_writev(rcd, pq, from->iov, from->nr_segs);
} }

2
drivers/infiniband/hw/qib/qib_iba6120.c
View File

@ -2609,7 +2609,7 @@ static void qib_chk_6120_errormask(struct qib_devdata *dd)
} }
/** /**
* qib_get_faststats - get word counters from chip before they overflow * qib_get_6120_faststats - get word counters from chip before they overflow
* @t: contains a pointer to the qlogic_ib device qib_devdata * @t: contains a pointer to the qlogic_ib device qib_devdata
* *
* This needs more work; in particular, decision on whether we really * This needs more work; in particular, decision on whether we really

4
drivers/infiniband/hw/qib/qib_iba7220.c
View File

@ -2236,7 +2236,7 @@ static void qib_7220_tidtemplate(struct qib_devdata *dd)
} }
/** /**
* qib_init_7220_get_base_info - set chip-specific flags for user code * qib_7220_get_base_info - set chip-specific flags for user code
* @rcd: the qlogic_ib ctxt * @rcd: the qlogic_ib ctxt
* @kinfo: qib_base_info pointer * @kinfo: qib_base_info pointer
* *
@ -4411,7 +4411,7 @@ static void writescratch(struct qib_devdata *dd, u32 val)
#define VALID_TS_RD_REG_MASK 0xBF #define VALID_TS_RD_REG_MASK 0xBF
/** /**
* qib_7220_tempsense_read - read register of temp sensor via TWSI * qib_7220_tempsense_rd - read register of temp sensor via TWSI
* @dd: the qlogic_ib device * @dd: the qlogic_ib device
* @regnum: register to read from * @regnum: register to read from
* *

4
drivers/infiniband/hw/qib/qib_iba7322.c
View File

@ -2513,7 +2513,7 @@ static int qib_7322_bringup_serdes(struct qib_pportdata *ppd)
} }
/** /**
* qib_7322_quiet_serdes - set serdes to txidle * qib_7322_mini_quiet_serdes - set serdes to txidle
* @ppd: the qlogic_ib device * @ppd: the qlogic_ib device
* Called when driver is being unloaded * Called when driver is being unloaded
*/ */
@ -3859,7 +3859,7 @@ static void qib_7322_tidtemplate(struct qib_devdata *dd)
} }
/** /**
* qib_init_7322_get_base_info - set chip-specific flags for user code * qib_7322_get_base_info - set chip-specific flags for user code
* @rcd: the qlogic_ib ctxt * @rcd: the qlogic_ib ctxt
* @kinfo: qib_base_info pointer * @kinfo: qib_base_info pointer
* *

2
drivers/infiniband/hw/qib/qib_init.c
View File

@ -1609,7 +1609,7 @@ bail:
} }
/** /**
* allocate eager buffers, both kernel and user contexts. * qib_setup_eagerbufs - allocate eager buffers, both kernel and user contexts.
* @rcd: the context we are setting up. * @rcd: the context we are setting up.
* *
* Allocate the eager TID buffers and program them into hip. * Allocate the eager TID buffers and program them into hip.

2
drivers/infiniband/hw/vmw_pvrdma/pvrdma_qp.c
View File

@ -882,7 +882,7 @@ out:
} }
/** /**
* pvrdma_post_receive - post receive work request entries on a QP * pvrdma_post_recv - post receive work request entries on a QP
* @ibqp: the QP * @ibqp: the QP
* @wr: the work request list to post * @wr: the work request list to post
* @bad_wr: the first bad WR returned * @bad_wr: the first bad WR returned