aboutsummaryrefslogtreecommitdiffstats
path: root/docs/man/xm.pod.1
diff options
context:
space:
mode:
authoremellor@leeni.uk.xensource.com <emellor@leeni.uk.xensource.com>2005-11-17 12:01:13 +0100
committeremellor@leeni.uk.xensource.com <emellor@leeni.uk.xensource.com>2005-11-17 12:01:13 +0100
commit8add0c9fed7fd9e8eaab0fe0e80161d0d8f6deb4 (patch)
tree866985dfb321297ce65784a86d31a702622f8e07 /docs/man/xm.pod.1
parentaafdb94b17ba9cc0234af1ba4663a9e3a1658087 (diff)
downloadxen-8add0c9fed7fd9e8eaab0fe0e80161d0d8f6deb4.tar.gz
xen-8add0c9fed7fd9e8eaab0fe0e80161d0d8f6deb4.tar.bz2
xen-8add0c9fed7fd9e8eaab0fe0e80161d0d8f6deb4.zip
This patch explains network-* options in xm.1, including the bits that are
currently not really working. Signed off by: Sean Dague <sean@dague.net>
Diffstat (limited to 'docs/man/xm.pod.1')
-rw-r--r--docs/man/xm.pod.153
1 files changed, 48 insertions, 5 deletions
diff --git a/docs/man/xm.pod.1 b/docs/man/xm.pod.1
index 7f34196220..4162b6e3d3 100644
--- a/docs/man/xm.pod.1
+++ b/docs/man/xm.pod.1
@@ -550,10 +550,10 @@ will be allowed to run before being preempted.
=item B<sched-sedf> I<period> I<slice> I<latency-hint> I<extratime> I<weight>
-Set Simple EDF scheduler parameters. This scheduler provides weighted
-CPU sharing in an intuitive way and uses realtime-algorithms to ensure
-time guarantees. For more information see
-docs/misc/sedf_scheduler_mini-HOWTO.txt in the Xen distribution.
+Set Simple EDF (Earliest Deadline First) scheduler parameters. This
+scheduler provides weighted CPU sharing in an intuitive way and uses
+realtime-algorithms to ensure time guarantees. For more information
+see docs/misc/sedf_scheduler_mini-HOWTO.txt in the Xen distribution.
B<PARAMETERS>
@@ -640,11 +640,54 @@ sexpression formatted.
=head2 NETWORK DEVICES
-=item B<network-attach> I<domain-id> I<[script=script]> I<[ip=ipaddr]>
+=item B<network-attach> I<domain-id> I<[script=scriptname]> I<[ip=ipaddr]>
I<[mac=macaddr]> I<[bridge=bridge-name]> I<[backend=bedomain-id]>
+Creates a new network device in the domain specified by domain-id. It
+takes the following optional options:
+
+B<OPTIONS>
+
+=over 4
+
+=item I<script=scriptname>
+
+Use the specified script name to bring up the network. Defaults to
+the default setting in xend-config.sxp for I<vif-script>.
+
+=item I<ip=ipaddr>
+
+Passes the specified IP Address to the adapter on creation.
+
+FIXME: this currently appears to be B<broken>. I'm not sure under what
+circumstances this should actually work.
+
+=item I<mac=macaddr>
+
+The MAC address that the domain will see on its ethernet device. If
+the device is not specified it will be randomly generated with the
+00:16:3e vendor id prefix.
+
+=item I<bridge=bridge-name>
+
+The name of the bridge to attach the vif to, in case you have more
+than one. This defaults to
+
+=item I<backend=bedomain-id>
+
+The backend domain id. By default this is domain 0.
+
+=back
+
=item B<network-detach> I<domain-id> I<devid>
+Removes the network device from the domain specified by I<domain-id>.
+I<devid> is the virtual interface device number within the domain
+(i.e. the 3 in vif22.3).
+
+FIXME: this is currently B<broken>. Network devices aren't completely
+removed from domain 0.
+
=item B<network-list> I<domain-id>
List virtual network interfaces for a domain. The returned output is