Commit e769ab53 authored Aug 26, 2020 by Lee Jones Committed by Kalle Valo Sep 01, 2020

brcmfmac: fwsignal: Finish documenting 'brcmf_fws_mac_descriptor'

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

drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c:389: warning: Function parameter or member 'name' not described in 'brcmf_fws_mac_descriptor'
drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c:389: warning: Function parameter or member 'requested_packet' not described in 'brcmf_fws_mac_descriptor'
drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c:389: warning: Function parameter or member 'suppr_transit_count' not described in 'brcmf_fws_mac_descriptor'
drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c:389: warning: Function parameter or member 'send_tim_signal' not described in 'brcmf_fws_mac_descriptor'
drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c:389: warning: Function parameter or member 'traffic_pending_bmp' not described in 'brcmf_fws_mac_descriptor'
drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c:389: warning: Function parameter or member 'traffic_lastreported_bmp' not described in 'brcmf_fws_mac_descriptor'

Cc: Arend van Spriel <arend.vanspriel@broadcom.com>
Cc: Franky Lin <franky.lin@broadcom.com>
Cc: Hante Meuleman <hante.meuleman@broadcom.com>
Cc: Chi-Hsien Lin <chi-hsien.lin@cypress.com>
Cc: Wright Feng <wright.feng@cypress.com>
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: brcm80211-dev-list.pdl@broadcom.com
Cc: brcm80211-dev-list@cypress.com
Cc: netdev@vger.kernel.org
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Kalle Valo <kvalo@codeaurora.org>
Link: https://lore.kernel.org/r/20200826093401.1458456-14-lee.jones@linaro.org

parent bb4b2c8b

drivers/net/wireless/broadcom/brcm80211/brcmfmac/fwsignal.c

+6 −0

Original line number	Diff line number	Diff line
		@@ -354,6 +354,7 @@ enum brcmf_fws_mac_desc_state {
		/**
		* struct brcmf_fws_mac_descriptor - firmware signalling data per node/interface
		*
		* @name: name of the descriptor.
		* @occupied: slot is in use.
		* @mac_handle: handle for mac entry determined by firmware.
		* @interface_id: interface index.
		@@ -362,10 +363,15 @@ enum brcmf_fws_mac_desc_state {
		* @generation: generation bit.
		* @ac_bitmap: ac queue bitmap.
		* @requested_credit: credits requested by firmware.
		* @requested_packet: packet requested by firmware.
		* @ea: ethernet address.
		* @seq: per-node free-running sequence.
		* @psq: power-save queue.
		* @transit_count: packet in transit to firmware.
		* @suppr_transit_count: suppressed packet in transit to firmware.
		* @send_tim_signal: if set tim signal will be sent.
		* @traffic_pending_bmp: traffic pending bitmap.
		* @traffic_lastreported_bmp: traffic last reported bitmap.
		*/
		struct brcmf_fws_mac_descriptor {
		char name[16];