trema 0.1.3

data/features/example.repeater_hub.feature

@@ -0,0 +1,49 @@
+Feature: Control one openflow switch with repeater_hub controller
+
+  As a Trema user
+  I want to control one openflow switch using repeater_hub controller
+  So that I can flood incoming packets to every other port
+
+
+  Scenario: Run repeater hub
+    When I try trema run "./objects/examples/repeater_hub/repeater_hub" with following configuration (backgrounded):
+      """
+      vswitch("repeater_hub") { datapath_id "0xabc" }
+
+      vhost("host1") { promisc "On" }
+      vhost("host2") { promisc "On" }
+      vhost("host3") { promisc "On" }
+
+      link "repeater_hub", "host1"
+      link "repeater_hub", "host2"
+      link "repeater_hub", "host3"
+      """
+      And wait until "repeater_hub" is up
+      And I send 1 packet from host1 to host2
+      And I try to run "./trema show_stats host1 --tx" (log = "host1.repeater_hub.log")
+      And I try to run "./trema show_stats host2 --rx" (log = "host2.repeater_hub.log")
+      And I try to run "./trema show_stats host3 --rx" (log = "host3.repeater_hub.log")
+    Then the content of "host1.repeater_hub.log" and "host2.repeater_hub.log" should be identical
+     And the content of "host1.repeater_hub.log" and "host3.repeater_hub.log" should be identical
+
+
+  Scenario: Run repeater hub (Ruby)
+    When I try trema run "./src/examples/repeater_hub/repeater-hub.rb" with following configuration (backgrounded):
+      """
+      vswitch("repeater_hub") { datapath_id "0xabc" }
+
+      vhost("host1") { promisc "On" }
+      vhost("host2") { promisc "On" }
+      vhost("host3") { promisc "On" }
+
+      link "repeater_hub", "host1"
+      link "repeater_hub", "host2"
+      link "repeater_hub", "host3"
+      """
+      And wait until "RepeaterHub" is up
+      And I send 1 packet from host1 to host2
+      And I try to run "./trema show_stats host1 --tx" (log = "host1.repeater-hub.rb.log")
+      And I try to run "./trema show_stats host2 --rx" (log = "host2.repeater-hub.rb.log")
+      And I try to run "./trema show_stats host3 --rx" (log = "host3.repeater-hub.rb.log")
+    Then the content of "host1.repeater-hub.rb.log" and "host2.repeater-hub.rb.log" should be identical
+     And the content of "host1.repeater-hub.rb.log" and "host3.repeater-hub.rb.log" should be identical

data/features/example.switch_monitor.feature

@@ -0,0 +1,39 @@
+Feature: Hello trema sample application
+
+  As a Trema user
+  I want to list up OpenFlow switches in my network
+  So that I can monitor my switches
+
+
+  Scenario: switch-monitor
+    Given I try trema run "./src/examples/switch_monitor/switch-monitor.rb" with following configuration (backgrounded):
+      """
+      vswitch { datapath_id 0x1 }
+      vswitch { datapath_id 0x2 }
+      vswitch { datapath_id 0x3 }
+      """
+      And *** sleep 2 ***
+      And wait until "SwitchMonitor" is up
+    When I try trema off "0x3"
+      And *** sleep 2 ***
+    Then the log file "SwitchMonitor.log" should match:
+      """
+      Switch 0x3 is DOWN
+      """
+
+
+  Scenario: switch-monitor in C
+    Given I try trema run "./objects/examples/switch_monitor/switch_monitor" with following configuration (backgrounded):
+      """
+      vswitch { datapath_id 0x1 }
+      vswitch { datapath_id 0x2 }
+      vswitch { datapath_id 0x3 }
+      """
+      And *** sleep 2 ***
+      And wait until "switch_monitor" is up
+    When I try trema off "0x3"
+      And *** sleep 2 ***
+    Then the log file "switch_monitor.log" should match:
+      """
+      Switch 0x3 is DOWN
+      """

data/features/packetin_filter.feature

@@ -0,0 +1,49 @@
+Feature: packetin_filter help
+
+  As a Trema user
+  I want to see the help message of packetin_filter command
+  So that I can learn how to use packetin_filter
+
+  Scenario: packetin_filter --help
+    When I try to run "./objects/packetin_filter/packetin_filter --help"
+    Then the output should be:
+      """
+      OpenFlow Packet in Filter.
+      Usage: packetin_filter [OPTION]... [PACKETIN-FILTER-RULE]...
+      
+        -n, --name=SERVICE_NAME     service name
+        -d, --daemonize             run in the background
+        -l, --logging_level=LEVEL   set logging level
+        -h, --help                  display this help and exit
+      
+      PACKETIN-FILTER-RULE:
+        match-type::destination-service-name
+      
+      match-type:
+        lldp                        LLDP ethernet frame type and priority is 0x8000
+        packet_in                   any packet and priority is zero
+      
+      destination-service-name      destination service name
+      """
+
+  Scenario: packetin_filter -h
+    When I try to run "./objects/packetin_filter/packetin_filter -h"
+    Then the output should be:
+      """
+      OpenFlow Packet in Filter.
+      Usage: packetin_filter [OPTION]... [PACKETIN-FILTER-RULE]...
+      
+        -n, --name=SERVICE_NAME     service name
+        -d, --daemonize             run in the background
+        -l, --logging_level=LEVEL   set logging level
+        -h, --help                  display this help and exit
+      
+      PACKETIN-FILTER-RULE:
+        match-type::destination-service-name
+      
+      match-type:
+        lldp                        LLDP ethernet frame type and priority is 0x8000
+        packet_in                   any packet and priority is zero
+      
+      destination-service-name      destination service name
+      """

data/features/step_definitions/kill_steps.rb

@@ -0,0 +1,30 @@
+#
+# Author: Yasuhito Takamiya <yasuhito@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+Given /^I terminated all trema services$/ do
+  run "./trema killall"
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/features/step_definitions/log_steps.rb

@@ -0,0 +1,90 @@
+#
+# Author: Yasuhito Takamiya <yasuhito@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+Then /^the output should be:$/ do | string |
+  IO.read( @log ).chomp.should == string.chomp
+end
+
+
+Then /^I should not get errors$/ do
+  step "the output should be:", ""
+end
+
+
+Then /^the output should include:$/ do | string |
+  string.chomp.split( "\n" ).each do | each |
+    IO.read( @log ).split( "\n" ).should include( each )
+  end
+end
+
+
+Then /^"([^"]*)" should be executed with option = "([^"]*)"$/ do | executable, options |
+  IO.read( @log ).should match( Regexp.new "#{ executable } #{ options }" )
+end
+
+
+Then /^the log file "([^"]*)" should be:$/ do | log_name, string |
+  IO.read( cucumber_log log_name ).chomp.should == string.chomp
+end
+
+
+Then /^the log file "([^"]*)" should include:$/ do | log_name, string |
+  IO.read( cucumber_log log_name ).split( "\n" ).should include( string )
+end
+
+
+Then /^the log file "([^"]*)" should match:$/ do | log_name, string |
+  IO.read( cucumber_log log_name ).should match( Regexp.new string )
+end
+
+
+Then /^the log file "([^"]*)" should include "([^"]*)" x (\d+)$/ do | log, message, n |
+  IO.read( cucumber_log log ).split( "\n" ).inject( 0 ) do | matched, each |
+    matched += 1 if each.include?( message )
+    matched
+  end.should == n.to_i
+end
+
+
+Then /^the content of "([^"]*)" should be:$/ do | log_name, string |
+  IO.read( cucumber_log log_name ).chomp( "" ).should == string.chomp
+end
+
+
+Then /^the content of "([^"]*)" and "([^"]*)" should be identical$/ do | log1, log2 |
+  IO.read( cucumber_log log1 ).size.should > 0
+  IO.read( cucumber_log log2 ).size.should > 0
+  IO.read( cucumber_log log1 ).chomp.should == IO.read( cucumber_log log2 ).chomp
+end
+
+
+Then /^"([^"]*)" should contain some flow entries$/ do | log |
+  IO.read( cucumber_log log ).size.should > 0
+  IO.read( cucumber_log log ).split( "\n" )[ 2..-1 ].each do | each |
+    each.should match( /actions=FLOOD/ )
+  end
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/features/step_definitions/misc_steps.rb

@@ -0,0 +1,64 @@
+#
+# Author: Yasuhito Takamiya <yasuhito@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+When /^\*\*\* sleep (\d+) \*\*\*$/ do | sec |
+  sleep sec.to_i
+end
+
+
+When /^wait until "([^"]*)" is up$/ do | process |
+  nloop = 0
+  pid_file = File.join( Trema.pid_directory, "#{ process }.pid" )
+  loop do
+    nloop += 1
+    raise "Timeout" if nloop > 30
+    break if FileTest.exists?( pid_file ) and not ps_entry_of( process ).nil?
+    sleep 0.1
+  end
+  sleep 1  # FIXME
+end
+
+
+Then /^([^\s]*) is terminated$/ do | name |
+  ps_entry_of( name ).should be_empty
+end
+
+
+Then /^vswitch ([^\s]*) is terminated$/ do | dpid |
+  pid_file = File.join( Trema.tmp, "openflowd.#{ dpid }.pid" )
+  File.exists?( pid_file ).should be_false
+end
+
+
+Then /^([^\s]*) is started$/ do | name |
+  ps_entry_of( name ).should_not be_empty
+end
+
+
+Then /^switch_manager should be killed$/ do
+  IO.read( @log ).should match( /^Shutting down switch_manager/ )
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/features/step_definitions/off_steps.rb

@@ -0,0 +1,30 @@
+#
+# Author: Yasuhito Takamiya <yasuhito@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+When /^I try trema off "([^"]*)"$/ do | component |
+  run "./trema off #{ component }"
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End:

data/features/step_definitions/run_steps.rb

@@ -0,0 +1,91 @@
+#
+# Author: Yasuhito Takamiya <yasuhito@gmail.com>
+#
+# Copyright (C) 2008-2012 NEC Corporation
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2, as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+
+When /^I try to run "([^"]*)"$/ do | command |
+  @log ||= new_tmp_log
+  run "#{ command } >> #{ @log }"
+end
+
+
+When /^I try to run "([^"]*)" \(log = "([^"]*)"\)$/ do | command, log_name |
+  run "#{ command } > #{ cucumber_log log_name } 2>&1"
+end
+
+
+When /^I try trema run "([^"]*)" with following configuration \((.*)\):$/ do | args, options, config |
+  verbose = if /verbose/=~ options
+              "--verbose"
+            else
+              ""
+            end
+  @log ||= new_tmp_log
+
+  trema_run = Proc.new do
+    Tempfile.open( "trema.conf" ) do | f |
+      f.puts config
+      f.flush
+      run "./trema run \"#{ args }\" -c #{ f.path } #{ verbose } >> #{ @log } 2>&1"
+    end
+  end
+
+  if /background/=~ options
+    pid = Process.fork do
+      trema_run.call
+    end
+    Process.detach pid
+  else
+    trema_run.call
+  end
+end
+
+
+Given /^I try trema run "([^"]*)" example with following configuration \(backgrounded\):$/ do | example, config |
+  controller = nil
+  name = nil
+  if /\.rb\Z/=~ example
+    controller = "./src/examples/#{ File.basename( example, ".rb" ).tr( "-", "_" ) }/#{ example }"
+    name = File.basename( example, ".rb" ).camelize
+  else
+    controller = "./objects/examples/#{ example }/#{ example }"
+    name = example
+  end
+  step %{I try trema run "#{ controller }" with following configuration (backgrounded):}, config
+  step %{wait until "#{ name }" is up}
+end
+
+
+When /^I try trema run "([^"]*)" with following configuration:$/ do | args, config |
+  step "I try trema run \"#{ args }\" with following configuration (no options):", config
+end
+
+
+Then /^"([^"]*)" exits abnormally with an error message:$/ do | command, message |
+  log = "error.log"
+  step %{I try to run "#{ command }" (log = "#{ log }")} rescue error_occured = true
+  error_occured.should be_true
+  step %{the content of "#{ log }" should be:}, message
+end
+
+
+### Local variables:
+### mode: Ruby
+### coding: utf-8-unix
+### indent-tabs-mode: nil
+### End: