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

[PATCH v5 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: Fri, 29 Aug 2025 16:06:38 +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=GONSEj8/1mepKECBs7Vda7Viy+ul1d1/au4fjFSO9gg=; b=eVIlIk0AM0DcQ9gFDSo4N1KCGeXLX+Ng/tspQQlFeM0vgk0MPZ+xZ+NrDX57787M5gJrI7Ug2fIXUB2Z29eIn4RpZhYVZTOLh1EQQjkuzGt+1oTcH41+ToIvuoQluJ6JAY1n6ZsAq1itPI4oxkx+GTFlCMJMnboAbMdeNAyVVL5JceuHqjhM50Cw04o2V/qfXvibI3F3g36X/320Ke+Ioir98WEO3T4wx3H2WiqlLx7WFlrAfo8J3zU4ZvWJG/Rd572accbFjL4qzEfOQp9njRa8LxQrhe3uPmGfmsscaDuYmiVaXu55DagUjD4Ot8gtMIvnV6b8Rx1ox4cmr/zvFg==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=DC4T/Np5DHBSTQPp4yWpi4wuBsP9Eh/0QyaZROatPlgZhEeT55qhlPG7ketlYlfudcNT59tG5mB3br1PKQsTOJG0ekCRJucmJ1+R407HHSpn8KsxmGgRbyd4b1E6VlBwutvwyMO5eBoDnlAR5bIxrhQvUchioR1OBzDQ8f1Y2KHrY7n+2cUbegeXuUlpQBgO2OrM7Osqlm4wzAjYC1TDAXymbWumdYjzyp4q/2VEi9YMcl1ywz+HqE1Odgkd7f1BB5FaOaULaDi4Y1o3SaqHhq7yeiAYEw7Ft6+s/lqXn222aieZ7BRNzN45IiHMcDQjd1/nF3yxaUUkK+uEu6qxyg==
  • 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: Fri, 29 Aug 2025 16:10:55 +0000
  • List-id: Xen developer discussion <xen-devel.lists.xenproject.org>
  • Thread-index: AQHcGP7m6ftj+OqxyUm3COIAuPKuog==
  • Thread-topic: [PATCH v5 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 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®.