From patchwork Wed Jan 17 23:07:05 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188991 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp94481dyb; Wed, 17 Jan 2024 18:59:42 -0800 (PST) X-Google-Smtp-Source: AGHT+IFNyK5HjnN9Getwk/DLnWv7zDA+YikA80Eke+nOGaqondnBpTZ0kNhyRnoi/omn9GMi2fRX X-Received: by 2002:a25:ae67:0:b0:dbf:23cd:c059 with SMTP id g39-20020a25ae67000000b00dbf23cdc059mr129927ybe.88.1705546782190; Wed, 17 Jan 2024 18:59:42 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705546782; cv=pass; d=google.com; s=arc-20160816; b=Lx5xxape8bLuf11Lj5sR4QhncBVzGif+6hJAksJdUNAV2hdElMBjN2BsRig8RUngRh MQ9bcuPloe8v9uNdDn+xVA/U00V5VI4SXacwqwroOr+MOesRExvYtNOIU0NFpBmQ/TK+ SToIahudS6j8QkHK4L6IHn9ZgrJS5RoMFEQhccPn0QEpEL84q2eMvBUP5eiOsxPn4Civ KV/NjFQ6HEvplI9W7VanBTItj7XgfRGwuCT1aq6vETMde9PYSypermSJpEwR0bXXxlul 2vlI1K0vh1SmDJxqRIbUly3nPkbpCwXSzWTbvdd5pGr0ckSCdy/B89+Ady6kDguzOVFX 3MlQ== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=33pXiC615tAp01UX0oIvnU0m5UyE9DId90eSm2AOiDA=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=cXTSy1w0BgHPqC8cfSEr/CXDIBQrT7NiGUXC7WFfwq98NUxRSj3o3wFU8/Pc4DSitB 77Wf0DbyYRF/vqzQe5P/1xi+ol0roTL4CGA451Q7DfIJgQdGAVeqNE8p5mIDH9tBFQ11 Mg9YZPLvlWjpFFxg68kUUPjT5hBj6Hbd488cIskAamusa5SMwX5nKKRUuF2CDxgD4Hh8 FVPBmXP8BWHDL+J3P6/+tRUMCGEkaZXqgN5VjXX0HV19uS1PAdXiiE4pfNii9wmbI1TS qCOng6tGhHweL2k/XlHzyAIJOACDaSjXGIQCBdVMcTLLpyfMKyFZRv9HDqVgXG2qGTZS aniA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Cmnv6kko; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29534-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29534-ouuuleilei=gmail.com@vger.kernel.org" Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id y6-20020a63ce06000000b005cdfc019324si641148pgf.629.2024.01.17.18.59.41 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 18:59:42 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29534-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Cmnv6kko; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29534-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29534-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 sy.mirrors.kernel.org (Postfix) with ESMTPS id 128D8B25968 for ; Wed, 17 Jan 2024 23:08:12 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id EEEDA28E29; Wed, 17 Jan 2024 23:07:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="Cmnv6kko" 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 E9956224C2; Wed, 17 Jan 2024 23:07:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532840; cv=none; b=NigVH1nI1ysDZI7njiK9OPhcQtNOuEAhZduqoOyXN0GfnB8pszjSLPOEnNU6bChIX4IoIMgPahRFwYEZMDUI9td+SpHw2jNU7LdxN3cUoF4R4YILTAcSoNUwSrugoJa1zbUQE1K8yrvT5+oGXo1Q3TWHKugf7s9goFKOiprTPmo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532840; c=relaxed/simple; bh=AxL2pBXazAzg//MRXlYnFJ53tGOVmTSBSNMjNVOlrTQ=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=GXdL1HAoH54cFJwrJgYU8758c+ExduJIiWjcjGQ6MWzB9KAlfsrUz1i7kAlEHSN0s2ndt0fZXa4S1j0Lpm5jlDnPlAfC4bxJECQ9PgBZZpALJ/lUiPlM/PjezMuvZiGeLKyypSDLf74D0e2/O7y90fq/DvkBI8Xm1aiErLSUGzg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=Cmnv6kko; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=33pXiC615tAp01UX0oIvnU0m5UyE9DId90eSm2AOiDA=; b=Cmnv6kko4O6H4EJIhtFSqIpoQp hhIHa5nLJ04S5KtXMPDlgR2LRpGkaqeRAtoN8iiTsqcAwuv6QsHOS9S3b19eZwO9bxF6Cuc5k4Z2z eeDXeeoaZ5cOj+bJSk32R01arFIetSHojqNyIKi8YA7Q4MPEyGpT4PxiTKkY7WQNDUceL2D+vizAx SYTAllYONNHpFNToNSpWPhDu3O7FX00ZwnA6UikLt66+Xes+jxooifGSV0lwvEHKbdlLMYx84oVbC 9w2UaJ+++NK0WrPCcAI6R5TuIcc/u2doq3w13LM4YR2tsx2PVpEnZIJFrAvq2zXDqSSrOaxXL1nUE TWj7KjRw==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF09-0011su-32; Wed, 17 Jan 2024 23:07:18 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 01/10] KVM: arm64: debug: fix kernel-doc warnings Date: Wed, 17 Jan 2024 15:07:05 -0800 Message-ID: <20240117230714.31025-2-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788395422496753880 X-GMAIL-MSGID: 1788395422496753880 Change one "/**" comment to a common "/*" comment since the comment is not in kernel-doc format. Add description for the @vcpu function parameter. These changes prevent warnings: debug.c:27: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * save/restore_guest_debug_regs debug.c:27: warning: missing initial short description on line: * save/restore_guest_debug_regs debug.c:149: warning: Function parameter or struct member 'vcpu' not described in 'kvm_arm_reset_debug_ptr' Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/debug.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff -- a/arch/arm64/kvm/debug.c b/arch/arm64/kvm/debug.c --- a/arch/arm64/kvm/debug.c +++ b/arch/arm64/kvm/debug.c @@ -23,7 +23,7 @@ static DEFINE_PER_CPU(u64, mdcr_el2); -/** +/* * save/restore_guest_debug_regs * * For some debug operations we need to tweak some guest registers. As @@ -143,6 +143,7 @@ void kvm_arm_vcpu_init_debug(struct kvm_ /** * kvm_arm_reset_debug_ptr - reset the debug ptr to point to the vcpu state + * @vcpu: the vcpu pointer */ void kvm_arm_reset_debug_ptr(struct kvm_vcpu *vcpu) From patchwork Wed Jan 17 23:07:06 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188980 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp66403dyb; Wed, 17 Jan 2024 17:35:22 -0800 (PST) X-Google-Smtp-Source: AGHT+IGwrPIewav5+1xS3SAHAudNOcTPyW01XRA8ZDQuYHPhagm4KdqYyETPuFIGNTEGGFZa2T0I X-Received: by 2002:a05:6214:496:b0:681:85b8:d506 with SMTP id pt22-20020a056214049600b0068185b8d506mr62543qvb.58.1705541722123; Wed, 17 Jan 2024 17:35:22 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705541722; cv=pass; d=google.com; s=arc-20160816; b=zvK7E0TIemdu9RvgR9DwitouY94HzepldVp9Wpd7osO1RarynNsEMy1P2KIIjRJvi+ ZGKQTWxMtnzW6h9W2r5l/tE8zf8+qe2Ej8viqNMWpiSU1mFAVxLXCpH/av+7eTp7YjMv oxWSQnjvGLoo0aqzCNdkHsG1X+tzun8+2oCaz3OvvcSdmP8i336cBs+8Kl7BDNhKizVk fwH6RQGqRYtgelMLE42QaK32YDFQDh2KDRWwSUcw3C6yYf0Q9OnosjOlIiFYjINb3x3S vIA5auVQF7TC7F0zpvMKMljaUiVink8raWJUbe3s0NnCfM2FVxPb6BRMbVwFyzxyO1mN mxJQ== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=ypndJ3q6jZFQH0yBwkGZzBndYEsmF1d2BBCzWXEQX3w=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=Umh4+qag/+GTKrTUYp7ndKjr8bNXAUB+r9hj71o5GVMhyH2bvpjfKV1pZTtlqyv+w4 hTkodeqj59BxDzhAnogo8UqcCofJvcuQHwTwog83sliHbs/w4ppUJvkZ217X6SDc3dS6 9yG1M4FP/GmqIgrnwVSSGmE+w5Nk98fZpWuCvUnxoh19+74TY4rERT9LXuNWK/EkJg2P r/e1005TbnbRaOScg2gJ6y41/ZV2ALJKThYYePOS3KJ/sGCt654U0/rMbyUWHC9AU1ZE BIuA80otHHAkwbnPsmTo/AB6vZV7jQyTroP9yWRvsfXles6o8bsZxAjD4Jph3/lCBQzg eR0g== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=vukh56S4; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29536-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29536-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id v7-20020a0c8e07000000b006818638771asi1478054qvb.200.2024.01.17.17.35.22 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 17:35:22 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29536-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=vukh56S4; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29536-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29536-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 ny.mirrors.kernel.org (Postfix) with ESMTPS id 035D51C24F04 for ; Wed, 17 Jan 2024 23:08:30 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B62982C1A3; Wed, 17 Jan 2024 23:07:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="vukh56S4" 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 2C20322EFE; Wed, 17 Jan 2024 23:07:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; cv=none; b=rdQIBAPwEBGdiL4gkbJWikBQYVSZPk7K2zih4tkqsR0OVN8euEwQ+53W0MTYKWj3zxX4twaUy6lgjLoXQHbaxMiTOH0ABt+3wJB0n3Ee57skMMnD5je2ItRN/8kE3Sr9bYMYhDyKWvUMRIZi6ITOcadef4Cvu+lHdRk7fXhNwWc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; c=relaxed/simple; bh=qe4FjNte+EfV+SxIMOllnF2vE+IqSHEb4QBYlyFCKsw=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=QRQSm5IGhuuDI9iP5rFe1ldILdOXBdttVYNgysbjjwPpdWxCrMwhhQJ9IZrXc2j5e6h25ddkZgCgCX10ZXobR7smy2SRjZof5nKPEPGBh5oYSxcJ+tnqL74MFpPWW08stpZym6lwx1dQU6X20C9Jwr2fDgjuHi2RvsArc0mrKHs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=vukh56S4; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=ypndJ3q6jZFQH0yBwkGZzBndYEsmF1d2BBCzWXEQX3w=; b=vukh56S447fwfDPuha9YigmbqP xSj28FnXgN2ji/AhU5njJCQrHUZXD7c2czNhmxmWTBmgs0rUxN7j6I+8+weQYQHM8KloLlg1BRX/O OE+lfxPBfWTWB6sPHlfx1tH9ABKq5PYWkCxxEmrHjpEojMumot9bai3FYKkW7Wg9ozrfFGI49tnn4 oyCbodzxiV6e66TB2CBkVYdEkkKFbReJavH3yrDrsS5Rwr/c5McMrwK+S/1JV0fPWSrIHt7ole8kV bTFg7BrOWIMMAXJSBUVl1PHvUhhPmXmctYj7VeToE+r+OfF86H3AuAgdWDX8laDmcGlzQ6mg45Ll8 gLBz2VZA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0A-0011su-15; Wed, 17 Jan 2024 23:07:18 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 02/10] KVM: arm64: guest: fix kernel-doc warnings Date: Wed, 17 Jan 2024 15:07:06 -0800 Message-ID: <20240117230714.31025-3-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788390116699235210 X-GMAIL-MSGID: 1788390116699235210 Fix multiple function parameter descriptions to prevent warnings: guest.c:718: warning: Function parameter or struct member 'vcpu' not described in 'kvm_arm_num_regs' guest.c:736: warning: Function parameter or struct member 'vcpu' not described in 'kvm_arm_copy_reg_indices' guest.c:736: warning: Function parameter or struct member 'uindices' not described in 'kvm_arm_copy_reg_indices' arch/arm64/kvm/guest.c:915: warning: Excess function parameter 'kvm' description in 'kvm_arch_vcpu_ioctl_set_guest_debug' arch/arm64/kvm/guest.c:915: warning: Excess function parameter 'kvm_guest_debug' description in 'kvm_arch_vcpu_ioctl_set_guest_debug' Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/guest.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff -- a/arch/arm64/kvm/guest.c b/arch/arm64/kvm/guest.c --- a/arch/arm64/kvm/guest.c +++ b/arch/arm64/kvm/guest.c @@ -711,6 +711,7 @@ static int copy_sve_reg_indices(const st /** * kvm_arm_num_regs - how many registers do we present via KVM_GET_ONE_REG + * @vcpu: the vCPU pointer * * This is for all registers. */ @@ -729,6 +730,8 @@ unsigned long kvm_arm_num_regs(struct kv /** * kvm_arm_copy_reg_indices - get indices of all registers. + * @vcpu: the vCPU pointer + * @uindices: register list to copy * * We do core registers right here, then we append system regs. */ @@ -902,8 +905,8 @@ int kvm_arch_vcpu_ioctl_translate(struct /** * kvm_arch_vcpu_ioctl_set_guest_debug - set up guest debugging - * @kvm: pointer to the KVM struct - * @kvm_guest_debug: the ioctl data buffer + * @vcpu: the vCPU pointer + * @dbg: the ioctl data buffer * * This sets up and enables the VM for guest debugging. Userspace * passes in a control flag to enable different debug types and From patchwork Wed Jan 17 23:07:07 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188972 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp33200dyb; Wed, 17 Jan 2024 16:12:11 -0800 (PST) X-Google-Smtp-Source: AGHT+IGYE6PZ8Shi7LsThsMXp2ypsZrq+nbWkN1zuJybE3GG9plZmAV2AB58qDJjb7RFmc34P67/ X-Received: by 2002:a05:6a20:4327:b0:19a:5d55:2d8 with SMTP id h39-20020a056a20432700b0019a5d5502d8mr78723pzk.44.1705536730838; Wed, 17 Jan 2024 16:12:10 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705536730; cv=pass; d=google.com; s=arc-20160816; b=qcQpuEgVZnbtbHT3NwTZt/nEm6ooDtipSYDp/yHHodvLfqubHLXLvjG2B25kNHmfuT 0eOOYmZ4AMORRc24O+JjF4cvTwiUGLSMEqkOPxP+ql4Dpk+tBUY69w27om1kZDDoegnG 9sLWD3Wsc9va/p/aSo9nNBx56ybzZbKJl61iiU8AOpokyVrWG/maSL5h9c/4M30y507q ZjN8iYbuEncJo1KJLWVRm9n0v4tbjLAZV/3oTJAgISFD+BIuPaWB6mrBHSQkSImcUj/v BOp3GR9rS6opNjA5V8hFEjUz4wE5t0QpPvexzS9aFDYdv6Xs9SrnynW7f7gEhW2afOsT jcbg== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=OkMmSUUzqla7nDqkHEtROz1zMAm2J8YGPaDlVU8GXs0=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=Cs2O/b+8MaxKsKfDDd3pZqB+UTknT+4Ak8j4BNA84N94iuYuvzCzy7K/Fj9yIv4vvi zt3zn4hUk/82bvY7wPY2Jv8sl/O5WEMT4Ac9A4st08Z0IP8GInHHGW8oh5HqL/RaLFQI 1TcM5P/PGnXVhomM1EQSTMax2idBEm5bmszz120kSfHNyepoU1mfUN0oSOVnbROJyANo UhFHa6M3OG0v48QpoH2268nDVISoleZ3gOBcDF+DckjNRo77rZpWanotvVlpj4uiBZcf l4fYtpORXNK8+Uibd+97ez+IbVrpUDmqUxQUPhg+hRoaMV02unZtZhwC3HSlJKw48Q0S vmlA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=WnGLn10S; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29541-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29541-ouuuleilei=gmail.com@vger.kernel.org" Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [147.75.48.161]) by mx.google.com with ESMTPS id l73-20020a633e4c000000b005c278ba0fe3si420955pga.556.2024.01.17.16.12.10 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 16:12:10 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29541-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=WnGLn10S; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29541-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29541-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 sy.mirrors.kernel.org (Postfix) with ESMTPS id D5771B2639D for ; Wed, 17 Jan 2024 23:09:42 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 444DC2D04B; Wed, 17 Jan 2024 23:07:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="WnGLn10S" 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 4E08222F16; Wed, 17 Jan 2024 23:07:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532842; cv=none; b=DtyTJDJiohYqjhUvYR8yMMvt+JHiu9Z/M8Z3UrWRbCA8p6fWJRCBJch17KgIxKDnvsx3wI6WNsMjLdLXlpLNV3p85GvfWHxF7YCaoOv6OF8e3UbGSlVIUHyhABFKYbihiySEgaGRUupDoxeiPzqL5qv7czGW6Ln/mHBQL6c0+T8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532842; c=relaxed/simple; bh=aeEiGwIx8qsK2ZA3R5/Sp9ad7VIHQstjCj1Q1oj46ws=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=B4Q1bVXh5MJ+1lRVdy2L6kPi4GuWqy1QgTWSaiJ8KE5WsaMDglYmqGNKXIRgSiVFcHwaANrNvCR+d7vvQro8CDWXO6VKqyhJRAWOLOnqIEBD1zD94MWG/4x1hVltwWGSg/KWjb4FQDHAFzl27PQpNgFKu1pDjwM6yB5kBtZVS64= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=WnGLn10S; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=OkMmSUUzqla7nDqkHEtROz1zMAm2J8YGPaDlVU8GXs0=; b=WnGLn10SkFXQy4WxXtZftFWBvb iIPZ7CI0D/9n6whLhQ3NKJ0z9XsPngXKyZM6CEsFnuoz2MuakwUTTgI/5q7zZcZ8WzOHkcncE3Yz6 BU+e8Hh7AP+GHsNfsl+KC+tqOmaWWyvxrH0DC3jIMhSnIxJIjJKDqVqCV24C5W6YW4NlpfjW/2mht h6/gEFkv96JF5TI673TW/tda4me7yey+3M+kznIC+uWeLmN36LnDxWlsRgxyHYpuedJ1zjt0+jCz8 ELArJDl20U2teOO6xKvMfGn/8lQGF7zDgilUTgIpYC/svoxQOk8aDoMdTw48gEFqGiZDurglEqlRv azcWBpuA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0A-0011su-2T; Wed, 17 Jan 2024 23:07:18 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 03/10] KVM: arm64: hyp/aarch32: fix kernel-doc warnings Date: Wed, 17 Jan 2024 15:07:07 -0800 Message-ID: <20240117230714.31025-4-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788384883248368729 X-GMAIL-MSGID: 1788384883248368729 Use the correct function name in the kernel-doc comments to prevent kernel-doc warnings: arch/arm64/kvm/hyp/vhe/../aarch32.c:97: warning: expecting prototype for adjust_itstate(). Prototype was for kvm_adjust_itstate() instead arch/arm64/kvm/hyp/vhe/../aarch32.c:127: warning: expecting prototype for kvm_skip_instr(). Prototype was for kvm_skip_instr32() instead Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/hyp/aarch32.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff -- a/arch/arm64/kvm/hyp/aarch32.c b/arch/arm64/kvm/hyp/aarch32.c --- a/arch/arm64/kvm/hyp/aarch32.c +++ b/arch/arm64/kvm/hyp/aarch32.c @@ -84,7 +84,7 @@ bool kvm_condition_valid32(const struct } /** - * adjust_itstate - adjust ITSTATE when emulating instructions in IT-block + * kvm_adjust_itstate - adjust ITSTATE when emulating instructions in IT-block * @vcpu: The VCPU pointer * * When exceptions occur while instructions are executed in Thumb IF-THEN @@ -120,7 +120,7 @@ static void kvm_adjust_itstate(struct kv } /** - * kvm_skip_instr - skip a trapped instruction and proceed to the next + * kvm_skip_instr32 - skip a trapped instruction and proceed to the next * @vcpu: The vcpu pointer */ void kvm_skip_instr32(struct kvm_vcpu *vcpu) From patchwork Wed Jan 17 23:07:08 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 189000 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp119632dyb; Wed, 17 Jan 2024 20:21:14 -0800 (PST) X-Google-Smtp-Source: AGHT+IEXGlkgj/q6p/LYYzWVdEWihxhdahNteyab+rP4KDFNkcccFBY7mGsdord1n5gKnA/OaPe/ X-Received: by 2002:a17:90a:f015:b0:290:9b:252f with SMTP id bt21-20020a17090af01500b00290009b252fmr224017pjb.18.1705551673919; Wed, 17 Jan 2024 20:21:13 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705551673; cv=pass; d=google.com; s=arc-20160816; b=D+UmH4z+ofpaJYobuGaOKf0VTavWI9YKmD4Ubj6ItmhOlZmhb/B+6YWzypEJh8lvGo KDEMmkzcAEi8hwVjSXf2mPsp4FM4tQyJAYRor/DL2chfpPDdqp0i4JnxxU0sNjUAA9QC 2AK8MvWxHIQav+lSuvHEl10iPPbPHh2ryNtv1qahzagTA5WKnOA3HWm0WLX01pZCupGa k1L90vWUTOkJrKTPyIZ36EWCxVFpO9S4OHUDD09DSR/DBBbWKEJnBaZAtrR0yFczlUpc N9RVH+bEm2kpKi4aOnPrrDdlCFswJ6QvrHu3Es9LFpNkg8up1ZWUdwX7bX/Gthqyu5Ji SAtA== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=tL7JHTjwR33SLiqO2gdH0Yo2NTGGiSKZCN1Uyn0m5mI=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=Svc+4Lu8mioHkeW4hAvxExnLZt8tUG1qx+Q3b2ExF4hrIhKRibKsQDXbNckV54Cph3 To6hwA0S1qBlDAIO2fmG85m/xBOB/hvrnD+cJP0MKtffUF7Vnynw8EdMF4xZTXtW5tpF /koqQhXNkIKPdULVCc95/r9ZfuEXOMVPaEbN+yp5QL00emr2hQs8pIHZ/TtrU5IYzK+e YXxpx3ufVsEDtOUcWZR+vbS3pERWO6Nnt4YK1IQxLrax03K5e27M6Q1+UhoS20wt3ef7 /CyGuElU2i+ENGojpw7gxyLhWML37iSZN2zqCbui3jJv2/R992OBHlme5Ukow8GWmxbw 6NHQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Sqv8CQ31; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29537-ouuuleilei=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29537-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 v13-20020a17090a0c8d00b0028e8bf193e3si740676pja.97.2024.01.17.20.21.13 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 20:21:13 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29537-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=Sqv8CQ31; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29537-ouuuleilei=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29537-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 4695128BAAD for ; Wed, 17 Jan 2024 23:08:31 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id BF3412C1AA; Wed, 17 Jan 2024 23:07:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="Sqv8CQ31" 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 CF11022F17; Wed, 17 Jan 2024 23:07:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; cv=none; b=S9kDCAWmz2Oc+2w7wFFPKNvoWlGySzjDUZliGQ6inWzRy/E+lpTXsx4NayTeYX2SO9+Zx6fljQ9sBDP76EgcPZ1S03yIhCpy02lwFdWLBkucoNdw4WaB0AV5JscZx+PmF8i9vJ5F6NCP3kfqk1vZQ2wigDoYRwQRVkY8MLILSGQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; c=relaxed/simple; bh=n2BhsFjGcr7MuBGXteubepVgpYIPmnI7f0uYF07S+ws=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=NFA+EJ3Edi6Qmw7suZWtP5DoJWFtJ60Alz1vlHuyIczkmW40iAGSJtiBHl8Sx3MIrrcXQSMHyTWV9gnWUfhj97v3el5VK5q1ukV4a9+rrgFrFWU4PCroeiMN5kb7spXpYGVL+vPxXRoif7lNq4CkCrf01tieBSzHw0Hy5iKnuDM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=Sqv8CQ31; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=tL7JHTjwR33SLiqO2gdH0Yo2NTGGiSKZCN1Uyn0m5mI=; b=Sqv8CQ31VYBNhnIc0P7XixwtXT UCNNXnytKrLzNfYcp6PVfgpzgkK1JnH1NAImPVR5rgreMrkMZihTo/UJwut9gap69NUCNqJgn68u9 pOydntKBU8khfOD2OebL/B6gKWtDotkgzZwysWHPecQfpJfnA/LvHZ6rKid/fqmO49qxIAAV2qa/2 dZb63Uzw1ZN4O78teO2NwvYEXgsprzKOxgKXYOaZNXcXslic31f4+nVBrriz20JX9h2exO0SXDbmh VQjarR4Yhn/HYPHZ8koIbUdIbTW/qFemhve23Qgps8zpmwjUlafU0omnlDGq1/QuavHlpLs5FS62H zIubOWZw==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0B-0011su-0O; Wed, 17 Jan 2024 23:07:19 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 04/10] KVM: arm64: vhe: fix a kernel-doc warning Date: Wed, 17 Jan 2024 15:07:08 -0800 Message-ID: <20240117230714.31025-5-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788400552189986583 X-GMAIL-MSGID: 1788400552189986583 Use the correct function name in the kernel-doc comment to prevent a warning: arch/arm64/kvm/hyp/vhe/sysreg-sr.c:109: warning: expecting prototype for __vcpu_put_switch_syregs(). Prototype was for __vcpu_put_switch_sysregs() instead Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/hyp/vhe/sysreg-sr.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm64/kvm/hyp/vhe/sysreg-sr.c b/arch/arm64/kvm/hyp/vhe/sysreg-sr.c --- a/arch/arm64/kvm/hyp/vhe/sysreg-sr.c +++ b/arch/arm64/kvm/hyp/vhe/sysreg-sr.c @@ -95,7 +95,7 @@ void __vcpu_load_switch_sysregs(struct k } /** - * __vcpu_put_switch_syregs - Restore host system registers to the physical CPU + * __vcpu_put_switch_sysregs - Restore host system registers to the physical CPU * * @vcpu: The VCPU pointer * From patchwork Wed Jan 17 23:07:09 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188974 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp38880dyb; Wed, 17 Jan 2024 16:25:51 -0800 (PST) X-Google-Smtp-Source: AGHT+IGa89qo+p8BHSeWEuDcplTrq/VdSgRpW7W8mApXqaxqLvXgULfub4xHbdWzuyqN4mvdSn+h X-Received: by 2002:a05:6808:448d:b0:3bc:3cc3:a99b with SMTP id eq13-20020a056808448d00b003bc3cc3a99bmr121354oib.8.1705537551206; Wed, 17 Jan 2024 16:25:51 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705537551; cv=pass; d=google.com; s=arc-20160816; b=H6WHy/eFdkRnDKlPdXzv3wpariuSW8G1cx76RVMNSDtOGP8H191VFzAFDOtFujTBX3 m19gO0qIu/qjr2+A32+Dm6Ef+JHXUZwlTZfGQl0HCCb8Li0BFo9QL2WmRl4LHfeo4b1f xxgo6DB7r6pdW5Jb2I16tnCPvA2Z0mz5v4h3DMvtI8LsGeNK0V7zEOPGJ6feEKGsLDft iMFUIWB4DgdFDC2QZO61ZGMwMtRn/NQQmK6YvsnhTxu7DDkNefqKcu1XnNDK1Ki+SDNa KomMsKq1w5uwEdQ32Q4GIpYIL3YJOmywu0si3BxZNIESlqmoWgZ12HjGWQYr2lto5HpA SjBw== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=rf9WG8QoK+Em5J0jsQlsXY6tjkvOuZcYJxM/46Zr9do=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=Ru69LGXoogpXOL5/8NvGgWXJjTPbsN91eHuZmo2bMZ0LhmiqgAdOZITzCJHCftN44K p2UUylgPl550pPbKPAAKMQGy9/XypzzgGRb+xQeaGtGdPjGcJeTZ7n5mz9EhXe9M37wF os7d0TDygJW3XFXnnc7NqjphZKMCWP0e3y3KhLKqSE5PeKNquCFvcKiPnus9mtglpCCO M8MU2WCqZkD+eigjQcEW0jwfISbRR2n7xv/WtVNlZ6+yaQqVSSUo2gU5wHXnqa6R85E8 5fDa120hxuNGvpaPPYukq5ejGRasn/SoTQxesOGCViridjzf0SyuWByacv5b27feaZzx QVaw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=KxkaUt4P; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29538-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29538-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id l14-20020a05622a050e00b00429d470ea36si9886554qtx.592.2024.01.17.16.25.51 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 16:25:51 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29538-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=KxkaUt4P; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29538-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29538-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 ny.mirrors.kernel.org (Postfix) with ESMTPS id 31DD01C2500A for ; Wed, 17 Jan 2024 23:08:47 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 476DD2C6B1; Wed, 17 Jan 2024 23:07:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="KxkaUt4P" 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 4618A24B25; Wed, 17 Jan 2024 23:07:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; cv=none; b=NJ51rsf89Sn71d27x6I4GBsUKwyaDteiw2qTXupsXeKw9DUHelNRir3KEEzVXmNd4uu62nB6vetqfLbzlXe8mW4fucCVRN8TxfYY7Q1K5TFFLKG6Ao7nnQQnNduwkhgm002kaMhfeiunVAZ8Oko+4hHYJfNQ9fQMlnRGsP379Cw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; c=relaxed/simple; bh=+6nIeOFxhPy+roORj2aw1phO7CMig6PwRogWUATtFQs=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=DiKDIJunhydp4+j4VOMHjryK1mOP1S96WUGEIbsmcotm1u+XgwHKxqIEAJ+cNGcM27RifbFm/81WtqKB8ONSIctG2HtVrbO3BV2aKbi16kt06a/sb969jFZii30ckyiPnRE+EBJ1YY02U4AZjVph1yKoUTKwgPlfL4sizqKc1RM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=KxkaUt4P; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=rf9WG8QoK+Em5J0jsQlsXY6tjkvOuZcYJxM/46Zr9do=; b=KxkaUt4PI8Mca+F7Kp2LvXFHOr gtPmoYFkMinRaue70E8zThkunG5etxWpKM8R0oeW4vwqKhDWwYtpWE7R4FTYN+FeNSS3e9WbNCN5h na5rG1e5Dzja9o3seH+r28SicPs8xCGkdf2ydmNmSEKBxpwzYXe3dKA7NAVk40kXu5aq7BXX/SM9D e1TcIMn94LOtvKMj9N7W00HDCJgcz+WzwSVDB5+nJheKbjcW5b49VABjQxHBf2eWtZmhW+ozxpacB t0Uwdq62LjsCMLp6dSPTCp98mEHAkSkCjNA2jl7aq1X6UcKBsq++LmXvJCMyNJWWXvwwpCIuEqBVA CFPVnSbg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0B-0011su-1T; Wed, 17 Jan 2024 23:07:19 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 05/10] KVM: arm64: mmu: fix a kernel-doc warning Date: Wed, 17 Jan 2024 15:07:09 -0800 Message-ID: <20240117230714.31025-6-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788385742939355473 X-GMAIL-MSGID: 1788385742939355473 Use the correct function name in a kernel-doc comment to prevent a warning: arch/arm64/kvm/mmu.c:321: warning: expecting prototype for unmap_stage2_range(). Prototype was for __unmap_stage2_range() instead Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/mmu.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm64/kvm/mmu.c b/arch/arm64/kvm/mmu.c --- a/arch/arm64/kvm/mmu.c +++ b/arch/arm64/kvm/mmu.c @@ -305,7 +305,7 @@ static void invalidate_icache_guest_page * does. */ /** - * unmap_stage2_range -- Clear stage2 page table entries to unmap a range + * __unmap_stage2_range -- Clear stage2 page table entries to unmap a range * @mmu: The KVM stage-2 MMU pointer * @start: The intermediate physical base address of the range to unmap * @size: The size of the area to unmap From patchwork Wed Jan 17 23:07:10 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188999 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp118081dyb; Wed, 17 Jan 2024 20:16:18 -0800 (PST) X-Google-Smtp-Source: AGHT+IEYr50r3gmciNvBJtD100bld3C/xjdbLofD/boFppBSgsupzEFQAQkyTdwilXNMtL5LGVQt X-Received: by 2002:a2e:9690:0:b0:2cd:d1:9032 with SMTP id q16-20020a2e9690000000b002cd00d19032mr138525lji.23.1705551378371; Wed, 17 Jan 2024 20:16:18 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705551378; cv=pass; d=google.com; s=arc-20160816; b=fg5ba/HkB4fK3SsP8QkNL05K+v49f4HUVaSTTK24/0UuFRTk4VWvJajDVlo/UytO8l GR10tLwhB3y6VOFMl5kfh60PQkh7ky3JpGxMCFciZXXTKG8iT1ZnKhTeLY5UdpCRb0nS nhu1f6rji5Xtl1nDD1rJO5/Yo2/HLA9+jDXzxzdUfqYm2fRZUwYh9BEyHpK3NjbN0rnW 5+lK9hxc4e8qUV7w37rhvfC23u33S3GA7jXSJwIfOFeIWqXYssTfdeTv3gmnctB9+1Gn 6nVNg4jXNO34PRyuOt6Ml26es2l7J8Z8alw4HzL1PsIfZ5EGvyd9O/DdpPQw0g6PJBBp ST6w== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=cMT/514E7BqW1l00hy1a7ZbFa058U0qT/SeW8KWVYfY=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=uaO++XduOhxTaddYyQqPIJCy+DGvkF9Jaoywh4EiWN+07ypRlz31jm+BHx6SBlEmBZ EOAd0uSvmJP/q2t/4svqjVnXp5PeAPpZXbylzQvxIESrmrqhoC5oOJuit3l+d9PQolLI JSC8CakaHzGIto82jU4cgEk1LG56FKd6ic+GtL4FwATftoyODi5RwjcP2JURleiKbPBE eEeSX9hqUZx4VFzqtDPHVdHkA9wpxu0kB9ngvNpx8NkCG3wfNwVLVCt3guwGFBlZYQ5Z 0JC8P05d5TLlayXWXukOf+c2LFdWnLGWMvgf6Ba17LHIRtLBced7V5zDkJ7PZsBEbhr8 LnJw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=vUICiNvY; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29539-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29539-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id et15-20020a056402378f00b00559da7da1e4si1265818edb.666.2024.01.17.20.16.18 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 20:16:18 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29539-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=vUICiNvY; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29539-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29539-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 am.mirrors.kernel.org (Postfix) with ESMTPS id 38B901F291A4 for ; Wed, 17 Jan 2024 23:09:42 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 386AE2D04A; Wed, 17 Jan 2024 23:07:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="vUICiNvY" 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 8327725620; Wed, 17 Jan 2024 23:07:20 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; cv=none; b=nWN7/aN8xWpoZtJxVs0W5I612Y7Z10nanoac9kn843RdJaVEOe/ok5g1Gej1F1kjcpLuXFPzKDqjeKyr1vLPb+RDZyThkqFPvJPNYbXJYIvw0FNwRHw8L70znRLOITnZlJvb0zyu903rwB8hWkPdNsJu1B8z48tJP2S8a+BtFHU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532841; c=relaxed/simple; bh=c7veDcJwfWEy2ceKhYMeTOZaPgtM+ubfAmWRTM5uF/g=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=JNwcbWeCpoiOU5AouKM9hnI3kN0D5SBjcc6oOECQ1gRVX5mTvnVV72eQcPyu5r4xE+oOYGVMdvM4CiZNA9WnuFoo6yO8caEJ334l7FFIujvp3L4CFKMsFybPnaSs0a0IRqNKgA+qnpP+mgUAmoFKyX7b6bshabVGpo4aHd8bmmU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=vUICiNvY; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=cMT/514E7BqW1l00hy1a7ZbFa058U0qT/SeW8KWVYfY=; b=vUICiNvYk2UTbA5YYdaPLFh/iq fwqIKZm8DRYR4XQTzieARAlxkfsfUd84g7qpVHdkHFWdWPN6vJYjE6zTqhFeTt8fA8ezY5FzWfvey NpTjwquz/xkpsDTLnnmevlTPT4yS2cCIQHFRc2WvaRunwRO9AJ9w+6zTuDautMr/r8fQFe5weS1AN PfSOgNW7AfMIv4XQqjKblU/8+XQ6xEAI3V2P6JPmL/xv/CYpnBxt1CF/AUrppWFI8tfk9IoN5MnoW IcoRyB/eRktNPZl0Ij9Ij8qm3k4X2xnYUQd1oxdYUpkzbsr3pTElJigz8V+evp4Uk2jZ+7jd0+bja 9zP+FKag==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0B-0011su-2b; Wed, 17 Jan 2024 23:07:19 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 06/10] KVM: arm64: PMU: fix kernel-doc warnings Date: Wed, 17 Jan 2024 15:07:10 -0800 Message-ID: <20240117230714.31025-7-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788400242174732054 X-GMAIL-MSGID: 1788400242174732054 Change 2 uses of "/**" on non-kernel-doc comments to common "/*" comments to prevent kernel-doc warnings: arch/arm64/kvm/pmu-emul.c:423: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * When perf interrupt is an NMI, we cannot safely notify the vcpu corresponding arch/arm64/kvm/pmu-emul.c:494: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * When the perf event overflows, set the overflow status and inform the vcpu. Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/pmu-emul.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff -- a/arch/arm64/kvm/pmu-emul.c b/arch/arm64/kvm/pmu-emul.c --- a/arch/arm64/kvm/pmu-emul.c +++ b/arch/arm64/kvm/pmu-emul.c @@ -419,7 +419,7 @@ void kvm_pmu_sync_hwstate(struct kvm_vcp kvm_pmu_update_state(vcpu); } -/** +/* * When perf interrupt is an NMI, we cannot safely notify the vcpu corresponding * to the event. * This is why we need a callback to do it once outside of the NMI context. @@ -490,7 +490,7 @@ static u64 compute_period(struct kvm_pmc return val; } -/** +/* * When the perf event overflows, set the overflow status and inform the vcpu. */ static void kvm_pmu_perf_overflow(struct perf_event *perf_event, From patchwork Wed Jan 17 23:07:11 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188973 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp34977dyb; Wed, 17 Jan 2024 16:16:15 -0800 (PST) X-Google-Smtp-Source: AGHT+IE44DwxzAPNdUvLMVIfSsRfAU+8hZnT3CFycknVTKLuPoB8KOlItUg8MKllAdh1jZRuHeLd X-Received: by 2002:a17:902:7d87:b0:1d4:75c8:6d2d with SMTP id a7-20020a1709027d8700b001d475c86d2dmr102942plm.49.1705536975117; Wed, 17 Jan 2024 16:16:15 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705536975; cv=pass; d=google.com; s=arc-20160816; b=tC99ec+v7kYOTuEgH2Ig7DmR8LzDA4MQXQPCjsF4Ves9/OSm93LOwbc8WsFali6YTz 0GQkKN05dQBgIF5QN2275WILo7au8Qc+zThs4sAk0Y9HSgVOq+f8lYeYGcMrv8Z2DKS4 5ecmGMyr/j1g1yJRSy2v4przHHsYMEnajL1lSs+22bm2tr6zVrJ1cL4cQGuVnqrPwSRa P43w1Hmm0GWhjjgDPHb9cvVEJdoWjXGlXTJTS2sTF4aJ6qhQMSz0srcDhzuZvIyLmypf Mu8RiFdX+Rb8wyAFsfBcG52v/kx2SwM/8e3WG45A3HXtynZ5hmJrprteQao2gjaHN8yD cqUg== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=iT44W7v/FtTigM/DN0Ec+D1xmeouh8V4OkR9aPPtQ1Q=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=0IyMsIgFn99n4CurMel/3zANLBBIh+5MQ8+YgTjIh45vKcLVxHGjy4uHMko9pqI8dw 4QtJIYQoY0CSwYwoC934fL+MIJTgoDyt7ZcVV9e6fKDocYncgHMqzVeqvumhDBcehUBY NRgWce7Om4RtuzZ8o+II6S/BjmEEndfFSKNt7RythftXuvaZC7sAox/3Dx0rVCNml669 UmLHp1oaMDU2eZkwQXYjI4Ro6+uRU0w1By6+AAe6WhK3c9agL9dJXaFg1xwXtzCvkQsN q2/60kLUKXBaOgvIK0MnnGLZAgaavvcvmEQ2/L4DiHGvKxbUt368wm/GAR7MRteoQjaV /NZA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=dweo1j75; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29540-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29540-ouuuleilei=gmail.com@vger.kernel.org" Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id k17-20020a170902c41100b001d5e414e1d6si447820plk.482.2024.01.17.16.16.15 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 16:16:15 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29540-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=dweo1j75; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29540-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29540-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 867D728CCF8 for ; Wed, 17 Jan 2024 23:09:39 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 2A9DB2D047; Wed, 17 Jan 2024 23:07:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="dweo1j75" 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 C3C2128694; Wed, 17 Jan 2024 23:07:20 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532842; cv=none; b=OLYR/S3UI1TCnld9PamillUyDDKa7P+wRp2hLNoyzYC0sppKv+Y5dN/MqQGlnCD/YO0KvRnR7zeVOKQYuZbid/QX7x4Llt66fXrD2u8DVHQ1JiKbDyXh5UfH3jEl5WmBWv9igjY55fDnlwxQBy6Hh+AJyaEEbqn1dZJvzsi+iDc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532842; c=relaxed/simple; bh=bskHYMIoZ8Px7JZI6eA5NMkXx5ScjCITwfg7FUAEcBo=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=HeI3zShOMBgPhYYJcyQmMDfZgHKcfnAJBh12k5KGpoRnu1Zmz5xSOJU6Jworq6XAzbMU7dQ7LiTzKDTXh8FPADijmeSqowaVhci/zlovvwqAReFsNARNp8fz5QlgULFGdfKKOxnwlGFX4gSErGB9HE+jOABIDKwOWZ0d47w9mrk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=dweo1j75; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=iT44W7v/FtTigM/DN0Ec+D1xmeouh8V4OkR9aPPtQ1Q=; b=dweo1j75EEMJ4/8gKndu/Cjl68 7+AwoVbFi0N6WulHFli8LlsqC2vLbjeGU6T1lf2dx51cIyJ0C8gVHKCgiz8ShpiH0T6lYdtoX5jyT 1u2PndgOL/HBnp4xvDDlfQEJKM1tey/n3HSqOyIfwRCXgW2HFUqSp1JkJZIuTuFrnRXgsqZHA0LBK pRWQm6YPMa0Z+v2GUvl3HotindYPuh5Bg1IThp0/zckBYy7/k2YhnN20uYB8HYtpOrvEq+ZSAgDL1 CvDqHOu+9mnU/rOKLkv7Ag07kjCjAnOaoWuchujMlQik2F1O6PBLcnK0wQvHo45z8u/von5umO1NG Wpv1hScg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0C-0011su-0Z; Wed, 17 Jan 2024 23:07:20 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 07/10] KVM: arm64: sys_regs: fix kernel-doc warnings Date: Wed, 17 Jan 2024 15:07:11 -0800 Message-ID: <20240117230714.31025-8-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788385139257503774 X-GMAIL-MSGID: 1788385139257503774 Drop the @run function parameter descriptions and add the actual ones for 2 functions to prevent kernel-doc warnings: arch/arm64/kvm/sys_regs.c:3167: warning: Excess function parameter 'run' description in 'kvm_handle_cp_64' arch/arm64/kvm/sys_regs.c:3335: warning: Excess function parameter 'run' description in 'kvm_handle_cp_32' Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/sys_regs.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff -- a/arch/arm64/kvm/sys_regs.c b/arch/arm64/kvm/sys_regs.c --- a/arch/arm64/kvm/sys_regs.c +++ b/arch/arm64/kvm/sys_regs.c @@ -3159,7 +3159,8 @@ static void unhandled_cp_access(struct k /** * kvm_handle_cp_64 -- handles a mrrc/mcrr trap on a guest CP14/CP15 access * @vcpu: The VCPU pointer - * @run: The kvm_run struct + * @global: &struct sys_reg_desc + * @nr_global: size of the @global array */ static int kvm_handle_cp_64(struct kvm_vcpu *vcpu, const struct sys_reg_desc *global, @@ -3326,7 +3327,9 @@ static int kvm_emulate_cp15_id_reg(struc /** * kvm_handle_cp_32 -- handles a mrc/mcr trap on a guest CP14/CP15 access * @vcpu: The VCPU pointer - * @run: The kvm_run struct + * @params: &struct sys_reg_params + * @global: &struct sys_reg_desc + * @nr_global: size of the @global array */ static int kvm_handle_cp_32(struct kvm_vcpu *vcpu, struct sys_reg_params *params, From patchwork Wed Jan 17 23:07:12 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188998 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp118050dyb; Wed, 17 Jan 2024 20:16:13 -0800 (PST) X-Google-Smtp-Source: AGHT+IHlFYqyWVUiUVlwCjqz41GFLIF7O6tVzZ2q2U9qfVE8bBGjK92VMfBa15DabQyv5cYBbdn+ X-Received: by 2002:a17:906:d8aa:b0:a28:ff59:12ee with SMTP id qc10-20020a170906d8aa00b00a28ff5912eemr98149ejb.5.1705551373325; Wed, 17 Jan 2024 20:16:13 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705551373; cv=pass; d=google.com; s=arc-20160816; b=aKxQ71rguMlqsxE6lkyOC5q6ebyCwfbwtIBnMa4RdkC1mU2Ompdjo9i8TEwXnx5vxP J6Q4UxCsBE9BJvIedGncCnZCB+dD7oMq7EmgeNcHSjVQ8LLDOMW+Q/h+NYN4Q6UiBmjL fSAAz2lIFxsbOJiYCHlwtn5IX/cqHqH8XkX5acirT4mm7TYjROzKvUd3mFCe7HDbHQnW srznjHh1PN22R0RSAH3Wc2derqBPlNOmhcFW+Weu00cGJJgDYt+cvhJiduFFV3OkbPVi V5ZO3/rvpYjCiPFUgNRk8Qfbx0EmhTseWOEb+g8XCCP7QlZdceC7P+n3QoN/DzfeqItT DyWQ== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=KBv72L9EWa6OscyWF0/gK01Q4M4/AoY4DRCGn5aUvKI=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=OOWhOhqonSNPH+qDTNMbBT6V6dNwhzpYFhquWc23Ji7RCP4rWJpVIQS6KryZNNsSr2 VLUyZx43K57Xe9ilvQWfiYDEE4KrJWGcuZnvnl25O4IF/pjWSaTo2F5aHK3NVNtmckv2 BgIA2VYdgi02/EAQ6WJczVm+2UxJXIf0a8bhO3weGSmEXJXPuZG0vCdi+IuhowiUjAu+ HvP+r4866fL6jDrqcGuaJEEVn5f72KFLT3YXlVCAThcCrnEUUVr2/RoMuYWbKdSaMQ/v YF34eKdauLuhA1F6uX+meZ9jTcqjbKAtNFDMNS8PNKJYDeZhSta2oDx1p/L6S1cSahv2 7AGQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Pkx2RUf0; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29542-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29542-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id gt6-20020a170906f20600b00a2a40a6df47si6258779ejb.133.2024.01.17.20.16.13 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 20:16:13 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29542-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Pkx2RUf0; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29542-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29542-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 am.mirrors.kernel.org (Postfix) with ESMTPS id 5D9BD1F291C6 for ; Wed, 17 Jan 2024 23:09:43 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 4485C2D04C; Wed, 17 Jan 2024 23:07:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="Pkx2RUf0" 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 7193328DA5; Wed, 17 Jan 2024 23:07:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532842; cv=none; b=GF1krz7bgGSzML+Jwtlxgdg8JCfr+rRTJmVUteZ/3V0LtAf4uUzWf/kFcpMpGnc/wLK4pZpNS0Z0uZ7OZucFVm0o5QXCKGeWIqBE7rmh4XVFIXu/3JqErt7B7eMCcC6pAe5/4LK9jtq5Nv6+1xxL1HN6zw11/a8lvB87JXHbmxc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532842; c=relaxed/simple; bh=TySm173rxyhAdotDK7EIJbVdusDgJzeysg/S3YPerVA=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=QHPMyPIF93uBcwW/KjvUtzSWT1NfXweur4Ry1FYBwoXePtSRdpR2TcnpgWJ69KNbdJs7BzJoIO/HVcFST2QSovc8YXv+p9Szb2nz/Oy4h/RJiYwHhpE/bCI2yE87fKADv0F8NboD2sjtXOzCuzH0HxBNYMOwyKDLmNgZIkZZsjY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=Pkx2RUf0; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=KBv72L9EWa6OscyWF0/gK01Q4M4/AoY4DRCGn5aUvKI=; b=Pkx2RUf0B6Jagv6qaghzuJ1vRL 8jw3ipu/hjZFqdfp5mFtDV2kbQreAwBbsozigWmFC+vY/C5VlLNcwA7agEwO/3uWhCcXYFVkAlXpg wW2bZL49WzxHGWY1ZJMH/Ba40qMyDKjpaSqGayHQz2WdBBvg7sJ+YW6OEuNu6CnDHh+MfOR3XXOfk E9D4IWUcf9N1+83a/8s/BeArV34JPQpHTHTwH3UWuJCgWDtYJbX7mdQrpGSE+DrTs3Wvwuxo3IONL 90KfUG0HkQkrBA1DupXQFb766moo5Hn8R0sl4/ipzDQC5sGXkFGq6ApAiFy4rGfDld6JbQJ88AtA7 msZ++Ddg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0C-0011su-1m; Wed, 17 Jan 2024 23:07:20 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 08/10] KVM: arm64: vgic-init: fix a kernel-doc warning Date: Wed, 17 Jan 2024 15:07:12 -0800 Message-ID: <20240117230714.31025-9-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788400237070594953 X-GMAIL-MSGID: 1788400237070594953 Change the function comment block to kernel-doc format to prevent a kernel-doc warning: arch/arm64/kvm/vgic/vgic-init.c:448: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Map the MMIO regions depending on the VGIC model exposed to the guest Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/vgic/vgic-init.c | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff -- a/arch/arm64/kvm/vgic/vgic-init.c b/arch/arm64/kvm/vgic/vgic-init.c --- a/arch/arm64/kvm/vgic/vgic-init.c +++ b/arch/arm64/kvm/vgic/vgic-init.c @@ -445,13 +445,15 @@ int vgic_lazy_init(struct kvm *kvm) /* RESOURCE MAPPING */ /** + * kvm_vgic_map_resources - map the MMIO regions + * @kvm: kvm struct pointer + * * Map the MMIO regions depending on the VGIC model exposed to the guest * called on the first VCPU run. * Also map the virtual CPU interface into the VM. * v2 calls vgic_init() if not already done. * v3 and derivatives return an error if the VGIC is not initialized. * vgic_ready() returns true if this function has succeeded. - * @kvm: kvm struct pointer */ int kvm_vgic_map_resources(struct kvm *kvm) { From patchwork Wed Jan 17 23:07:13 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 189002 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp132958dyb; Wed, 17 Jan 2024 21:06:06 -0800 (PST) X-Google-Smtp-Source: AGHT+IFQChuEfXODrrXWqevf37kXAf6weGCIF7kjOmvGRCCeXnnq/AmUzKQrO8bWIEV6dy4k5QDo X-Received: by 2002:a17:906:3acc:b0:a29:445f:a1 with SMTP id z12-20020a1709063acc00b00a29445f00a1mr117144ejd.140.1705554366738; Wed, 17 Jan 2024 21:06:06 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705554366; cv=pass; d=google.com; s=arc-20160816; b=EVG9figgp2TL/grubcYqQECfSPyvOjkLFH9PrmelCHbp4pNh3vzAswzQ7dpWEW6roo wB70SxyTD22pGTveSIo4usE90oHEJnYA2SOyPwlmbVMlXxzNOwNI2r4iuwATX7Y/Dhhp WY+TC3uvS/cp7jtwQK9dCjoHG93LsUbK1NTn+n1asqtVSiPha/o8PjpDOrWsSI10sAIJ 6gYlTYeFo69DhkDgRBTt/RBbUssJAMgKh21Vl0c/5ehUv5pgdqKxOaXqEnJSQfQeJ15j mp5oyW69OxdN5LV5EGhWyzPmjngpG0rJwX68HFMBFrQON6aamiEPy3fkvmwBWVFPtyU+ fbJA== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=l0w1dsym1D/QG/0mtlqKSd3j1TQngBvbzezDyJnZL68=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=zUiJL8ERMMB1w8ZyytPGqwTt9lWIEtmkk/7I2DNcFhf0j4hRgA+GuFyCVC+IsMlvhj LmtCJeFBGcoLnvZ7woMC3IgpP2pUnvgb0seXDPQ4MuvbElwIiVi2Hrhv5N5L+DGwW7bt lQHs2GUIU+dJ0YrDjp+CfuXWj2LxWQXiJ6QZ0MJ0jSYPf3NZ4oZbBsZWeVpFJQrwv1Sg Es1+UGuNBTe7/HWC9To7Kx0om0pW4L1EToSc9wl3KIw1X+DtNWH9o5HnmHuU7rpnTqq0 0y8v3stsatlu4gQhYeHDfEtk0JULM0Os1pa877PZFSVoI0KfJqqUudGnk3e3X14K42l+ UiKQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=N1jpdSJ7; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29543-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29543-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id y20-20020a1709060a9400b00a298b6c03efsi6337103ejf.238.2024.01.17.21.06.06 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 21:06:06 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29543-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=N1jpdSJ7; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29543-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29543-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 am.mirrors.kernel.org (Postfix) with ESMTPS id 155E31F294EE for ; Wed, 17 Jan 2024 23:09:59 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 06F8B2D616; Wed, 17 Jan 2024 23:07:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="N1jpdSJ7" 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 D454428DC0; Wed, 17 Jan 2024 23:07:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532843; cv=none; b=WkBKy1wDPk43lZ7XeQYxdg1WdH7CWjCZomjAhjXyoriuXGTqwHPcNTQcSszATDv2G/IozAv/HAQRvq+IlSNUf7sBCiiNR5E7il6WJXkjlQ0TqiWtuOb7v39R2wpZmDJmZ4nrtqo+8Rph3qZx+ZQOKShb/qwLZAPfOloto7ss9Fk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532843; c=relaxed/simple; bh=DdymCnLkI27rGLQLx/CbSqqG9VBvyCiclIx2NAPLf98=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=UEvItUAPJdAFyBrsRuxVebjT6lBMp9XQtXmSIQ2h9B5ubBJM4VnJAPDVLJj0+9sFfVq6yxibSwStt6X5QRtlMjfOYDjzesDusp6PYfbABxZpSYlASnYgzu0KxLd1/EVNgR0nDFAHjYbpfc/5Ymc/Qtc+0XO1oRKu9KgjgJ3aXFk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=N1jpdSJ7; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=l0w1dsym1D/QG/0mtlqKSd3j1TQngBvbzezDyJnZL68=; b=N1jpdSJ7XNunvOhxbX1M1L2rJ5 5BkibONmiWR8b3469QCpJWp1VTg1C/4hJL9oYL5qrV8jaCJRvkp4gMbVmb8EfrB4oGsbOn7r2g/Ce sD6oPLKpJkTdyq/pmi+z6FedH5GNDjr952hWAmHX+XlY4cDcCDZoCl/mJ3wDGpsaUdc+OQU4TMbQM cKauxSRRKsPiHyb1a/DWfLFaVW+5smRb9ylQK6FJ2GE+qm1ec5hwBIAvS+wVxuO4Cyv+36+qMGusH gINFg2tPJ89ogG4wu8Oai/iIxDImrx/H9wvqpeWTYewYBomCyxsSvzw9S/lLpq/Zz05r2sTL+Hv3+ xI+U/F+w==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0C-0011su-38; Wed, 17 Jan 2024 23:07:21 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 09/10] KVM: arm64: vgic-its: fix kernel-doc warnings Date: Wed, 17 Jan 2024 15:07:13 -0800 Message-ID: <20240117230714.31025-10-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788403375406066176 X-GMAIL-MSGID: 1788403375406066176 Correct the function parameter name "@save tables" -> "@save_tables". Use the "typedef" keyword in the kernel-doc comment for a typedef. These changes prevent kernel-doc warnings: vgic/vgic-its.c:174: warning: Function parameter or struct member 'save_tables' not described in 'vgic_its_abi' arch/arm64/kvm/vgic/vgic-its.c:2152: warning: expecting prototype for entry_fn_t(). Prototype was for int() instead Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/vgic/vgic-its.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff -- a/arch/arm64/kvm/vgic/vgic-its.c b/arch/arm64/kvm/vgic/vgic-its.c --- a/arch/arm64/kvm/vgic/vgic-its.c +++ b/arch/arm64/kvm/vgic/vgic-its.c @@ -158,7 +158,7 @@ struct vgic_translation_cache_entry { * @cte_esz: collection table entry size * @dte_esz: device table entry size * @ite_esz: interrupt translation table entry size - * @save tables: save the ITS tables into guest RAM + * @save_tables: save the ITS tables into guest RAM * @restore_tables: restore the ITS internal structs from tables * stored in guest RAM * @commit: initialize the registers which expose the ABI settings, @@ -2139,7 +2139,7 @@ static u32 compute_next_eventid_offset(s } /** - * entry_fn_t - Callback called on a table entry restore path + * typedef entry_fn_t - Callback called on a table entry restore path * @its: its handle * @id: id of the entry * @entry: pointer to the entry From patchwork Wed Jan 17 23:07:14 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188996 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp111473dyb; Wed, 17 Jan 2024 19:56:04 -0800 (PST) X-Google-Smtp-Source: AGHT+IFAVV0jLIEhYOivNXXJrWnTAJ45r80eMgwYpZA1lXHVYJOzIsgEuR5FyZOLiOywvT/2cLi+ X-Received: by 2002:a05:600c:3c8c:b0:40e:758a:96d5 with SMTP id bg12-20020a05600c3c8c00b0040e758a96d5mr98723wmb.167.1705550164607; Wed, 17 Jan 2024 19:56:04 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705550164; cv=pass; d=google.com; s=arc-20160816; b=0RUcabNqoDNITur0xVie0z+mts+sCrJNaRSS0b4Ouw3/Z7ZgAYAylrNde1SVdVTYjI nreHGOOmI7RDRYbRTjGWLtj46W2Nvwx2fIP2aB0RGokwELRC+B4xN977yydrN14Noe56 B5dW+yShrDCvhpciQl9eNVz/juWUvJDHtrZjV//3AfaRM1SK2uP8PgfaVDR8SnANJn73 W3HfpGMJ8aU5wEHlswzglYemyQymSNrQEhSTPk8TVq7AUCjoHmQbalQ6ezBQfY2rV6hN ICn/ZSJP4jbdWkoaNf2sQjarjLjcGPOjyPVbaVCLWZrVxmlGFSfbcnqLT7+rgvUSsbCY 0uuw== ARC-Message-Signature: i=2; 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=4z//f4SWii73rhmNB7IdhlI7RbSfenJTKTaX55Qhiuk=; fh=TuTJIK9Hfh8tZaYMtS0Npxgp4MlTi4TEneQ74odOfs4=; b=PlplnUlV7x4siJwt0HQt80COErje+Qmio7GiyciIh7gLeUpREtUqTNrcvgmWJy78sv YdbitEskBV2yP9w2bwbR4wDP3J5ONB/7hDYKio0G1YSkWx7q3f2RKUhl7i/fx1RxpvDr 9Y/4aksqpQe+td/k+zvfBQS2iEdZ0ZpsSFGYB2PVfzoVkGJNmcn3Ida3OPjOF/FCgLM6 SN/3FKPQDIX2HBcBX6O1H0cmzzPvPpdH5TU5hrsDMpTnCt/9a7mZbrwDiIWChN+7vKL8 FJwPO7OeXIAMOo0A798J+i8FsXc+EZ5x0/EO5DV1+a1Pjw1lbNRKrslDyAW50GgxtB72 Q8ZQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=q4imAu3N; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29544-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29544-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id fe12-20020a056402390c00b0055822976d9dsi6724987edb.26.2024.01.17.19.56.04 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 17 Jan 2024 19:56:04 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29544-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=q4imAu3N; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-29544-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29544-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 am.mirrors.kernel.org (Postfix) with ESMTPS id 8D4DD1F2944F for ; Wed, 17 Jan 2024 23:09:59 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 06FB82D618; Wed, 17 Jan 2024 23:07:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="q4imAu3N" 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 0AF9B28DCA; Wed, 17 Jan 2024 23:07:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532843; cv=none; b=CzsVwGPVordeU3IoHehIzl/IxHlrK3qyKofuudYaHGLf6Sxa6b9tFW+gme4GFuqolS4Y4hz9x7YfVTlFO35icMGV7srT4M4eWTiZnmewjee+DLEYqlBvYLIw/jiXDJy2cpK2QJYhf5Db+eLWt5FqLG2TIpl63d8W0TYKHTaEmQA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705532843; c=relaxed/simple; bh=RiiiCFCSg23bdODcmHVKYdCbg7Nx10zpVDFgao209n0=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=h4BxmEstxuH4CRy911oJawEPcPjXXuBPv0IZbUnUPWnlSJ1yB/o57GphPoVts9y7lxc8TcYvV+tPTv7VmzkofvW3jQFwMG6+AleVJa0tVaHY6zsLID1hhV3AMv42crIoddKVbqHFgSozdp0zb56AnnwGkYGD48fRY0v1vMPUxE8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=q4imAu3N; arc=none smtp.client-ip=198.137.202.133 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:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=4z//f4SWii73rhmNB7IdhlI7RbSfenJTKTaX55Qhiuk=; b=q4imAu3NSlhLHLEfxBINKlePAf EoW2oKIsUWSxyc0WEiV3W9N9j7vE9sGxXbVt+0UL5AxkvQcn5xvJ1Sy2R+LmuMJPgtuRd2qHPQ8kM p7/5G6sBOXCLfMXJdBQvKZCsjCm1RKQV5kmIm1TudfMVKpUFe41cBFQcIbxNJyu1ESZaxW/ojZ8cX RWntzG7KluBxBZzo06l7bhopvQIupwjEnw9iJV5CwPXAhuBCX5SrvDNgS0+ysKZE1vWN9tKdrvMQQ em/3TFg6TUbMnj6bxjvbKr5ezbAyzmOgO8X1/Q7nMLR5dTM5a0KD5uIWPMXqCkla/8NLDQjI9VUV4 rUXAR+FA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rQF0D-0011su-11; Wed, 17 Jan 2024 23:07:21 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Zenghui Yu , linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, Catalin Marinas , Will Deacon Subject: [PATCH 10/10] KVM: arm64: vgic: fix a kernel-doc warning Date: Wed, 17 Jan 2024 15:07:14 -0800 Message-ID: <20240117230714.31025-11-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117230714.31025-1-rdunlap@infradead.org> References: <20240117230714.31025-1-rdunlap@infradead.org> 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: 1788398969757245348 X-GMAIL-MSGID: 1788398969757245348 Use the correct function name in a kernel-doc comment to prevent a warning: arch/arm64/kvm/vgic/vgic.c:217: warning: expecting prototype for kvm_vgic_target_oracle(). Prototype was for vgic_target_oracle() instead Signed-off-by: Randy Dunlap Cc: Marc Zyngier Cc: Oliver Upton Cc: James Morse Cc: Suzuki K Poulose Cc: Zenghui Yu Cc: linux-arm-kernel@lists.infradead.org Cc: kvmarm@lists.linux.dev Cc: Catalin Marinas Cc: Will Deacon --- arch/arm64/kvm/vgic/vgic.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm64/kvm/vgic/vgic.c b/arch/arm64/kvm/vgic/vgic.c --- a/arch/arm64/kvm/vgic/vgic.c +++ b/arch/arm64/kvm/vgic/vgic.c @@ -203,7 +203,7 @@ void vgic_irq_set_phys_active(struct vgi } /** - * kvm_vgic_target_oracle - compute the target vcpu for an irq + * vgic_target_oracle - compute the target vcpu for an irq * * @irq: The irq to route. Must be already locked. *