--- virt-install.man.orig Fri Feb 20 14:28:55 2009 +++ virt-install.man.bw Fri Feb 20 23:30:41 2009 @@ -166,7 +166,8 @@ do not specify a bridge, the system attempts to deter- mine the default. This should be the name of the inter- face in the control domain through which to route the - domain's networking traffic, for example, bge0. + domain's networking traffic, for example, bge0. This op- + tion is obsolete. Use -w/--network option, instead. -c cdrom, --cdrom=cdrom @@ -293,7 +294,8 @@ virtual machines it is required that the first 3 pairs in the MAC address be the sequence 00:16:3e. This option is required when performing PXE or NFS-based installa- - tions of Solaris guests. + tions of Solaris guests. This option is obsolete. Use + -w/--network option, instead. -n name, --name=name @@ -491,26 +493,43 @@ the specified port, creating a conflict. - -w network, --network=network + -w property_list, --network=property_list - Connect the guest to the host network. The value for - network can take the following format: - - host:bridge - - Connect to a bridge device in the specified host. - Use this option if the host has a static networking - configuration and the guest requires full outbound - and inbound connectivity with the LAN. Also use this - format if live migration will be used with this - guest. - + Describes a virtual interface via a list of property-va- + lue pairs separated by comma. Supported properties are: + + bridge=bridge + + Bridge to which to connect the virtual interface. If + you do not specify a bridge, the system attempts to + determine the default. This should be the name of + the interface in the control domain through which to + route the domain's networking traffic, for example, + bge0. This property obsolete -b/--bridge option. + + mac=mac_addr + + Specifies a fixed MAC address for the guest. If this + parameter is omitted, or the value 'RANDOM' is spec- + ified, a suitable address will be randomly generated. + For xVM virtual machines it is required that the fi- + rst 3 pairs in the MAC address be the sequence 00:16 + :3e. This property is required when performing PXE + or NFS-based installations of Solaris guests. This + property obsolete -m/--mac option. + + capped-bandwidth=bandwidth + + Sets bandwidth of this interface. Bandwidth should + be specified as an integer with one of the scale su- + ffixes(K, M, or G for Kbps, Mbps, or Gbps). + If this option is omitted, a single NIC will be created in the guest. If there is a bridge device in the host with a physical interface enslaved, this interface will - be used for connectivity. Failing that, the virtual net- - work called default will be used. This option can be - specified multiple times to setup more than one NIC. + be used for connectivity. This option can be specified + multiple times to setup more than one NIC. Do not mix it + with any one of -b/--bridge and -m/--mac options. -x extra_args, --extra-args=extra_args