[xen staging] xenstore-paths: Specify ipvX/$INDEX/prefix

[patchbot@xxxxxxx]

commit 644ea6f84510af27ee1847e981df945a94068479
Author:     Tu Dinh <ngoc-tu.dinh@xxxxxxxxxx>
AuthorDate: Thu Jul 23 10:20:45 2026 +0200
Commit:     Jan Beulich <jbeulich@xxxxxxxx>
CommitDate: Thu Jul 23 10:20:45 2026 +0200

    xenstore-paths: Specify ipvX/$INDEX/prefix
    
    In the guest-reported IP address in xenstore, it's useful to know which
    subnet it belongs to.
    
    Add a specification for a subkey of each IP address, containing that
    address's subnet prefix.
    
    Signed-off-by: Tu Dinh <ngoc-tu.dinh@xxxxxxxxxx>
    Reviewed-by: Juergen Gross <jgross@xxxxxxxx>
---
 docs/misc/xenstore-paths.pandoc | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/misc/xenstore-paths.pandoc b/docs/misc/xenstore-paths.pandoc
index 4994194e2b..b8b02e007a 100644
--- a/docs/misc/xenstore-paths.pandoc
+++ b/docs/misc/xenstore-paths.pandoc
@@ -564,6 +564,16 @@ address written in one of these paths to, for example, 
establish a VNC
 session to the guest (although clearly some level of trust is placed
 in the value supplied by the guest in this case).
 
+#### ~/attr/vif/$DEVID/ipv4/$INDEX/prefix = INTEGER [w]
+#### ~/attr/vif/$DEVID/ipv6/$INDEX/prefix = INTEGER [w]
+
+Paths of this form may be written by the guest to indicate the network
+prefix length of the IP address at the corresponding $INDEX.
+
+An IPv4 prefix value can be in the range of 0 to 32.
+
+An IPv6 prefix value can be in the range of 0 to 128.
+
 #### ~/error [w]
 
 A domain writable path used by some PV drivers to pass error messages
--
generated by git-patchbot for /home/xen/git/xen.git#staging