From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id D1CA3CCA479 for ; Tue, 28 Jun 2022 09:47:50 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344480AbiF1Jra (ORCPT ); Tue, 28 Jun 2022 05:47:30 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39308 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344312AbiF1Jqg (ORCPT ); Tue, 28 Jun 2022 05:46:36 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8F0BB25C7C; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 2123D617FB; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 2D74AC341D0; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=xHKhJmmG6pOtTNRxB35U3omdaLpNm3R0DbSnh9czaGY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=UW40VbnEsQCyVuLWDjzMPJKYEaZPLkuBmqtpWuafag+7UevJxyBBZ5Cc8SHZ8hdXg r5IwdOynhIafXdmOMo2EOjrV6wsFBDFlLpkJcDGLZJrRqLtOXiSNlrUmVOIpK31jKf prT4obQtUZwaFg61yt7uf13T0KE9hW+pcSl61qqHMTfwD2UPUBVSJpn8R6xJulT2fR sgy0XyO/zb2Wn9jWflQ3rgeuy5/1YzXp31pSKhboa1hEAi3mXpnL1AswXnZ2rMfl0m jqwUZrwZCfcG45680QBxbFGYlS6rh4MQROP4aN7cn686mV+FsCaPT+5IZINYhcBnss bjVSz1juAz5Dw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HEm-KU; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "David S. Miller" , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Eric Dumazet , Jakub Kicinski , Johannes Berg , Paolo Abeni , linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org, netdev@vger.kernel.org Subject: [PATCH 01/22] net: cfg80211: fix kernel-doc warnings all over the file Date: Tue, 28 Jun 2022 10:46:05 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" There are currently 17 kernel-doc warnings on this file: include/net/cfg80211.h:391: warning: Function parameter or member 'bw' not= described in 'ieee80211_eht_mcs_nss_supp' include/net/cfg80211.h:437: warning: Function parameter or member 'eht_cap= ' not described in 'ieee80211_sband_iftype_data' include/net/cfg80211.h:507: warning: Function parameter or member 's1g' no= t described in 'ieee80211_sta_s1g_cap' include/net/cfg80211.h:1390: warning: Function parameter or member 'counte= r_offset_beacon' not described in 'cfg80211_color_change_settings' include/net/cfg80211.h:1390: warning: Function parameter or member 'counte= r_offset_presp' not described in 'cfg80211_color_change_settings' include/net/cfg80211.h:1430: warning: Enum value 'STATION_PARAM_APPLY_STA_= TXPOWER' not described in enum 'station_parameters_apply_mask' include/net/cfg80211.h:2195: warning: Function parameter or member 'dot11M= eshConnectedToAuthServer' not described in 'mesh_config' include/net/cfg80211.h:2341: warning: Function parameter or member 'short_= ssid' not described in 'cfg80211_scan_6ghz_params' include/net/cfg80211.h:3328: warning: Function parameter or member 'kck_le= n' not described in 'cfg80211_gtk_rekey_data' include/net/cfg80211.h:3698: warning: Function parameter or member 'ftm' n= ot described in 'cfg80211_pmsr_result' include/net/cfg80211.h:3828: warning: Function parameter or member 'global= _mcast_stypes' not described in 'mgmt_frame_regs' include/net/cfg80211.h:4977: warning: Function parameter or member 'ftm' n= ot described in 'cfg80211_pmsr_capabilities' include/net/cfg80211.h:5742: warning: Function parameter or member 'u' not= described in 'wireless_dev' include/net/cfg80211.h:5742: warning: Function parameter or member 'links'= not described in 'wireless_dev' include/net/cfg80211.h:5742: warning: Function parameter or member 'valid_= links' not described in 'wireless_dev' include/net/cfg80211.h:6076: warning: Function parameter or member 'is_ams= du' not described in 'ieee80211_data_to_8023_exthdr' include/net/cfg80211.h:6949: warning: Function parameter or member 'sig_db= m' not described in 'cfg80211_notify_new_peer_candidate' Address them, in order to build a better documentation from this header. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/net/cfg80211.h | 28 +++++++++++++++++++++------- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/include/net/cfg80211.h b/include/net/cfg80211.h index 996782c44838..c7e641071eff 100644 --- a/include/net/cfg80211.h +++ b/include/net/cfg80211.h @@ -374,6 +374,7 @@ struct ieee80211_sta_he_cap { * and NSS Set field" * * @only_20mhz: MCS/NSS support for 20 MHz-only STA. + * @bw: MCS/NSS support for 80, 160 and 320 MHz * @bw._80: MCS/NSS support for BW <=3D 80 MHz * @bw._160: MCS/NSS support for BW =3D 160 MHz * @bw._320: MCS/NSS support for BW =3D 320 MHz @@ -420,6 +421,7 @@ struct ieee80211_sta_eht_cap { * @he_cap: holds the HE capabilities * @he_6ghz_capa: HE 6 GHz capabilities, must be filled in for a * 6 GHz band channel (and 0 may be valid value). + * @eht_cap: STA's EHT capabilities * @vendor_elems: vendor element(s) to advertise * @vendor_elems.data: vendor element(s) data * @vendor_elems.len: vendor element(s) length @@ -495,7 +497,7 @@ struct ieee80211_edmg { * This structure describes most essential parameters needed * to describe 802.11ah S1G capabilities for a STA. * - * @s1g_supported: is STA an S1G STA + * @s1g: is STA an S1G STA * @cap: S1G capabilities information * @nss_mcs: Supported NSS MCS set */ @@ -1373,8 +1375,8 @@ struct cfg80211_csa_settings { * Used for bss color change * * @beacon_color_change: beacon data while performing the color countdown - * @counter_offsets_beacon: offsets of the counters within the beacon (tai= l) - * @counter_offsets_presp: offsets of the counters within the probe respon= se + * @counter_offset_beacon: offsets of the counters within the beacon (tail) + * @counter_offset_presp: offsets of the counters within the probe response * @beacon_next: beacon data to be used after the color change * @count: number of beacons until the color change * @color: the color used after the change @@ -1417,6 +1419,7 @@ struct iface_combination_params { * @STATION_PARAM_APPLY_UAPSD: apply new uAPSD parameters (uapsd_queues, m= ax_sp) * @STATION_PARAM_APPLY_CAPABILITY: apply new capability * @STATION_PARAM_APPLY_PLINK_STATE: apply new plink state + * @STATION_PARAM_APPLY_STA_TXPOWER: apply tx power for STA * * Not all station parameters have in-band "no change" signalling, * for those that don't these flags will are used. @@ -2149,6 +2152,9 @@ struct bss_parameters { * @plink_timeout: If no tx activity is seen from a STA we've established * peering with for longer than this time (in seconds), then remove it * from the STA's list of peers. Default is 30 minutes. + * @dot11MeshConnectedToAuthServer: if set to true then this mesh STA + * will advertise that it is connected to a authentication server + * in the mesh formation field. * @dot11MeshConnectedToMeshGate: if set to true, advertise that this STA = is * connected to a mesh gate in mesh formation info. If false, the * value in mesh formation is determined by the presence of root paths @@ -2321,12 +2327,12 @@ struct cfg80211_scan_info { /** * struct cfg80211_scan_6ghz_params - relevant for 6 GHz only * - * @short_bssid: short ssid to scan for + * @short_ssid: short ssid to scan for * @bssid: bssid to scan for * @channel_idx: idx of the channel in the channel array in the scan reque= st * which the above info relvant to * @unsolicited_probe: the AP transmits unsolicited probe response every 2= 0 TU - * @short_ssid_valid: short_ssid is valid and can be used + * @short_ssid_valid: @short_ssid is valid and can be used * @psc_no_listen: when set, and the channel is a PSC channel, no need to = wait * 20 TUs before starting to send probe requests. */ @@ -3317,7 +3323,7 @@ struct cfg80211_wowlan_wakeup { * @kck: key confirmation key (@kck_len bytes) * @replay_ctr: replay counter (NL80211_REPLAY_CTR_LEN bytes) * @kek_len: length of kek - * @kck_len length of kck + * @kck_len: length of kck * @akm: akm (oui, id) */ struct cfg80211_gtk_rekey_data { @@ -3679,6 +3685,7 @@ struct cfg80211_pmsr_ftm_result { * @type: type of the measurement reported, note that we only support repo= rting * one type at a time, but you can report multiple results separately and * they're all aggregated for userspace. + * @ftm: FTM result */ struct cfg80211_pmsr_result { u64 host_time, ap_tsf; @@ -3817,7 +3824,7 @@ struct cfg80211_update_owe_info { * for the entire device * @interface_stypes: bitmap of management frame subtypes registered * for the given interface - * @global_mcast_rx: mcast RX is needed globally for these subtypes + * @global_mcast_stypes: mcast RX is needed globally for these subtypes * @interface_mcast_stypes: mcast RX is needed on this interface * for these subtypes */ @@ -4940,6 +4947,7 @@ struct wiphy_iftype_ext_capab { * @max_peers: maximum number of peers in a single measurement * @report_ap_tsf: can report assoc AP's TSF for radio resource measurement * @randomize_mac_addr: can randomize MAC address for measurement + * @ftm: FTM measurement data * @ftm.supported: FTM measurement is supported * @ftm.asap: ASAP-mode is supported * @ftm.non_asap: non-ASAP-mode is supported @@ -5563,6 +5571,7 @@ static inline void wiphy_unlock(struct wiphy *wiphy) * @netdev: (private) Used to reference back to the netdev, may be %NULL * @identifier: (private) Identifier used in nl80211 to identify this * wireless device if it has no netdev + * @u: union containing data specific to @iftype * @connected_addr: (private) BSSID or AP MLD address if connected * @connected: indicates if connected or not (STA mode) * @current_bss: (private) Used by the internal configuration code @@ -5624,6 +5633,9 @@ static inline void wiphy_unlock(struct wiphy *wiphy) * @pmsr_free_wk: (private) peer measurements cleanup work * @unprot_beacon_reported: (private) timestamp of last * unprotected beacon report + * @links: array of %IEEE80211_MLD_MAX_NUM_LINKS elements containing @addr + * @ap and @client for each link + * @valid_links: bitmap describing what elements of @links are valid */ struct wireless_dev { struct wiphy *wiphy; @@ -6068,6 +6080,7 @@ unsigned int ieee80211_get_mesh_hdrlen(struct ieee802= 11s_hdr *meshhdr); * @addr: the device MAC address * @iftype: the virtual interface type * @data_offset: offset of payload after the 802.11 header + * @is_amsdu: true if the 802.11 header is A-MSDU * Return: 0 on success. Non-zero on error. */ int ieee80211_data_to_8023_exthdr(struct sk_buff *skb, struct ethhdr *ehdr, @@ -6937,6 +6950,7 @@ void cfg80211_ibss_joined(struct net_device *dev, con= st u8 *bssid, * @macaddr: the MAC address of the new candidate * @ie: information elements advertised by the peer candidate * @ie_len: length of the information elements buffer + * @sig_dbm: signal level in dBm * @gfp: allocation flags * * This function notifies cfg80211 that the mesh peer candidate has been --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id BDA6BC43334 for ; Tue, 28 Jun 2022 09:46:55 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344347AbiF1Jqy (ORCPT ); Tue, 28 Jun 2022 05:46:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39312 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1343913AbiF1Jqd (ORCPT ); Tue, 28 Jun 2022 05:46:33 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id EAF1325C73; Tue, 28 Jun 2022 02:46:31 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 69785617BB; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 326AEC341CE; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=/pVDv47pHcbB0gI2Mal+afS7TWigkjO6bV5Qn+g/Q90=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=KfzyXVXg2vrOXJT2eg0g+QkyLyfSUpuP0oKskeI1VnHoHc1lfzPAK2EmbaHXxKPcL K5PcUfjEh3LC6cQBJjxi9xRimB4MWdkeThC60+oeht7mvJ18tNRBW+pZwNKtE0QwsQ OM472nkjtd8L62ZOwqtuEbri7Ys1aGEHReh2HSj+foCjvQX6mz2ZBERG8bsXgluBrm +30MTfAX7f4HeLhFCHzhp9J9uf+St2Dazah1E3hvS3tC3nQ8MKkAikpOsk9ogdrdg6 zTEJDNkuqjN+vGBCP4DJNlElMQ2iWPLYmRJ5topmkzzRxAz+gBTwL81zUZoFZ7RFvz 4xJxSqL3t4hew== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HEp-LB; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "David S. Miller" , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Eric Dumazet , Jakub Kicinski , Johannes Berg , Paolo Abeni , linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org, netdev@vger.kernel.org Subject: [PATCH 02/22] net: mac80211: add a missing comma at kernel-doc markup Date: Tue, 28 Jun 2022 10:46:06 +0100 Message-Id: <11c1bdb861d89c93058fcfe312749b482851cbdb.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The lack of the comma makes it to not parse the function parameter: include/net/mac80211.h:6250: warning: Function parameter or member 'vif' n= ot described in 'ieee80211_channel_switch_disconnect' Fix it. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/net/mac80211.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/net/mac80211.h b/include/net/mac80211.h index 27f24ac0426d..c0557142343f 100644 --- a/include/net/mac80211.h +++ b/include/net/mac80211.h @@ -6238,7 +6238,7 @@ void ieee80211_chswitch_done(struct ieee80211_vif *vi= f, bool success); =20 /** * ieee80211_channel_switch_disconnect - disconnect due to channel switch = error - * @vif &struct ieee80211_vif pointer from the add_interface callback. + * @vif: &struct ieee80211_vif pointer from the add_interface callback. * @block_tx: if %true, do not send deauth frame. * * Instruct mac80211 to disconnect due to a channel switch error. The chan= nel --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2E04ECCA480 for ; Tue, 28 Jun 2022 09:46:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344326AbiF1Jqj (ORCPT ); Tue, 28 Jun 2022 05:46:39 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39310 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344151AbiF1Jqc (ORCPT ); Tue, 28 Jun 2022 05:46:32 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4791F25C69; Tue, 28 Jun 2022 02:46:31 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id CB414617B3; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 21F00C341CB; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=aNsBjoam9FomQGP0KLpmbiHeL/xAsgah34KubXmo/7Q=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=cV5jmYDejNl2eM22Og0AgzjAq1KUDXy9YVpy90dvsGq8t/J9oBSRJNZghpgru6e0Y JYBCsSth17DmDu3kVrH+RNB93KNImGfVfHSmW47GIW8Tl05c5Ut4hDUtDobfYxEsRf mxqamINcbsAdtUplbsQvMHKxMsq09w28pP/gwXI2t8siWGQUBxxVOdqcTP4Fpynqkb wVdayItZkl0b80YceJnP0ZniXQPtKvQF4PtE0Z0sHF9sBORrn/D/XUIuNOWybdTeSO be7YmggGzSrSKeLWWtotW1sUshOjPdtnsByqEJLAEeoCznotST7ObjBOVgcbiecHwB kwDMrHjS7TACg== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HEs-Lu; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "David S. Miller" , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Eric Dumazet , Jakub Kicinski , Johannes Berg , Paolo Abeni , linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org, netdev@vger.kernel.org Subject: [PATCH 03/22] net: mac80211: sta_info: fix a missing kernel-doc struct element Date: Tue, 28 Jun 2022 10:46:07 +0100 Message-Id: <37d898634bb30776442a33833c48cbb21c90ecc6.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" struct link_sta_info has now a cur_max_bandwidth data: net/mac80211/sta_info.h:569: warning: Function parameter or member 'cur_ma= x_bandwidth' not described in 'link_sta_info' Copy the meaning from struct sta_info, documenting it. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ net/mac80211/sta_info.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/net/mac80211/sta_info.h b/net/mac80211/sta_info.h index 218430790660..4e0b969891de 100644 --- a/net/mac80211/sta_info.h +++ b/net/mac80211/sta_info.h @@ -517,6 +517,8 @@ struct ieee80211_fragment_cache { * @status_stats.last_ack_signal: last ACK signal * @status_stats.ack_signal_filled: last ACK signal validity * @status_stats.avg_ack_signal: average ACK signal + * @cur_max_bandwidth: maximum bandwidth to use for TX to the station, + * taken from HT/VHT capabilities or VHT operating mode notification * @pub: public (driver visible) link STA data * TODO Move other link params from sta_info as required for MLD operation */ --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id DEA75C433EF for ; Tue, 28 Jun 2022 09:46:44 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S244121AbiF1Jqm (ORCPT ); Tue, 28 Jun 2022 05:46:42 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39336 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239715AbiF1Jqd (ORCPT ); Tue, 28 Jun 2022 05:46:33 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9E64625C40; Tue, 28 Jun 2022 02:46:31 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id D8573617B2; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 28169C341CD; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=Dobj9yjTJrK/J/vsMeQNCoBHeBjpfx+RuR+DAv7rT1o=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=o7beWfPaBf1rEDF4k2UDO6dCfuzGVu1HCxgPmE3qcE2bkfMHR28T1TkkbSZNXqdUh udQdVnK26VXUdQC/K6QAQmUDVQlxqjMpX5Scj9HJxICuPaH8SCluoqD3FPek/H93Dp rvItpW/a91giX5JJPfYhD2s8/7wjAp5JPyyU0p0xwPpwC0FzqyKJnkkdRWWJ9VXtLw X+8RpZgk4mrpsiUXmLwUXzO3ItM/7tEtp1MGAqc2+XpE9z2QdPC661aNPIhOoqHktZ 6u8It/mxBmrNnr9PH3sbyyyWJRe9nY8hURf1gfne11k3884iRqKdFSFrR3SZHs+YME PRECThEbNa/hg== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HEv-Me; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "H. Peter Anvin" , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Borislav Petkov , Dave Hansen , Ingo Molnar , Jarkko Sakkinen , Thomas Gleixner , linux-kernel@vger.kernel.org, linux-sgx@vger.kernel.org, x86@kernel.org Subject: [PATCH 04/22] x86/sgx: fix kernel-doc markups Date: Tue, 28 Jun 2022 10:46:08 +0100 Message-Id: <49f0900ca467867917182a4428b731e55608ca67.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" There are a couple typos there, violating kernel-doc syntax. Also, on a function typedef, the register snapshots aren't documented. This should fix those warnings: arch/x86/include/uapi/asm/sgx.h:19: warning: Enum value 'SGX_PAGE_MEASURE'= not described in enum 'sgx_page_flags' arch/x86/include/uapi/asm/sgx.h:97: warning: Function parameter or member = 'rdi' not described in 'sgx_enclave_user_handler_t' arch/x86/include/uapi/asm/sgx.h:97: warning: Function parameter or member = 'rsi' not described in 'sgx_enclave_user_handler_t' arch/x86/include/uapi/asm/sgx.h:97: warning: Function parameter or member = 'rdx' not described in 'sgx_enclave_user_handler_t' arch/x86/include/uapi/asm/sgx.h:97: warning: Function parameter or member = 'rsp' not described in 'sgx_enclave_user_handler_t' arch/x86/include/uapi/asm/sgx.h:97: warning: Function parameter or member = 'r8' not described in 'sgx_enclave_user_handler_t' arch/x86/include/uapi/asm/sgx.h:97: warning: Function parameter or member = 'r9' not described in 'sgx_enclave_user_handler_t' arch/x86/include/uapi/asm/sgx.h:124: warning: Function parameter or member= 'reserved' not described in 'sgx_enclave_run' Signed-off-by: Mauro Carvalho Chehab Acked-by: Dave Hansen Reviewed-by: Jarkko Sakkinen --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ arch/x86/include/uapi/asm/sgx.h | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/arch/x86/include/uapi/asm/sgx.h b/arch/x86/include/uapi/asm/sg= x.h index f4b81587e90b..e0e6a3ebc941 100644 --- a/arch/x86/include/uapi/asm/sgx.h +++ b/arch/x86/include/uapi/asm/sgx.h @@ -10,7 +10,7 @@ =20 /** * enum sgx_page_flags - page control flags - * %SGX_PAGE_MEASURE: Measure the page contents with a sequence of + * @SGX_PAGE_MEASURE: Measure the page contents with a sequence of * ENCLS[EEXTEND] operations. */ enum sgx_page_flags { @@ -81,6 +81,12 @@ struct sgx_enclave_run; /** * typedef sgx_enclave_user_handler_t - Exit handler function accepted by * __vdso_sgx_enter_enclave() + * @rdi: snapshot of DI register at enclave exit + * @rsi: snapshot of SI register at enclave exit + * @rdx: snapshot of DX register at enclave exit + * @rsp: snapshot of SP register at enclave exit + * @r8: snapshot of R8 register at enclave exit + * @r9: snapshot of R9 register at enclave exit * @run: The run instance given by the caller * * The register parameters contain the snapshot of their values at enclave @@ -104,7 +110,7 @@ typedef int (*sgx_enclave_user_handler_t)(long rdi, lon= g rsi, long rdx, * @exception_addr: The address that triggered the exception * @user_handler: User provided callback run on exception * @user_data: Data passed to the user handler - * @reserved Reserved for future extensions + * @reserved: Reserved for future extensions * * If @user_handler is provided, the handler will be invoked on all return= paths * of the normal flow. The user handler may transfer control, e.g. via a --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id CAEE1C43334 for ; Tue, 28 Jun 2022 09:46:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344338AbiF1Jqq (ORCPT ); Tue, 28 Jun 2022 05:46:46 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39308 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344303AbiF1Jqe (ORCPT ); Tue, 28 Jun 2022 05:46:34 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BF79625C55; Tue, 28 Jun 2022 02:46:32 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 64596B81D79; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1EE31C341CA; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=qHIYwC0MUE7l/qkHy6SpVtjLMVFmnu5rrRpz/lQTjrM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=JCcb/wcS2buWfSiU6z7jcNlYGTLIogyO4E35JoCwqlOwgd2m9sbjwul9VIqMhghh2 oKhfXGAq5Do+8VZMHRnVtb2rR2kfNO42LpLTlBry1atuNqYvqkEe8goxMZbIkU0qci 8fAMAh9GxD+xMT1ra421ngp4O2ib4wph58kyGL3EjfubQy9DMScoFNFi4oTlnQ28xX x1uiSFler+c7b842gN2r7lTVnYSJwMMrnUWbGTxq+dNAPFmlgqa+sL5ptfHAtEEKx+ Pm1qZNaSOXQWT6Ug7VD1JbWtrtpM7oX4G1KDDSPI29sYQSfmj/p4Pbml4Q1QfDftUS uAEXAWxMge7Yw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HEy-NJ; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , David Howells , linux-cachefs@redhat.com, linux-kernel@vger.kernel.org Subject: [PATCH 05/22] fscache: fix kernel-doc documentation Date: Tue, 28 Jun 2022 10:46:09 +0100 Message-Id: <9fb5c8a99752e1f01adfa32ed7ddeda2a9f75d71.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The prototype of two functions use "cookie" for the object parameter. Update kernel-doc tags accordingly, fixing those warnings: include/linux/fscache.h:270: warning: Function parameter or member 'cookie= ' not described in 'fscache_use_cookie' include/linux/fscache.h:270: warning: Excess function parameter 'object' d= escription in 'fscache_use_cookie' include/linux/fscache.h:287: warning: Function parameter or member 'cookie= ' not described in 'fscache_unuse_cookie' include/linux/fscache.h:287: warning: Excess function parameter 'object' d= escription in 'fscache_unuse_cookie' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/linux/fscache.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/include/linux/fscache.h b/include/linux/fscache.h index 2f82ea31d4c1..e13184c4b198 100644 --- a/include/linux/fscache.h +++ b/include/linux/fscache.h @@ -257,7 +257,7 @@ struct fscache_cookie *fscache_acquire_cookie(struct fs= cache_volume *volume, =20 /** * fscache_use_cookie - Request usage of cookie attached to an object - * @object: Object description + * @cookie: Object description * @will_modify: If cache is expected to be modified locally * * Request usage of the cookie attached to an object. The caller should t= ell @@ -273,7 +273,7 @@ static inline void fscache_use_cookie(struct fscache_co= okie *cookie, =20 /** * fscache_unuse_cookie - Cease usage of cookie attached to an object - * @object: Object description + * @cookie: Object description * @aux_data: Updated auxiliary data (or NULL) * @object_size: Revised size of the object (or NULL) * --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 72383C433EF for ; Tue, 28 Jun 2022 09:47:11 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344403AbiF1JrJ (ORCPT ); Tue, 28 Jun 2022 05:47:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39312 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S242209AbiF1Jqf (ORCPT ); Tue, 28 Jun 2022 05:46:35 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id ED21225C5A; Tue, 28 Jun 2022 02:46:32 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 7257BB81D8E; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1BAC3C3411D; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=sTi4x9ZoZpkbQr4+xjPIIlVa/suTKm/0lLP05XVf1f8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Roh2K2uEouhV7ax8h2Vhchn+12/YTfUUS2F/Uz48hFp0Tr1yfOXCYbtIMoY+R2VbR hc6oX+g3EgDon6XPqm8DKQFGi1kn0bfZcEMkv4iSGTu71abraXin7rwX+hprHq8sQF TO6rLghyUh0UGj6iXohFEdC0Bjc0z/DmawhKH1jHN4EROLOWbatoJejD236ecrWvEV PjN2wCmDgMal/iycvRUWV1H4x9nDj4Jy2HKBl8jZTGQb4vyrZhfMlUdVY/6kPpMOSK RAClAg2j9sYe1JOdj6hdnZtvLDw0oxrGEWxC7A3kAYk9NndT+TmlDAk5nCM31wLLrM iooErJJYiRWQg== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HF1-Nz; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Alexander Viro , linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 06/22] fs: attr: update vfs uid/gid parameters at kernel-doc Date: Tue, 28 Jun 2022 10:46:10 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The vfs uid/gid parameters have a different name at the function prototype causing kernel-doc warnings. Update them for the parameters to match, fixing those warnings: fs/attr.c:36: warning: Function parameter or member 'ia_vfsuid' not descri= bed in 'chown_ok' fs/attr.c:36: warning: Excess function parameter 'uid' description in 'cho= wn_ok' fs/attr.c:63: warning: Function parameter or member 'ia_vfsgid' not descri= bed in 'chgrp_ok' fs/attr.c:63: warning: Excess function parameter 'gid' description in 'chg= rp_ok' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ fs/attr.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fs/attr.c b/fs/attr.c index 1ba7ddef537f..b5b8835ddf15 100644 --- a/fs/attr.c +++ b/fs/attr.c @@ -22,7 +22,7 @@ * chown_ok - verify permissions to chown inode * @mnt_userns: user namespace of the mount @inode was found from * @inode: inode to check permissions on - * @uid: uid to chown @inode to + * @ia_vfsuid: uid to chown @inode to * * If the inode has been found through an idmapped mount the user namespac= e of * the vfsmount must be passed through @mnt_userns. This function will then @@ -49,7 +49,7 @@ static bool chown_ok(struct user_namespace *mnt_userns, * chgrp_ok - verify permissions to chgrp inode * @mnt_userns: user namespace of the mount @inode was found from * @inode: inode to check permissions on - * @gid: gid to chown @inode to + * @ia_vfsgid: gid to chown @inode to * * If the inode has been found through an idmapped mount the user namespac= e of * the vfsmount must be passed through @mnt_userns. This function will then --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id BEB64CCA480 for ; Tue, 28 Jun 2022 09:47:50 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344471AbiF1Jr0 (ORCPT ); Tue, 28 Jun 2022 05:47:26 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39318 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344311AbiF1Jqg (ORCPT ); Tue, 28 Jun 2022 05:46:36 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8029325C6D; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 1C534B81D92; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 2FC66C341D1; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=Ms5JmO/YVveA71jHzxf9CpKV8ph43B9gY0cCetOz/GQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=lGbAXWP1HHRzM4gQTAP86HupxxsnRqE9d3ydeGxprJnSkY/sSmWQgtQ8sEycyHc0H uRiYeU5QlC8R+gAGkTcRt8n2AfW+U6aqcWbHihVnlqmxT+zMP2o3AmOwwtH+lFKNxi LJ2u8Ur9VNgD4FO60fsoBnS5HCZUQIzJuuTJSA/y8ZdAnmmWYtMqZ0Cyic7wfN2RDM nOckaHhh6deQxudn90MfQIE2onYO9nWcgnUuYAe2hkVnQ6jumUX94cOUjNKDCuBjxN eKEIIAaiiGW2ddu4nxHB1oW7a2W/43mlgn48DCri+kOE6KsB53TwSoGW3UBo/vCJK/ dGqAnm+qHEwHA== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HF4-Oc; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Alexander Viro , linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 07/22] fs: namei: address some kernel-doc issues Date: Tue, 28 Jun 2022 10:46:11 +0100 Message-Id: <4a1bbfb71afc91ab643a74c5d3b16c4f506b35a1.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" There are couple of symbols missing documentation: fs/namei.c:649: warning: Function parameter or member 'mnt' not described = in 'path_connected' fs/namei.c:649: warning: Function parameter or member 'dentry' not describ= ed in 'path_connected' fs/namei.c:1089: warning: Function parameter or member 'inode' not describ= ed in 'may_follow_link' Document them. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ fs/namei.c | 3 +++ 1 file changed, 3 insertions(+) diff --git a/fs/namei.c b/fs/namei.c index 1f28d3f463c3..a8079d6250bc 100644 --- a/fs/namei.c +++ b/fs/namei.c @@ -640,6 +640,8 @@ static bool nd_alloc_stack(struct nameidata *nd) =20 /** * path_connected - Verify that a dentry is below mnt.mnt_root + * @mnt: pointer to vfs mount + * @dentry: pointer to dentry to verify * * Rename can sometimes move a file or directory outside of a bind * mount, path_connected allows those cases to be detected. @@ -1072,6 +1074,7 @@ fs_initcall(init_fs_namei_sysctls); /** * may_follow_link - Check symlink following for unsafe situations * @nd: nameidata pathwalk data + * @inode: inode to check * * In the case of the sysctl_protected_symlinks sysctl being enabled, * CAP_DAC_OVERRIDE needs to be specifically ignored if the symlink is --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A8B7AC433EF for ; Tue, 28 Jun 2022 09:47:49 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344460AbiF1JrZ (ORCPT ); Tue, 28 Jun 2022 05:47:25 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39420 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344310AbiF1Jqf (ORCPT ); Tue, 28 Jun 2022 05:46:35 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 786E925C5C; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 0C787B81D91; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 2B33FC341CF; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=ahdzpqYwi4rLbemhWXEKhNIrYuQYS6uMQzIKxHuMXDI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=QZezjzuKXXhgx44O2x6Iw9Zlvv+iyQpkIIikfCvEF04mzxQzxUmZ2pQ2lB1c40Yjm CSx2AhNwnfnTAq/7DFWRNer1u9QpCcZOnbQ5AMTmndeDI92/NvdP5nRinbDBed3L40 GhhJtO4SZUHv7Sjr23/dUinep0hVB1mXT+yX8Q3sjLOqyZznWW1e+x3zjAEjY1NfTF MYtbwNf1xh/wLXQ6+Xi3yWfFBKrBb6E8YTZyGQ1+isbvaa4tYLFTsrjmTWjSn96bio Z7GrwsrEp5X+wsOJy1cRGubqbSXH2jTZ5MVqJtJhB5jSLaNna7iojFuEeL+GiiJIIi apcptWz+9DvPA== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HF7-PD; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Chanwoo Choi , Kyungmin Park , MyungJoo Ham , linux-kernel@vger.kernel.org, linux-pm@vger.kernel.org Subject: [PATCH 08/22] devfreq: shut up kernel-doc warnings Date: Tue, 28 Jun 2022 10:46:12 +0100 Message-Id: <6a15081e17d78e914526c315d5bb53ea575edf90.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" There are 4 warnings there: drivers/devfreq/devfreq.c:707: warning: Function parameter or member 'val'= not described in 'qos_min_notifier_call' drivers/devfreq/devfreq.c:707: warning: Function parameter or member 'ptr'= not described in 'qos_min_notifier_call' drivers/devfreq/devfreq.c:717: warning: Function parameter or member 'val'= not described in 'qos_max_notifier_call' drivers/devfreq/devfreq.c:717: warning: Function parameter or member 'ptr'= not described in 'qos_max_notifier_call' It turns that neither val nor ptr are actually used on those function, so document as such. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ drivers/devfreq/devfreq.c | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/drivers/devfreq/devfreq.c b/drivers/devfreq/devfreq.c index 01474daf4548..3020855d8400 100644 --- a/drivers/devfreq/devfreq.c +++ b/drivers/devfreq/devfreq.c @@ -700,6 +700,8 @@ static int qos_notifier_call(struct devfreq *devfreq) /** * qos_min_notifier_call() - Callback for QoS min_freq changes. * @nb: Should be devfreq->nb_min + * @val: not used + * @ptr: not used */ static int qos_min_notifier_call(struct notifier_block *nb, unsigned long val, void *ptr) @@ -710,6 +712,8 @@ static int qos_min_notifier_call(struct notifier_block = *nb, /** * qos_max_notifier_call() - Callback for QoS max_freq changes. * @nb: Should be devfreq->nb_max + * @val: not used + * @ptr: not used */ static int qos_max_notifier_call(struct notifier_block *nb, unsigned long val, void *ptr) --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 87374C43334 for ; Tue, 28 Jun 2022 09:47:56 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344312AbiF1Jry (ORCPT ); Tue, 28 Jun 2022 05:47:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39434 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344226AbiF1Jqg (ORCPT ); Tue, 28 Jun 2022 05:46:36 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id EE2E325C58; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 3856B6181A; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 782A7C36AF5; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=90hzTT2z6vZB7uuIRDY/vSrWqqeHuIcSGnrbKG+2HqU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=cpbBqRun56n6IlUjUGC9CtEYkUqAgOlHHvmxQfRs5UQ5uA2dtJkvtY71S98+kmGTC ufcNv4lcfobB5bH5c3ijgalrtTT54xS5DWlMPtiATjLh0IA9NJ0PDPXKDTgQK9uTle KzC56YCGv6TCvmY/vlvIJeO6FQsj/2RDfXPUmZXF3g1m6vwLa7E6uLyxZfIwI2Cu4k MWW/0/PeA7GvW/JSkWFOt1r2yA+4qqh+TdmL+gp4fE30CyLzVKEB9wAjXu0pnTwad7 BX/LfnNnCqcrotb0ZsQ5LNJL06JBO6uXZZl68ZE+olOdGbeihhVqAwBNkKmYCgbsgl tvpCPdmF0+klQ== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFA-Q3; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Christian=20K=C3=B6nig?= , "Jonathan Corbet" , "Mauro Carvalho Chehab" , "Pan, Xinhui" , Alex Deucher , Alex Hung , Daniel Vetter , David Airlie , Harry Wentland , Jude Shih , Leo Li , Nicholas Kazlauskas , Rodrigo Siqueira , Roman Li , Shirish S , Thomas Zimmermann , Wayne Lin , amd-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: [PATCH 09/22] drm: amdgpu: amdgpu_dm: fix kernel-doc markups Date: Tue, 28 Jun 2022 10:46:13 +0100 Message-Id: <3a54b73b6cbd251d3d5a899b9cfe8b794be78146.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" There are 4 undocumented fields at struct amdgpu_display_manager. Add documentation for them, fixing those warnings: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:544: warning: Function p= arameter or member 'dmub_outbox_params' not described in 'amdgpu_display_ma= nager' drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:544: warning: Function p= arameter or member 'num_of_edps' not described in 'amdgpu_display_manager' drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:544: warning: Function p= arameter or member 'disable_hpd_irq' not described in 'amdgpu_display_manag= er' drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:544: warning: Function p= arameter or member 'dmub_aux_transfer_done' not described in 'amdgpu_displa= y_manager' drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:544: warning: Function p= arameter or member 'delayed_hpd_wq' not described in 'amdgpu_display_manage= r' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h b/drivers/gp= u/drm/amd/display/amdgpu_dm/amdgpu_dm.h index 547fc1547977..73755b304299 100644 --- a/drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h +++ b/drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h @@ -242,6 +242,13 @@ struct hpd_rx_irq_offload_work { * @force_timing_sync: set via debugfs. When set, indicates that all conne= cted * displays will be forced to synchronize. * @dmcub_trace_event_en: enable dmcub trace events + * @dmub_outbox_params: DMUB Outbox parameters + * @num_of_edps: number of backlight eDPs + * @disable_hpd_irq: disables all HPD and HPD RX interrupt handling in the + * driver when true + * @dmub_aux_transfer_done: struct completion used to indicate when DMUB + * transfers are done + * @delayed_hpd_wq: work queue used to delay DMUB HPD work */ struct amdgpu_display_manager { =20 --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6F01CCCA485 for ; Tue, 28 Jun 2022 09:47:08 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1343886AbiF1JrF (ORCPT ); Tue, 28 Jun 2022 05:47:05 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39388 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344305AbiF1Jqe (ORCPT ); Tue, 28 Jun 2022 05:46:34 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 04C5125C7A; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id A4FC0617C5; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 56BF3C36AE7; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=4DMz4UXLGu0uFuXPe+nKrtjSJ9DOJhlkac6gN7tBAmU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=OgiGPoKdlAxpDh13ECLhDLR7tvZLpF+oBjOo2jCH+fdAGuBmotoBAKdxRqZyUKbWE 0PdrXAAAkXmSFwMwTLEh9Z4y+Sxv4K0LW7R18MJcIKtE+9JNzXL3xcsV5wE6F2Ng+M K72cPmR/1P+xpT436+VvFwG2i0lAN1Y+sh7Vqw76jzyXlSVwA16rcv6c4/kEw3HxyC 62GxkYn4VHWClZ+wgcXIvk3lecpOMx/RlREtZE1/EokQq4VSM6cy42Rq+YZR8ONohI Nm6qZWgzKnm34TYbR7T8y1EYCiTGDqb9SFOlAMQL3wifHEeDe4aQe/DvfAkDc8f04W RdFbNbjuDPvSg== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFD-Qp; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Christian=20K=C3=B6nig?= , "Jonathan Corbet" , "Mauro Carvalho Chehab" , "Pan, Xinhui" , Alex Deucher , Andrey Grodzovsky , Daniel Vetter , David Airlie , Evan Quan , Guchun Chen , Kevin Wang , Lang Yu , Somalapuram Amaranath , amd-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: [PATCH 10/22] drm: amdgpu: amdgpu_device.c: fix a kernel-doc markup Date: Tue, 28 Jun 2022 10:46:14 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The function was renamed without renaming also kernel-doc markup: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c:5095: warning: expecting protot= ype for amdgpu_device_gpu_recover_imp(). Prototype was for amdgpu_device_gp= u_recover() instead Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ drivers/gpu/drm/amd/amdgpu/amdgpu_device.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/gpu/drm/amd/amdgpu/amdgpu_device.c b/drivers/gpu/drm/a= md/amdgpu/amdgpu_device.c index 9d6418bb963e..6d74767591e7 100644 --- a/drivers/gpu/drm/amd/amdgpu/amdgpu_device.c +++ b/drivers/gpu/drm/amd/amdgpu/amdgpu_device.c @@ -5079,7 +5079,7 @@ static inline void amdggpu_device_stop_pedning_resets= (struct amdgpu_device *adev =20 =20 /** - * amdgpu_device_gpu_recover_imp - reset the asic and recover scheduler + * amdgpu_device_gpu_recover - reset the asic and recover scheduler * * @adev: amdgpu_device pointer * @job: which job trigger hang --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 4BEB6C43334 for ; Tue, 28 Jun 2022 09:47:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344420AbiF1JrR (ORCPT ); Tue, 28 Jun 2022 05:47:17 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39310 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S244939AbiF1Jqf (ORCPT ); Tue, 28 Jun 2022 05:46:35 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 40E1A25C4C; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id D54DB617CF; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 77708C341EE; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=KmE1n0kBTzhMcDi/Es4qlC1RvvMz696gfPuCpCdCwXA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=gwuiQNtLKte3nUdoCxdKSDOuRdlj/40+1HS65mhF7M/yFot3TsdTn7O24tvybSWgC W8ISK3Ms8GdYha5G8nCAt23Yoswo5flJ6O7ezyLVvU+w/yIfP5bYo2xCXCIvS9hmrb S759Ga4sNfLrqyuwTyZZm/4mersiFwGydZr9UQPPhYtZJWpUAOv+X4uX19/5REBqjI 1Qb/C2iiZ9mWBoXMilbVTGb1KIP4iaxbGqJ+AVrR7tl2cbPtQ5DYRptfDeEkfBxfo8 gBjJPj0o96jsYKUX719G8Rq+8DKqK3LZH9jxhS1gPPZy9ZzwV9cbT401X7Z3UFIz4+ tzfM/QEtoo3xg== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFG-Rk; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Christian=20K=C3=B6nig?= , "Jonathan Corbet" , "Mauro Carvalho Chehab" , "Pan, Xinhui" , Alex Deucher , Aurabindo Pillai , Daniel Vetter , David Airlie , David Zhang , Evan Quan , Harry Wentland , Hawking Zhang , Kenneth Feng , Lijo Lazar , Nicholas Kazlauskas , Zhan Liu , amd-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: [PATCH 11/22] drm: amd: amd_shared.h: Add missing doc for PP_GFX_DCS_MASK Date: Tue, 28 Jun 2022 10:46:15 +0100 Message-Id: <3aee446a0e396fe3f338f270746939f6e803a4de.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" This symbol is missing documentation: drivers/gpu/drm/amd/include/amd_shared.h:224: warning: Enum value 'PP_GFX_= DCS_MASK' not described in enum 'PP_FEATURE_MASK' Document it. Fixes: 680602d6c2d6 ("drm/amd/pm: enable DCS") Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ drivers/gpu/drm/amd/include/amd_shared.h | 1 + 1 file changed, 1 insertion(+) diff --git a/drivers/gpu/drm/amd/include/amd_shared.h b/drivers/gpu/drm/amd= /include/amd_shared.h index bcdf7453a403..2e02a6fc1717 100644 --- a/drivers/gpu/drm/amd/include/amd_shared.h +++ b/drivers/gpu/drm/amd/include/amd_shared.h @@ -193,6 +193,7 @@ enum amd_powergating_state { * @PP_ACG_MASK: Adaptive clock generator. * @PP_STUTTER_MODE: Stutter mode. * @PP_AVFS_MASK: Adaptive voltage and frequency scaling. + * @PP_GFX_DCS_MASK: GFX Async DCS. * * To override these settings on boot, append amdgpu.ppfeaturemask=3D to * the kernel's command line parameters. This is usually done through a sy= stem's --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 53AC4CCA487 for ; Tue, 28 Jun 2022 09:46:36 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344300AbiF1Jqe (ORCPT ); Tue, 28 Jun 2022 05:46:34 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39312 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344226AbiF1Jqc (ORCPT ); Tue, 28 Jun 2022 05:46:32 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 47B8525C6D; Tue, 28 Jun 2022 02:46:31 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id CFF9B617B8; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 2580BC341CC; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=0NbCo+YW090Jj7w8/2xxoP/ojPkPgosUj8xMfRMxsao=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ZZZBB3B2yZQo7yy3G4Geuz38zgBKXEW3Nrm02C58j4UcwkLy6kw988E2IoNArMmX7 r+TJ5L6OXqthHeUEBTXoCkrGKHZjdBT6ZszKQzhma67ADFyzR0M0aAXbAC4CebXr9E 0yAqdQPeZUMS2PJz+L18H8m5aLmykqgJCszCuz2AdfJ2MVcOWfEDFfZg3/Q/UUYCEo es7SZfiqAXXIneq1tgySVZHENjRumhMRY3u8BaAizyCxDyaUsGd31WdQALc6f6sy4D QN7oSmNrS/E3NcBm/vCdgUXM6ItvG20llGu6D9mfEIJUARqHdr6rG/H3bKwRZfzhx9 LOiGJPLvTAQzw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFN-SY; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Andrey Grodzovsky , Daniel Vetter , David Airlie , dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: [PATCH 12/22] drm: gpu_scheduler: fix a kernel-doc warning Date: Tue, 28 Jun 2022 10:46:16 +0100 Message-Id: <0129fa0ffb8d418ab66f2ab0f1d525cb49f01f75.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The dev field was not documented: include/drm/gpu_scheduler.h:463: warning: Function parameter or member 'de= v' not described in 'drm_gpu_scheduler' Document it. Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Alex Deucher --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/drm/gpu_scheduler.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/drm/gpu_scheduler.h b/include/drm/gpu_scheduler.h index addb135eeea6..c7c487e0c40e 100644 --- a/include/drm/gpu_scheduler.h +++ b/include/drm/gpu_scheduler.h @@ -435,6 +435,7 @@ struct drm_sched_backend_ops { * @_score: score used when the driver doesn't provide one * @ready: marks if the underlying HW is ready to work * @free_guilty: A hit to time out handler to free the guilty job. + * @dev: pointer to struct device. * * One scheduler is implemented for each hardware ring. */ --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 14C68CCA480 for ; Tue, 28 Jun 2022 09:46:52 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344342AbiF1Jqt (ORCPT ); Tue, 28 Jun 2022 05:46:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39344 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1343770AbiF1Jqd (ORCPT ); Tue, 28 Jun 2022 05:46:33 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E3DD125C72; Tue, 28 Jun 2022 02:46:31 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 73E05617C0; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 357E2C341D2; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=E1S37wDKTg+xS0E091LgAEWJ/wC5uO4LpBsUrtsrhqg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=nq+0AY3LCA0eoc4pLTKACsNle3YgbtmWHzZjyu3omVZgbS6g9Ga+k1qfSd9P6I8vy /LEOo3hLEILda4Cy4B27lhFo4ditj4Gl+nKUe1IaBXQSJbQmANAPDSbcc0mbsEMQ4L YJIHjA6c1R7cSx1QUmFP8WxiPe3V7Sxp6rBjP9c4QMXHblo0ZC16TKGPkVrvtURkie pKYOPRzxYowoRNvh/LOBg/mlCVaQ35iGnEj3Ots023/0bSDALfYJOM9xMSy7BRLhxe Hq40GV0sON0Itzgzqltku6pZRb/4LZ82nJJrkYFR04FRJ+Cly6nq6GUM+Pf22dpr7/ wnLs/UF7vk0dQ== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFQ-T9; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Andrey Grodzovsky , Daniel Vetter , David Airlie , dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: [PATCH 13/22] drm: scheduler: add a missing kernel-doc parameter Date: Tue, 28 Jun 2022 10:46:17 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Add a description for struct device at drm_sched_init(), in order to solve this warning: drivers/gpu/drm/scheduler/sched_main.c:999: warning: Function parameter or= member 'dev' not described in 'drm_sched_init' Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Alex Deucher --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ drivers/gpu/drm/scheduler/sched_main.c | 1 + 1 file changed, 1 insertion(+) diff --git a/drivers/gpu/drm/scheduler/sched_main.c b/drivers/gpu/drm/sched= uler/sched_main.c index 76fd2904c7c6..b45bd8473e9e 100644 --- a/drivers/gpu/drm/scheduler/sched_main.c +++ b/drivers/gpu/drm/scheduler/sched_main.c @@ -987,6 +987,7 @@ static int drm_sched_main(void *param) * used * @score: optional score atomic shared with other schedulers * @name: name used for debugging + * @dev: pointer to struct device * * Return 0 on success, otherwise error code. */ --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 83CEECCA480 for ; Tue, 28 Jun 2022 09:47:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344443AbiF1JrU (ORCPT ); Tue, 28 Jun 2022 05:47:20 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39418 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344309AbiF1Jqf (ORCPT ); Tue, 28 Jun 2022 05:46:35 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 970AC25C69; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 1191D617EF; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 580D6C36AEB; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=wOl3phQK/9dc8MhyVGH3zTw/kzoObzt1n8crGoupegI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=QKNOLdAgIvkT4X0FxaygrM4yibUdjhAvTqPQ7kO0iAvmvgn5XbUyygCIqqD65Udur 2Yp+3vwpX2T1jnC3bnFmc4NnrFvGW1dhmdZpRY9X5u6JM16c4kRrbiwlNqfBLyb0+v aDH/wA7eZkZK/MoozW1Cff+MhD6xPlpvYkpxTlP4iXHEAFPBZQKGk2bWPNYoCv2hmS gsvnqrBBvgyAxpAKjkZjv///VTxm7CJmQVps6auaZ2cmSrgA3RWh5XwiO/GqswQqco cBU2zfjCd8YBGkqcYtWPnq1VrSO4aZLhwAvOjW5xwOw0dPqPJ+bxUx6mVDckPmV8ZA WpV1EUUkQuaUw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFX-Tp; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Christian=20K=C3=B6nig?= , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Alexander Potapenko , Dmitry Vyukov , Marco Elver , Sumit Semwal , dri-devel@lists.freedesktop.org, kasan-dev@googlegroups.com, linaro-mm-sig@lists.linaro.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 14/22] kfence: fix a kernel-doc parameter Date: Tue, 28 Jun 2022 10:46:18 +0100 Message-Id: <687a2e724020d135bc7dfef0ec9010a00ecc0a3a.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The kernel-doc markup is missing the slab pointer description: include/linux/kfence.h:221: warning: Function parameter or member 'slab' n= ot described in '__kfence_obj_info' Document it. Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Marco Elver --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/linux/kfence.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/linux/kfence.h b/include/linux/kfence.h index 726857a4b680..9c242f4e9fab 100644 --- a/include/linux/kfence.h +++ b/include/linux/kfence.h @@ -210,6 +210,7 @@ struct kmem_obj_info; * __kfence_obj_info() - fill kmem_obj_info struct * @kpp: kmem_obj_info to be filled * @object: the object + * @slab: pointer to slab * * Return: * * false - not a KFENCE object --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6E044C43334 for ; Tue, 28 Jun 2022 09:47:14 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344413AbiF1JrN (ORCPT ); Tue, 28 Jun 2022 05:47:13 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39400 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344023AbiF1Jqf (ORCPT ); Tue, 28 Jun 2022 05:46:35 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 40CC025C46; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id C5498617D1; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6B0E1C341E5; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=zRrTJI5mHEi/MLTyZxsw5CNr5hJaKcUuODBWP1DC3l4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fS3ETSceg+fLzbhZENlP+0ErwVNTGxMysl2vqr7sIIs2Gpi7RO/XjlyjP9JNKr9WO A2u406AE/dyf9/QkakqOYWQmGBqkM5+pwJwxi1CGYk/Pv8uWttp4XNLpwiUqMMS78l x+sq+pwaSwUGexlkQeOQKJWQUdsm1YLIc/vAS80Qp79pYid56rrT9xI9YAWYo1QRET jS49Xvl34UdDY/U+ApzFexIL6tOegjAhy1ca7S38z37mkUpSn9NTNUUU0XGBM+Uvrs SXqN7p9OdthvV+DaiQUccUNYRu3i1mhwt9EKEBSYbRA3ldID3q2xaoMxgRJ9+as8Xr XQuQ/ewJuI7pw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFb-UR; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Liam R. Howlett" , "Matthew Wilcox (Oracle)" , "Mauro Carvalho Chehab" , Andrew Morton , linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH 15/22] mm: document maple tree pointer at unmap_vmas() at memory.c Date: Tue, 28 Jun 2022 10:46:19 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" A maple tree pointer parameter was added at unmap_vmas() without description: mm/memory.c:1729: warning: Function parameter or member 'mt' not described= in 'unmap_vmas' Document it it. Fixes: 5966e5c968b2 ("mm: remove the vma linked list") Fixes: f8acc5e9581e ("Maple Tree: add new data structure") Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ mm/memory.c | 2 ++ 1 file changed, 2 insertions(+) diff --git a/mm/memory.c b/mm/memory.c index e3d3596068f2..771b61444507 100644 --- a/mm/memory.c +++ b/mm/memory.c @@ -1707,6 +1707,8 @@ static void unmap_single_vma(struct mmu_gather *tlb, /** * unmap_vmas - unmap a range of memory covered by a list of vma's * @tlb: address of the caller's struct mmu_gather + * @mt: maple tree pointer. A maple tree is a RCU-safe range based B-tree + * designed to use modern processor cache efficiently * @vma: the starting vma * @start_addr: virtual address at which to start unmapping * @end_addr: virtual address at which to end unmapping --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id C761EC43334 for ; Tue, 28 Jun 2022 09:46:58 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344352AbiF1Jq5 (ORCPT ); Tue, 28 Jun 2022 05:46:57 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39344 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344304AbiF1Jqe (ORCPT ); Tue, 28 Jun 2022 05:46:34 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 04FC725C7B; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 97F56617C2; Tue, 28 Jun 2022 09:46:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 553C2C341E2; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=uLwYP4VIFIvnNdqDbc6GDUr5BO5ueAv2OaStvlcNVIs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Z35o19HFUXHnWtGilAH+MVwzdnBZMbIU1Frq6P3JoAcQNTV7LUIYonaROoJuLP6pQ 5BpwwbEaoQDZd/GXpqHBAhPoP7WAKGzdmIuU99Qjt84dlLh1a1guSAVrcrlTKpIiBC UNMf6Y6AmfPtgfQtpLq7w1pB1aOFEriT2JYp43OgopKgwgKpdHvadx8kGLnY3z1cit U57qTuW8AyAqUWw5oDd5I9YTq7XgMjOIxYY82SgFkVQoQ8/zUJQWRYLujfLBwe5T/R 3bJ8cDz18APoccGNxAxsUtzwKbuMyP2I+YfsqNjfRIwtA0EeVtpEZDnBRXTHyD1AAv cXTag6Lav3sFw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFe-Uw; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 16/22] genalloc: add a description for start_addr parameter Date: Tue, 28 Jun 2022 10:46:20 +0100 Message-Id: <6d8efc83d361ba678b2aab6330ac8977350ea9cd.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Copy the same description as found at lib/genalloc.c, fixing this warning: include/linux/genalloc.h:54: warning: Function parameter or member 'start_= addr' not described in 'genpool_algo_t' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/linux/genalloc.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/linux/genalloc.h b/include/linux/genalloc.h index 0bd581003cd5..2a67a54e5018 100644 --- a/include/linux/genalloc.h +++ b/include/linux/genalloc.h @@ -44,6 +44,7 @@ struct gen_pool; * @nr: The number of zeroed bits we're looking for * @data: optional additional data used by the callback * @pool: the pool being allocated from + * @start_addr: virtual starting address of memory chunk to add to pool */ typedef unsigned long (*genpool_algo_t)(unsigned long *map, unsigned long size, --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id E901CCCA482 for ; Tue, 28 Jun 2022 09:47:50 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344494AbiF1Jre (ORCPT ); Tue, 28 Jun 2022 05:47:34 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39324 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344313AbiF1Jqg (ORCPT ); Tue, 28 Jun 2022 05:46:36 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A276125C7E; Tue, 28 Jun 2022 02:46:33 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 3CAB7B81D90; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 5526BC341DD; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=ArSgShbnkK2vHPevrDl6OPLY7UfpcoMZgBRBgsm9KFk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=tqZwdgSkTS3zWgVo6RJLP5DXaDs4LrUfYTgvhpHKtPRSI3r+5QU/Qwevqvh6twQWf qd0t2C4R4Tnlu8ohElGMDr38d5ubHQGRvy8SnU+bAl22zBVniBhnVa6u7oqmL/7fAN JbOE46EB+me3ezX7rqOfjnfz7pSzSINn4nwUxPy/i4CmOFMn0+PRvEQ9sYIVJF+LEV LjLa+jnLMY3edi3Fnuk6qInTTZYCo8vYXiB+6F7MOwvPHpRgww2zqNL83NwkyCDFC9 Pl1dnK3aG81Ky+oAQEo+h0yDeeKf3Og9zQ4dQrED7x3SZxPgvzJmee7mz/Zuhdp8j5 t9843HoRHDfmA== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFh-VU; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 17/22] textsearch: document list inside struct ts_ops Date: Tue, 28 Jun 2022 10:46:21 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The list field of struct ts_ops is not documented: include/linux/textsearch.h:51: warning: Function parameter or member 'list= ' not described in 'ts_ops' Add a documentation for it. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/linux/textsearch.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/linux/textsearch.h b/include/linux/textsearch.h index 6673e4d4ac2e..29de95657ff1 100644 --- a/include/linux/textsearch.h +++ b/include/linux/textsearch.h @@ -35,6 +35,7 @@ struct ts_state * @get_pattern: return head of pattern * @get_pattern_len: return length of pattern * @owner: module reference to algorithm + * @list: pointer to ts_ops list */ struct ts_ops { --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 06E91C433EF for ; Tue, 28 Jun 2022 09:48:05 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344380AbiF1JsC (ORCPT ); Tue, 28 Jun 2022 05:48:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39344 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344302AbiF1Jqj (ORCPT ); Tue, 28 Jun 2022 05:46:39 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1196525C55; Tue, 28 Jun 2022 02:46:36 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id AFAB6B81D96; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 5437BC36AE5; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=mH0IqtWPBXiWck++b9ZqdkpJ66zW1PTOjMSEWTBrX+g=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=XREhXjmjga1ST6oPjVBoVrw2g/POI3UZPZH0Uur2uXBVHdyxnM/NKyoOUM9lZ4Svj 8lcDUw38dt2ScApnROT1od6WQaE1fMt0Af+7x9M8uOHnU6xhQUCYHWFVwGKX5NUutS txs5W65kPmdmxfN4qrOBHBTcFY/z0zhcdCtpbAez9fNP4QMTjmmiChAiEyx+RYkH61 uQJ3Z0ip5J6ktkEgH8ECdrvlrYbOmWBJ3n2lPd48IChTgQwO2D7hkWr0n4LzLXqOX4 4878MBQ2sBGI+X2dgnMhn8Mey4qRjeLRIi8EAr3HHNiZ6rHcN5fM8mvt2eNEw0jXrZ rwOvkdHv7gdrQ== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67nf-005HFk-W5; Tue, 28 Jun 2022 10:46:27 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Liam Girdwood , Mark Brown , linux-kernel@vger.kernel.org Subject: [PATCH 18/22] regulator: fix a kernel-doc warning Date: Tue, 28 Jun 2022 10:46:22 +0100 Message-Id: <15efc16e878aa327aa2769023bcdf959a795f41d.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" document n_ramp_values field at struct regulator_desc, in order to solve this warning: include/linux/regulator/driver.h:434: warning: Function parameter or membe= r 'n_ramp_values' not described in 'regulator_desc' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/linux/regulator/driver.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/linux/regulator/driver.h b/include/linux/regulator/dri= ver.h index 0228caaa6741..f9a7461e72b8 100644 --- a/include/linux/regulator/driver.h +++ b/include/linux/regulator/driver.h @@ -348,6 +348,7 @@ enum regulator_type { * @ramp_delay_table: Table for mapping the regulator ramp-rate values. Va= lues * should be given in units of V/S (uV/uS). See the * regulator_set_ramp_delay_regmap(). + * @n_ramp_values: number of elements at @ramp_delay_table. * * @enable_time: Time taken for initial enable of regulator (in uS). * @off_on_delay: guard time (in uS), before re-enabling a regulator --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 71B7BC43334 for ; Tue, 28 Jun 2022 09:48:00 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344357AbiF1Jr6 (ORCPT ); Tue, 28 Jun 2022 05:47:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39430 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344314AbiF1Jqg (ORCPT ); Tue, 28 Jun 2022 05:46:36 -0400 Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4620225C40; Tue, 28 Jun 2022 02:46:34 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sin.source.kernel.org (Postfix) with ESMTPS id 86550CE1F4D; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 508B6C36AE3; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=WbBL6ytq+2PylXv/jxqYZH6s3NkumUGsKk7uYgLBh3Q=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=WJnPwrAeaVZd6fbyKl80bJCJXnyjKgaY3QWur0sVI4zuFy6dzmrffSKPmqfwWRJDY prZ6LliDnGIuBjmX78uQHggtl/Ao/IdMljs1pMBq/+TBwypzMlh/SQ8fR+vveUP9Wx gP+Ebs30z++Hdl4gQaF1OXMOSwoxM5OKNem0PGJv+bWsDkvdpm6BQ2ap5NbYcPGnM2 sj10BZ31vC840hE/8gd7u+p8+i1+ij1CqykguZnULqkqpSMBRvlH/tbN4u9Fk1B0Kc uQPjzaUywUFc+34drLUYfo8Bq9gJn0RtBLRFT53HCMKrEB7jxdo3Rd2wK/sFCk2n7v nblBwwk2DdC4g== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67ng-005HFn-0P; Tue, 28 Jun 2022 10:46:28 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Andrew Morton , Arnd Bergmann , Luis Chamberlain , linux-kernel@vger.kernel.org Subject: [PATCH 19/22] dcache: fix a kernel-doc warning Date: Tue, 28 Jun 2022 10:46:23 +0100 Message-Id: <3dbb2c7e6a9180de4ca628f96eaddd27e6327f8d.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The name of the function is wrong: include/linux/dcache.h:309: warning: expecting prototype for dget, dget_dl= ock(). Prototype was for dget_dlock() instead Fix it. Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/linux/dcache.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/linux/dcache.h b/include/linux/dcache.h index f5bba51480b2..ce0b36f728fa 100644 --- a/include/linux/dcache.h +++ b/include/linux/dcache.h @@ -297,7 +297,7 @@ extern char *dentry_path(const struct dentry *, char *,= int); /* Allocation counts.. */ =20 /** - * dget, dget_dlock - get a reference to a dentry + * dget_dlock - get a reference to a dentry * @dentry: dentry to get a reference to * * Given a dentry or %NULL pointer increment the reference count --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 169E5CCA481 for ; Tue, 28 Jun 2022 09:47:51 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344533AbiF1Jrl (ORCPT ); Tue, 28 Jun 2022 05:47:41 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39336 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344324AbiF1Jqj (ORCPT ); Tue, 28 Jun 2022 05:46:39 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8040425C76; Tue, 28 Jun 2022 02:46:36 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id CB98DB81D98; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 71C7DC341E9; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=lh6o/QFPtVGrO1ZYX3PjI7UAR4mnHtfCksAmlyGH4Z0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=g0TTrjSTKMtxLlo0c0qbNEDt5h7tfXmjrOPlCioBph0Q3Clxqg5W3k0D74JiDGVl6 A6QC2NeDyEg8wLQzcPvnwzmQtkS8PaC5yODnbPogbGVA33BARCCW2vXa7WeBabj1DH b4S+oMCu2pQ2XwDZlt29QztuJ0rvPzzqRm5/SFjL5lvTfxYYGGkJ0bL5arOrBQ3NvY QqOqFmsX+zviJUWFpvdmrpwh9XscBs8BIbSsOQ4d9zdcMZhBY1AGYGJTUwmMCbtcZS FsMtMP3H4EerCmVVnZpbVS0My5r57HN8R4fv3zXxMJagGqEqFkZX8GZLGlCvhe3T9m ujZqMN04z1z1g== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67ng-005HFq-0w; Tue, 28 Jun 2022 10:46:28 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Greg Kroah-Hartman , Heikki Krogerus , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH 20/22] usb: typec_altmode: add a missing "@" at a kernel-doc parameter Date: Tue, 28 Jun 2022 10:46:24 +0100 Message-Id: <70dc4c5d744cf1fe9a0efe6b85deaa0489628282.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Without that, the parameter is not properly parsed: include/linux/usb/typec_altmode.h:132: warning: Function parameter or memb= er 'altmode' not described in 'typec_altmode_get_orientation' Signed-off-by: Mauro Carvalho Chehab Acked-by: Heikki Krogerus --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ include/linux/usb/typec_altmode.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/linux/usb/typec_altmode.h b/include/linux/usb/typec_al= tmode.h index 65933cbe9129..350d49012659 100644 --- a/include/linux/usb/typec_altmode.h +++ b/include/linux/usb/typec_altmode.h @@ -124,7 +124,7 @@ struct typec_altmode *typec_match_altmode(struct typec_= altmode **altmodes, =20 /** * typec_altmode_get_orientation - Get cable plug orientation - * altmode: Handle to the alternate mode + * @altmode: Handle to the alternate mode */ static inline enum typec_orientation typec_altmode_get_orientation(struct typec_altmode *altmode) --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 25A12C43334 for ; Tue, 28 Jun 2022 09:48:15 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344492AbiF1JsM (ORCPT ); Tue, 28 Jun 2022 05:48:12 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39516 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1344328AbiF1Jqj (ORCPT ); Tue, 28 Jun 2022 05:46:39 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1952A25C68; Tue, 28 Jun 2022 02:46:36 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id B22A2B81D99; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 599F9C341E4; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=iaQdNc88ElygWwpOBXidr0c6SZkvYula3SyEYHKlyDA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Y+A91k9QbTLFzrmkI3RA2LnkHMLtZfcQO9njDmN3DctNkjWrqagq+CmvGs8WYGbpZ m/7ldVT+IG1AQq0oS6cBVmvYlg9QbCTUUbjxItk3WS0ZBDTLqYCDBe4ENl0I5zFLdT aQU+nQH2TiOz9PWkRAEHYt+DLyV8YJYWQ9xMkAGkG/zbVyDJy6H488gAkK/zON4Qf5 GDo9okXLAvXrupP8UoeGtu9f39bEHhXm4GSOcFMzMXar+pTxSi4K7esbzrscu/d48q YMAyji5yDkB9NVj4Of1MlqGZ5LbmqMXl9i/p3uL9LuFyEJurX25dcd4xHFRQumV3qA FmOdClokY4UPw== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67ng-005HFu-1W; Tue, 28 Jun 2022 10:46:28 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Felipe Balbi , Greg Kroah-Hartman , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH 21/22] usb: dwc3: document async_callbacks field Date: Tue, 28 Jun 2022 10:46:25 +0100 Message-Id: <2c3de5935934baec097286f525ce4beff0a31ec0.1656409369.git.mchehab@kernel.org> X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Avoid a kernel-doc warning by documenting it: drivers/usb/dwc3/core.h:1328: warning: Function parameter or member 'async= _callbacks' not described in 'dwc3' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ drivers/usb/dwc3/core.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/drivers/usb/dwc3/core.h b/drivers/usb/dwc3/core.h index 722808d8c0af..4fe4287dc934 100644 --- a/drivers/usb/dwc3/core.h +++ b/drivers/usb/dwc3/core.h @@ -1087,6 +1087,8 @@ struct dwc3_scratchpad_array { * @dis_u1_entry_quirk: set if link entering into U1 state needs to be dis= abled. * @dis_u2_entry_quirk: set if link entering into U2 state needs to be dis= abled. * @dis_rxdet_inp3_quirk: set if we disable Rx.Detect in P3 + * @async_callbacks: if set, indicate that async callbacks will be used. + * * @dis_u2_freeclk_exists_quirk : set if we clear u2_freeclk_exists * in GUSB2PHYCFG, specify that USB2 PHY doesn't * provide a free-running PHY clock. --=20 2.36.1 From nobody Sun Apr 26 13:31:53 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2B2A5C433EF for ; Tue, 28 Jun 2022 09:48:09 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344422AbiF1JsG (ORCPT ); Tue, 28 Jun 2022 05:48:06 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39388 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S242161AbiF1JrD (ORCPT ); Tue, 28 Jun 2022 05:47:03 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8066525E80; Tue, 28 Jun 2022 02:46:36 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id C39C4B81D9B; Tue, 28 Jun 2022 09:46:32 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6CBCDC341E7; Tue, 28 Jun 2022 09:46:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656409590; bh=31LxezsefKWZxd2OhNR0VkL1vX8zivhz/ovRCJXS1V8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=gx5qWDseQpempDJEgIyEp6tY0x8uPqoKAF6nAL+ChrVCh33s5wvQuhSiIWcWHyG0N YWI+xRKJBFgONvz3tMBF074eCzeDTciulZR7MGMuTj07STlXze6fcq0WdOZg+g+cdr Vxaq4L3TyoMXXj0CiYbB255haA97E+JIQLiH0HkrjJwBB3ZJLt6bTBS0ok/FgEHozg f9UtpHP19mqsah7nLxN4AtDISWQPMBDPwpVKmQ9hBCg7TcUtkwxABS6OHi1NMVH1jl Ai5XD3MXgspBGGbSKrXzb2Yls4d6aXnEaXGPn6kkZZnHTOV1p1XNDFvTy2qq04oK7j c17OAh4XOSArQ== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o67ng-005HFx-23; Tue, 28 Jun 2022 10:46:28 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mauro Carvalho Chehab" , Felipe Balbi , Greg Kroah-Hartman , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH 22/22] usb: dwc3: gadget: fix a kernel-doc warning Date: Tue, 28 Jun 2022 10:46:26 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The multiplier parameter of dwc3_gadget_calc_tx_fifo_size() was not documented: drivers/usb/dwc3/gadget.c:675: warning: Function parameter or member 'mult= ' not described in 'dwc3_gadget_calc_tx_fifo_size' Signed-off-by: Mauro Carvalho Chehab --- To avoid mailbombing on a large number of people, only mailing lists were C= /C on the cover. See [PATCH 00/22] at: https://lore.kernel.org/all/cover.1656409369.git.mche= hab@kernel.org/ drivers/usb/dwc3/gadget.c | 1 + 1 file changed, 1 insertion(+) diff --git a/drivers/usb/dwc3/gadget.c b/drivers/usb/dwc3/gadget.c index 8716bece1072..a944c7a6c83a 100644 --- a/drivers/usb/dwc3/gadget.c +++ b/drivers/usb/dwc3/gadget.c @@ -657,6 +657,7 @@ static int dwc3_gadget_set_ep_config(struct dwc3_ep *de= p, unsigned int action) /** * dwc3_gadget_calc_tx_fifo_size - calculates the txfifo size value * @dwc: pointer to the DWC3 context + * @mult: multiplier to be used when calculating the fifo_size * * Calculates the size value based on the equation below: * --=20 2.36.1