Commit c7b1a9b3 authored by Lee Jones's avatar Lee Jones Committed by Kalle Valo

wil6210: pmc: Demote a few nonconformant kernel-doc function headers

Fixes the following W=1 kernel build warning(s):

 drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'wil' not described in 'wil_pmc_alloc'
 drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'num_descriptors' not described in 'wil_pmc_alloc'
 drivers/net/wireless/ath/wil6210/pmc.c:43: warning: Function parameter or member 'descriptor_size' not described in 'wil_pmc_alloc'
 drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'wil' not described in 'wil_pmc_free'
 drivers/net/wireless/ath/wil6210/pmc.c:229: warning: Function parameter or member 'send_pmc_cmd' not described in 'wil_pmc_free'
 drivers/net/wireless/ath/wil6210/pmc.c:307: warning: Function parameter or member 'wil' not described in 'wil_pmc_last_cmd_status'
 drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'filp' not described in 'wil_pmc_read'
 drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'buf' not described in 'wil_pmc_read'
 drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'count' not described in 'wil_pmc_read'
 drivers/net/wireless/ath/wil6210/pmc.c:320: warning: Function parameter or member 'f_pos' not described in 'wil_pmc_read'

Cc: Maya Erez <merez@codeaurora.org>
Cc: Kalle Valo <kvalo@codeaurora.org>
Cc: "David S. Miller" <davem@davemloft.net>
Cc: Jakub Kicinski <kuba@kernel.org>
Cc: linux-wireless@vger.kernel.org
Cc: wil6210@qti.qualcomm.com
Cc: netdev@vger.kernel.org
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Signed-off-by: default avatarKalle Valo <kvalo@codeaurora.org>
Link: https://lore.kernel.org/r/20200827073718.GV3248864@dell
parent e2d651b9
...@@ -29,8 +29,7 @@ void wil_pmc_init(struct wil6210_priv *wil) ...@@ -29,8 +29,7 @@ void wil_pmc_init(struct wil6210_priv *wil)
mutex_init(&wil->pmc.lock); mutex_init(&wil->pmc.lock);
} }
/** /* Allocate the physical ring (p-ring) and the required
* Allocate the physical ring (p-ring) and the required
* number of descriptors of required size. * number of descriptors of required size.
* Initialize the descriptors as required by pmc dma. * Initialize the descriptors as required by pmc dma.
* The descriptors' buffers dwords are initialized to hold * The descriptors' buffers dwords are initialized to hold
...@@ -221,8 +220,7 @@ void wil_pmc_alloc(struct wil6210_priv *wil, ...@@ -221,8 +220,7 @@ void wil_pmc_alloc(struct wil6210_priv *wil,
mutex_unlock(&pmc->lock); mutex_unlock(&pmc->lock);
} }
/** /* Traverse the p-ring and release all buffers.
* Traverse the p-ring and release all buffers.
* At the end release the p-ring memory * At the end release the p-ring memory
*/ */
void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd) void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd)
...@@ -299,8 +297,7 @@ void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd) ...@@ -299,8 +297,7 @@ void wil_pmc_free(struct wil6210_priv *wil, int send_pmc_cmd)
mutex_unlock(&pmc->lock); mutex_unlock(&pmc->lock);
} }
/** /* Status of the last operation requested via debugfs: alloc/free/read.
* Status of the last operation requested via debugfs: alloc/free/read.
* 0 - success or negative errno * 0 - success or negative errno
*/ */
int wil_pmc_last_cmd_status(struct wil6210_priv *wil) int wil_pmc_last_cmd_status(struct wil6210_priv *wil)
...@@ -311,8 +308,7 @@ int wil_pmc_last_cmd_status(struct wil6210_priv *wil) ...@@ -311,8 +308,7 @@ int wil_pmc_last_cmd_status(struct wil6210_priv *wil)
return wil->pmc.last_cmd_status; return wil->pmc.last_cmd_status;
} }
/** /* Read from required position up to the end of current descriptor,
* Read from required position up to the end of current descriptor,
* depends on descriptor size configured during alloc request. * depends on descriptor size configured during alloc request.
*/ */
ssize_t wil_pmc_read(struct file *filp, char __user *buf, size_t count, ssize_t wil_pmc_read(struct file *filp, char __user *buf, size_t count,
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment