From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-alma10-1.taild15c8.ts.net [100.103.45.18]) (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 5897F3DDAF0; Thu, 20 Aug 2026 10:46:17 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=100.103.45.18 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787222778; cv=none; b=p8L5jHZP+NwkeH2GzTMoJtPZJOgdR/ZC9j1BLTr8+CKnFdELwN7u1hpcMIyqVT+OUHXwxD8mJg3sc3wQHl1d7BxkWlJGvcT+bhQ6JODWHZ+EcwgWgTe9EaQuCWYeEt0R6dsJvNdkRRywFMsoKJQjLTyT+OKTAvceyCtdO0xT+s4= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787222778; c=relaxed/simple; bh=dB4Sn+g5+8EXto3KTgmB6+U3sXk6A1AUH07jcEFRxwI=; h=Date:Message-ID:From:To:Cc:Subject:In-Reply-To:References: MIME-Version:Content-Type; b=Ws4qMfuRremIOAi1hv/a9806ZKWWIeQRFUtvfXwqyuRVIxpA7SOeoLDW9BeRxQp9AmjORQx+14DRnnPDxVI6J5V0FoK4Y+neLu77+UGHP+MUMIAgon8Q7HDvhgWk0V4zEQQlHiVbdk+U/UuMdvCL5G+2fzeXVbQqo8KN+qiZfm4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=UL1xMM+O; arc=none smtp.client-ip=100.103.45.18 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="UL1xMM+O" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 2464D1F000E9; Thu, 20 Aug 2026 10:46:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1787222777; bh=fGWPN53+LtuQxuiYMSRiXpBjH0T44ztBiCq6/Ef14To=; h=Date:From:To:Cc:Subject:In-Reply-To:References; b=UL1xMM+O7C1EUZ2FmctdeuCuuw05mogST/CcUm50lr1DQLSNj2ZmC8ph5CjpjJTkm brAFa3FBlRIC+CdZ5iTT30RjubMcFThNW7uICT+3VKdg+3E3lsO6oTLPbe58VJXCYf ifSLuoV+kIM+jwVymE9+U1V1PnghbcG8LYSw6asjE98vwhdPLG+U0rHrUTCgm8ae3R 85Z3vhuPsFUWiNibHfK5Ze5w5YfMIcY1uF07wOppayH/ipMUy4LZ+TPLfb3hmHB4+q l63vQZD0mi+za///e4tBH7fvPWeogEwOCarALfj8vN6vtITXTZmjA/WZgRgCc5BSb+ aM2mFrjcaJgWQ== Received: from sofa.misterjones.org ([185.219.108.64] helo=lobster-girl.misterjones.org) by disco-boy.misterjones.org with esmtpsa (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1wx0Hn-0000000HG2v-0Ngr; Thu, 20 Aug 2026 10:46:15 +0000 Date: Thu, 20 Aug 2026 11:48:46 +0100 Message-ID: <87zeyhnk35.wl-maz@kernel.org> From: Marc Zyngier To: Karl Mehltretter Cc: Oliver Upton , Sascha Bischoff , Paolo Bonzini , Jonathan Corbet , Shuah Khan , Jonathan Cameron , Timothy Hayes , kvmarm@lists.linux.dev, kvm@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] Documentation: KVM: Fix the GICv5 KVM_IRQ_LINE PPI range In-Reply-To: References: <20260815092537.31737-1-kmehltretter@gmail.com> <86wltrzm5n.wl-maz@kernel.org> User-Agent: Wanderlust/2.15.9 (Almost Unreal) SEMI-EPG/1.14.7 (Harue) FLIM-LB/1.14.9 (=?UTF-8?B?R29qxY0=?=) APEL-LB/10.8 EasyPG/1.0.0 Emacs/30.1 (aarch64-unknown-linux-gnu) MULE/6.0 (HANACHIRUSATO) Precedence: bulk X-Mailing-List: kvm@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue") Content-Type: text/plain; charset=US-ASCII X-SA-Exim-Connect-IP: 185.219.108.64 X-SA-Exim-Rcpt-To: kmehltretter@gmail.com, oupton@kernel.org, sascha.bischoff@arm.com, pbonzini@redhat.com, corbet@lwn.net, skhan@linuxfoundation.org, jic23@kernel.org, timothy.hayes@arm.com, kvmarm@lists.linux.dev, kvm@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org X-SA-Exim-Mail-From: maz@kernel.org X-SA-Exim-Scanned: No (on disco-boy.misterjones.org); SAEximRunCond expanded to false On Sat, 15 Aug 2026 14:07:38 +0100, Karl Mehltretter wrote: > > On Sat, Aug 15, 2026 at 11:57:24AM +0100, Marc Zyngier wrote: > > > + in-kernel GICv5: PPI, irq_id between 0 and 63 (incl.), and > > > > No. Please understand the difference between *implementation* and > > *architecture*. > > Got it. That distinction could perhaps be clearer in api.rst, but 0-127 > is intentional, not a missed doc update. This is on purpose. We are not going to go and update the documentation each time something change in KVM (such as a new interrupt being controllable from the VMM). So by describing everything in architectural terms and giving the interfaces for userspace to introspect the implementation, we avoid having to disclose all the decisions that we make when implementing the hypervisor. This is valid for the whole of KVM/arm64, not just the GIC, and represent the intent of the ARM architecture. Thanks, M. -- Jazz isn't dead. It just smells funny.