Differences

This shows you the differences between two versions of the page.

--- summerofcode2015:ne2000emulationforbhyve [2015/05/17 16:48] – AlexTeaca
+++ summerofcode2015:ne2000emulationforbhyve [2015/08/23 20:17] (current) – AlexTeaca
@@ Line 42: / Line 42: @@
 Test the NE2000 module implementation, fix some possible bugs and prepare the deliverables and the final evaluation.
-===== Test Plan =====
+===== Final Results =====
+I've implemented the NE2000 emulation in the bhyve hypervisor under both PCI and LPC attachments. The full implementation is located in:
+///usr/src/usr.sbin/bhyve/ne2000.c//, and emulates the ne2000 device for the ED driver in %%FreeBSD%%: ///usr/src/sys/dev/ed/if_ed.c//
-(List of steps you plan to use to test your work, as discussed with your mentor)
+In order to use the device in bhyve, you need to configure it in the parameters list as:
+  * under lpc: -l ne2k0,/dev/tap0
+  * under pci: -s 4:0,ne2k,/dev/tap0
-===== The Code =====
+Under the LPC bus, you can add at most two ne2000 devices which are ne2k0 and ne2k1. If you want to add two interfaces at the same time you will configure it like:
+  * -l ne2k0,/dev/tap0 -l ne2k1,/dev/tap1,00:a0:98:4a:0e:de
-  * https://socsvn.freebsd.org/socsvn/soc2015/iateaca/bhyve-ne2000-head/
+In the guest operating system you will see the network interfaces as:
-===== Useful links =====
+<code>
+ed0 at port 0x310-0x32f irq 10 on isa0
+ed0: Ethernet address: 00:a0:98:4a:0e:ee
+ed1 at port 0x330-0x34f irq 11 on isa0
+ed1: Ethernet address: 00:a0:98:4a:0e:de
-  * [0] http://www.osdever.net/documents/DP8390Details.pdf?the_id=46
+ed0: flags=8802<BROADCAST,SIMPLEX,MULTICAST> metric 0 mtu 1500
-  * [1] https://github.com/qemu/qemu/blob/master/hw/net/ne2000.c
+	ether 00:a0:98:4a:0e:ee
-  * [2] http://realtek.info/pdf/rtl8029as.pdf
+	nd6 options=29<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL>
+	media: Ethernet 10baseT/UTP <full-duplex>
+ed1: flags=8802<BROADCAST,SIMPLEX,MULTICAST> metric 0 mtu 1500
+	ether 00:a0:98:4a:0e:de
+	nd6 options=29<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL>
+	media: Ethernet 10baseT/UTP <full-duplex>}}}
+Any ne2000 device attached under the PCI bus will be probed as the ed2, ed3 ... network interfaces.
+'''Note0:''' For the LPC attachments you need to add in the /boot/device.hints file from the guest operating system the following lines:{{{
+hint.ed.0.at="isa"
+hint.ed.0.port="0x310"
+hint.ed.0.irq="10"
+hint.ed.1.at="isa"
+hint.ed.1.port="0x330"
+hint.ed.1.irq="11"}}}
+== Test Plan ==
+All these tests have passed successfully:
+ * transmit/receive tcp/udp traffic on the ED interface
+ * stop, start the ED interface during the traffic is running
+ * transmit/receive multicast traffic
+ * enable promiscuous mode with the tcpdump enabled, so all packets are accepted
+== Performance Tests ==
+In order to measure the N2000 emulation performance I've used the iperf tool running as server and client in two virtual machine instances.{{{
+guest1: ifconfig ed0 inet 192.168.0.1
+guest2: ifconfig ed1 inet 192.168.0.2}}}
+In order to make connectivity between them, I've attached their tap interfaces in a bridge. For example:{{{
+ifconfig bridge create
+ifconfig bridge0 addm tap0 addm tap1
+ifconfig bridge0 inet 192.168.0.10}}}
+For the UDP traffic I've run these iperf commands:{{{
+guest2: iperf -s -u
+guest1: iperf -c 192.168.0.2 -f Mbyte -u -b 7m
+------------------------------------------------------------
+Client connecting to 192.168.0.2, UDP port 5001
+Sending 1470 byte datagrams
+UDP buffer size: 0.01 MByte (default)
+------------------------------------------------------------
+[  3] local 192.168.0.1 port 54052 connected with 192.168.0.2 port 5001
+[ ID] Interval       Transfer     Bandwidth
+[  3]  0.0-10.0 sec  7.09 MBytes  0.71 MBytes/sec
+[  3] Sent 5057 datagrams
+[  3] Server Report:
+[  3]  0.0-10.0 sec  7.09 MBytes  0.71 MBytes/sec   2.649 ms    0/ 5056 (0%)
+[  3]  0.0-10.0 sec  1 datagrams received out-of-order}}}
+For the TCP traffic I've run these iperf commands:{{{
+guest2: iperf -s
+guest1: iperf -c 192.168.0.2 -f Mbyte
+------------------------------------------------------------
+Client connecting to 192.168.0.2, TCP port 5001
+TCP window size: 0.03 MByte (default)
+------------------------------------------------------------
+[  3] local 192.168.0.1 port 31221 connected with 192.168.0.2 port 5001
+[ ID] Interval       Transfer     Bandwidth
+[  3]  0.0-10.0 sec  6.75 MBytes  0.67 MBytes/sec}}}
+'''Note1:''' The hardware N2000 devices are supposed to work at 10 Mbits/sec which means 1.25 MBytes/sec.
+== The Code ==
+ * https://socsvn.freebsd.org/socsvn/soc2015/iateaca/bhyve-ne2000-head/
+ * https://svnweb.freebsd.org/socsvn/soc2015/iateaca/bhyve-ne2000-head/
+== Useful links ==
+ * [0] http://www.osdever.net/documents/DP8390Details.pdf?the_id=46
+ * [1] https://github.com/qemu/qemu/blob/master/hw/net/ne2000.c
+ * [2] http://realtek.info/pdf/rtl8029as.pdf
+</code>