removed old examples, updated examples api to denote they are python script examples

daemon/examples/python/emane80211.py

@@ -0,0 +1,66 @@
+#!/usr/bin/python -i
+#
+# Example CORE Python script that attaches N nodes to an EMANE 802.11abg network.
+
+import datetime
+import parser
+from builtins import range
+
+from core.emane.ieee80211abg import EmaneIeee80211abgModel
+from core.emulator.coreemu import CoreEmu
+from core.emulator.emudata import IpPrefixes
+from core.emulator.enumerations import EventTypes
+from core.utils import load_logging_config
+
+load_logging_config()
+
+
+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 range(options.nodes):
+        node = session.create_wireless_node()
+        node.setposition(x=150 * (i + 1), y=150)
+        interface = prefixes.create_interface(node)
+        session.add_link(node.id, emane_network.id, interface_one=interface)
+
+    # instantiate session
+    session.instantiate()
+
+    # start a shell on the first node
+    node = session.get_node(2)
+    node.client.term("bash")
+
+    # shutdown session
+    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/python/parser.py

@@ -0,0 +1,51 @@
+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/python/switch.py

@@ -0,0 +1,68 @@
+#!/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 builtins import range
+
+from core.emulator.coreemu import CoreEmu
+from core.emulator.emudata import IpPrefixes
+from core.emulator.enumerations import EventTypes, NodeTypes
+from core.utils import load_logging_config
+
+load_logging_config()
+
+
+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 range(options.nodes):
+        node = session.add_node()
+        interface = prefixes.create_interface(node)
+        session.add_link(node.id, switch.id, interface_one=interface)
+
+    # instantiate session
+    session.instantiate()
+
+    # get nodes to run example
+    first_node = session.get_node(2)
+    last_node = session.get_node(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/python/switch_inject.py

@@ -0,0 +1,41 @@
+#!/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 builtins import range
+
+from core.emulator.emudata import IpPrefixes
+from core.emulator.enumerations import EventTypes, NodeTypes
+from core.utils import load_logging_config
+
+load_logging_config()
+
+
+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 range(nodes):
+        node = session.add_node()
+        interface = prefixes.create_interface(node)
+        session.add_link(node.id, switch.id, interface_one=interface)
+
+    # instantiate session
+    session.instantiate()
+
+
+if __name__ in {"__main__", "__builtin__"}:
+    example(2)

daemon/examples/python/wlan.py

@@ -0,0 +1,72 @@
+#!/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 builtins import range
+
+from core.emulator.coreemu import CoreEmu
+from core.emulator.emudata import IpPrefixes, NodeOptions
+from core.emulator.enumerations import EventTypes, NodeTypes
+from core.location.mobility import BasicRangeModel
+from core.utils import load_logging_config
+
+load_logging_config()
+
+
+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.mobility.set_model(wlan, BasicRangeModel)
+
+    # create nodes, must set a position for wlan basic range model
+    node_options = NodeOptions()
+    node_options.set_position(0, 0)
+    for _ in range(options.nodes):
+        node = session.add_node(node_options=node_options)
+        interface = prefixes.create_interface(node)
+        session.add_link(node.id, wlan.id, interface_one=interface)
+
+    # instantiate session
+    session.instantiate()
+
+    # get nodes for example run
+    first_node = session.get_node(2)
+    last_node = session.get_node(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()