From nobody Mon Jun 15 03:56:04 2026 Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id EE0631E9B3A; Tue, 7 Apr 2026 19:03:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=193.142.43.55 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775588597; cv=none; b=KHvKJmNcX7jxUraiCBKI1o/4dfCkQoY4Iy7ejHv7rr6cArJPmGfGhf4oSAM28zDM4361g9IZwIVLZS8tGasxwzI3VbCB3XmWvA7Y1mlKW4vm1+b7PLK/TPQjREiJEC+aQUdpgDTEe7LZLN7KT5Rs/tSp6sTRzZ4ajVG5VJpw4Fc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775588597; c=relaxed/simple; bh=GcIk0gnDDlJjU1aO7d75x7e7onwf+THup0gxSzMxjGk=; h=Date:From:To:Subject:Cc:In-Reply-To:References:MIME-Version: Message-ID:Content-Type; b=p54CghFbZ4ox0O9aeRQeJe5MG3qiDNkLB/biF/guyoYkTPVJPQ/7icIxz0Hbm+nOGKLvouLZcZYX89OCthx3kq5fMMKRoR4mreQW54s5Y7O+jRzlLOR/gMNXG7O5aaOZItmNf7jQLcpMt9MKlsOMsjTQjRM19fDwerlSWA1naXI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linutronix.de; spf=pass smtp.mailfrom=linutronix.de; dkim=pass (2048-bit key) header.d=linutronix.de header.i=@linutronix.de header.b=IwIf1m/j; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b=w5dxrWOQ; arc=none smtp.client-ip=193.142.43.55 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linutronix.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linutronix.de Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="IwIf1m/j"; dkim=permerror (0-bit key) header.d=linutronix.de header.i=@linutronix.de header.b="w5dxrWOQ" Date: Tue, 07 Apr 2026 19:03:11 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1775588593; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=YD33FGwTGiZlCeVdEyF1SJMo2leuNB2nDpzyrSO+AA8=; b=IwIf1m/jXz25sKu/eDYHm9PLnM8UHaxh3XD/cu9MHMtpz5HvniVjuSbD41xSgTPX203K/X ngPNta1Kh/wrW13jrS9o8tRtpL79qyDz9JGVfc8dwdM10gJaXKzAdC1oovGMswKkCXKdLp /6r64fwhQcYAVfXlt00plzEUmx5/LMG+GnsDJvsPp5ofFaDOdmgt+epvVNCI5WE7/F11lL wsg1BXqwVkp0Ifmscbw4OAhOavs6JawVRxgLLg/gokSJe4GI13CIzGheKomszxqxr36do8 Zp5Yofhs09gFLDzyWVmeOyegccxS3xeOHr3DhfLHGiY/h76pgn+IHOA2c4wodg== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1775588593; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=YD33FGwTGiZlCeVdEyF1SJMo2leuNB2nDpzyrSO+AA8=; b=w5dxrWOQd/mHuebxojigtoFY/xoL6W5gCxUaHN3RVRHFEZR3/cKH4nxDGhS/aG2323lRz5 JWa+4v/sk9dhlcDQ== From: "tip-bot2 for Reinette Chatre" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: x86/cache] fs/resctrl: Add missing return value descriptions Cc: Reinette Chatre , "Borislav Petkov (AMD)" , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: =?utf-8?q?=3C1c50b9f7c73251c007133590986f127e1af57780=2E1775576?= =?utf-8?q?382=2Egit=2Ereinette=2Echatre=40intel=2Ecom=3E?= References: =?utf-8?q?=3C1c50b9f7c73251c007133590986f127e1af57780=2E17755763?= =?utf-8?q?82=2Egit=2Ereinette=2Echatre=40intel=2Ecom=3E?= Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-ID: <177558859188.801717.3149219166892598322.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails Precedence: bulk Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable The following commit has been merged into the x86/cache branch of tip: Commit-ID: 79727019ce3da234d877ec0cb6a3985f001e2b2d Gitweb: https://git.kernel.org/tip/79727019ce3da234d877ec0cb6a3985f0= 01e2b2d Author: Reinette Chatre AuthorDate: Tue, 07 Apr 2026 09:01:59 -07:00 Committer: Borislav Petkov (AMD) CommitterDate: Tue, 07 Apr 2026 21:01:22 +02:00 fs/resctrl: Add missing return value descriptions Using the stricter "./tools/docs/kernel-doc -Wall -v" to verify proper formatting of documentation comments includes warnings related to return markup on functions that are omitted during the default verification checks. This stricter verification reports a couple of missing return descriptions in resctrl: Warning: .../fs/resctrl/rdtgroup.c:1536 No description found for return= value of 'rdtgroup_cbm_to_size' Warning: .../fs/resctrl/rdtgroup.c:3131 No description found for return= value of 'mon_get_kn_priv' Warning: .../fs/resctrl/rdtgroup.c:3523 No description found for return= value of 'cbm_ensure_valid' Warning: .../fs/resctrl/monitor.c:238 No description found for return v= alue of 'resctrl_find_cleanest_closid' Add the missing return descriptions. Signed-off-by: Reinette Chatre Signed-off-by: Borislav Petkov (AMD) Link: https://patch.msgid.link/1c50b9f7c73251c007133590986f127e1af57780.177= 5576382.git.reinette.chatre@intel.com --- fs/resctrl/monitor.c | 2 ++ fs/resctrl/rdtgroup.c | 6 ++++++ 2 files changed, 8 insertions(+) diff --git a/fs/resctrl/monitor.c b/fs/resctrl/monitor.c index 49f3f6b..9fd901c 100644 --- a/fs/resctrl/monitor.c +++ b/fs/resctrl/monitor.c @@ -234,6 +234,8 @@ static struct rmid_entry *resctrl_find_free_rmid(u32 cl= osid) * * When the CLOSID and RMID are independent numbers, the first free CLOSID= will * be returned. + * + * Return: Free CLOSID on success, < 0 on failure. */ int resctrl_find_cleanest_closid(void) { diff --git a/fs/resctrl/rdtgroup.c b/fs/resctrl/rdtgroup.c index 5da305b..5dfdaa6 100644 --- a/fs/resctrl/rdtgroup.c +++ b/fs/resctrl/rdtgroup.c @@ -1519,6 +1519,8 @@ out: * * @cbm is unsigned long, even if only 32 bits are used to make the * bitmap functions work correctly. + * + * Return: Size (in bytes) of cache portion represented by CBM, 0 on failu= re. */ unsigned int rdtgroup_cbm_to_size(struct rdt_resource *r, struct rdt_ctrl_domain *d, unsigned long cbm) @@ -3102,6 +3104,8 @@ static void rmdir_all_sub(void) * @mevt: The type of event file being created. * @do_sum: Whether SNC summing monitors are being created. Only set * when @rid =3D=3D RDT_RESOURCE_L3. + * + * Return: Pointer to mon_data private data of the event, NULL on failure. */ static struct mon_data *mon_get_kn_priv(enum resctrl_res_level rid, int do= mid, struct mon_evt *mevt, @@ -3496,6 +3500,8 @@ out_destroy: * resource group is initialized. The user can follow this with a * modification to the CBM if the default does not satisfy the * requirements. + * + * Return: A CBM that is valid for resource @r. */ static u32 cbm_ensure_valid(u32 _val, struct rdt_resource *r) {