summaryrefslogtreecommitdiff
path: root/network/vde2/README
diff options
context:
space:
mode:
authorSean Donner <sean.donner@sbcglobal.net>2010-05-11 20:01:45 +0200
committerRobby Workman <rworkman@slackbuilds.org>2010-05-11 20:01:45 +0200
commit2f62f05d45b76d410ffdc91a6d3c1c413b7db759 (patch)
treed1693dda687153ae0b14be591ed24caa6ce89da0 /network/vde2/README
parent31ed2c363fc98bc200244b4cf2356ccacf7e6771 (diff)
downloadslackbuilds-2f62f05d45b76d410ffdc91a6d3c1c413b7db759.tar.gz
network/vde2: Added to 12.0 repository
Diffstat (limited to 'network/vde2/README')
-rw-r--r--network/vde2/README45
1 files changed, 45 insertions, 0 deletions
diff --git a/network/vde2/README b/network/vde2/README
new file mode 100644
index 0000000000..d893cc50f0
--- /dev/null
+++ b/network/vde2/README
@@ -0,0 +1,45 @@
+VDE is an ethernet compliant virtual network which includes tools such
+as 'vde_switch' and 'vdeqemu'. VDE switch has several virtual ports
+where virtual machines, applications, virtual interfaces and
+connectivity tools can be virtually plugged in. VDE qemu works as a
+wrapper for running qemu virtual machines that connects transparently
+to a specified vde_switch
+
+VDE is dependant upon TUN/TAP support in the Linux Kernel; this comes
+enabled by default with Slackware 12's 'generic' kernel. To enable
+TUN/TAP support manually, you must set the following entry in your
+kernel's '.config' file and recompile:
+ CONFIG_TUN=m
+
+## Configuration
+An init script has been provided in /etc/rc.d/rc.vde2 to use with
+vde_switch. Edit this script and provide the TAP inteface name as
+well as the subnet for your Virtual Switch to use. Do NOT choose
+a subnet which is already in use. More than likely, the default
+values will work fine.
+
+## VDE + Qemu
+A common usage for vde_switch is to be able to have emulated OS's
+via Qemu behave as if they were actually attached to a Local Network.
+To enable this functionality with Qemu, replace any calls to 'qemu'
+with the following command:
+
+vdeqemu -net vde,vlan=0 -net nic,vlan=0,macaddr=AA:BB:CC:DD:EE:FF
+
+Note that the 'macaddr' string is optional but can prove to be
+quite useful when used in conjuction with a DHCP server (such as
+dhcpd or dnsmasq) to assign IP's based upon MAC address.
+
+Do not forget to include the options which point vdeqemu to your
+ISO image to boot along with any other options you may have used
+with 'qemu' such as -localtime, -nographic etc.
+
+## Startup
+To have this start upon each boot, add the following lines to
+/etc/rc.d/rc.local and make sure rc.vde2 is executable.
+
+ # Start vde_switch
+ if [ -x /etc/rc.d/rc.vde2 ]; then
+ /etc/rc.d/rc.vde2 start
+ fi
+