diff --git a/docs/formatnetwork.html.in b/docs/formatnetwork.html.in index b1b04859ba..c6969eb1a3 100644 --- a/docs/formatnetwork.html.in +++ b/docs/formatnetwork.html.in @@ -105,12 +105,15 @@
- The final set of elements define the IPv4 address range available, - and optionally enable DHCP sevices. + The final set of elements define the addresses (IPv4 and/or + IPv6, as well as MAC) to be assigned to the bridge device + associated with the virtual network, and optionally enable DHCP + services.
... + <mac address='00:16:3E:5D:C7:9E'/> <ip address="192.168.122.1" netmask="255.255.255.0"> <dhcp> <range start="192.168.122.100" end="192.168.122.254" /> @@ -121,6 +124,20 @@ </network>
mac
address
attribute defines a MAC
+ (hardware) address formatted as 6 groups of 2-digit
+ hexadecimal numbers, the groups separated by colons
+ (eg, "52:54:00:1C:DA:2F"
). This MAC address is
+ assigned to the bridge device when it is created. Generally
+ it is best to not specify a MAC address when creating a
+ network - in this case, if a defined MAC address is needed for
+ proper operation, libvirt will automatically generate a random
+ MAC address and save it in the config. Allowing libvirt to
+ generate the MAC address will assure that it is compatible
+ with the idiosyncrasies of the platform where libvirt is
+ running. Since 0.8.8
+ ip
address
attribute defines an IPv4 address in
dotted-decimal format, or an IPv6 address in standard
diff --git a/docs/schemas/network.rng b/docs/schemas/network.rng
index 4252f30f56..6d01b06082 100644
--- a/docs/schemas/network.rng
+++ b/docs/schemas/network.rng
@@ -50,6 +50,14 @@
+
+