[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH v7 11/12] doc/man: update description for nr_spis with eSPI


  • To: "xen-devel@xxxxxxxxxxxxxxxxxxxx" <xen-devel@xxxxxxxxxxxxxxxxxxxx>
  • From: Leonid Komarianskyi <Leonid_Komarianskyi@xxxxxxxx>
  • Date: Thu, 4 Sep 2025 20:01:49 +0000
  • Accept-language: en-US
  • Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=epam.com; dmarc=pass action=none header.from=epam.com; dkim=pass header.d=epam.com; arc=none
  • Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=ujJFLWmitcsII9Trys4sWi3B0EXAvym/os6h93KEm9U=; b=E1s5EPVmePhHDNAOsL+yIiFO09BrOp1g6q8XNIzBWAm2bkbBBWVbzlwwsoTgxn060Iw3jSbRK2kJ8aoyyTsWpcttvVs1MRvMVgrmwl7QytA6ZJA2D641MMnMDMVU8JVSSL8NM0mvUG7KjicCpZ7DAh4fzm1b3SyR7m9VChDEcQU2NqheyOn3VHM3xB/jFNCKYeLGoPbgXtjTDAwawFhOwIw2ZCWgrPH60hwAvKcC3Xo7sfzLFGyFJAiGcS1Ckpg9+GRXfZ2Bk+QKcPNKTMRHc9c+mb7mR1cpMNckhVsQAsicHo3n5M5qGsOc/bgJs6/KXeIfbX9o7p9TZoWXZnNZAQ==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=qQpxAiXhYi0FOL43BE/vyRI5vVaoTe9nD4O6LCqo855OiUoKpG770NozZ/pH7C5f1fHEAy3LnR7jKnmg+TiCgLv30YiFDkKxC/QgxQBlDFUmldgrPcg/UF/uHn6GJxYHWzflmze4lODosRuhCbMQE3sLif2eJLdmKjBbMKG9Nqh8NclHcl0iVkODEnm/yUN7bCJC1KOwF/SNrikOwRBH7AsLu97cbYkYDqGz793SlufxmmXXhUZznl1AQ9sw/FE8Cuump5Wy1tFQpbh0/IUm66jIVjqZItgoWmqL4o6TVn7RAvpF7QrJf/QfqpJED2tfWmoGXidCyDXdybUZyrFehA==
  • Authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=epam.com;
  • Cc: "olekstysh@xxxxxxxxx" <olekstysh@xxxxxxxxx>, Leonid Komarianskyi <Leonid_Komarianskyi@xxxxxxxx>, Anthony PERARD <anthony.perard@xxxxxxxxxx>
  • Delivery-date: Thu, 04 Sep 2025 20:11:13 +0000
  • List-id: Xen developer discussion <xen-devel.lists.xenproject.org>
  • Thread-index: AQHcHda/fAGGraP6Q0Ofqx0FuB+e7w==
  • Thread-topic: [PATCH v7 11/12] doc/man: update description for nr_spis with eSPI

Since eSPI support has been introduced, update the documentation with
the appropriate description.

Signed-off-by: Leonid Komarianskyi <leonid_komarianskyi@xxxxxxxx>

---
The discussion is ongoing and can be addressed in V5.
Clarification is needed from the maintainers.
Link:
- https://lore.kernel.org/xen-devel/87y0r4z717.fsf@xxxxxxxx/

Changes in V7:
- no changes

Changes in V6:
- no changes

Changes in V5:
- no changes

Changes in V4:
- introduced this patch
---
 docs/man/xl.cfg.5.pod.in | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/docs/man/xl.cfg.5.pod.in b/docs/man/xl.cfg.5.pod.in
index 5362fb0e9a..292ab10331 100644
--- a/docs/man/xl.cfg.5.pod.in
+++ b/docs/man/xl.cfg.5.pod.in
@@ -3072,11 +3072,14 @@ interval of colors (such as "0-4").
 =item B<nr_spis="NR_SPIS">
 
 An optional integer parameter specifying the number of SPIs (Shared
-Peripheral Interrupts) to allocate for the domain. Max is 960 SPIs. If
-the `nr_spis` parameter is not specified, the value calculated by the toolstack
-will be used for the domain. Otherwise, the value specified by the `nr_spis`
-parameter will be used. The number of SPIs should match the highest interrupt
-ID that will be assigned to the domain.
+Peripheral Interrupts) to allocate for the domain. Max is 960 for regular SPIs
+or 5088 for eSPIs (Extended SPIs). The eSPIs includes an additional 1024 SPIs
+from the eSPI range (4096 to 5119) if the hardware supports extended SPIs
+(GICv3.1+) and CONFIG_GICV3_ESPI is enabled. If the `nr_spis` parameter is not
+specified, the value calculated by the toolstack will be used for the domain.
+Otherwise, the value specified by the `nr_spis` parameter will be used. The
+number of SPIs should match the highest interrupt ID that will be assigned to
+the domain.
 
 =item B<trap_unmapped_accesses=BOOLEAN>
 
-- 
2.34.1



 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.