From f3a55c909224066e223bfc6f97a7d09c14ca8ea8 Mon Sep 17 00:00:00 2001
From: Alexander Schreiber <als@google.com>
Date: Fri, 28 Dec 2007 10:05:49 +0000
Subject: [PATCH] Document variable MAC support to gnt-instance.

Document the ability to set and change the MAC address for instances.

Reviewed-by: iustinp
---
 man/gnt-instance.sgml | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/man/gnt-instance.sgml b/man/gnt-instance.sgml
index c7ac8ef1b..748750255 100644
--- a/man/gnt-instance.sgml
+++ b/man/gnt-instance.sgml
@@ -68,6 +68,7 @@
           <sbr>
           <arg>-o <replaceable>os-type</replaceable></arg>
           <arg>-b <replaceable>bridge</replaceable></arg>
+          <arg>--mac <replaceable>MAC-address</replaceable></arg>
           <sbr>
           <arg choice="req">-t<group>
               <arg>diskless</arg>
@@ -124,6 +125,15 @@
           bridge specified at cluster initialization time).
         </para>
 
+        <para>
+          The <option>--mac</option> option specifies the MAC address
+          of the ethernet interface for the instance. If this option
+          is not specified, a new MAC address is generated randomly with
+          the configured MAC prefix. The randomly generated MAC
+          address is guaranteed to be unique among the instances of
+          this cluster.
+        </para>
+
         <para>
           The <option>-t</option> options specifies the disk layout type for
           the instance. The available choices are:
@@ -395,12 +405,13 @@
           <arg choice="opt">-p <replaceable>vcpus</replaceable></arg>
           <arg choice="opt">-i <replaceable>ip</replaceable></arg>
           <arg choice="opt">-b <replaceable>bridge</replaceable></arg>
+          <arg chioce="opt">--mac <replaceable>MAC-address</replaceable></arg>
           <arg choice="req"><replaceable>instance</replaceable></arg>
         </cmdsynopsis>
 
         <para>
-          Modify the memory size, number of vcpus, ip address and/or bridge
-          for an instance.
+          Modify the memory size, number of vcpus, ip address, MAC
+          address and/or bridge for an instance.
         </para>
 
         <para>
-- 
GitLab