removed session manager, since CoreEmu does this now, set future examples to serve as API examples, removed netns examples that are replaced by these API variations

daemon/examples/api/emane80211.py

@@ -0,0 +1,60 @@
+#!/usr/bin/python -i
+#
+# Example CORE Python script that attaches N nodes to an EMANE 802.11abg network.
+
+import datetime
+
+import parser
+from core.emane.ieee80211abg import EmaneIeee80211abgModel
+from core.enumerations import EventTypes
+from core.future.coreemu import CoreEmu
+from core.future.futuredata import IpPrefixes
+
+
+def example(options):
+    # ip generator for example
+    prefixes = IpPrefixes(ip4_prefix="10.83.0.0/16")
+
+    # create emulator instance for creating sessions and utility methods
+    coreemu = CoreEmu()
+    session = coreemu.create_session()
+
+    # must be in configuration state for nodes to start, when using "node_add" below
+    session.set_state(EventTypes.CONFIGURATION_STATE)
+
+    # create emane network node
+    emane_network = session.create_emane_network(
+        model=EmaneIeee80211abgModel,
+        geo_reference=(47.57917, -122.13232, 2.00000)
+    )
+    emane_network.setposition(x=80, y=50)
+
+    # create nodes
+    for i in xrange(options.nodes):
+        node = session.create_wireless_node()
+        node.setposition(x=150 * (i + 1), y=150)
+        interface = prefixes.create_interface(node)
+        session.add_link(node.objid, emane_network.objid, interface_one=interface)
+
+    # instantiate session
+    session.instantiate()
+
+    # start a shell on the first node
+    node = session.get_object(2)
+    node.client.term("bash")
+
+    # shutdown session
+    raw_input("press enter to exit...")
+    coreemu.shutdown()
+
+
+def main():
+    options = parser.parse_options("emane80211")
+    start = datetime.datetime.now()
+    print "running emane 80211 example: nodes(%s) time(%s)" % (options.nodes, options.time)
+    example(options)
+    print "elapsed time: %s" % (datetime.datetime.now() - start)
+
+
+if __name__ == "__main__" or __name__ == "__builtin__":
+    main()

daemon/examples/api/parser.py

@@ -0,0 +1,41 @@
+import argparse
+
+DEFAULT_NODES = 2
+DEFAULT_TIME = 10
+DEFAULT_STEP = 1
+
+
+def parse_options(name):
+    parser = argparse.ArgumentParser(description="Run %s example" % name)
+    parser.add_argument("-n", "--nodes", type=int, default=DEFAULT_NODES,
+                        help="number of nodes to create in this example")
+    parser.add_argument("-t", "--time", type=int, default=DEFAULT_TIME,
+                        help="example iperf run time in seconds")
+
+    options = parser.parse_args()
+
+    # usagestr = "usage: %prog [-h] [options] [args]"
+    # parser = optparse.OptionParser(usage=usagestr)
+    #
+    # parser.add_option("-n", "--nodes", dest="nodes", type=int, default=DEFAULT_NODES,
+    #                   help="number of nodes to create in this example")
+    #
+    # parser.add_option("-t", "--time", dest="time", type=int, default=DEFAULT_TIME,
+    #                   help="example iperf run time in seconds")
+
+    # def usage(msg=None, err=0):
+    #     print
+    #     if msg:
+    #         print "%s\n" % msg
+    #     parser.print_help()
+    #     sys.exit(err)
+
+    # parse command line options
+    # options, args = parser.parse_args()
+
+    if options.nodes < 2:
+        parser.error("invalid min number of nodes: %s" % options.nodes)
+    if options.time < 1:
+        parser.error("invalid test time: %s" % options.time)
+
+    return options

daemon/examples/api/switch.py

@@ -0,0 +1,64 @@
+#!/usr/bin/python
+#
+# run iperf to measure the effective throughput between two nodes when
+# n nodes are connected to a virtual wlan; run test for testsec
+# and repeat for minnodes <= n <= maxnodes with a step size of
+# nodestep
+
+import datetime
+
+import parser
+from core.enumerations import NodeTypes, EventTypes
+from core.future.coreemu import CoreEmu
+from core.future.futuredata import IpPrefixes
+
+
+def example(options):
+    # ip generator for example
+    prefixes = IpPrefixes(ip4_prefix="10.83.0.0/16")
+
+    # create emulator instance for creating sessions and utility methods
+    coreemu = CoreEmu()
+    session = coreemu.create_session()
+
+    # must be in configuration state for nodes to start, when using "node_add" below
+    session.set_state(EventTypes.CONFIGURATION_STATE)
+
+    # create switch network node
+    switch = session.add_node(_type=NodeTypes.SWITCH)
+
+    # create nodes
+    for _ in xrange(options.nodes):
+        node = session.add_node()
+        interface = prefixes.create_interface(node)
+        session.add_link(node.objid, switch.objid, interface_one=interface)
+
+    # instantiate session
+    session.instantiate()
+
+    # get nodes to run example
+    first_node = session.get_object(2)
+    last_node = session.get_object(options.nodes + 1)
+
+    print "starting iperf server on node: %s" % first_node.name
+    first_node.cmd(["iperf", "-s", "-D"])
+    first_node_address = prefixes.ip4_address(first_node)
+    print "node %s connecting to %s" % (last_node.name, first_node_address)
+    last_node.client.icmd(["iperf", "-t", str(options.time), "-c", first_node_address])
+    first_node.cmd(["killall", "-9", "iperf"])
+
+    # shutdown session
+    coreemu.shutdown()
+
+
+def main():
+    options = parser.parse_options("switch")
+
+    start = datetime.datetime.now()
+    print "running switch example: nodes(%s) time(%s)" % (options.nodes, options.time)
+    example(options)
+    print "elapsed time: %s" % (datetime.datetime.now() - start)
+
+
+if __name__ == "__main__":
+    main()

daemon/examples/api/switch_inject.py

@@ -0,0 +1,37 @@
+#!/usr/bin/python
+#
+# run iperf to measure the effective throughput between two nodes when
+# n nodes are connected to a virtual wlan; run test for testsec
+# and repeat for minnodes <= n <= maxnodes with a step size of
+# nodestep
+
+from core.enumerations import NodeTypes, EventTypes
+from core.future.futuredata import IpPrefixes
+
+
+def example(nodes):
+    # ip generator for example
+    prefixes = IpPrefixes("10.83.0.0/16")
+
+    # create emulator instance for creating sessions and utility methods
+    coreemu = globals()["coreemu"]
+    session = coreemu.create_session()
+
+    # must be in configuration state for nodes to start, when using "node_add" below
+    session.set_state(EventTypes.CONFIGURATION_STATE)
+
+    # create switch network node
+    switch = session.add_node(_type=NodeTypes.SWITCH)
+
+    # create nodes
+    for _ in xrange(nodes):
+        node = session.add_node()
+        interface = prefixes.create_interface(node)
+        session.add_link(node.objid, switch.objid, interface_one=interface)
+
+    # instantiate session
+    session.instantiate()
+
+
+if __name__ in {"__main__", "__builtin__"}:
+    example(2)

daemon/examples/api/wlan.py

@@ -0,0 +1,71 @@
+#!/usr/bin/python
+#
+# run iperf to measure the effective throughput between two nodes when
+# n nodes are connected to a virtual wlan; run test for testsec
+# and repeat for minnodes <= n <= maxnodes with a step size of
+# nodestep
+
+import datetime
+
+import parser
+from core.enumerations import NodeTypes, EventTypes
+from core.future.coreemu import CoreEmu
+from core.future.futuredata import IpPrefixes
+from core.mobility import BasicRangeModel
+
+
+def example(options):
+    # ip generator for example
+    prefixes = IpPrefixes("10.83.0.0/16")
+
+    # create emulator instance for creating sessions and utility methods
+    coreemu = CoreEmu()
+    session = coreemu.create_session()
+
+    # must be in configuration state for nodes to start, when using "node_add" below
+    session.set_state(EventTypes.CONFIGURATION_STATE)
+
+    # create wlan network node
+    wlan = session.add_node(_type=NodeTypes.WIRELESS_LAN)
+    session.set_wireless_model(wlan, BasicRangeModel)
+
+    # create nodes
+    wireless_nodes = []
+    for _ in xrange(options.nodes):
+        node = session.add_node()
+        interface = prefixes.create_interface(node)
+        session.add_link(node.objid, wlan.objid, interface_one=interface)
+        wireless_nodes.append(node)
+
+    # link all created nodes with the wireless network
+    session.wireless_link_all(wlan, wireless_nodes)
+
+    # instantiate session
+    session.instantiate()
+
+    # get nodes for example run
+    first_node = session.get_object(2)
+    last_node = session.get_object(options.nodes + 1)
+
+    print "starting iperf server on node: %s" % first_node.name
+    first_node.cmd(["iperf", "-s", "-D"])
+    address = prefixes.ip4_address(first_node)
+    print "node %s connecting to %s" % (last_node.name, address)
+    last_node.client.icmd(["iperf", "-t", str(options.time), "-c", address])
+    first_node.cmd(["killall", "-9", "iperf"])
+
+    # shutdown session
+    coreemu.shutdown()
+
+
+def main():
+    options = parser.parse_options("wlan")
+
+    start = datetime.datetime.now()
+    print "running wlan example: nodes(%s) time(%s)" % (options.nodes, options.time)
+    example(options)
+    print "elapsed time: %s" % (datetime.datetime.now() - start)
+
+
+if __name__ == "__main__":
+    main()