omf_ec 6.0.0.pre.2

data/exp_repo/system/exp/winlib.rb

@@ -0,0 +1,154 @@
+#
+# Copyright (c) 2006-2009 National ICT Australia (NICTA), Australia
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+#
+# = winlib.rb
+#
+# == Description
+#
+# THIS IS FOR WINLAB ONLY
+#
+# To use the old OMF 5.2 syntax for node description (e.g. [x,y])
+# - load this file in your experiment
+# - rename your 'defTopology' in your experiment by 'defTopology52'
+# - rename your 'defGroup' in your experiment by 'defGroup52'
+# See the examples of use in the test section at the end of this file
+#
+
+
+# THIS IS FOR WINLAB ONLY
+# Return a HRN for a resource based on:
+# - its [x,y] coordinates
+# - the testbed console on which this experiment is currently being executed
+# - a fixed PREFIX
+# e.g. if console's hostname is 'console.grid.orbit-lab.org' and prefix is 'node'
+#      and the resource is at coordinate [1,2]
+#      then the returned HRN is 'node1-2.grid.orbit-lab.org'
+# 
+HRN_PREFIX='node'
+@@hrnSuffix = nil
+def hrn(x,y)
+  @@hrnSuffix = `hostname`.chomp!.split('console')[1] if @@hrnSuffix.nil?
+  raise "Translating 5.2 resource syntax to 5.3 one. "+
+        "Cannot figure out which WINLAB console we are running on! " +
+        "(hostname: #{`hostname`})" if @@hrnSuffix.nil?
+  return "#{HRN_PREFIX}#{x}-#{y}#{@@hrnSuffix}"
+end
+
+# THIS IS FOR WINLAB ONLY
+# Turns a list of node in the 5.2 [x,y] syntax into a list of 5.3 HRN 
+# (this code is from the 5.2. Topology class)
+#
+def turn_52_to_53(nodes)
+    list = []
+    if ! nodes[0].kind_of?(Array)
+      # Array should contain two ranges
+      return [] if nodes.length != 2
+      x = nodes[0]
+      if x.kind_of?(Integer)
+        x = [x]
+      elsif x.kind_of?(ExperimentProperty)
+        x = [x.value]
+      end
+      y = nodes[1]
+      if y.kind_of?(Integer)
+        y = [y]
+      elsif y.kind_of?(ExperimentProperty)
+        y = [y.value]
+      end
+      # Expected two range declarations, but found #{nodes.join(', ')}."
+      return [] if ! ((x.kind_of?(Range) || x.kind_of?(Array)) && (y.kind_of?(Array) || y.kind_of?(Range)))
+      x.each { |i| y.each {|j| list << hrn(i, j) } }
+    else
+      nodes.each {|n| list << turn_52_to_53(n) }
+    end
+    return list
+end
+
+# THIS IS FOR WINLAB ONLY
+# Turns a group/topology selector from the 5.2 to the 5.3 format
+# If the format change is not possible, returns the original selector
+#
+def process_selector(selector)
+  resources = nil
+  # Make sure we use the selector's value if it's an Experiment Property
+  selector = selector.value if selector.kind_of?(ExperimentProperty)
+  # If this is a 5.2 selector then turn it into a 5.3 one
+  if selector.kind_of?(Array)
+    # Add a single resource
+    if (selector.length == 2 && selector[0].kind_of?(Integer) && selector[1].kind_of?(Integer))
+      resources = [hrn(selector[0],selector[1])]
+    # Add a many resource
+    else
+      resources = turn_52_to_53(selector)
+    end
+  end
+  # If the 5.2 to 5.3 process did not succeed, then use the original selector
+  sel = (!resources.nil? && !resources.empty?) ? resources.join(',') : selector
+  return sel
+end
+
+# THIS IS FOR WINLAB ONLY
+# Provide a new 'defGroup52' method which accept 5.3 node coordinate syntax,
+# turns them into 5.3 HRN syntax and call the 5.3 defGroup with it 
+#
+def defGroup52(groupName, selector = nil, &block)
+  sel = process_selector(selector)
+  #puts ">>> s: '#{selector}'" ;  puts ">>> r: '#{sel}'"
+  OMF::EC::CmdContext.instance.defGroup(groupName, sel, &block)
+end
+
+# THIS IS FOR WINLAB ONLY
+# Provide a new 'defTopology52' method which accept 5.3 node coordinate syntax,
+# turns them into 5.3 HRN syntax and call the 5.3 defTopology with it 
+#
+def defTopology52(topoName, selector = nil, &block)
+  sel = process_selector(selector)
+  #puts ">>> s: '#{selector.inspect}'" ;  puts ">>> r: '#{sel}'"
+  OMF::EC::CmdContext.instance.defTopology(topoName, sel, &block)
+end
+
+#
+# Testing Topology: uncomment below and run with "omf-5.3 exec winlib.rb"
+#
+#defTopology52('topo1', [2,3]) 
+#defTopology52('topo2', [[2,3],[4,5],[6,7]]) 
+#defTopology52('topo3', [1..2,4..5]) 
+#defTopology52('topo4', [[1..2,4..5],[6,7],[8,9]]) 
+#defProperty('res2', [1..2,1..2], "Some nodes")
+#defTopology52('topo5', property.res2)
+#(1..5).each { |i|
+#  puts "Content of Topology: topo#{i}"
+#  Topology["topo#{i}"].eachNode { |n| puts "- #{n}" }
+#}
+#Experiment.done
+
+#
+# Testing Groups: uncomment below and run with "omf-5.3 exec winlib.rb"
+#
+#defGroup52('group1', [2,3]) 
+#defGroup52('group2', [[2,3],[4,5],[6,7]]) 
+#defGroup52('group3', [1..2,4..5]) 
+#defGroup52('group4', [[1..2,4..5],[6,7],[8,9]]) 
+#defProperty('res1', [1..2,1..2], "Some nodes")
+#defGroup52('group5', property.res1)
+#defGroup52('group6', ['group1','group2'])
+#Experiment.done

data/exp_repo/system/topo/active.rb

@@ -0,0 +1,9 @@
+#
+# Topology containing entire active nodes on the current testbed
+#
+defTopology('system:topo:active') { |t|
+  active = Topology["system:topo:active:#{OConfig.domain}"]
+  active.each { |n|
+    t.addNode(n)
+  }
+}

data/exp_repo/system/topo/all.rb

@@ -0,0 +1,10 @@
+#
+# Topology containing entire testbed
+#
+
+defTopology('system:topo:all'){ |t|
+  all = OMF::Services.inventory.getListOfResources(OConfig.domain)
+  all.elements.each("RESOURCES/NODE"){|e|
+    t.addNode(e.text)
+  }
+}

data/exp_repo/system/topo/circle.rb

@@ -0,0 +1,23 @@
+defProperty('radius', 8, "Circle radius")
+defProperty('xCenter', 10, "x coordinate of circle center")
+defProperty('yCenter', 10, "y coordinate of circle center")
+
+# nodes arranged in a circle
+defTopology('system:topo:circle') { |t|
+  puts "<#{t}>"
+  # use simple 4-way algorithm
+  radius = prop.radius.value
+  xCenter = prop.xCenter.value
+  yCenter = prop.yCenter.value
+
+  r2 = radius * radius
+  t.addNode(xCenter, yCenter + radius)
+  t.addNode(xCenter, yCenter - radius)
+  (1..radius).each { |x|
+    y = (Math.sqrt(r2 - x*x) + 0.5).to_i
+    t.addNode(xCenter + x, yCenter + y)
+    t.addNode(xCenter + x, yCenter - y)
+    t.addNode(xCenter - x, yCenter + y)
+    t.addNode(xCenter - x, yCenter - y)
+  }
+}

data/exp_repo/test/app/aodvd.rb

@@ -0,0 +1,73 @@
+#
+# Copyright (c) 2006-2009 National ICT Australia (NICTA), Australia
+#
+# Copyright (c) 2004-2009 WINLAB, Rutgers University, USA
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+#
+#
+# Create an application representation from scratch
+#
+require 'omf-expctl/application/appDefinition'
+
+a = AppDefinition.create('test:app:aodvd')
+a.name = "aodvd"
+a.version(0, 0, 1)
+a.shortDescription = "Iperf traffic generator"
+a.description = <<TEXT
+Iperf is a traffic generator for TCP and UDP traffic. It contains generators
+producing various forms of packet streams and port for sending
+these packets via various transports, such as TCP and UDP.
+TEXT
+
+# addProperty(name, description, mnemonic, type, isDynamic = false, constraints = nil)
+a.addProperty('interface', 'Interface to run on', ?i, :string, false)
+a.addProperty('log', 'Enable logging', ?l, :string, false)
+a.addProperty('rttable', 'Log rting table every N secs', ?r, :string, false)
+
+a.addMeasurement("receiverport", nil, [
+  ['flow_no','int'],
+  ['throughput',Float],
+  ['jitter',Float],
+  ['packet_loss',Float]
+ ])
+a.path = "/usr/sbin/aodvd"
+
+if $0 == __FILE__
+  require 'stringio'
+  require 'rexml/document'
+  include REXML
+
+  sio = StringIO.new()
+  a.to_xml.write(sio, 2)
+  sio.rewind
+  puts sio.read
+
+  sio.rewind
+  doc = Document.new(sio)
+  t = AppDefinition.from_xml(doc.root)
+
+  puts
+  puts "-------------------------"
+  puts
+  t.to_xml.write($stdout, 2)
+
+end
+

data/exp_repo/test/app/appDef1.rb

@@ -0,0 +1,102 @@
+#
+# Copyright (c) 2006-2009 National ICT Australia (NICTA), Australia
+#
+# Copyright (c) 2004-2009 WINLAB, Rutgers University, USA
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+#
+#
+
+# Create an application representation from scratch
+
+#
+
+require "appDefinition.rb"
+
+
+
+
+
+a = AppDefinition.create("nodeAgent")
+
+a.url = "http://apps.orbit-lab.org/nodeAgent"
+
+a.name = "NodeAgent"
+
+a.version(0, 0, 1)
+
+a.shortDescription = "Node Agent"
+
+a.description = "\
+
+    A node agent is active on every experiment node and communicates through \
+
+    semantic multicast with all other agents in the system. It can control all the resources \
+
+    on a node and can react to commands from the management agent to control \
+
+    the life cycle of experiments on the respective node."
+
+
+
+# addProperty(name, description, mnemonic, type, isDynamic = false, constraints = nil)
+
+a.addProperty("channel_id", "Channel to send on", "c", "int", true)
+
+a.addProperty("payload_length", "Length of payload of packet", "l", "int", true)
+
+
+
+
+
+a.addMeasurement("group1", nil, [
+
+  ["rssi", AppMeasurement::FLOAT],
+
+  ["noise", AppMeasurement::FLOAT]
+
+])
+
+a.addMeasurement("group2", nil, [
+
+  ["throughput", AppMeasurement::FLOAT]
+
+])
+
+a.addMeasurement("group3", nil, [
+
+  ["offered_load", AppMeasurement::FLOAT]
+
+])
+
+
+
+a.to_xml.write($stdout, 2)
+
+puts
+
+
+
+
+
+
+
+
+

data/exp_repo/test/app/athstats.rb

@@ -0,0 +1,76 @@
+#
+# Copyright (c) 2006-2009 National ICT Australia (NICTA), Australia
+#
+# Copyright (c) 2004-2009 WINLAB, Rutgers University, USA
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+#
+#
+# Create an application representation from scratch
+#
+require 'omf-expctl/application/appDefinition'
+
+a = AppDefinition.create('test:app:athstats')
+a.name = "athstats"
+a.version(0, 0, 1)
+a.shortDescription = "Application to gather madwifi driver statistics"
+a.description = <<TEXT
+This C application gathers driver statistics and reports them.
+TEXT
+
+# addProperty(name, description, mnemonic, type, isDynamic = false, constraints = nil)
+a.addProperty('interface', 'Use ath0/ath1, ath0 by default', nil, :string, false)
+a.addProperty('interval', 'Number of msec between calls to query driver', nil, :string, false)
+
+a.addMeasurement("queryport", nil, [
+    ['succ_tx_attempts', 'int'],
+    ['fail_xretries', 'int'],
+    ['fail_fifoerr', 'int'],
+    ['fail_filtered', 'int'],
+    ['short_retries', 'int'],
+    ['long_retries', 'int'],
+    ['total_frames_rcvd', 'int'],
+    ['crc_errors', 'int'],
+    ['fifo_errors', 'int'],
+    ['phy_errors', 'int']
+ ])
+a.path = "/usr/bin/athstats-oml"
+
+if $0 == __FILE__
+  require 'stringio'
+  require 'rexml/document'
+  include REXML
+
+  sio = StringIO.new()
+  a.to_xml.write(sio, 2)
+  sio.rewind
+  puts sio.read
+
+  sio.rewind
+  doc = Document.new(sio)
+  t = AppDefinition.from_xml(doc.root)
+
+  puts
+  puts "-------------------------"
+  puts
+  t.to_xml.write($stdout, 2)
+
+end
+

data/exp_repo/test/app/echo.rb

@@ -0,0 +1,36 @@
+#
+# Copyright (c) 2006-2009 National ICT Australia (NICTA), Australia
+#
+# Copyright (c) 2004-2009 WINLAB, Rutgers University, USA
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+#
+require 'omf-expctl/application/appDefinition'
+
+defApplication('test:app:echo', 'echo') { |a|
+
+  a.version(1, 0, 0)
+  a.shortDescription = "The shell Echo command"
+  a.description = <<TEXT
+echo is a wrapper around the echo shell command. 
+TEXT
+
+  a.path = "/bin/echo"
+}

data/exp_repo/test/app/gennyReceiverAppDef.rb

@@ -0,0 +1,100 @@
+#
+# Copyright (c) 2006-2009 National ICT Australia (NICTA), Australia
+#
+# Copyright (c) 2004-2009 WINLAB, Rutgers University, USA
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+#
+#
+
+# Create an application representation from scratch
+
+#
+
+require "appDefinition.rb"
+
+
+
+a = AppDefinition.create("gennyReceiver")
+
+a.url = "http://apps.orbit-lab.org/gennyReceiver"
+
+a.name = "gennyReceiver"
+
+a.version(0, 0, 1)
+
+a.shortDescription = "Traffic sink"
+
+a.description = <<TEXT
+
+Genny Revceiver is the receiving peer of the UDP traffic
+
+generator that reports measurements such as RSSI, noise
+
+and throughput. It can be configured to use
+
+libmac (for RSSI measurement) or plain sockets
+
+as its underlying transport mechanism.
+
+TEXT
+
+
+
+# addProperty(name, description, mnemonic, type, isDynamic = false, constraints = nil)
+
+a.addProperty(:interface_name, "Interface to send on", ?i, :string, false)
+
+a.addProperty(:use_socket, "Socket or Libmac", ?s, :boolean, false)
+
+
+
+
+
+a.addMeasurement(:group1, nil, [
+
+  [:rssi, AppMeasurement::FLOAT],
+
+  [:noise, AppMeasurement::FLOAT]
+
+])
+
+a.addMeasurement(:group2, nil, [
+
+  [:throughput, AppMeasurement::FLOAT]
+
+])
+
+
+
+a.repository("http://repository.orbit-lab.org/common/gennyReceiver")
+
+
+
+if $0 == __FILE__
+
+  a.to_xml.write($stdout, 2)
+
+  puts
+
+end
+
+
+

data/exp_repo/test/app/gennySenderAppDef.rb

@@ -0,0 +1,106 @@
+#
+# Copyright (c) 2006-2009 National ICT Australia (NICTA), Australia
+#
+# Copyright (c) 2004-2009 WINLAB, Rutgers University, USA
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+#
+#
+
+# Create an application representation from scratch
+
+#
+
+require "appDefinition.rb"
+
+
+
+a = AppDefinition.create("gennySender")
+
+a.url = "http://apps.orbit-lab.org/gennySender"
+
+a.name = "gennySender"
+
+a.version(0, 0, 1)
+
+a.shortDescription = "Programmable traffic generator"
+
+a.description = <<TEXT
+
+Genny Sender is a custom UDP traffic generator that is able to send
+
+packets at a constant bit rate. It can be configured to use libmac
+
+or plain sockets as its underlying transport mechanism. Users can
+
+change packet rates and payload lengths during the course of the
+
+experiment. Genny sender uses pipes to accept run-time arguments
+
+from users.
+
+TEXT
+
+
+
+# addProperty(name, description, mnemonic, type, isDynamic = false, constraints = nil)
+
+a.addProperty('interface_name', "Interface to send on", ?i, :string, false)
+
+#a.addProperty(:pipe_name, "Pipe on which genny sender listens on", ?p, String, false)
+
+a.addProperty('rate', "Packet rate", ?r, :integer, true)
+
+a.addProperty('payload_length', "Payload length (bytes)", ?l, :integer, true)
+
+a.addProperty('use_socket', "Socket or Libmac", ?s, :boolean, false)
+
+
+
+a.addMeasurement("group3", nil, [
+
+  ["offered_load", Float]
+
+])
+
+
+
+a.repository("http://repository.orbit-lab.org/common/gennySender")
+
+a.repository("http://controlpxe.orbit-lab.org/repository/genny-0.3.tar")
+
+
+
+a.path = "/opt/genny/bin/gennySender"
+
+
+
+
+
+if $0 == __FILE__
+
+  a.to_xml.write($stdout, 2)
+
+  puts
+
+end
+
+
+