Project: Trema-testbed

Publisher: y-higuchi

C function example command "add_forward_entry"

Switch Event forwarding configuration command (add_forward_entry)
is a command to add an event forwarding entry to
Switch Manager and Switch Daemons.

Following switch event types can be configured by this command:

vendor
packet_in
port_stat
state_notify

This command is a simple usage example for C version of switch event forwarding API.
C version API is defined as a group of functions declared in event_forward_interface.h.
These functions are used in topology manager to
add itself to packet_in forwarding entry of all existing switch daemons and
switch manager to receive LLDP packets.
By adding and removing entry for 'topology' from some switches, it is possible to make
topology manager to map only a subset of the switches managed by trema.

Please see README.md for general notes on switch event forwarding API.

Background

Given: I cd to "../../src/examples/switch_event_config/"
And: I compile "add_forward_entry.c" into "add_forward_entry"
And: I compile "dump_forward_entries.c" into "dump_forward_entries"

Scenarios

add_forward_entry Usage
Add 'mirror' to All Switch Manager/Daemon's event forwarding entries of packet_in
Switch added after event forwarding entry manipulation should also reflect new configuration of Switch Manager.
Add 'mirror' only to Switch Manager's event forwarding entry of packet_in
Add 'mirror' only to Switch Daemon 0x1's event forwarding entries of packet_in

add_forward_entry Usage

When

I successfully run trema run './add_forward_entry -h'

Then

the output should contain:

Add OpenFlow Switch Manager/Daemon event forward entry.
 Both Switch Mgr/Daemon: add_forward_entry -t EVENT_TYPE service_name
 Only Switch Manager   : add_forward_entry -m -t EVENT_TYPE service_name
 Only Switch Daemon    : add_forward_entry -s SWITCH_DPID -t EVENT_TYPE service_name

 EVENT_TYPE:
  -t, --type={vendor,packet_in,port_status,state_notify} Specify event type.

Add 'mirror' to All Switch Manager/Daemon's event forwarding entries of packet_in

Given

a file named "nw_dsl.conf" with:

vswitch { datapath_id 0x1 }
vswitch { datapath_id 0x2 }

And

I successfully run trema run ../repeater_hub/repeater-hub.rb -c nw_dsl.conf -d

And

wait until "RepeaterHub" is up

When

I successfully run trema run './add_forward_entry -t packet_in mirror'

Then

the output should contain "Operation Succeeded."

And

I successfully run trema run './dump_forward_entries option -t packet_in'

And

the output should contain "Current service name list:"

And

the output should match /.* RepeaterHub.*/

And

the output should match /.* mirror.*/

Examples:
target	option
SW MGR	-m
SW 0x1	-s 0x1
SW 0x2	-s 0x2

Switch added after event forwarding entry manipulation should also reflect new configuration of Switch Manager.

Given

a file named "nw_dsl.conf" with:

vswitch { datapath_id 0x1 }
vswitch { datapath_id 0x2 }

And

I successfully run trema run ../repeater_hub/repeater-hub.rb -c nw_dsl.conf -d

And

wait until "RepeaterHub" is up

And

I successfully run trema run './add_forward_entry -t packet_in mirror'

And

the output should contain "Operation Succeeded."

And

a file named "switch_event_config_add.conf" with:

vswitch { datapath_id 0x3 }

And

I successfully run trema run -c switch_event_config_add.conf -d

When

I successfully run trema run './dump_forward_entries option -t packet_in'

Then

the output should contain "Current service name list:"

And

the output should match /.* RepeaterHub.*/

And

the output should match /.* mirror.*/

Examples:
target	option
SW 0x3	-s 0x3
SW MGR	-m
SW 0x1	-s 0x1
SW 0x2	-s 0x2

Add 'mirror' only to Switch Manager's event forwarding entry of packet_in

Given

a file named "nw_dsl.conf" with:

vswitch { datapath_id 0x1 }
vswitch { datapath_id 0x2 }

And

I successfully run trema run ../repeater_hub/repeater-hub.rb -c nw_dsl.conf -d

And

wait until "RepeaterHub" is up

When

I successfully run trema run './add_forward_entry -m -t packet_in mirror'

Then

the output should contain "Updated service name list:"

And

the output should contain " RepeaterHub"

And

the output should contain " mirror"

And

I successfully run trema run './dump_forward_entries -s switch -t packet_in'

And

the output should match /Current service name list:.* RepeaterHub/

And

the output should not match /Current service name list:.* mirror/

Examples:
switch
0x1
0x2

Add 'mirror' only to Switch Daemon 0x1's event forwarding entries of packet_in

Given

a file named "nw_dsl.conf" with:

vswitch { datapath_id 0x1 }
vswitch { datapath_id 0x2 }

And

I successfully run trema run ../repeater_hub/repeater-hub.rb -c nw_dsl.conf -d

And

wait until "RepeaterHub" is up

When

I successfully run trema run './add_forward_entry -s 0x1 -t packet_in mirror'

Then

the output should contain "Updated service name list:"

And

the output should contain " RepeaterHub"

And

the output should contain " mirror"

And

I successfully run trema run './dump_forward_entries option -t packet_in'

And

the output should match /Current service name list:.* RepeaterHub/

And

the output should not match /Current service name list:.* mirror/

Examples:
target	option
SW MGR	-m
SW 0x2	-s 0x2

Last published over 7 years ago by y-higuchi.

C function example command "add_forward_entry"

Trema-testbed settings