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

[PATCH v6 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: Wed, 3 Sep 2025 14:30:22 +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=XyahV/BpOkGFxSqvav5Se24ucuKX8ic+JBea+qL3ihg=; b=kOmfXA347k4Hj1L/L1BrRxRnMd17+pRV3ofEBSVaoCh39HbtdBZfYQnFvbOlMbPZ5G+ORs3t6T6OGX0en7yD2fpgaRkjof1uTWBE11WmENjAX4cwl9GcTdW8dp8rbxZJxzvz7kpMklECrwD+7sWh+BTe2KoACnuySm9D0XvZ8OnW8evOcV4IHZP8JJP1E3w1TH0baUPN/MgyezGLBlQeWJHvLtUoXlBkwkowcOsKAOInj+2pqObIQYObp2n+fwm/AiY8g2WpDwvbIx8tF5K1NnH0XBQVXvHBSvhcP3xGACWNv92LTh+gq9V+Bcy0pOrifks38t6/sn0CgBc5l2Qw3A==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=EDApSG4SU7AcrJzS0jjZc4COVOUrs82CAJvL3o6Jkor+n9EEr+KOOtqdfnVipkaAIntDkA15SJeileGvmpzBA/xtvbra3fFovJgWMeC3sZdpykpOTcPvNMnwHJR9LdS2UTQR0Fmbj0efUvnoHDddszjOvNwGyxNGl8t8SOO3hEFljqDC53pbBc5hUgqmwOZAYYqCkSSt8Owolhmn+x5LLQIIGj65KHaQ9Q9VVZqFdUw0AkBXwqDa2W9fTOyw4vSvAYuPN5kzkD2O9yPwSfY3it9rG460ej56dDwf4mC1N77R2ssmLU1BA1gT15jNb4U0D7b9AqFt7ct+X+t/9RkoSQ==
  • 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: Wed, 03 Sep 2025 14:30:52 +0000
  • List-id: Xen developer discussion <xen-devel.lists.xenproject.org>
  • Thread-index: AQHcHN9HOJL8STXwX0GL+HONwVVLYw==
  • Thread-topic: [PATCH v6 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 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®.