From nobody Fri Dec 19 15:48:14 2025 Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.13]) (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 49FD9268688; Thu, 6 Nov 2025 10:14:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=192.198.163.13 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762424072; cv=none; b=l5uLd1DdLJGvH7Az/mI/UjD+Pst2LNZhttehypdJgozFwC6SALA78uMCptWC1e+m7i/XHgmk9foJlukgmtFq14gIiJqQbT7VpHvMmoipzH5o5iDxkXtBO6slG/5bJFYMUcPRVC2FO1GNnVhvmVzjjlnc/vRJvPD4Ppk7pKMhtaU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762424072; c=relaxed/simple; bh=l2b1j5/Yp/pqI4I8XHvVSJ5OwExUUHKNBWIajqYLZ74=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ZTEysktfq3koqxn22otB/hBnGRWfglii2S0g7Ux49J66EygmfhxofLcAzBIVsD8dP6NQlklriPkiQVtFnZYErJs5eiscVusN/hfophB/PqFKyziNAe/mFU9BMuq9zLAmOECv5+WUJzetwtHwODTjJPRmLr2ANQYPb65l4YDD114= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com; spf=pass smtp.mailfrom=linux.intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=S6tl+CfB; arc=none smtp.client-ip=192.198.163.13 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="S6tl+CfB" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1762424071; x=1793960071; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=l2b1j5/Yp/pqI4I8XHvVSJ5OwExUUHKNBWIajqYLZ74=; b=S6tl+CfBy185pglcHYR9fFHo6+joK7lxyqMRkyJLW0gyX2mh1nFj8j1F DzV95SnAYxH8cR51DJ1fo5M+k+43NiYPYydAVpVfBcy/l2u0RgDy5RmAD wmLnS2gJtOcszU4L/CfJaOm+lRdYwzUlalrNB2drWbSoGGxSHFfSHIACx p0zNOmEc28f5tikxWeJQ9HHayycxoEKN4eBuWnA3uePUBMz9ilkB04+K/ t3A+OUPkcpMot1cywQjhi6c+P9B7fBKYi0HzH3pFYji9hLtyofFvYs64t zhWdyNv2LvDGOU+LbWWnIFR5fOvn6Q9tWdOI7DqgMq5l0S7pF6EZLb+5r w==; X-CSE-ConnectionGUID: Jzz/CaCMQSyXoaaQubVcjQ== X-CSE-MsgGUID: CvdcVcUKR1aZVVANDnznVw== X-IronPort-AV: E=McAfee;i="6800,10657,11604"; a="67169486" X-IronPort-AV: E=Sophos;i="6.19,284,1754982000"; d="scan'208";a="67169486" Received: from fmviesa007.fm.intel.com ([10.60.135.147]) by fmvoesa107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 06 Nov 2025 02:14:30 -0800 X-CSE-ConnectionGUID: rawiGsbdR9CzsDSoQMDFfQ== X-CSE-MsgGUID: pBKL89GzQ62WPj+gdm+rnA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.19,284,1754982000"; d="scan'208";a="187385336" Received: from black.igk.intel.com ([10.91.253.5]) by fmviesa007.fm.intel.com with ESMTP; 06 Nov 2025 02:14:27 -0800 Received: by black.igk.intel.com (Postfix, from userid 1003) id 831FE96; Thu, 06 Nov 2025 11:14:26 +0100 (CET) From: Andy Shevchenko To: Jonathan Corbet , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Cc: Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , x86@kernel.org, "H. Peter Anvin" , Andy Shevchenko Subject: [PATCH v1 1/2] doc: kdoc: Handle DEFINE_IDTENTRY_*() cases Date: Thu, 6 Nov 2025 11:12:25 +0100 Message-ID: <20251106101416.1924707-2-andriy.shevchenko@linux.intel.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20251106101416.1924707-1-andriy.shevchenko@linux.intel.com> References: <20251106101416.1924707-1-andriy.shevchenko@linux.intel.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" We have an unparsed kernel-doc for spurious_interrupt() IDTENTRY. Update kdoc to handle that. Signed-off-by: Andy Shevchenko --- scripts/lib/kdoc/kdoc_parser.py | 27 +++++++++++++++++++++++---- 1 file changed, 23 insertions(+), 4 deletions(-) diff --git a/scripts/lib/kdoc/kdoc_parser.py b/scripts/lib/kdoc/kdoc_parser= .py index f7dbb0868367..b583edd80a52 100644 --- a/scripts/lib/kdoc/kdoc_parser.py +++ b/scripts/lib/kdoc/kdoc_parser.py @@ -1430,6 +1430,25 @@ class KernelDoc: =20 return proto =20 + def idtentry_munge(self, ln, proto): + """ + Handle DEFINE_IDTENTRY_*() definitions + """ + + name =3D None + + # Replace DEFINE_IDTENTRY_IRQ with correct return type & function = name + r =3D KernRe(r'DEFINE_IDTENTRY_IRQ\((.*?)\)') + if r.search(proto): + name =3D r.group(1) + + if not name: + self.emit_msg(ln, f"Unrecognized IDTENTRY format:\n{proto}\n") + else: + proto =3D f"static inline void {name}((struct pt_regs *regs, u= nsigned long error_code)" + + return proto + def tracepoint_munge(self, ln, proto): """ Handle tracepoint definitions @@ -1499,13 +1518,13 @@ class KernelDoc: # Handle special declaration syntaxes # if 'SYSCALL_DEFINE' in self.entry.prototype: - self.entry.prototype =3D self.syscall_munge(ln, - self.entry.proto= type) + self.entry.prototype =3D self.syscall_munge(ln, self.entry= .prototype) + elif 'DEFINE_IDTENTRY' in self.entry.prototype: + self.entry.prototype =3D self.idtentry_munge(ln, self.entr= y.prototype) else: r =3D KernRe(r'TRACE_EVENT|DEFINE_EVENT|DEFINE_SINGLE_EVEN= T') if r.search(self.entry.prototype): - self.entry.prototype =3D self.tracepoint_munge(ln, - self.entr= y.prototype) + self.entry.prototype =3D self.tracepoint_munge(ln, sel= f.entry.prototype) # # ... and we're done # --=20 2.50.1 From nobody Fri Dec 19 15:48:14 2025 Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.13]) (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 40E3130CDB5; Thu, 6 Nov 2025 10:14:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=192.198.163.13 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762424073; cv=none; b=kmXazm7nctjVX4hCcE0XDQ9jlcWFQZsg5Qw9IWdSAd1bSnYgU4FjmOphX92BRR9XaEO09tEy9eerFAbank7Ik6zLgCZHhFQMQmMnQHOyOlnvp9nraKbKXnoItLRYTH7EwJWDvZlNw/a9uXU6jBFzhW0g1C8FGt8izqfphPIRyM0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762424073; c=relaxed/simple; bh=D0c1o0g+7l5tANzTq/Aq54JsjXTAfQD9PUNnw6N4PWo=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=lZZbVao4rxvQk82Or/cCZoKdmY1B9Z7oCV1ZF9Tmr6OedlaN6MzH8mbZWLWKxG/vz4QzTCi9427kpJMIyhBAZ9LlvjndJm3rBLSXkFZLB3tudCc8s0NTIU5AWLsVFGhf9E/bJ1XD+iANC4zS/tCWhHI0m3t7PNGC9FFqTDgvL/Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com; spf=pass smtp.mailfrom=linux.intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=eoW8jiVE; arc=none smtp.client-ip=192.198.163.13 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="eoW8jiVE" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1762424072; x=1793960072; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=D0c1o0g+7l5tANzTq/Aq54JsjXTAfQD9PUNnw6N4PWo=; b=eoW8jiVEXVSzR++Ay3h4QdDSvyJ19LiFoEtYADK7q4lmKjXnzh7vgoO9 qQks1MgsOonADkmuAaqghmy458xcSByAjZm4syEKhYddmwnpEuH6YUd3V S6jfUazNzo5hGAnMdH2D81BiGWQNvniVfWZ50BO172rdMMKp5d+fDk7VL Eg9rMAakOG3+0ofSKCXs5muIgxfJMw6xNRhSzVNn7yzwu901ObO+1n/6V jSa0i+WAQEmm5cq9YAqEzO+g1iMQlsqCxtXM5XX4bkH8fUktevZ68335G +LOQwoespR34kh1v7MIGhvdlz0d/snEzY8RW6HncGCcKHyXvIdCJT4tf4 w==; X-CSE-ConnectionGUID: bdCLBNAbQeiP20qTtreFGA== X-CSE-MsgGUID: Ul6g1DssTpqWLjop+dveGQ== X-IronPort-AV: E=McAfee;i="6800,10657,11604"; a="67169488" X-IronPort-AV: E=Sophos;i="6.19,284,1754982000"; d="scan'208";a="67169488" Received: from orviesa005.jf.intel.com ([10.64.159.145]) by fmvoesa107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 06 Nov 2025 02:14:30 -0800 X-CSE-ConnectionGUID: M0RsptvdT+yGoSfhNVBi+A== X-CSE-MsgGUID: irFrkxs/S46QYNqXPSNB4Q== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.19,284,1754982000"; d="scan'208";a="192891391" Received: from black.igk.intel.com ([10.91.253.5]) by orviesa005.jf.intel.com with ESMTP; 06 Nov 2025 02:14:27 -0800 Received: by black.igk.intel.com (Postfix, from userid 1003) id 8797097; Thu, 06 Nov 2025 11:14:26 +0100 (CET) From: Andy Shevchenko To: Jonathan Corbet , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Cc: Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , x86@kernel.org, "H. Peter Anvin" , Andy Shevchenko Subject: [PATCH v1 2/2] x86/apic: Update kernel-doc to avoid warnings Date: Thu, 6 Nov 2025 11:12:26 +0100 Message-ID: <20251106101416.1924707-3-andriy.shevchenko@linux.intel.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20251106101416.1924707-1-andriy.shevchenko@linux.intel.com> References: <20251106101416.1924707-1-andriy.shevchenko@linux.intel.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Validator is not happy about some of the kernel-doc descriptions: Warning: arch/x86/kernel/apic/apic.c:245 No description found for return va= lue of 'lapic_get_maxlvt' Warning: arch/x86/kernel/apic/apic.c:2145 function parameter 'error_code' n= ot described in 'spurious_interrupt' Update them accordingly. Signed-off-by: Andy Shevchenko Reviewed-by: Randy Dunlap --- arch/x86/kernel/apic/apic.c | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/arch/x86/kernel/apic/apic.c b/arch/x86/kernel/apic/apic.c index 680d305589a3..4675d1a07fc9 100644 --- a/arch/x86/kernel/apic/apic.c +++ b/arch/x86/kernel/apic/apic.c @@ -241,6 +241,8 @@ u64 native_apic_icr_read(void) =20 /** * lapic_get_maxlvt - get the maximum number of local vector table entries + * + * Return: the maximum number of local vector table entries */ int lapic_get_maxlvt(void) { @@ -2136,7 +2138,7 @@ static noinline void handle_spurious_interrupt(u8 vec= tor) /** * spurious_interrupt - Catch all for interrupts raised on unused vectors * @regs: Pointer to pt_regs on stack - * @vector: The vector number + * @error_code: The vector number * * This is invoked from ASM entry code to catch all interrupts which * trigger on an entry which is routed to the common_spurious idtentry --=20 2.50.1