From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-oo1-f51.google.com (mail-oo1-f51.google.com [209.85.161.51]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 652393F074A for ; Tue, 28 Jul 2026 07:31:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.51 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1785223916; cv=none; b=KufgxeM2kaW3luR8i0AWKeeiFflpDbslhBbmkipnHcXwg7R6C96nNlUNb5gRmawiimNimfYhDABg+4PW+lld0UJ/tfVAoyw/dKT6R/dfc1gqnK2qRoxhb5lc+YckC9oAN+IlLefoD76y/hJ/0ycBP4dugowrJ3H+gHlRnIU5jLo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1785223916; c=relaxed/simple; bh=8BdMURF69/uBF2yJWJR2TWG337rslns4sjCBwv/dzXg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=bGFWB29aY+xLwFKKFpv6rK38kLZTboYZTDzYTYQzWJUt42m+sn/PrH07MZfbMsy61DDW6Hv08PxQebWal58D3w1hDOcBMZsZcKjS+11DT7tbsoKq1EMSabQqNbXhjyfY04K7KV3vzbfDCEVBAEjyx8H0LJWBA224zZM/ZgNVcyQ= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=manifault.com; spf=pass smtp.mailfrom=manifault.com; dkim=pass (2048-bit key) header.d=manifault-com.20251104.gappssmtp.com header.i=@manifault-com.20251104.gappssmtp.com header.b=UTEnjfBF; arc=none smtp.client-ip=209.85.161.51 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=manifault.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=manifault.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=manifault-com.20251104.gappssmtp.com header.i=@manifault-com.20251104.gappssmtp.com header.b="UTEnjfBF" Received: by mail-oo1-f51.google.com with SMTP id 006d021491bc7-6aae2766d48so516297eaf.0 for ; Tue, 28 Jul 2026 00:31:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=manifault-com.20251104.gappssmtp.com; s=20251104; t=1785223914; x=1785828714; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=aKsoUL/x0BWL8hOHZwkWcIVk7QHl+uLVAwgOItINi2Y=; b=UTEnjfBFNI5GXSEJR/aS9OQxR/71f8OjkgKb9mPvVNsCeFn6c2UBseGXOjIUWWj+2S kREbXpfhmf1JaEhQsNaXbKaQFc8mnx1IibP0g/oInd36L0P/CfYoKGi5vPRStqxR4fVD oad+CHp7Q7z4eCFmQZP5WcGmNzrJBuETK+vnAcC4cihvd3RYiRvkCH3NAdBtbZjDDayq A6hckPdMgDclvxqSeCr3B+VETNuhu7xIrHvEkMmAGT9ibFC141Fe7jKhb16Zdy1T5wqq N0YeoBKiuX1/cko8tbyvOLG1yenQ1F8ljbN8NlqhbX74zAMgMmgW4krF1bFbL1bX3AHQ IMEA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1785223914; x=1785828714; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=aKsoUL/x0BWL8hOHZwkWcIVk7QHl+uLVAwgOItINi2Y=; b=lf8fPOoLmbZtkBWqKUT4BPhG4Omf2+5HsnFSiiQhhbUm9O27/fB1QD+D6TfZTLt9MZ sFtbh7e/omCIS6T4prmqPI5kao0wWE3n1kU89iDWmreOMScUkquB1JQFrNSVlQWurdzK cwrfJmh9hy98DPb8WNnTLuPWK1T0Z/wrrU4S/T6QFUDVgRS0Ioq1duinHojzvCLBMV8f TIef1JeYurAU5/e3HQmYRAOBRjE+59RYoJyWgEf7+NFNlegMtrlBFlmXbVpc5JQJN5K5 8J2pEai1a3Jcy5+46Dya8zTfl8d2SUuwB5eOkZrhciIw+QSioTRgELN+8ZuXWLfKaJtd Ltng== X-Forwarded-Encrypted: i=1; AHgh+RotKfgjN20M9VuE4DAnbQF7uJb+Gap5xXT9LjvMRoktGoFMNyWHfI8lnKfiNL9y0o2/7ZO1xwQvyMFh0PU=@vger.kernel.org X-Gm-Message-State: AOJu0Yx2d51aQ4lj2ckXuKySGymVWldLsnFN3Hy9GeWyPAtYBfGAI65E rnbJOl9t45kCUqBeoZqK4nQbID2w3xhjo2oVumpLANtsRD1Nryz39jyJLG0/OIXa0gMX X-Gm-Gg: AR+sD13SzwsJYn4FSK7RJEFd/Z0n3eUPz1Vx/NIt4Xym818bbAGyz1fZr5WFLtpZih6 qoYNUeCHHxoJq8LfuqqIhGAudZmSahDllenXhXDePPqNHGX3eRi4NiRgfxnzlg9Sr8ezn/SVrzc 7YcPT30QDflTgi9hwRft5STPYFGXiCjdQaiwkr+xDI2+HkGiSFKM+Qu/HKOmQQq3Erm09OXDUaC h199E8Y1AV61waDRWNssHrpJ6AkwUy+5Rj8LbL6DPsXT8uell5PpfRbKWu9Jjl5L+yY+5Re5hHZ LWAK7oHXcRWiG8xpZaEB6kjfUkD27eUGf2DomMBmDu9p4XhiLov9/ZOdLeiistlrkBTfY7+l+92 9LdenYXC/0vJ32b/KOcnrKXYX581yRe0KMjB1PsZTZp66a6Mf7k0/2Mco/EjNFQUxFgPlrwgVgq bqobe6doZCD734iDgC09qL4Tixk8TZv8KGbwx6/FgrRQE7gcIr X-Received: by 2002:a05:6820:80cc:b0:6aa:dfbc:65ab with SMTP id 006d021491bc7-6ac969f1caemr610511eaf.5.1785223914280; Tue, 28 Jul 2026 00:31:54 -0700 (PDT) Received: from localhost (c-76-141-129-107.hsd1.il.comcast.net. [76.141.129.107]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7ee2a102120sm14168192a34.26.2026.07.28.00.31.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Jul 2026 00:31:53 -0700 (PDT) From: David Vernet To: "Rafael J. Wysocki" Cc: Mario Limonciello , "Gautham R. Shenoy" , linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, =?UTF-8?q?Andr=C3=A9=20Almeida?= , Changwoo Min Subject: [RFC PATCH 1/4] cpufreq/amd-pstate: Document missing kernel-doc members Date: Tue, 28 Jul 2026 02:31:47 -0500 Message-ID: <20260728073150.54964-2-void@manifault.com> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260728073150.54964-1-void@manifault.com> References: <20260728073150.54964-1-void@manifault.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit kernel-doc warns about five undescribed members in amd-pstate.h: union perf_cached's @val and struct amd_cpudata's @raw_epp, @current_profile, @ppdev and @profile_name. Describe them. Signed-off-by: David Vernet --- drivers/cpufreq/amd-pstate.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/drivers/cpufreq/amd-pstate.h b/drivers/cpufreq/amd-pstate.h index 23e8baa05849..99532595150e 100644 --- a/drivers/cpufreq/amd-pstate.h +++ b/drivers/cpufreq/amd-pstate.h @@ -32,6 +32,7 @@ * @min_limit_perf: Cached value of the performance corresponding to policy->min * @max_limit_perf: Cached value of the performance corresponding to policy->max * @bios_min_perf: Cached perf value corresponding to the "Requested CPU Min Frequency" BIOS option + * @val: Raw 64-bit value for atomic access via READ_ONCE()/WRITE_ONCE() */ union perf_cached { struct { @@ -89,7 +90,12 @@ struct amd_aperf_mperf { * @epp_default_ac: Default EPP value for AC power source * @epp_default_dc: Default EPP value for DC power source * @dynamic_epp: Whether dynamic EPP is enabled + * @raw_epp: Whether the last EPP write was a raw numeric value rather than a + * named preference * @power_nb: Notifier block for power events + * @current_profile: Currently selected platform profile option + * @ppdev: Device registered with the platform profile handler + * @profile_name: Name under which @ppdev is registered * * The amd_cpudata is key private data for each CPU thread in AMD P-State, and * represents all the attributes and goals that AMD P-State requests at runtime. -- 2.53.0