[PATCH v2] xenstore-paths: Specify ipvX/$INDEX/prefix

[Tu Dinh <ngoc-tu.dinh@xxxxxxxxxx>]

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>
---
 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
-- 
2.55.0



--
Ngoc Tu Dinh | Vates XCP-ng Developer

XCP-ng & Xen Orchestra - Vates solutions

web: https://vates.tech