From d4c3191b07c8a71b6add2ce3fba57373a3f7b8f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Fri, 21 Aug 2026 02:49:03 -0300
Subject: [PATCH] docs(rspconfig): describe one network value per BMC

Record that a node with more than one BMC is configured one BMC at a
time and that a comma separated value gives one setting per BMC, in
both the man page source and the checked-in text.
---
 .../guides/admin-guides/references/man1/rspconfig.1.rst    | 4 ++++
 xCAT-client/pods/man1/rspconfig.1.pod                      | 7 +++++++
 2 files changed, 11 insertions(+)

diff --git a/docs/source/guides/admin-guides/references/man1/rspconfig.1.rst b/docs/source/guides/admin-guides/references/man1/rspconfig.1.rst
index c77901a03..6a8b6b7f6 100644
--- a/docs/source/guides/admin-guides/references/man1/rspconfig.1.rst
+++ b/docs/source/guides/admin-guides/references/man1/rspconfig.1.rst
@@ -40,6 +40,8 @@ BMC specific:
 
 \ **rspconfig**\  \ *noderange*\  {\ **ip | netmask | gateway | backupgateway | garp | vlan**\ }
 
+\ **rspconfig**\  \ *noderange*\  {\ **ip | netmask | gateway**\ }=\ *value*\ [,\ *value*\ ...]
+
 \ **rspconfig**\  \ *noderange*\  \ **garp**\ =\ *time*\ 
 
 
@@ -313,6 +315,8 @@ DESCRIPTION
 
 For options \ **autopower | iocap | decfg | memdecfg | procdecfg | time | date | spdump | sysdump | network**\ , user need to use \ *chdef -t site enableASMI=yes*\  to enable ASMI first.
 
+A node whose \ **ipmi.bmc**\  attribute names more than one BMC is configured one BMC at a time, in the order the attribute lists them. Give one value per BMC, separated by commas, when a setting differs between them, for example \ *ip=10.1.1.1,10.1.1.2*\ . A single value is sent to every BMC of the node.
+
 
 *******
 OPTIONS
diff --git a/xCAT-client/pods/man1/rspconfig.1.pod b/xCAT-client/pods/man1/rspconfig.1.pod
index 412d1daeb..ac32107d1 100644
--- a/xCAT-client/pods/man1/rspconfig.1.pod
+++ b/xCAT-client/pods/man1/rspconfig.1.pod
@@ -20,6 +20,8 @@ B<rspconfig> I<noderange> B<community>={B<public> | I<string>}
 
 B<rspconfig> I<noderange> {B<ip>|B<netmask>|B<gateway>|B<backupgateway>|B<garp>|B<vlan>}
 
+B<rspconfig> I<noderange> {B<ip>|B<netmask>|B<gateway>}=I<value>[,I<value>...]
+
 B<rspconfig> I<noderange> B<garp>=I<time>
 
 =head2 OpenBMC specific:
@@ -266,6 +268,11 @@ B<rspconfig> configures various settings in the nodes' service processors.
 
 For options B<autopower>|B<iocap>|B<decfg>|B<memdecfg>|B<procdecfg>|B<time>|B<date>|B<spdump>|B<sysdump>|B<network>, user need to use I<chdef -t site enableASMI=yes> to enable ASMI first.
 
+A node whose B<ipmi.bmc> attribute names more than one BMC is configured one
+BMC at a time, in the order the attribute lists them. Give one value per BMC,
+separated by commas, when a setting differs between them, for example
+I<ip=10.1.1.1,10.1.1.2>. A single value is sent to every BMC of the node.
+
 =head1 OPTIONS
 
 =over 4