From patchwork Thu Jan 4 01:32:51 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 184885 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:6f82:b0:100:9c79:88ff with SMTP id tb2csp5363202dyb; Wed, 3 Jan 2024 17:33:23 -0800 (PST) X-Google-Smtp-Source: AGHT+IHhVLXhOxx5WStcAGHSvf6xW9vOZvMr8HOFkyHGldayugsVm9pNZmyZAmm7kugmn6WylSyn X-Received: by 2002:a05:6e02:1d8c:b0:35d:62f2:1f45 with SMTP id h12-20020a056e021d8c00b0035d62f21f45mr31431816ila.20.1704332002968; Wed, 03 Jan 2024 17:33:22 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1704332002; cv=none; d=google.com; s=arc-20160816; b=x5/5u5ymhAgki65mqQlTIyUAUXMp4GQzZF1DYgbAcsGZl4Ywj8rYqbA8nNvNSFJ4Kc tpjle1WeAIpjdeYe3VPpd27c3zR7m349827Mo8exU1eMEluiFpIWmlB8A9NNOx+U1p+c TeX2k7Eq9ykmzvzezSnywGkVDA+jROobpSrmkTCyWqihwxv7cemjNZ4/Y558yRmGwVy0 aJAW/eeFRNlS5ikDu1eKiwoEM37q4cQvo9BivY5cjkhywWcCpIf1dPHt1IGdBxNFS8x1 JmID2RYBg9lmDMo8Ja/Y0fjVAvjgsBdIHOHZ6d1QY2DWDTsfzJj4MWGeqLvtyHnYohT+ /ePw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=K4FGLqD3uBdoWg9s/jHgykLgM1NMmD65870GHPhgAJQ=; fh=mI98GeH76dSfoleew24z62/yEGEfqfvUJc0DY7aOn4Y=; b=Fw45ROGwRZjkSpJSKZ9VZ+aFRX8Pzs2EMQf2eIHxCFg5uIxinF/w1IsVfYUEalrJV1 775WEwcy+ubXku9uxp9lPLBcOt1cHYSJ7hPDxeS29q9/7skuEqZZF7epTNdKsgV3XW6P Wft6YUxGpc8CsoEDeEW/FIXquW0l0MlFz+adcDEbq+RjqISrdq6dvHkTd7rJwkMCA0cb dA2fXTeJBVCaWKq+siZfdT8UldktHnDlziLVjRDQlZCb9u34VQbtJi5U+gGsi4eYUrv2 6jaiuBlxC3qWLgqt9UUWShAfnOcocUlNgDDaQsrAB1SRzrNM9rf0joRvtM+AgF7jkJiQ G1QA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=IB8ZWww2; spf=pass (google.com: domain of linux-kernel+bounces-16182-ouuuleilei=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-16182-ouuuleilei=gmail.com@vger.kernel.org" Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id e20-20020a656494000000b005c635a9d1f2si22414070pgv.156.2024.01.03.17.33.22 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 03 Jan 2024 17:33:22 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-16182-ouuuleilei=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=IB8ZWww2; spf=pass (google.com: domain of linux-kernel+bounces-16182-ouuuleilei=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-16182-ouuuleilei=gmail.com@vger.kernel.org" Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id B7797286FE4 for ; Thu, 4 Jan 2024 01:33:22 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 1F2004C9A; Thu, 4 Jan 2024 01:32:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="IB8ZWww2" X-Original-To: linux-kernel@vger.kernel.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 6ED2F4417 for ; Thu, 4 Jan 2024 01:32:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=K4FGLqD3uBdoWg9s/jHgykLgM1NMmD65870GHPhgAJQ=; b=IB8ZWww266mfUb+riNCgbPaAe2 c2ojz9fx28CDtTRTKM5M/refK4xHzIMeSdWUZDmKdf0lKY9DtYwGhIATflFHpBg5XqSEJ1AxQfMdo WTUtWe18nvqT6tyy9dkYag0vNlDyiogiXrjv1r8N/p2O/EuQd7SQM7oj536xtCSqAlgpNX8tM1u+W jYFaWlKz5EAnDEnbdaviEswjnb9WOt7TLaV+hU7MKu5BIf+Jt/q7gdvrlLIA89pvtczzKhuJgPOAq FGlLDFW25xpsdPERlOiZfq8PY0ZzPMTCYlh8esK9wMkYGlyeeu+7frzByuIIwV/JsE1GcSH8nmsRX YsgKjZQw==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rLCbM-00Ca9g-1g; Thu, 04 Jan 2024 01:32:52 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Andy Lutomirski , Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , x86@kernel.org, Jonathan Corbet Subject: [PATCH] x86/entry: don't use kernel-doc for IDTENTRY functions Date: Wed, 3 Jan 2024 17:32:51 -0800 Message-ID: <20240104013251.14440-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1787121634521856330 X-GMAIL-MSGID: 1787121634521856330 scripts/kernel-doc doesn't handle DEFINE_IDTENTRY*() variants so it prints a warning when processing them. In order to reduce/remove kernel-doc warnings from the kernel, don't use kernel-doc notation for DEFINE_IDTENTRY*() function comments. This brings the common.c usage in line with the more than 50 other uses of DEFINE_IDTENTRY*() in the kernel. This prevents one warning: arch/x86/entry/common.c:211: warning: expecting prototype for int80_emulation(). Prototype was for DEFINE_IDTENTRY_RAW() instead Signed-off-by: Randy Dunlap Cc: Andy Lutomirski Cc: Thomas Gleixner Cc: Ingo Molnar Cc: Borislav Petkov Cc: Dave Hansen Cc: x86@kernel.org Cc: Jonathan Corbet --- arch/x86/entry/common.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/x86/entry/common.c b/arch/x86/entry/common.c --- a/arch/x86/entry/common.c +++ b/arch/x86/entry/common.c @@ -188,7 +188,7 @@ static __always_inline bool int80_is_ext return apic_read(APIC_ISR + offs) & bit; } -/** +/* * int80_emulation - 32-bit legacy syscall entry * * This entry point can be used by 32-bit and 64-bit programs to perform