Commit bd61395a authored Apr 29, 2022 by Randy Dunlap Committed by Marc Zyngier May 06, 2022

KVM: arm64: nvhe: Eliminate kernel-doc warnings



Don't use begin-kernel-doc notation (/**) for comments that are not in
kernel-doc format.

This prevents these kernel-doc warnings:

arch/arm64/kvm/hyp/nvhe/switch.c:126: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 * Disable host events, enable guest events
arch/arm64/kvm/hyp/nvhe/switch.c:146: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 * Disable guest events, enable host events
arch/arm64/kvm/hyp/nvhe/switch.c:164: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 * Handler for protected VM restricted exceptions.
arch/arm64/kvm/hyp/nvhe/switch.c:176: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
 * Handler for protected VM MSR, MRS or System instruction execution in AArch64.
arch/arm64/kvm/hyp/nvhe/switch.c:196: warning: Function parameter or member 'vcpu' not described in 'kvm_handle_pvm_fpsimd'
arch/arm64/kvm/hyp/nvhe/switch.c:196: warning: Function parameter or member 'exit_code' not described in 'kvm_handle_pvm_fpsimd'
arch/arm64/kvm/hyp/nvhe/switch.c:196: warning: expecting prototype for Handler for protected floating(). Prototype was for kvm_handle_pvm_fpsimd() instead

Fixes: 09cf57eb ("KVM: arm64: Split hyp/switch.c to VHE/nVHE")
Fixes: 1423afcb ("KVM: arm64: Trap access to pVM restricted features")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reported-by: kernel test robot <lkp@intel.com>
Cc: Fuad Tabba <tabba@google.com>
Cc: Marc Zyngier <maz@kernel.org>
Cc: David Brazdil <dbrazdil@google.com>
Cc: James Morse <james.morse@arm.com>
Cc: Alexandru Elisei <alexandru.elisei@arm.com>
Cc: Suzuki K Poulose <suzuki.poulose@arm.com>
Cc: linux-arm-kernel@lists.infradead.org
Cc: kvmarm@lists.cs.columbia.edu
Signed-off-by: Marc Zyngier <maz@kernel.org>
Link: https://lore.kernel.org/r/20220430050123.2844-1-rdunlap@infradead.org

parent 7ee74cc7

arch/arm64/kvm/hyp/nvhe/switch.c

+4 −4

Original line number	Diff line number	Diff line
		@@ -120,7 +120,7 @@ static void __hyp_vgic_restore_state(struct kvm_vcpu *vcpu)
		}
		}

		/**
		/*
		* Disable host events, enable guest events
		*/
		static bool __pmu_switch_to_guest(struct kvm_cpu_context *host_ctxt)
		@@ -140,7 +140,7 @@ static bool __pmu_switch_to_guest(struct kvm_cpu_context *host_ctxt)
		return (pmu->events_host \|\| pmu->events_guest);
		}

		/**
		/*
		* Disable guest events, enable host events
		*/
		static void __pmu_switch_to_host(struct kvm_cpu_context *host_ctxt)
		@@ -158,7 +158,7 @@ static void __pmu_switch_to_host(struct kvm_cpu_context *host_ctxt)
		write_sysreg(pmu->events_host, pmcntenset_el0);
		}

		/**
		/*
		* Handler for protected VM MSR, MRS or System instruction execution in AArch64.
		*
		* Returns true if the hypervisor has handled the exit, and control should go
		@@ -175,7 +175,7 @@ static bool kvm_handle_pvm_sys64(struct kvm_vcpu vcpu, u64 exit_code)
		kvm_handle_pvm_sysreg(vcpu, exit_code));
		}

		/**
		/*
		* Handler for protected floating-point and Advanced SIMD accesses.
		*
		* Returns true if the hypervisor has handled the exit, and control should go