WARNING: As previously announced on our communication channels, the Kytos project will enter the "shutdown" phase on May 31, 2021. After this date, only critical patches (security and core bug fixes) will be accepted, and the project will be in "critical-only" mode for another six months (until November 30, 2021). For more information visit the FAQ at <https://kytos.io/faq>. We'll have eternal gratitude to the entire community of developers and users that made the project so far.

The NApp kytos/of_core is a NApp to handle all OpenFlow basic operations. The messages covered are:

• hello messages;
• reply echo request messages;
• request stats messages;
• send a feature request after echo reply;
• update flow list of each switch;
• update features;
• handle all input messages.

Besides the operations related to the messages above and OpenFlow handshake, this NApp emits basic OpenFlow status events.

All of the Kytos Network Applications are located in the NApps online repository. To install this NApp, run:

$ kytos napps install kytos/of_core

Handle a RawEvent and generate a kytos/core.messages.in.* event.

{ 'message': <object> # instance of napps.kytos.of_core.utils.GenericHello message
  'source': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any input of OpenFlow StatsReply in versions 1.0 (v0x01) and updates the switches list with its Flow Stats.

{ 'message': <object> # instance of a python-openflow StatsReply message
  'source': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any input of OpenFlow FeaturesReply in versions 1.0 (v0x01) or 1.3 (v0x04).

{ 'message': <object> # instance of a python-openflow FeaturesReply message
  'source': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any input of OpenFlow MultiPartReply in versions 1.3 (v0x04) and handles Port Description Reply messages

{ 'message': <object> # instance of a python-openflow MultiPartReply message
  'source': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any input of OpenFlow EchoRequest in versions 1.0 (v0x01) or 1.3 (v0x04) and generate an appropriate echo reply.

{ 'message': <object> # instance of a python-openflow EchoRequest message
  'source': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any output of OpenFlow EchoReply in versions 1.0 (v0x01) or 1.3 (v0x04).

{ 'message': <object> # instance of a python-openflow EchoReply message
  'destination': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any output of OpenFlow FeaturesRequest in versions 1.0 (v0x01) or 1.3 (v0x04) and ensure request has actually been sent before changing state.

{ 'message': <object> # instance of a python-openflow FeaturesRequest message
  'destination': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any input of OpenFlow HelloFailed in versions 1.0 (v0x01) or 1.3 (v0x04) and close the destination connection.

{ 'message': <object> # instance of a python-openflow HelloFailed message
  'destination': <object>, # instance of kytos.core.switch.Connection class
}

Listen to any output of OpenFlow HelloFailed in versions 1.0 (v0x01) or 1.3 (v0x04) and close the destination connection.

{ 'message': <object> # instance of a python-openflow HelloFailed message
  'destination': <object>, # instance of kytos.core.switch.Connection class
}

Event reporting that a port was modified in the datapath. It is dispatched after parsing a PortStatus sent by a datapath.

It is worth to say that the PortStatus message just announces that some Port attributes were modified, but it does not state which one. The event dispatched will hold all current Port attributes. If a NApp needs to know which attribute was modified, it will need to compare the current list of attributes with the previous one.

{
 'interface': <interface> # Instance of Interface class
}

kytos/of_core.switch.interface.deleted ===================================== Event reporting that a port was deleted from the datapath. It is dispatched after parsing a PortStatus sent by a datapath.

{
 'interface': <interface> # Instance of Interface class
}

Event reporting that a mac address is reachable from a specific switch/port. This information is retrieved from PacketIns generated sent by the switches.

{
  'switch': <switch.id>,   # switch identification
  'port': <port.port_no>,  # port number
  'reachable_mac': <reachable_mac_address>  # string with mac address
}

Send Error message and emit event upon negotiation failure.

{
  'source': <object> # instance of kytos.core.switch.Connection class
}

Send a StatsRequest message for request stats of flow to switches.

{ 'message': <object>, # instance of a python-openflow StatsRequest message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send an EchoRequest to a datapath.

{ 'message': <object>, # instance of a python-openflow EchoRequest message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send a SetConfig message after the Openflow handshake.

{ 'message': <object>, # instance of a python-openflow SetConfig message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send back a Hello packet with the same version as the switch.

{ 'message': <object>, # instance of a python-openflow Hello message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send a Port Description Request after the Features Reply. This message will be a Multipart with the type OFPMP_PORT_DESC.

{ 'message': <object>, # instance of a python-openflow MultiPart message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send EchoRequest to a datapath.

{ 'message': <object>, # instance of a python-openflow EchoRequest message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send a SetConfig message after the OpenFlow handshake.

{ 'message': <object>, # instance of a python-openflow SetConfig message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send back a Hello packet with the same version as the switch.

{ 'message': <object>, # instance of a python-openflow Hello message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Emit a KytosEvent for an incoming message containing the message and the source.

{ 'message': <object>, # instance of a python-openflow
  'source': <object> # instance of kytos.core.switch.Connection class
}

Send an Echo Reply message to data path.

{ 'message': <object>, # instance of a python-openflow EchoReply message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send Error message and emit event upon negotiation failure.

{ 'message': <object>, # instance of a python-openflow ErrorMsg message
  'destination': <object> # instance of kytos.core.switch.Connection class
}

Send a feature request to the switch.

{ 'message': <object>, # instance of a python-openflow FeaturesRequest message
  'destination': <object> # instance of kytos.core.switch.Connection class
}