0% found this document useful (0 votes)

31 views610 pages

Ryu Readthedocs Io en Latest

Uploaded by

Anderson Valderrama

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

31 views610 pages

Ryu Readthedocs Io en Latest

Uploaded by

Anderson Valderrama

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 610

ryu Documentation

Release 4.34

ryu development team

Jun 09, 2022

Contents

1 Getting Started 3
1.1 What’s Ryu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Optional Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.4 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.5 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Writing Your Ryu Application 5

2.1 The First Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2 Components of Ryu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3 Ryu application API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4 Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.5 OpenFlow protocol API Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
2.6 Nicira Extension Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
2.7 Ryu API Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

3 Configuration 499
3.1 Setup TLS Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
3.2 Topology Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

4 Tests 503
4.1 Testing VRRP Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
4.2 Testing OF-config support with LINC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507

5 Snort Intergration 511

5.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
5.2 Installation Snort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
5.3 Configure Snort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
5.4 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512

6 Built-in Ryu applications 515

6.1 ryu.app.ofctl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
6.2 ryu.app.ofctl_rest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
6.3 ryu.app.rest_vtep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
6.4 ryu.services.protocols.bgp.application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580

7 Indices and tables 585

i
Python Module Index 587

Index 589

ii
ryu Documentation, Release 4.34

Contents:

Contents 1
ryu Documentation, Release 4.34

2 Contents
CHAPTER 1

Getting Started

PLEASE READ: RYU NOT CURRENTLY MAINTAINED

• The Ryu project needs new maintainers - please file an issue if you are able to assist.
• see OpenStack’s os-ken (https://github.com/openstack/os-ken) for a maintained Ryu alternative.

1.1 What’s Ryu

Ryu is a component-based software defined networking framework.

Ryu provides software components with well defined API’s that make it easy for developers to create new network
management and control applications. Ryu supports various protocols for managing network devices, such as Open-
Flow, Netconf, OF-config, etc. About OpenFlow, Ryu supports fully 1.0, 1.2, 1.3, 1.4, 1.5 and Nicira Extensions.
All of the code is freely available under the Apache 2.0 license. Ryu is fully written in Python.

1.2 Quick Start

Installing Ryu is quite easy:

% pip install ryu

If you prefer to install Ryu from the source code:

% git clone https://github.com/faucetsdn/ryu.git

% cd ryu; pip install .

If you want to write your Ryu application, have a look at Writing ryu application document. After writing your
application, just type:

% ryu-manager yourapp.py

3
ryu Documentation, Release 4.34

1.3 Optional Requirements

Some functions of ryu require extra packages:

• OF-Config requires lxml and ncclient
• NETCONF requires paramiko
• BGP speaker (SSH console) requires paramiko
• Zebra protocol service (database) requires SQLAlchemy
If you want to use these functions, please install the requirements:

% pip install -r tools/optional-requires

Please refer to tools/optional-requires for details.

1.4 Prerequisites

If you got some error messages at the installation stage, please confirm dependencies for building the required Python
packages.
On Ubuntu(16.04 LTS or later):

% apt install gcc python-dev libffi-dev libssl-dev libxml2-dev libxslt1-dev zlib1g-dev

1.5 Support

Ryu Official site is https://ryu-sdn.org/.

If you have any questions, suggestions, and patches, the mailing list is available at ryu-devel ML. The ML archive at
Gmane is also available.

4 Chapter 1. Getting Started

CHAPTER 2

Writing Your Ryu Application

2.1 The First Application

2.1.1 Whetting Your Appetite

If you want to manage network gear (switches, routers, etc) your own way, you just need to write your own Ryu
application. Your application tells Ryu how you want to manage the gear. Then Ryu configures the gear by using
OpenFlow protocol, etc.
Writing Ryu applications is easy. They’re just Python scripts.

2.1.2 Start Writing

Here we show a Ryu application that makes an OpenFlow switch work as a dumb layer 2 switch.
Open a text editor and create a new file with the following content:

from ryu.base import app_manager

class L2Switch(app_manager.RyuApp):
def __init__(self, *args, **kwargs):
super(L2Switch, self).__init__(*args, **kwargs)

Ryu applications are just Python scripts so you can save the file with any name, any extension, and any place you want.
Let’s name the file ’l2.py’ in your home directory.
This application does nothing useful yet, however it’s a complete Ryu application. In fact, you can run this Ryu
application:

% ryu-manager ~/l2.py
loading app /Users/fujita/l2.py
instantiating app /Users/fujita/l2.py

5
ryu Documentation, Release 4.34

All you have to do is define a new subclass of RyuApp to run your Python script as a Ryu application.
Next let’s add some functionality that sends a received packet to all the ports.

from ryu.base import app_manager

from ryu.controller import ofp_event
from ryu.controller.handler import MAIN_DISPATCHER
from ryu.controller.handler import set_ev_cls
from ryu.ofproto import ofproto_v1_0

class L2Switch(app_manager.RyuApp):
OFP_VERSIONS = [ofproto_v1_0.OFP_VERSION]

def init(self, *args, **kwargs):

super(L2Switch, self).__init__(*args, **kwargs)

@set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
def packet_in_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto
ofp_parser = dp.ofproto_parser

actions = [ofp_parser.OFPActionOutput(ofp.OFPP_FLOOD)]

data = None
if msg.buffer_id == ofp.OFP_NO_BUFFER:
data = msg.data

out = ofp_parser.OFPPacketOut(
datapath=dp, buffer_id=msg.buffer_id, in_port=msg.in_port,
actions=actions, data = data)
dp.send_msg(out)

A new method ’packet_in_handler’ is added to the L2Switch class. This is called when Ryu receives an OpenFlow
packet_in message. The trick is the ’set_ev_cls’ decorator. This decorator tells Ryu when the decorated function
should be called.
The first argument of the decorator indicates which type of event this function should be called for. As you might
expect, every time Ryu gets a packet_in message, this function is called.
The second argument indicates the state of the switch. You probably want to ignore packet_in messages before the
negotiation between Ryu and the switch is finished. Using ’MAIN_DISPATCHER’ as the second argument means
this function is called only after the negotiation completes.
Next let’s look at the first half of the ’packet_in_handler’ function.
• ev.msg is an object that represents a packet_in data structure.
• msg.dp is an object that represents a datapath (switch).
• dp.ofproto and dp.ofproto_parser are objects that represent the OpenFlow protocol that Ryu and the switch
negotiated.
Ready for the second half.
• OFPActionOutput class is used with a packet_out message to specify a switch port that you want to send the
packet out of. This application uses the OFPP_FLOOD flag to indicate that the packet should be sent out on all
ports.
• OFPPacketOut class is used to build a packet_out message.

6 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

• If you call Datapath class’s send_msg method with a OpenFlow message class object, Ryu builds and sends the
on-wire data format to the switch.
There, you finished implementing your first Ryu application. You are ready to run a Ryu application that does some-
thing useful.
Is a dumb L2 switch is too dumb? You want to implement a learning L2 switch? Move to the next step. You can learn
from the existing Ryu applications at ryu/app directory and integrated tests directory.

2.2 Components of Ryu

2.2.1 Executables

bin/ryu-manager

The main executable.

2.2.2 Base components

ryu.base.app_manager

The central management of Ryu applications.

• Load Ryu applications
• Provide contexts to Ryu applications
• Route messages among Ryu applications

2.2.3 OpenFlow controller

ryu.controller.controller

The main component of OpenFlow controller.

• Handle connections from switches
• Generate and route events to appropriate entities like Ryu applications

ryu.controller.dpset

Manage switches.
Planned to be replaced by ryu/topology.

ryu.controller.ofp_event

OpenFlow event definitions.

ryu.controller.ofp_handler

Basic OpenFlow handling including negotiation.

2.2. Components of Ryu 7

ryu Documentation, Release 4.34

2.2.4 OpenFlow wire protocol encoder and decoder

ryu.ofproto.ofproto_v1_0

OpenFlow 1.0 definitions.

ryu.ofproto.ofproto_v1_0_parser

Decoder/Encoder implementations of OpenFlow 1.0.

ryu.ofproto.ofproto_v1_2

OpenFlow 1.2 definitions.

ryu.ofproto.ofproto_v1_2_parser

Decoder/Encoder implementations of OpenFlow 1.2.

ryu.ofproto.ofproto_v1_3

OpenFlow 1.3 definitions.

ryu.ofproto.ofproto_v1_3_parser

This module implements OpenFlow 1.3.x.

This module also implements some of extensions shown in "OpenFlow Extensions for 1.3.X Pack 1". Namely, the
following extensions are implemented.
• EXT-230 Bundle Extension (without bundle properties)
• EXT-236 Bad flow entry priority error Extension
• EXT-237 Set async config error Extension
• EXT-256 PBB UCA header field Extension
• EXT-260 Duplicate instruction error Extension
• EXT-264 Multipart timeout errors Extension
The following extensions are partially implemented.
• EXT-187 Flow entry notifications Extension (ONFMP_FLOW_MONITOR only)
• EXT-232 Table synchronisation Extension (Error codes only)
The following extensions are not implemented yet.
• EXT-191 Role Status Extension
• EXT-192-e Flow entry eviction Extension
• EXT-192-v Vacancy events Extension

8 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

ryu.ofproto.ofproto_v1_4

OpenFlow 1.4 definitions.

ryu.ofproto.ofproto_v1_4_parser

Decoder/Encoder implementations of OpenFlow 1.4.

ryu.ofproto.ofproto_v1_5

OpenFlow 1.5 definitions.

ryu.ofproto.ofproto_v1_5_parser

Decoder/Encoder implementations of OpenFlow 1.5.

2.2.5 Ryu applications

ryu.app.cbench

A dumb OpenFlow 1.0 responder for benchmarking the controller framework. Intended to be used with oflops cbench.

ryu.app.simple_switch

An OpenFlow 1.0 L2 learning switch implementation.

ryu.topology

Switch and link discovery module. Planned to replace ryu/controller/dpset.

2.2.6 Libraries

ryu.lib.packet

Ryu packet library. Decoder/Encoder implementations of popular protocols like TCP/IP.

ryu.lib.ovs

ovsdb interaction library.

ryu.lib.of_config

OF-Config implementation.

ryu.lib.netconf

NETCONF definitions used by ryu/lib/of_config.

2.2. Components of Ryu 9

ryu Documentation, Release 4.34

ryu.lib.xflow

An implementation of sFlow and NetFlow.

2.2.7 Third party libraries

ryu.contrib.ovs

Open vSwitch python binding. Used by ryu.lib.ovs.

ryu.contrib.oslo.config

Oslo configuration library. Used for ryu-manager’s command-line options and configuration files.

ryu.contrib.ncclient

Python library for NETCONF client. Used by ryu.lib.of_config.

2.3 Ryu application API

2.3.1 Ryu application programming model

Threads, events, and event queues

Ryu applications are single-threaded entities which implement various functionalities in Ryu. Events are messages
between them.
Ryu applications send asynchronous events to each other. Besides that, there are some Ryu-internal event sources
which are not Ryu applications. One of examples of such event sources is OpenFlow controller. While an event can
currently contain arbitrary python objects, it’s discouraged to pass complex objects (eg. unpickleable objects) between
Ryu applications.
Each Ryu application has a receive queue for events. The queue is FIFO and preserves the order of events. Each Ryu
application has a thread for event processing. The thread keeps draining the receive queue by dequeueing an event
and calling the appropritate event handler for the event type. Because the event handler is called in the context of the
event processing thread, it should be careful when blocking. While an event handler is blocked, no further events for
the Ryu application will be processed.
There are kinds of events which are used to implement synchronous inter-application calls between Ryu applications.
While such requests uses the same machinary as ordinary events, their replies are put on a queue dedicated to the
transaction to avoid deadlock.
While threads and queues is currently implemented with eventlet/greenlet, a direct use of them in a Ryu application is
strongly discouraged.

Contexts

Contexts are ordinary python objects shared among Ryu applications. The use of contexts are discouraged for new
code.

10 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

2.3.2 Create a Ryu application

A Ryu application is a python module which defines a subclass of ryu.base.app_manager.RyuApp. If two or more
such classes are defined in a module, the first one (by name order) will be picked by app_manager. Ryu application is
singleton: only single instance of a given Ryu application is supported.

2.3.3 Observe events

A Ryu application can register itself to listen for specific events using ryu.controller.handler.set_ev_cls decorator.

2.3.4 Generate events

A Ryu application can raise events by calling appropriate ryu.base.app_manager.RyuApp’s methods like send_event
or send_event_to_observers.

2.3.5 Event classes

An event class describes a Ryu event generated in the system. By convention, event class names are prefixed by
"Event". Events are generated either by the core part of Ryu or Ryu applications. A Ryu application can register its
interest for a specific type of event by providing a handler method using ryu.controller.handler.set_ev_cls decorator.

OpenFlow event classes

ryu.controller.ofp_event module exports event classes which describe receptions of OpenFlow messages from con-
nected switches. By convention, they are named as ryu.controller.ofp_event.EventOFPxxxx where xxxx is the name
of the corresponding OpenFlow message. For example, EventOFPPacketIn for packet-in message. The OpenFlow
controller part of Ryu automatically decodes OpenFlow messages received from switches and send these events to
Ryu applications which expressed an interest using ryu.controller.handler.set_ev_cls. OpenFlow event classes are
subclasses of the following class.
class ryu.controller.ofp_event.EventOFPMsgBase(msg)
The base class of OpenFlow event class.
OpenFlow event classes have at least the following attributes.

Attribute Description
msg An object which describes the corresponding OpenFlow message.
msg.datapath A ryu.controller.controller.Datapath instance which describes an OpenFlow switch from
which we received this OpenFlow message.
timestamp Timestamp when Datapath instance generated this event.

The msg object has some more additional members whose values are extracted from the original OpenFlow
message.
See OpenFlow protocol API Reference for more info about OpenFlow messages.

2.3.6 ryu.base.app_manager.RyuApp

See Ryu API Reference.

2.3. Ryu application API 11

ryu Documentation, Release 4.34

2.3.7 ryu.controller.handler.set_ev_cls

ryu.controller.handler.set_ev_cls(ev_cls, dispatchers=None)
A decorator for Ryu application to declare an event handler.
Decorated method will become an event handler. ev_cls is an event class whose instances this RyuApp wants
to receive. dispatchers argument specifies one of the following negotiation phases (or a list of them) for which
events should be generated for this handler. Note that, in case an event changes the phase, the phase before the
change is used to check the interest.

Negotiation phase Description

ryu.controller.handler.HANDSHAKE_DISPATCHER Sending and waiting for hello message
ryu.controller.handler.CONFIG_DISPATCHER Version negotiated and sent features-request
message
ryu.controller.handler.MAIN_DISPATCHER Switch-features message received and sent
set-config message
ryu.controller.handler.DEAD_DISPATCHER Disconnect from the peer. Or disconnecting due to
some unrecoverable errors.

2.3.8 ryu.controller.controller.Datapath

class ryu.controller.controller.Datapath(socket, address)

A class to describe an OpenFlow switch connected to this controller.
An instance has the following attributes.

Attribute Description
id 64-bit OpenFlow Datapath ID. Only available for
ryu.controller.handler.MAIN_DISPATCHER phase.
ofproto A module which exports OpenFlow definitions, mainly constants
appeared in the specification, for the negotiated OpenFlow version.
For example, ryu.ofproto.ofproto_v1_0 for OpenFlow 1.0.
ofproto_parser A module which exports OpenFlow wire message encoder and
decoder for the negotiated OpenFlow version. For example,
ryu.ofproto.ofproto_v1_0_parser for OpenFlow 1.0.
ofproto_parser.OFPxxxx(datapath,...) A callable to prepare an OpenFlow message for the given switch. It
can be sent with Datapath.send_msg later. xxxx is a name of the
message. For example OFPFlowMod for flow-mod message.
Arguemnts depend on the message.
set_xid(self, msg) Generate an OpenFlow XID and put it in msg.xid.
send_msg(self, msg) Queue an OpenFlow message to send to the corresponding switch.
If msg.xid is None, set_xid is automatically called on the message
before queueing.
send_packet_out deprecated
send_flow_mod deprecated
send_flow_del deprecated
send_delete_all_flows deprecated
send_barrier Queue an OpenFlow barrier message to send to the switch.
send_nxt_set_flow_format deprecated
is_reserved_port deprecated

12 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

2.3.9 ryu.controller.event.EventBase

class ryu.controller.event.EventBase
The base of all event classes.
A Ryu application can define its own event type by creating a subclass.

2.3.10 ryu.controller.event.EventRequestBase

class ryu.controller.event.EventRequestBase
The base class for synchronous request for RyuApp.send_request.

2.3.11 ryu.controller.event.EventReplyBase

class ryu.controller.event.EventReplyBase(dst)
The base class for synchronous request reply for RyuApp.send_reply.

2.3.12 ryu.controller.ofp_event.EventOFPStateChange

class ryu.controller.ofp_event.EventOFPStateChange(dp)
An event class for negotiation phase change notification.
An instance of this class is sent to observer after changing the negotiation phase. An instance has at least the
following attributes.

Attribute Description
datapath ryu.controller.controller.Datapath instance of the switch

2.3.13 ryu.controller.ofp_event.EventOFPPortStateChange

class ryu.controller.ofp_event.EventOFPPortStateChange(dp, reason, port_no)

An event class to notify the port state changes of Dtatapath instance.
This event performs like EventOFPPortStatus, but Ryu will send this event after updating ports dict of Data-
path instances. An instance has at least the following attributes.

Attribute Description
datapath ryu.controller.controller.Datapath instance of the switch
reason one of OFPPR_*
port_no Port number which state was changed

2.3.14 ryu.controller.dpset.EventDP

class ryu.controller.dpset.EventDP(dp, enter_leave)

An event class to notify connect/disconnect of a switch.
For OpenFlow switches, one can get the same notification by observing
ryu.controller.ofp_event.EventOFPStateChange. An instance has at least the following attributes.

2.3. Ryu application API 13

ryu Documentation, Release 4.34

Attribute Description
dp A ryu.controller.controller.Datapath instance of the switch
enter True when the switch connected to our controller. False for disconnect.
ports A list of port instances.

2.3.15 ryu.controller.dpset.EventPortAdd

class ryu.controller.dpset.EventPortAdd(dp, port)

An event class for switch port status "ADD" notification.
This event is generated when a new port is added to a switch. For OpenFlow switches, one can get the same
notification by observing ryu.controller.ofp_event.EventOFPPortStatus. An instance has at least the following
attributes.

Attribute Description
dp A ryu.controller.controller.Datapath instance of the switch
port port number

2.3.16 ryu.controller.dpset.EventPortDelete

class ryu.controller.dpset.EventPortDelete(dp, port)

An event class for switch port status "DELETE" notification.
This event is generated when a port is removed from a switch. For OpenFlow switches, one can get the same
notification by observing ryu.controller.ofp_event.EventOFPPortStatus. An instance has at least the following
attributes.

Attribute Description
dp A ryu.controller.controller.Datapath instance of the switch
port port number

2.3.17 ryu.controller.dpset.EventPortModify

class ryu.controller.dpset.EventPortModify(dp, new_port)

An event class for switch port status "MODIFY" notification.
This event is generated when some attribute of a port is changed. For OpenFlow switches, one can get the same
notification by observing ryu.controller.ofp_event.EventOFPPortStatus. An instance has at least the following
attributes.

Attribute Description
dp A ryu.controller.controller.Datapath instance of the switch
port port number

2.3.18 ryu.controller.network.EventNetworkPort

class ryu.controller.network.EventNetworkPort(network_id, dpid, port_no, add_del)

An event class for notification of port arrival and deperture.

14 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

This event is generated when a port is introduced to or removed from a network by the REST API. An instance
has at least the following attributes.

Attribute Description
network_id Network ID
dpid OpenFlow Datapath ID of the switch to which the port belongs.
port_no OpenFlow port number of the port
add_del True for adding a port. False for removing a port.

2.3.19 ryu.controller.network.EventNetworkDel

class ryu.controller.network.EventNetworkDel(network_id)
An event class for network deletion.
This event is generated when a network is deleted by the REST API. An instance has at least the following
attributes.

Attribute Description
network_id Network ID

2.3.20 ryu.controller.network.EventMacAddress

class ryu.controller.network.EventMacAddress(dpid, port_no, network_id, mac_address,

add_del)
An event class for end-point MAC address registration.
This event is generated when a end-point MAC address is updated by the REST API. An instance has at least
the following attributes.

Attribute Description
network_id Network ID
dpid OpenFlow Datapath ID of the switch to which the port belongs.
port_no OpenFlow port number of the port
mac_address The old MAC address of the port if add_del is False. Otherwise the new MAC address.
add_del False if this event is a result of a port removal. Otherwise True.

2.3.21 ryu.controller.tunnels.EventTunnelKeyAdd

class ryu.controller.tunnels.EventTunnelKeyAdd(network_id, tunnel_key)

An event class for tunnel key registration.
This event is generated when a tunnel key is registered or updated by the REST API. An instance has at least
the following attributes.

Attribute Description
network_id Network ID
tunnel_key Tunnel Key

2.3. Ryu application API 15

ryu Documentation, Release 4.34

2.3.22 ryu.controller.tunnels.EventTunnelKeyDel

class ryu.controller.tunnels.EventTunnelKeyDel(network_id, tunnel_key)

An event class for tunnel key registration.
This event is generated when a tunnel key is removed by the REST API. An instance has at least the following
attributes.

Attribute Description
network_id Network ID
tunnel_key Tunnel Key

2.3.23 ryu.controller.tunnels.EventTunnelPort

class ryu.controller.tunnels.EventTunnelPort(dpid, port_no, remote_dpid, add_del)

An event class for tunnel port registration.
This event is generated when a tunnel port is added or removed by the REST API. An instance has at least the
following attributes.

Attribute Description
dpid OpenFlow Datapath ID
port_no OpenFlow port number
remote_dpid OpenFlow port number of the tunnel peer
add_del True for adding a tunnel. False for removal.

2.4 Library

Ryu provides some useful library for your network applications.

2.4.1 Packet library

Introduction

Ryu packet library helps you to parse and build various protocol packets. dpkt is the popular library for the same
purpose, however it is not designed to handle protocols that are interleaved; vlan, mpls, gre, etc. So we implemented
our own packet library.

Network Addresses

Unless otherwise specified, MAC/IPv4/IPv6 addresses are specified using human readable strings for this library. For
example, ’08:60:6e:7f:74:e7’, ’192.0.2.1’, ’fe80::a60:6eff:fe7f:74e7’.

Parsing Packet

First, let’s look at how we can use the library to parse the received packets in a handler for OFPPacketIn messages.

16 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

from ryu.lib.packet import packet

@handler.set_ev_cls(ofp_event.EventOFPPacketIn, handler.MAIN_DISPATCHER)
def packet_in_handler(self, ev):
pkt = packet.Packet(array.array('B', ev.msg.data))
for p in pkt.protocols:
print p

You can create a Packet class instance with the received raw data. Then the packet library parses the data and creates
protocol class instances included the data. The packet class ’protocols’ has the protocol class instances.
If a TCP packet is received, something like the following is printed:
<ryu.lib.packet.ethernet.ethernet object at 0x107a5d790>
<ryu.lib.packet.vlan.vlan object at 0x107a5d7d0>
<ryu.lib.packet.ipv4.ipv4 object at 0x107a5d810>
<ryu.lib.packet.tcp.tcp object at 0x107a5d850>

If vlan is not used, you see something like:

<ryu.lib.packet.ethernet.ethernet object at 0x107a5d790>
<ryu.lib.packet.ipv4.ipv4 object at 0x107a5d810>
<ryu.lib.packet.tcp.tcp object at 0x107a5d850>

You can access to a specific protocol class instance by using the packet class iterator. Let’s try to check VLAN id if
VLAN is used:
from ryu.lib.packet import packet

@handler.set_ev_cls(ofp_event.EventOFPPacketIn, handler.MAIN_DISPATCHER)
def packet_in_handler(self, ev):
pkt = packet.Packet(array.array('B', ev.msg.data))
for p in pkt:
print p.protocol_name, p
if p.protocol_name == 'vlan':
print 'vid = ', p.vid

You see something like:

ethernet <ryu.lib.packet.ethernet.ethernet object at 0x107a5d790>
vlan <ryu.lib.packet.vlan.vlan object at 0x107a5d7d0>
vid = 10
ipv4 <ryu.lib.packet.ipv4.ipv4 object at 0x107a5d810>
tcp <ryu.lib.packet.tcp.tcp object at 0x107a5d850>

Building Packet

You need to create protocol class instances that you want to send, add them to a packet class instance via add_protocol
method, and then call serialize method. You have the raw data to send. The following example is building an arp
packet.
from ryu.ofproto import ether
from ryu.lib.packet import ethernet, arp, packet

e = ethernet.ethernet(dst='ff:ff:ff:ff:ff:ff',
src='08:60:6e:7f:74:e7',
(continues on next page)

2.4. Library 17
ryu Documentation, Release 4.34

(continued from previous page)

ethertype=ether.ETH_TYPE_ARP)
a = arp.arp(hwtype=1, proto=0x0800, hlen=6, plen=4, opcode=2,
src_mac='08:60:6e:7f:74:e7', src_ip='192.0.2.1',
dst_mac='00:00:00:00:00:00', dst_ip='192.0.2.2')
p = packet.Packet()
p.add_protocol(e)
p.add_protocol(a)
p.serialize()
print repr(p.data) # the on-wire packet

2.4.2 Packet library API Reference

Packet class

class ryu.lib.packet.packet.Packet(data=None, protocols=None, parse_cls=<class

’ryu.lib.packet.ethernet.ethernet’>)
A packet decoder/encoder class.
An instance is used to either decode or encode a single packet.
data is a bytearray to describe a raw datagram to decode. When decoding, a Packet object is iteratable. Iterated
values are protocol (ethernet, ipv4, ...) headers and the payload. Protocol headers are instances of subclass of
packet_base.PacketBase. The payload is a bytearray. They are iterated in on-wire order.
data should be omitted when encoding a packet.
add_protocol(proto)
Register a protocol proto for this packet.
This method is legal only when encoding a packet.
When encoding a packet, register a protocol (ethernet, ipv4, ...) header to add to this packet. Protocol
headers should be registered in on-wire order before calling self.serialize.
classmethod from_jsondict(dict_, decode_string=<function b64decode>, **additional_args)
Create an instance from a JSON style dict.
Instantiate this class with parameters specified by the dict.
This method takes the following arguments.

Argument Descrpition
dict_ A dictionary which describes the parameters. For example, {"Param1": 100,
"Param2": 200}
decode_string (Optional) specify how to decode strings. The default is base64. This argument is
used only for attributes which don’t have explicit type annotations in _TYPE class
attribute.
additional_args (Optional) Additional kwargs for constructor.

get_protocol(protocol)
Returns the firstly found protocol that matches to the specified protocol.
get_protocols(protocol)
Returns a list of protocols that matches to the specified protocol.
serialize()
Encode a packet and store the resulted bytearray in self.data.

18 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

This method is legal only when encoding a packet.

Stream Parser class

class ryu.lib.packet.stream_parser.StreamParser
Streaming parser base class.
An instance of a subclass of this class is used to extract messages from a raw byte stream.
It’s designed to be used for data read from a transport which doesn’t preserve message boundaries. A typical
example of such a transport is TCP.
exception TooSmallException
parse(data)
Tries to extract messages from a raw byte stream.
The data argument would be python bytes newly read from the input stream.
Returns an ordered list of extracted messages. It can be an empty list.
The rest of data which doesn’t produce a complete message is kept internally and will be used when more
data is come. I.e. next time this method is called again.
try_parse(q)
Try to extract a message from the given bytes.
This is an override point for subclasses.
This method tries to extract a message from bytes given by the argument.
Raises TooSmallException if the given data is not enough to extract a complete message but there’s still a
chance to extract a message if more data is come later.
List of the sub-classes:
• ryu.lib.packet.bgp.StreamParser

Protocol Header classes

Packet Base Class

class ryu.lib.packet.packet_base.PacketBase
A base class for a protocol (ethernet, ipv4, ...) header.
classmethod get_packet_type(type_)
Per-protocol dict-like get method.
Provided for convenience of protocol implementers. Internal use only.
classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.

2.4. Library 19
ryu Documentation, Release 4.34

classmethod register_packet_type(cls_, type_)

Per-protocol dict-like set method.
Provided for convenience of protocol implementers. Internal use only.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.

ARP

class ryu.lib.packet.arp.arp(hwtype=1, proto=2048, hlen=6, plen=4, opcode=1,

src_mac=’ff:ff:ff:ff:ff:ff’, src_ip=’0.0.0.0’, dst_mac=’ff:ff:ff:ff:ff:ff’,
dst_ip=’0.0.0.0’)
ARP (RFC 826) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. IPv4 addresses are represented as a string like ’192.0.2.1’. MAC addresses are represented as a
string like ’08:60:6e:7f:74:e7’. __init__ takes the corresponding args in this order.

Attribute Description Example

hwtype Hardware address.
proto Protocol address.
hlen byte length of each hardware address.
plen byte length of each protocol address.
opcode operation codes.
src_mac Hardware address of sender. ’08:60:6e:7f:74:e7’
src_ip Protocol address of sender. ’192.0.2.1’
dst_mac Hardware address of target. ’00:00:00:00:00:00’
dst_ip Protocol address of target. ’192.0.2.2’

20 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
ryu.lib.packet.arp.arp_ip(opcode, src_mac, src_ip, dst_mac, dst_ip)
A convenient wrapper for IPv4 ARP for Ethernet.
This is an equivalent of the following code.
arp(ARP_HW_TYPE_ETHERNET, ether.ETH_TYPE_IP, 6, 4, opcode, src_mac, src_ip, dst_mac,
dst_ip)

BFD

BFD Control packet parser/serializer

[RFC 5880] BFD Control packet format:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|Vers | Diag |Sta|P|F|C|A|D|M| Detect Mult | Length |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| My Discriminator |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Your Discriminator |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Desired Min TX Interval |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Required Min RX Interval |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Required Min Echo RX Interval |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

An optional Authentication Section MAY be present in the following format of types:

1. Format of Simple Password Authentication Section:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Auth Type | Auth Len | Auth Key ID | Password... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| ... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

2. Format of Keyed MD5 and Meticulous Keyed MD5 Authentication Section:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Auth Type | Auth Len | Auth Key ID | Reserved |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sequence Number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Auth Key/Digest... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
(continues on next page)

2.4. Library 21
ryu Documentation, Release 4.34

(continued from previous page)

| ... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

3. Format of Keyed SHA1 and Meticulous Keyed SHA1 Authentication Section:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Auth Type | Auth Len | Auth Key ID | Reserved |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sequence Number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Auth Key/Hash... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| ... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

class ryu.lib.packet.bfd.BFDAuth(auth_len=None)
Base class of BFD (RFC 5880) Authentication Section
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order.

Attribute Description
auth_type The authentication type in use.
auth_len The length, in bytes, of the authentication section, including the auth_type and auth_len
fields.

classmethod parser_hdr(buf )
Parser for common part of authentication section.
serialize_hdr()
Serialization function for common part of authentication section.
class ryu.lib.packet.bfd.KeyedMD5(auth_key_id, seq, auth_key=None, digest=None,
auth_len=None)
BFD (RFC 5880) Keyed MD5 Authentication Section class
An instance has the following attributes. Most of them are same to the on-wire counterparts but in host byte
order.

Attribute Description
auth_type (Fixed) The authentication type in use.
auth_key_id The authentication Key ID in use.
seq The sequence number for this packet. This value is incremented occasionally.
auth_key The shared MD5 key for this packet.
digest (Optional) The 16-byte MD5 digest for the packet.
auth_len (Fixed) The length of the authentication section is 24 bytes.

authenticate(prev, auth_keys=None)
Authenticate the MD5 digest for this packet.
This method can be invoked only when self.digest is defined.
Returns a boolean indicates whether the digest can be authenticated by the correspondent Auth Key or not.

22 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

prev is a bfd instance for the BFD Control header which this authentication section belongs to. It’s
necessary to be assigned because an MD5 digest must be calculated over the entire BFD Control packet.
auth_keys is a dictionary of authentication key chain which key is an integer of Auth Key ID and value
is a string of Auth Key.
serialize(payload, prev)
Encode a Keyed MD5 Authentication Section.
This method is used only when encoding an BFD Control packet.
payload is the rest of the packet which will immediately follow this section.
prev is a bfd instance for the BFD Control header which this authentication section belongs to. It’s
necessary to be assigned because an MD5 digest must be calculated over the entire BFD Control packet.
class ryu.lib.packet.bfd.KeyedSHA1(auth_key_id, seq, auth_key=None, auth_hash=None,
auth_len=None)
BFD (RFC 5880) Keyed SHA1 Authentication Section class
An instance has the following attributes. Most of them are same to the on-wire counterparts but in host byte
order.

Attribute Description
auth_type (Fixed) The authentication type in use.
auth_key_id The authentication Key ID in use.
seq The sequence number for this packet. This value is incremented occasionally.
auth_key The shared SHA1 key for this packet.
auth_hash (Optional) The 20-byte SHA1 hash for the packet.
auth_len (Fixed) The length of the authentication section is 28 bytes.

authenticate(prev, auth_keys=None)
Authenticate the SHA1 hash for this packet.
This method can be invoked only when self.auth_hash is defined.
Returns a boolean indicates whether the hash can be authenticated by the correspondent Auth Key or not.
prev is a bfd instance for the BFD Control header which this authentication section belongs to. It’s
necessary to be assigned because an SHA1 hash must be calculated over the entire BFD Control packet.
auth_keys is a dictionary of authentication key chain which key is an integer of Auth Key ID and value
is a string of Auth Key.
serialize(payload, prev)
Encode a Keyed SHA1 Authentication Section.
This method is used only when encoding an BFD Control packet.
payload is the rest of the packet which will immediately follow this section.
prev is a bfd instance for the BFD Control header which this authentication section belongs to. It’s
necessary to be assigned because an SHA1 hash must be calculated over the entire BFD Control packet.
class ryu.lib.packet.bfd.MeticulousKeyedMD5(auth_key_id, seq, auth_key=None, di-
gest=None, auth_len=None)
BFD (RFC 5880) Meticulous Keyed MD5 Authentication Section class
All methods of this class are inherited from KeyedMD5.
An instance has the following attributes. Most of them are same to the on-wire counterparts but in host byte
order.

2.4. Library 23
ryu Documentation, Release 4.34

Attribute Description
auth_type (Fixed) The authentication type in use.
auth_key_id The authentication Key ID in use.
seq The sequence number for this packet. This value is incremented for each successive packet
transmitted for a session.
auth_key The shared MD5 key for this packet.
digest (Optional) The 16-byte MD5 digest for the packet.
auth_len (Fixed) The length of the authentication section is 24 bytes.

class ryu.lib.packet.bfd.MeticulousKeyedSHA1(auth_key_id, seq, auth_key=None,

auth_hash=None, auth_len=None)
BFD (RFC 5880) Meticulous Keyed SHA1 Authentication Section class
All methods of this class are inherited from KeyedSHA1.
An instance has the following attributes. Most of them are same to the on-wire counterparts but in host byte
order.

Attribute Description
auth_type (Fixed) The authentication type in use.
auth_key_id The authentication Key ID in use.
seq The sequence number for this packet. This value is incremented for each successive packet
transmitted for a session.
auth_key The shared SHA1 key for this packet.
auth_hash (Optional) The 20-byte SHA1 hash for the packet.
auth_len (Fixed) The length of the authentication section is 28 bytes.

class ryu.lib.packet.bfd.SimplePassword(auth_key_id, password, auth_len=None)

BFD (RFC 5880) Simple Password Authentication Section class
An instance has the following attributes. Most of them are same to the on-wire counterparts but in host byte
order.

Attribute Description
auth_type (Fixed) The authentication type in use.
auth_key_id The authentication Key ID in use.
password The simple password in use on this session. The password is a binary string, and MUST be
from 1 to 16 bytes in length.
auth_len The length, in bytes, of the authentication section, including the auth_type and
auth_len fields.

authenticate(prev=None, auth_keys=None)
Authenticate the password for this packet.
This method can be invoked only when self.password is defined.
Returns a boolean indicates whether the password can be authenticated or not.
prev is a bfd instance for the BFD Control header. It’s not necessary for authenticating the Simple
Password.
auth_keys is a dictionary of authentication key chain which key is an integer of Auth Key ID and value
is a string of Password.
serialize(payload, prev)
Encode a Simple Password Authentication Section.

24 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

payload is the rest of the packet which will immediately follow this section.
prev is a bfd instance for the BFD Control header. It’s not necessary for encoding only the Simple
Password section.
class ryu.lib.packet.bfd.bfd(ver=1, diag=0, state=0, flags=0, detect_mult=0,
my_discr=0, your_discr=0, desired_min_tx_interval=0, re-
quired_min_rx_interval=0, required_min_echo_rx_interval=0,
auth_cls=None, length=None)
BFD (RFC 5880) Control packet encoder/decoder class.
The serialized packet would looks like the ones described in the following sections.
• RFC 5880 Generic BFD Control Packet Format
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order.
__init__ takes the corresponding args in this order.

Attribute Description
ver The version number of the protocol. This class implements protocol
version 1.
diag A diagnostic code specifying the local system’s reason for the last
change in session state.
state The current BFD session state as seen by the transmitting system.
flags Bitmap of the following flags.

BFD_FLAG_POLL
BFD_FLAG_FINAL
BFD_FLAG_CTRL_PLANE_INDEP
BFD_FLAG_AUTH_PRESENT
BFD_FLAG_DEMAND
BFD_FLAG_MULTIPOINT

detect_mult Detection time multiplier.

my_discr My Discriminator.
your_discr Your Discriminator.
desired_min_tx_interval Desired Min TX Interval. (in microseconds)
required_min_rx_interval Required Min RX Interval. (in microseconds)
required_min_echo_rx_interval Required Min Echo RX Interval. (in microseconds)
auth_cls (Optional) Authentication Section instance. It’s defined only when the
Authentication Present (A) bit is set in flags. Assign an instance of the
following classes: SimplePassword, KeyedMD5,
MeticulousKeyedMD5, KeyedSHA1, and
MeticulousKeyedSHA1.
length (Optional) Length of the BFD Control packet, in bytes.

authenticate(*args, **kwargs)
Authenticate this packet.
Returns a boolean indicates whether the packet can be authenticated or not.
Returns False if the Authentication Present (A) is not set in the flag of this packet.
Returns False if the Authentication Section for this packet is not present.

2.4. Library 25
ryu Documentation, Release 4.34

For the description of the arguemnts of this method, refer to the authentication method of the Authentica-
tion Section classes.
pack()
Encode a BFD Control packet without authentication section.
classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.

BGP

RFC 4271 BGP-4

exception ryu.lib.packet.bgp.AdminReset(data=”)
exception ryu.lib.packet.bgp.AdminShutdown(data=”)
Error to indicate Administrative shutdown.
RFC says: If a BGP speaker decides to administratively shut down its peering with a neighbor, then the speaker
SHOULD send a NOTIFICATION message with the Error Code Cease and the Error Subcode ’Administrative
Shutdown’.
exception ryu.lib.packet.bgp.AttrFlagError(data=”)
Error to indicate recognized path attributes have incorrect flags.
RFC says: If any recognized attribute has Attribute Flags that conflict with the Attribute Type Code, then the
Error Subcode MUST be set to Attribute Flags Error. The Data field MUST contain the erroneous attribute
(type, length, and value).
exception ryu.lib.packet.bgp.AttrLenError(data=”)
exception ryu.lib.packet.bgp.AuthFailure(data=”)
class ryu.lib.packet.bgp.BGPEvpnEsImportRTExtendedCommunity(**kwargs)
ES-Import Route Target Extended Community
class ryu.lib.packet.bgp.BGPEvpnEsiLabelExtendedCommunity(label=None,
mpls_label=None,
vni=None, **kwargs)
ESI Label Extended Community

26 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.BGPEvpnMacMobilityExtendedCommunity(**kwargs)
MAC Mobility Extended Community
class ryu.lib.packet.bgp.BGPFlowSpecRedirectCommunity(**kwargs)
Flow Specification Traffic Filtering Actions for Redirect.

Attribute Description
as_number Autonomous System number.
local_administrator Local Administrator.

class ryu.lib.packet.bgp.BGPFlowSpecTPIDActionCommunity(**kwargs)
Flow Specification TPID Actions.

At- Description
tribute
actions Bit representation of actions. Supported actions are TI(inner TPID action) and
TO(outer TPID action).
tpid_1 TPID used by TI.
tpid_2 TPID used by TO.

class ryu.lib.packet.bgp.BGPFlowSpecTrafficActionCommunity(**kwargs)
Flow Specification Traffic Filtering Actions for Traffic Action.

Attribute Description
action Apply action. The supported action are SAMPLE and TERMINAL.

class ryu.lib.packet.bgp.BGPFlowSpecTrafficMarkingCommunity(**kwargs)
Flow Specification Traffic Filtering Actions for Traffic Marking.

Attribute Description
dscp Differentiated Services Code Point.

class ryu.lib.packet.bgp.BGPFlowSpecTrafficRateCommunity(**kwargs)
Flow Specification Traffic Filtering Actions for Traffic Rate.

Attribute Description
as_number Autonomous System number.
rate_info rate information.

class ryu.lib.packet.bgp.BGPFlowSpecVlanActionCommunity(**kwargs)
Flow Specification Vlan Actions.

At- Description
tribute
ac- Bit representation of actions. Supported actions are POP, PUSH, SWAP, REWRITE_INNER,
tions_1 REWRITE_OUTER.
ac- Same as actions_1.
tions_2
vlan_1 VLAN ID used by actions_1.
cos_1 Class of Service used by actions_1.
vlan_2 VLAN ID used by actions_2.
cos_2 Class of Service used by actions_2.

2.4. Library 27
ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.BGPKeepAlive(type_=4, len_=None, marker=None)

BGP-4 KEEPALIVE Message encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
marker Marker field. Ignored when encoding.
len Length field. Ignored when encoding.
type Type field.

Attribute Description
marker Marker field. Ignored when encoding.
len Length field. Ignored when encoding.
type Type field. one of BGP_MSG_* constants.

28 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.BGPNotification(error_code, error_subcode, data=b”, type_=3,

len_=None, marker=None)
BGP-4 NOTIFICATION Message encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
marker Marker field. Ignored when encoding.
len Length field. Ignored when encoding.
type Type field.
error_code Error code field.
error_subcode Error subcode field.
data Data field.

Attribute Description
marker Marker field. Ignored when encoding.
len Length field. Ignored when encoding.
type Type field.
version Version field.
my_as My Autonomous System field. 2 octet unsigned integer.
hold_time Hold Time field. 2 octet unsigned integer.
bgp_identifier BGP Identifier field. An IPv4 address. For example, ’192.0.2.1’
opt_param_len Optional Parameters Length field. Ignored when encoding.
opt_param Optional Parameters field. A list of BGPOptParam instances. The default is [].

2.4. Library 29
ryu Documentation, Release 4.34

• The rest of packet.

class ryu.lib.packet.bgp.BGPPathAttributePmsiTunnel(pmsi_flags, tunnel_type,
mpls_label=None, label=None,
vni=None, tunnel_id=None,
flags=0, type_=None,
length=None)
P-Multicast Service Interface Tunnel (PMSI Tunnel) attribute
classmethod from_jsondict(dict_, decode_string=<function b64decode>, **additional_args)
Create an instance from a JSON style dict.
Instantiate this class with parameters specified by the dict.
This method takes the following arguments.

class ryu.lib.packet.bgp.BGPRouteRefresh(afi, safi, demarcation=0, type_=5, len_=None,

marker=None)
BGP-4 ROUTE REFRESH Message (RFC 2918) encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
marker Marker field. Ignored when encoding.
len Length field. Ignored when encoding.
type Type field.
afi Address Family Identifier
safi Subsequent Address Family Identifier

30 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
marker Marker field. Ignored when encoding.
len Length field. Ignored when encoding.
type Type field.
withdrawn_routes_len Withdrawn Routes Length field. Ignored when encoding.
withdrawn_routes Withdrawn Routes field. A list of BGPWithdrawnRoute instances. The default is
[].
total_path_attribute_len Total Path Attribute Length field. Ignored when encoding.
path_attributes Path Attributes field. A list of BGPPathAttribute instances. The default is [].
nlri Network Layer Reachability Information field. A list of BGPNLRI instances.
The default is [].

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
exception ryu.lib.packet.bgp.BadBgpId(data=”)
Error to indicate incorrect BGP Identifier.
RFC says: If the BGP Identifier field of the OPEN message is syntactically incorrect, then the Error Subcode
MUST be set to Bad BGP Identifier. Syntactic correctness means that the BGP Identifier field represents a valid
unicast IP host address.
exception ryu.lib.packet.bgp.BadLen(msg_type_code, message_length)
exception ryu.lib.packet.bgp.BadMsg(msg_type)
Error to indicate un-recognized message type.
RFC says: If the Type field of the message header is not recognized, then the Error Subcode MUST be set to
Bad Message Type. The Data field MUST contain the erroneous Type field.
exception ryu.lib.packet.bgp.BadNotification(data=”)
exception ryu.lib.packet.bgp.BadPeerAs(data=”)
Error to indicate open message has incorrect AS number.
RFC says: If the Autonomous System field of the OPEN message is unacceptable, then the Error Subcode
MUST be set to Bad Peer AS. The determination of acceptable Autonomous System numbers is configure peer
AS.
exception ryu.lib.packet.bgp.BgpExc(data=”)
Base bgp exception.
CODE = 0
BGP error code.
SEND_ERROR = True
Flag if set indicates Notification message should be sent to peer.
SUB_CODE = 0
BGP error sub-code.

2.4. Library 31
ryu Documentation, Release 4.34

exception ryu.lib.packet.bgp.CollisionResolution(data=”)
Error to indicate Connection Collision Resolution.
RFC says: If a BGP speaker decides to send a NOTIFICATION message with the Error Code Cease as a result of
the collision resolution procedure (as described in [BGP-4]), then the subcode SHOULD be set to "Connection
Collision Resolution".
exception ryu.lib.packet.bgp.ConnRejected(data=”)
Error to indicate Connection Rejected.
RFC says: If a BGP speaker decides to disallow a BGP connection (e.g., the peer is not configured locally) after
the speaker accepts a transport protocol connection, then the BGP speaker SHOULD send a NOTIFICATION
message with the Error Code Cease and the Error Subcode "Connection Rejected".
class ryu.lib.packet.bgp.EvpnASBasedEsi(as_number, local_disc, type_=None)
AS based ESI value
This type indicates an Autonomous System(AS)-based ESI Value that can be auto-generated or configured by
the operator.
class ryu.lib.packet.bgp.EvpnArbitraryEsi(value, type_=None)
Arbitrary 9-octet ESI value
This type indicates an arbitrary 9-octet ESI value, which is managed and configured by the operator.
class ryu.lib.packet.bgp.EvpnEsi(type_=None)
Ethernet Segment Identifier
The supported ESI Types:
• EvpnEsi.ARBITRARY indicates EvpnArbitraryEsi.
• EvpnEsi.LACP indicates EvpnLACPEsi.
• EvpnEsi.L2_BRIDGE indicates EvpnL2BridgeEsi.
• EvpnEsi.MAC_BASED indicates EvpnMacBasedEsi.
• EvpnEsi.ROUTER_ID indicates EvpnRouterIDEsi.
• EvpnEsi.AS_BASED indicates EvpnASBasedEsi.
class ryu.lib.packet.bgp.EvpnEthernetAutoDiscoveryNLRI(route_dist, esi,
ethernet_tag_id,
mpls_label=None,
vni=None, label=None,
type_=None, length=None)
Ethernet A-D route type specific EVPN NLRI
class ryu.lib.packet.bgp.EvpnEthernetSegmentNLRI(route_dist, esi, ip_addr,
ip_addr_len=None, type_=None,
length=None)
Ethernet Segment route type specific EVPN NLRI
class ryu.lib.packet.bgp.EvpnInclusiveMulticastEthernetTagNLRI(route_dist, eth-
ernet_tag_id,
ip_addr,
ip_addr_len=None,
type_=None,
length=None)
Inclusive Multicast Ethernet Tag route type specific EVPN NLRI

32 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.EvpnIpPrefixNLRI(route_dist, ethernet_tag_id, ip_prefix,

esi=None, gw_ip_addr=None,
mpls_label=None, vni=None, label=None,
type_=None, length=None)
IP Prefix advertisement route NLRI
class ryu.lib.packet.bgp.EvpnL2BridgeEsi(mac_addr, priority, type_=None)
ESI value for Layer 2 Bridge
This type is used in the case of indirectly connected hosts via a bridged LAN between the CEs and the PEs. The
ESI Value is auto-generated and determined based on the Layer 2 bridge protocol.
class ryu.lib.packet.bgp.EvpnLACPEsi(mac_addr, port_key, type_=None)
ESI value for LACP
When IEEE 802.1AX LACP is used between the PEs and CEs, this ESI type indicates an auto-generated ESI
value determined from LACP.
class ryu.lib.packet.bgp.EvpnMacBasedEsi(mac_addr, local_disc, type_=None)
MAC-based ESI Value
This type indicates a MAC-based ESI Value that can be auto-generated or configured by the operator.
class ryu.lib.packet.bgp.EvpnMacIPAdvertisementNLRI(route_dist, ethernet_tag_id,
mac_addr, ip_addr,
esi=None, mpls_labels=None,
vni=None, labels=None,
mac_addr_len=None,
ip_addr_len=None,
type_=None, length=None)
MAC/IP Advertisement route type specific EVPN NLRI
class ryu.lib.packet.bgp.EvpnNLRI(type_=None, length=None)
BGP Network Layer Reachability Information (NLRI) for EVPN
class ryu.lib.packet.bgp.EvpnRouterIDEsi(router_id, local_disc, type_=None)
Router-ID ESI Value
This type indicates a router-ID ESI Value that can be auto-generated or configured by the operator.
class ryu.lib.packet.bgp.EvpnUnknownEsi(value, type_=None)
ESI value for unknown type
class ryu.lib.packet.bgp.EvpnUnknownNLRI(value, type_, length=None)
Unknown route type specific EVPN NLRI
exception ryu.lib.packet.bgp.FiniteStateMachineError(data=”)
Error to indicate any Finite State Machine Error.
RFC says: Any error detected by the BGP Finite State Machine (e.g., receipt of an unexpected event) is indicated
by sending the NOTIFICATION message with the Error Code Finite State Machine Error.
class ryu.lib.packet.bgp.FlowSpecComponentUnknown(buf, type_=None)
Unknown component type for Flow Specification NLRI component
class ryu.lib.packet.bgp.FlowSpecDSCP(operator, value, type_=None)
Diffserv Code Point for Flow Specification NLRI component
Set the 6-bit DSCP field at value. [RFC2474]
class ryu.lib.packet.bgp.FlowSpecDestPort(operator, value, type_=None)
Destination port number for Flow Specification NLRI component
Set the destination port of a TCP or UDP packet at value.

2.4. Library 33
ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.FlowSpecDestPrefix(length, addr, type_=None)

Destination Prefix for Flow Specification NLRI component
class ryu.lib.packet.bgp.FlowSpecDestinationMac(length, addr, type_=None)
Destination Mac Address.
Set the Mac Address at value.
class ryu.lib.packet.bgp.FlowSpecEtherType(operator, value, type_=None)
Ethernet Type field in an Ethernet frame.
Set the 2 byte value of an Ethernet Type field at value.
class ryu.lib.packet.bgp.FlowSpecFragment(operator, value, type_=None)
Fragment for Flow Specification NLRI component
Set the bitmask for operand format at value. The following values are supported.

Attribute Description
LF Last fragment
FF First fragment
ISF Is a fragment
DF Don’t fragment

class ryu.lib.packet.bgp.FlowSpecIPProtocol(operator, value, type_=None)

IP Protocol for Flow Specification NLRI component
Set the IP protocol number at value.
class ryu.lib.packet.bgp.FlowSpecIPv4NLRI(length=0, rules=None)
Flow Specification NLRI class for IPv4 [RFC 5575]
classmethod from_user(**kwargs)
Utility method for creating a NLRI instance.
This function returns a NLRI instance from human readable format value.
Parameters kwargs – The following arguments are available.

34 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Argu- Value Op- Description

ment era-
tor
dst_prefixIPv4 Noth- Destination Prefix.
Prefix ing
src_prefixIPv4 Noth- Source Prefix.
Prefix ing
ip_proto Integer Nu- IP Protocol.
meric
port Integer Nu- Port number.
meric
dst_port Integer Nu- Destination port number.
meric
src_port Integer Nu- Source port number.
meric
icmp_typeInteger Nu- ICMP type.
meric
icmp_codeInteger Nu- ICMP code.
meric
tcp_flags Fixed Bit- TCP flags. Supported values are CWR, ECN, URGENT, ACK, PUSH, RST,
string mask SYN and FIN.
packet_lenInteger Nu- Packet length.
meric
dscp Integer Nu- Differentiated Services Code Point.
meric
frag- Fixed Bit- Fragment. Supported values are DF (Don’t fragment), ISF (Is a frag-
ment string mask ment), FF (First fragment) and LF (Last fragment)

Example:

>>> msg = bgp.FlowSpecIPv4NLRI.from_user(

... dst_prefix='10.0.0.0/24',
... src_prefix='20.0.0.1/24',
... ip_proto=6,
... port='80 | 8000',
... dst_port='>9000 & <9050',
... src_port='>=8500 & <=9000',
... icmp_type=0,
... icmp_code=6,
... tcp_flags='SYN+ACK & !=URGENT',
... packet_len=1000,
... dscp='22 | 24',
... fragment='LF | ==FF')
>>>

You can specify conditions with the following keywords.

The following keywords can be used when the operator type is Numeric.

2.4. Library 35
ryu Documentation, Release 4.34

Keyword Description
< Less than comparison between data and value.
<= Less than or equal to comparison between data and value.
> Greater than comparison between data and value.
>= Greater than or equal to comparison between data and value.
== Equality between data and value. This operator can be omitted.

The following keywords can be used when the operator type is Bitmask.

Keyword Description
!= Not equal operation.
== Exact match operation if specified. Otherwise partial match operation.
+ Used for the summation of bitmask values. (e.g., SYN+ACK)

You can combine the multiple conditions with the following operators.

Keyword Description
| Logical OR operation
& Logical AND operation

Returns A instance of FlowSpecVPNv4NLRI.

class ryu.lib.packet.bgp.FlowSpecIPv6DestPrefix(length, addr, offset=0, type_=None)

IPv6 destination Prefix for Flow Specification NLRI component
class ryu.lib.packet.bgp.FlowSpecIPv6FlowLabel(operator, value, type_=None)
class ryu.lib.packet.bgp.FlowSpecIPv6Fragment(operator, value, type_=None)
Fragment for Flow Specification for IPv6 NLRI component

Attribute Description
LF Last fragment
FF First fragment
ISF Is a fragment

class ryu.lib.packet.bgp.FlowSpecIPv6NLRI(length=0, rules=None)

Flow Specification NLRI class for IPv6 [RFC draft-ietf-idr-flow-spec-v6-08]
classmethod from_user(**kwargs)
Utility method for creating a NLRI instance.
This function returns a NLRI instance from human readable format value.
Parameters kwargs – The following arguments are available.

36 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Argu- Value Oper- Description

ment ator
dst_prefix IPv6 Noth- Destination Prefix.
Prefix ing
src_prefix IPv6 Noth- Source Prefix.
Prefix ing
next_headerInteger Nu- Next Header.
meric
port Integer Nu- Port number.
meric
dst_port Integer Nu- Destination port number.
meric
src_port Integer Nu- Source port number.
meric
icmp_type Integer Nu- ICMP type.
meric
icmp_code Integer Nu- ICMP code.
meric
tcp_flags Fixed Bit- TCP flags. Supported values are CWR, ECN, URGENT, ACK, PUSH,
string mask RST, SYN and FIN.
packet_len Integer Nu- Packet length.
meric
dscp Integer Nu- Differentiated Services Code Point.
meric
frag- Fixed Bit- Fragment. Supported values are ISF (Is a fragment), FF (First frag-
ment string mask ment) and LF (Last fragment)
flow_label Intefer Nu- Flow Label.
meric

Note: For dst_prefix and src_prefix, you can give "offset" value like this: 2001::2/128/32.
At this case, offset is 32. offset can be omitted, then offset is treated as 0.

class ryu.lib.packet.bgp.FlowSpecIPv6SrcPrefix(length, addr, offset=0, type_=None)

IPv6 source Prefix for Flow Specification NLRI component
class ryu.lib.packet.bgp.FlowSpecIcmpCode(operator, value, type_=None)
ICMP code Flow Specification NLRI component
Set the code field of an ICMP packet at value.
class ryu.lib.packet.bgp.FlowSpecIcmpType(operator, value, type_=None)
ICMP type for Flow Specification NLRI component
Set the type field of an ICMP packet at value.
class ryu.lib.packet.bgp.FlowSpecInnerVLANCoS(operator, value, type_=None)
VLAN CoS Fields in an Inner Ethernet frame.
Set the 3 bit CoS field at value..
class ryu.lib.packet.bgp.FlowSpecInnerVLANID(operator, value, type_=None)
Inner VLAN ID.
Set VLAN ID at value.

2.4. Library 37
ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.FlowSpecL2VPNNLRI(length=0, route_dist=None, rules=None)

Flow Specification NLRI class for L2VPN [draft-ietf-idr-flowspec-l2vpn-05]
classmethod from_user(route_dist, **kwargs)
Utility method for creating a L2VPN NLRI instance.
This function returns a L2VPN NLRI instance from human readable format value.
Parameters kwargs – The following arguments are available.

Argument Value Operator Description

ether_type Integer Numeric Ethernet Type.
src_mac Mac Address Nothing Source Mac address.
dst_mac Mac Address Nothing Destination Mac address.
llc_ssap Integer Numeric Source Service Access Point in LLC.
llc_dsap Integer Numeric Destination Service Access Point in LLC.
llc_control Integer Numeric Control field in LLC.
snap Integer Numeric Sub-Network Access Protocol field.
vlan_id Integer Numeric VLAN ID.
vlan_cos Integer Numeric VLAN COS field.
inner_vlan_id Integer Numeric Inner VLAN ID.
inner_vlan_cos Integer Numeric Inner VLAN COS field.

class ryu.lib.packet.bgp.FlowSpecLLCControl(operator, value, type_=None)

Control field in LLC header in an Ethernet frame.
Set the Contorol field at value.
class ryu.lib.packet.bgp.FlowSpecLLCDSAP(operator, value, type_=None)
Destination SAP field in LLC header in an Ethernet frame.
Set the 2 byte value of an Destination SAP at value.
class ryu.lib.packet.bgp.FlowSpecLLCSSAP(operator, value, type_=None)
Source SAP field in LLC header in an Ethernet frame.
Set the 2 byte value of an Source SAP at value.
class ryu.lib.packet.bgp.FlowSpecNextHeader(operator, value, type_=None)
Next Header value in IPv6 packets
Set the IP protocol number at value
class ryu.lib.packet.bgp.FlowSpecPacketLen(operator, value, type_=None)
Packet length for Flow Specification NLRI component
Set the total IP packet length at value.
class ryu.lib.packet.bgp.FlowSpecPort(operator, value, type_=None)
Port number for Flow Specification NLRI component
Set the source or destination TCP/UDP ports at value.
class ryu.lib.packet.bgp.FlowSpecSNAP(operator, value, type_=None)
Sub-Network Access Protocol field in an Ethernet frame.
Set the 5 byte SNAP field at value.
class ryu.lib.packet.bgp.FlowSpecSourceMac(length, addr, type_=None)
Source Mac Address.
Set the Mac Address at value.

38 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.FlowSpecSrcPort(operator, value, type_=None)

Source port number for Flow Specification NLRI component
Set the source port of a TCP or UDP packet at value.
class ryu.lib.packet.bgp.FlowSpecSrcPrefix(length, addr, type_=None)
Source Prefix for Flow Specification NLRI component
class ryu.lib.packet.bgp.FlowSpecTCPFlags(operator, value, type_=None)
TCP flags for Flow Specification NLRI component
Supported TCP flags are CWR, ECN, URGENT, ACK, PUSH, RST, SYN and FIN.
class ryu.lib.packet.bgp.FlowSpecVLANCoS(operator, value, type_=None)
VLAN CoS Fields in an Ethernet frame.
Set the 3 bit CoS field at value.
class ryu.lib.packet.bgp.FlowSpecVLANID(operator, value, type_=None)
VLAN ID.
Set VLAN ID at value.
class ryu.lib.packet.bgp.FlowSpecVPNv4NLRI(length=0, route_dist=None, rules=None)
Flow Specification NLRI class for VPNv4 [RFC 5575]
classmethod from_user(route_dist, **kwargs)
Utility method for creating a NLRI instance.
This function returns a NLRI instance from human readable format value.
Parameters
• route_dist – Route Distinguisher.
• kwargs – See ryu.lib.packet.bgp.FlowSpecIPv4NLRI
Example:

>>> msg = bgp.FlowSpecIPv4NLRI.from_user(

... route_dist='65000:1000',
... dst_prefix='10.0.0.0/24',
... src_prefix='20.0.0.1/24',
... ip_proto=6,
... port='80 | 8000',
... dst_port='>9000 & <9050',
... src_port='>=8500 & <=9000',
... icmp_type=0,
... icmp_code=6,
... tcp_flags='SYN+ACK & !=URGENT',
... packet_len=1000,
... dscp='22 | 24',
... fragment='LF | ==FF')
>>>

class ryu.lib.packet.bgp.FlowSpecVPNv6NLRI(length=0, route_dist=None, rules=None)

Flow Specification NLRI class for VPNv6 [draft-ietf-idr-flow-spec-v6-08]
classmethod from_user(route_dist, **kwargs)
Utility method for creating a NLRI instance.
This function returns a NLRI instance from human readable format value.
Parameters

2.4. Library 39
ryu Documentation, Release 4.34

• route_dist – Route Distinguisher.

• kwargs – See ryu.lib.packet.bgp.FlowSpecIPv6NLRI
exception ryu.lib.packet.bgp.HoldTimerExpired(data=”)
Error to indicate Hold Timer expired.
RFC says: If a system does not receive successive KEEPALIVE, UPDATE, and/or NOTIFICATION messages
within the period specified in the Hold Time field of the OPEN message, then the NOTIFICATION message
with the Hold Timer Expired Error Code is sent and the BGP connection is closed.
exception ryu.lib.packet.bgp.InvalidNetworkField(data=”)
exception ryu.lib.packet.bgp.InvalidNextHop(data=”)
exception ryu.lib.packet.bgp.InvalidOriginError(data=”)
Error indicates undefined Origin attribute value.
RFC says: If the ORIGIN attribute has an undefined value, then the Error Sub- code MUST be set to Invalid
Origin Attribute. The Data field MUST contain the unrecognized attribute (type, length, and value).
exception ryu.lib.packet.bgp.MalformedAsPath(data=”)
Error to indicate if AP_PATH attribute is syntactically incorrect.
RFC says: The AS_PATH attribute is checked for syntactic correctness. If the path is syntactically incorrect,
then the Error Subcode MUST be set to Malformed AS_PATH.
exception ryu.lib.packet.bgp.MalformedAttrList(data=”)
Error to indicate UPDATE message is malformed.
RFC says: Error checking of an UPDATE message begins by examining the path attributes. If the Withdrawn
Routes Length or Total Attribute Length is too large (i.e., if Withdrawn Routes Length + Total Attribute Length
+ 23 exceeds the message Length), then the Error Subcode MUST be set to Malformed Attribute List.
exception ryu.lib.packet.bgp.MalformedOptionalParam(data=”)
If recognized optional parameters are malformed.
RFC says: If one of the Optional Parameters in the OPEN message is recognized, but is malformed, then the
Error Subcode MUST be set to 0 (Unspecific).
exception ryu.lib.packet.bgp.MaxPrefixReached(data=”)
exception ryu.lib.packet.bgp.MissingWellKnown(pattr_type_code)
Error to indicate missing well-known attribute.
RFC says: If any of the well-known mandatory attributes are not present, then the Error Subcode MUST be
set to Missing Well-known Attribute. The Data field MUST contain the Attribute Type Code of the missing,
well-known attribute.
exception ryu.lib.packet.bgp.NotSync(data=”)
exception ryu.lib.packet.bgp.OptAttrError(data=”)
Error indicates Optional Attribute is malformed.
RFC says: If an optional attribute is recognized, then the value of this attribute MUST be checked. If an error
is detected, the attribute MUST be discarded, and the Error Subcode MUST be set to Optional Attribute Error.
The Data field MUST contain the attribute (type, length, and value).
exception ryu.lib.packet.bgp.OtherConfChange(data=”)
exception ryu.lib.packet.bgp.OutOfResource(data=”)
exception ryu.lib.packet.bgp.PeerDeConfig(data=”)

40 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.bgp.PmsiTunnelIdUnknown(value)
Unknown route type specific _PmsiTunnelId
class ryu.lib.packet.bgp.RouteTargetMembershipNLRI(origin_as, route_target)
Route Target Membership NLRI.
Route Target membership NLRI is advertised in BGP UPDATE messages using the MP_REACH_NLRI and
MP_UNREACH_NLRI attributes.
exception ryu.lib.packet.bgp.RoutingLoop(data=”)
class ryu.lib.packet.bgp.StreamParser
Streaming parser for BGP-4 messages.
This is a subclass of ryu.lib.packet.stream_parser.StreamParser. Its parse method returns a list of BGPMessage
subclass instances.
try_parse(data)
Try to extract a message from the given bytes.
This is an override point for subclasses.
This method tries to extract a message from bytes given by the argument.
Raises TooSmallException if the given data is not enough to extract a complete message but there’s still a
chance to extract a message if more data is come later.
exception ryu.lib.packet.bgp.UnRegWellKnowAttr(data=”)
exception ryu.lib.packet.bgp.UnacceptableHoldTime(data=”)
Error to indicate Unacceptable Hold Time in open message.
RFC says: If the Hold Time field of the OPEN message is unacceptable, then the Error Subcode MUST be set
to Unacceptable Hold Time.
exception ryu.lib.packet.bgp.UnsupportedOptParam(data=”)
Error to indicate unsupported optional parameters.
RFC says: If one of the Optional Parameters in the OPEN message is not recognized, then the Error Subcode
MUST be set to Unsupported Optional Parameters.
exception ryu.lib.packet.bgp.UnsupportedVersion(locally_support_version)
Error to indicate unsupport bgp version number.
RFC says: If the version number in the Version field of the received OPEN message is not supported, then the
Error Subcode MUST be set to Unsupported Version Number. The Data field is a 2-octet unsigned integer,
which indicates the largest, locally-supported version number less than the version the remote BGP peer bid (as
indicated in the received OPEN message), or if the smallest, locally-supported version number is greater than
the version the remote BGP peer bid, then the smallest, locally- supported version number.

BMP

BGP Monitoring Protocol draft-ietf-grow-bmp-07

class ryu.lib.packet.bmp.BMPInitiation(info, type_=4, len_=None, version=3)
BMP Initiation Message

2.4. Library 41
ryu Documentation, Release 4.34

Attribute Description
version Version. this packet lib defines BMP ver. 3
len Length field. Ignored when encoding.
type Type field. one of BMP_MSG_ constants.
info One or more piece of information encoded as a TLV

Attribute Description
version Version. this packet lib defines BMP ver. 3
len Length field. Ignored when encoding.
type Type field. one of BMP_MSG_ constants.

42 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.bmp.BMPPeerDownNotification(reason, data, peer_type,

is_post_policy, peer_distinguisher,
peer_address, peer_as, peer_bgp_id,
timestamp, version=3, type_=2,
len_=None, is_adj_rib_out=False)
BMP Peer Down Notification Message

Attribute Description
version Version. this packet lib defines BMP ver. 3
len Length field. Ignored when encoding.
type Type field. one of BMP_MSG_ constants.
reason Reason indicates why the session was closed.
data vary by the reason.

Attribute Description
version Version. this packet lib defines BMP ver. 3
len Length field. Ignored when encoding.
type Type field. one of BMP_MSG_ constants.
peer_type The type of the peer.
is_post_policy Indicate the message reflects the post-policy
is_adj_rib_out Indicate the message reflects Adj-RIB-Out (defaults to Adj-RIB-In)
peer_distinguisher Use for L3VPN router which can have multiple instance.
peer_address The remote IP address associated with the TCP session.
peer_as The Autonomous System number of the peer.
peer_bgp_id The BGP Identifier of the peer
timestamp The time when the encapsulated routes were received.

classmethod parser(buf )
Decode a protocol header.

2.4. Library 43
ryu Documentation, Release 4.34

This method is used only when decoding a packet.

Attribute Description
version Version. this packet lib defines BMP ver. 3
len Length field. Ignored when encoding.
type Type field. one of BMP_MSG_ constants.
peer_type The type of the peer.
peer_flags Provide more information about the peer.
peer_distinguisher Use for L3VPN router which can have multiple instance.
peer_address The remote IP address associated with the TCP session.
peer_as The Autonomous System number of the peer.
peer_bgp_id The BGP Identifier of the peer
timestamp The time when the encapsulated routes were received.
local_address The local IP address associated with the peering TCP session.
local_port The local port number associated with the peering TCP session.
remote_port The remote port number associated with the peering TCP session.
sent_open_message The full OPEN message transmitted by the monitored router to its peer.
received_open_message The full OPEN message received by the monitored router from its peer.

44 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

2.4. Library 45
ryu Documentation, Release 4.34

• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
class ryu.lib.packet.bmp.BMPTermination(info, type_=5, len_=None, version=3)
BMP Termination Message

BPDU

Bridge Protocol Data Unit(BPDU, IEEE 802.1D) parser/serializer http://standards.ieee.org/getieee802/download/802.

1D-2004.pdf
Configuration BPDUs format

46 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Structure Octet
Protocol Identifier = 0000 0000 0000 0000 1-2
Protocol Version Identifier = 0000 0000 3
BPDU Type = 0000 0000 4
Flags 5
6 - 13
Root Identifier
include - priority system ID extension
MAC address

Root Path Cost 14 - 17

18 - 25
Bridge Identifier
include - priority system ID extension
MAC address

26 - 27
Port Identifier
include - priority port number

Message Age 28 - 29
Max Age 30 - 31
Hello Time 32 - 33
Forward Delay 34 - 35

Topology Change NotificationBPDUs format

Structure Octet
Protocol Identifier = 0000 0000 0000 0000 1-2
Protocol Version Identifier = 0000 0000 3
BPDU Type = 1000 0000 4

Rapid Spanning Tree BPDUs(RST BPDUs) format

2.4. Library 47
ryu Documentation, Release 4.34

Structure Octet
Protocol Identifier = 0000 0000 0000 0000 1-2
Protocol Version Identifier = 0000 0010 3
BPDU Type = 0000 0010 4
Flags 5
6 - 13
Root Identifier
include - priority system ID extension
MAC address

Root Path Cost 14 - 17

18 - 25
Bridge Identifier
include - priority system ID extension
MAC address

26 - 27
Port Identifier
include - priority port number

Message Age 28 - 29
Max Age 30 - 31
Hello Time 32 - 33
Forward Delay 34 - 35
Version 1 Length = 0000 0000 36

class ryu.lib.packet.bpdu.ConfigurationBPDUs(flags=0, root_priority=32768,

root_system_id_extension=0,
root_mac_address=’00:00:00:00:00:00’,
root_path_cost=0, bridge_priority=32768,
bridge_system_id_extension=0,
bridge_mac_address=’00:00:00:00:00:00’,
port_priority=128, port_number=0, mes-
sage_age=0, max_age=20, hello_time=2,
forward_delay=15)
Configuration BPDUs(IEEE 802.1D) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

48 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
flags
Bit 1: Topology Change flag
Bits 2 through 7: unused and take the value 0
Bit 8: Topology Change Acknowledgment flag

root_priority Root Identifier priority set 0-61440 in steps of 4096

root_system_id_extension Root Identifier system ID extension
root_mac_address Root Identifier MAC address
root_path_cost Root Path Cost
bridge_priority Bridge Identifier priority set 0-61440 in steps of 4096
bridge_system_id_extension Bridge Identifier system ID extension
bridge_mac_address Bridge Identifier MAC address
port_priority Port Identifier priority set 0-240 in steps of 16
port_number Port Identifier number
message_age Message Age timer value
max_age Max Age timer value
hello_time Hello Time timer value
forward_delay Forward Delay timer value

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.bpdu.RstBPDUs(flags=0, root_priority=32768,
root_system_id_extension=0,
root_mac_address=’00:00:00:00:00:00’,
root_path_cost=0, bridge_priority=32768,
bridge_system_id_extension=0,
bridge_mac_address=’00:00:00:00:00:00’,
port_priority=128, port_number=0, message_age=0,
max_age=20, hello_time=2, forward_delay=15)
Rapid Spanning Tree BPDUs(RST BPDUs, IEEE 802.1D) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 49
ryu Documentation, Release 4.34

Attribute Description
flags
Bit 1: Topology Change flag
Bit 2: Proposal flag
Bits 3 and 4: Port Role
Bit 5: Learning flag
Bit 6: Forwarding flag
Bit 7: Agreement flag
Bit 8: Topology Change Acknowledgment flag

root_priority Root Identifier priority set 0-61440 in steps of 4096

50 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
class ryu.lib.packet.bpdu.bpdu
Bridge Protocol Data Unit(BPDU) header encoder/decoder base class.
classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.

CFM

class ryu.lib.packet.cfm.cc_message(md_lv=0, version=0, rdi=0, interval=4, seq_num=0,

mep_id=1, md_name_format=4, md_name_length=0,
md_name=b’0’, short_ma_name_format=2,
short_ma_name_length=0, short_ma_name=b’1’,
tlvs=None)
CFM (IEEE Std 802.1ag-2007) Continuity Check Message (CCM) encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 51
ryu Documentation, Release 4.34

Attribute Description
md_lv Maintenance Domain Level.
version The protocol version number.
rdi RDI bit.
interval CCM Interval.The default is 4 (1 frame/s)
seq_num Sequence Number.
mep_id Maintenance association End Point Identifier.
md_name_format Maintenance Domain Name Format. The default is 4 (Character string)
md_name_length Maintenance Domain Name Length. (0 means automatically-calculate when
encoding.)
md_name Maintenance Domain Name.
short_ma_name_format Short MA Name Format. The default is 2 (Character string)
short_ma_name_length Short MA Name Format Length. (0 means automatically-calculate when
encoding.)
short_ma_name Short MA Name.
tlvs TLVs.

class ryu.lib.packet.cfm.cfm(op=None)
CFM (Connectivity Fault Management) Protocol header class.
http://standards.ieee.org/getieee802/download/802.1ag-2007.pdf
OpCode Field range assignments

OpCode range CFM PDU or organization

0 Reserved for IEEE 802.1
1 Continuity Check Message (CCM)
2 Loopback Reply (LBR)
3 Loopback Message (LBM)
4 Linktrace Reply (LTR)
5 Linktrace Message (LTM)
06 - 31 Reserved for IEEE 802.1
32 - 63 Defined by ITU-T Y.1731
64 - 255 Reserved for IEEE 802.1.

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
op CFM PDU

52 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.cfm.data_tlv(length=0, data_value=b”)
CFM (IEEE Std 802.1ag-2007) Data TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding)
data_value Bit pattern of any of n octets.(n = length)

class ryu.lib.packet.cfm.interface_status_tlv(length=0, interface_status=1)

CFM (IEEE Std 802.1ag-2007) Interface Status TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
interface_status Interface Status.The default is 1 (isUp)

class ryu.lib.packet.cfm.link_trace_message(md_lv=0, version=0, use_fdb_only=1,

transaction_id=0, ttl=64,
ltm_orig_addr=’00:00:00:00:00:00’,
ltm_targ_addr=’00:00:00:00:00:00’,
tlvs=None)
CFM (IEEE Std 802.1ag-2007) Linktrace Message (LTM) encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
md_lv Maintenance Domain Level.
version The protocol version number.
use_fdb_only UseFDBonly bit.
transaction_id LTM Transaction Identifier.
ttl LTM TTL.
ltm_orig_addr Original MAC Address.
ltm_targ_addr Target MAC Address.
tlvs TLVs.

2.4. Library 53
ryu Documentation, Release 4.34

class ryu.lib.packet.cfm.link_trace_reply(md_lv=0, version=0, use_fdb_only=1,

fwd_yes=0, terminal_mep=1, transaction_id=0,
ttl=64, relay_action=1, tlvs=None)
CFM (IEEE Std 802.1ag-2007) Linktrace Reply (LTR) encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
version The protocol version number.
use_fdb_only UseFDBonly bit.
fwd_yes FwdYes bit.
terminal_mep TerminalMep bit.
transaction_id LTR Transaction Identifier.
ttl Reply TTL.
relay_action Relay Action.The default is 1 (RlyHit)
tlvs TLVs.

class ryu.lib.packet.cfm.loopback_message(md_lv=0, version=0, transaction_id=0,

tlvs=None)
CFM (IEEE Std 802.1ag-2007) Loopback Message (LBM) encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
md_lv Maintenance Domain Level.
version The protocol version number.
transaction_id Loopback Transaction Identifier.
tlvs TLVs.

class ryu.lib.packet.cfm.loopback_reply(md_lv=0, version=0, transaction_id=0,

tlvs=None)
CFM (IEEE Std 802.1ag-2007) Loopback Reply (LBR) encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
md_lv Maintenance Domain Level.
version The protocol version number.
transaction_id Loopback Transaction Identifier.
tlvs TLVs.

class ryu.lib.packet.cfm.ltm_egress_identifier_tlv(length=0, egress_id_ui=0,

egress_id_mac=’00:00:00:00:00:00’)
CFM (IEEE Std 802.1ag-2007) LTM EGRESS TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.

54 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
egress_id_ui Egress Identifier of Unique ID.
egress_id_mac Egress Identifier of MAC address.

class ryu.lib.packet.cfm.ltr_egress_identifier_tlv(length=0, last_egress_id_ui=0,

last_egress_id_mac=’00:00:00:00:00:00’,
next_egress_id_ui=0,
next_egress_id_mac=’00:00:00:00:00:00’)
CFM (IEEE Std 802.1ag-2007) LTR EGRESS TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
last_egress_id_ui Last Egress Identifier of Unique ID.
last_egress_id_mac Last Egress Identifier of MAC address.
next_egress_id_ui Next Egress Identifier of Unique ID.
next_egress_id_mac Next Egress Identifier of MAC address.

class ryu.lib.packet.cfm.organization_specific_tlv(length=0, oui=b’x00x00x00’, sub-

type=0, value=b”)
CFM (IEEE Std 802.1ag-2007) Organization Specific TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
oui Organizationally Unique Identifier.
subtype Subtype.
value Value.(optional)

class ryu.lib.packet.cfm.port_status_tlv(length=0, port_status=2)

CFM (IEEE Std 802.1ag-2007) Port Status TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
port_status Port Status.The default is 1 (psUp)

2.4. Library 55
ryu Documentation, Release 4.34

class ryu.lib.packet.cfm.reply_egress_tlv(length=0, action=1,

mac_address=’00:00:00:00:00:00’,
port_id_length=0, port_id_subtype=0,
port_id=b”)
CFM (IEEE Std 802.1ag-2007) Reply Egress TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
action Egress Action.The default is 1 (EgrOK)
mac_address Egress MAC Address.
port_id_length Egress PortID Length. (0 means automatically-calculate when encoding.)
port_id_subtype Egress PortID Subtype.
port_id Egress PortID.

class ryu.lib.packet.cfm.reply_ingress_tlv(length=0, action=1,

mac_address=’00:00:00:00:00:00’,
port_id_length=0, port_id_subtype=0,
port_id=b”)
CFM (IEEE Std 802.1ag-2007) Reply Ingress TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
action Ingress Action.The default is 1 (IngOK)
mac_address Ingress MAC Address.
port_id_length Ingress PortID Length. (0 means automatically-calculate when encoding.)
port_id_subtype Ingress PortID Subtype.
port_id Ingress PortID.

class ryu.lib.packet.cfm.sender_id_tlv(length=0, chassis_id_length=0, chas-

sis_id_subtype=4, chassis_id=b”,
ma_domain_length=0, ma_domain=b”,
ma_length=0, ma=b”)
CFM (IEEE Std 802.1ag-2007) Sender ID TLV encoder/decoder class.
This is used with ryu.lib.packet.cfm.cfm.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

56 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
length Length of Value field. (0 means automatically-calculate when encoding.)
chassis_id_length Chassis ID Length. (0 means automatically-calculate when encoding.)
chassis_id_subtype Chassis ID Subtype. The default is 4 (Mac Address)
chassis_id Chassis ID.
ma_domain_length Management Address Domain Length. (0 means automatically-calculate when
encoding.)
ma_domain Management Address Domain.
ma_length Management Address Length. (0 means automatically-calculate when encoding.)
ma Management Address.

DHCP

DHCP packet parser/serializer

class ryu.lib.packet.dhcp.dhcp(op, chaddr, options=None, htype=1, hlen=0, hops=0,
xid=None, secs=0, flags=0, ciaddr=’0.0.0.0’, yiaddr=’0.0.0.0’,
siaddr=’0.0.0.0’, giaddr=’0.0.0.0’, sname=”, boot_file=”)
DHCP (RFC 2131) header encoder/decoder class.
The serialized packet would looks like the ones described in the following sections.
• RFC 2131 DHCP packet format
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
op Message op code / message type. 1 = BOOTREQUEST, 2 = BOOTREPLY
htype Hardware address type (e.g. ’1’ = 10mb ethernet).
hlen Hardware address length (e.g. ’6’ = 10mb ethernet).
hops Client sets to zero, optionally used by relay agent when booting via a relay agent.
xid Transaction ID, a random number chosen by the client, used by the client and serverto associate
messages and responses between a client and a server.
secs Filled in by client, seconds elapsed since client began address acquisition or renewal process.
flags Flags.
ciaddr Client IP address; only filled in if client is in BOUND, RENEW or REBINDING state and can
respond to ARP requests.
yiaddr ’your’ (client) IP address.
siaddr IP address of next server to use in bootstrap; returned in DHCPOFFER, DHCPACK by server.
giaddr Relay agent IP address, used in booting via a relay agent.
chaddr Client hardware address.
sname Optional server host name, null terminated string.
boot_file Boot file name, null terminated string; "generic" name or null in DHCPDISCOVER, fully
qualified directory-path name in DHCPOFFER.
options Optional parameters field (’DHCP message type’ option must be included in every DHCP
message).

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.

2.4. Library 57
ryu Documentation, Release 4.34

• An object to describe the decoded header.

Attribute Description
tag Option type. (except for the ’magic cookie’, ’pad option’ and ’end option’.)
value Option’s value. (set the value that has been converted to hexadecimal.)
length Option’s value length. (calculated automatically from the length of value.)

class ryu.lib.packet.dhcp.options(option_list=None, options_len=0,

magic_cookie=’99.130.83.99’)
DHCP (RFC 2132) options encoder/decoder class.
This is used with ryu.lib.packet.dhcp.dhcp.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
option_list ’end option’ and ’pad option’ are added automatically after the option class is stored in
array.
options_len Option’s byte length. (’magic cookie’, ’end option’ and ’pad option’ length including.)
magic_cookie The first four octets contain the decimal values 99, 130, 83 and 99.

DHCP6

DHCPv6 packet parser/serializer

[RFC 3315] DHCPv6 packet format:
The following diagram illustrates the format of DHCP messages sent between clients and servers:
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| msg_type | transaction_id |
(continues on next page)

58 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
. options .
. (variable) .
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

There are two relay agent messages, which share the following format:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| msg_type | hop_count | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| link_address |
| |
| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| |
| peer_address |
| |
| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
. .
. options (variable number and length) .... .
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

class ryu.lib.packet.dhcp6.dhcp6(msg_type, options, transaction_id=None, hop_count=0,

link_address=’::’, peer_address=’::’)
DHCPv6 (RFC 3315) header encoder/decoder class.
The serialized packet would looks like the ones described in the following sections.
• RFC 3315 DHCP packet format
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
msg_type Identifies the DHCP message type
transac- For unrelayed messages only: the transaction ID for this message exchange.
tion_id
hop_count For relayed messages only: number of relay agents that have relayed this message.
link_address For relayed messages only: a global or site-local address that will be used by the server to
identify the link on which the client is located.
peer_addressFor relayed messages only: the address of the client or relay agent from which the message to
be relayed was received.
options Options carried in this message

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.

2.4. Library 59
ryu Documentation, Release 4.34

Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload=None, prev=None)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.dhcp6.option(code, data, length=0)
DHCP (RFC 3315) options encoder/decoder class.
This is used with ryu.lib.packet.dhcp6.dhcp6.options.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.
The format of DHCP options is:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| option-code | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| option-data |
| (option-len octets) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Attribute Description
option-code An unsigned integer identifying the specific option type carried in this option.
option-len An unsigned integer giving the length of the option-data field in this option in octets.
option-data The data for the option; the format of this data depends on the definition of the option.

class ryu.lib.packet.dhcp6.options(option_list=None, options_len=0)

DHCP (RFC 3315) options encoder/decoder class.
This is used with ryu.lib.packet.dhcp6.dhcp6.

Ethernet

class ryu.lib.packet.ethernet.ethernet(dst=’ff:ff:ff:ff:ff:ff’, src=’00:00:00:00:00:00’, ether-

type=2048)
Ethernet header encoder/decoder class.
An instance has the following attributes at least. MAC addresses are represented as a string like
’08:60:6e:7f:74:e7’. __init__ takes the corresponding args in this order.

60 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description Example

dst destination address ’ff:ff:ff:ff:ff:ff’
src source address ’08:60:6e:7f:74:e7’
ethertype ether type 0x0800

classmethod get_packet_type(type_)
Override method for the ethernet IEEE802.3 Length/Type field (self.ethertype).
If the value of Length/Type field is less than or equal to 1500 decimal(05DC hexadecimal), it means Length
interpretation and be passed to the LLC sublayer.
classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.

Geneve

Geneve packet parser/serializer

class ryu.lib.packet.geneve.Option(option_class=None, type_=None, length=0)
Tunnel Options
class ryu.lib.packet.geneve.OptionDataUnknown(buf, option_class=None, type_=None,
length=0)
Unknown Option Class and Type specific Option
class ryu.lib.packet.geneve.geneve(version=0, opt_len=0, flags=0, protocol=25944,
vni=None, options=None)
Geneve (RFC draft-ietf-nvo3-geneve-03) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 61
ryu Documentation, Release 4.34

Attribute Description
version Version.
opt_len The length of the options fields.
flags Flag field for OAM packet and Critical options present.
protocol Protocol Type field. The Protocol Type is defined as "ETHER TYPES".
vni Identifier for unique element of virtual network.
options List of Option* instance.

GRE

class ryu.lib.packet.gre.gre(version=0, protocol=2048, checksum=None, key=None,

vsid=None, flow_id=None, seq_number=None)
GRE (RFC2784,RFC2890) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

At- Description
tribute
version Version.
protocol Protocol Type field. The Protocol Type is defined as "ETHER TYPES".
check- Checksum field(optional). When you set a value other than None, this field will be automatically
sum calculated.
key Key field(optional) This field is intended to be used for identifying an individual traffic flow
within a tunnel.
vsid Virtual Subnet ID field(optional) This field is a 24-bit value that is used to identify the NVGRE-
based Virtual Layer 2 Network.
flow_id FlowID field(optional) This field is an 8-bit value that is used to provide per-flow entropy for
flows in the same VSID.
seq_numberSequence Number field(optional)

62 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

ICMP

class ryu.lib.packet.icmp.TimeExceeded(data_len=0, data=None)

ICMP sub encoder/decoder class for Time Exceeded Message.
This is used with ryu.lib.packet.icmp.icmp for ICMP Time Exceeded Message.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.
[RFC4884] introduced 8-bit data length attribute.

Attribute Description
data_len data length
data Internet Header + leading octets of original datagram

class ryu.lib.packet.icmp.dest_unreach(data_len=0, mtu=0, data=None)

ICMP sub encoder/decoder class for Destination Unreachable Message.
This is used with ryu.lib.packet.icmp.icmp for ICMP Destination Unreachable Message.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 63
ryu Documentation, Release 4.34

[RFC1191] reserves bits for the "Next-Hop MTU" field. [RFC4884] introduced 8-bit data length attribute.

Attribute Description
data_len data length
mtu Next-Hop MTU
NOTE: This field is required when icmp code is 4
code 4 = fragmentation needed and DF set
data Internet Header + leading octets of original datagram

class ryu.lib.packet.icmp.echo(id_=0, seq=0, data=None)

ICMP sub encoder/decoder class for Echo and Echo Reply messages.
This is used with ryu.lib.packet.icmp.icmp for ICMP Echo and Echo Reply messages.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
id Identifier
seq Sequence Number
data Internet Header + 64 bits of Original Data Datagram

class ryu.lib.packet.icmp.icmp(type_=8, code=0, csum=0, data=b”)

ICMP (RFC 792) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
type Type
code Code
csum CheckSum (0 means automatically-calculate when encoding)
data Payload. Either a bytearray, or ryu.lib.packet.icmp.echo or ryu.lib.packet.icmp.dest_unreach
or ryu.lib.packet.icmp.TimeExceeded object NOTE for icmp.echo: This includes "unused" 16
bits and the following "Internet Header + 64 bits of Original Data Datagram" of the ICMP
header. NOTE for icmp.dest_unreach and icmp.TimeExceeded: This includes "unused" 8 or
24 bits and the following "Internet Header + leading octets of original datagram" of the
original packet.

64 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Encode a protocol header. Returns a bytearray which contains the header.

ICMPv6

class ryu.lib.packet.icmpv6.echo(id_=0, seq=0, data=None)

ICMPv6 sub encoder/decoder class for Echo Request and Echo Reply messages.
This is used with ryu.lib.packet.icmpv6.icmpv6 for ICMPv6 Echo Request and Echo Reply messages.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
id Identifier
seq Sequence Number
data Data

class ryu.lib.packet.icmpv6.icmpv6(type_=0, code=0, csum=0, data=b”)

ICMPv6 (RFC 2463) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
type_ Type
code Code
csum CheckSum (0 means automatically-calculate when encoding)
data Payload.
ryu.lib.packet.icmpv6.echo object, ryu.lib.packet.icmpv6.nd_neighbor object,
ryu.lib.packet.icmpv6.nd_router_solicit object, ryu.lib.packet.icmpv6.nd_router_advert
object, ryu.lib.packet.icmpv6.mld object, or a bytearray.

2.4. Library 65
ryu Documentation, Release 4.34

prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.icmpv6.mld(maxresp=0, address=’::’)
ICMPv6 sub encoder/decoder class for MLD Lister Query, MLD Listener Report, and MLD Listener Done
messages. (RFC 2710)
http://www.ietf.org/rfc/rfc2710.txt
This is used with ryu.lib.packet.icmpv6.icmpv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
maxresp max response time in millisecond. it is meaningful only in Query Message.
address a group address value.

class ryu.lib.packet.icmpv6.mldv2_query(maxresp=0, address=’::’, s_flg=0, qrv=2, qqic=0,

num=0, srcs=None)
ICMPv6 sub encoder/decoder class for MLD v2 Lister Query messages. (RFC 3810)
http://www.ietf.org/rfc/rfc3810.txt
This is used with ryu.lib.packet.icmpv6.icmpv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
maxresp max response time in millisecond. it is meaningful only in Query Message.
address a group address value.
s_flg when set to 1, routers suppress the timer process.
qrv robustness variable for a querier.
qqic an interval time for a querier in unit of seconds.
num a number of the multicast servers.
srcs a list of IPv6 addresses of the multicast servers.

class ryu.lib.packet.icmpv6.mldv2_report(record_num=0, records=None)

ICMPv6 sub encoder/decoder class for MLD v2 Lister Report messages. (RFC 3810)
http://www.ietf.org/rfc/rfc3810.txt
This is used with ryu.lib.packet.icmpv6.icmpv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
record_num a number of the group records.
records a list of ryu.lib.packet.icmpv6.mldv2_report_group. None if no records.

class ryu.lib.packet.icmpv6.mldv2_report_group(type_=0, aux_len=0, num=0, ad-

dress=’::’, srcs=None, aux=None)
ICMPv6 sub encoder/decoder class for MLD v2 Lister Report Group Record messages. (RFC 3810)
This is used with ryu.lib.packet.icmpv6.mldv2_report.

66 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
type_ a group record type for v3.
aux_len the length of the auxiliary data in 32-bit words.
num a number of the multicast servers.
address a group address value.
srcs a list of IPv6 addresses of the multicast servers.
aux the auxiliary data.

class ryu.lib.packet.icmpv6.nd_neighbor(res=0, dst=’::’, option=None)

ICMPv6 sub encoder/decoder class for Neighbor Solicitation and Neighbor Advertisement messages. (RFC
4861)
This is used with ryu.lib.packet.icmpv6.icmpv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
res R,S,O Flags for Neighbor Advertisement. The 3 MSBs of "Reserved" field for Neighbor
Solicitation.
dst Target Address
option a derived object of ryu.lib.packet.icmpv6.nd_option or a bytearray. None if no options.

class ryu.lib.packet.icmpv6.nd_option_mtu(mtu=1500)
ICMPv6 sub encoder/decoder class for Neighbor discovery MTU Option. (RFC 4861)
This is used with ryu.lib.packet.icmpv6.nd_router_advert.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
mtu MTU.

class ryu.lib.packet.icmpv6.nd_option_pi(length=0, pl=0, res1=0, val_l=0, pre_l=0,

res2=0, prefix=’::’)
ICMPv6 sub encoder/decoder class for Neighbor discovery Prefix Information Option. (RFC 4861)
This is used with ryu.lib.packet.icmpv6.nd_router_advert.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length length of the option. (0 means automatically-calculate when encoding)
pl Prefix Length.
res1 L,A,R* Flags for Prefix Information.
val_l Valid Lifetime.
pre_l Preferred Lifetime.
res2 This field is unused. It MUST be initialized to zero.
prefix An IP address or a prefix of an IP address.

2.4. Library 67
ryu Documentation, Release 4.34

*R flag is defined in (RFC 3775)

class ryu.lib.packet.icmpv6.nd_option_sla(length=0, hw_src=’00:00:00:00:00:00’,
data=None)
ICMPv6 sub encoder/decoder class for Neighbor discovery Source Link-Layer Address Option. (RFC 4861)
This is used with ryu.lib.packet.icmpv6.nd_neighbor, ryu.lib.packet.icmpv6.nd_router_solicit or
ryu.lib.packet.icmpv6.nd_router_advert.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length length of the option. (0 means automatically-calculate when encoding)
hw_src Link-Layer Address. NOTE: If the address is longer than 6 octets this contains the first
6 octets in the address. This implementation assumes the address has at least 6 octets.
data A bytearray which contains the rest of Link-Layer Address and padding. When encoding
a packet, it’s user’s responsibility to provide necessary padding for 8-octets alignment
required by the protocol.

class ryu.lib.packet.icmpv6.nd_option_tla(length=0, hw_src=’00:00:00:00:00:00’,

data=None)
ICMPv6 sub encoder/decoder class for Neighbor discovery Target Link-Layer Address Option. (RFC 4861)
This is used with ryu.lib.packet.icmpv6.nd_neighbor.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

class ryu.lib.packet.icmpv6.nd_router_advert(ch_l=0, res=0, rou_l=0, rea_t=0, ret_t=0,

options=None)
ICMPv6 sub encoder/decoder class for Router Advertisement messages. (RFC 4861)
This is used with ryu.lib.packet.icmpv6.icmpv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
ch_l Cur Hop Limit.
res M,O Flags for Router Advertisement.
rou_l Router Lifetime.
rea_t Reachable Time.
ret_t Retrans Timer.
options List of a derived object of ryu.lib.packet.icmpv6.nd_option or a bytearray. None if no
options.

68 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.icmpv6.nd_router_solicit(res=0, option=None)

ICMPv6 sub encoder/decoder class for Router Solicitation messages. (RFC 4861)
This is used with ryu.lib.packet.icmpv6.icmpv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
res This field is unused. It MUST be initialized to zero.
option a derived object of ryu.lib.packet.icmpv6.nd_option or a bytearray. None if no options.

IGMP

Internet Group Management Protocol(IGMP) packet parser/serializer

[RFC 1112] IGMP v1 format:

[RFC 2236] IGMP v2 format:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type | Max Resp Time | Checksum |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Group Address |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

[RFC 3376] IGMP v3 Membership Query format:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type = 0x11 | Max Resp Code | Checksum |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Group Address |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Resv |S| QRV | QQIC | Number of Sources (N) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Source Address [1] |
+- -+
| Source Address [2] |
+- . -+
. . .
. . .
+- -+
| Source Address [N] |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

2.4. Library 69
ryu Documentation, Release 4.34

IGMP v3 Membership Report format:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type = 0x22 | Reserved | Checksum |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Reserved | Number of Group Records (M) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
. .
. Group Record [1] .
. .
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
. .
. Group Record [2] .
. .
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| . |
. . .
| . |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
. .
. Group Record [M] .
. .
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Where each Group Record has the following internal format:

+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Record Type | Aux Data Len | Number of Sources (N) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Multicast Address |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Source Address [1] |
+- -+
| Source Address [2] |
+- -+
. . .
. . .
. . .
+- -+
| Source Address [N] |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
. .
. Auxiliary Data .
. .
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

class ryu.lib.packet.igmp.igmp(msgtype=17, maxresp=0, csum=0, address=’0.0.0.0’)

Internet Group Management Protocol(IGMP, RFC 1112, RFC 2236) header encoder/decoder class.

70 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

http://www.ietf.org/rfc/rfc1112.txt
http://www.ietf.org/rfc/rfc2236.txt
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
msgtype a message type for v2, or a combination of version and a message type for v1.
maxresp max response time in unit of 1/10 second. it is meaningful only in Query Message.
csum a check sum value. 0 means automatically-calculate when encoding.
address a group address value.

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.igmp.igmpv3_query(msgtype=17, maxresp=100, csum=0, ad-
dress=’0.0.0.0’, s_flg=0, qrv=2, qqic=0, num=0,
srcs=None)
Internet Group Management Protocol(IGMP, RFC 3376) Membership Query message encoder/decoder class.
http://www.ietf.org/rfc/rfc3376.txt
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
msgtype a message type for v3.
maxresp max response time in unit of 1/10 second.
csum a check sum value. 0 means automatically-calculate when encoding.
address a group address value.
s_flg when set to 1, routers suppress the timer process.
qrv robustness variable for a querier.
qqic an interval time for a querier in unit of seconds.
num a number of the multicast servers.
srcs a list of IPv4 addresses of the multicast servers.

2.4. Library 71
ryu Documentation, Release 4.34

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.igmp.igmpv3_report(msgtype=34, csum=0, record_num=0,
records=None)
Internet Group Management Protocol(IGMP, RFC 3376) Membership Report message encoder/decoder class.
http://www.ietf.org/rfc/rfc3376.txt
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
msgtype a message type for v3.
csum a check sum value. 0 means automatically-calculate when encoding.
record_num a number of the group records.
records a list of ryu.lib.packet.igmp.igmpv3_report_group. None if no records.

72 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.igmp.igmpv3_report_group(type_=0, aux_len=0, num=0, ad-
dress=’0.0.0.0’, srcs=None, aux=None)
Internet Group Management Protocol(IGMP, RFC 3376) Membership Report Group Record message en-
coder/decoder class.
http://www.ietf.org/rfc/rfc3376.txt
This is used with ryu.lib.packet.igmp.igmpv3_report.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
type_ a group record type for v3.
aux_len the length of the auxiliary data.
num a number of the multicast servers.
address a group address value.
srcs a list of IPv4 addresses of the multicast servers.
aux the auxiliary data.

IPv4

class ryu.lib.packet.ipv4.ipv4(version=4, header_length=5, tos=0, total_length=0, identi-

fication=0, flags=0, offset=0, ttl=255, proto=0, csum=0,
src=’10.0.0.1’, dst=’10.0.0.2’, option=None)
IPv4 (RFC 791) header encoder/decoder class.
NOTE: When decoding, this implementation tries to decode the upper layer protocol even for a fragmented
datagram. It isn’t likely what a user would want.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. IPv4 addresses are represented as a string like ’192.0.2.1’. __init__ takes the corresponding args in
this order.

Attribute Description Example

version Version
header_length IHL
tos Type of Service
total_length Total Length (0 means automatically-calculate when encoding)
identification Identification
flags Flags
offset Fragment Offset
ttl Time to Live
proto Protocol
csum Header Checksum (Ignored and automatically-calculated when encoding)
src Source Address ’192.0.2.1’
dst Destination Address ’192.0.2.2’
option A bytearray which contains the entire Options, or None for no Options

classmethod parser(buf )
Decode a protocol header.

2.4. Library 73
ryu Documentation, Release 4.34

This method is used only when decoding a packet.

IPv6

class ryu.lib.packet.ipv6.auth(nxt=6, size=2, spi=0, seq=0, data=b’x00x00x00x00’)

IP Authentication header (RFC 2402) encoder/decoder class.
This is used with ryu.lib.packet.ipv6.ipv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
nxt Next Header
size the length of the Authentication Header in 64-bit words, subtracting 1.
spi security parameters index.
seq sequence number.
data authentication data.

class ryu.lib.packet.ipv6.dst_opts(nxt=6, size=0, data=None)

IPv6 (RFC 2460) destination header encoder/decoder class.
This is used with ryu.lib.packet.ipv6.ipv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
nxt Next Header
size the length of the destination header, not include the first 8 octet.
data IPv6 options.

class ryu.lib.packet.ipv6.fragment(nxt=6, offset=0, more=0, id_=0)

IPv6 (RFC 2460) fragment header encoder/decoder class.
This is used with ryu.lib.packet.ipv6.ipv6.

74 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
nxt Next Header
offset offset, in 8-octet units, relative to the start of the fragmentable part of the original packet.
more 1 means more fragments follow; 0 means last fragment.
id_ packet identification value.

class ryu.lib.packet.ipv6.header(nxt)
extension header abstract class.
class ryu.lib.packet.ipv6.hop_opts(nxt=6, size=0, data=None)
IPv6 (RFC 2460) Hop-by-Hop Options header encoder/decoder class.
This is used with ryu.lib.packet.ipv6.ipv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
nxt Next Header
size the length of the Hop-by-Hop Options header, not include the first 8 octet.
data IPv6 options.

class ryu.lib.packet.ipv6.ipv6(version=6, traffic_class=0, flow_label=0, payload_length=0,

nxt=6, hop_limit=255, src=’10::10’, dst=’20::20’,
ext_hdrs=None)
IPv6 (RFC 2460) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. IPv6 addresses are represented as a string like ’ff02::1’. __init__ takes the corresponding args in this
order.

Attribute Description Example

version Version
traffic_class Traffic Class
flow_label When decoding, Flow Label. When encoding, the most significant 8 bits of
Flow Label.
payload_length Payload Length
nxt Next Header
hop_limit Hop Limit
src Source Address ’ff02::1’
dst Destination Address ’::’
ext_hdrs Extension Headers

2.4. Library 75
ryu Documentation, Release 4.34

Attribute Description
type_ option type.
len_ the length of data. -1 if type_ is 0.
data an option value. None if len_ is 0 or -1.

class ryu.lib.packet.ipv6.routing(nxt)
An IPv6 Routing Header decoder class. This class has only the parser method.
IPv6 Routing Header types.
http://www.iana.org/assignments/ipv6-parameters/ipv6-parameters.xhtml

Value Description Reference

0 Source Route (DEPRECATED) [[IPV6]][RFC5095]
1 Nimrod (DEPRECATED 2009-05-06)
2 Type 2 Routing Header [RFC6275]
3 RPL Source Route Header [RFC6554]
4 - 252 Unassigned
253 RFC3692-style Experiment 1 [2] [RFC4727]
254 RFC3692-style Experiment 2 [2] [RFC4727]
255 Reserved

class ryu.lib.packet.ipv6.routing_type3(nxt=6, size=0, type_=3, seg=0, cmpi=0, cmpe=0,

adrs=None)
An IPv6 Routing Header for Source Routes with the RPL (RFC 6554) encoder/decoder class.
This is used with ryu.lib.packet.ipv6.ipv6.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

76 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
nxt Next Header
size The length of the Routing header, not include the first 8 octet. (0 means automatically-calculate
when encoding)
type Identifies the particular Routing header variant.
seg Number of route segments remaining.
cmpi Number of prefix octets from segments 1 through n-1.
cmpe Number of prefix octets from segment n.
pad Number of octets that are used for padding after Address[n] at the end of the SRH.
adrs Vector of addresses, numbered 1 to n.

LLC

Logical Link Control(LLC, IEEE 802.2) parser/serializer http://standards.ieee.org/getieee802/download/802.2-1998.

DSAP address field:

LSB
+-----+---+---+---+---+---+---+---+
| I/G | D | D | D | D | D | D | D |
+-----+---+---+---+---+---+---+---+
I/G bit = 0 : Individual DSAP
I/G bit = 1 : Group DSA
D : DSAP address

SSAP address field:

LSB
+-----+---+---+---+---+---+---+---+
| C/R | S | S | S | S | S | S | S |
+-----+---+---+---+---+---+---+---+
C/R bit = 0 : Command
C/R bit = 1 : Response
S : SSAP address

Control field:
Information transfer command/response (I-format PDU):
1 2 3 4 5 6 7 8 9 10-16
+---+---+---+---+---+---+---+---+-----+------+
| 0 | N(S) | P/F | N(R) |
+---+---+---+---+---+---+---+---+-----+------+

Supervisory commands/responses (S-format PDUs):

2.4. Library 77
ryu Documentation, Release 4.34

1 2 3 4 5 6 7 8 9 10-16
+---+---+---+---+---+---+---+---+-----+------+
| 1 0 | S S | 0 0 0 0 | P/F | N(R) |
+---+---+---+---+---+---+---+---+-----+------+

Unnumbered commands/responses (U-format PDUs):

1 2 3 4 5 6 7 8
+---+---+----+---+-----+---+----+---+
| 1 1 | M1 M1 | P/F | M2 M2 M2 |
+---+---+----+---+-----+---+----+---+

N(S) : sender send sequence number (Bit 2=lower-order-bit)

N(R) : sender receive sequence number (Bit 10=lower-order-bit)
S : supervisory function bit
M1/M2: modifier function bit
P/F : poll bit - command LLC PDUs
final bit - response LLC PDUs

class ryu.lib.packet.llc.ControlFormatI(send_sequence_number=0, pf_bit=0, re-

ceive_sequence_number=0)
LLC sub encoder/decoder class for control I-format field.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
send_sequence_number sender send sequence number
pf_bit poll/final bit
receive_sequence_number sender receive sequence number

class ryu.lib.packet.llc.ControlFormatS(supervisory_function=0, pf_bit=0, re-

ceive_sequence_number=0)
LLC sub encoder/decoder class for control S-format field.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
supervisory_function supervisory function bit
pf_bit poll/final bit
receive_sequence_number sender receive sequence number

class ryu.lib.packet.llc.ControlFormatU(modifier_function1=0, pf_bit=0, modi-

fier_function2=0)
LLC sub encoder/decoder class for control U-format field.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
modifier_function1 modifier function bit
pf_bit poll/final bit
modifier_function2 modifier function bit

78 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.llc.llc(dsap_addr, ssap_addr, control)

LLC(IEEE 802.2) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
dsap_addr Destination service access point address field includes I/G bit at least significant bit.
ssap_addr Source service access point address field includes C/R bit at least significant bit.
control Control field [16 bits for formats that include sequence numbering, and 8 bits for formats that
do not]. Either ryu.lib.packet.llc.ControlFormatI or ryu.lib.packet.llc.ControlFormatS or
ryu.lib.packet.llc.ControlFormatU object.

LLDP

Link Layer Discovery Protocol(LLDP, IEEE 802.1AB) http://standards.ieee.org/getieee802/download/802.1AB-2009.

pdf
basic TLV format:
octets | 1 | 2 | 3 ... n + 2 |
--------------------------------------------------------
| TLV type | TLV information | TLV information string |
| (7bits) | string length | (0-507 octets) |
| | (9bits) | |
--------------------------------------------------------
bits |8 2|1|8 1|

Organizationally specific TLV format:

octets | 1 | 2 | 3 ... 5 | 6 | 7 ... n + 6 |
---------------------------------------------------------------
| TLV type | Length | OUI | Subtype | Infomation |
(continues on next page)

2.4. Library 79
ryu Documentation, Release 4.34

(continued from previous page)

LLDPDU format:
------------------------------------------------------------------------
| Chassis ID | Port ID | TTL | optional TLV | ... | optional TLV | End |
------------------------------------------------------------------------

Chasis ID, Port ID, TTL, End are mandatory optional TLV may be inserted in any order
class ryu.lib.packet.lldp.ChassisID(buf=None, *args, **kwargs)
Chassis ID TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
subtype Subtype.
chassis_id Chassis id corresponding to subtype.

class ryu.lib.packet.lldp.End(buf=None, *args, **kwargs)

End TLV encoder/decoder class

Attribute Description
buf Binary data to parse.

class ryu.lib.packet.lldp.ManagementAddress(buf=None, *args, **kwargs)

Management Address TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
addr_subtype Address type.
addr Device address.
intf_subtype Interface type.
intf_num Interface number.
oid Object ID.

class ryu.lib.packet.lldp.OrganizationallySpecific(buf=None, *args, **kwargs)

Organizationally Specific TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
oui Organizationally unique ID.
subtype Organizationally defined subtype.
info Organizationally defined information string.

class ryu.lib.packet.lldp.PortDescription(buf=None, *args, **kwargs)

Port description TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
port_description Port description.

80 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.lldp.PortID(buf=None, *args, **kwargs)

Port ID TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
subtype Subtype.
port_id Port ID corresponding to subtype.

class ryu.lib.packet.lldp.SystemCapabilities(buf=None, *args, **kwargs)

System Capabilities TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
system_cap System Capabilities.
enabled_cap Enabled Capabilities.

class ryu.lib.packet.lldp.SystemDescription(buf=None, *args, **kwargs)

System description TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
system_description System description.

class ryu.lib.packet.lldp.SystemName(buf=None, *args, **kwargs)

System name TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
system_name System name.

class ryu.lib.packet.lldp.TTL(buf=None, *args, **kwargs)

Time To Live TLV encoder/decoder class

Attribute Description
buf Binary data to parse.
ttl Time To Live.

class ryu.lib.packet.lldp.lldp(tlvs)
LLDPDU encoder/decoder class.
An instance has the following attributes at least.

Attribute Description
tlvs List of TLV instance.

2.4. Library 81
ryu Documentation, Release 4.34

MPLS

ryu.lib.packet.mpls.label_from_bin(buf )
Converts binary representation label to integer.
Parameters buf – Binary representation of label.
Returns MPLS Label and BoS bit.
ryu.lib.packet.mpls.label_to_bin(mpls_label, is_bos=True)
Converts integer label to binary representation.
Parameters
• mpls_label – MPLS Label.
• is_bos – BoS bit.
Returns Binary representation of label.
class ryu.lib.packet.mpls.mpls(label=0, exp=0, bsb=1, ttl=255)
MPLS (RFC 3032) header encoder/decoder class.
NOTE: When decoding, this implementation assumes that the inner protocol is IPv4.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
label Label Value
exp Experimental Use
bsb Bottom of Stack
ttl Time To Live

82 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

• The rest of packet.

OpenFlow

class ryu.lib.packet.openflow.OFPUnparseableMsg(datapath, version, msg_type, msg_len,

xid, body)
Unparseable OpenFlow message encoder class.
An instance has the following attributes at least.

At- Description
tribute
datap- A ryu.ofproto.ofproto_protocol.ProtocolDesc instance for this message or None if OpenFlow pro-
ath tocol version is unsupported version.
ver- OpenFlow protocol version
sion
msg_type Type of OpenFlow message
msg_len Length of the message
xid Transaction id
body OpenFlow body data

Note: "datapath" attribute is different from ryu.controller.controller.Datapath. So you can not use "datapath"
attribute to send OpenFlow messages. For example, "datapath" attribute does not have send_msg method.

class ryu.lib.packet.openflow.openflow(msg)
OpenFlow message encoder/decoder class.
An instance has the following attributes at least.

At- Description
tribute
msg An instance of OpenFlow message (see OpenFlow protocol API Reference) or an instance of OF-
PUnparseableMsg if failed to parse packet as OpenFlow message.

2.4. Library 83
ryu Documentation, Release 4.34

OSPF

RFC 2328 OSPF version 2

exception ryu.lib.packet.ospf.InvalidChecksum
class ryu.lib.packet.ospf.OSPFDBDesc(length=None, router_id=’0.0.0.0’, area_id=’0.0.0.0’,
au_type=1, authentication=0, checksum=None, ver-
sion=2, mtu=1500, options=0, i_flag=0, m_flag=0,
ms_flag=0, sequence_number=0, lsa_headers=None)

84 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.ospf.OSPFLSAck(length=None, router_id=’0.0.0.0’, area_id=’0.0.0.0’,

au_type=1, authentication=0, checksum=None, ver-
sion=2, lsa_headers=None)

2.4. Library 85
ryu Documentation, Release 4.34

• An object to describe the decoded header.

PBB

class ryu.lib.packet.pbb.itag(pcp=0, dei=0, uca=0, sid=0)

I-TAG (IEEE 802.1ah-2008) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
pcp Priority Code Point
dei Drop Eligible Indication
uca Use Customer Address
sid Service Instance ID

86 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

SCTP

class ryu.lib.packet.sctp.cause_cookie_while_shutdown(length=0)
Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Cookie Received While Shutting
Down (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_invalid_param(length=0)
Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Invalid Mandatory Parameter
(RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_invalid_stream_id(value=0, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Invalid Stream Identifier (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value stream id.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_missing_param(types=None, num=0, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Missing Mandatory Parameter
(RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort

2.4. Library 87
ryu Documentation, Release 4.34

• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
types a list of missing params.
num Number of missing params. (0 means automatically-calculate when encoding)
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_no_userdata(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for No User Data (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value the TSN of the DATA chunk received with no user data field.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_out_of_resource(length=0)
Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Out of Resource (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_protocol_violation(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Protocol Violation (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value Additional Information.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

88 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.sctp.cause_restart_with_new_addr(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Restart of an Association with
New Addresses (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value New Address TLVs.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_stale_cookie(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Stale Cookie Error (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value Measure of Staleness.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_unrecognized_chunk(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Unrecognized Chunk Type (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value Unrecognized Chunk.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_unrecognized_param(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Unrecognized Parameters (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error

2.4. Library 89
ryu Documentation, Release 4.34

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value Unrecognized Parameter.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_unresolvable_addr(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Unresolvable Address (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value Unresolvable Address. one of follows:
ryu.lib.packet.sctp.param_host_addr,
ryu.lib.packet.sctp.param_ipv4, or
ryu.lib.packet.sctp.param_ipv6.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.cause_user_initiated_abort(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for User-Initiated Abort (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_abort
• ryu.lib.packet.sctp.chunk_error
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value Upper Layer Abort Reason.
length length of this cause containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.chunk_abort(tflag=0, length=0, causes=None)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Abort Association (ABORT)
chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
tflag ’0’ means the Verification tag is normal. ’1’ means the Verification tag is copy of the sender.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)
causes a list of derived classes of ryu.lib.packet.sctp.causes.

90 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.sctp.chunk_cookie_ack(flags=0, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Cookie Acknowledgement
(COOKIE ACK) chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.chunk_cookie_echo(flags=0, length=0, cookie=None)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Cookie Echo (COOKIE ECHO)
chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)
cookie cookie data.

class ryu.lib.packet.sctp.chunk_cwr(flags=0, length=0, low_tsn=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for CWR chunk (RFC 4960 Appendix
A.).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)
low_tsn the lowest TSN.

class ryu.lib.packet.sctp.chunk_data(unordered=0, begin=0, end=0, length=0, tsn=0, sid=0,

seq=0, payload_id=0, payload_data=None)
Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Payload Data (DATA) chunk (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 91
ryu Documentation, Release 4.34

Attribute Description
unordered if set to ’1’, the receiver ignores the sequence number.
begin if set to ’1’, this chunk is the first fragment.
end if set to ’1’, this chunk is the last fragment.
length length of this chunk containing this header. (0 means automatically-calculate when
encoding)
tsn Transmission Sequence Number.
sid stream id.
seq the sequence number.
payload_id application specified protocol id. ’0’ means that no application id is identified.
payload_data user data.

class ryu.lib.packet.sctp.chunk_ecn_echo(flags=0, length=0, low_tsn=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for ECN-Echo chunk (RFC 4960
Appendix A.).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)
low_tsn the lowest TSN.

class ryu.lib.packet.sctp.chunk_error(flags=0, length=0, causes=None)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Operation Error (ERROR) chunk
(RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)
causes a list of derived classes of ryu.lib.packet.sctp.causes.

class ryu.lib.packet.sctp.chunk_heartbeat(flags=0, length=0, info=None)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Heartbeat Request (HEARTBEAT)
chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

92 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)
info ryu.lib.packet.sctp.param_heartbeat.

class ryu.lib.packet.sctp.chunk_heartbeat_ack(flags=0, length=0, info=None)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Heartbeat Acknowledgement
(HEARTBEAT ACK) chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

class ryu.lib.packet.sctp.chunk_init(flags=0, length=0, init_tag=0, a_rwnd=0, os=0,

mis=0, i_tsn=0, params=None)
Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Initiation (INIT) chunk (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)
init_tag the tag that be used as Verification Tag.
a_rwnd Advertised Receiver Window Credit.
os number of outbound streams.
mis number of inbound streams.
i_tsn Transmission Sequence Number that the sender will use.
params Optional/Variable-Length Parameters.
a list of derived classes of ryu.lib.packet.sctp.param.

class ryu.lib.packet.sctp.chunk_init_ack(flags=0, length=0, init_tag=0, a_rwnd=0, os=0,

mis=0, i_tsn=0, params=None)
Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Initiation Acknowledgement (INIT
ACK) chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 93
ryu Documentation, Release 4.34

class ryu.lib.packet.sctp.chunk_sack(flags=0, length=0, tsn_ack=0, a_rwnd=0,

gapack_num=0, duptsn_num=0, gapacks=None,
duptsns=None)
Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Selective Acknowledgement
(SACK) chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when
encoding)
tsn_ack TSN of the last DATA chunk received in sequence before a gap.
a_rwnd Advertised Receiver Window Credit.
gapack_num number of Gap Ack blocks.
duptsn_num number of duplicate TSNs.
gapacks a list of Gap Ack blocks. one block is made of a list with the start offset and the end offset
from tsn_ack. e.g.) gapacks = [[2, 3], [10, 12], [19, 21]]
duptsns a list of duplicate TSN.

class ryu.lib.packet.sctp.chunk_shutdown(flags=0, length=0, tsn_ack=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Shutdown Association (SHUT-
DOWN) chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

class ryu.lib.packet.sctp.chunk_shutdown_ack(flags=0, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Shutdown Acknowledgement
(SHUTDOWN ACK) chunk (RFC 4960).

94 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

This class is used with the following.

• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
flags set to ’0’. this field will be ignored.
length length of this chunk containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.chunk_shutdown_complete(tflag=0, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Shutdown Complete (SHUT-
DOWN COMPLETE) chunk (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.sctp
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

class ryu.lib.packet.sctp.param_cookie_preserve(value=0, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Cookie Preservative Parameter
(RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value Suggested Cookie Life-Span Increment (msec).
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.param_ecn(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for ECN Parameter (RFC 4960 Ap-
pendix A.).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init
• ryu.lib.packet.sctp.chunk_init_ack
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value set to None.
length length of this param containing this header. (0 means automatically-calculate when encoding)

2.4. Library 95
ryu Documentation, Release 4.34

class ryu.lib.packet.sctp.param_heartbeat(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Heartbeat Info Parameter (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_heartbeat
• ryu.lib.packet.sctp.chunk_heartbeat_ack
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value the sender-specific heartbeat information.
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.param_host_addr(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Host Name Address Parameter
(RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init
• ryu.lib.packet.sctp.chunk_init_ack
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value a host name that ends with null terminator.
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.param_ipv4(value=’127.0.0.1’, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for IPv4 Address Parameter (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init
• ryu.lib.packet.sctp.chunk_init_ack
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value IPv4 address of the sending endpoint.
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.param_ipv6(value=’::1’, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for IPv6 Address Parameter (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init
• ryu.lib.packet.sctp.chunk_init_ack

96 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value IPv6 address of the sending endpoint.
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.param_state_cookie(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for State Cookie Parameter (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init_ack
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value the state cookie. see Section 5.1.3 in RFC 4960.
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.param_supported_addr(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Supported Address Types Param-
eter (RFC 4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value a list of parameter types. odd cases pad with 0x0000.
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.param_unrecognized_param(value=None, length=0)

Stream Control Transmission Protocol (SCTP) sub encoder/decoder class for Unrecognized Parameter (RFC
4960).
This class is used with the following.
• ryu.lib.packet.sctp.chunk_init_ack
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
value the unrecognized parameter in the INIT chunk.
length length of this param containing this header. (0 means automatically-calculate when encoding)

class ryu.lib.packet.sctp.sctp(src_port=1, dst_port=1, vtag=0, csum=0, chunks=None)

Stream Control Transmission Protocol (SCTP) header encoder/decoder class (RFC 4960).
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 97
ryu Documentation, Release 4.34

Attribute Description
src_port Source Port
dst_port Destination Port
vtag Verification Tag
csum Checksum (0 means automatically-calculate when encoding)
chunks a list of derived classes of ryu.lib.packet.sctp.chunk.

Slow

class ryu.lib.packet.slow.lacp(version=1, actor_system_priority=0, ac-

tor_system=’00:00:00:00:00:00’, actor_key=0, ac-
tor_port_priority=0, actor_port=0, actor_state_activity=0,
actor_state_timeout=0, actor_state_aggregation=0, ac-
tor_state_synchronization=0, actor_state_collecting=0,
actor_state_distributing=0, actor_state_defaulted=0, ac-
tor_state_expired=0, partner_system_priority=0, part-
ner_system=’00:00:00:00:00:00’, partner_key=0, part-
ner_port_priority=0, partner_port=0, partner_state_activity=0,
partner_state_timeout=0, partner_state_aggregation=0, part-
ner_state_synchronization=0, partner_state_collecting=0,
partner_state_distributing=0, partner_state_defaulted=0,
partner_state_expired=0, collector_max_delay=0)
Link Aggregation Control Protocol(LACP, IEEE 802.1AX) header encoder/decoder class.
http://standards.ieee.org/getieee802/download/802.1AX-2008.pdf
LACPDU format

98 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

LACPDU structure Octets

Subtype = LACP 1
Version Number 1
TLV Actor TLV_type = Actor Information 1
Actor_Information_Length = 20 1
Actor_System_Priority 2
Actor_System 6
Actor_Key 2
Actor_Port_Priority 2
Actor_Port 2
Actor_State 1
Reserved 3
TLV Partner TLV_type = Partner Information 1
Partner_Information_Length = 20 1
Partner_System_Priority 2
Partner_System 6
Partner_Key 2
Partner_Port_Priority 2
Partner_Port 2
Partner_State 1
Reserved 3
TLV Collector TLV_type = Collector Information 1
Collector_Information_Length = 16 1
Collector_Max_Delay 2
Reserved 12
TLV Terminator TLV_type = Terminator 1
Terminator_Length = 0 1
Reserved 50

Terminator information uses a length value of 0 (0x00).

NOTE–The use of a Terminator_Length of 0 is intentional. In TLV encoding schemes it is common practice
for the terminator encoding to be 0 both for the type and the length.
Actor_State and Partner_State encoded as individual bits within a single octet as follows:

7 6 5 4 3 2 1 0
EXPR DFLT DIST CLCT SYNC AGGR TMO ACT

ACT bit 0. about the activity control value with regard to this link.
TMO bit 1. about the timeout control value with regard to this link.
AGGR bit 2. about how the system regards this link from the point of view of the aggregation.
SYNC bit 3. about how the system regards this link from the point of view of the synchronization.
CLCT bit 4. about collecting of incoming frames.
DIST bit 5. about distributing of outgoing frames.
DFLT bit 6. about the opposite system information which the system use.
EXPR bit 7. about the expire state of the system.

2.4. Library 99
ryu Documentation, Release 4.34

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

100 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
version LACP version. This parameter must be set to
LACP_VERSION_NUMBER(i.e. 1).
actor_system_priority The priority assigned to this System.
actor_system The Actor’s System ID, encoded as a MAC address.
actor_key The operational Key value assigned to the port by the Actor.
actor_port_priority The priority assigned to this port.
actor_port The port number assigned to the port by the Actor.
actor_state_activity
about the activity control value with regard to this link.
LACP_STATE_ACTIVE(1)
LACP_STATE_PASSIVE(0)
actor_state_timeout
about the timeout control value with regard to this link.
LACP_STATE_SHORT_TIMEOUT(1)
LACP_STATE_LONG_TIMEOUT(0)
actor_state_aggregation
about how the system regards this link from the point of view of the
aggregation.
LACP_STATE_AGGREGATEABLE(1)
LACP_STATE_INDIVIDUAL(0)
actor_state_synchronization
about how the system regards this link from the point of view of the
synchronization.
LACP_STATE_IN_SYNC(1)
LACP_STATE_OUT_OF_SYNC(0)
actor_state_collecting
about collecting of incoming frames.
LACP_STATE_COLLECTING_ENABLED(1)
LACP_STATE_COLLECTING_DISABLED(0)
actor_state_distributing
about distributing of outgoing frames.
LACP_STATE_DISTRIBUTING_ENABLED(1)
LACP_STATE_DISTRIBUTING_DISABLED(0)
actor_state_defaulted
about the Partner information which the the Actor use.
LACP_STATE_DEFAULTED_PARTNER(1)
LACP_STATE_OPERATIONAL_PARTNER(0)
actor_state_expired
about the state of the Actor.
LACP_STATE_EXPIRED(1)
LACP_STATE_NOT_EXPIRED(0)
partner_system_priority The priority assigned to the Partner System.
partner_system The Partner’s System ID, encoded as a MAC address.
partner_key The operational Key value assigned to the port by the Partner.
partner_port_priority The priority assigned to this port by the Partner.
partner_port The port number assigned to the port by the Partner.
partner_state_activity See actor_state_activity.
partner_state_timeout See actor_state_timeout.
partner_state_aggregation See actor_state_aggregation.
partner_state_synchronization See actor_state_synchronization.
partner_state_collecting See actor_state_collecting.
partner_state_distributing See actor_state_distributing.
partner_state_defaulted See actor_state_defaulted.
partner_state_expired See actor_state_expired.
collector_max_delay the maximum time that the Frame Collector may delay.

2.4. Library 101

ryu Documentation, Release 4.34

Subtype Value Protocol Name

0 Unused - Illegal Value
1 Link Aggregation Control Protocol(LACP)
2 Link Aggregation - Marker Protocol
3 Operations, Administration, and Maintenance(OAM)
4-9 Reserved for future use
10 Organization Specific Slow Protocol(OSSP)
11 - 255 Unused - Illegal values

TCP

class ryu.lib.packet.tcp.tcp(src_port=1, dst_port=1, seq=0, ack=0, offset=0, bits=0, win-

dow_size=0, csum=0, urgent=0, option=None)
TCP (RFC 793) header encoder/decoder class.

102 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
src_port Source Port
dst_port Destination Port
seq Sequence Number
ack Acknowledgement Number
offset Data Offset (0 means automatically-calculate when encoding)
bits Control Bits
window_size Window
csum Checksum (0 means automatically-calculate when encoding)
urgent Urgent Pointer
option List of TCPOption sub-classes or an bytearray containing options. None if no options.

has_flags(*flags)
Check if flags are set on this packet.
returns boolean if all passed flags is set
Example:

>>> pkt = tcp.tcp(bits=(tcp.TCP_SYN | tcp.TCP_ACK))

>>> pkt.has_flags(tcp.TCP_SYN, tcp.TCP_ACK)
True

UDP

class ryu.lib.packet.udp.udp(src_port=1, dst_port=1, total_length=0, csum=0)

UDP (RFC 768) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

2.4. Library 103

ryu Documentation, Release 4.34

Attribute Description
src_port Source Port
dst_port Destination Port
total_length Length (0 means automatically-calculate when encoding)
csum Checksum (0 means automatically-calculate when encoding)

static get_packet_type(src_port, dst_port)

Per-protocol dict-like get method.
Provided for convenience of protocol implementers. Internal use only.
classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.

VLAN

class ryu.lib.packet.vlan.svlan(pcp=0, cfi=0, vid=0, ethertype=33024)

S-VLAN (IEEE 802.1ad) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
pcp Priority Code Point
cfi Canonical Format Indicator. In a case to be used as B-TAG, this field means DEI(Drop Eligible
Indication).
vid VLAN Identifier
ethertype EtherType

classmethod get_packet_type(type_)
Per-protocol dict-like get method.
Provided for convenience of protocol implementers. Internal use only.

104 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.vlan.vlan(pcp=0, cfi=0, vid=0, ethertype=2048)

VLAN (IEEE 802.1Q) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
pcp Priority Code Point
cfi Canonical Format Indicator
vid VLAN Identifier
ethertype EtherType

classmethod get_packet_type(type_)
Override method for the Length/Type field (self.ethertype). The Length/Type field means Length or Type
interpretation, same as ethernet IEEE802.3. If the value of Length/Type field is less than or equal to 1500
decimal(05DC hexadecimal), it means Length interpretation and be passed to the LLC sublayer.

VRRP

VRRP packet parser/serializer

[RFC 3768] VRRP v2 packet format:

0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|Version| Type | Virtual Rtr ID| Priority | Count IP Addrs|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Auth Type | Adver Int | Checksum |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| IP Address (1) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| . |
| . |
| . |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| IP Address (n) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Authentication Data (1) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Authentication Data (2) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

[RFC 5798] VRRP v3 packet format:

2.4. Library 105

ryu Documentation, Release 4.34

(continued from previous page)

+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
+ +
| IPvX Address(es) |
+ +
+ +
+ +
+ +
| |
+ +
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

class ryu.lib.packet.vrrp.vrrp(version, type_, vrid, priority, count_ip, max_adver_int, check-

sum, ip_addresses, auth_type=None, auth_data=None)
The base class for VRRPv2 (RFC 3768) and VRRPv3 (RFC 5798) header encoder/decoder classes.
Unlike other ryu.lib.packet.packet_base.PacketBase derived classes, This class should not be directly instanti-
ated by user.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order.

Attribute Description
version Version
type Type
vrid Virtual Rtr ID (VRID)
priority Priority
count_ip Count IPvX Addr. Calculated automatically when encoding.
max_adver_int Maximum Advertisement Interval (Max Adver Int)
checksum Checksum. Calculated automatically when encoding.
ip_addresses IPvX Address(es). A python list of IP addresses.
auth_type Authentication Type (only for VRRPv2)
auth_data Authentication Data (only for VRRPv2)

create_packet(primary_ip_address, vlan_id=None)
Prepare a VRRP packet.
Returns a newly created ryu.lib.packet.packet.Packet object with appropriate protocol header objects added
by add_protocol(). It’s caller’s responsibility to serialize(). The serialized packet would looks like the ones
described in the following sections.
• RFC 3768 5.1. VRRP Packet Format
• RFC 5798 5.1. VRRP Packet Format

Argument Description
primary_ip_address Source IP address
vlan_id VLAN ID. None for no VLAN.

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.

106 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

• An object to describe the decoded header.

• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(payload, prev)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.vrrp.vrrpv2(version, type_, vrid, priority, count_ip, max_adver_int, check-
sum, ip_addresses, auth_type=None, auth_data=None)
VRRPv2 (RFC 3768) header encoder/decoder class.
Unlike other ryu.lib.packet.packet_base.PacketBase derived classes, create method should be used to instantiate
an object of this class.
static create(type_, vrid, priority, max_adver_int, ip_addresses)
Unlike other ryu.lib.packet.packet_base.PacketBase derived classes, this method should be used to instan-
tiate an object of this class.
This method’s arguments are same as ryu.lib.packet.vrrp.vrrp object’s attributes of the same name. (except
that type_ corresponds to type attribute.)
classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.
• An object to describe the decoded header.
• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
class ryu.lib.packet.vrrp.vrrpv3(version, type_, vrid, priority, count_ip, max_adver_int, check-
sum, ip_addresses, auth_type=None, auth_data=None)
VRRPv3 (RFC 5798) header encoder/decoder class.
Unlike other ryu.lib.packet.packet_base.PacketBase derived classes, create method should be used to instantiate
an object of this class.
static create(type_, vrid, priority, max_adver_int, ip_addresses)
Unlike other ryu.lib.packet.packet_base.PacketBase derived classes, this method should be used to instan-
tiate an object of this class.
This method’s arguments are same as ryu.lib.packet.vrrp.vrrp object’s attributes of the same name. (except
that type_ corresponds to type attribute.)
classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.

2.4. Library 107

ryu Documentation, Release 4.34

VXLAN

ryu.lib.packet.vxlan.vni_from_bin(buf )
Converts binary representation VNI to integer.
Parameters buf – binary representation of VNI.
Returns VNI integer.
ryu.lib.packet.vxlan.vni_to_bin(vni)
Converts integer VNI to binary representation.
Parameters vni – integer of VNI
Returns binary representation of VNI.
class ryu.lib.packet.vxlan.vxlan(vni)
VXLAN (RFC 7348) header encoder/decoder class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

Attribute Description
vni VXLAN Network Identifier

108 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Zebra

Zebra protocol parser/serializer

Zebra Protocol is used to communicate with the zebra daemon.
class ryu.lib.packet.zebra.InterfaceLinkParams(lp_status, te_metric, max_bw,
max_reserved_bw, unreserved_bw,
admin_group, remote_as, remote_ip,
average_delay, min_delay, max_delay,
delay_var, pkt_loss, residual_bw,
average_bw, utilized_bw)
Interface Link Parameters class for if_link_params structure.
class ryu.lib.packet.zebra.NextHopBlackhole(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_BLACKHOLE type.
class ryu.lib.packet.zebra.NextHopIFIndex(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IFINDEX type.
class ryu.lib.packet.zebra.NextHopIFName(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IFNAME type.
class ryu.lib.packet.zebra.NextHopIPv4(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IPV4 type.
class ryu.lib.packet.zebra.NextHopIPv4IFIndex(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IPV4_IFINDEX type.
class ryu.lib.packet.zebra.NextHopIPv4IFName(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IPV4_IFNAME type.
class ryu.lib.packet.zebra.NextHopIPv6(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IPV6 type.
class ryu.lib.packet.zebra.NextHopIPv6IFIndex(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IPV6_IFINDEX type.
class ryu.lib.packet.zebra.NextHopIPv6IFName(ifindex=None, ifname=None, addr=None,
type_=None)
Nexthop class for ZEBRA_NEXTHOP_IPV6_IFNAME type.
class ryu.lib.packet.zebra.RegisteredNexthop(connected, family, prefix)
Unit of ZEBRA_NEXTHOP_REGISTER message body.
class ryu.lib.packet.zebra.ZebraBfdClientRegister(pid)
Message body class for FRR_ZEBRA_BFD_CLIENT_REGISTER.
class ryu.lib.packet.zebra.ZebraBfdDestinationDeregister(pid, dst_family,
dst_prefix, multi_hop,
src_family, src_prefix,
multi_hop_count=None,
ifname=None)
Message body class for FRR_ZEBRA_BFD_DEST_DEREGISTER.

2.4. Library 109

ryu Documentation, Release 4.34

class ryu.lib.packet.zebra.ZebraBfdDestinationRegister(pid, dst_family,

dst_prefix, min_rx_timer,
min_tx_timer, de-
tect_mult, multi_hop,
src_family, src_prefix,
multi_hop_count=None,
ifname=None)
Message body class for FRR_ZEBRA_BFD_DEST_REGISTER.
class ryu.lib.packet.zebra.ZebraBfdDestinationReply
Message body class for FRR_ZEBRA_BFD_DEST_REPLAY.
class ryu.lib.packet.zebra.ZebraBfdDestinationUpdate(pid, dst_family, dst_prefix,
min_rx_timer, min_tx_timer,
detect_mult, multi_hop,
src_family, src_prefix,
multi_hop_count=None, if-
name=None)
Message body class for FRR_ZEBRA_BFD_DEST_UPDATE.
class ryu.lib.packet.zebra.ZebraHello(route_type, instance=None)
Message body class for ZEBRA_HELLO.
class ryu.lib.packet.zebra.ZebraIPv4ImportLookup(prefix, metric=None, nexthops=None,
from_zebra=False)
Message body class for ZEBRA_IPV4_IMPORT_LOOKUP.
class ryu.lib.packet.zebra.ZebraIPv4NexthopAdd(route_type, flags, message, safi=None,
prefix=None, src_prefix=None,
nexthops=None, ifindexes=None,
distance=None, metric=None,
mtu=None, tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_IPV4_NEXTHOP_ADD.
class ryu.lib.packet.zebra.ZebraIPv4NexthopDelete(route_type, flags, message,
safi=None, prefix=None,
src_prefix=None, nexthops=None,
ifindexes=None, distance=None,
metric=None, mtu=None,
tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_IPV4_NEXTHOP_DELETE.
class ryu.lib.packet.zebra.ZebraIPv4NexthopLookup(addr, metric=None, nex-
thops=None)
Message body class for ZEBRA_IPV4_NEXTHOP_LOOKUP.
class ryu.lib.packet.zebra.ZebraIPv4NexthopLookupMRib(addr, distance=None, met-
ric=None, nexthops=None)
Message body class for ZEBRA_IPV4_NEXTHOP_LOOKUP_MRIB.
class ryu.lib.packet.zebra.ZebraIPv4RouteAdd(route_type, flags, message, safi=None,
prefix=None, src_prefix=None,
nexthops=None, ifindexes=None,
distance=None, metric=None,
mtu=None, tag=None, instance=None,
from_zebra=False)
Message body class for ZEBRA_IPV4_ROUTE_ADD.

110 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.zebra.ZebraIPv4RouteDelete(route_type, flags, message, safi=None,

prefix=None, src_prefix=None,
nexthops=None, ifindexes=None,
distance=None, metric=None,
mtu=None, tag=None, instance=None,
from_zebra=False)
Message body class for ZEBRA_IPV4_ROUTE_DELETE.
class ryu.lib.packet.zebra.ZebraIPv4RouteIPv6NexthopAdd(route_type, flags, message,
safi=None, prefix=None,
src_prefix=None, nex-
thops=None, ifind-
exes=None, dis-
tance=None, met-
ric=None, mtu=None,
tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_IPV4_ROUTE_IPV6_NEXTHOP_ADD.
class ryu.lib.packet.zebra.ZebraIPv6ImportLookup(prefix, metric=None, nexthops=None,
from_zebra=False)
Message body class for ZEBRA_IPV6_IMPORT_LOOKUP.
class ryu.lib.packet.zebra.ZebraIPv6NexthopAdd(route_type, flags, message, safi=None,
prefix=None, src_prefix=None,
nexthops=None, ifindexes=None,
distance=None, metric=None,
mtu=None, tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_IPV6_NEXTHOP_ADD.
class ryu.lib.packet.zebra.ZebraIPv6NexthopDelete(route_type, flags, message,
safi=None, prefix=None,
src_prefix=None, nexthops=None,
ifindexes=None, distance=None,
metric=None, mtu=None,
tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_IPV6_NEXTHOP_DELETE.
class ryu.lib.packet.zebra.ZebraIPv6NexthopLookup(addr, metric=None, nex-
thops=None)
Message body class for ZEBRA_IPV6_NEXTHOP_LOOKUP.
class ryu.lib.packet.zebra.ZebraIPv6RouteAdd(route_type, flags, message, safi=None,
prefix=None, src_prefix=None,
nexthops=None, ifindexes=None,
distance=None, metric=None,
mtu=None, tag=None, instance=None,
from_zebra=False)
Message body class for ZEBRA_IPV6_ROUTE_ADD.
class ryu.lib.packet.zebra.ZebraIPv6RouteDelete(route_type, flags, message, safi=None,
prefix=None, src_prefix=None,
nexthops=None, ifindexes=None,
distance=None, metric=None,
mtu=None, tag=None, instance=None,
from_zebra=False)
Message body class for ZEBRA_IPV6_ROUTE_DELETE.

2.4. Library 111

ryu Documentation, Release 4.34

class ryu.lib.packet.zebra.ZebraImportCheckUpdate(family, prefix, distance=None, met-

ric=None, nexthops=None)
Message body class for FRR_ZEBRA_IMPORT_CHECK_UPDATE.
class ryu.lib.packet.zebra.ZebraImportRouteRegister(nexthops)
Message body class for FRR_ZEBRA_IMPORT_ROUTE_REGISTER.
class ryu.lib.packet.zebra.ZebraImportRouteUnregister(nexthops)
Message body class for FRR_ZEBRA_IMPORT_ROUTE_UNREGISTER.
class ryu.lib.packet.zebra.ZebraInterfaceAdd(ifname=None, ifindex=None, status=None,
if_flags=None, ptm_enable=None,
ptm_status=None, metric=None,
speed=None, ifmtu=None, ifmtu6=None,
bandwidth=None, ll_type=None,
hw_addr_len=0, hw_addr=None,
link_params=None)
Message body class for ZEBRA_INTERFACE_ADD.
class ryu.lib.packet.zebra.ZebraInterfaceAddressAdd(ifindex, ifc_flags, family, prefix,
dest)
Message body class for ZEBRA_INTERFACE_ADDRESS_ADD.
class ryu.lib.packet.zebra.ZebraInterfaceAddressDelete(ifindex, ifc_flags, family,
prefix, dest)
Message body class for ZEBRA_INTERFACE_ADDRESS_DELETE.
class ryu.lib.packet.zebra.ZebraInterfaceBfdDestinationUpdate(ifindex,
dst_family,
dst_prefix, sta-
tus, src_family,
src_prefix)
Message body class for FRR_ZEBRA_INTERFACE_BFD_DEST_UPDATE.
class ryu.lib.packet.zebra.ZebraInterfaceDelete(ifname=None, ifindex=None,
status=None, if_flags=None,
ptm_enable=None, ptm_status=None,
metric=None, speed=None,
ifmtu=None, ifmtu6=None, band-
width=None, ll_type=None,
hw_addr_len=0, hw_addr=None,
link_params=None)
Message body class for ZEBRA_INTERFACE_DELETE.
class ryu.lib.packet.zebra.ZebraInterfaceDisableRadv(ifindex, interval)
Message body class for FRR_ZEBRA_INTERFACE_DISABLE_RADV.
class ryu.lib.packet.zebra.ZebraInterfaceDown(ifname=None, ifindex=None,
status=None, if_flags=None,
ptm_enable=None, ptm_status=None,
metric=None, speed=None, ifmtu=None,
ifmtu6=None, bandwidth=None,
ll_type=None, hw_addr_len=0,
hw_addr=None, link_params=None)
Message body class for ZEBRA_INTERFACE_DOWN.
class ryu.lib.packet.zebra.ZebraInterfaceEnableRadv(ifindex, interval)
Message body class for FRR_ZEBRA_INTERFACE_ENABLE_RADV.
class ryu.lib.packet.zebra.ZebraInterfaceLinkParams(ifindex, link_params)
Message body class for ZEBRA_INTERFACE_LINK_PARAMS.

112 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.zebra.ZebraInterfaceNbrAddressAdd(ifindex, family, prefix)

Message body class for FRR_ZEBRA_INTERFACE_NBR_ADDRESS_ADD.
class ryu.lib.packet.zebra.ZebraInterfaceNbrAddressDelete(ifindex, family, prefix)
Message body class for FRR_ZEBRA_INTERFACE_NBR_ADDRESS_DELETE.
class ryu.lib.packet.zebra.ZebraInterfaceUp(ifname=None, ifindex=None, status=None,
if_flags=None, ptm_enable=None,
ptm_status=None, metric=None,
speed=None, ifmtu=None, ifmtu6=None,
bandwidth=None, ll_type=None,
hw_addr_len=0, hw_addr=None,
link_params=None)
Message body class for ZEBRA_INTERFACE_UP.
class ryu.lib.packet.zebra.ZebraInterfaceVrfUpdate(ifindex, vrf_id)
Message body class for FRR_ZEBRA_INTERFACE_VRF_UPDATE.
class ryu.lib.packet.zebra.ZebraMessage(length=None, version=3, vrf_id=0, com-
mand=None, body=None)
Zebra protocol parser/serializer class.
An instance has the following attributes at least. Most of them are same to the on-wire counterparts but in host
byte order. __init__ takes the corresponding args in this order.

At- Description
tribute
length Total packet length including this header. The minimum length is 3 bytes for version 0 messages, 6
bytes for version 1/2 messages and 8 bytes for version 3 messages.
ver- Version number of the Zebra protocol message. To instantiate messages with other than the default
sion version, version must be specified.
vrf_id VRF ID for the route contained in message. Not present in version 0/1/2 messages in the on-wire
structure, and always 0 for theses version.
com- Zebra Protocol command, which denotes message type.
mand
body Messages body. An instance of subclass of _ZebraMessageBody named like "Zebra + <message
name>" (e.g., ZebraHello). Or None if message does not contain any body.

Note: To instantiate Zebra messages, command can be omitted when the valid body is specified.

>>> from ryu.lib.packet import zebra

>>> zebra.ZebraMessage(body=zebra.ZebraHello())
ZebraMessage(body=ZebraHello(route_type=14),command=23,
length=None,version=3,vrf_id=0)

On the other hand, if body is omitted, command must be specified.

>>> zebra.ZebraMessage(command=zebra.ZEBRA_INTERFACE_ADD)
ZebraMessage(body=None,command=1,length=None,version=3,vrf_id=0)

classmethod parser(buf )
Decode a protocol header.
This method is used only when decoding a packet.
Decode a protocol header at offset 0 in bytearray buf. Returns the following three objects.

2.4. Library 113

ryu Documentation, Release 4.34

• An object to describe the decoded header.

• A packet_base.PacketBase subclass appropriate for the rest of the packet. None when the rest of the
packet should be considered as raw payload.
• The rest of packet.
serialize(_payload=None, _prev=None)
Encode a protocol header.
This method is used only when encoding a packet.
Encode a protocol header. Returns a bytearray which contains the header.
payload is the rest of the packet which will immediately follow this header.
prev is a packet_base.PacketBase subclass for the outer protocol header. prev is None if the current header
is the outer-most. For example, prev is ipv4 or ipv6 for tcp.serialize.
class ryu.lib.packet.zebra.ZebraMplsLabelsAdd(route_type, family, prefix, gate_addr,
ifindex=None, distance=None,
in_label=None, out_label=None)
Message body class for FRR_ZEBRA_MPLS_LABELS_ADD.
class ryu.lib.packet.zebra.ZebraMplsLabelsDelete(route_type, family, prefix, gate_addr,
ifindex=None, distance=None,
in_label=None, out_label=None)
Message body class for FRR_ZEBRA_MPLS_LABELS_DELETE.
class ryu.lib.packet.zebra.ZebraNexthopRegister(nexthops)
Message body class for ZEBRA_NEXTHOP_REGISTER.
class ryu.lib.packet.zebra.ZebraNexthopUnregister(nexthops)
Message body class for ZEBRA_NEXTHOP_UNREGISTER.
class ryu.lib.packet.zebra.ZebraNexthopUpdate(family, prefix, distance=None, met-
ric=None, nexthops=None)
Message body class for ZEBRA_NEXTHOP_UPDATE.
class ryu.lib.packet.zebra.ZebraRedistributeAdd(route_type, afi=None, instance=None)
Message body class for ZEBRA_REDISTRIBUTE_ADD.
class ryu.lib.packet.zebra.ZebraRedistributeDefaultAdd(route_type, afi=None, in-
stance=None)
Message body class for ZEBRA_REDISTRIBUTE_DEFAULT_ADD.
class ryu.lib.packet.zebra.ZebraRedistributeDefaultDelete(route_type, afi=None,
instance=None)
Message body class for ZEBRA_REDISTRIBUTE_DEFAULT_DELETE.
class ryu.lib.packet.zebra.ZebraRedistributeDelete(route_type, afi=None, in-
stance=None)
Message body class for ZEBRA_REDISTRIBUTE_DELETE.
class ryu.lib.packet.zebra.ZebraRedistributeIPv4Add(route_type, flags, mes-
sage, safi=None, pre-
fix=None, src_prefix=None,
nexthops=None, ifind-
exes=None, distance=None,
metric=None, mtu=None,
tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_IPV4_ROUTE_ADD.

114 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.lib.packet.zebra.ZebraRedistributeIPv4Delete(route_type, flags, mes-

sage, safi=None, pre-
fix=None, src_prefix=None,
nexthops=None, ifind-
exes=None, distance=None,
metric=None, mtu=None,
tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_IPV4_ROUTE_DELETE.
class ryu.lib.packet.zebra.ZebraRedistributeIPv6Add(route_type, flags, mes-
sage, safi=None, pre-
fix=None, src_prefix=None,
nexthops=None, ifind-
exes=None, distance=None,
metric=None, mtu=None,
tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_REDISTRIBUTE_IPV6_ADD.
class ryu.lib.packet.zebra.ZebraRedistributeIPv6Delete(route_type, flags, mes-
sage, safi=None, pre-
fix=None, src_prefix=None,
nexthops=None, ifind-
exes=None, distance=None,
metric=None, mtu=None,
tag=None, instance=None,
from_zebra=False)
Message body class for FRR_ZEBRA_REDISTRIBUTE_IPV6_DEL.
class ryu.lib.packet.zebra.ZebraRouterIDAdd
Message body class for ZEBRA_ROUTER_ID_ADD.
class ryu.lib.packet.zebra.ZebraRouterIDDelete
Message body class for ZEBRA_ROUTER_ID_DELETE.
class ryu.lib.packet.zebra.ZebraRouterIDUpdate(family, prefix)
Message body class for ZEBRA_ROUTER_ID_UPDATE.
class ryu.lib.packet.zebra.ZebraUnknownMessage(buf )
Message body class for Unknown command.
class ryu.lib.packet.zebra.ZebraVrfAdd(vrf_name)
Message body class for FRR_ZEBRA_VRF_ADD.
class ryu.lib.packet.zebra.ZebraVrfDelete(vrf_name)
Message body class for FRR_ZEBRA_VRF_DELETE.
class ryu.lib.packet.zebra.ZebraVrfUnregister
Message body class for ZEBRA_VRF_UNREGISTER.
ryu.lib.packet.zebra.zebra
alias of ryu.lib.packet.zebra.ZebraMessage

2.4.3 PCAP file library

2.4. Library 115

ryu Documentation, Release 4.34

Introduction

Ryu PCAP file library helps you to read/write PCAP file which file format are described in The Wireshark Wiki.

Reading PCAP file

For loading the packet data containing in PCAP files, you can use pcaplib.Reader.
class ryu.lib.pcaplib.Reader(file_obj)
PCAP file reader

Argument Description
file_obj File object which reading PCAP file in binary mode

Example of usage:

from ryu.lib import pcaplib

from ryu.lib.packet import packet

frame_count = 0
# iterate pcaplib.Reader that yields (timestamp, packet_data)
# in the PCAP file
for ts, buf in pcaplib.Reader(open('test.pcap', 'rb')):
frame_count += 1
pkt = packet.Packet(buf)
print("%d, %f, %s" % (frame_count, ts, pkt))

Writing PCAP file

For dumping the packet data which your RyuApp received, you can use pcaplib.Writer.
class ryu.lib.pcaplib.Writer(file_obj, snaplen=65535, network=1)
PCAP file writer

Argument Description
file_obj File object which writing PCAP file in binary mode
snaplen Max length of captured packets (in octets)
network Data link type. (e.g. 1 for Ethernet, see tcpdump.org for details)

Example of usage:

...
from ryu.lib import pcaplib

class SimpleSwitch13(app_manager.RyuApp):
OFP_VERSIONS = [ofproto_v1_3.OFP_VERSION]

def init(self, *args, **kwargs):

super(SimpleSwitch13, self).__init__(*args, **kwargs)
self.mac_to_port = {}

# Create pcaplib.Writer instance with a file object

(continues on next page)

116 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

# for the PCAP file
self.pcap_writer = pcaplib.Writer(open('mypcap.pcap', 'wb'))

...

@set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
def _packet_in_handler(self, ev):
# Dump the packet data into PCAP file
self.pcap_writer.write_pkt(ev.msg.data)

...

2.4.4 OF-Config support

Ryu has a library for OF-Config support.

XML schema files for NETCONFIG and OFConfig

XML schema files for NETCONF and OFConfig are stolen from LINC whose licence is Apache 2.0. It supports only
part of OFConfig so that its schema files are (intentionally) limited such that operation attributes are allowed only in
several limited places. Once our library is tested with other OFConfig switches, the schema files should be updated to
allow operation attribute in more places.

References

• NETCONF ietf,
• NETCONF ietf wiki,
• OF-Config spec,
• ncclient,
• ncclient repo,
• LINC git repo

2.4.5 BGP speaker library

Introduction

Ryu BGP speaker library helps you to enable your code to speak BGP protocol. The library supports IPv4, IPv4
MPLS-labeled VPN, IPv6 MPLS-labeled VPN and L2VPN EVPN address families.

Example

The following simple code creates a BGP instance with AS number 64512 and Router ID 10.0.0.1. It tries to establish a
bgp session with a peer (its IP is 192.168.177.32 and the AS number is 64513). The instance advertizes some prefixes.

2.4. Library 117

ryu Documentation, Release 4.34

import eventlet

# BGPSpeaker needs sockets patched

eventlet.monkey_patch()

# initialize a log handler

# this is not strictly necessary but useful if you get messages like:
# No handlers could be found for logger "ryu.lib.hub"
import logging
import sys
log = logging.getLogger()
log.addHandler(logging.StreamHandler(sys.stderr))

from ryu.services.protocols.bgp.bgpspeaker import BGPSpeaker

def dump_remote_best_path_change(event):
print 'the best path changed:', event.remote_as, event.prefix,\
event.nexthop, event.is_withdraw

def detect_peer_down(remote_ip, remote_as):

print 'Peer down:', remote_ip, remote_as

if __name__ == "__main__":
speaker = BGPSpeaker(as_number=64512, router_id='10.0.0.1',
best_path_change_handler=dump_remote_best_path_change,
peer_down_handler=detect_peer_down)

speaker.neighbor_add('192.168.177.32', 64513)
# uncomment the below line if the speaker needs to talk with a bmp server.
# speaker.bmp_server_add('192.168.177.2', 11019)
count = 1
while True:
eventlet.sleep(30)
prefix = '10.20.' + str(count) + '.0/24'
print "add a new prefix", prefix
speaker.prefix_add(prefix)
count += 1
if count == 4:
speaker.shutdown()
break

2.4.6 BGP speaker library API Reference

118 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

BGPSpeaker class

class ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker(as_number, router_id,

bgp_server_hosts=(’0.0.0.0’,
’::’), bgp_server_port=179,
refresh_stalepath_time=0,
refresh_max_eor_time=0,
best_path_change_handler=None,
adj_rib_in_change_handler=None,
peer_down_handler=None,
peer_up_handler=None,
ssh_console=False,
ssh_port=None,
ssh_host=None,
ssh_host_key=None,
label_range=(100,
100000), al-
low_local_as_in_count=0,
cluster_id=None, lo-
cal_pref=100)
Class to provide the APIs of Ryu BGP Speaker.
as_number specifies an Autonomous Number. It must be an integer between 1 and 65535.
router_id specifies BGP router identifier. It must be the string representation of an IPv4 address (e.g.
10.0.0.1).
bgp_server_host specifies a list of TCP listen host addresses.
bgp_server_port specifies TCP listen port number. 179 is used if not specified.
refresh_stalepath_time causes the BGP speaker to remove stale routes from the BGP table after the
timer expires, even if the speaker does not receive a Router-Refresh End-of-RIB message. This feature is
disabled (not implemented yet).
refresh_max_eor_time causes the BGP speaker to generate a Route-Refresh End-of-RIB message if it
was not able to generate one due to route flapping. This feature is disabled (not implemented yet).
best_path_change_handler, if specified, is called when any best remote path is changed due to an up-
date message or remote peer down. The handler is supposed to take one argument, the instance of an EventPrefix
class instance.
adj_rib_in_change_handler, if specified, is called when any adj-RIB-in path is changed due to an up-
date message or remote peer down. The given handler should take three argument, the instance of an EventPrefix
class instance, str type peer’s IP address and int type peer’s AS number.
peer_down_handler, if specified, is called when BGP peering session goes down.
peer_up_handler, if specified, is called when BGP peering session goes up.
ssh_console specifies whether or not SSH CLI need to be started.
ssh_port specifies the port number for SSH CLI server. The default is
bgp.operator.ssh.DEFAULT_SSH_PORT.
ssh_host specifies the IP address for SSH CLI server. The default is
bgp.operator.ssh.DEFAULT_SSH_HOST.
ssh_host_key specifies the path to the host key added to the keys list used by SSH CLI server. The default
is bgp.operator.ssh.DEFAULT_SSH_HOST_KEY.
label_range specifies the range of MPLS labels generated automatically.

2.4. Library 119

ryu Documentation, Release 4.34

allow_local_as_in_count maximum number of local AS number occurrences in AS_PATH. This option

is useful for e.g. auto RD/RT configurations in leaf/spine architecture with shared AS numbers. The default is
0 and means "local AS number is not allowed in AS_PATH". To allow local AS, 3 is recommended (Cisco’s
default).
cluster_id specifies the cluster identifier for Route Reflector. It must be the string representation of an IPv4
address. If omitted, "router_id" is used for this field.
local_pref specifies the default local preference. It must be an integer.
attribute_map_get(address, route_dist=None, route_family=’ipv4’)
This method gets in-bound filters of the specified neighbor.
address specifies the IP address of the neighbor.
route_dist specifies route distinguisher that has attribute_maps.
route_family specifies route family of the VRF. This parameter must be one of the following.
• RF_VPN_V4 (default) = ’ipv4’
• RF_VPN_V6 = ’ipv6’
Returns a list object containing an instance of AttributeMap
attribute_map_set(address, attribute_maps, route_dist=None, route_family=’ipv4’)
This method sets attribute mapping to a neighbor. attribute mapping can be used when you want to apply
attribute to BGPUpdate under specific conditions.
address specifies the IP address of the neighbor
attribute_maps specifies attribute_map list that are used before paths are advertised. All the items in
the list must be an instance of AttributeMap class
route_dist specifies route dist in which attribute_maps are added.
route_family specifies route family of the VRF. This parameter must be one of the following.
• RF_VPN_V4 (default) = ’ipv4’
• RF_VPN_V6 = ’ipv6’
We can set AttributeMap to a neighbor as follows:

pref_filter = PrefixFilter('192.168.103.0/30',
PrefixFilter.POLICY_PERMIT)

attribute_map = AttributeMap([pref_filter],
AttributeMap.ATTR_LOCAL_PREF, 250)

speaker.attribute_map_set('192.168.50.102', [attribute_map])

bmp_server_add(address, port)
This method registers a new BMP (BGP monitoring Protocol) server. The BGP speaker starts to send BMP
messages to the server. Currently, only one BMP server can be registered.
address specifies the IP address of a BMP server.
port specifies the listen port number of a BMP server.
bmp_server_del(address, port)
This method unregister the registered BMP server.
address specifies the IP address of a BMP server.
port specifies the listen port number of a BMP server.

120 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

evpn_prefix_add(route_type, route_dist, esi=0, ethernet_tag_id=None, mac_addr=None,

ip_addr=None, ip_prefix=None, gw_ip_addr=None, vni=None, next_hop=None,
tunnel_type=None, pmsi_tunnel_type=None, redundancy_mode=None, tun-
nel_endpoint_ip=None, mac_mobility=None)
This method adds a new EVPN route to be advertised.
route_type specifies one of the EVPN route type name. This parameter must be one of the following.
• EVPN_ETH_AUTO_DISCOVERY = ’eth_ad’
• EVPN_MAC_IP_ADV_ROUTE = ’mac_ip_adv’
• EVPN_MULTICAST_ETAG_ROUTE = ’multicast_etag’
• EVPN_ETH_SEGMENT = ’eth_seg’
• EVPN_IP_PREFIX_ROUTE = ’ip_prefix’
route_dist specifies a route distinguisher value.
esi is an value to specify the Ethernet Segment Identifier. 0 is the default and denotes a single-homed
site. If you want to advertise esi other than 0, it must be set as dictionary type. If esi is dictionary type,
’type’ key must be set and specifies ESI type. For the supported ESI type, see ryu.lib.packet.bgp.
EvpnEsi. The remaining arguments are the same as that for the corresponding class.
ethernet_tag_id specifies the Ethernet Tag ID.
mac_addr specifies a MAC address to advertise.
ip_addr specifies an IPv4 or IPv6 address to advertise.
ip_prefix specifies an IPv4 or IPv6 prefix to advertise.
gw_ip_addr specifies an IPv4 or IPv6 address of gateway to advertise.
vni specifies an Virtual Network Identifier for VXLAN or Virtual Subnet Identifier for NVGRE. If tun-
nel_type is not TUNNEL_TYPE_VXLAN or TUNNEL_TYPE_NVGRE, this field is ignored.
next_hop specifies the next hop address for this prefix.
tunnel_type specifies the data plane encapsulation type to advertise. By the default, this attribute is
not advertised. The supported encapsulation types are following.
• TUNNEL_TYPE_VXLAN = ’vxlan’
• TUNNEL_TYPE_NVGRE = ’nvgre
pmsi_tunnel_type specifies the type of the PMSI tunnel attribute used to encode the multicast tunnel
identifier. This attribute is advertised only if route_type is EVPN_MULTICAST_ETAG_ROUTE and not
advertised by the default. This attribute can also carry vni if tunnel_type is specified. The supported PMSI
tunnel types are following.
• PMSI_TYPE_NO_TUNNEL_INFO = 0
• PMSI_TYPE_INGRESS_REP = 6
redundancy_mode specifies a redundancy mode type. This attribute is advertised only if route_type
is EVPN_ETH_AUTO_DISCOVERY and not advertised by the default. The supported redundancy mode
types are following.
• REDUNDANCY_MODE_ALL_ACTIVE = ’all_active’
• REDUNDANCY_MODE_SINGLE_ACTIVE = ’single_active’
tunnel_endpoint_ip specifies a VTEP IP address other than the local router ID. This attribute is
advertised only if route_type is EVPN_MULTICAST_ETAG_ROUTE, and defaults to the local router ID.

2.4. Library 121

ryu Documentation, Release 4.34

mac_mobility specifies an optional integer sequence number to use in a MAC Mobility extended com-
munity field. The special value ’-1’ can be used to set the STATIC flag with a 0-value sequence number.
evpn_prefix_del(route_type, route_dist, esi=0, ethernet_tag_id=None, mac_addr=None,
ip_addr=None, ip_prefix=None)
This method deletes an advertised EVPN route.
route_type specifies one of the EVPN route type name.
route_dist specifies a route distinguisher value.
esi is an value to specify the Ethernet Segment Identifier.
ethernet_tag_id specifies the Ethernet Tag ID.
mac_addr specifies a MAC address to advertise.
ip_addr specifies an IPv4 or IPv6 address to advertise.
ip_prefix specifies an IPv4 or IPv6 prefix to advertise.
flowspec_prefix_add(flowspec_family, rules, route_dist=None, actions=None)
This method adds a new Flow Specification prefix to be advertised.
flowspec_family specifies one of the flowspec family name. This parameter must be one of the
following.
• FLOWSPEC_FAMILY_IPV4 = ’ipv4fs’
• FLOWSPEC_FAMILY_IPV6 = ’ipv6fs’
• FLOWSPEC_FAMILY_VPNV4 = ’vpnv4fs’
• FLOWSPEC_FAMILY_VPNV6 = ’vpnv6fs’
• FLOWSPEC_FAMILY_L2VPN = ’l2vpnfs’
rules specifies NLRIs of Flow Specification as a dictionary type value. For the supported NLRI types
and arguments, see from_user() method of the following classes.
• ryu.lib.packet.bgp.FlowSpecIPv4NLRI
• ryu.lib.packet.bgp.FlowSpecIPv6NLRI
• ryu.lib.packet.bgp.FlowSpecVPNv4NLRI
• ryu.lib.packet.bgp.FlowSpecVPNv6NLRI
• ryu.lib.packet.bgp.FlowSpecL2VPNNLRI
route_dist specifies a route distinguisher value. This parameter is required only if flowspec_family is
one of the following address family.
• FLOWSPEC_FAMILY_VPNV4 = ’vpnv4fs’
• FLOWSPEC_FAMILY_VPNV6 = ’vpnv6fs’
• FLOWSPEC_FAMILY_L2VPN = ’l2vpnfs’
actions specifies Traffic Filtering Actions of Flow Specification as a dictionary type value. The keys
are "ACTION_NAME" for each action class and values are used for the arguments to that class. For the
supported "ACTION_NAME" and arguments, see the following table.

122 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

ACTION_NAME Action Class

traffic_rate ryu.lib.packet.bgp.BGPFlowSpecTrafficRateCommunity
traffic_action ryu.lib.packet.bgp.BGPFlowSpecTrafficActionCommunity
redirect ryu.lib.packet.bgp.BGPFlowSpecRedirectCommunity
traffic_marking ryu.lib.packet.bgp.BGPFlowSpecTrafficMarkingCommunity
vlan_action ryu.lib.packet.bgp.BGPFlowSpecVlanActionCommunity
tpid_action ryu.lib.packet.bgp.BGPFlowSpecTPIDActionCommunity

Example(IPv4):

>>> speaker = BGPSpeaker(as_number=65001, router_id='172.17.0.1')

>>> speaker.neighbor_add(address='172.17.0.2',
... remote_as=65002,
... enable_ipv4fs=True)
>>> speaker.flowspec_prefix_add(
... flowspec_family=FLOWSPEC_FAMILY_IPV4,
... rules={
... 'dst_prefix': '10.60.1.0/24'
... },
... actions={
... 'traffic_marking': {
... 'dscp': 24
... }
... }
... )

Example(VPNv4):

>>> speaker = BGPSpeaker(as_number=65001, router_id='172.17.0.1')

>>> speaker.neighbor_add(address='172.17.0.2',
... remote_as=65002,
... enable_vpnv4fs=True)
>>> speaker.vrf_add(route_dist='65001:100',
... import_rts=['65001:100'],
... export_rts=['65001:100'],
... route_family=RF_VPNV4_FLOWSPEC)
>>> speaker.flowspec_prefix_add(
... flowspec_family=FLOWSPEC_FAMILY_VPNV4,
... route_dist='65000:100',
... rules={
... 'dst_prefix': '10.60.1.0/24'
... },
... actions={
... 'traffic_marking': {
... 'dscp': 24
... }
... }
... )

flowspec_prefix_del(flowspec_family, rules, route_dist=None)

This method deletes an advertised Flow Specification route.
flowspec_family specifies one of the flowspec family name.
rules specifies NLRIs of Flow Specification as a dictionary type value.
route_dist specifies a route distinguisher value.

2.4. Library 123

ryu Documentation, Release 4.34

in_filter_get(address)
This method gets in-bound filters of the specified neighbor.
address specifies the IP address of the neighbor.
Returns a list object containing an instance of Filter sub-class
in_filter_set(address, filters)
This method sets in-bound filters to a neighbor.
address specifies the IP address of the neighbor
filters specifies filter list applied before advertised paths are imported to the global rib. All the items
in the list must be an instance of Filter sub-class.
neighbor_add(address, remote_as, remote_port=179, enable_ipv4=True, enable_ipv6=False,
enable_vpnv4=False, enable_vpnv6=False, enable_evpn=False, en-
able_ipv4fs=False, enable_ipv6fs=False, enable_vpnv4fs=False, en-
able_vpnv6fs=False, enable_l2vpnfs=False, enable_enhanced_refresh=False,
enable_four_octet_as_number=True, next_hop=None, password=None,
multi_exit_disc=None, site_of_origins=None, is_route_server_client=False,
is_route_reflector_client=False, is_next_hop_self=False, local_address=None,
local_port=None, local_as=None, connect_mode=’both’)
This method registers a new neighbor. The BGP speaker tries to establish a bgp session with the peer
(accepts a connection from the peer and also tries to connect to it).
address specifies the IP address of the peer. It must be the string representation of an IP address. Only
IPv4 is supported now.
remote_as specifies the AS number of the peer. It must be an integer between 1 and 65535.
remote_port specifies the TCP port number of the peer.
enable_ipv4 enables IPv4 address family for this neighbor.
enable_ipv6 enables IPv6 address family for this neighbor.
enable_vpnv4 enables VPNv4 address family for this neighbor.
enable_vpnv6 enables VPNv6 address family for this neighbor.
enable_evpn enables Ethernet VPN address family for this neighbor.
enable_ipv4fs enables IPv4 Flow Specification address family for this neighbor.
enable_ipv6fs enables IPv6 Flow Specification address family for this neighbor.
enable_vpnv4fs enables VPNv4 Flow Specification address family for this neighbor.
enable_vpnv6fs enables VPNv6 Flow Specification address family for this neighbor.
enable_l2vpnfs enables L2VPN Flow Specification address family for this neighbor.
enable_enhanced_refresh enables Enhanced Route Refresh for this neighbor.
enable_four_octet_as_number enables Four-Octet AS Number capability for this neighbor.
next_hop specifies the next hop IP address. If not specified, host’s ip address to access to a peer is used.
password is used for the MD5 authentication if it’s specified. By default, the MD5 authentication is
disabled.
multi_exit_disc specifies multi exit discriminator (MED) value as an int type value. If omitted,
MED is not sent to the neighbor.
site_of_origins specifies site_of_origin values. This parameter must be a list of string.

124 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

is_route_server_client specifies whether this neighbor is a router server’s client or not.

is_route_reflector_client specifies whether this neighbor is a router reflector’s client or not.
is_next_hop_self specifies whether the BGP speaker announces its own ip address to iBGP neighbor
or not as path’s next_hop address.
local_address specifies Loopback interface address for iBGP peering.
local_port specifies source TCP port for iBGP peering.
local_as specifies local AS number per-peer. If omitted, the AS number of BGPSpeaker instance is
used.
connect_mode specifies how to connect to this neighbor. This parameter must be one of the following.
• CONNECT_MODE_ACTIVE = ’active’
• CONNECT_MODE_PASSIVE = ’passive’
• CONNECT_MODE_BOTH (default) = ’both’
neighbor_del(address)
This method unregister the registered neighbor. If a session with the peer exists, the session will be closed.
address specifies the IP address of the peer. It must be the string representation of an IP address.
neighbor_get(route_type, address, format=’json’)
This method returns the BGP adj-RIB-in/adj-RIB-out information in a json format.
route_type This parameter is necessary for only received-routes and sent-routes.
• received-routes : paths received and not withdrawn by given peer
• sent-routes : paths sent and not withdrawn to given peer
address specifies the IP address of the peer. It must be the string representation of an IP address.
format specifies the format of the response. This parameter must be one of the following.
• ’json’ (default)
• ’cli’
neighbor_reset(address)
This method reset the registered neighbor.
address specifies the IP address of the peer. It must be the string representation of an IP address.
neighbor_state_get(address=None, format=’json’)
This method returns the state of peer(s) in a json format.
address specifies the address of a peer. If not given, the state of all the peers return.
format specifies the format of the response. This parameter must be one of the following.
• ’json’ (default)
• ’cli’
neighbor_update(address, conf_type, conf_value)
This method changes the neighbor configuration.
address specifies the IP address of the peer.
conf_type specifies configuration type which you want to change. Currently
ryu.services.protocols.bgp.bgpspeaker.MULTI_EXIT_DISC can be specified.
conf_value specifies value for the configuration type.

2.4. Library 125

ryu Documentation, Release 4.34

neighbors_get(format=’json’)
This method returns a list of the BGP neighbors.
format specifies the format of the response. This parameter must be one of the following.
• ’json’ (default)
• ’cli’
out_filter_get(address)
This method gets out-filter setting from the specified neighbor.
address specifies the IP address of the peer.
Returns a list object containing an instance of Filter sub-class
out_filter_set(address, filters)
This method sets out-filter to neighbor.
address specifies the IP address of the peer.
filters specifies a filter list to filter the path advertisement. The contents must be an instance of Filter
sub-class
If you want to define out-filter that send only a particular prefix to neighbor, filters can be created as
follows:

p = PrefixFilter('10.5.111.0/24',
policy=PrefixFilter.POLICY_PERMIT)

all = PrefixFilter('0.0.0.0/0',
policy=PrefixFilter.POLICY_DENY)

pList = [p, all]

self.bgpspeaker.out_filter_set(neighbor_address, pList)

Note: out-filter evaluates paths in the order of Filter in the pList.

prefix_add(prefix, next_hop=None, route_dist=None)

This method adds a new prefix to be advertised.
prefix must be the string representation of an IP network (e.g., 10.1.1.0/24).
next_hop specifies the next hop address for this prefix. This parameter is necessary for only VPNv4 and
VPNv6 address families.
route_dist specifies a route distinguisher value. This parameter is necessary for only VPNv4 and
VPNv6 address families.
prefix_del(prefix, route_dist=None)
This method deletes a advertised prefix.
prefix must be the string representation of an IP network.
route_dist specifies a route distinguisher value.
rib_get(family=’all’, format=’json’)
This method returns the BGP routing information in a json format. This will be improved soon.
family specifies the address family of the RIB (e.g. ’ipv4’).
format specifies the format of the response. This parameter must be one of the following.

126 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

• ’json’ (default)
• ’cli’
shutdown()
Shutdown BGP speaker
vrf_add(route_dist, import_rts, export_rts, site_of_origins=None, route_family=’ipv4’,
multi_exit_disc=None)
This method adds a new vrf used for VPN.
route_dist specifies a route distinguisher value.
import_rts specifies a list of route targets to be imported.
export_rts specifies a list of route targets to be exported.
site_of_origins specifies site_of_origin values. This parameter must be a list of string.
route_family specifies route family of the VRF. This parameter must be one of the following.
• RF_VPN_V4 (default) = ’ipv4’
• RF_VPN_V6 = ’ipv6’
• RF_L2_EVPN = ’evpn’
• RF_VPNV4_FLOWSPEC = ’ipv4fs’
• RF_VPNV6_FLOWSPEC = ’ipv6fs’
• RF_L2VPN_FLOWSPEC = ’l2vpnfs’
multi_exit_disc specifies multi exit discriminator (MED) value. It must be an integer.
vrf_del(route_dist)
This method deletes the existing vrf.
route_dist specifies a route distinguisher value.
vrfs_get(subcommand=’routes’, route_dist=None, route_family=’all’, format=’json’)
This method returns the existing vrfs.
subcommand specifies one of the following.
• ’routes’: shows routes present for vrf
• ’summary’: shows configuration and summary of vrf
route_dist specifies a route distinguisher value. If route_family is not ’all’, this value must be speci-
fied.
route_family specifies route family of the VRF. This parameter must be one of the following.
• RF_VPN_V4 = ’ipv4’
• RF_VPN_V6 = ’ipv6’
• RF_L2_EVPN = ’evpn’
• ’all’ (default)
format specifies the format of the response. This parameter must be one of the following.
• ’json’ (default)
• ’cli’

2.4. Library 127

ryu Documentation, Release 4.34

class ryu.services.protocols.bgp.bgpspeaker.EventPrefix(path, is_withdraw)

Used to pass an update on any best remote path to best_path_change_handler.

Attribute Description
remote_as The AS number of a peer that caused this change
route_dist None in the case of IPv4 or IPv6 family
prefix A prefix was changed
nexthop The nexthop of the changed prefix
label MPLS label for VPNv4, VPNv6 or EVPN prefix
path An instance of info_base.base.Path subclass
is_withdraw True if this prefix has gone otherwise False

class ryu.services.protocols.bgp.info_base.base.PrefixFilter(prefix, pol-

icy, ge=None,
le=None)
Used to specify a prefix for filter.
We can create PrefixFilter object as follows:

prefix_filter = PrefixFilter('10.5.111.0/24',
policy=PrefixFilter.POLICY_PERMIT)

Attribute Description
prefix A prefix used for this filter
policy One of the following values.

PrefixFilter.POLICY.PERMIT
PrefixFilter.POLICY_DENY

ge Prefix length that will be applied to this filter. ge

means greater than or equal.
le Prefix length that will be applied to this filter. le
means less than or equal.

For example, when PrefixFilter object is created as follows:

p = PrefixFilter('10.5.111.0/24',
policy=PrefixFilter.POLICY_DENY,
ge=26, le=28)

Prefixes which match 10.5.111.0/24 and its length matches from 26 to 28 will be filtered. When this filter is
used as an out-filter, it will stop sending the path to neighbor because of POLICY_DENY. When this filter is
used as in-filter, it will stop importing the path to the global rib because of POLICY_DENY. If you specify
POLICY_PERMIT, the path is sent to neighbor or imported to the global rib.
If you don’t want to send prefixes 10.5.111.64/26 and 10.5.111.32/27 and 10.5.111.16/28, and allow to send
other 10.5.111.0’s prefixes, you can do it by specifying as follows:

p = PrefixFilter('10.5.111.0/24',
policy=PrefixFilter.POLICY_DENY,
ge=26, le=28).

clone()
This method clones PrefixFilter object.

128 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Returns PrefixFilter object that has the same values with the original one.
evaluate(path)
This method evaluates the prefix.
Returns this object’s policy and the result of matching. If the specified prefix matches this object’s prefix
and ge and le condition, this method returns True as the matching result.
path specifies the path that has prefix.
class ryu.services.protocols.bgp.info_base.base.ASPathFilter(as_number, pol-
icy)
Used to specify a prefix for AS_PATH attribute.
We can create ASPathFilter object as follows:

as_path_filter = ASPathFilter(65000,policy=ASPathFilter.TOP)

Attribute Description
as_number A AS number used for this filter
policy One of the following values.

ASPathFilter.POLICY_TOP
ASPathFilter.POLICY_END
ASPathFilter.POLICY_INCLUDE
ASPathFilter.POLICY_NOT_INCLUDE

Meaning of each policy is as follows:

Policy Description
POLICY_TOP Filter checks if the specified AS number is at the top of AS_PATH attribute.
POLICY_END Filter checks is the specified AS number is at the last of AS_PATH attribute.
POLICY_INCLUDE Filter checks if specified AS number exists in AS_PATH attribute.
POLICY_NOT_INCLUDE Opposite to POLICY_INCLUDE.

clone()
This method clones ASPathFilter object.
Returns ASPathFilter object that has the same values with the original one.
evaluate(path)
This method evaluates as_path list.
Returns this object’s policy and the result of matching. If the specified AS number matches this object’s
AS number according to the policy, this method returns True as the matching result.
path specifies the path.
class ryu.services.protocols.bgp.info_base.base.AttributeMap(filters, attr_type,
attr_value)
This class is used to specify an attribute to add if the path matches filters. We can create AttributeMap object as
follows:

pref_filter = PrefixFilter('192.168.103.0/30',
PrefixFilter.POLICY_PERMIT)

(continues on next page)

2.4. Library 129

ryu Documentation, Release 4.34

(continued from previous page)

attribute_map = AttributeMap([pref_filter],
AttributeMap.ATTR_LOCAL_PREF, 250)

speaker.attribute_map_set('192.168.50.102', [attribute_map])

AttributeMap.ATTR_LOCAL_PREF means that 250 is set as a local preference value if nlri in the path matches
pref_filter.
ASPathFilter is also available as a filter. ASPathFilter checks if AS_PATH attribute in the path matches AS
number in the filter.

Attribute Description
filters A list of filter. Each object should be a Filter class or its sub-class
attr_type A type of attribute to map on filters. Currently AttributeMap.ATTR_LOCAL_PREF is avail-
able.
attr_value A attribute value

clone()
This method clones AttributeMap object.
Returns AttributeMap object that has the same values with the original one.
evaluate(path)
This method evaluates attributes of the path.
Returns the cause and result of matching. Both cause and result are returned from filters that this object
contains.
path specifies the path.

2.4.7 MRT file library

Introduction

Ryu MRT file library helps you to read/write MRT (Multi-Threaded Routing Toolkit) Routing Information Export
Format [RFC6396].

Reading MRT file

For loading the routing information contained in MRT files, you can use mrtlib.Reader.
class ryu.lib.mrtlib.Reader(f )
MRT format file reader.

Argument Description
f File object which reading MRT format file in binary mode.

Example of Usage:
import bz2
from ryu.lib import mrtlib

count = 0
(continues on next page)

130 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

for record in mrtlib.Reader(
bz2.BZ2File('rib.YYYYMMDD.hhmm.bz2', 'rb')):
print("%d, %s" % (count, record))
count += 1

Writing MRT file

For dumping the routing information which your RyuApp generated, you can use mrtlib.Writer.
class ryu.lib.mrtlib.Writer(f )
MRT format file writer.

Argument Description
f File object which writing MRT format file in binary mode.

Example of usage:

import bz2
import time
from ryu.lib import mrtlib
from ryu.lib.packet import bgp

mrt_writer = mrtlib.Writer(
bz2.BZ2File('rib.YYYYMMDD.hhmm.bz2', 'wb'))

prefix = bgp.IPAddrPrefix(24, '10.0.0.0')

rib_entry = mrtlib.MrtRibEntry(
peer_index=0,
originated_time=int(time.time()),
bgp_attributes=[bgp.BGPPathAttributeOrigin(0)])

message = mrtlib.TableDump2RibIPv4UnicastMrtMessage(
seq_num=0,
prefix=prefix,
rib_entries=[rib_entry])

record = mrtlib.TableDump2MrtRecord(
message=message)

mrt_writer.write(record)

2.4.8 OVSDB Manager library

Path: ryu.services.protocols.ovsdb

Introduction

Ryu OVSDB Manager library allows your code to interact with devices speaking the OVSDB protocol. This enables
your code to perform remote management of the devices and react to topology changes on them.

2.4. Library 131

ryu Documentation, Release 4.34

Please note this library will spawn a server listening on the port 6640 (the IANA registered for OVSDB protocol), but
does not initiate connections from controller side. Then, to make your devices connect to Ryu, you need to tell the
controller IP address and port to your devices.

# Show current configuration

$ ovs-vsctl get-manager

# Set manager (controller) address

$ ovs-vsctl set-manager "tcp:127.0.0.1:6640"

# If you want to specify IPv6 address, wrap ip with brackets

$ ovs-vsctl set-manager "tcp:[::1]:6640"

Also this library identifies the devices by "system-id" which should be unique, persistent identifier among all devices
connecting to a single controller. Please make sure "system-id" is configured before connecting.

# Show current configuration

$ ovs-vsctl get Open_vSwitch . external_ids:system-id

# Set system-id manually

$ ovs-vsctl set Open_vSwitch . external_ids:system-id=<SYSTEM-ID>

Example

The following logs all new OVSDB connections in "handle_new_ovsdb_connection" and also provides the API "cre-
ate_port" for creating a port on a bridge.

import uuid

from ryu.base import app_manager

from ryu.controller.handler import set_ev_cls
from ryu.services.protocols.ovsdb import api as ovsdb
from ryu.services.protocols.ovsdb import event as ovsdb_event

class MyApp(app_manager.RyuApp):
@set_ev_cls(ovsdb_event.EventNewOVSDBConnection)
def handle_new_ovsdb_connection(self, ev):
system_id = ev.system_id
address = ev.client.address
self.logger.info(
'New OVSDB connection from system-id=%s, address=%s',
system_id, address)

# Example: If device has bridge "s1", add port "s1-eth99"

if ovsdb.bridge_exists(self, system_id, "s1"):
self.create_port(system_id, "s1", "s1-eth99")

def create_port(self, system_id, bridge_name, name):

new_iface_uuid = uuid.uuid4()
new_port_uuid = uuid.uuid4()

bridge = ovsdb.row_by_name(self, system_id, bridge_name)

def _create_port(tables, insert):

iface = insert(tables['Interface'], new_iface_uuid)
(continues on next page)

132 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

iface.name = name
iface.type = 'internal'

port = insert(tables['Port'], new_port_uuid)

port.name = name
port.interfaces = [iface]

bridge.ports = bridge.ports + [port]

return new_port_uuid, new_iface_uuid

req = ovsdb_event.EventModifyRequest(system_id, _create_port)

rep = self.send_request(req)

if rep.status != 'success':
self.logger.error('Error creating port %s on bridge %s: %s',
name, bridge, rep.status)
return None

return rep.insert_uuids[new_port_uuid]

2.4.9 OVSDB library

Path: ryu.lib.ovs
Similar to the OVSDB Manager library, this library enables your application to speak the OVSDB protocol (RFC7047),
but differ from the OVSDB Manager library, this library will initiate connections from controller side as ovs-vsctl
command does. Please make sure that your devices are listening on either the Unix domain socket or TCP/SSL port
before calling the APIs of this library.
# Show current configuration
$ ovs-vsctl get-manager

# Set TCP listen address

$ ovs-vsctl set-manager "ptcp:6640"

See manpage of ovs-vsctl command for more details.

Basic Usage

1. Instantiate ryu.lib.ovs.vsctl.VSCtl.
2. Construct commands with ryu.lib.ovs.vsctl.VSCtlCommand. The syntax is almost the same as ovs-
vsctl command.
3. Execute commands via ryu.lib.ovs.vsctl.VSCtl.run_command.

Example

from ryu.lib.ovs import vsctl

OVSDB_ADDR = 'tcp:127.0.0.1:6640'
ovs_vsctl = vsctl.VSCtl(OVSDB_ADDR)
(continues on next page)

2.4. Library 133

ryu Documentation, Release 4.34

(continued from previous page)

# Equivalent to
# $ ovs-vsctl show
command = vsctl.VSCtlCommand('show')
ovs_vsctl.run_command([command])
print(command)
# >>> VSCtlCommand(args=[],command='show',options=[],result='830d781f-c3c8-4b4f-837e-
˓→106e1b33d058\n ovs_version: "2.8.90"\n')

# Equivalent to
# $ ovs-vsctl list Port s1-eth1
command = vsctl.VSCtlCommand('list', ('Port', 's1-eth1'))
ovs_vsctl.run_command([command])
print(command)
# >>> VSCtlCommand(args=('Port', 's1-eth1'),command='list',options=[],result=[<ovs.db.
˓→idl.Row object at 0x7f525fb682e8>])

print(command.result[0].name)
# >>> s1-eth1

API Reference

ryu.lib.ovs.vsctl

ovs-vsctl command like library to speak OVSDB protocol

class ryu.lib.ovs.vsctl.VSCtl(remote)
A class to describe an Open vSwitch instance.
remote specifies the address of the OVS instance. ryu.lib.ovs.vsctl.valid_ovsdb_addr is a
convenient function to validate this address.
run_command(commands, timeout_sec=None, exception=None)
Executes the given commands and sends OVSDB messages.
commands must be a list of ryu.lib.ovs.vsctl.VSCtlCommand.
If timeout_sec is specified, raises exception after the given timeout [sec]. Additionally, if exception
is specified, this function will wraps exception using the given exception class.
Retruns None but fills result attribute for each command instance.
class ryu.lib.ovs.vsctl.VSCtlCommand(command, args=None, options=None)
Class to describe artgumens similar to those of ovs-vsctl command.
command specifies the command of ovs-vsctl.
args specifies a list or tuple of arguments for the given command.
options specifies a list or tuple of options for the given command. Please note that NOT all options of
ovs-vsctl are supported. For example, --id option is not yet supported. This class supports the followings.

134 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Option Description
--may-exist Does nothing when the given port already exists. The supported commands are add-port
and add-bond.
--fake-ifaceCreates a port as a fake interface. The supported command is add-bond.
--must-existRaises exception if the given port does not exist. The supported command is del-port.
--with-ifaceTakes effect to the interface which has the same name. The supported command is
del-port.
--if-exists Ignores exception when not found. The supported command is get.

ryu.lib.ovs.vsctl.valid_ovsdb_addr(addr)
Returns True if the given addr is valid OVSDB server address, otherwise False.
The valid formats are:
• unix:file
• tcp:ip:port
• ssl:ip:port
If ip is IPv6 address, wrap ip with brackets (e.g., ssl:[::1]:6640).
Parameters addr – str value of OVSDB server address.
Returns True if valid, otherwise False.

ryu.lib.ovs.bridge

Wrapper utility library of ryu.lib.ovs.vsctl

class ryu.lib.ovs.bridge.OVSBridge(CONF, datapath_id, ovsdb_addr, timeout=None, excep-
tion=None, br_name=None)
Class to provide wrapper utilities of ryu.lib.ovs.vsctl.VSCtl
CONF is a instance of oslo_config.cfg.ConfigOpts. Mostly self.CONF is sufficient to instantiate
this class from your Ryu application.
datapath_id specifies Datapath ID of the target OVS instance.
ovsdb_addr specifies the address of the OVS instance. Automatically validated when you call init()
method. Refer to ryu.lib.ovs.vsctl.valid_ovsdb_addr for the format of this address.
if timeout is omitted, CONF.ovsdb_timeout will be used as the default value.
Usage of timeout and exception is the same with timeout_sec and exception of ryu.lib.ovs.
vsctl.VSCtl.run_command.
add_bond(name, ifaces, bond_mode=None, lacp=None)
Creates a bonded port.
Parameters
• name – Port name to be created
• ifaces – List of interfaces containing at least 2 interfaces
• bond_mode – Bonding mode (active-backup, balance-tcp or balance-slb)
• lacp – LACP mode (active, passive or off)

2.4. Library 135

ryu Documentation, Release 4.34

add_db_attribute(table, record, column, value, key=None)

Adds (’key’=)’value’ into ’column’ in ’record’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl add TBL REC COL [KEY=]VALUE

add_gre_port(name, remote_ip, local_ip=None, key=None, ofport=None)

Creates a GRE tunnel port.
See the description of add_tunnel_port().
add_tunnel_port(name, tunnel_type, remote_ip, local_ip=None, key=None, ofport=None)
Creates a tunnel port.
Parameters
• name – Port name to be created
• tunnel_type – Type of tunnel (gre or vxlan)
• remote_ip – Remote IP address of tunnel
• local_ip – Local IP address of tunnel
• key – Key of GRE or VNI of VxLAN
• ofport – Requested OpenFlow port number
add_vxlan_port(name, remote_ip, local_ip=None, key=None, ofport=None)
Creates a VxLAN tunnel port.
See the description of add_tunnel_port().
clear_db_attribute(table, record, column)
Clears values from ’column’ in ’record’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl clear TBL REC COL

db_get_map(table, record, column)

Gets dict type value of ’column’ in ’record’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl get TBL REC COL

db_get_val(table, record, column)

Gets values of ’column’ in ’record’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl get TBL REC COL

del_controller()
Deletes the configured OpenFlow controller address.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl del-controller <bridge>

136 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

del_port(port_name)
Deletes a port on OVS instance.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl del-port <bridge> <port>

del_qos(port_name)
Deletes the Qos rule on the given port.
delete_port(port_name)
Deletes a port on the OVS instance.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl --if-exists del-port <bridge> <port>

find_db_attributes(table, *conditions)
Lists records satisfying ’conditions’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl find TBL CONDITION...

Note: Currently, only ’=’ condition is supported. To support other condition is TODO.

get_controller()
Gets the configured OpenFlow controller address.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl get-controller <bridge>

get_datapath_id()
Gets Datapath ID of OVS instance.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl get Bridge <bridge> datapath_id

get_db_attribute(table, record, column, key=None)

Gets values of ’column’ in ’record’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl get TBL REC COL[:KEY]

get_ofport(port_name)
Gets the OpenFlow port number.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl get Interface <port> ofport

get_port_name_list()
Gets a list of all ports on OVS instance.
This method is corresponding to the following ovs-vsctl command:

2.4. Library 137

ryu Documentation, Release 4.34

$ ovs-vsctl list-ports <bridge>

get_vif_ports()
Returns a VIF object for each VIF port
init()
Validates the given ovsdb_addr and connects to OVS instance.
If failed to connect to OVS instance or the given datapath_id does not match with the Datapath ID of
the connected OVS instance, raises ryu.lib.ovs.bridge.OVSBridgeNotFound exception.
list_db_attributes(table, record=None)
Lists ’record’ (or all records) in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl list TBL [REC]

remove_db_attribute(table, record, column, value, key=None)

Removes (’key’=)’value’ into ’column’ in ’record’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl remove TBL REC COL [KEY=]VALUE

run_command(commands)
Executes the given commands and sends OVSDB messages.
commands must be a list of ryu.lib.ovs.vsctl.VSCtlCommand.
The given timeout and exception when instantiation will be used to call ryu.lib.ovs.vsctl.
VSCtl.run_command.
set_controller(controllers)
Sets the OpenFlow controller address.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl set-controller <bridge> <target>...

set_db_attribute(table, record, column, value, key=None)

Sets ’value’ into ’column’ in ’record’ in ’table’.
This method is corresponding to the following ovs-vsctl command:

$ ovs-vsctl set TBL REC COL[:KEY]=VALUE

set_qos(port_name, type=’linux-htb’, max_rate=None, queues=None)

Sets a Qos rule and creates Queues on the given port.
exception ryu.lib.ovs.bridge.OVSBridgeNotFound(msg=None, **kwargs)

2.5 OpenFlow protocol API Reference

2.5.1 OpenFlow version independent classes and functions

138 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Base class for OpenFlow messages

class ryu.ofproto.ofproto_parser.MsgBase(datapath)
This is a base class for OpenFlow message classes.
An instance of this class has at least the following attributes.

Attribute Description
datapath A ryu.controller.controller.Datapath instance for this message
version OpenFlow protocol version
msg_type Type of OpenFlow message
msg_len Length of the message
xid Transaction id
buf Raw data

_TYPE
_TYPE class attribute is used to annotate types of attributes.
This type information is used to find an appropriate conversion for a JSON style dictionary.
Currently the following types are implemented.

Type Descrption
ascii US-ASCII
utf-8 UTF-8

Example:

_TYPE = {
'ascii': [
'hw_addr',
],
'utf-8': [
'name',
]
}

classmethod from_jsondict(dict_, decode_string=<function b64decode>, **additional_args)

Create an instance from a JSON style dict.
Instantiate this class with parameters specified by the dict.
This method takes the following arguments.

to_jsondict(encode_string=<function b64encode>)
This method returns a JSON style dict to describe this object.
The returned dict is compatible with json.dumps() and json.loads().

2.5. OpenFlow protocol API Reference 139

ryu Documentation, Release 4.34

Suppose ClassName object inherits StringifyMixin. For an object like the following:

ClassName(Param1=100, Param2=200)

this method would produce:

{ "ClassName": {"Param1": 100, "Param2": 200} }

This method takes the following arguments.

Argument Description
encode_string (Optional) specify how to encode attributes which has python ’str’ type. The default
is base64. This argument is used only for attributes which don’t have explicit type
annotations in _TYPE class attribute.

Functions

ryu.ofproto.ofproto_parser.ofp_msg_from_jsondict(dp, jsondict)
This function instanticates an appropriate OpenFlow message class from the given JSON style dictionary. The
objects created by following two code fragments are equivalent.
Code A:

jsonstr = '{ "OFPSetConfig": { "flags": 0, "miss_send_len": 128 } }'

jsondict = json.loads(jsonstr)
o = ofp_msg_from_jsondict(dp, jsondict)

Code B:

o = dp.ofproto_parser.OFPSetConfig(flags=0, miss_send_len=128)

This function takes the following arguments.

Argument Description
dp An instance of ryu.controller.Datapath.
jsondict A JSON style dict.

2.5.2 OpenFlow v1.0 Messages and Structures

Controller-to-Switch Messages

Handshake

class ryu.ofproto.ofproto_v1_0_parser.OFPFeaturesRequest(datapath)
Features request message
The controller sends a feature request to the switch upon session establishment.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
Example:

140 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_features_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPFeaturesRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPFeaturesRequest": {}
}

class ryu.ofproto.ofproto_v1_0_parser.OFPSwitchFeatures(datapath, data-

path_id=None,
n_buffers=None,
n_tables=None, capabili-
ties=None, actions=None,
ports=None)
Features reply message
The switch responds with a features reply message to a features request.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
datapath_id Datapath unique ID.
n_buffers Max packets buffered at once.
n_tables Number of tables supported by datapath.
capabilities Bitmap of capabilities flag.

OFPC_FLOW_STATS
OFPC_TABLE_STATS
OFPC_PORT_STATS
OFPC_STP
OFPC_RESERVED
OFPC_IP_REASM
OFPC_QUEUE_STATS
OFPC_ARP_MATCH_IP

actions Bitmap of supported OFPAT_*.

ports List of OFPPhyPort instances.

Example:

@set_ev_cls(ofp_event.EventOFPSwitchFeatures, CONFIG_DISPATCHER)
def switch_features_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPSwitchFeatures received: '

'datapath_id=0x%016x n_buffers=%d '
'n_tables=%d capabilities=0x%08x ports=%s',
msg.datapath_id, msg.n_buffers, msg.n_tables,
msg.capabilities, msg.ports)

JSON Example:

2.5. OpenFlow protocol API Reference 141

ryu Documentation, Release 4.34

{
"OFPSwitchFeatures": {
"actions": 2115,
"capabilities": 169,
"datapath_id": 1095522080376,
"n_buffers": 0,
"n_tables": 255,
"ports": {
"6": {
"OFPPhyPort": {
"advertised": 640,
"config": 0,
"curr": 648,
"hw_addr": "f2:0b:a4:7d:f8:ea",
"name": "Port6",
"peer": 648,
"port_no": 6,
"state": 2,
"supported": 648
}
},
"7": {
"OFPPhyPort": {
"advertised": 640,
"config": 0,
"curr": 648,
"hw_addr": "f2:0b:a4:d0:3f:70",
"name": "Port7",
"peer": 648,
"port_no": 7,
"state": 16,
"supported": 648
}
}
}
}
}

Switch Configuration

class ryu.ofproto.ofproto_v1_0_parser.OFPSetConfig(datapath, flags=None,

miss_send_len=None)
Set config request message
The controller sends a set config request message to set configuraion parameters.

142 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
flags One of the following configuration flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM
OFPC_FRAG_MASK

miss_send_len Max bytes of new flow that datapath should send to

the controller.

Example:
def send_set_config(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPSetConfig(datapath, ofp.OFPC_FRAG_NORMAL, 256)

datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPGetConfigRequest(datapath)
Get config request message
The controller sends a get config request to query configuration parameters in the switch.
Example:
def send_get_config_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetConfigRequest(datapath)
datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPGetConfigReply(datapath)
Get config reply message
The switch responds to a configuration request with a get config reply message.

Attribute Description
flags One of the following configuration flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM
OFPC_FRAG_MASK

miss_send_len Max bytes of new flow that datapath should send to

the controller.

Example:
@set_ev_cls(ofp_event.EventOFPGetConfigReply, MAIN_DISPATCHER)
def get_config_reply_handler(self, ev):
msg = ev.msg
(continues on next page)

2.5. OpenFlow protocol API Reference 143

ryu Documentation, Release 4.34

(continued from previous page)

dp = msg.datapath
ofp = dp.ofproto

if msg.flags == ofp.OFPC_FRAG_NORMAL:
flags = 'NORMAL'
elif msg.flags == ofp.OFPC_FRAG_DROP:
flags = 'DROP'
elif msg.flags == ofp.OFPC_FRAG_REASM:
flags = 'REASM'
elif msg.flags == ofp.OFPC_FRAG_MASK:
flags = 'MASK'
else:
flags = 'unknown'
self.logger.debug('OFPGetConfigReply received: '
'flags=%s miss_send_len=%d',
flags, msg.miss_send_len)

Modify State Messages

class ryu.ofproto.ofproto_v1_0_parser.OFPFlowMod(datapath, match=None, cookie=0,

command=0, idle_timeout=0,
hard_timeout=0, prior-
ity=32768, buffer_id=4294967295,
out_port=65535, flags=0, ac-
tions=None)
Modify Flow entry message
The controller sends this message to modify the flow table.

144 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
match Instance of OFPMatch.
cookie Opaque controller-issued identifier.
command One of the following values.

OFPFC_ADD
OFPFC_MODIFY
OFPFC_MODIFY_STRICT
OFPFC_DELETE
OFPFC_DELETE_STRICT

idle_timeout Idle time before discarding (seconds).

hard_timeout Max time before discarding (seconds).
priority Priority level of flow entry.
buffer_id Buffered packet to apply to (or 0xffffffff). Not mean-
ingful for OFPFC_DELETE*.
out_port For OFPFC_DELETE* commands, require match-
ing entries to include this as an output port. A value
of OFPP_NONE indicates no restriction.
flags One of the following values.

OFPFF_SEND_FLOW_REM
OFPFF_CHECK_OVERLAP
OFPFF_EMERG

actions List of OFPAction* instance.

Example:

def send_flow_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

match = ofp_parser.OFPMatch(in_port=1)
cookie = 0
command = ofp.OFPFC_ADD
idle_timeout = hard_timeout = 0
priority = 32768
buffer_id = 0xffffffff
out_port = ofproto.OFPP_NONE
flags = 0
actions = [ofp_parser.OFPActionOutput(ofp.OFPP_NORMAL, 0)]
req = ofp_parser.OFPFlowMod(
datapath, match, cookie, command, idle_timeout, hard_timeout,
priority, buffer_id, out_port, flags, actions)
datapath.send_msg(req)

JSON Example:

{
"OFPFlowMod": {
"actions": [
{
(continues on next page)

2.5. OpenFlow protocol API Reference 145

ryu Documentation, Release 4.34

(continued from previous page)

"OFPActionOutput": {
"max_len": 65535,
"port": 6
}
}
],
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"match": {
"OFPMatch": {
"dl_dst": "f2:0b:a4:7d:f8:ea",
"dl_src": "00:00:00:00:00:00",
"dl_type": 0,
"dl_vlan": 0,
"dl_vlan_pcp": 0,
"in_port": 0,
"nw_dst": "0.0.0.0",
"nw_proto": 0,
"nw_src": "0.0.0.0",
"nw_tos": 0,
"tp_dst": 0,
"tp_src": 0,
"wildcards": 4194295
}
},
"out_port": 65532,
"priority": 123
}
}

class ryu.ofproto.ofproto_v1_0_parser.OFPPortMod(datapath, port_no=0,

hw_addr=’00:00:00:00:00:00’,
config=0, mask=0, advertise=0)
Port modification message
The controller send this message to modify the behavior of the port.

146 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
port_no Port number to modify.
hw_addr The hardware address that must be the
same as hw_addr of OFPPhyPort of
OFPSwitchFeatures.
config Bitmap of configuration flags.

OFPPC_PORT_DOWN
OFPPC_NO_STP
OFPPC_NO_RECV
OFPPC_NO_RECV_STP
OFPPC_NO_FLOOD
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

mask Bitmap of configuration flags above to be changed

advertise Bitmap of the following flags.

OFPPF_10MB_HD
OFPPF_10MB_FD
OFPPF_100MB_HD
OFPPF_100MB_FD
OFPPF_1GB_HD
OFPPF_1GB_FD
OFPPF_10GB_FD
OFPPF_COPPER
OFPPF_FIBER
OFPPF_AUTONEG
OFPPF_PAUSE
OFPPF_PAUSE_ASYM

Example:

def send_port_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

2.5. OpenFlow protocol API Reference 147

ryu Documentation, Release 4.34

Queue Configuration Messages

class ryu.ofproto.ofproto_v1_0_parser.OFPQueueGetConfigRequest(datapath, port)

Queue configuration request message

Attribute Description
port Port to be queried. Should refer to a valid physical port (i.e. < OFPP_MAX).

Example:
def send_queue_get_config_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueGetConfigRequest(datapath,
ofp.OFPP_NONE)
datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPQueueGetConfigReply(datapath)
Queue configuration reply message
The switch responds with this message to a queue configuration request.

Attribute Description
port Port to be queried.
queues List of OFPPacketQueue instance.

Example:
@set_ev_cls(ofp_event.EventOFPQueueGetConfigReply, MAIN_DISPATCHER)
def queue_get_config_reply_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPQueueGetConfigReply received: '

'port=%s queues=%s',
msg.port, msg.queues)

Read State Messages

class ryu.ofproto.ofproto_v1_0_parser.OFPDescStatsRequest(datapath, flags)

Description statistics request message
The controller uses this message to query description of the switch.

Attribute Description
flags Zero (none yet defined in the spec).

Example:
def send_desc_stats_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPDescStatsRequest(datapath)
datapath.send_msg(req)

148 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_0_parser.OFPDescStatsReply(datapath)
Description statistics reply message
The switch responds with a stats reply that include this message to a description statistics request.

Attribute Description
mfr_desc Manufacturer description.
hw_desc Hardware description.
sw_desc Software description.
serial_num Serial number.
dp_desc Human readable description of datapath.

Example:
@set_ev_cls(ofp_event.EventOFPDescStatsReply, MAIN_DISPATCHER)
def desc_stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

self.logger.debug('DescStats: mfr_desc=%s hw_desc=%s sw_desc=%s '

'serial_num=%s dp_desc=%s',
body.mfr_desc, body.hw_desc, body.sw_desc,
body.serial_num, body.dp_desc)

class ryu.ofproto.ofproto_v1_0_parser.OFPFlowStatsRequest(datapath, flags, match,

table_id, out_port)
Individual flow statistics request message
The controller uses this message to query individual flow statistics.

At- Description
tribute
flags Zero (none yet defined in the spec).
match Instance of OFPMatch.
table_id ID of table to read (from ofp_table_stats), 0xff for all tables or 0xfe for emergency.
out_port Require matching entries to include this as an output port. A value of OFPP_NONE indicates no
restriction.

Example:
def send_flow_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

match = ofp_parser.OFPMatch(in_port=1)
table_id = 0xff
out_port = ofp.OFPP_NONE
req = ofp_parser.OFPFlowStatsRequest(
datapath, 0, match, table_id, out_port)

datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPFlowStatsReply(datapath)
Individual flow statistics reply message
The switch responds with a stats reply that include this message to an individual flow statistics request.

2.5. OpenFlow protocol API Reference 149

ryu Documentation, Release 4.34

Attribute Description
table_id ID of table flow came from.
match Instance of OFPMatch.
duration_sec Time flow has been alive in seconds.
duration_nsec Time flow has been alive in nanoseconds beyond duration_sec.
priority Priority of the entry. Only meaningful when this is not an exact-match entry.
idle_timeout Number of seconds idle before expiration.
hard_timeout Number of seconds before expiration.
cookie Opaque controller-issued identifier.
packet_count Number of packets in flow.
byte_count Number of bytes in flow.
actions List of OFPAction* instance

Example:

@set_ev_cls(ofp_event.EventOFPFlowStatsReply, MAIN_DISPATCHER)
def flow_stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

flows = []
for stat in body:
flows.append('table_id=%s match=%s '
'duration_sec=%d duration_nsec=%d '
'priority=%d '
'idle_timeout=%d hard_timeout=%d '
'cookie=%d packet_count=%d byte_count=%d '
'actions=%s' %
(stat.table_id, stat.match,
stat.duration_sec, stat.duration_nsec,
stat.priority,
stat.idle_timeout, stat.hard_timeout,
stat.cookie, stat.packet_count, stat.byte_count,
stat.actions))
self.logger.debug('FlowStats: %s', flows)

class ryu.ofproto.ofproto_v1_0_parser.OFPAggregateStatsRequest(datapath, flags,

match, table_id,
out_port)
Aggregate flow statistics request message
The controller uses this message to query aggregate flow statictics.

At- Description
tribute
flags Zero (none yet defined in the spec).
match Fields to match.
table_id ID of table to read (from ofp_table_stats) 0xff for all tables or 0xfe for emergency.
out_port Require matching entries to include this as an output port. A value of OFPP_NONE indicates no
restriction.

Example:

150 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_aggregate_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

cookie = cookie_mask = 0
match = ofp_parser.OFPMatch(in_port=1)
req = ofp_parser.OFPAggregateStatsRequest(
datapath, 0, match, 0xff, ofp.OFPP_NONE)

datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPAggregateStatsReply(datapath)
Aggregate flow statistics reply message
The switch responds with a stats reply that include this message to an aggregate flow statistics request.

Attribute Description
packet_count Number of packets in flows.
byte_count Number of bytes in flows.
flow_count Number of flows.

Example:

@set_ev_cls(ofp_event.EventOFPAggregateStatsReply, MAIN_DISPATCHER)
def aggregate_stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

self.logger.debug('AggregateStats: packet_count=%d byte_count=%d '

'flow_count=%d',
body.packet_count, body.byte_count,
body.flow_count)

class ryu.ofproto.ofproto_v1_0_parser.OFPTableStatsRequest(datapath, flags)

Table statistics request message
The controller uses this message to query flow table statictics.

Attribute Description
flags Zero (none yet defined in the spec).

Example:

def send_table_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableStatsRequest(datapath)
datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPTableStatsReply(datapath)
Table statistics reply message
The switch responds with a stats reply that include this message to a table statistics request.

2.5. OpenFlow protocol API Reference 151

ryu Documentation, Release 4.34

Attribute Description
table_id ID of table.
name table name.
wildcards Bitmap of OFPFW_* wildcards that are supported by the table.
max_entries Max number of entries supported
active_count Number of active entries
lookup_count Number of packets looked up in table
matched_count Number of packets that hit table

Example:

@set_ev_cls(ofp_event.EventOFPTableStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

tables = []
for stat in body:
tables.append('table_id=%d name=%s wildcards=0x%02x '
'max_entries=%d active_count=%d '
'lookup_count=%d matched_count=%d' %
(stat.table_id, stat.name, stat.wildcards,
stat.max_entries, stat.active_count,
stat.lookup_count, stat.matched_count))
self.logger.debug('TableStats: %s', tables)

class ryu.ofproto.ofproto_v1_0_parser.OFPPortStatsRequest(datapath, flags,

port_no)
Port statistics request message
The controller uses this message to query information about ports statistics.

Attribute Description
flags Zero (none yet defined in the spec).
port_no Port number to read (OFPP_NONE to all ports).

Example:

def send_port_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortStatsRequest(datapath, 0, ofp.OFPP_ANY)

datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPPortStatsReply(datapath)
Port statistics reply message
The switch responds with a stats reply that include this message to a port statistics request.

152 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
port_no Port number.
rx_packets Number of received packets.
tx_packets Number of transmitted packets.
rx_bytes Number of received bytes.
tx_bytes Number of transmitted bytes.
rx_dropped Number of packets dropped by RX.
tx_dropped Number of packets dropped by TX.
rx_errors Number of receive errors.
tx_errors Number of transmit errors.
rx_frame_err Number of frame alignment errors.
rx_over_err Number of packet with RX overrun.
rx_crc_err Number of CRC errors.
collisions Number of collisions.

Example:

@set_ev_cls(ofp_event.EventOFPPortStatsReply, MAIN_DISPATCHER)
def port_stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

ports = []
for stat in body:
ports.append('port_no=%d '
'rx_packets=%d tx_packets=%d '
'rx_bytes=%d tx_bytes=%d '
'rx_dropped=%d tx_dropped=%d '
'rx_errors=%d tx_errors=%d '
'rx_frame_err=%d rx_over_err=%d rx_crc_err=%d '
'collisions=%d' %
(stat.port_no,
stat.rx_packets, stat.tx_packets,
stat.rx_bytes, stat.tx_bytes,
stat.rx_dropped, stat.tx_dropped,
stat.rx_errors, stat.tx_errors,
stat.rx_frame_err, stat.rx_over_err,
stat.rx_crc_err, stat.collisions))
self.logger.debug('PortStats: %s', ports)

class ryu.ofproto.ofproto_v1_0_parser.OFPQueueStatsRequest(datapath, flags,

port_no, queue_id)
Queue statistics request message
The controller uses this message to query queue statictics.

Attribute Description
flags Zero (none yet defined in the spec)
port_no Port number to read (All ports if OFPT_ALL).
queue_id ID of queue to read (All queues if OFPQ_ALL).

Example:

2.5. OpenFlow protocol API Reference 153

ryu Documentation, Release 4.34

def send_queue_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueStatsRequest(datapath, 0, ofp.OFPT_ALL,

ofp.OFPQ_ALL)
datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_0_parser.OFPQueueStatsReply(datapath)
Queue statistics reply message
The switch responds with a stats reply that include this message to an aggregate flow statistics request.

Attribute Description
port_no Port number.
queue_id ID of queue.
tx_bytes Number of transmitted bytes.
tx_packets Number of transmitted packets.
tx_errors Number of packets dropped due to overrun.

Example:

@set_ev_cls(ofp_event.EventOFPQueueStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

queues = []
for stat in body:
queues.append('port_no=%d queue_id=%d '
'tx_bytes=%d tx_packets=%d tx_errors=%d ' %
(stat.port_no, stat.queue_id,
stat.tx_bytes, stat.tx_packets, stat.tx_errors))
self.logger.debug('QueueStats: %s', queues)

class ryu.ofproto.ofproto_v1_0_parser.OFPVendorStatsRequest(datapath, flags,

vendor, spe-
cific_data=None)
Vendor statistics request message
The controller uses this message to query vendor-specific information of a switch.
class ryu.ofproto.ofproto_v1_0_parser.OFPVendorStatsReply(datapath)
Vendor statistics reply message
The switch responds with a stats reply that include this message to an vendor statistics request.

Send Packet Message

class ryu.ofproto.ofproto_v1_0_parser.OFPPacketOut(datapath, buffer_id=None,

in_port=None, actions=None,
data=None)
Packet-Out message
The controller uses this message to send a packet out throught the switch.

154 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
buffer_id ID assigned by datapath (0xffffffff if none).
in_port Packet’s input port (OFPP_NONE if none).
actions ist of OFPAction* instance.
data Packet data of a binary type value or an instances of packet.Packet.

Example:

def send_packet_out(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

buffer_id = 0xffffffff
in_port = ofp.OFPP_NONE
actions = [ofp_parser.OFPActionOutput(ofp.OFPP_FLOOD, 0)]
req = ofp_parser.OFPPacketOut(datapath, buffer_id,
in_port, actions)
datapath.send_msg(req)

JSON Example:

{
"OFPPacketOut": {
"actions": [
{
"OFPActionOutput": {
"max_len": 65535,
"port": 65532
}
}
],
"buffer_id": 4294967295,
"data":
˓→"8guk0D9w8gukffjqCABFAABU+BoAAP8Br4sKAAABCgAAAggAAgj3YAAAMdYCAAAAAACrjS0xAAAAABAREhMUFRYXGBkaG

˓→",

"in_port": 65533
}
}

Barrier Message

class ryu.ofproto.ofproto_v1_0_parser.OFPBarrierRequest(datapath)
Barrier request message
The controller sends this message to ensure message dependencies have been met or receive notifications for
completed operations.
Example:

def send_barrier_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPBarrierRequest(datapath)
datapath.send_msg(req)

2.5. OpenFlow protocol API Reference 155

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_0_parser.OFPBarrierReply(datapath)
Barrier reply message
The switch responds with this message to a barrier request.
Example:

@set_ev_cls(ofp_event.EventOFPBarrierReply, MAIN_DISPATCHER)
def barrier_reply_handler(self, ev):
self.logger.debug('OFPBarrierReply received')

Asynchronous Messages

Packet-In Message

class ryu.ofproto.ofproto_v1_0_parser.OFPPacketIn(datapath, buffer_id=None, to-

tal_len=None, in_port=None,
reason=None, data=None)
Packet-In message
The switch sends the packet that received to the controller by this message.

Attribute Description
buffer_id ID assigned by datapath.
total_len Full length of frame.
in_port Port on which frame was received.
reason Reason packet is being sent.

OFPR_NO_MATCH
OFPR_ACTION
OFPR_INVALID_TTL

data Ethernet frame.

Example:

@set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
def packet_in_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPR_NO_MATCH:
reason = 'NO MATCH'
elif msg.reason == ofp.OFPR_ACTION:
reason = 'ACTION'
elif msg.reason == ofp.OFPR_INVALID_TTL:
reason = 'INVALID TTL'
else:
reason = 'unknown'

self.logger.debug('OFPPacketIn received: '

'buffer_id=%x total_len=%d in_port=%d, '
'reason=%s data=%s',
(continues on next page)

156 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

msg.buffer_id, msg.total_len, msg.in_port,
reason, utils.hex_array(msg.data))

JSON Example:

{
"OFPPacketIn": {
"buffer_id": 2,
"data": "////////8gukffjqCAYAAQgABgQAAfILpH346goAAAEAAAAAAAAKAAAD",
"in_port": 99,
"reason": 1,
"total_len": 42
}
}

Flow Removed Message

class ryu.ofproto.ofproto_v1_0_parser.OFPFlowRemoved(datapath)
Flow removed message
When flow entries time out or are deleted, the switch notifies controller with this message.

Attribute Description
match Instance of OFPMatch.
cookie Opaque controller-issued identifier.
priority Priority level of flow entry.
reason One of the following values.

OFPRR_IDLE_TIMEOUT
OFPRR_HARD_TIMEOUT
OFPRR_DELETE

duration_sec Time flow was alive in seconds.

duration_nsec Time flow was alive in nanoseconds beyond dura-
tion_sec.
idle_timeout Idle timeout from original flow mod.
packet_count Number of packets that was associated with the flow.
byte_count Number of bytes that was associated with the flow.

Example:

@set_ev_cls(ofp_event.EventOFPFlowRemoved, MAIN_DISPATCHER)
def flow_removed_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPRR_IDLE_TIMEOUT:
reason = 'IDLE TIMEOUT'
elif msg.reason == ofp.OFPRR_HARD_TIMEOUT:
reason = 'HARD TIMEOUT'
elif msg.reason == ofp.OFPRR_DELETE:
(continues on next page)

2.5. OpenFlow protocol API Reference 157

ryu Documentation, Release 4.34

(continued from previous page)

reason = 'DELETE'
elif msg.reason == ofp.OFPRR_GROUP_DELETE:
reason = 'GROUP DELETE'
else:
reason = 'unknown'

self.logger.debug('OFPFlowRemoved received: '

'match=%s cookie=%d priority=%d reason=%s '
'duration_sec=%d duration_nsec=%d '
'idle_timeout=%d packet_count=%d byte_count=%d',
msg.match, msg.cookie, msg.priority, reason,
msg.duration_sec, msg.duration_nsec,
msg.idle_timeout, msg.packet_count,
msg.byte_count)

Port Status Message

class ryu.ofproto.ofproto_v1_0_parser.OFPPortStatus(datapath, reason=None,

desc=None)
Port status message
The switch notifies controller of change of ports.

Attribute Description
reason One of the following values.

OFPPR_ADD
OFPPR_DELETE
OFPPR_MODIFY

desc instance of OFPPhyPort

Example:

@set_ev_cls(ofp_event.EventOFPPortStatus, MAIN_DISPATCHER)
def port_status_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPPR_ADD:
reason = 'ADD'
elif msg.reason == ofp.OFPPR_DELETE:
reason = 'DELETE'
elif msg.reason == ofp.OFPPR_MODIFY:
reason = 'MODIFY'
else:
reason = 'unknown'

self.logger.debug('OFPPortStatus received: reason=%s desc=%s',

reason, msg.desc)

158 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Error Message

class ryu.ofproto.ofproto_v1_0_parser.OFPErrorMsg(datapath, type_=None, code=None,

data=None)
Error message
The switch notifies controller of problems by this message.

Attribute Description
type High level type of error
code Details depending on the type
data Variable length data depending on the type and code

type attribute corresponds to type_ parameter of init.

Types and codes are defined in ryu.ofproto.ofproto.

Type Code
OFPET_HELLO_FAILED OFPHFC_*
OFPET_BAD_REQUEST OFPBRC_*
OFPET_BAD_ACTION OFPBAC_*
OFPET_FLOW_MOD_FAILED OFPFMFC_*
OFPET_PORT_MOD_FAILED OFPPMFC_*
OFPET_QUEUE_OP_FAILED OFPQOFC_*

Example:

@set_ev_cls(ofp_event.EventOFPErrorMsg,
[HANDSHAKE_DISPATCHER, CONFIG_DISPATCHER, MAIN_DISPATCHER])
def error_msg_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPErrorMsg received: type=0x%02x code=0x%02x '

'message=%s',
msg.type, msg.code, utils.hex_array(msg.data))

Symmetric Messages

Hello

class ryu.ofproto.ofproto_v1_0_parser.OFPHello(datapath)
Hello message
When connection is started, the hello message is exchanged between a switch and a controller.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Echo Request

class ryu.ofproto.ofproto_v1_0_parser.OFPEchoRequest(datapath, data=None)

Echo request message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

2.5. OpenFlow protocol API Reference 159

ryu Documentation, Release 4.34

Attribute Description
data An arbitrary length data.

Example:

def send_echo_request(self, datapath, data):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPEchoRequest(datapath, data)

datapath.send_msg(req)

Echo Reply

class ryu.ofproto.ofproto_v1_0_parser.OFPEchoReply(datapath, data=None)

Echo reply message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data.

Example:

@set_ev_cls(ofp_event.EventOFPEchoReply,
[HANDSHAKE_DISPATCHER, CONFIG_DISPATCHER, MAIN_DISPATCHER])
def echo_reply_handler(self, ev):
self.logger.debug('OFPEchoReply received: data=%s',
utils.hex_array(ev.msg.data))

Vendor

class ryu.ofproto.ofproto_v1_0_parser.OFPVendor(datapath)
Vendor message
The controller send this message to send the vendor-specific information to a switch.

Port Structures

class ryu.ofproto.ofproto_v1_0_parser.OFPPhyPort
Description of a port

160 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
port_no Port number and it uniquely identifies a port within a
switch.
hw_addr MAC address for the port.
name Null-terminated string containing a human-readable
name for the interface.
config Bitmap of port configration flags.

OFPPC_PORT_DOWN
OFPPC_NO_STP
OFPPC_NO_RECV
OFPPC_NO_RECV_STP
OFPPC_NO_FLOOD
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

state Bitmap of port state flags.

OFPPS_LINK_DOWN
OFPPS_STP_LISTEN
OFPPS_STP_LEARN
OFPPS_STP_FORWARD
OFPPS_STP_BLOCK
OFPPS_STP_MASK

curr Current features.

advertised Features being advertised by the port.
supported Features supported by the port.
peer Features advertised by peer.

Flow Match Structure

class ryu.ofproto.ofproto_v1_0_parser.OFPMatch(wildcards=None, in_port=None,

dl_src=None, dl_dst=None,
dl_vlan=None, dl_vlan_pcp=None,
dl_type=None, nw_tos=None,
nw_proto=None, nw_src=None,
nw_dst=None, tp_src=None,
tp_dst=None, nw_src_mask=32,
nw_dst_mask=32)
Flow Match Structure
This class is implementation of the flow match structure having compose/query API.

Attribute Description
wildcards Wildcard fields.
(match fields) For the available match fields, please refer to the following.

2.5. OpenFlow protocol API Reference 161

ryu Documentation, Release 4.34

Argument Value Description

in_port Integer 16bit Switch input port.
dl_src MAC address Ethernet source address.
dl_dst MAC address Ethernet destination address.
dl_vlan Integer 16bit Input VLAN id.
dl_vlan_pcp Integer 8bit Input VLAN priority.
dl_type Integer 16bit Ethernet frame type.
nw_tos Integer 8bit IP ToS (actually DSCP field, 6 bits).
nw_proto Integer 8bit IP protocol or lower 8 bits of ARP opcode.
nw_src IPv4 address IP source address.
nw_dst IPv4 address IP destination address.
tp_src Integer 16bit TCP/UDP source port.
tp_dst Integer 16bit TCP/UDP destination port.
nw_src_mask Integer 8bit IP source address mask specified as IPv4 address prefix.
nw_dst_mask Integer 8bit IP destination address mask specified as IPv4 address prefix.

Example:

>>> # compose
>>> match = parser.OFPMatch(
... in_port=1,
... dl_type=0x0800,
... dl_src='aa:bb:cc:dd:ee:ff',
... nw_src='192.168.0.1')
>>> # query
>>> if 'nw_src' in match:
... print match['nw_src']
...
'192.168.0.1'

Action Structures

class ryu.ofproto.ofproto_v1_0_parser.OFPActionHeader(type_, len_)

class ryu.ofproto.ofproto_v1_0_parser.OFPAction
class ryu.ofproto.ofproto_v1_0_parser.OFPActionOutput(port, max_len=65509)
Output action
This action indicates output a packet to the switch port.

Attribute Description
port Output port.
max_len Max length to send to controller.

Note:: The reason of this magic number (0xffe5) is because there is no good constant in of1.0. The same value
as OFPCML_MAX of of1.2 and of1.3 is used.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionVlanVid(vlan_vid)
Set the 802.1q VLAN id action
This action indicates the 802.1q VLAN id to be set.

162 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
vlan_vid VLAN id.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionVlanPcp(vlan_pcp)
Set the 802.1q priority action
This action indicates the 802.1q priority to be set.

Attribute Description
vlan_pcp VLAN priority.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionStripVlan
Strip the 802.1q header action
This action indicates the 802.1q priority to be striped.
class ryu.ofproto.ofproto_v1_0_parser.OFPActionDlAddr(dl_addr)
class ryu.ofproto.ofproto_v1_0_parser.OFPActionSetDlSrc(dl_addr)
Set the ethernet source address action
This action indicates the ethernet source address to be set.

Attribute Description
dl_addr Ethernet address.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionSetDlDst(dl_addr)
Set the ethernet destination address action
This action indicates the ethernet destination address to be set.

Attribute Description
dl_addr Ethernet address.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionNwAddr(nw_addr)
class ryu.ofproto.ofproto_v1_0_parser.OFPActionSetNwSrc(nw_addr)
Set the IP source address action
This action indicates the IP source address to be set.

Attribute Description
nw_addr IP address.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionSetNwDst(nw_addr)
Set the IP destination address action
This action indicates the IP destination address to be set.

Attribute Description
nw_addr IP address.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionSetNwTos(tos)
Set the IP ToS action

2.5. OpenFlow protocol API Reference 163

ryu Documentation, Release 4.34

This action indicates the IP ToS (DSCP field, 6 bits) to be set.

Attribute Description
tos IP ToS (DSCP field, 6 bits).

class ryu.ofproto.ofproto_v1_0_parser.OFPActionTpPort(tp)
class ryu.ofproto.ofproto_v1_0_parser.OFPActionSetTpSrc(tp)
Set the TCP/UDP source port action
This action indicates the TCP/UDP source port to be set.

Attribute Description
tp TCP/UDP port.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionSetTpDst(tp)
Set the TCP/UDP destination port action
This action indicates the TCP/UDP destination port to be set.

Attribute Description
tp TCP/UDP port.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionEnqueue(port, queue_id)

Output to queue action
This action indicates send packets to given queue on port.

Attribute Description
port Port that queue belongs.
queue_id Where to enqueue the packets.

class ryu.ofproto.ofproto_v1_0_parser.OFPActionVendor(vendor=None)
Vendor action
This action is an extensible action for the vendor.

2.5.3 OpenFlow v1.2 Messages and Structures

Controller-to-Switch Messages

Handshake

class ryu.ofproto.ofproto_v1_2_parser.OFPFeaturesRequest(datapath)
Features request message
The controller sends a feature request to the switch upon session establishment.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
Example:

164 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_features_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPFeaturesRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPFeaturesRequest": {}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPSwitchFeatures(datapath, data-

path_id=None,
n_buffers=None,
n_tables=None, capabili-
ties=None, ports=None)
Features reply message
The switch responds with a features reply message to a features request.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
Example:

@set_ev_cls(ofp_event.EventOFPSwitchFeatures, CONFIG_DISPATCHER)
def switch_features_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPSwitchFeatures received: '

'datapath_id=0x%016x n_buffers=%d '
'n_tables=%d capabilities=0x%08x ports=%s',
msg.datapath_id, msg.n_buffers, msg.n_tables,
msg.capabilities, msg.ports)

JSON Example:

{
"OFPSwitchFeatures": {
"capabilities": 79,
"datapath_id": 9210263729383,
"n_buffers": 0,
"n_tables": 255,
"ports": {
"6": {
"OFPPort": {
"advertised": 10240,
"config": 0,
"curr": 10248,
"curr_speed": 5000,
"hw_addr": "f2:0b:a4:7d:f8:ea",
"max_speed": 5000,
"name": "Port6",
"peer": 10248,
"port_no": 6,
"state": 4,
"supported": 10248
}
(continues on next page)

2.5. OpenFlow protocol API Reference 165

ryu Documentation, Release 4.34

(continued from previous page)

},
"7": {
"OFPPort": {
"advertised": 10240,
"config": 0,
"curr": 10248,
"curr_speed": 5000,
"hw_addr": "f2:0b:a4:d0:3f:70",
"max_speed": 5000,
"name": "Port7",
"peer": 10248,
"port_no": 7,
"state": 4,
"supported": 10248
}
}
}
}
}

Switch Configuration

class ryu.ofproto.ofproto_v1_2_parser.OFPSetConfig(datapath, flags=0,

miss_send_len=0)
Set config request message
The controller sends a set config request message to set configuraion parameters.

Attribute Description
flags One of the following configuration flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM
OFPC_FRAG_MASK
OFPC_INVALID_TTL_TO_CONTROLLER

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:
def send_set_config(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPSetConfig(datapath, ofp.OFPC_FRAG_NORMAL, 256)

datapath.send_msg(req)

JSON Example:
{
"OFPSetConfig": {
(continues on next page)

166 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"flags": 0,
"miss_send_len": 128
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPGetConfigRequest(datapath)
Get config request message
The controller sends a get config request to query configuration parameters in the switch.
Example:

def send_get_config_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetConfigRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPGetConfigRequest": {}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPGetConfigReply(datapath, flags=None,

miss_send_len=None)
Get config reply message
The switch responds to a configuration request with a get config reply message.

Attribute Description
flags One of the following configuration flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM
OFPC_FRAG_MASK
OFPC_INVALID_TTL_TO_CONTROLLER

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:

@set_ev_cls(ofp_event.EventOFPGetConfigReply, MAIN_DISPATCHER)
def get_config_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.flags == ofp.OFPC_FRAG_NORMAL:
flags = 'NORMAL'
elif msg.flags == ofp.OFPC_FRAG_DROP:
flags = 'DROP'
elif msg.flags == ofp.OFPC_FRAG_REASM:
(continues on next page)

2.5. OpenFlow protocol API Reference 167

ryu Documentation, Release 4.34

(continued from previous page)

flags = 'REASM'
elif msg.flags == ofp.OFPC_FRAG_MASK:
flags = 'MASK'
elif msg.flags == ofp.OFPC_INVALID_TTL_TO_CONTROLLER:
flags = 'INVALID TTL TO CONTROLLER'
else:
flags = 'unknown'
self.logger.debug('OFPGetConfigReply received: '
'flags=%s miss_send_len=%d',
flags, msg.miss_send_len)

JSON Example:
{
"OFPGetConfigReply": {
"flags": 0,
"miss_send_len": 128
}
}

Flow Table Configuration

class ryu.ofproto.ofproto_v1_2_parser.OFPTableMod(datapath, table_id, config)

Flow table configuration message
The controller sends this message to configure table state.

Attribute Description
table_id ID of the table (OFPTT_ALL indicates all tables)
config Bitmap of the following flags.

OFPTC_TABLE_MISS_CONTROLLER
OFPTC_TABLE_MISS_CONTINUE
OFPTC_TABLE_MISS_DROP
OFPTC_TABLE_MISS_MASK

Example:
def send_table_mod(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableMod(datapath, ofp.OFPTT_ALL,

ofp.OFPTC_TABLE_MISS_DROP)
datapath.send_msg(req)

JSON Example:
{
"OFPTableMod": {
"config": 0,
"table_id": 255
(continues on next page)

168 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
}

Modify State Messages

class ryu.ofproto.ofproto_v1_2_parser.OFPFlowMod(datapath, cookie=0, cookie_mask=0,

table_id=0, command=0,
idle_timeout=0, hard_timeout=0,
priority=0, buffer_id=4294967295,
out_port=0, out_group=0, flags=0,
match=None, instructions=None)
Modify Flow entry message
The controller sends this message to modify the flow table.

Attribute Description
cookie Opaque controller-issued identifier
cookie_mask Mask used to restrict the cookie bits that must
match when the command is OPFFC_MODIFY* or
OFPFC_DELETE*
table_id ID of the table to put the flow in
command One of the following values.

OFPFC_ADD
OFPFC_MODIFY
OFPFC_MODIFY_STRICT
OFPFC_DELETE
OFPFC_DELETE_STRICT

idle_timeout Idle time before discarding (seconds)

hard_timeout Max time before discarding (seconds)
priority Priority level of flow entry
buffer_id Buffered packet to apply to (or OFP_NO_BUFFER)
out_port For OFPFC_DELETE* commands, require match-
ing entries to include this as an output port
out_group For OFPFC_DELETE* commands, require match-
ing entries to include this as an output group
flags One of the following values.

OFPFF_SEND_FLOW_REM
OFPFF_CHECK_OVERLAP
OFPFF_RESET_COUNTS

match Instance of OFPMatch

instructions list of OFPInstruction* instance

Example:
def send_flow_mod(self, datapath):
ofp = datapath.ofproto
(continues on next page)

2.5. OpenFlow protocol API Reference 169

ryu Documentation, Release 4.34

(continued from previous page)

ofp_parser = datapath.ofproto_parser

cookie = cookie_mask = 0
table_id = 0
idle_timeout = hard_timeout = 0
priority = 32768
buffer_id = ofp.OFP_NO_BUFFER
match = ofp_parser.OFPMatch(in_port=1, eth_dst='ff:ff:ff:ff:ff:ff')
actions = [ofp_parser.OFPActionOutput(ofp.OFPP_NORMAL, 0)]
inst = [ofp_parser.OFPInstructionActions(ofp.OFPIT_APPLY_ACTIONS,
actions)]
req = ofp_parser.OFPFlowMod(datapath, cookie, cookie_mask,
table_id, ofp.OFPFC_ADD,
idle_timeout, hard_timeout,
priority, buffer_id,
ofp.OFPP_ANY, ofp.OFPG_ANY,
ofp.OFPFF_SEND_FLOW_REM,
match, inst)
datapath.send_msg(req)

JSON Example:
{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 258
}
},
"len": 16,
"type": 25
}
},
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 6,
"type": 0
}
}
],
(continues on next page)

170 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"len": 40,
"type": 3
}
},
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "01:02:03:04:05:06"
}
},
"len": 16,
"type": 25
}
}
],
"len": 24,
"type": 4
}
}
],
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 1
}
}

{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
(continues on next page)

2.5. OpenFlow protocol API Reference 171

ryu Documentation, Release 4.34

(continued from previous page)

"idle_timeout": 0,
"instructions": [
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 1,
"type": 1
}
}
],
"match": {
"OFPMatch": {
"length": 22,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPGroupMod(datapath, command=0, type_=0,

group_id=0, buckets=None)
Modify group entry message
The controller sends this message to modify the group table.

172 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
command One of the following values.

OFPGC_ADD
OFPGC_MODIFY
OFPGC_DELETE

type One of the following values.

OFPGT_ALL
OFPGT_SELECT
OFPGT_INDIRECT
OFPGT_FF

group_id Group identifier

buckets list of OFPBucket

type attribute corresponds to type_ parameter of init.

Example:
def send_group_mod(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

port = 1
max_len = 2000
actions = [ofp_parser.OFPActionOutput(port, max_len)]

weight = 100
watch_port = 0
watch_group = 0
buckets = [ofp_parser.OFPBucket(weight, watch_port, watch_group,
actions)]

group_id = 1
req = ofp_parser.OFPGroupMod(datapath, ofp.OFPGC_ADD,
ofp.OFPGT_SELECT, group_id, buckets)
datapath.send_msg(req)

JSON Example:
{
"OFPGroupMod": {
"buckets": [
{
"OFPBucket": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 2,
"type": 0
}
(continues on next page)

2.5. OpenFlow protocol API Reference 173

ryu Documentation, Release 4.34

(continued from previous page)

}
],
"len": 32,
"watch_group": 1,
"watch_port": 1,
"weight": 1
}
}
],
"command": 0,
"group_id": 1,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPPortMod(datapath, port_no=0,

hw_addr=’00:00:00:00:00:00’,
config=0, mask=0, advertise=0)
Port modification message
The controller sneds this message to modify the behavior of the port.

174 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
port_no Port number to modify
hw_addr The hardware address that must be the same as
hw_addr of OFPPort of OFPSwitchFeatures
config Bitmap of configuration flags.

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

mask Bitmap of configuration flags above to be changed

advertise Bitmap of the following flags.

OFPPF_10MB_HD
OFPPF_10MB_FD
OFPPF_100MB_HD
OFPPF_100MB_FD
OFPPF_1GB_HD
OFPPF_1GB_FD
OFPPF_10GB_FD
OFPPF_40GB_FD
OFPPF_100GB_FD
OFPPF_1TB_FD
OFPPF_OTHER
OFPPF_COPPER
OFPPF_FIBER
OFPPF_AUTONEG
OFPPF_PAUSE
OFPPF_PAUSE_ASYM

Example:

def send_port_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:

2.5. OpenFlow protocol API Reference 175

ryu Documentation, Release 4.34

{
"OFPPortMod": {
"advertise": 4096,
"config": 0,
"hw_addr": "00-11-00-00-11-11",
"mask": 0,
"port_no": 1
}
}

Read State Messages

class ryu.ofproto.ofproto_v1_2_parser.OFPDescStatsRequest(datapath, flags=0)

Description statistics request message
The controller uses this message to query description of the switch.

Attribute Description
flags Zero (none yet defined in the spec)

Example:

def send_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPDescStatsRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPDescStatsRequest": {
"flags": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPDescStats
Description statistics reply message
The switch responds with a stats reply that include this message to a description statistics request.

Attribute Description
mfr_desc Manufacturer description
hw_desc Hardware description
sw_desc Software description
serial_num Serial number
dp_desc Human readable description of datapath

Example:

@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
(continues on next page)

176 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_DESC:
self.desc_stats_reply_handler(body)

def desc_stats_reply_handler(self, body):

self.logger.debug('DescStats: mfr_desc=%s hw_desc=%s sw_desc=%s '
'serial_num=%s dp_desc=%s',
body.mfr_desc, body.hw_desc, body.sw_desc,
body.serial_num, body.dp_desc)

JSON Example:
{
"OFPStatsReply": {
"body": {
"OFPDescStats": {
"dp_desc": "dp",
"hw_desc": "hw",
"mfr_desc": "mfr",
"serial_num": "serial",
"sw_desc": "sw"
}
},
"flags": 0,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPFlowStatsRequest(datapath, ta-

ble_id=255,
out_port=4294967295,
out_group=4294967295,
cookie=0,
cookie_mask=0,
match=None, flags=0)
Individual flow statistics request message
The controller uses this message to query individual flow statistics.

Attribute Description
table_id ID of table to read
out_port Require matching entries to include this as an output port
out_group Require matching entries to include this as an output group
cookie Require matching entries to contain this cookie value
cookie_mask Mask used to restrict the cookie bits that must match
match Instance of OFPMatch
flags Zero (none yet defined in the spec)

Example:
def send_flow_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser
(continues on next page)

2.5. OpenFlow protocol API Reference 177

ryu Documentation, Release 4.34

(continued from previous page)

cookie = cookie_mask = 0
match = ofp_parser.OFPMatch(in_port=1)
req = ofp_parser.OFPFlowStatsRequest(datapath,
ofp.OFPTT_ALL,
ofp.OFPP_ANY, ofp.OFPG_ANY,
cookie, cookie_mask, match)
datapath.send_msg(req)

JSON Example:

{
"OFPFlowStatsRequest": {
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"table_id": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPFlowStats(table_id, duration_sec, dura-

tion_nsec, priority, idle_timeout,
hard_timeout, cookie,
packet_count, byte_count, match,
instructions=None, length=None)
Individual flow statistics reply message
The switch responds with a stats reply that include this message to an individual flow statistics request.

Attribute Description
table_id ID of table flow came from
duration_sec Time flow has been alive in seconds
duration_nsec Time flow has been alive in nanoseconds beyond duration_sec
priority Priority of the entry
idle_timeout Number of seconds idle before expiration
hard_timeout Number of seconds before expiration
cookie Opaque controller-issued identifier
packet_count Number of packets in flow
byte_count Number of bytes in flow
match Instance of OFPMatch
instructions list of OFPInstruction* instance

Example:

178 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_FLOW:
self.flow_stats_reply_handler(body)

def flow_stats_reply_handler(self, body):

flows = []
for stat in body:
flows.append('table_id=%s '
'duration_sec=%d duration_nsec=%d '
'priority=%d '
'idle_timeout=%d hard_timeout=%d '
'cookie=%d packet_count=%d byte_count=%d '
'match=%s instructions=%s' %
(stat.table_id,
stat.duration_sec, stat.duration_nsec,
stat.priority,
stat.idle_timeout, stat.hard_timeout,
stat.cookie, stat.packet_count, stat.byte_count,
stat.match, stat.instructions))
self.logger.debug('FlowStats: %s', flows)

JSON Example:

{
"OFPStatsReply": {
"body": [
{
"OFPFlowStats": {
"byte_count": 0,
"cookie": 0,
"duration_nsec": 115277000,
"duration_sec": 358,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [],
"length": 56,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"packet_count": 0,
"priority": 65535,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 0,
"cookie": 0,
(continues on next page)

2.5. OpenFlow protocol API Reference 179

ryu Documentation, Release 4.34

(continued from previous page)

"duration_nsec": 115055000,
"duration_sec": 358,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 0,
"port": 4294967290,
"type": 0
}
}
],
"len": 24,
"type": 4
}
}
],
"length": 88,
"match": {
"OFPMatch": {
"length": 10,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
}
],
"type": 1
}
},
"packet_count": 0,
"priority": 65534,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 238,
"cookie": 0,
"duration_nsec": 511582000,
"duration_sec": 316220,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 1,
"type": 1
(continues on next page)

180 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
}
],
"length": 80,
"match": {
"OFPMatch": {
"length": 22,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"packet_count": 3,
"priority": 123,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 98,
"cookie": 0,
"duration_nsec": 980901000,
"duration_sec": 313499,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 4294967293,
"type": 0
}
}
],
"len": 24,
"type": 3
}
}
],
(continues on next page)

2.5. OpenFlow protocol API Reference 181

ryu Documentation, Release 4.34

(continued from previous page)

"length": 80,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"packet_count": 1,
"priority": 0,
"table_id": 0
}
}
],
"flags": 0,
"type": 1
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPAggregateStatsRequest(datapath,
table_id=255,
out_port=4294967295,
out_group=4294967295,
cookie=0,
cookie_mask=0,
match=None,
flags=0)
Aggregate flow statistics request message
The controller uses this message to query aggregate flow statictics.

Example:

def send_aggregate_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

cookie = cookie_mask = 0
match = ofp_parser.OFPMatch(in_port=1)
req = ofp_parser.OFPAggregateStatsRequest(datapath, 0,
ofp.OFPTT_ALL,
ofp.OFPP_ANY,
ofp.OFPG_ANY,
cookie, cookie_mask,
match)
datapath.send_msg(req)

182 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

JSON Example:
{
"OFPAggregateStatsRequest": {
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"table_id": 255
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPAggregateStatsReply
Aggregate flow statistics reply message
The switch responds with a stats reply that include this message to an aggregate flow statistics request.

Attribute Description
packet_count Number of packets in flows
byte_count Number of bytes in flows
flow_count Number of flows

Example:
@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_AGGREGATE:
self.aggregate_stats_reply_handler(body)

def aggregate_stats_reply_handler(self, body):

self.logger.debug('AggregateStats: packet_count=%d byte_count=%d '
'flow_count=%d',
body.packet_count, body.byte_count,
body.flow_count)

JSON Example:
{
"OFPStatsReply": {
"body": {
"OFPAggregateStatsReply": {
"byte_count": 574,
"flow_count": 6,
"packet_count": 7
}
(continues on next page)

2.5. OpenFlow protocol API Reference 183

ryu Documentation, Release 4.34

(continued from previous page)

},
"flags": 0,
"type": 2
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPTableStatsRequest(datapath, flags=0)

Table statistics request message
The controller uses this message to query flow table statictics.

Attribute Description
flags Zero (none yet defined in the spec)

Example:

def send_table_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableStatsRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPTableStatsRequest": {
"flags": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPTableStats
Table statistics reply message
The switch responds with a stats reply that include this message to a table statistics request.

184 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
table_id ID of table
name table name
match Bitmap of (1 << OFPXMT_*) that indicate the fields the table can match on
wildcards Bitmap of (1 << OFPXMT_*) wildcards that are supported by the table
write_actions Bitmap of OFPAT_* that are supported by the table with OFPIT_WRITE_ACTIONS
apply_actions Bitmap of OFPAT_* that are supported by the table with OFPIT_APPLY_ACTIONS
write_setfields Bitmap of (1 << OFPXMT_*) header fields that can be set with OF-
PIT_WRITE_ACTIONS
apply_setfields Bitmap of (1 << OFPXMT_*) header fields that can be set with OF-
PIT_APPLY_ACTIONS
meta- Bits of metadata table can match
data_match
metadata_write Bits of metadata table can write
instructions Bitmap of OFPIT_* values supported
config Bitmap of OFPTC_* values
max_entries Max number of entries supported
active_count Number of active entries
lookup_count Number of packets looked up in table
matched_count Number of packets that hit table

Example:

@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_TABLE:
self.table_stats_reply_handler(body)

def table_stats_reply_handler(self, body):

tables = []
for stat in body:
tables.append('table_id=%d active_count=%d lookup_count=%d '
' matched_count=%d' %
(stat.table_id, stat.active_count,
stat.lookup_count, stat.matched_count))
self.logger.debug('TableStats: %s', tables)

class ryu.ofproto.ofproto_v1_2_parser.OFPPortStatsRequest(datapath,
port_no=4294967295,
flags=0)
Port statistics request message
The controller uses this message to query information about ports statistics.

Attribute Description
port_no Port number to read (OFPP_ANY to all ports)
flags Zero (none yet defined in the spec)

Example:

2.5. OpenFlow protocol API Reference 185

ryu Documentation, Release 4.34

def send_port_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortStatsRequest(datapath, ofp.OFPP_ANY)

datapath.send_msg(req)

JSON Example:

{
"OFPPortStatsRequest": {
"flags": 0,
"port_no": 4294967295
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPPortStats
Port statistics reply message
The switch responds with a stats reply that include this message to a port statistics request.

Attribute Description
port_no Port number
rx_packets Number of received packets
tx_packets Number of transmitted packets
rx_bytes Number of received bytes
tx_bytes Number of transmitted bytes
rx_dropped Number of packets dropped by RX
tx_dropped Number of packets dropped by TX
rx_errors Number of receive errors
tx_errors Number of transmit errors
rx_frame_err Number of frame alignment errors
rx_over_err Number of packet with RX overrun
rx_crc_err Number of CRC errors
collisions Number of collisions

Example:

@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_PORT:
self.port_stats_reply_handler(body)

def port_stats_reply_handler(self, body):

ports = []
for stat in body:
ports.append('port_no=%d '
'rx_packets=%d tx_packets=%d '
'rx_bytes=%d tx_bytes=%d '
'rx_dropped=%d tx_dropped=%d '
'rx_errors=%d tx_errors=%d '
(continues on next page)

186 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

'rx_frame_err=%d rx_over_err=%d rx_crc_err=%d '
'collisions=%d' %
(stat.port_no,
stat.rx_packets, stat.tx_packets,
stat.rx_bytes, stat.tx_bytes,
stat.rx_dropped, stat.tx_dropped,
stat.rx_errors, stat.tx_errors,
stat.rx_frame_err, stat.rx_over_err,
stat.rx_crc_err, stat.collisions))
self.logger.debug('PortStats: %s', ports)

JSON Example:

{
"OFPStatsReply": {
"body": [
{
"OFPPortStats": {
"collisions": 0,
"port_no": 7,
"rx_bytes": 0,
"rx_crc_err": 0,
"rx_dropped": 0,
"rx_errors": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"rx_packets": 0,
"tx_bytes": 336,
"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
},
{
"OFPPortStats": {
"collisions": 0,
"port_no": 6,
"rx_bytes": 336,
"rx_crc_err": 0,
"rx_dropped": 0,
"rx_errors": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"rx_packets": 4,
"tx_bytes": 336,
"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
}
],
"flags": 0,
"type": 4
}
}

2.5. OpenFlow protocol API Reference 187

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_2_parser.OFPQueueStatsRequest(datapath,
port_no=4294967295,
queue_id=4294967295,
flags=0)
Queue statistics request message
The controller uses this message to query queue statictics.

Attribute Description
port_no Port number to read
queue_id ID of queue to read
flags Zero (none yet defined in the spec)

Example:
def send_queue_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueStatsRequest(datapath, ofp.OFPP_ANY,

ofp.OFPQ_ALL)
datapath.send_msg(req)

JSON Example:
{
"OFPQueueStatsRequest": {
"flags": 0,
"port_no": 4294967295,
"queue_id": 4294967295
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPQueueStats
Queue statistics reply message
The switch responds with a stats reply that include this message to an aggregate flow statistics request.

Attribute Description
port_no Port number
queue_id ID of queue
tx_bytes Number of transmitted bytes
tx_packets Number of transmitted packets
tx_errors Number of packets dropped due to overrun

Example:
@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_QUEUE:
self.queue_stats_reply_handler(body)

(continues on next page)

188 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

def queue_stats_reply_handler(self, body):
queues = []
for stat in body:
queues.append('port_no=%d queue_id=%d '
'tx_bytes=%d tx_packets=%d tx_errors=%d ' %
(stat.port_no, stat.queue_id,
stat.tx_bytes, stat.tx_packets, stat.tx_errors))
self.logger.debug('QueueStats: %s', queues)

JSON Example:

{
"OFPStatsReply": {
"body": [
{
"OFPQueueStats": {
"port_no": 7,
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
},
{
"OFPQueueStats": {
"port_no": 6,
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
},
{
"OFPQueueStats": {
"port_no": 7,
"queue_id": 2,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
}
],
"flags": 0,
"type": 5
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPGroupStatsRequest(datapath,
group_id=4294967292,
flags=0)
Group statistics request message
The controller uses this message to query statistics of one or more groups.

Attribute Description
group_id ID of group to read (OFPG_ALL to all groups)
flags Zero (none yet defined in the spec)

2.5. OpenFlow protocol API Reference 189

ryu Documentation, Release 4.34

Example:

def send_group_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupStatsRequest(datapath, ofp.OFPG_ALL)

datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_2_parser.OFPGroupStats(group_id, ref_count,

packet_count, byte_count,
bucket_counters, length=None)
Group statistics reply message
The switch responds with a stats reply that include this message to a group statistics request.

Attribute Description
group_id Group identifier
ref_count Number of flows or groups that directly forward to this group
packet_count Number of packets processed by group
byte_count Number of bytes processed by group
bucket_counters List of OFPBucketCounter instance

Example:

@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_GROUP:
self.group_stats_reply_handler(body)

def group_stats_reply_handler(self, body):

groups = []
for stat in body:
groups.append('group_id=%d ref_count=%d packet_count=%d '
'byte_count=%d bucket_counters=%s' %
(stat.group_id,
stat.ref_count, stat.packet_count,
stat.byte_count, stat.bucket_counters))
self.logger.debug('GroupStats: %s', groups)

class ryu.ofproto.ofproto_v1_2_parser.OFPGroupDescStatsRequest(datapath,
flags=0)
Group description request message
The controller uses this message to list the set of groups on a switch.

Attribute Description
flags Zero (none yet defined in the spec)

Example:

190 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_group_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupDescStatsRequest(datapath)
datapath.send_msg(req)

JSON Example:
{
"OFPGroupDescStatsRequest": {
"flags": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPGroupDescStats(type_, group_id, buckets,

length=None)
Group description reply message
The switch responds with a stats reply that include this message to a group description request.

Attribute Description
type One of OFPGT_*
group_id Group identifier
buckets List of OFPBucket instance

type attribute corresponds to type_ parameter of init.

Example:
@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_GROUP_DESC:
self.group_desc_stats_reply_handler(body)

def group_desc_stats_reply_handler(self, body):

descs = []
for stat in body:
descs.append('type=%d group_id=%d buckets=%s' %
(stat.type, stat.group_id, stat.buckets))
self.logger.debug('GroupDescStats: %s', descs)

JSON Example:
{
"OFPStatsReply": {
"body": [
{
"OFPGroupDescStats": {
"buckets": [
{
"OFPBucket": {
"actions": [
{
(continues on next page)

2.5. OpenFlow protocol API Reference 191

ryu Documentation, Release 4.34

(continued from previous page)

"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 2,
"type": 0
}
}
],
"len": 32,
"watch_group": 1,
"watch_port": 1,
"weight": 1
}
}
],
"group_id": 1,
"length": 40,
"type": 0
}
}
],
"flags": 0,
"type": 7
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPGroupFeaturesStatsRequest(datapath,
flags=0)
Group features request message
The controller uses this message to list the capabilities of groups on a switch.

Attribute Description
flags Zero (none yet defined in the spec)

Example:

def send_group_features_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupFeaturesStatsRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPGroupFeaturesStatsRequest": {
"flags": 0
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPGroupFeaturesStats(types, capabilities,

max_groups, ac-
tions, length=None)
Group features reply message
The switch responds with a stats reply that include this message to a group features request.

192 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
types Bitmap of OFPGT_* values supported
capabilities Bitmap of OFPGFC_* capability supported
max_groups Maximum number of groups for each type
actions Bitmaps of OFPAT_* that are supported

Example:

@set_ev_cls(ofp_event.EventOFPStatsReply, MAIN_DISPATCHER)
def stats_reply_handler(self, ev):
msg = ev.msg
ofp = msg.datapath.ofproto
body = ev.msg.body

if msg.type == ofp.OFPST_GROUP_FEATURES:
self.group_features_stats_reply_handler(body)

def group_features_stats_reply_handler(self, body):

self.logger.debug('GroupFeaturesStats: types=%d '
'capabilities=0x%08x max_groups=%s '
'actions=%s',
body.types, body.capabilities, body.max_groups,
body.actions)

JSON Example:

{
"OFPStatsReply": {
"body": {
"OFPGroupFeaturesStats": {
"actions": [
67082241,
67082241,
67082241,
67082241
],
"capabilities": 5,
"length": 40,
"max_groups": [
16777216,
16777216,
16777216,
16777216
],
"types": 15
}
},
"flags": 0,
"type": 8
}
}

2.5. OpenFlow protocol API Reference 193

ryu Documentation, Release 4.34

Queue Configuration Messages

class ryu.ofproto.ofproto_v1_2_parser.OFPQueueGetConfigRequest(datapath, port)

Queue configuration request message

Attribute Description
port Port to be queried (OFPP_ANY to all configured queues)

Example:

def send_queue_get_config_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueGetConfigRequest(datapath, ofp.OFPP_ANY)

datapath.send_msg(req)

JSON Example:

{
"OFPQueueGetConfigRequest": {
"port": 4294967295
}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPQueueGetConfigReply(datapath,
port=None,
queues=None)
Queue configuration reply message
The switch responds with this message to a queue configuration request.

Attribute Description
port Port which was queried
queues list of OFPPacketQueue instance

Example:

@set_ev_cls(ofp_event.EventOFPQueueGetConfigReply, MAIN_DISPATCHER)
def queue_get_config_reply_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPQueueGetConfigReply received: '

'port=%s queues=%s',
msg.port, msg.queues)

JSON Example:

{
"OFPQueueGetConfigReply": {
"port": 4294967295,
"queues": [
{
"OFPPacketQueue": {
"len": 48,
(continues on next page)

194 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"port": 77,
"properties": [
{
"OFPQueuePropMinRate": {
"len": 16,
"property": 1,
"rate": 10
}
},
{
"OFPQueuePropMaxRate": {
"len": 16,
"property": 2,
"rate": 900
}
}
],
"queue_id": 99
}
},
{
"OFPPacketQueue": {
"len": 48,
"port": 77,
"properties": [
{
"OFPQueuePropMinRate": {
"len": 16,
"property": 1,
"rate": 100
}
},
{
"OFPQueuePropMaxRate": {
"len": 16,
"property": 2,
"rate": 200
}
}
],
"queue_id": 88
}
}
]
}
}

Packet-Out Message

class ryu.ofproto.ofproto_v1_2_parser.OFPPacketOut(datapath, buffer_id=None,

in_port=None, actions=None,
data=None, actions_len=None)
Packet-Out message
The controller uses this message to send a packet out throught the switch.

2.5. OpenFlow protocol API Reference 195

ryu Documentation, Release 4.34

Attribute Description
buffer_id ID assigned by datapath (OFP_NO_BUFFER if none)
in_port Packet’s input port or OFPP_CONTROLLER
actions list of OpenFlow action class
data Packet data of a binary type value or an instances of packet.Packet.

Example:

def send_packet_out(self, datapath, buffer_id, in_port):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

actions = [ofp_parser.OFPActionOutput(ofp.OFPP_FLOOD, 0)]

req = ofp_parser.OFPPacketOut(datapath, buffer_id,
in_port, actions)
datapath.send_msg(req)

JSON Example:

{
"OFPPacketOut": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 4294967292,
"type": 0
}
}
],
"actions_len": 16,
"buffer_id": 4294967295,
"data":
˓→"8guk0D9w8gukffjqCABFAABU+BoAAP8Br4sKAAABCgAAAggAAgj3YAAAMdYCAAAAAACrjS0xAAAAABAREhMUFRYXGBkaG

˓→",

"in_port": 4294967293
}
}

Barrier Message

class ryu.ofproto.ofproto_v1_2_parser.OFPBarrierRequest(datapath)
Barrier request message
The controller sends this message to ensure message dependencies have been met or receive notifications for
completed operations.
Example:

def send_barrier_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPBarrierRequest(datapath)
datapath.send_msg(req)

196 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

JSON Example:
{
"OFPBarrierRequest": {}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPBarrierReply(datapath)
Barrier reply message
The switch responds with this message to a barrier request.
Example:
@set_ev_cls(ofp_event.EventOFPBarrierReply, MAIN_DISPATCHER)
def barrier_reply_handler(self, ev):
self.logger.debug('OFPBarrierReply received')

JSON Example:
{
"OFPBarrierReply": {}
}

Role Request Message

class ryu.ofproto.ofproto_v1_2_parser.OFPRoleRequest(datapath, role, generation_id)

Role request message
The controller uses this message to change its role.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

generation_id Master Election Generation ID

Example:
def send_role_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPRoleRequest(datapath, ofp.OFPCR_ROLE_EQUAL, 0)

datapath.send_msg(req)

JSON Example:
{
"OFPRoleRequest": {
"generation_id": 17294086455919964160,
"role": 2
(continues on next page)

2.5. OpenFlow protocol API Reference 197

ryu Documentation, Release 4.34

(continued from previous page)

}
}

class ryu.ofproto.ofproto_v1_2_parser.OFPRoleReply(datapath, role=None, genera-

tion_id=None)
Role reply message
The switch responds with this message to a role request.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

generation_id Master Election Generation ID

Example:

@set_ev_cls(ofp_event.EventOFPRoleReply, MAIN_DISPATCHER)
def role_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.role == ofp.OFPCR_ROLE_NOCHANGE:
role = 'NOCHANGE'
elif msg.role == ofp.OFPCR_ROLE_EQUAL:
role = 'EQUAL'
elif msg.role == ofp.OFPCR_ROLE_MASTER:
role = 'MASTER'
elif msg.role == ofp.OFPCR_ROLE_SLAVE:
role = 'SLAVE'
else:
role = 'unknown'

self.logger.debug('OFPRoleReply received: '

'role=%s generation_id=%d',
role, msg.generation_id)

JSON Example:

{
"OFPRoleReply": {
"generation_id": 17294086455919964160,
"role": 3
}
}

Asynchronous Messages

198 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Packet-In Message

class ryu.ofproto.ofproto_v1_2_parser.OFPPacketIn(datapath, buffer_id=None, to-

tal_len=None, reason=None,
table_id=None, match=None,
data=None)
Packet-In message
The switch sends the packet that received to the controller by this message.

Attribute Description
buffer_id ID assigned by datapath
total_len Full length of frame
reason Reason packet is being sent.

OFPR_NO_MATCH
OFPR_ACTION
OFPR_INVALID_TTL

table_id ID of the table that was looked up

match Instance of OFPMatch
data Ethernet frame

Example:

@set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
def packet_in_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPR_NO_MATCH:
reason = 'NO MATCH'
elif msg.reason == ofp.OFPR_ACTION:
reason = 'ACTION'
elif msg.reason == ofp.OFPR_INVALID_TTL:
reason = 'INVALID TTL'
else:
reason = 'unknown'

self.logger.debug('OFPPacketIn received: '

'buffer_id=%x total_len=%d reason=%s '
'table_id=%d match=%s data=%s',
msg.buffer_id, msg.total_len, reason,
msg.table_id, msg.match,
utils.hex_array(msg.data))

JSON Example:

{
"OFPPacketIn": {
"buffer_id": 2,
"data": "////////8gukffjqCAYAAQgABgQAAfILpH346goAAAEAAAAAAAAKAAAD",
"match": {
"OFPMatch": {
(continues on next page)

2.5. OpenFlow protocol API Reference 199

ryu Documentation, Release 4.34

(continued from previous page)

"length": 80,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
},
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "ff:ff:ff:ff:ff:ff"
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "arp_op",
"mask": null,
"value": 1
}
},
{
"OXMTlv": {
"field": "arp_spa",
"mask": null,
"value": "10.0.0.1"
}
},
{
"OXMTlv": {
"field": "arp_tpa",
"mask": null,
"value": "10.0.0.3"
}
},
{
"OXMTlv": {
"field": "arp_sha",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
(continues on next page)

200 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OXMTlv": {
"field": "arp_tha",
"mask": null,
"value": "00:00:00:00:00:00"
}
}
],
"type": 1
}
},
"reason": 1,
"table_id": 1,
"total_len": 42
}
}

Flow Removed Message

class ryu.ofproto.ofproto_v1_2_parser.OFPFlowRemoved(datapath, cookie=None,

priority=None, rea-
son=None, table_id=None,
duration_sec=None,
duration_nsec=None,
idle_timeout=None,
hard_timeout=None,
packet_count=None,
byte_count=None,
match=None)
Flow removed message
When flow entries time out or are deleted, the switch notifies controller with this message.

2.5. OpenFlow protocol API Reference 201

ryu Documentation, Release 4.34

Attribute Description
cookie Opaque controller-issued identifier
priority Priority level of flow entry
reason One of the following values.

OFPRR_IDLE_TIMEOUT
OFPRR_HARD_TIMEOUT
OFPRR_DELETE
OFPRR_GROUP_DELETE

table_id ID of the table

duration_sec Time flow was alive in seconds
duration_nsec Time flow was alive in nanoseconds beyond dura-
tion_sec
idle_timeout Idle timeout from original flow mod
hard_timeout Hard timeout from original flow mod
packet_count Number of packets that was associated with the flow
byte_count Number of bytes that was associated with the flow
match Instance of OFPMatch

Example:

@set_ev_cls(ofp_event.EventOFPFlowRemoved, MAIN_DISPATCHER)
def flow_removed_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

self.logger.debug('OFPFlowRemoved received: '

'cookie=%d priority=%d reason=%s table_id=%d '
'duration_sec=%d duration_nsec=%d '
'idle_timeout=%d hard_timeout=%d '
'packet_count=%d byte_count=%d match.fields=%s',
msg.cookie, msg.priority, reason, msg.table_id,
msg.duration_sec, msg.duration_nsec,
msg.idle_timeout, msg.hard_timeout,
msg.packet_count, msg.byte_count, msg.match)

JSON Example:

{
"OFPFlowRemoved": {
"byte_count": 86,
(continues on next page)

202 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"cookie": 0,
"duration_nsec": 48825000,
"duration_sec": 3,
"hard_timeout": 0,
"idle_timeout": 3,
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"packet_count": 1,
"priority": 65535,
"reason": 0,
"table_id": 0
}
}

Port Status Message

class ryu.ofproto.ofproto_v1_2_parser.OFPPortStatus(datapath, reason=None,

desc=None)
Port status message
The switch notifies controller of change of ports.

Attribute Description
reason One of the following values.

OFPPR_ADD
OFPPR_DELETE
OFPPR_MODIFY

desc instance of OFPPort

Example:

@set_ev_cls(ofp_event.EventOFPPortStatus, MAIN_DISPATCHER)
def port_status_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPPR_ADD:
(continues on next page)

2.5. OpenFlow protocol API Reference 203

ryu Documentation, Release 4.34

(continued from previous page)

reason = 'ADD'
elif msg.reason == ofp.OFPPR_DELETE:
reason = 'DELETE'
elif msg.reason == ofp.OFPPR_MODIFY:
reason = 'MODIFY'
else:
reason = 'unknown'

self.logger.debug('OFPPortStatus received: reason=%s desc=%s',

reason, msg.desc)

JSON Example:

{
"OFPPortStatus": {
"desc": {
"OFPPort": {
"advertised": 10240,
"config": 0,
"curr": 10248,
"curr_speed": 5000,
"hw_addr": "f2:0b:a4:d0:3f:70",
"max_speed": 5000,
"name": "\u79c1\u306e\u30dd\u30fc\u30c8",
"peer": 10248,
"port_no": 7,
"state": 4,
"supported": 10248
}
},
"reason": 0
}
}

Error Message

class ryu.ofproto.ofproto_v1_2_parser.OFPErrorMsg(datapath, type_=None, code=None,

data=None, **kwargs)
Error message
The switch notifies controller of problems by this message.

Attribute Description
type High level type of error
code Details depending on the type
data Variable length data depending on the type and code

type attribute corresponds to type_ parameter of init.

Types and codes are defined in ryu.ofproto.ofproto.

204 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Type Code
OFPET_HELLO_FAILED OFPHFC_*
OFPET_BAD_REQUEST OFPBRC_*
OFPET_BAD_ACTION OFPBAC_*
OFPET_BAD_INSTRUCTION OFPBIC_*
OFPET_BAD_MATCH OFPBMC_*
OFPET_FLOW_MOD_FAILED OFPFMFC_*
OFPET_GROUP_MOD_FAILED OFPGMFC_*
OFPET_PORT_MOD_FAILED OFPPMFC_*
OFPET_TABLE_MOD_FAILED OFPTMFC_*
OFPET_QUEUE_OP_FAILED OFPQOFC_*
OFPET_SWITCH_CONFIG_FAILED OFPSCFC_*
OFPET_ROLE_REQUEST_FAILED OFPRRFC_*
OFPET_EXPERIMENTER N/A

If type == OFPET_EXPERIMENTER, this message has also the following attributes.

Attribute Description
exp_type Experimenter defined type
experimenter Experimenter ID

Example:
@set_ev_cls(ofp_event.EventOFPErrorMsg,
[HANDSHAKE_DISPATCHER, CONFIG_DISPATCHER, MAIN_DISPATCHER])
def error_msg_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPErrorMsg received: type=0x%02x code=0x%02x '

'message=%s',
msg.type, msg.code, utils.hex_array(msg.data))

JSON Example:
{
"OFPErrorMsg": {
"code": 11,
"data": "ZnVnYWZ1Z2E=",
"type": 2
}
}

{
"OFPErrorMsg": {
"code": null,
"data": "amlra2VuIGRhdGE=",
"exp_type": 60000,
"experimenter": 999999,
"type": 65535
}
}

Symmetric Messages

2.5. OpenFlow protocol API Reference 205

ryu Documentation, Release 4.34

Hello

class ryu.ofproto.ofproto_v1_2_parser.OFPHello(datapath)
Hello message
When connection is started, the hello message is exchanged between a switch and a controller.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
JSON Example:

{
"OFPHello": {}
}

Echo Request

class ryu.ofproto.ofproto_v1_2_parser.OFPEchoRequest(datapath, data=None)

Echo request message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data

Example:

def send_echo_request(self, datapath, data):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPEchoRequest(datapath, data)

datapath.send_msg(req)

@set_ev_cls(ofp_event.EventOFPEchoRequest,
[HANDSHAKE_DISPATCHER, CONFIG_DISPATCHER, MAIN_DISPATCHER])
def echo_request_handler(self, ev):
self.logger.debug('OFPEchoRequest received: data=%s',
utils.hex_array(ev.msg.data))

JSON Example:

{
"OFPEchoRequest": {
"data": "aG9nZQ=="
}
}

Echo Reply

class ryu.ofproto.ofproto_v1_2_parser.OFPEchoReply(datapath, data=None)

Echo reply message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

206 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
data An arbitrary length data

Example:

def send_echo_reply(self, datapath, data):

ofp_parser = datapath.ofproto_parser

reply = ofp_parser.OFPEchoReply(datapath, data)

datapath.send_msg(reply)

JSON Example:

{
"OFPEchoReply": {
"data": "aG9nZQ=="
}
}

Experimenter

class ryu.ofproto.ofproto_v1_2_parser.OFPExperimenter(datapath, exper-

imenter=None,
exp_type=None, data=None)
Experimenter extension message

Attribute Description
experimenter Experimenter ID
exp_type Experimenter defined
data Experimenter defined arbitrary additional data

JSON Example:

{
"OFPExperimenter": {
"data": "bmF6bw==",
"exp_type": 123456789,
"experimenter": 98765432
}
}

Port Structures

class ryu.ofproto.ofproto_v1_2_parser.OFPPort
Description of a port

2.5. OpenFlow protocol API Reference 207

ryu Documentation, Release 4.34

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

state Bitmap of port state flags.

OFPPS_LINK_DOWN
OFPPS_BLOCKED
OFPPS_LIVE

curr Current features.

advertised Features being advertised by the port.
supported Features supported by the port.
peer Features advertised by peer.
curr_speed Current port bitrate in kbps.
max_speed Max port bitrate in kbps.

Flow Match Structure

class ryu.ofproto.ofproto_v1_2_parser.OFPMatch(type_=None, length=None, _or-

dered_fields=None, **kwargs)
Flow Match Structure
This class is implementation of the flow match structure having compose/query API. There are new API and old
API for compatibility. the old API is supposed to be removed later.
You can define the flow match by the keyword arguments. The following arguments are available.

Argument Value Description

208 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Table 1 – continued from previous page

Argument Value Description
tcp_src Integer 16bit TCP source port
tcp_dst Integer 16bit TCP destination port
udp_src Integer 16bit UDP source port
udp_dst Integer 16bit UDP destination port
sctp_src Integer 16bit SCTP source port
sctp_dst Integer 16bit SCTP destination port
icmpv4_type Integer 8bit ICMP type
icmpv4_code Integer 8bit ICMP code
arp_op Integer 16bit ARP opcode
arp_spa IPv4 address ARP source IPv4 address
arp_tpa IPv4 address ARP target IPv4 address
arp_sha MAC address ARP source hardware address
arp_tha MAC address ARP target hardware address
ipv6_src IPv6 address IPv6 source address
ipv6_dst IPv6 address IPv6 destination address
ipv6_flabel Integer 32bit IPv6 Flow Label
icmpv6_type Integer 8bit ICMPv6 type
icmpv6_code Integer 8bit ICMPv6 code
ipv6_nd_target IPv6 address Target address for ND
ipv6_nd_sll MAC address Source link-layer for ND
ipv6_nd_tll MAC address Target link-layer for ND
mpls_label Integer 32bit MPLS label
mpls_tc Integer 8bit MPLS TC
pbb_uca Integer 8bit PBB UCA header field (EXT-256 Old version of ONF Extension)
tcp_flags Integer 16bit TCP flags (EXT-109 ONF Extension)
actset_output Integer 32bit Output port from action set metadata (EXT-233 ONF Extension)

Example:

>>> # compose
>>> match = parser.OFPMatch(
... in_port=1,
... eth_type=0x86dd,
... ipv6_src=('2001:db8:bd05:1d2:288a:1fc0:1:10ee',
... 'ffff:ffff:ffff:ffff::'),
... ipv6_dst='2001:db8:bd05:1d2:288a:1fc0:1:10ee')
>>> # query
>>> if 'ipv6_src' in match:
... print match['ipv6_src']
...
('2001:db8:bd05:1d2:288a:1fc0:1:10ee', 'ffff:ffff:ffff:ffff::')

Note: For the list of the supported Nicira experimenter matches, please refer to ryu.ofproto.nx_match.

Note: For VLAN id match field, special values are defined in OpenFlow Spec.
1) Packets with and without a VLAN tag
• Example:

2.5. OpenFlow protocol API Reference 209

ryu Documentation, Release 4.34

match = parser.OFPMatch()

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

2) Only packets without a VLAN tag

• Example:

match = parser.OFPMatch(vlan_vid=0x0000)

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) x
VLAN-tagged(vlan_id=5) x

3) Only packets with a VLAN tag regardless of its value

• Example:

match = parser.OFPMatch(vlan_vid=(0x1000, 0x1000))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

4) Only packets with VLAN tag and VID equal

• Example:

match = parser.OFPMatch(vlan_vid=(0x1000 | 3))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) x

Flow Instruction Structures

class ryu.ofproto.ofproto_v1_2_parser.OFPInstructionGotoTable(table_id,
type_=None,
len_=None)
Goto table instruction
This instruction indicates the next table in the processing pipeline.

210 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
table_id Next table

class ryu.ofproto.ofproto_v1_2_parser.OFPInstructionWriteMetadata(metadata,
meta-
data_mask,
type_=None,
len_=None)
Write metadata instruction
This instruction writes the masked metadata value into the metadata field.

Attribute Description
metadata Metadata value to write
metadata_mask Metadata write bitmask

class ryu.ofproto.ofproto_v1_2_parser.OFPInstructionActions(type_, ac-

tions=None,
len_=None)
Actions instruction
This instruction writes/applies/clears the actions.

Attribute Description
type One of following values.

OFPIT_WRITE_ACTIONS
OFPIT_APPLY_ACTIONS
OFPIT_CLEAR_ACTIONS

actions list of OpenFlow action class

type attribute corresponds to type_ parameter of init.

Action Structures

class ryu.ofproto.ofproto_v1_2_parser.OFPActionOutput(port, max_len=65509,

type_=None, len_=None)
Output action
This action indicates output a packet to the switch port.

Attribute Description
port Output port
max_len Max length to send to controller

class ryu.ofproto.ofproto_v1_2_parser.OFPActionGroup(group_id=0, type_=None,

len_=None)
Group action
This action indicates the group used to process the packet.

2.5. OpenFlow protocol API Reference 211

ryu Documentation, Release 4.34

Attribute Description
group_id Group identifier

class ryu.ofproto.ofproto_v1_2_parser.OFPActionSetQueue(queue_id, type_=None,

len_=None)
Set queue action
This action sets the queue id that will be used to map a flow to an already-configured queue on a port.

Attribute Description
queue_id Queue ID for the packets

class ryu.ofproto.ofproto_v1_2_parser.OFPActionSetMplsTtl(mpls_ttl, type_=None,

len_=None)
Set MPLS TTL action
This action sets the MPLS TTL.

Attribute Description
mpls_ttl MPLS TTL

class ryu.ofproto.ofproto_v1_2_parser.OFPActionDecMplsTtl(type_=None,
len_=None)
Decrement MPLS TTL action
This action decrements the MPLS TTL.
class ryu.ofproto.ofproto_v1_2_parser.OFPActionSetNwTtl(nw_ttl, type_=None,
len_=None)
Set IP TTL action
This action sets the IP TTL.

Attribute Description
nw_ttl IP TTL

class ryu.ofproto.ofproto_v1_2_parser.OFPActionDecNwTtl(type_=None, len_=None)

Decrement IP TTL action
This action decrements the IP TTL.
class ryu.ofproto.ofproto_v1_2_parser.OFPActionCopyTtlOut(type_=None,
len_=None)
Copy TTL Out action
This action copies the TTL from the next-to-outermost header with TTL to the outermost header with TTL.
class ryu.ofproto.ofproto_v1_2_parser.OFPActionCopyTtlIn(type_=None,
len_=None)
Copy TTL In action
This action copies the TTL from the outermost header with TTL to the next-to-outermost header with TTL.
class ryu.ofproto.ofproto_v1_2_parser.OFPActionPushVlan(ethertype=33024,
type_=None, len_=None)
Push VLAN action
This action pushes a new VLAN tag to the packet.

212 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
ethertype Ether type. The default is 802.1Q. (0x8100)

class ryu.ofproto.ofproto_v1_2_parser.OFPActionPushMpls(ethertype=34887,
type_=None, len_=None)
Push MPLS action
This action pushes a new MPLS header to the packet.

Attribute Description
ethertype Ether type

class ryu.ofproto.ofproto_v1_2_parser.OFPActionPopVlan(type_=None, len_=None)

Pop VLAN action
This action pops the outermost VLAN tag from the packet.
class ryu.ofproto.ofproto_v1_2_parser.OFPActionPopMpls(ethertype=2048,
type_=None, len_=None)
Pop MPLS action
This action pops the MPLS header from the packet.
class ryu.ofproto.ofproto_v1_2_parser.OFPActionSetField(field=None, **kwargs)
Set field action
This action modifies a header field in the packet.
The set of keywords available for this is same as OFPMatch.
Example:

set_field = OFPActionSetField(eth_src="00:00:00:00:00:00")

class ryu.ofproto.ofproto_v1_2_parser.OFPActionExperimenter(experimenter,
type_=None,
len_=None)
Experimenter action
This action is an extensible action for the experimenter.

Attribute Description
experimenter Experimenter ID

Note: For the list of the supported Nicira experimenter actions, please refer to ryu.ofproto.nx_actions.

2.5.4 OpenFlow v1.3 Messages and Structures

Controller-to-Switch Messages

Handshake

class ryu.ofproto.ofproto_v1_3_parser.OFPFeaturesRequest(datapath)
Features request message

2.5. OpenFlow protocol API Reference 213

ryu Documentation, Release 4.34

The controller sends a feature request to the switch upon session establishment.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
Example:

def send_features_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPFeaturesRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPFeaturesRequest": {}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPSwitchFeatures(datapath, data-

path_id=None,
n_buffers=None,
n_tables=None, auxil-
iary_id=None, capabili-
ties=None)
Features reply message
The switch responds with a features reply message to a features request.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
Example:

@set_ev_cls(ofp_event.EventOFPSwitchFeatures, CONFIG_DISPATCHER)
def switch_features_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPSwitchFeatures received: '

'datapath_id=0x%016x n_buffers=%d '
'n_tables=%d auxiliary_id=%d '
'capabilities=0x%08x',
msg.datapath_id, msg.n_buffers, msg.n_tables,
msg.auxiliary_id, msg.capabilities)

JSON Example:

{
"OFPSwitchFeatures": {
"auxiliary_id": 99,
"capabilities": 79,
"datapath_id": 9210263729383,
"n_buffers": 0,
"n_tables": 255
}
}

214 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Switch Configuration

class ryu.ofproto.ofproto_v1_3_parser.OFPSetConfig(datapath, flags=0,

miss_send_len=0)
Set config request message
The controller sends a set config request message to set configuraion parameters.

Attribute Description
flags Bitmap of the following flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:
def send_set_config(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPSetConfig(datapath, ofp.OFPC_FRAG_NORMAL, 256)

datapath.send_msg(req)

JSON Example:
{
"OFPSetConfig": {
"flags": 0,
"miss_send_len": 128
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGetConfigRequest(datapath)
Get config request message
The controller sends a get config request to query configuration parameters in the switch.
Example:
def send_get_config_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetConfigRequest(datapath)
datapath.send_msg(req)

JSON Example:
{
"OFPGetConfigRequest": {}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGetConfigReply(datapath, flags=None,

miss_send_len=None)
Get config reply message

2.5. OpenFlow protocol API Reference 215

ryu Documentation, Release 4.34

The switch responds to a configuration request with a get config reply message.

Attribute Description
flags Bitmap of the following flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM
OFPC_FRAG_MASK

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:

@set_ev_cls(ofp_event.EventOFPGetConfigReply, MAIN_DISPATCHER)
def get_config_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto
flags = []

if msg.flags & ofp.OFPC_FRAG_NORMAL:

flags.append('NORMAL')
if msg.flags & ofp.OFPC_FRAG_DROP:
flags.append('DROP')
if msg.flags & ofp.OFPC_FRAG_REASM:
flags.append('REASM')
self.logger.debug('OFPGetConfigReply received: '
'flags=%s miss_send_len=%d',
','.join(flags), msg.miss_send_len)

JSON Example:

{
"OFPGetConfigReply": {
"flags": 0,
"miss_send_len": 128
}
}

Flow Table Configuration

class ryu.ofproto.ofproto_v1_3_parser.OFPTableMod(datapath, table_id, config)

Flow table configuration message
The controller sends this message to configure table state.

Attribute Description
table_id ID of the table (OFPTT_ALL indicates all tables)
config Bitmap of the following flags. OFPTC_DEPRECATED_MASK (3)

Example:

216 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_table_mod(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableMod(datapath, 1, 3)
datapath.send_msg(req)

JSON Example:

{
"OFPTableMod": {
"config": 0,
"table_id": 255
}
}

Modify State Messages

class ryu.ofproto.ofproto_v1_3_parser.OFPFlowMod(datapath, cookie=0,

cookie_mask=0, table_id=0,
command=0, idle_timeout=0,
hard_timeout=0, priority=32768,
buffer_id=4294967295, out_port=0,
out_group=0, flags=0, match=None,
instructions=None)
Modify Flow entry message
The controller sends this message to modify the flow table.

2.5. OpenFlow protocol API Reference 217

ryu Documentation, Release 4.34

OFPFC_ADD
OFPFC_MODIFY
OFPFC_MODIFY_STRICT
OFPFC_DELETE
OFPFC_DELETE_STRICT

idle_timeout Idle time before discarding (seconds)

OFPFF_SEND_FLOW_REM
OFPFF_CHECK_OVERLAP
OFPFF_RESET_COUNTS
OFPFF_NO_PKT_COUNTS
OFPFF_NO_BYT_COUNTS

match Instance of OFPMatch

instructions list of OFPInstruction* instance

Example:

def send_flow_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

218 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

ofp.OFPP_ANY, ofp.OFPG_ANY,
ofp.OFPFF_SEND_FLOW_REM,
match, inst)
datapath.send_msg(req)

JSON Example:
{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 258
}
},
"len": 16,
"type": 25
}
},
{
"OFPActionCopyTtlOut": {
"len": 8,
"type": 11
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
},
{
"OFPActionPopPbb": {
"len": 8,
"type": 27
}
},
(continues on next page)

2.5. OpenFlow protocol API Reference 219

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPActionPushPbb": {
"ethertype": 4660,
"len": 8,
"type": 26
}
},
{
"OFPActionPopMpls": {
"ethertype": 39030,
"len": 8,
"type": 20
}
},
{
"OFPActionPushMpls": {
"ethertype": 34887,
"len": 8,
"type": 19
}
},
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionPushVlan": {
"ethertype": 33024,
"len": 8,
"type": 17
}
},
{
"OFPActionDecMplsTtl": {
"len": 8,
"type": 16
}
},
{
"OFPActionSetMplsTtl": {
"len": 8,
"mpls_ttl": 10,
"type": 15
}
},
{
"OFPActionDecNwTtl": {
"len": 8,
"type": 24
}
},
{
"OFPActionSetNwTtl": {
"len": 8,
"nw_ttl": 10,
(continues on next page)

220 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"type": 23
}
},
{
"OFPActionExperimenterUnknown": {
"data": "AAECAwQFBgc=",
"experimenter": 101,
"len": 16,
"type": 65535
}
},
{
"OFPActionSetQueue": {
"len": 8,
"queue_id": 3,
"type": 21
}
},
{
"OFPActionGroup": {
"group_id": 99,
"len": 8,
"type": 22
}
},
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 6,
"type": 0
}
}
],
"len": 176,
"type": 3
}
},
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "01:02:03:04:05:06"
}
},
"len": 16,
"type": 25
}
},
{
"OFPActionSetField": {
"field": {
(continues on next page)

2.5. OpenFlow protocol API Reference 221

ryu Documentation, Release 4.34

(continued from previous page)

"OXMTlv": {
"field": "pbb_uca",
"mask": null,
"value": 1
}
},
"len": 16,
"type": 25
}
}
],
"len": 40,
"type": 4
}
}
],
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 1
}
}

{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 1,
"type": 1
}
}
],
(continues on next page)

222 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"match": {
"OFPMatch": {
"length": 22,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 0
}
}

{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionMeter": {
"len": 8,
"meter_id": 1,
"type": 6
}
},
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 6,
"type": 0
}
(continues on next page)

2.5. OpenFlow protocol API Reference 223

ryu Documentation, Release 4.34

(continued from previous page)

}
],
"len": 24,
"type": 3
}
}
],
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 1
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGroupMod(datapath, command=0, type_=0,

group_id=0, buckets=None)
Modify group entry message
The controller sends this message to modify the group table.

Attribute Description
command One of the following values.

OFPGC_ADD
OFPGC_MODIFY
OFPGC_DELETE

type One of the following values.

OFPGT_ALL
OFPGT_SELECT
OFPGT_INDIRECT
OFPGT_FF

group_id Group identifier

buckets list of OFPBucket

type attribute corresponds to type_ parameter of init.

Example:

224 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_group_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

port = 1
max_len = 2000
actions = [ofp_parser.OFPActionOutput(port, max_len)]

weight = 100
watch_port = 0
watch_group = 0
buckets = [ofp_parser.OFPBucket(weight, watch_port, watch_group,
actions)]

group_id = 1
req = ofp_parser.OFPGroupMod(datapath, ofp.OFPGC_ADD,
ofp.OFPGT_SELECT, group_id, buckets)
datapath.send_msg(req)

JSON Example:

{
"OFPGroupMod": {
"buckets": [
{
"OFPBucket": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 2,
"type": 0
}
}
],
"len": 32,
"watch_group": 1,
"watch_port": 1,
"weight": 1
}
}
],
"command": 0,
"group_id": 1,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPPortMod(datapath, port_no=0,

hw_addr=’00:00:00:00:00:00’,
config=0, mask=0, advertise=0)
Port modification message
The controller sneds this message to modify the behavior of the port.

2.5. OpenFlow protocol API Reference 225

ryu Documentation, Release 4.34

Attribute Description
port_no Port number to modify
hw_addr The hardware address that must be the same as
hw_addr of OFPPort of OFPSwitchFeatures
config Bitmap of configuration flags.

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

mask Bitmap of configuration flags above to be changed

advertise Bitmap of the following flags.

Example:

def send_port_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:

226 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

{
"OFPPortMod": {
"advertise": 4096,
"config": 0,
"hw_addr": "00:11:00:00:11:11",
"mask": 0,
"port_no": 1
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPMeterMod(datapath, command=0, flags=1,

meter_id=1, bands=None)
Meter modification message
The controller sends this message to modify the meter.

Attribute Description
command One of the following values.

OFPMC_ADD
OFPMC_MODIFY
OFPMC_DELETE

flags Bitmap of the following flags.

OFPMF_KBPS
OFPMF_PKTPS
OFPMF_BURST
OFPMF_STATS

meter_id Meter instance

bands list of the following class instance.

OFPMeterBandDrop
OFPMeterBandDscpRemark
OFPMeterBandExperimenter

JSON Example:
{
"OFPMeterMod": {
"bands": [
{
"OFPMeterBandDrop": {
"burst_size": 10,
"len": 16,
"rate": 1000,
"type": 1
}
},
{
"OFPMeterBandDscpRemark": {
"burst_size": 10,
(continues on next page)

2.5. OpenFlow protocol API Reference 227

ryu Documentation, Release 4.34

(continued from previous page)

"len": 16,
"prec_level": 1,
"rate": 1000,
"type": 2
}
},
{
"OFPMeterBandExperimenter": {
"burst_size": 10,
"experimenter": 999,
"len": 16,
"rate": 1000,
"type": 65535
}
}
],
"command": 0,
"flags": 14,
"meter_id": 100
}
}

Multipart Messages

class ryu.ofproto.ofproto_v1_3_parser.OFPDescStatsRequest(datapath, flags=0,

type_=None)
Description statistics request message
The controller uses this message to query description of the switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPDescStatsRequest": {
"flags": 0,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPDescStatsReply(datapath, type_=None,

**kwargs)
Description statistics reply message
The switch responds with this message to a description statistics request.

228 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
body Instance of OFPDescStats

Example:

@set_ev_cls(ofp_event.EventOFPDescStatsReply, MAIN_DISPATCHER)
def desc_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('DescStats: mfr_desc=%s hw_desc=%s sw_desc=%s '

'serial_num=%s dp_desc=%s',
body.mfr_desc, body.hw_desc, body.sw_desc,
body.serial_num, body.dp_desc)

JSON Example:

{
"OFPDescStatsReply": {
"body": {
"OFPDescStats": {
"dp_desc": "dp",
"hw_desc": "hw",
"mfr_desc": "mfr",
"serial_num": "serial",
"sw_desc": "sw"
}
},
"flags": 0,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPFlowStatsRequest(datapath, flags=0,

table_id=255,
out_port=4294967295,
out_group=4294967295,
cookie=0,
cookie_mask=0,
match=None,
type_=None)
Individual flow statistics request message
The controller uses this message to query individual flow statistics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
table_id ID of table to read
out_port Require matching entries to include this as an output port
out_group Require matching entries to include this as an output group
cookie Require matching entries to contain this cookie value
cookie_mask Mask used to restrict the cookie bits that must match
match Instance of OFPMatch

Example:

2.5. OpenFlow protocol API Reference 229

ryu Documentation, Release 4.34

def send_flow_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

cookie = cookie_mask = 0
match = ofp_parser.OFPMatch(in_port=1)
req = ofp_parser.OFPFlowStatsRequest(datapath, 0,
ofp.OFPTT_ALL,
ofp.OFPP_ANY, ofp.OFPG_ANY,
cookie, cookie_mask,
match)
datapath.send_msg(req)

JSON Example:
{
"OFPFlowStatsRequest": {
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"table_id": 0,
"type": 1
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPFlowStatsReply(datapath, type_=None,

**kwargs)
Individual flow statistics reply message
The switch responds with this message to an individual flow statistics request.

Attribute Description
body List of OFPFlowStats instance

Example:
@set_ev_cls(ofp_event.EventOFPFlowStatsReply, MAIN_DISPATCHER)
def flow_stats_reply_handler(self, ev):
flows = []
for stat in ev.msg.body:
flows.append('table_id=%s '
'duration_sec=%d duration_nsec=%d '
'priority=%d '
'idle_timeout=%d hard_timeout=%d flags=0x%04x '
'cookie=%d packet_count=%d byte_count=%d '
'match=%s instructions=%s' %
(stat.table_id,
stat.duration_sec, stat.duration_nsec,
(continues on next page)

230 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

stat.priority,
stat.idle_timeout, stat.hard_timeout, stat.flags,
stat.cookie, stat.packet_count, stat.byte_count,
stat.match, stat.instructions))
self.logger.debug('FlowStats: %s', flows)

JSON Example:
{
"OFPFlowStatsReply": {
"body": [
{
"OFPFlowStats": {
"byte_count": 0,
"cookie": 0,
"duration_nsec": 115277000,
"duration_sec": 358,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [],
"length": 56,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"packet_count": 0,
"priority": 65535,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 0,
"cookie": 0,
"duration_nsec": 115055000,
"duration_sec": 358,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 0,
"port": 4294967290,
"type": 0
}
}
],
"len": 24,
(continues on next page)

2.5. OpenFlow protocol API Reference 231

ryu Documentation, Release 4.34

(continued from previous page)

"type": 4
}
}
],
"length": 88,
"match": {
"OFPMatch": {
"length": 10,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
}
],
"type": 1
}
},
"packet_count": 0,
"priority": 65534,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 238,
"cookie": 0,
"duration_nsec": 511582000,
"duration_sec": 316220,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 1,
"type": 1
}
}
],
"length": 80,
"match": {
"OFPMatch": {
"length": 22,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
(continues on next page)

232 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"packet_count": 3,
"priority": 123,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 98,
"cookie": 0,
"duration_nsec": 980901000,
"duration_sec": 313499,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 258
}
},
"len": 16,
"type": 25
}
},
{
"OFPActionCopyTtlOut": {
"len": 8,
"type": 11
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
(continues on next page)

2.5. OpenFlow protocol API Reference 233

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OFPActionPopPbb": {
"len": 8,
"type": 27
}
},
{
"OFPActionPushPbb": {
"ethertype": 4660,
"len": 8,
"type": 26
}
},
{
"OFPActionPopMpls": {
"ethertype": 39030,
"len": 8,
"type": 20
}
},
{
"OFPActionPushMpls": {
"ethertype": 34887,
"len": 8,
"type": 19
}
},
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionPushVlan": {
"ethertype": 33024,
"len": 8,
"type": 17
}
},
{
"OFPActionDecMplsTtl": {
"len": 8,
"type": 16
}
},
{
"OFPActionSetMplsTtl": {
"len": 8,
"mpls_ttl": 10,
"type": 15
}
},
{
"OFPActionDecNwTtl": {
"len": 8,
(continues on next page)

234 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"type": 24
}
},
{
"OFPActionSetNwTtl": {
"len": 8,
"nw_ttl": 10,
"type": 23
}
},
{
"OFPActionSetQueue": {
"len": 8,
"queue_id": 3,
"type": 21
}
},
{
"OFPActionGroup": {
"group_id": 99,
"len": 8,
"type": 22
}
},
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 6,
"type": 0
}
},
{
"OFPActionExperimenterUnknown": {
"len": 16,
"data": "ZXhwX2RhdGE=",
"experimenter": 98765432,
"type": 65535
}
},
{
"NXActionUnknown": {
"len": 16,
"data": "cF9kYXRh",
"experimenter": 8992,
"type": 65535,
"subtype": 25976
}
}
],
"len": 192,
"type": 3
}
},
{
"OFPInstructionActions": {
"actions": [
(continues on next page)

2.5. OpenFlow protocol API Reference 235

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "01:02:03:04:05:06"
}
},
"len": 16,
"type": 25
}
},
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "pbb_uca",
"mask": null,
"value": 1
}
},
"len": 16,
"type": 25
}
}
],
"len": 40,
"type": 4
}
},
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 4294967293,
"type": 0
}
}
],
"len": 24,
"type": 3
}
}
],
"length": 312,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"packet_count": 1,
(continues on next page)

236 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"priority": 0,
"table_id": 0
}
}
],
"flags": 0,
"type": 1
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPAggregateStatsRequest(datapath,
flags, table_id,
out_port,
out_group,
cookie,
cookie_mask,
match,
type_=None)
Aggregate flow statistics request message
The controller uses this message to query aggregate flow statictics.

Example:
def send_aggregate_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:
{
"OFPAggregateStatsRequest": {
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"match": {
(continues on next page)

2.5. OpenFlow protocol API Reference 237

ryu Documentation, Release 4.34

(continued from previous page)

"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"table_id": 255,
"type": 2
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPAggregateStatsReply(datapath,
type_=None,
**kwargs)
Aggregate flow statistics reply message
The switch responds with this message to an aggregate flow statistics request.

Attribute Description
body Instance of OFPAggregateStats

Example:

@set_ev_cls(ofp_event.EventOFPAggregateStatsReply, MAIN_DISPATCHER)
def aggregate_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('AggregateStats: packet_count=%d byte_count=%d '

'flow_count=%d',
body.packet_count, body.byte_count,
body.flow_count)

JSON Example:

{
"OFPAggregateStatsReply": {
"body": {
"OFPAggregateStats": {
"byte_count": 574,
"flow_count": 6,
"packet_count": 7
}
},
"flags": 0,
"type": 2
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPTableStatsRequest(datapath, flags=0,

type_=None)
Table statistics request message
The controller uses this message to query flow table statictics.

238 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:
def send_table_stats_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:
{
"OFPTableStatsRequest": {
"flags": 0,
"type": 3
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPTableStatsReply(datapath, type_=None,

**kwargs)
Table statistics reply message
The switch responds with this message to a table statistics request.

Attribute Description
body List of OFPTableStats instance

Example:
@set_ev_cls(ofp_event.EventOFPTableStatsReply, MAIN_DISPATCHER)
def table_stats_reply_handler(self, ev):
tables = []
for stat in ev.msg.body:
tables.append('table_id=%d active_count=%d lookup_count=%d '
' matched_count=%d' %
(stat.table_id, stat.active_count,
stat.lookup_count, stat.matched_count))
self.logger.debug('TableStats: %s', tables)

JSON Example:
{
"OFPTableStatsReply": {
"body": [
{
"OFPTableStats": {
"active_count": 4,
"lookup_count": 4,
"matched_count": 4,
"table_id": 0
}
},
{
"OFPTableStats": {
(continues on next page)

2.5. OpenFlow protocol API Reference 239

ryu Documentation, Release 4.34

(continued from previous page)

"active_count": 4,
"lookup_count": 4,
"matched_count": 4,
"table_id": 1
}
}
],
"flags": 0,
"type": 3
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPPortStatsRequest(datapath, flags=0,

port_no=4294967295,
type_=None)
Port statistics request message
The controller uses this message to query information about ports statistics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read (OFPP_ANY to all ports)

Example:
def send_port_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortStatsRequest(datapath, 0, ofp.OFPP_ANY)

datapath.send_msg(req)

JSON Example:
{
"OFPPortStatsRequest": {
"flags": 0,
"port_no": 4294967295,
"type": 4
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPPortStatsReply(datapath, type_=None,

**kwargs)
Port statistics reply message
The switch responds with this message to a port statistics request.

Attribute Description
body List of OFPPortStats instance

Example:
@set_ev_cls(ofp_event.EventOFPPortStatsReply, MAIN_DISPATCHER)
def port_stats_reply_handler(self, ev):
(continues on next page)

240 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

ports = []
for stat in ev.msg.body:
ports.append('port_no=%d '
'rx_packets=%d tx_packets=%d '
'rx_bytes=%d tx_bytes=%d '
'rx_dropped=%d tx_dropped=%d '
'rx_errors=%d tx_errors=%d '
'rx_frame_err=%d rx_over_err=%d rx_crc_err=%d '
'collisions=%d duration_sec=%d duration_nsec=%d' %
(stat.port_no,
stat.rx_packets, stat.tx_packets,
stat.rx_bytes, stat.tx_bytes,
stat.rx_dropped, stat.tx_dropped,
stat.rx_errors, stat.tx_errors,
stat.rx_frame_err, stat.rx_over_err,
stat.rx_crc_err, stat.collisions,
stat.duration_sec, stat.duration_nsec))
self.logger.debug('PortStats: %s', ports)

JSON Example:
{
"OFPPortStatsReply": {
"body": [
{
"OFPPortStats": {
"collisions": 0,
"duration_nsec": 0,
"duration_sec": 0,
"port_no": 7,
"rx_bytes": 0,
"rx_crc_err": 0,
"rx_dropped": 0,
"rx_errors": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"rx_packets": 0,
"tx_bytes": 336,
"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
},
{
"OFPPortStats": {
"collisions": 0,
"duration_nsec": 0,
"duration_sec": 0,
"port_no": 6,
"rx_bytes": 336,
"rx_crc_err": 0,
"rx_dropped": 0,
"rx_errors": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"rx_packets": 4,
"tx_bytes": 336,
(continues on next page)

2.5. OpenFlow protocol API Reference 241

ryu Documentation, Release 4.34

(continued from previous page)

"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
}
],
"flags": 0,
"type": 4
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPPortDescStatsRequest(datapath,
flags=0,
type_=None)
Port description request message
The controller uses this message to query description of all the ports.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_port_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPPortDescStatsRequest": {
"flags": 0,
"type": 13
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPPortDescStatsReply(datapath,
type_=None,
**kwargs)
Port description reply message
The switch responds with this message to a port description request.

Attribute Description
body List of OFPPort instance

Example:

242 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

'state=0x%08x curr=0x%08x advertised=0x%08x '
'supported=0x%08x peer=0x%08x curr_speed=%d '
'max_speed=%d' %
(p.port_no, p.hw_addr,
p.name, p.config,
p.state, p.curr, p.advertised,
p.supported, p.peer, p.curr_speed,
p.max_speed))
self.logger.debug('OFPPortDescStatsReply received: %s', ports)

JSON Example:

{
"OFPPortDescStatsReply": {
"body": [
{
"OFPPort": {
"advertised": 10240,
"config": 0,
"curr": 10248,
"curr_speed": 5000,
"hw_addr": "f2:0b:a4:d0:3f:70",
"max_speed": 5000,
"name": "Port7",
"peer": 10248,
"port_no": 7,
"state": 4,
"supported": 10248
}
},
{
"OFPPort": {
"advertised": 10240,
"config": 0,
"curr": 10248,
"curr_speed": 5000,
"hw_addr": "f2:0b:a4:7d:f8:ea",
"max_speed": 5000,
"name": "Port6",
"peer": 10248,
"port_no": 6,
"state": 4,
"supported": 10248
}
}
],
"flags": 0,
"type": 13
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPQueueStatsRequest(datapath, flags=0,

port_no=4294967295,
queue_id=4294967295,
type_=None)
Queue statistics request message

2.5. OpenFlow protocol API Reference 243

ryu Documentation, Release 4.34

The controller uses this message to query queue statictics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read
queue_id ID of queue to read

Example:
def send_queue_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueStatsRequest(datapath, 0, ofp.OFPP_ANY,

ofp.OFPQ_ALL)
datapath.send_msg(req)

JSON Example:
{
"OFPQueueStatsRequest": {
"flags": 0,
"port_no": 4294967295,
"queue_id": 4294967295,
"type": 5
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPQueueStatsReply(datapath, type_=None,

**kwargs)
Queue statistics reply message
The switch responds with this message to an aggregate flow statistics request.

Attribute Description
body List of OFPQueueStats instance

Example:
@set_ev_cls(ofp_event.EventOFPQueueStatsReply, MAIN_DISPATCHER)
def queue_stats_reply_handler(self, ev):
queues = []
for stat in ev.msg.body:
queues.append('port_no=%d queue_id=%d '
'tx_bytes=%d tx_packets=%d tx_errors=%d '
'duration_sec=%d duration_nsec=%d' %
(stat.port_no, stat.queue_id,
stat.tx_bytes, stat.tx_packets, stat.tx_errors,
stat.duration_sec, stat.duration_nsec))
self.logger.debug('QueueStats: %s', queues)

JSON Example:
{
"OFPQueueStatsReply": {
"body": [
(continues on next page)

244 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"port_no": 7,
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
},
{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"port_no": 6,
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
},
{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"port_no": 7,
"queue_id": 2,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
}
],
"flags": 0,
"type": 5
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGroupStatsRequest(datapath, flags=0,

group_id=4294967292,
type_=None)
Group statistics request message
The controller uses this message to query statistics of one or more groups.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
group_id ID of group to read (OFPG_ALL to all groups)

Example:
def send_group_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

(continues on next page)

2.5. OpenFlow protocol API Reference 245

ryu Documentation, Release 4.34

(continued from previous page)

req = ofp_parser.OFPGroupStatsRequest(datapath, 0, ofp.OFPG_ALL)
datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_3_parser.OFPGroupStatsReply(datapath, type_=None,

**kwargs)
Group statistics reply message
The switch responds with this message to a group statistics request.

Attribute Description
body List of OFPGroupStats instance

Example:

@set_ev_cls(ofp_event.EventOFPGroupStatsReply, MAIN_DISPATCHER)
def group_stats_reply_handler(self, ev):
groups = []
for stat in ev.msg.body:
groups.append('length=%d group_id=%d '
'ref_count=%d packet_count=%d byte_count=%d '
'duration_sec=%d duration_nsec=%d' %
(stat.length, stat.group_id,
stat.ref_count, stat.packet_count,
stat.byte_count, stat.duration_sec,
stat.duration_nsec))
self.logger.debug('GroupStats: %s', groups)

class ryu.ofproto.ofproto_v1_3_parser.OFPGroupDescStatsRequest(datapath,
flags=0,
type_=None)
Group description request message
The controller uses this message to list the set of groups on a switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_group_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPGroupDescStatsRequest": {
"flags": 0,
"type": 7
}
}

246 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_3_parser.OFPGroupDescStatsReply(datapath,
type_=None,
**kwargs)
Group description reply message
The switch responds with this message to a group description request.

Attribute Description
body List of OFPGroupDescStats instance

Example:

@set_ev_cls(ofp_event.EventOFPGroupDescStatsReply, MAIN_DISPATCHER)
def group_desc_stats_reply_handler(self, ev):
descs = []
for stat in ev.msg.body:
descs.append('length=%d type=%d group_id=%d '
'buckets=%s' %
(stat.length, stat.type, stat.group_id,
stat.bucket))
self.logger.debug('GroupDescStats: %s', descs)

JSON Example:

{
"OFPGroupDescStatsReply": {
"body": [
{
"OFPGroupDescStats": {
"buckets": [
{
"OFPBucket": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 2,
"type": 0
}
}
],
"len": 32,
"watch_group": 1,
"watch_port": 1,
"weight": 1
}
}
],
"group_id": 1,
"length": 40,
"type": 0
}
}
],
"flags": 0,
"type": 7
(continues on next page)

2.5. OpenFlow protocol API Reference 247

ryu Documentation, Release 4.34

(continued from previous page)

}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGroupFeaturesStatsRequest(datapath,
flags=0,
type_=None)
Group features request message
The controller uses this message to list the capabilities of groups on a switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_group_features_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupFeaturesStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPGroupFeaturesStatsRequest": {
"flags": 0,
"type": 8
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGroupFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Group features reply message
The switch responds with this message to a group features request.

Attribute Description
body Instance of OFPGroupFeaturesStats

Example:

@set_ev_cls(ofp_event.EventOFPGroupFeaturesStatsReply, MAIN_DISPATCHER)
def group_features_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('GroupFeaturesStats: types=%d '

'capabilities=0x%08x max_groups=%s '
'actions=%s',
body.types, body.capabilities,
body.max_groups, body.actions)

JSON Example:

248 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

{
"OFPGroupFeaturesStatsReply": {
"body": {
"OFPGroupFeaturesStats": {
"actions": [
67082241,
67082241,
67082241,
67082241
],
"capabilities": 5,
"max_groups": [
16777216,
16777216,
16777216,
16777216
],
"types": 15
}
},
"flags": 0,
"type": 8
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPMeterStatsRequest(datapath, flags=0, me-

ter_id=4294967295,
type_=None)
Meter statistics request message
The controller uses this message to query statistics for one or more meters.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
meter_id ID of meter to read (OFPM_ALL to all meters)

Example:

def send_meter_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterStatsRequest(datapath, 0, ofp.OFPM_ALL)

datapath.send_msg(req)

JSON Example:

{
"OFPMeterStatsRequest": {
"flags": 0,
"meter_id": 4294967295,
"type": 9
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPMeterStatsReply(datapath, type_=None,

**kwargs)

2.5. OpenFlow protocol API Reference 249

ryu Documentation, Release 4.34

Meter statistics reply message

The switch responds with this message to a meter statistics request.

Attribute Description
body List of OFPMeterStats instance

Example:

@set_ev_cls(ofp_event.EventOFPMeterStatsReply, MAIN_DISPATCHER)
def meter_stats_reply_handler(self, ev):
meters = []
for stat in ev.msg.body:
meters.append('meter_id=0x%08x len=%d flow_count=%d '
'packet_in_count=%d byte_in_count=%d '
'duration_sec=%d duration_nsec=%d '
'band_stats=%s' %
(stat.meter_id, stat.len, stat.flow_count,
stat.packet_in_count, stat.byte_in_count,
stat.duration_sec, stat.duration_nsec,
stat.band_stats))
self.logger.debug('MeterStats: %s', meters)

JSON Example:

{
"OFPMeterStatsReply": {
"body": [
{
"OFPMeterStats": {
"band_stats": [
{
"OFPMeterBandStats": {
"byte_band_count": 0,
"packet_band_count": 0
}
}
],
"byte_in_count": 0,
"duration_nsec": 480000,
"duration_sec": 0,
"flow_count": 0,
"len": 56,
"meter_id": 100,
"packet_in_count": 0
}
}
],
"flags": 0,
"type": 9
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPMeterConfigStatsRequest(datapath,
flags=0, me-
ter_id=4294967295,
type_=None)
Meter configuration statistics request message

250 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

The controller uses this message to query configuration for one or more meters.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
meter_id ID of meter to read (OFPM_ALL to all meters)

Example:

def send_meter_config_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterConfigStatsRequest(datapath, 0,
ofp.OFPM_ALL)
datapath.send_msg(req)

JSON Example:

{
"OFPMeterConfigStatsRequest": {
"flags": 0,
"meter_id": 4294967295,
"type": 10
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPMeterConfigStatsReply(datapath,
type_=None,
**kwargs)
Meter configuration statistics reply message
The switch responds with this message to a meter configuration statistics request.

Attribute Description
body List of OFPMeterConfigStats instance

Example:

@set_ev_cls(ofp_event.EventOFPMeterConfigStatsReply, MAIN_DISPATCHER)
def meter_config_stats_reply_handler(self, ev):
configs = []
for stat in ev.msg.body:
configs.append('length=%d flags=0x%04x meter_id=0x%08x '
'bands=%s' %
(stat.length, stat.flags, stat.meter_id,
stat.bands))
self.logger.debug('MeterConfigStats: %s', configs)

JSON Example:

{
"OFPMeterConfigStatsReply": {
"body": [
{
"OFPMeterConfigStats": {
"bands": [
(continues on next page)

2.5. OpenFlow protocol API Reference 251

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPMeterBandDrop": {
"burst_size": 10,
"len": 16,
"rate": 1000,
"type": 1
}
}
],
"flags": 14,
"length": 24,
"meter_id": 100
}
}
],
"flags": 0,
"type": 10
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPMeterFeaturesStatsRequest(datapath,
flags=0,
type_=None)
Meter features statistics request message
The controller uses this message to query the set of features of the metering subsystem.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_meter_features_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterFeaturesStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPMeterFeaturesStatsRequest": {
"flags": 0,
"type": 11
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPMeterFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Meter features statistics reply message
The switch responds with this message to a meter features statistics request.

Attribute Description
body List of OFPMeterFeaturesStats instance

252 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Example:

@set_ev_cls(ofp_event.EventOFPMeterFeaturesStatsReply, MAIN_DISPATCHER)
def meter_features_stats_reply_handler(self, ev):
features = []
for stat in ev.msg.body:
features.append('max_meter=%d band_types=0x%08x '
'capabilities=0x%08x max_bands=%d '
'max_color=%d' %
(stat.max_meter, stat.band_types,
stat.capabilities, stat.max_bands,
stat.max_color))
self.logger.debug('MeterFeaturesStats: %s', features)

JSON Example:

{
"OFPMeterFeaturesStatsReply": {
"body": [
{
"OFPMeterFeaturesStats": {
"band_types": 2147483654,
"capabilities": 15,
"max_bands": 255,
"max_color": 0,
"max_meter": 16777216
}
}
],
"flags": 0,
"type": 11
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPTableFeaturesStatsRequest(datapath,
flags=0,
body=None,
type_=None)
Table features statistics request message
The controller uses this message to query table features.

Attribute Description
body List of OFPTableFeaturesStats instances. The default is [].

class ryu.ofproto.ofproto_v1_3_parser.OFPTableFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Table features statistics reply message
The switch responds with this message to a table features statistics request.

Attribute Description
body List of OFPTableFeaturesStats instance

JSON Example:

2.5. OpenFlow protocol API Reference 253

ryu Documentation, Release 4.34

See an example in:

ryu/tests/unit/ofproto/json/of13/4-56-ofp_table_features_reply.
packet.json

Queue Configuration Messages

class ryu.ofproto.ofproto_v1_3_parser.OFPQueueGetConfigRequest(datapath, port)

Queue configuration request message

Attribute Description
port Port to be queried (OFPP_ANY to all configured queues)

Example:

def send_queue_get_config_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueGetConfigRequest(datapath, ofp.OFPP_ANY)

datapath.send_msg(req)

JSON Example:

{
"OFPQueueGetConfigRequest": {
"port": 4294967295
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPQueueGetConfigReply(datapath,
queues=None,
port=None)
Queue configuration reply message
The switch responds with this message to a queue configuration request.

Attribute Description
queues list of OFPPacketQueue instance
port Port which was queried

Example:

@set_ev_cls(ofp_event.EventOFPQueueGetConfigReply, MAIN_DISPATCHER)
def queue_get_config_reply_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPQueueGetConfigReply received: '

'port=%s queues=%s',
msg.port, msg.queues)

JSON Example:

254 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

{
"OFPQueueGetConfigReply": {
"port": 4294967295,
"queues": [
{
"OFPPacketQueue": {
"len": 64,
"port": 77,
"properties": [
{
"OFPQueuePropMinRate": {
"len": 16,
"property": 1,
"rate": 10
}
},
{
"OFPQueuePropMaxRate": {
"len": 16,
"property": 2,
"rate": 900
}
},
{
"OFPQueuePropExperimenter": {
"data": [],
"experimenter": 999,
"len": 16,
"property": 65535
}
}
],
"queue_id": 99
}
},
{
"OFPPacketQueue": {
"len": 65,
"port": 77,
"properties": [
{
"OFPQueuePropMinRate": {
"len": 16,
"property": 1,
"rate": 100
}
},
{
"OFPQueuePropMaxRate": {
"len": 16,
"property": 2,
"rate": 200
}
},
{
"OFPQueuePropExperimenter": {
"experimenter": 999,
(continues on next page)

2.5. OpenFlow protocol API Reference 255

ryu Documentation, Release 4.34

(continued from previous page)

"data": [
1
],
"len": 17,
"property": 65535
}
}
],
"queue_id": 88
}
},
{
"OFPPacketQueue": {
"len": 66,
"port": 77,
"properties": [
{
"OFPQueuePropMinRate": {
"len": 16,
"property": 1,
"rate": 200
}
},
{
"OFPQueuePropMaxRate": {
"len": 16,
"property": 2,
"rate": 400
}
},
{
"OFPQueuePropExperimenter": {
"experimenter": 999,
"data": [
1,
2
],
"len": 18,
"property": 65535
}
}
],
"queue_id": 77
}
}
]
}
}

Packet-Out Message

class ryu.ofproto.ofproto_v1_3_parser.OFPPacketOut(datapath, buffer_id=None,

in_port=None, actions=None,
data=None, actions_len=None)
Packet-Out message

256 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

The controller uses this message to send a packet out throught the switch.

Example:

def send_packet_out(self, datapath, buffer_id, in_port):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

actions = [ofp_parser.OFPActionOutput(ofp.OFPP_FLOOD, 0)]

req = ofp_parser.OFPPacketOut(datapath, buffer_id,
in_port, actions)
datapath.send_msg(req)

JSON Example:

˓→",

"in_port": 4294967293
}
}

Barrier Message

class ryu.ofproto.ofproto_v1_3_parser.OFPBarrierRequest(datapath)
Barrier request message
The controller sends this message to ensure message dependencies have been met or receive notifications for
completed operations.
Example:

def send_barrier_request(self, datapath):

ofp_parser = datapath.ofproto_parser

(continues on next page)

2.5. OpenFlow protocol API Reference 257

ryu Documentation, Release 4.34

(continued from previous page)

req = ofp_parser.OFPBarrierRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPBarrierRequest": {}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPBarrierReply(datapath)
Barrier reply message
The switch responds with this message to a barrier request.
Example:

@set_ev_cls(ofp_event.EventOFPBarrierReply, MAIN_DISPATCHER)
def barrier_reply_handler(self, ev):
self.logger.debug('OFPBarrierReply received')

JSON Example:

{
"OFPBarrierReply": {}
}

Role Request Message

class ryu.ofproto.ofproto_v1_3_parser.OFPRoleRequest(datapath, role=None, genera-

tion_id=None)
Role request message
The controller uses this message to change its role.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

generation_id Master Election Generation ID

Example:

def send_role_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPRoleRequest(datapath, ofp.OFPCR_ROLE_EQUAL, 0)

datapath.send_msg(req)

JSON Example:

258 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

{
"OFPRoleRequest": {
"generation_id": 17294086455919964160,
"role": 2
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPRoleReply(datapath, role=None, genera-

tion_id=None)
Role reply message
The switch responds with this message to a role request.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

generation_id Master Election Generation ID

Example:

@set_ev_cls(ofp_event.EventOFPRoleReply, MAIN_DISPATCHER)
def role_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

self.logger.debug('OFPRoleReply received: '

'role=%s generation_id=%d',
role, msg.generation_id)

JSON Example:

{
"OFPRoleReply": {
"generation_id": 17294086455919964160,
"role": 3
}
}

2.5. OpenFlow protocol API Reference 259

ryu Documentation, Release 4.34

Set Asynchronous Configuration Message

class ryu.ofproto.ofproto_v1_3_parser.OFPSetAsync(datapath, packet_in_mask,

port_status_mask,
flow_removed_mask)
Set asynchronous configuration message
The controller sends this message to set the asynchronous messages that it wants to receive on a given OpneFlow
channel.

Attribute Description
packet_in_mask 2-element array: element 0, when the con-
troller has a OFPCR_ROLE_EQUAL or OF-
PCR_ROLE_MASTER role. element 1, OF-
PCR_ROLE_SLAVE role controller. Bitmasks of
following values.

OFPR_NO_MATCH
OFPR_ACTION
OFPR_INVALID_TTL

port_status_mask 2-element array. Bitmasks of following values.

OFPPR_ADD
OFPPR_DELETE
OFPPR_MODIFY

flow_removed_mask 2-element array. Bitmasks of following values.

OFPRR_IDLE_TIMEOUT
OFPRR_HARD_TIMEOUT
OFPRR_DELETE
OFPRR_GROUP_DELETE

Example:

def send_set_async(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

packet_in_mask = 1 << ofp.OFPR_ACTION | 1 << ofp.OFPR_INVALID_TTL

port_status_mask = (1 << ofp.OFPPR_ADD
| 1 << ofp.OFPPR_DELETE
| 1 << ofp.OFPPR_MODIFY)
flow_removed_mask = (1 << ofp.OFPRR_IDLE_TIMEOUT
| 1 << ofp.OFPRR_HARD_TIMEOUT
| 1 << ofp.OFPRR_DELETE)
req = ofp_parser.OFPSetAsync(datapath,
[packet_in_mask, 0],
[port_status_mask, 0],
[flow_removed_mask, 0])
datapath.send_msg(req)

260 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

JSON Example:

{
"OFPSetAsync": {
"flow_removed_mask": [
15,
3
],
"packet_in_mask": [
5,
1
],
"port_status_mask": [
7,
3
]
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGetAsyncRequest(datapath)
Get asynchronous configuration request message
The controller uses this message to query the asynchronous message.
Example:

def send_get_async_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetAsyncRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPGetAsyncRequest": {}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPGetAsyncReply(datapath,
packet_in_mask=None,
port_status_mask=None,
flow_removed_mask=None)
Get asynchronous configuration reply message
The switch responds with this message to a get asynchronous configuration request.

2.5. OpenFlow protocol API Reference 261

ryu Documentation, Release 4.34

OFPR_NO_MATCH
OFPR_ACTION
OFPR_INVALID_TTL

port_status_mask 2-element array. Bitmasks of following values.

OFPPR_ADD
OFPPR_DELETE
OFPPR_MODIFY

flow_removed_mask 2-element array. Bitmasks of following values.

OFPRR_IDLE_TIMEOUT
OFPRR_HARD_TIMEOUT
OFPRR_DELETE
OFPRR_GROUP_DELETE

Example:

@set_ev_cls(ofp_event.EventOFPGetAsyncReply, MAIN_DISPATCHER)
def get_async_reply_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPGetAsyncReply received: '

'packet_in_mask=0x%08x:0x%08x '
'port_status_mask=0x%08x:0x%08x '
'flow_removed_mask=0x%08x:0x%08x',
msg.packet_in_mask[0],
msg.packet_in_mask[1],
msg.port_status_mask[0],
msg.port_status_mask[1],
msg.flow_removed_mask[0],
msg.flow_removed_mask[1])

JSON Example:

{
"OFPGetAsyncReply": {
"flow_removed_mask": [
15,
3
],
"packet_in_mask": [
5,
1
(continues on next page)

262 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

],
"port_status_mask": [
7,
3
]
}
}

Asynchronous Messages

Packet-In Message

class ryu.ofproto.ofproto_v1_3_parser.OFPPacketIn(datapath, buffer_id=None, to-

tal_len=None, reason=None,
table_id=None, cookie=None,
match=None, data=None)
Packet-In message
The switch sends the packet that received to the controller by this message.

Attribute Description
buffer_id ID assigned by datapath
total_len Full length of frame
reason Reason packet is being sent.

OFPR_NO_MATCH
OFPR_ACTION
OFPR_INVALID_TTL

table_id ID of the table that was looked up

cookie Cookie of the flow entry that was looked up
match Instance of OFPMatch
data Ethernet frame

Example:

@set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
def packet_in_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPR_NO_MATCH:
reason = 'NO MATCH'
elif msg.reason == ofp.OFPR_ACTION:
reason = 'ACTION'
elif msg.reason == ofp.OFPR_INVALID_TTL:
reason = 'INVALID TTL'
else:
reason = 'unknown'

self.logger.debug('OFPPacketIn received: '

(continues on next page)

2.5. OpenFlow protocol API Reference 263

ryu Documentation, Release 4.34

(continued from previous page)

'buffer_id=%x total_len=%d reason=%s '
'table_id=%d cookie=%d match=%s data=%s',
msg.buffer_id, msg.total_len, reason,
msg.table_id, msg.cookie, msg.match,
utils.hex_array(msg.data))

JSON Example:
{
"OFPPacketIn": {
"buffer_id": 2,
"cookie": 283686884868096,
"data": "////////8gukffjqCAYAAQgABgQAAfILpH346goAAAEAAAAAAAAKAAAD",
"match": {
"OFPMatch": {
"length": 80,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
},
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "ff:ff:ff:ff:ff:ff"
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "arp_op",
"mask": null,
"value": 1
}
},
{
"OXMTlv": {
"field": "arp_spa",
"mask": null,
"value": "10.0.0.1"
(continues on next page)

264 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OXMTlv": {
"field": "arp_tpa",
"mask": null,
"value": "10.0.0.3"
}
},
{
"OXMTlv": {
"field": "arp_sha",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "arp_tha",
"mask": null,
"value": "00:00:00:00:00:00"
}
}
],
"type": 1
}
},
"reason": 1,
"table_id": 1,
"total_len": 42
}
}

Flow Removed Message

class ryu.ofproto.ofproto_v1_3_parser.OFPFlowRemoved(datapath, cookie=None,

2.5. OpenFlow protocol API Reference 265

ryu Documentation, Release 4.34

Attribute Description
cookie Opaque controller-issued identifier
priority Priority level of flow entry
reason One of the following values.

OFPRR_IDLE_TIMEOUT
OFPRR_HARD_TIMEOUT
OFPRR_DELETE
OFPRR_GROUP_DELETE

table_id ID of the table

Example:

@set_ev_cls(ofp_event.EventOFPFlowRemoved, MAIN_DISPATCHER)
def flow_removed_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

self.logger.debug('OFPFlowRemoved received: '

JSON Example:

{
"OFPFlowRemoved": {
"byte_count": 86,
(continues on next page)

266 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

Port Status Message

class ryu.ofproto.ofproto_v1_3_parser.OFPPortStatus(datapath, reason=None,

desc=None)
Port status message
The switch notifies controller of change of ports.

Attribute Description
reason One of the following values.

OFPPR_ADD
OFPPR_DELETE
OFPPR_MODIFY

desc instance of OFPPort

Example:

@set_ev_cls(ofp_event.EventOFPPortStatus, MAIN_DISPATCHER)
def port_status_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPPR_ADD:
(continues on next page)

2.5. OpenFlow protocol API Reference 267

ryu Documentation, Release 4.34

(continued from previous page)

reason = 'ADD'
elif msg.reason == ofp.OFPPR_DELETE:
reason = 'DELETE'
elif msg.reason == ofp.OFPPR_MODIFY:
reason = 'MODIFY'
else:
reason = 'unknown'

self.logger.debug('OFPPortStatus received: reason=%s desc=%s',

reason, msg.desc)

JSON Example:

Error Message

class ryu.ofproto.ofproto_v1_3_parser.OFPErrorMsg(datapath, type_=None, code=None,

data=None, **kwargs)
Error message
The switch notifies controller of problems by this message.

Attribute Description
type High level type of error
code Details depending on the type
data Variable length data depending on the type and code

type attribute corresponds to type_ parameter of init.

Types and codes are defined in ryu.ofproto.ofproto.

268 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

If type == OFPET_EXPERIMENTER, this message has also the following attributes.

Attribute Description
exp_type Experimenter defined type
experimenter Experimenter ID

Example:

@set_ev_cls(ofp_event.EventOFPErrorMsg,
[HANDSHAKE_DISPATCHER, CONFIG_DISPATCHER, MAIN_DISPATCHER])
def error_msg_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPErrorMsg received: type=0x%02x code=0x%02x '

'message=%s',
msg.type, msg.code, utils.hex_array(msg.data))

JSON Example:

{
"OFPErrorMsg": {
"code": 11,
"data": "ZnVnYWZ1Z2E=",
"type": 2
}
}

Symmetric Messages

Hello

class ryu.ofproto.ofproto_v1_3_parser.OFPHello(datapath, elements=None)

Hello message
When connection is started, the hello message is exchanged between a switch and a controller.

2.5. OpenFlow protocol API Reference 269

ryu Documentation, Release 4.34

This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
elements list of OFPHelloElemVersionBitmap instance

JSON Example:
{
"OFPHello": {
"elements": [
{
"OFPHelloElemVersionBitmap": {
"length": 8,
"type": 1,
"versions": [
1,
2,
3,
9,
10,
30
]
}
}
]
}
}

class ryu.ofproto.ofproto_v1_3_parser.OFPHelloElemVersionBitmap(versions,
type_=None,
length=None)
Version bitmap Hello Element

Attribute Description
versions list of versions of OpenFlow protocol a device supports

Echo Request

class ryu.ofproto.ofproto_v1_3_parser.OFPEchoRequest(datapath, data=None)

Echo request message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data

Example:
def send_echo_request(self, datapath, data):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPEchoRequest(datapath, data)

datapath.send_msg(req)

(continues on next page)

270 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

JSON Example:

{
"OFPEchoRequest": {
"data": "aG9nZQ=="
}
}

Echo Reply

class ryu.ofproto.ofproto_v1_3_parser.OFPEchoReply(datapath, data=None)

Echo reply message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data

Example:

def send_echo_reply(self, datapath, data):

ofp_parser = datapath.ofproto_parser

reply = ofp_parser.OFPEchoReply(datapath, data)

datapath.send_msg(reply)

JSON Example:

{
"OFPEchoReply": {
"data": "aG9nZQ=="
}
}

Experimenter

class ryu.ofproto.ofproto_v1_3_parser.OFPExperimenter(datapath, exper-

imenter=None,
exp_type=None, data=None)
Experimenter extension message

2.5. OpenFlow protocol API Reference 271

ryu Documentation, Release 4.34

Attribute Description
experimenter Experimenter ID
exp_type Experimenter defined
data Experimenter defined arbitrary additional data

JSON Example:
{
"OFPExperimenter": {
"data": "bmF6bw==",
"exp_type": 123456789,
"experimenter": 98765432
}
}

Port Structures

class ryu.ofproto.ofproto_v1_3_parser.OFPPort
Description of a port

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

state Bitmap of port state flags.

OFPPS_LINK_DOWN
OFPPS_BLOCKED
OFPPS_LIVE

curr Current features.

Flow Match Structure

class ryu.ofproto.ofproto_v1_3_parser.OFPMatch(type_=None, length=None, _or-

dered_fields=None, **kwargs)
Flow Match Structure

272 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

This class is implementation of the flow match structure having compose/query API. There are new API and old
API for compatibility. the old API is supposed to be removed later.
You can define the flow match by the keyword arguments. The following arguments are available.

Argument Value Description

in_port Integer 32bit Switch input port
in_phy_port Integer 32bit Switch physical input port
metadata Integer 64bit Metadata passed between tables
eth_dst MAC address Ethernet destination address
eth_src MAC address Ethernet source address
eth_type Integer 16bit Ethernet frame type
vlan_vid Integer 16bit VLAN id
vlan_pcp Integer 8bit VLAN priority
ip_dscp Integer 8bit IP DSCP (6 bits in ToS field)
ip_ecn Integer 8bit IP ECN (2 bits in ToS field)
ip_proto Integer 8bit IP protocol
ipv4_src IPv4 address IPv4 source address
ipv4_dst IPv4 address IPv4 destination address
tcp_src Integer 16bit TCP source port
tcp_dst Integer 16bit TCP destination port
udp_src Integer 16bit UDP source port
udp_dst Integer 16bit UDP destination port
sctp_src Integer 16bit SCTP source port
sctp_dst Integer 16bit SCTP destination port
icmpv4_type Integer 8bit ICMP type
icmpv4_code Integer 8bit ICMP code
arp_op Integer 16bit ARP opcode
arp_spa IPv4 address ARP source IPv4 address
arp_tpa IPv4 address ARP target IPv4 address
arp_sha MAC address ARP source hardware address
arp_tha MAC address ARP target hardware address
ipv6_src IPv6 address IPv6 source address
ipv6_dst IPv6 address IPv6 destination address
ipv6_flabel Integer 32bit IPv6 Flow Label
icmpv6_type Integer 8bit ICMPv6 type
icmpv6_code Integer 8bit ICMPv6 code
ipv6_nd_target IPv6 address Target address for ND
ipv6_nd_sll MAC address Source link-layer for ND
ipv6_nd_tll MAC address Target link-layer for ND
mpls_label Integer 32bit MPLS label
mpls_tc Integer 8bit MPLS TC
mpls_bos Integer 8bit MPLS BoS bit
pbb_isid Integer 24bit PBB I-SID
tunnel_id Integer 64bit Logical Port Metadata
ipv6_exthdr Integer 16bit IPv6 Extension Header pseudo-field
pbb_uca Integer 8bit PBB UCA header field (EXT-256 Old version of ONF Extension)
tcp_flags Integer 16bit TCP flags (EXT-109 ONF Extension)
actset_output Integer 32bit Output port from action set metadata (EXT-233 ONF Extension)

Example:

2.5. OpenFlow protocol API Reference 273

ryu Documentation, Release 4.34

Note: For the list of the supported Nicira experimenter matches, please refer to ryu.ofproto.nx_match.

Note: For VLAN id match field, special values are defined in OpenFlow Spec.
1) Packets with and without a VLAN tag
• Example:

match = parser.OFPMatch()

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

2) Only packets without a VLAN tag

• Example:

match = parser.OFPMatch(vlan_vid=0x0000)

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) x
VLAN-tagged(vlan_id=5) x

3) Only packets with a VLAN tag regardless of its value

• Example:

match = parser.OFPMatch(vlan_vid=(0x1000, 0x1000))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

274 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

4) Only packets with VLAN tag and VID equal

• Example:

match = parser.OFPMatch(vlan_vid=(0x1000 | 3))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) x

Flow Instruction Structures

class ryu.ofproto.ofproto_v1_3_parser.OFPInstructionGotoTable(table_id,
type_=None,
len_=None)
Goto table instruction
This instruction indicates the next table in the processing pipeline.

Attribute Description
table_id Next table

class ryu.ofproto.ofproto_v1_3_parser.OFPInstructionWriteMetadata(metadata,
meta-
data_mask,
type_=None,
len_=None)
Write metadata instruction
This instruction writes the masked metadata value into the metadata field.

Attribute Description
metadata Metadata value to write
metadata_mask Metadata write bitmask

class ryu.ofproto.ofproto_v1_3_parser.OFPInstructionActions(type_, ac-

tions=None,
len_=None)
Actions instruction
This instruction writes/applies/clears the actions.

Attribute Description
type One of following values.

OFPIT_WRITE_ACTIONS
OFPIT_APPLY_ACTIONS
OFPIT_CLEAR_ACTIONS

actions list of OpenFlow action class

2.5. OpenFlow protocol API Reference 275

ryu Documentation, Release 4.34

type attribute corresponds to type_ parameter of init.

class ryu.ofproto.ofproto_v1_3_parser.OFPInstructionMeter(meter_id=1,
type_=None,
len_=None)
Meter instruction
This instruction applies the meter.

Attribute Description
meter_id Meter instance

Action Structures

class ryu.ofproto.ofproto_v1_3_parser.OFPActionOutput(port, max_len=65509,

type_=None, len_=None)
Output action
This action indicates output a packet to the switch port.

Attribute Description
port Output port
max_len Max length to send to controller

class ryu.ofproto.ofproto_v1_3_parser.OFPActionGroup(group_id=0, type_=None,

len_=None)
Group action
This action indicates the group used to process the packet.

Attribute Description
group_id Group identifier

class ryu.ofproto.ofproto_v1_3_parser.OFPActionSetQueue(queue_id, type_=None,

len_=None)
Set queue action
This action sets the queue id that will be used to map a flow to an already-configured queue on a port.

Attribute Description
queue_id Queue ID for the packets

class ryu.ofproto.ofproto_v1_3_parser.OFPActionSetMplsTtl(mpls_ttl, type_=None,

len_=None)
Set MPLS TTL action
This action sets the MPLS TTL.

Attribute Description
mpls_ttl MPLS TTL

class ryu.ofproto.ofproto_v1_3_parser.OFPActionDecMplsTtl(type_=None,
len_=None)
Decrement MPLS TTL action
This action decrements the MPLS TTL.

276 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_3_parser.OFPActionSetNwTtl(nw_ttl, type_=None,

len_=None)
Set IP TTL action
This action sets the IP TTL.

Attribute Description
nw_ttl IP TTL

class ryu.ofproto.ofproto_v1_3_parser.OFPActionDecNwTtl(type_=None, len_=None)

Decrement IP TTL action
This action decrements the IP TTL.
class ryu.ofproto.ofproto_v1_3_parser.OFPActionCopyTtlOut(type_=None,
len_=None)
Copy TTL Out action
This action copies the TTL from the next-to-outermost header with TTL to the outermost header with TTL.
class ryu.ofproto.ofproto_v1_3_parser.OFPActionCopyTtlIn(type_=None,
len_=None)
Copy TTL In action
This action copies the TTL from the outermost header with TTL to the next-to-outermost header with TTL.
class ryu.ofproto.ofproto_v1_3_parser.OFPActionPushVlan(ethertype=33024,
type_=None, len_=None)
Push VLAN action
This action pushes a new VLAN tag to the packet.

Attribute Description
ethertype Ether type. The default is 802.1Q. (0x8100)

class ryu.ofproto.ofproto_v1_3_parser.OFPActionPushMpls(ethertype=34887,
type_=None, len_=None)
Push MPLS action
This action pushes a new MPLS header to the packet.

Attribute Description
ethertype Ether type

class ryu.ofproto.ofproto_v1_3_parser.OFPActionPopVlan(type_=None, len_=None)

Pop VLAN action
This action pops the outermost VLAN tag from the packet.
class ryu.ofproto.ofproto_v1_3_parser.OFPActionPopMpls(ethertype=2048,
type_=None, len_=None)
Pop MPLS action
This action pops the MPLS header from the packet.
class ryu.ofproto.ofproto_v1_3_parser.OFPActionSetField(field=None, **kwargs)
Set field action
This action modifies a header field in the packet.
The set of keywords available for this is same as OFPMatch.

2.5. OpenFlow protocol API Reference 277

ryu Documentation, Release 4.34

Example:

set_field = OFPActionSetField(eth_src="00:00:00:00:00:00")

class ryu.ofproto.ofproto_v1_3_parser.OFPActionExperimenter(experimenter)
Experimenter action
This action is an extensible action for the experimenter.

Attribute Description
experimenter Experimenter ID

Note: For the list of the supported Nicira experimenter actions, please refer to ryu.ofproto.nx_actions.

2.5.5 OpenFlow v1.4 Messages and Structures

Controller-to-Switch Messages

Handshake

class ryu.ofproto.ofproto_v1_4_parser.OFPFeaturesRequest(datapath)
Features request message
The controller sends a feature request to the switch upon session establishment.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
Example:

def send_features_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPFeaturesRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPFeaturesRequest": {}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPSwitchFeatures(datapath, data-

278 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPSwitchFeatures, CONFIG_DISPATCHER)
def switch_features_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPSwitchFeatures received: '

'datapath_id=0x%016x n_buffers=%d '
'n_tables=%d auxiliary_id=%d '
'capabilities=0x%08x',
msg.datapath_id, msg.n_buffers, msg.n_tables,
msg.auxiliary_id, msg.capabilities)

JSON Example:
{
"OFPSwitchFeatures": {
"auxiliary_id": 99,
"capabilities": 79,
"datapath_id": 9210263729383,
"n_buffers": 0,
"n_tables": 255
}
}

Switch Configuration

class ryu.ofproto.ofproto_v1_4_parser.OFPSetConfig(datapath, flags=0,

miss_send_len=0)
Set config request message
The controller sends a set config request message to set configuraion parameters.

Attribute Description
flags Bitmap of the following flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:
def send_set_config(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPSetConfig(datapath, ofp.OFPC_FRAG_NORMAL, 256)

datapath.send_msg(req)

JSON Example:
{
"OFPSetConfig": {
(continues on next page)

2.5. OpenFlow protocol API Reference 279

ryu Documentation, Release 4.34

(continued from previous page)

"flags": 0,
"miss_send_len": 128
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGetConfigRequest(datapath)
Get config request message
The controller sends a get config request to query configuration parameters in the switch.
Example:
def send_get_config_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetConfigRequest(datapath)
datapath.send_msg(req)

JSON Example:
{
"OFPGetConfigRequest": {}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGetConfigReply(datapath, flags=None,

miss_send_len=None)
Get config reply message
The switch responds to a configuration request with a get config reply message.

Attribute Description
flags Bitmap of the following flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:
@set_ev_cls(ofp_event.EventOFPGetConfigReply, MAIN_DISPATCHER)
def get_config_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto
flags = []

if msg.flags & ofp.OFPC_FRAG_NORMAL:

280 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

'flags=%s miss_send_len=%d',
','.join(flags), msg.miss_send_len)

JSON Example:

{
"OFPGetConfigReply": {
"flags": 0,
"miss_send_len": 128
}
}

Modify State Messages

class ryu.ofproto.ofproto_v1_4_parser.OFPTableMod(datapath, table_id, config, proper-

ties)
Flow table configuration message
The controller sends this message to configure table state.

Attribute Description
table_id ID of the table (OFPTT_ALL indicates all tables)
config Bitmap of configuration flags.

OFPTC_EVICTION
OFPTC_VACANCY_EVENTS

properties List of OFPTableModProp subclass instance

Example:

def send_table_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableMod(datapath, 1, 3)
flags = ofp.OFPTC_VACANCY_EVENTS
properties = [ofp_parser.OFPTableModPropEviction(flags)]
req = ofp_parser.OFPTableMod(datapath, 1, 3, properties)
datapath.send_msg(req)

JSON Example:

{
"OFPTableMod": {
"config": 0,
"properties": [
{
"OFPTableModPropEviction": {
"flags": 0,
"length": 8,
"type": 2
}
(continues on next page)

2.5. OpenFlow protocol API Reference 281

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OFPTableModPropVacancy": {
"length": 8,
"type": 3,
"vacancy": 0,
"vacancy_down": 0,
"vacancy_up": 0
}
},
{
"OFPTableModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"table_id": 255
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPFlowMod(datapath, cookie=0,

cookie_mask=0, table_id=0,
command=0, idle_timeout=0,
hard_timeout=0, priority=32768,
buffer_id=4294967295, out_port=0,
out_group=0, flags=0, impor-
tance=0, match=None, instruc-
tions=None)
Modify Flow entry message

282 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

The controller sends this message to modify the flow table.

OFPFC_ADD
OFPFC_MODIFY
OFPFC_MODIFY_STRICT
OFPFC_DELETE
OFPFC_DELETE_STRICT

idle_timeout Idle time before discarding (seconds)

OFPFF_SEND_FLOW_REM
OFPFF_CHECK_OVERLAP
OFPFF_RESET_COUNTS
OFPFF_NO_PKT_COUNTS
OFPFF_NO_BYT_COUNTS

importance Eviction precedence

match Instance of OFPMatch
instructions list of OFPInstruction* instance

Example:

def send_flow_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

2.5. OpenFlow protocol API Reference 283

ryu Documentation, Release 4.34

(continued from previous page)

req = ofp_parser.OFPFlowMod(datapath, cookie, cookie_mask,
table_id, ofp.OFPFC_ADD,
idle_timeout, hard_timeout,
priority, buffer_id,
ofp.OFPP_ANY, ofp.OFPG_ANY,
ofp.OFPFF_SEND_FLOW_REM,
importance,
match, inst)
datapath.send_msg(req)

JSON Example:
{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 258
}
},
"len": 16,
"type": 25
}
},
{
"OFPActionCopyTtlOut": {
"len": 8,
"type": 11
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
},
(continues on next page)

284 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPActionPopPbb": {
"len": 8,
"type": 27
}
},
{
"OFPActionPushPbb": {
"ethertype": 4660,
"len": 8,
"type": 26
}
},
{
"OFPActionPopMpls": {
"ethertype": 39030,
"len": 8,
"type": 20
}
},
{
"OFPActionPushMpls": {
"ethertype": 34887,
"len": 8,
"type": 19
}
},
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionPushVlan": {
"ethertype": 33024,
"len": 8,
"type": 17
}
},
{
"OFPActionDecMplsTtl": {
"len": 8,
"type": 16
}
},
{
"OFPActionSetMplsTtl": {
"len": 8,
"mpls_ttl": 10,
"type": 15
}
},
{
"OFPActionDecNwTtl": {
"len": 8,
"type": 24
(continues on next page)

2.5. OpenFlow protocol API Reference 285

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OFPActionSetNwTtl": {
"len": 8,
"nw_ttl": 10,
"type": 23
}
},
{
"OFPActionExperimenterUnknown": {
"data": "AAECAwQFBgc=",
"experimenter": 101,
"len": 16,
"type": 65535
}
},
{
"OFPActionSetQueue": {
"len": 8,
"queue_id": 3,
"type": 21
}
},
{
"OFPActionGroup": {
"group_id": 99,
"len": 8,
"type": 22
}
},
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 6,
"type": 0
}
}
],
"len": 176,
"type": 3
}
},
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "01:02:03:04:05:06"
}
},
"len": 16,
(continues on next page)

286 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"type": 25
}
},
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "pbb_uca",
"mask": null,
"value": 1
}
},
"len": 16,
"type": 25
}
}
],
"len": 40,
"type": 4
}
}
],
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 1
}
}

{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 0,
"instructions": [
{
(continues on next page)

2.5. OpenFlow protocol API Reference 287

ryu Documentation, Release 4.34

(continued from previous page)

"OFPInstructionGotoTable": {
"len": 8,
"table_id": 1,
"type": 1
}
}
],
"match": {
"OFPMatch": {
"length": 22,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 0
}
}

{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 0,
"instructions": [
{
"OFPInstructionMeter": {
"len": 8,
"meter_id": 1,
"type": 6
}
},
{
"OFPInstructionActions": {
(continues on next page)

288 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 6,
"type": 0
}
}
],
"len": 24,
"type": 3
}
}
],
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 1
}
}

{
"OFPFlowMod": {
"buffer_id": 65535,
"command": 0,
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 0,
"instructions": [],
"match": {
"OFPMatch": {
"length": 329,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
(continues on next page)

2.5. OpenFlow protocol API Reference 289

ryu Documentation, Release 4.34

(continued from previous page)

"value": 84281096
}
},
{
"OXMTlv": {
"field": "in_phy_port",
"mask": null,
"value": 16909060
}
},
{
"OXMTlv": {
"field": "metadata",
"mask": null,
"value": 283686952306183
}
},
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
},
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "ff:ff:ff:ff:ff:ff"
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 999
}
},
{
"OXMTlv": {
"field": "ip_dscp",
"mask": null,
"value": 9
}
},
{
"OXMTlv": {
"field": "ip_ecn",
"mask": null,
"value": 3
(continues on next page)

290 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OXMTlv": {
"field": "ip_proto",
"mask": null,
"value": 99
}
},
{
"OXMTlv": {
"field": "ipv4_src",
"mask": null,
"value": "1.2.3.4"
}
},
{
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "1.2.3.4"
}
},
{
"OXMTlv": {
"field": "tcp_src",
"mask": null,
"value": 8080
}
},
{
"OXMTlv": {
"field": "tcp_dst",
"mask": null,
"value": 18080
}
},
{
"OXMTlv": {
"field": "udp_src",
"mask": null,
"value": 28080
}
},
{
"OXMTlv": {
"field": "udp_dst",
"mask": null,
"value": 55936
}
},
{
"OXMTlv": {
"field": "sctp_src",
"mask": null,
"value": 48080
}
(continues on next page)

2.5. OpenFlow protocol API Reference 291

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OXMTlv": {
"field": "sctp_dst",
"mask": null,
"value": 59328
}
},
{
"OXMTlv": {
"field": "icmpv4_type",
"mask": null,
"value": 100
}
},
{
"OXMTlv": {
"field": "icmpv4_code",
"mask": null,
"value": 101
}
},
{
"OXMTlv": {
"field": "arp_op",
"mask": null,
"value": 1
}
},
{
"OXMTlv": {
"field": "arp_spa",
"mask": null,
"value": "10.0.0.1"
}
},
{
"OXMTlv": {
"field": "arp_tpa",
"mask": null,
"value": "10.0.0.3"
}
},
{
"OXMTlv": {
"field": "arp_sha",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "arp_tha",
"mask": null,
"value": "00:00:00:00:00:00"
}
},
(continues on next page)

292 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OXMTlv": {
"field": "ipv6_src",
"mask": null,
"value": "fe80::f00b:a4ff:fe48:28a5"
}
},
{
"OXMTlv": {
"field": "ipv6_dst",
"mask": null,
"value": "fe80::f00b:a4ff:fe05:b7dc"
}
},
{
"OXMTlv": {
"field": "ipv6_flabel",
"mask": null,
"value": 541473
}
},
{
"OXMTlv": {
"field": "icmpv6_type",
"mask": null,
"value": 200
}
},
{
"OXMTlv": {
"field": "icmpv6_code",
"mask": null,
"value": 201
}
},
{
"OXMTlv": {
"field": "ipv6_nd_target",
"mask": null,
"value": "fe80::a60:6eff:fe7f:74e7"
}
},
{
"OXMTlv": {
"field": "ipv6_nd_sll",
"mask": null,
"value": "00:00:00:00:02:9a"
}
},
{
"OXMTlv": {
"field": "ipv6_nd_tll",
"mask": null,
"value": "00:00:00:00:02:2b"
}
},
{
(continues on next page)

2.5. OpenFlow protocol API Reference 293

ryu Documentation, Release 4.34

(continued from previous page)

"OXMTlv": {
"field": "mpls_label",
"mask": null,
"value": 624485
}
},
{
"OXMTlv": {
"field": "mpls_tc",
"mask": null,
"value": 5
}
},
{
"OXMTlv": {
"field": "mpls_bos",
"mask": null,
"value": 1
}
},
{
"OXMTlv": {
"field": "pbb_isid",
"mask": null,
"value": 11259375
}
},
{
"OXMTlv": {
"field": "tunnel_id",
"mask": null,
"value": 651061555542690057
}
},
{
"OXMTlv": {
"field": "ipv6_exthdr",
"mask": null,
"value": 500
}
},
{
"OXMTlv": {
"field": "pbb_uca",
"mask": null,
"value": 1
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"priority": 123,
"table_id": 1
}
(continues on next page)

294 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}

class ryu.ofproto.ofproto_v1_4_parser.OFPGroupMod(datapath, command=0, type_=0,

group_id=0, buckets=None)
Modify group entry message
The controller sends this message to modify the group table.

Attribute Description
command One of the following values.

OFPGC_ADD
OFPGC_MODIFY
OFPGC_DELETE

type One of the following values.

OFPGT_ALL
OFPGT_SELECT
OFPGT_INDIRECT
OFPGT_FF

group_id Group identifier

buckets list of OFPBucket

type attribute corresponds to type_ parameter of init.

Example:

def send_group_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

port = 1
max_len = 2000
actions = [ofp_parser.OFPActionOutput(port, max_len)]

weight = 100
watch_port = 0
watch_group = 0
buckets = [ofp_parser.OFPBucket(weight, watch_port, watch_group,
actions)]

group_id = 1
req = ofp_parser.OFPGroupMod(datapath, ofp.OFPGC_ADD,
ofp.OFPGT_SELECT, group_id, buckets)
datapath.send_msg(req)

JSON Example:

{
"OFPGroupMod": {
"buckets": [
{
(continues on next page)

2.5. OpenFlow protocol API Reference 295

ryu Documentation, Release 4.34

(continued from previous page)

"OFPBucket": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 2,
"type": 0
}
}
],
"len": 32,
"watch_group": 1,
"watch_port": 1,
"weight": 1
}
}
],
"command": 0,
"group_id": 1,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPPortMod(datapath, port_no=0,

hw_addr=’00:00:00:00:00:00’, con-
fig=0, mask=0, properties=None)
Port modification message
The controller sneds this message to modify the behavior of the port.

Attribute Description
port_no Port number to modify
hw_addr The hardware address that must be the same as
hw_addr of OFPPort of OFPSwitchFeatures
config Bitmap of configuration flags.

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

mask Bitmap of configuration flags above to be changed

properties List of OFPPortModProp subclass instance

Example:

def send_port_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

port_no = 3
hw_addr = 'fa:c8:e8:76:1d:7e'
config = 0
(continues on next page)

296 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

JSON Example:
{
"OFPPortMod": {
"config": 0,
"hw_addr": "00:11:00:00:11:11",
"mask": 0,
"port_no": 1,
"properties": [
{
"OFPPortModPropEthernet": {
"advertise": 4096,
"length": 8,
"type": 0
}
},
{
"OFPPortModPropOptical": {
"configure": 3,
"fl_offset": 2000,
"freq_lmda": 1500,
"grid_span": 3000,
"length": 24,
"tx_pwr": 300,
"type": 1
}
},
{
"OFPPortModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPPortModPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
(continues on next page)

2.5. OpenFlow protocol API Reference 297

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OFPPortModPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
]
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPMeterMod(datapath, command=0, flags=1,

meter_id=1, bands=None)
Meter modification message
The controller sends this message to modify the meter.

Attribute Description
command One of the following values.

OFPMC_ADD
OFPMC_MODIFY
OFPMC_DELETE

flags Bitmap of the following flags.

OFPMF_KBPS
OFPMF_PKTPS
OFPMF_BURST
OFPMF_STATS

meter_id Meter instance

bands list of the following class instance.

OFPMeterBandDrop
OFPMeterBandDscpRemark
OFPMeterBandExperimenter

JSON Example:

{
"OFPMeterMod": {
"bands": [
{
"OFPMeterBandDrop": {
"burst_size": 10,
(continues on next page)

298 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"len": 16,
"rate": 1000,
"type": 1
}
},
{
"OFPMeterBandDscpRemark": {
"burst_size": 10,
"len": 16,
"prec_level": 1,
"rate": 1000,
"type": 2
}
},
{
"OFPMeterBandExperimenter": {
"burst_size": 10,
"experimenter": 999,
"len": 16,
"rate": 1000,
"type": 65535
}
}
],
"command": 0,
"flags": 14,
"meter_id": 100
}
}

Multipart Messages

class ryu.ofproto.ofproto_v1_4_parser.OFPDescStatsRequest(datapath, flags=0,

type_=None)
Description statistics request message
The controller uses this message to query description of the switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPDescStatsRequest": {
"flags": 0,
(continues on next page)

2.5. OpenFlow protocol API Reference 299

ryu Documentation, Release 4.34

(continued from previous page)

"type": 0
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPDescStatsReply(datapath, type_=None,

**kwargs)
Description statistics reply message
The switch responds with this message to a description statistics request.

Attribute Description
body Instance of OFPDescStats

Example:

@set_ev_cls(ofp_event.EventOFPDescStatsReply, MAIN_DISPATCHER)
def desc_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('DescStats: mfr_desc=%s hw_desc=%s sw_desc=%s '

'serial_num=%s dp_desc=%s',
body.mfr_desc, body.hw_desc, body.sw_desc,
body.serial_num, body.dp_desc)

JSON Example:

{
"OFPDescStatsReply": {
"body": {
"OFPDescStats": {
"dp_desc": "dp",
"hw_desc": "hw",
"mfr_desc": "mfr",
"serial_num": "serial",
"sw_desc": "sw"
}
},
"flags": 0,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPFlowStatsRequest(datapath, flags=0,

300 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Example:

def send_flow_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:

class ryu.ofproto.ofproto_v1_4_parser.OFPFlowStatsReply(datapath, type_=None,

**kwargs)
Individual flow statistics reply message
The switch responds with this message to an individual flow statistics request.

Attribute Description
body List of OFPFlowStats instance

Example:

2.5. OpenFlow protocol API Reference 301

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPFlowStatsReply, MAIN_DISPATCHER)
def flow_stats_reply_handler(self, ev):
flows = []
for stat in ev.msg.body:
flows.append('table_id=%s '
'duration_sec=%d duration_nsec=%d '
'priority=%d '
'idle_timeout=%d hard_timeout=%d flags=0x%04x '
'importance=%d cookie=%d packet_count=%d '
'byte_count=%d match=%s instructions=%s' %
(stat.table_id,
stat.duration_sec, stat.duration_nsec,
stat.priority,
stat.idle_timeout, stat.hard_timeout,
stat.flags, stat.importance,
stat.cookie, stat.packet_count, stat.byte_count,
stat.match, stat.instructions))
self.logger.debug('FlowStats: %s', flows)

JSON Example:

{
"OFPFlowStatsReply": {
"body": [
{
"OFPFlowStats": {
"byte_count": 0,
"cookie": 0,
"duration_nsec": 115277000,
"duration_sec": 358,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 0,
"instructions": [],
"length": 56,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"packet_count": 0,
"priority": 65535,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 0,
"cookie": 0,
"duration_nsec": 115055000,
"duration_sec": 358,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
(continues on next page)

302 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"importance": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 0,
"port": 4294967290,
"type": 0
}
}
],
"len": 24,
"type": 4
}
}
],
"length": 88,
"match": {
"OFPMatch": {
"length": 10,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
}
],
"type": 1
}
},
"packet_count": 0,
"priority": 65534,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 238,
"cookie": 0,
"duration_nsec": 511582000,
"duration_sec": 316220,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 0,
"instructions": [
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 1,
"type": 1
}
(continues on next page)

2.5. OpenFlow protocol API Reference 303

ryu Documentation, Release 4.34

(continued from previous page)

}
],
"length": 80,
"match": {
"OFPMatch": {
"length": 22,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 6
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"packet_count": 3,
"priority": 123,
"table_id": 0
}
},
{
"OFPFlowStats": {
"byte_count": 98,
"cookie": 0,
"duration_nsec": 980901000,
"duration_sec": 313499,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 0,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 258
}
},
"len": 16,
"type": 25
}
},
(continues on next page)

304 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPActionCopyTtlOut": {
"len": 8,
"type": 11
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
},
{
"OFPActionCopyTtlIn": {
"len": 8,
"type": 12
}
},
{
"OFPActionPopPbb": {
"len": 8,
"type": 27
}
},
{
"OFPActionPushPbb": {
"ethertype": 4660,
"len": 8,
"type": 26
}
},
{
"OFPActionPopMpls": {
"ethertype": 39030,
"len": 8,
"type": 20
}
},
{
"OFPActionPushMpls": {
"ethertype": 34887,
"len": 8,
"type": 19
}
},
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionPushVlan": {
"ethertype": 33024,
"len": 8,
"type": 17
}
(continues on next page)

2.5. OpenFlow protocol API Reference 305

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OFPActionDecMplsTtl": {
"len": 8,
"type": 16
}
},
{
"OFPActionSetMplsTtl": {
"len": 8,
"mpls_ttl": 10,
"type": 15
}
},
{
"OFPActionDecNwTtl": {
"len": 8,
"type": 24
}
},
{
"OFPActionSetNwTtl": {
"len": 8,
"nw_ttl": 10,
"type": 23
}
},
{
"OFPActionSetQueue": {
"len": 8,
"queue_id": 3,
"type": 21
}
},
{
"OFPActionGroup": {
"group_id": 99,
"len": 8,
"type": 22
}
},
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 6,
"type": 0
}
},
{
"OFPActionExperimenterUnknown": {
"len": 16,
"data": "ZXhwX2RhdGE=",
"experimenter": 98765432,
"type": 65535
}
},
(continues on next page)

306 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"NXActionUnknown": {
"len": 16,
"data": "cF9kYXRh",
"experimenter": 8992,
"type": 65535,
"subtype": 25976
}
}
],
"len": 192,
"type": 3
}
},
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "01:02:03:04:05:06"
}
},
"len": 16,
"type": 25
}
},
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "pbb_uca",
"mask": null,
"value": 1
}
},
"len": 16,
"type": 25
}
}
],
"len": 40,
"type": 4
}
},
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 4294967293,
"type": 0
(continues on next page)

2.5. OpenFlow protocol API Reference 307

ryu Documentation, Release 4.34

(continued from previous page)

}
}
],
"len": 24,
"type": 3
}
}
],
"length": 312,
"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"packet_count": 1,
"priority": 0,
"table_id": 0
}
}
],
"flags": 0,
"type": 1
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPAggregateStatsRequest(datapath,
flags, table_id,
out_port,
out_group,
cookie,
cookie_mask,
match,
type_=None)
Aggregate flow statistics request message
The controller uses this message to query aggregate flow statictics.

Example:
def send_aggregate_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

cookie = cookie_mask = 0
(continues on next page)

308 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

match = ofp_parser.OFPMatch(in_port=1)
req = ofp_parser.OFPAggregateStatsRequest(datapath, 0,
ofp.OFPTT_ALL,
ofp.OFPP_ANY,
ofp.OFPG_ANY,
cookie, cookie_mask,
match)
datapath.send_msg(req)

class ryu.ofproto.ofproto_v1_4_parser.OFPAggregateStatsReply(datapath,
type_=None,
**kwargs)
Aggregate flow statistics reply message
The switch responds with this message to an aggregate flow statistics request.

Attribute Description
body Instance of OFPAggregateStats

Example:
@set_ev_cls(ofp_event.EventOFPAggregateStatsReply, MAIN_DISPATCHER)
def aggregate_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('AggregateStats: packet_count=%d byte_count=%d '

'flow_count=%d',
body.packet_count, body.byte_count,
body.flow_count)

JSON Example:
{
"OFPAggregateStatsReply": {
"body": {
(continues on next page)

2.5. OpenFlow protocol API Reference 309

ryu Documentation, Release 4.34

(continued from previous page)

"OFPAggregateStats": {
"byte_count": 574,
"flow_count": 6,
"packet_count": 7
}
},
"flags": 0,
"type": 2
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPTableStatsRequest(datapath, flags,

type_=None)
Table statistics request message
The controller uses this message to query flow table statictics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_table_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPTableStatsRequest": {
"flags": 0,
"type": 3
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPTableStatsReply(datapath, type_=None,

**kwargs)
Table statistics reply message
The switch responds with this message to a table statistics request.

Attribute Description
body List of OFPTableStats instance

Example:

@set_ev_cls(ofp_event.EventOFPTableStatsReply, MAIN_DISPATCHER)
def table_stats_reply_handler(self, ev):
tables = []
for stat in ev.msg.body:
tables.append('table_id=%d active_count=%d lookup_count=%d '
' matched_count=%d' %
(stat.table_id, stat.active_count,
(continues on next page)

310 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

stat.lookup_count, stat.matched_count))
self.logger.debug('TableStats: %s', tables)

JSON Example:

{
"OFPTableStatsReply": {
"body": [
{
"OFPTableStats": {
"active_count": 4,
"lookup_count": 4,
"matched_count": 4,
"table_id": 0
}
},
{
"OFPTableStats": {
"active_count": 4,
"lookup_count": 4,
"matched_count": 4,
"table_id": 1
}
}
],
"flags": 0,
"type": 3
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPTableDescStatsRequest(datapath,
flags=0,
type_=None)
Table description request message
The controller uses this message to query description of all the tables.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_table_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPTableDescStatsRequest": {
"flags": 0,
"type": 14
}
}

2.5. OpenFlow protocol API Reference 311

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_4_parser.OFPTableDescStatsReply(datapath,
type_=None,
**kwargs)
Table description reply message
The switch responds with this message to a table description request.

Attribute Description
body List of OFPTableDesc instance

Example:

@set_ev_cls(ofp_event.EventOFPTableDescStatsReply, MAIN_DISPATCHER)
def table_desc_stats_reply_handler(self, ev):
tables = []
for p in ev.msg.body:
tables.append('table_id=%d config=0x%08x properties=%s' %
(p.table_id, p.config, repr(p.properties)))
self.logger.debug('OFPTableDescStatsReply received: %s', tables)

JSON Example:

{
"OFPTableDescStatsReply": {
"body": [
{
"OFPTableDesc": {
"config": 0,
"length": 24,
"properties": [
{
"OFPTableModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
}
],
"table_id": 7
}
},
{
"OFPTableDesc": {
"config": 0,
"length": 80,
"properties": [
{
"OFPTableModPropEviction": {
"flags": 0,
"length": 8,
"type": 2
}
},
{
"OFPTableModPropVacancy": {
(continues on next page)

312 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"length": 8,
"type": 3,
"vacancy": 0,
"vacancy_down": 0,
"vacancy_up": 0
}
},
{
"OFPTableModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"table_id": 8
}
}
],
"flags": 0,
"type": 14
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPTableFeaturesStatsRequest(datapath,
flags=0,
body=None,
type_=None)
Table features statistics request message
The controller uses this message to query table features.

2.5. OpenFlow protocol API Reference 313

ryu Documentation, Release 4.34

Attribute Description
body List of OFPTableFeaturesStats instances. The default is [].

JSON Example:
See an example in:
ryu/tests/unit/ofproto/json/of14/5-53-ofp_table_features_request.
packet.json
class ryu.ofproto.ofproto_v1_4_parser.OFPTableFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Table features statistics reply message
The switch responds with this message to a table features statistics request.

Attribute Description
body List of OFPTableFeaturesStats instance

JSON Example:
See an example in:
ryu/tests/unit/ofproto/json/of14/5-54-ofp_table_features_reply.
packet.json
class ryu.ofproto.ofproto_v1_4_parser.OFPPortStatsRequest(datapath, flags,
port_no, type_=None)
Port statistics request message
The controller uses this message to query information about ports statistics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read (OFPP_ANY to all ports)

Example:

def send_port_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortStatsRequest(datapath, 0, ofp.OFPP_ANY)

datapath.send_msg(req)

JSON Example:

{
"OFPPortStatsRequest": {
"flags": 0,
"port_no": 4294967295,
"type": 4
}
}

314 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_4_parser.OFPPortStatsReply(datapath, type_=None,

**kwargs)
Port statistics reply message
The switch responds with this message to a port statistics request.

Attribute Description
body List of OFPPortStats instance

Example:

@set_ev_cls(ofp_event.EventOFPPortStatsReply, MAIN_DISPATCHER)
def port_stats_reply_handler(self, ev):
ports = []
for stat in ev.msg.body:
ports.append(stat.length, stat.port_no,
stat.duration_sec, stat.duration_nsec,
stat.rx_packets, stat.tx_packets,
stat.rx_bytes, stat.tx_bytes,
stat.rx_dropped, stat.tx_dropped,
stat.rx_errors, stat.tx_errors,
repr(stat.properties))
self.logger.debug('PortStats: %s', ports)

JSON Example:

2.5. OpenFlow protocol API Reference 315

ryu Documentation, Release 4.34

(continued from previous page)

"tx_grid_span": 500,
"tx_offset": 700,
"tx_pwr": 2000,
"type": 1
}
},
{
"OFPPortStatsPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPPortStatsPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPPortStatsPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"rx_bytes": 0,
"rx_dropped": 0,
"rx_errors": 0,
"rx_packets": 0,
"tx_bytes": 336,
"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
},
{
"OFPPortStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 120,
"port_no": 6,
"properties": [
{
(continues on next page)

316 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"OFPPortStatsPropEthernet": {
"collisions": 0,
"length": 40,
"rx_crc_err": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"type": 0
}
}
],
"rx_bytes": 336,
"rx_dropped": 0,
"rx_errors": 0,
"rx_packets": 4,
"tx_bytes": 336,
"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
}
],
"flags": 0,
"type": 4
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPPortDescStatsRequest(datapath,
flags=0,
type_=None)
Port description request message
The controller uses this message to query description of all the ports.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:
def send_port_desc_stats_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:
{
"OFPPortDescStatsRequest": {
"flags": 0,
"type": 13
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPPortDescStatsReply(datapath,
type_=None,
**kwargs)
Port description reply message

2.5. OpenFlow protocol API Reference 317

ryu Documentation, Release 4.34

The switch responds with this message to a port description request.

Attribute Description
body List of OFPPort instance

Example:

@set_ev_cls(ofp_event.EventOFPPortDescStatsReply, MAIN_DISPATCHER)
def port_desc_stats_reply_handler(self, ev):
ports = []
for p in ev.msg.body:
ports.append('port_no=%d hw_addr=%s name=%s config=0x%08x '
'state=0x%08x properties=%s' %
(p.port_no, p.hw_addr,
p.name, p.config, p.state, repr(p.properties)))
self.logger.debug('OFPPortDescStatsReply received: %s', ports)

JSON Example:

{
"OFPPortDescStatsReply": {
"body": [
{
"OFPPort": {
"config": 0,
"hw_addr": "f2:0b:a4:d0:3f:70",
"length": 168,
"name": "Port7",
"port_no": 7,
"properties": [
{
"OFPPortDescPropEthernet": {
"advertised": 10240,
"curr": 10248,
"curr_speed": 5000,
"length": 32,
"max_speed": 5000,
"peer": 10248,
"supported": 10248,
"type": 0
}
},
{
"OFPPortDescPropOptical": {
"length": 40,
"rx_grid_freq_lmda": 1500,
"rx_max_freq_lmda": 2000,
"rx_min_freq_lmda": 1000,
"supported": 1,
"tx_grid_freq_lmda": 1500,
"tx_max_freq_lmda": 2000,
"tx_min_freq_lmda": 1000,
"tx_pwr_max": 2000,
"tx_pwr_min": 1000,
"type": 1
}
},
(continues on next page)

318 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPPortDescPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPPortDescPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPPortDescPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"state": 4
}
},
{
"OFPPort": {
"config": 0,
"hw_addr": "f2:0b:a4:7d:f8:ea",
"length": 72,
"name": "Port6",
"port_no": 6,
"properties": [
{
"OFPPortDescPropEthernet": {
"advertised": 10240,
"curr": 10248,
"curr_speed": 5000,
"length": 32,
"max_speed": 5000,
"peer": 10248,
"supported": 10248,
"type": 0
}
}
],
(continues on next page)

2.5. OpenFlow protocol API Reference 319

ryu Documentation, Release 4.34

(continued from previous page)

"state": 4
}
}
],
"flags": 0,
"type": 13
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPQueueStatsRequest(datapath, flags=0,

port_no=4294967295,
queue_id=4294967295,
type_=None)
Queue statistics request message
The controller uses this message to query queue statictics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read
queue_id ID of queue to read

Example:

def send_queue_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueStatsRequest(datapath, 0, ofp.OFPP_ANY,

ofp.OFPQ_ALL)
datapath.send_msg(req)

JSON Example:

{
"OFPQueueStatsRequest": {
"flags": 0,
"port_no": 4294967295,
"queue_id": 4294967295,
"type": 5
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPQueueStatsReply(datapath, type_=None,

**kwargs)
Queue statistics reply message
The switch responds with this message to an aggregate flow statistics request.

Attribute Description
body List of OFPQueueStats instance

Example:

320 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPQueueStatsReply, MAIN_DISPATCHER)
def queue_stats_reply_handler(self, ev):
queues = []
for stat in ev.msg.body:
queues.append('port_no=%d queue_id=%d '
'tx_bytes=%d tx_packets=%d tx_errors=%d '
'duration_sec=%d duration_nsec=%d'
'properties=%s' %
(stat.port_no, stat.queue_id,
stat.tx_bytes, stat.tx_packets, stat.tx_errors,
stat.duration_sec, stat.duration_nsec,
repr(stat.properties)))
self.logger.debug('QueueStats: %s', queues)

JSON Example:

{
"OFPQueueStatsReply": {
"body": [
{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 104,
"port_no": 7,
"properties": [
{
"OFPQueueStatsPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPQueueStatsPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPQueueStatsPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
(continues on next page)

2.5. OpenFlow protocol API Reference 321

ryu Documentation, Release 4.34

(continued from previous page)

}
],
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
},
{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 48,
"port_no": 6,
"properties": [],
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
},
{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 48,
"port_no": 7,
"properties": [],
"queue_id": 2,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
}
],
"flags": 0,
"type": 5
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPQueueDescStatsRequest(datapath,
flags=0,
port_no=4294967295,
queue_id=4294967295,
type_=None)
Queue description request message
The controller uses this message to query description of all the queues.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read (OFPP_ANY for all ports)
queue_id ID of queue to read (OFPQ_ALL for all queues)

Example:

322 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_queue_desc_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser
req = ofp_parser.OFPQueueDescStatsRequest(datapath, 0,
ofp.OFPP_ANY,
ofp.OFPQ_ALL)
datapath.send_msg(req)

JSON Example:

{
"OFPQueueDescStatsRequest": {
"flags": 0,
"port_no": 7,
"queue_id": 4294967295,
"type": 15
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPQueueDescStatsReply(datapath,
type_=None,
**kwargs)
Queue description reply message
The switch responds with this message to a queue description request.

Attribute Description
body List of OFPQueueDesc instance

Example:

@set_ev_cls(ofp_event.EventOFPQueueDescStatsReply, MAIN_DISPATCHER)
def queue_desc_stats_reply_handler(self, ev):
queues = []
for q in ev.msg.body:
queues.append('port_no=%d queue_id=0x%08x properties=%s' %
(q.port_no, q.queue_id, repr(q.properties)))
self.logger.debug('OFPQueueDescStatsReply received: %s', queues)

JSON Example:

2.5. OpenFlow protocol API Reference 323

ryu Documentation, Release 4.34

(continued from previous page)

}
}
],
"queue_id": 0
}
},
{
"OFPQueueDesc": {
"len": 88,
"port_no": 8,
"properties": [
{
"OFPQueueDescPropMinRate": {
"length": 8,
"rate": 300,
"type": 1
}
},
{
"OFPQueueDescPropMaxRate": {
"length": 8,
"rate": 900,
"type": 2
}
},
{
"OFPQueueDescPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPQueueDescPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPQueueDescPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
(continues on next page)

324 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

],
"queue_id": 1
}
}
],
"flags": 0,
"type": 15
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGroupStatsRequest(datapath, flags=0,

group_id=4294967292,
type_=None)
Group statistics request message
The controller uses this message to query statistics of one or more groups.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
group_id ID of group to read (OFPG_ALL to all groups)

Example:
def send_group_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupStatsRequest(datapath, 0, ofp.OFPG_ALL)

datapath.send_msg(req)

JSON Example:
{
"OFPGroupStatsRequest": {
"flags": 0,
"group_id": 4294967292,
"type": 6
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGroupStatsReply(datapath, type_=None,

**kwargs)
Group statistics reply message
The switch responds with this message to a group statistics request.

Attribute Description
body List of OFPGroupStats instance

Example:
@set_ev_cls(ofp_event.EventOFPGroupStatsReply, MAIN_DISPATCHER)
def group_stats_reply_handler(self, ev):
groups = []
for stat in ev.msg.body:
(continues on next page)

2.5. OpenFlow protocol API Reference 325

ryu Documentation, Release 4.34

(continued from previous page)

groups.append('length=%d group_id=%d '
'ref_count=%d packet_count=%d byte_count=%d '
'duration_sec=%d duration_nsec=%d' %
(stat.length, stat.group_id,
stat.ref_count, stat.packet_count,
stat.byte_count, stat.duration_sec,
stat.duration_nsec))
self.logger.debug('GroupStats: %s', groups)

JSON Example:

{
"OFPGroupStatsReply": {
"body": [
{
"OFPGroupStats": {
"bucket_stats": [
{
"OFPBucketCounter": {
"byte_count": 2345,
"packet_count": 234
}
}
],
"byte_count": 12345,
"duration_nsec": 609036000,
"duration_sec": 9,
"group_id": 1,
"length": 56,
"packet_count": 123,
"ref_count": 2
}
}
],
"flags": 0,
"type": 6
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGroupDescStatsRequest(datapath,
flags=0,
type_=None)
Group description request message
The controller uses this message to list the set of groups on a switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_group_desc_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

(continues on next page)

326 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

req = ofp_parser.OFPGroupDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:
{
"OFPGroupDescStatsRequest": {
"flags": 0,
"type": 7
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGroupDescStatsReply(datapath,
type_=None,
**kwargs)
Group description reply message
The switch responds with this message to a group description request.

Attribute Description
body List of OFPGroupDescStats instance

Example:
@set_ev_cls(ofp_event.EventOFPGroupDescStatsReply, MAIN_DISPATCHER)
def group_desc_stats_reply_handler(self, ev):
descs = []
for stat in ev.msg.body:
descs.append('length=%d type=%d group_id=%d '
'buckets=%s' %
(stat.length, stat.type, stat.group_id,
stat.bucket))
self.logger.debug('GroupDescStats: %s', descs)

JSON Example:
{
"OFPGroupDescStatsReply": {
"body": [
{
"OFPGroupDescStats": {
"buckets": [
{
"OFPBucket": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 2,
"type": 0
}
}
],
"len": 32,
"watch_group": 1,
(continues on next page)

2.5. OpenFlow protocol API Reference 327

ryu Documentation, Release 4.34

(continued from previous page)

"watch_port": 1,
"weight": 1
}
}
],
"group_id": 1,
"length": 40,
"type": 0
}
}
],
"flags": 0,
"type": 7
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGroupFeaturesStatsRequest(datapath,
flags=0,
type_=None)
Group features request message
The controller uses this message to list the capabilities of groups on a switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_group_features_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupFeaturesStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPGroupFeaturesStatsRequest": {
"flags": 0,
"type": 8
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGroupFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Group features reply message
The switch responds with this message to a group features request.

Attribute Description
body Instance of OFPGroupFeaturesStats

Example:

328 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPGroupFeaturesStatsReply, MAIN_DISPATCHER)
def group_features_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('GroupFeaturesStats: types=%d '

'capabilities=0x%08x max_groups=%s '
'actions=%s',
body.types, body.capabilities,
body.max_groups, body.actions)

JSON Example:

class ryu.ofproto.ofproto_v1_4_parser.OFPMeterStatsRequest(datapath, flags=0, me-

ter_id=4294967295,
type_=None)
Meter statistics request message
The controller uses this message to query statistics for one or more meters.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
meter_id ID of meter to read (OFPM_ALL to all meters)

Example:

def send_meter_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterStatsRequest(datapath, 0, ofp.OFPM_ALL)

datapath.send_msg(req)

2.5. OpenFlow protocol API Reference 329

ryu Documentation, Release 4.34

JSON Example:

{
"OFPMeterStatsRequest": {
"flags": 0,
"meter_id": 4294967295,
"type": 9
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPMeterStatsReply(datapath, type_=None,

**kwargs)
Meter statistics reply message
The switch responds with this message to a meter statistics request.

Attribute Description
body List of OFPMeterStats instance

Example:

JSON Example:

330 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
}
],
"flags": 0,
"type": 9
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPMeterConfigStatsRequest(datapath,
flags=0, me-
ter_id=4294967295,
type_=None)
Meter configuration statistics request message
The controller uses this message to query configuration for one or more meters.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
meter_id ID of meter to read (OFPM_ALL to all meters)

Example:
def send_meter_config_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterConfigStatsRequest(datapath, 0,
ofp.OFPM_ALL)
datapath.send_msg(req)

JSON Example:
{
"OFPMeterConfigStatsRequest": {
"flags": 0,
"meter_id": 4294967295,
"type": 10
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPMeterConfigStatsReply(datapath,
type_=None,
**kwargs)
Meter configuration statistics reply message
The switch responds with this message to a meter configuration statistics request.

Attribute Description
body List of OFPMeterConfigStats instance

Example:
@set_ev_cls(ofp_event.EventOFPMeterConfigStatsReply, MAIN_DISPATCHER)
def meter_config_stats_reply_handler(self, ev):
configs = []
(continues on next page)

2.5. OpenFlow protocol API Reference 331

ryu Documentation, Release 4.34

(continued from previous page)

for stat in ev.msg.body:
configs.append('length=%d flags=0x%04x meter_id=0x%08x '
'bands=%s' %
(stat.length, stat.flags, stat.meter_id,
stat.bands))
self.logger.debug('MeterConfigStats: %s', configs)

JSON Example:

{
"OFPMeterConfigStatsReply": {
"body": [
{
"OFPMeterConfigStats": {
"bands": [
{
"OFPMeterBandDrop": {
"burst_size": 10,
"len": 16,
"rate": 1000,
"type": 1
}
}
],
"flags": 14,
"length": 24,
"meter_id": 100
}
}
],
"flags": 0,
"type": 10
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPMeterFeaturesStatsRequest(datapath,
flags=0,
type_=None)
Meter features statistics request message
The controller uses this message to query the set of features of the metering subsystem.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_meter_features_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterFeaturesStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

332 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

{
"OFPMeterFeaturesStatsRequest": {
"flags": 0,
"type": 11
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPMeterFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Meter features statistics reply message
The switch responds with this message to a meter features statistics request.

Attribute Description
body List of OFPMeterFeaturesStats instance

Example:

JSON Example:

2.5. OpenFlow protocol API Reference 333

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_4_parser.OFPFlowMonitorRequest(datapath, flags=0,

monitor_id=0,
out_port=4294967295,
out_group=4294967295,
monitor_flags=0,
table_id=255,
command=0,
match=None,
type_=None)
Flow monitor request message
The controller uses this message to query flow monitors.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
monitor_id Controller-assigned ID for this monitor
out_port Require matching entries to include this as an output
port
out_group Require matching entries to include this as an output
group
monitor_flags Bitmap of the following flags.

OFPFMF_INITIAL
OFPFMF_ADD
OFPFMF_REMOVED
OFPFMF_MODIFY
OFPFMF_INSTRUCTIONS
OFPFMF_NO_ABBREV
OFPFMF_ONLY_OWN

table_id ID of table to monitor

command One of the following values.

OFPFMC_ADD
OFPFMC_MODIFY
OFPFMC_DELETE

match Instance of OFPMatch

Example:

def send_flow_monitor_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

monitor_flags = [ofp.OFPFMF_INITIAL, ofp.OFPFMF_ONLY_OWN]

match = ofp_parser.OFPMatch(in_port=1)
req = ofp_parser.OFPFlowMonitorRequest(datapath, 0, 10000,
ofp.OFPP_ANY, ofp.OFPG_ANY,
monitor_flags,
ofp.OFPTT_ALL,
ofp.OFPFMC_ADD, match)
datapath.send_msg(req)

334 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

JSON Example:
{
"OFPFlowMonitorRequest": {
"command": 0,
"flags": 0,
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"monitor_flags": 15,
"monitor_id": 100000000,
"out_group": 4294967295,
"out_port": 22,
"table_id": 33,
"type": 16
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPFlowMonitorReply(datapath, type_=None,

**kwargs)
Flow monitor reply message
The switch responds with this message to a flow monitor request.

Attribute Description
body List of list of the following class instance.

OFPFlowMonitorFull
OFPFlowMonitorAbbrev
OFPFlowMonitorPaused

Example:
@set_ev_cls(ofp_event.EventOFPFlowMonitorReply, MAIN_DISPATCHER)
def flow_monitor_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto
flow_updates = []

for update in msg.body:

update_str = 'length=%d event=%d' %
(update.length, update.event)
if (update.event == ofp.OFPFME_INITIAL or
(continues on next page)

2.5. OpenFlow protocol API Reference 335

ryu Documentation, Release 4.34

(continued from previous page)

update.event == ofp.OFPFME_ADDED or
update.event == ofp.OFPFME_REMOVED or
update.event == ofp.OFPFME_MODIFIED):
update_str += 'table_id=%d reason=%d idle_timeout=%d '
'hard_timeout=%d priority=%d cookie=%d '
'match=%d instructions=%s' %
(update.table_id, update.reason,
update.idle_timeout, update.hard_timeout,
update.priority, update.cookie,
update.match, update.instructions)
elif update.event == ofp.OFPFME_ABBREV:
update_str += 'xid=%d' % (update.xid)
flow_updates.append(update_str)
self.logger.debug('FlowUpdates: %s', flow_updates)

JSON Example:
{
"OFPFlowMonitorReply": {
"body": [
{
"OFPFlowUpdateFull": {
"cookie": 0,
"event": 0,
"hard_timeout": 700,
"idle_timeout": 600,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 0,
"port": 4294967290,
"type": 0
}
}
],
"len": 24,
"type": 4
}
}
],
"length": 64,
"match": {
"OFPMatch": {
"length": 10,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
}
],
(continues on next page)

336 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"type": 1
}
},
"priority": 3,
"reason": 0,
"table_id": 0
}
},
{
"OFPFlowUpdateAbbrev": {
"event": 4,
"length": 8,
"xid": 1234
}
},
{
"OFPFlowUpdatePaused": {
"event": 5,
"length": 8
}
}
],
"flags": 0,
"type": 16
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPExperimenterStatsRequest(datapath,
flags, ex-
perimenter,
exp_type,
data,
type_=None)
Experimenter multipart request message

Attribute Description
flags Zero or OFPMPF_REQ_MORE
experimenter Experimenter ID
exp_type Experimenter defined
data Experimenter defined additional data

JSON Example:

{
"OFPExperimenterStatsRequest": {
"data": "aG9nZWhvZ2U=",
"exp_type": 3405678728,
"experimenter": 3735928495,
"flags": 0,
"type": 65535
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPExperimenterStatsReply(datapath,
type_=None,
**kwargs)

2.5. OpenFlow protocol API Reference 337

ryu Documentation, Release 4.34

Experimenter multipart reply message

Attribute Description
body An OFPExperimenterMultipart instance

JSON Example:

{
"OFPExperimenterStatsReply": {
"body": {
"OFPExperimenterMultipart": {
"data": "dGVzdGRhdGE5OTk5OTk5OQ==",
"exp_type": 3405674359,
"experimenter": 3735928495
}
},
"flags": 0,
"type": 65535
}
}

Packet-Out Message

class ryu.ofproto.ofproto_v1_4_parser.OFPPacketOut(datapath, buffer_id=None,

in_port=None, actions=None,
data=None, actions_len=None)
Packet-Out message
The controller uses this message to send a packet out throught the switch.

Example:

def send_packet_out(self, datapath, buffer_id, in_port):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

actions = [ofp_parser.OFPActionOutput(ofp.OFPP_FLOOD, 0)]

req = ofp_parser.OFPPacketOut(datapath, buffer_id,
in_port, actions)
datapath.send_msg(req)

JSON Example:

{
"OFPPacketOut": {
"actions": [
{
"OFPActionOutput": {
(continues on next page)

338 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"len": 16,
"max_len": 65535,
"port": 4294967292,
"type": 0
}
}
],
"actions_len": 16,
"buffer_id": 4294967295,
"data":
˓→"8guk0D9w8gukffjqCABFAABU+BoAAP8Br4sKAAABCgAAAggAAgj3YAAAMdYCAAAAAACrjS0xAAAAABAREhMUFRYXGBkaG

˓→",

"in_port": 4294967293
}
}

Barrier Message

class ryu.ofproto.ofproto_v1_4_parser.OFPBarrierRequest(datapath)
Barrier request message
The controller sends this message to ensure message dependencies have been met or receive notifications for
completed operations.
Example:

def send_barrier_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPBarrierRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPBarrierRequest": {}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPBarrierReply(datapath)
Barrier reply message
The switch responds with this message to a barrier request.
Example:

@set_ev_cls(ofp_event.EventOFPBarrierReply, MAIN_DISPATCHER)
def barrier_reply_handler(self, ev):
self.logger.debug('OFPBarrierReply received')

JSON Example:

{
"OFPBarrierReply": {}
}

2.5. OpenFlow protocol API Reference 339

ryu Documentation, Release 4.34

Role Request Message

class ryu.ofproto.ofproto_v1_4_parser.OFPRoleRequest(datapath, role=None, genera-

tion_id=None)
Role request message
The controller uses this message to change its role.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

generation_id Master Election Generation ID

Example:

def send_role_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPRoleRequest(datapath, ofp.OFPCR_ROLE_EQUAL, 0)

datapath.send_msg(req)

JSON Example:

{
"OFPRoleRequest": {
"generation_id": 17294086455919964160,
"role": 2
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPRoleReply(datapath, role=None, genera-

tion_id=None)
Role reply message
The switch responds with this message to a role request.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

generation_id Master Election Generation ID

Example:

340 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPRoleReply, MAIN_DISPATCHER)
def role_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

self.logger.debug('OFPRoleReply received: '

'role=%s generation_id=%d',
role, msg.generation_id)

JSON Example:

{
"OFPRoleReply": {
"generation_id": 17294086455919964160,
"role": 3
}
}

Bundle Messages

class ryu.ofproto.ofproto_v1_4_parser.OFPBundleCtrlMsg(datapath, bundle_id=None,

type_=None, flags=None,
properties=None)
Bundle control message
The controller uses this message to create, destroy and commit bundles

2.5. OpenFlow protocol API Reference 341

ryu Documentation, Release 4.34

Attribute Description
bundle_id Id of the bundle
type One of the following values.

OFPBCT_OPEN_REQUEST
OFPBCT_OPEN_REPLY
OFPBCT_CLOSE_REQUEST
OFPBCT_CLOSE_REPLY
OFPBCT_COMMIT_REQUEST
OFPBCT_COMMIT_REPLY
OFPBCT_DISCARD_REQUEST
OFPBCT_DISCARD_REPLY

flags Bitmap of the following flags.

OFPBF_ATOMIC
OFPBF_ORDERED

properties List of OFPBundleProp subclass instance

Example:
def send_bundle_control(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPBundleCtrlMsg(datapath, 7,
ofp.OFPBCT_OPEN_REQUEST,
ofp.OFPBF_ATOMIC, [])
datapath.send_msg(req)

JSON Example:
{
"OFPBundleCtrlMsg": {
"bundle_id": 1234,
"flags": 1,
"properties": [
{
"OFPBundlePropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPBundlePropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
(continues on next page)

342 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"length": 16,
"type": 65535
}
},
{
"OFPBundlePropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"type": 0
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPBundleAddMsg(datapath, bundle_id, flags,

message, properties)
Bundle add message
The controller uses this message to add a message to a bundle

Attribute Description
bundle_id Id of the bundle
flags Bitmap of the following flags.

OFPBF_ATOMIC
OFPBF_ORDERED

message MsgBase subclass instance

properties List of OFPBundleProp subclass instance

Example:

def send_bundle_add_message(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

msg = ofp_parser.OFPRoleRequest(datapath, ofp.OFPCR_ROLE_EQUAL, 0)

req = ofp_parser.OFPBundleAddMsg(datapath, 7, ofp.OFPBF_ATOMIC,

msg, [])
datapath.send_msg(req)

JSON Example:

{
"OFPBundleAddMsg": {
"bundle_id": 1234,
"flags": 1,
(continues on next page)

2.5. OpenFlow protocol API Reference 343

ryu Documentation, Release 4.34

(continued from previous page)

"message": {
"OFPEchoRequest": {
"data": null
}
},
"properties": [
{
"OFPBundlePropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPBundlePropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPBundlePropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
]
}
}

Set Asynchronous Configuration Message

class ryu.ofproto.ofproto_v1_4_parser.OFPSetAsync(datapath, properties=None)

Set asynchronous configuration message
The controller sends this message to set the asynchronous messages that it wants to receive on a given OpneFlow
channel.

Attribute Description
properties List of OFPAsyncConfigProp subclass instances

Example:

344 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_set_async(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

properties = [
ofp_parser.OFPAsyncConfigPropReasons(
ofp.OFPACPT_PACKET_IN_SLAVE, 8,
(1 << ofp.OFPR_APPLY_ACTION
| 1 << ofp.OFPR_INVALID_TTL))]
req = ofp_parser.OFPSetAsync(datapath, properties)
datapath.send_msg(req)

JSON Example:

{
"OFPSetAsync": {
"properties": [
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 0
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 1
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 2
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 3
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 4
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 5
(continues on next page)

2.5. OpenFlow protocol API Reference 345

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 6
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 7
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 8
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 9
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 10
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 11
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65534
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [
1
(continues on next page)

346 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
]
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGetAsyncRequest(datapath)
Get asynchronous configuration request message
The controller uses this message to query the asynchronous message.
Example:

def send_get_async_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetAsyncRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPGetAsyncRequest": {}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPGetAsyncReply(datapath, properties=None)

Get asynchronous configuration reply message
The switch responds with this message to a get asynchronous configuration request.

Attribute Description
properties List of OFPAsyncConfigProp subclass instances

Example:

@set_ev_cls(ofp_event.EventOFPGetAsyncReply, MAIN_DISPATCHER)
def get_async_reply_handler(self, ev):
msg = ev.msg

(continues on next page)

2.5. OpenFlow protocol API Reference 347

ryu Documentation, Release 4.34

(continued from previous page)

self.logger.debug('OFPGetAsyncReply received: '
'properties=%s', repr(msg.properties))

JSON Example:
{
"OFPGetAsyncReply": {
"properties": [
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 0
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 1
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 2
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 3
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 4
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 5
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 6
}
},
(continues on next page)

348 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 7
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 8
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 9
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 10
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 11
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65534
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPAsyncConfigPropExperimenter": {
(continues on next page)

2.5. OpenFlow protocol API Reference 349

ryu Documentation, Release 4.34

(continued from previous page)

"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
]
}
}

Asynchronous Messages

Packet-In Message

class ryu.ofproto.ofproto_v1_4_parser.OFPPacketIn(datapath, buffer_id=None, to-

tal_len=None, reason=None,
table_id=None, cookie=None,
match=None, data=None)
Packet-In message
The switch sends the packet that received to the controller by this message.

Attribute Description
buffer_id ID assigned by datapath
total_len Full length of frame
reason Reason packet is being sent.

OFPR_TABLE_MISS
OFPR_APPLY_ACTION
OFPR_INVALID_TTL
OFPR_ACTION_SET
OFPR_GROUP
OFPR_PACKET_OUT

table_id ID of the table that was looked up

cookie Cookie of the flow entry that was looked up
match Instance of OFPMatch
data Ethernet frame

Example:

@set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
def packet_in_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

(continues on next page)

350 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

if msg.reason == ofp.TABLE_MISS:
reason = 'TABLE MISS'
elif msg.reason == ofp.OFPR_APPLY_ACTION:
reason = 'APPLY ACTION'
elif msg.reason == ofp.OFPR_INVALID_TTL:
reason = 'INVALID TTL'
elif msg.reason == ofp.OFPR_ACTION_SET:
reason = 'ACTION SET'
elif msg.reason == ofp.OFPR_GROUP:
reason = 'GROUP'
elif msg.reason == ofp.OFPR_PACKET_OUT:
reason = 'PACKET OUT'
else:
reason = 'unknown'

self.logger.debug('OFPPacketIn received: '

'buffer_id=%x total_len=%d reason=%s '
'table_id=%d cookie=%d match=%s data=%s',
msg.buffer_id, msg.total_len, reason,
msg.table_id, msg.cookie, msg.match,
utils.hex_array(msg.data))

2.5. OpenFlow protocol API Reference 351

ryu Documentation, Release 4.34

(continued from previous page)

"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "arp_op",
"mask": null,
"value": 1
}
},
{
"OXMTlv": {
"field": "arp_spa",
"mask": null,
"value": "10.0.0.1"
}
},
{
"OXMTlv": {
"field": "arp_tpa",
"mask": null,
"value": "10.0.0.3"
}
},
{
"OXMTlv": {
"field": "arp_sha",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "arp_tha",
"mask": null,
"value": "00:00:00:00:00:00"
}
}
],
"type": 1
}
},
"reason": 3,
"table_id": 1,
"total_len": 42
}
}

{
"OFPPacketIn": {
"buffer_id": 4026531840,
"cookie": 283686884868096,
"data": "",
"match": {
"OFPMatch": {
(continues on next page)

352 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"length": 329,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 84281096
}
},
{
"OXMTlv": {
"field": "in_phy_port",
"mask": null,
"value": 16909060
}
},
{
"OXMTlv": {
"field": "metadata",
"mask": null,
"value": 283686952306183
}
},
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2054
}
},
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "ff:ff:ff:ff:ff:ff"
}
},
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 999
}
},
{
"OXMTlv": {
"field": "ip_dscp",
"mask": null,
"value": 9
}
(continues on next page)

2.5. OpenFlow protocol API Reference 353

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OXMTlv": {
"field": "ip_ecn",
"mask": null,
"value": 3
}
},
{
"OXMTlv": {
"field": "ip_proto",
"mask": null,
"value": 99
}
},
{
"OXMTlv": {
"field": "ipv4_src",
"mask": null,
"value": "1.2.3.4"
}
},
{
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "1.2.3.4"
}
},
{
"OXMTlv": {
"field": "tcp_src",
"mask": null,
"value": 8080
}
},
{
"OXMTlv": {
"field": "tcp_dst",
"mask": null,
"value": 18080
}
},
{
"OXMTlv": {
"field": "udp_src",
"mask": null,
"value": 28080
}
},
{
"OXMTlv": {
"field": "udp_dst",
"mask": null,
"value": 55936
}
},
(continues on next page)

354 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OXMTlv": {
"field": "sctp_src",
"mask": null,
"value": 48080
}
},
{
"OXMTlv": {
"field": "sctp_dst",
"mask": null,
"value": 59328
}
},
{
"OXMTlv": {
"field": "icmpv4_type",
"mask": null,
"value": 100
}
},
{
"OXMTlv": {
"field": "icmpv4_code",
"mask": null,
"value": 101
}
},
{
"OXMTlv": {
"field": "arp_op",
"mask": null,
"value": 1
}
},
{
"OXMTlv": {
"field": "arp_spa",
"mask": null,
"value": "10.0.0.1"
}
},
{
"OXMTlv": {
"field": "arp_tpa",
"mask": null,
"value": "10.0.0.3"
}
},
{
"OXMTlv": {
"field": "arp_sha",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
},
{
(continues on next page)

2.5. OpenFlow protocol API Reference 355

ryu Documentation, Release 4.34

(continued from previous page)

"OXMTlv": {
"field": "arp_tha",
"mask": null,
"value": "00:00:00:00:00:00"
}
},
{
"OXMTlv": {
"field": "ipv6_src",
"mask": null,
"value": "fe80::f00b:a4ff:fe48:28a5"
}
},
{
"OXMTlv": {
"field": "ipv6_dst",
"mask": null,
"value": "fe80::f00b:a4ff:fe05:b7dc"
}
},
{
"OXMTlv": {
"field": "ipv6_flabel",
"mask": null,
"value": 541473
}
},
{
"OXMTlv": {
"field": "icmpv6_type",
"mask": null,
"value": 200
}
},
{
"OXMTlv": {
"field": "icmpv6_code",
"mask": null,
"value": 201
}
},
{
"OXMTlv": {
"field": "ipv6_nd_target",
"mask": null,
"value": "fe80::a60:6eff:fe7f:74e7"
}
},
{
"OXMTlv": {
"field": "ipv6_nd_sll",
"mask": null,
"value": "00:00:00:00:02:9a"
}
},
{
"OXMTlv": {
(continues on next page)

356 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"field": "ipv6_nd_tll",
"mask": null,
"value": "00:00:00:00:02:2b"
}
},
{
"OXMTlv": {
"field": "mpls_label",
"mask": null,
"value": 624485
}
},
{
"OXMTlv": {
"field": "mpls_tc",
"mask": null,
"value": 5
}
},
{
"OXMTlv": {
"field": "mpls_bos",
"mask": null,
"value": 1
}
},
{
"OXMTlv": {
"field": "pbb_isid",
"mask": null,
"value": 11259375
}
},
{
"OXMTlv": {
"field": "tunnel_id",
"mask": null,
"value": 651061555542690057
}
},
{
"OXMTlv": {
"field": "ipv6_exthdr",
"mask": null,
"value": 500
}
},
{
"OXMTlv": {
"field": "pbb_uca",
"mask": null,
"value": 1
}
}
],
"type": 1
}
(continues on next page)

2.5. OpenFlow protocol API Reference 357

ryu Documentation, Release 4.34

(continued from previous page)

},
"reason": 0,
"table_id": 200,
"total_len": 0
}
}

Flow Removed Message

class ryu.ofproto.ofproto_v1_4_parser.OFPFlowRemoved(datapath, cookie=None,

Attribute Description
cookie Opaque controller-issued identifier
priority Priority level of flow entry
reason One of the following values.

OFPRR_IDLE_TIMEOUT
OFPRR_HARD_TIMEOUT
OFPRR_DELETE
OFPRR_GROUP_DELETE
OFPRR_METER_DELETE
OFPRR_EVICTION

table_id ID of the table

Example:
@set_ev_cls(ofp_event.EventOFPFlowRemoved, MAIN_DISPATCHER)
def flow_removed_handler(self, ev):
msg = ev.msg
dp = msg.datapath
(continues on next page)

358 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

ofp = dp.ofproto

self.logger.debug('OFPFlowRemoved received: '

JSON Example:

{
"OFPFlowRemoved": {
"byte_count": 86,
"cookie": 0,
"duration_nsec": 48825000,
"duration_sec": 3,
"hard_timeout": 0,
"idle_timeout": 3,
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"packet_count": 1,
"priority": 65535,
"reason": 0,
"table_id": 0
}
}

2.5. OpenFlow protocol API Reference 359

ryu Documentation, Release 4.34

Port Status Message

class ryu.ofproto.ofproto_v1_4_parser.OFPPortStatus(datapath, reason=None,

desc=None)
Port status message
The switch notifies controller of change of ports.

Attribute Description
reason One of the following values.

OFPPR_ADD
OFPPR_DELETE
OFPPR_MODIFY

desc instance of OFPPort

Example:

@set_ev_cls(ofp_event.EventOFPPortStatus, MAIN_DISPATCHER)
def port_status_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPPR_ADD:
reason = 'ADD'
elif msg.reason == ofp.OFPPR_DELETE:
reason = 'DELETE'
elif msg.reason == ofp.OFPPR_MODIFY:
reason = 'MODIFY'
else:
reason = 'unknown'

self.logger.debug('OFPPortStatus received: reason=%s desc=%s',

reason, msg.desc)

JSON Example:

360 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"peer": 10248,
"supported": 10248,
"type": 0
}
},
{
"OFPPortDescPropOptical": {
"length": 40,
"rx_grid_freq_lmda": 1500,
"rx_max_freq_lmda": 2000,
"rx_min_freq_lmda": 1000,
"supported": 1,
"tx_grid_freq_lmda": 1500,
"tx_max_freq_lmda": 2000,
"tx_min_freq_lmda": 1000,
"tx_pwr_max": 2000,
"tx_pwr_min": 1000,
"type": 1
}
},
{
"OFPPortDescPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPPortDescPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPPortDescPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"state": 4
}
},
"reason": 0
(continues on next page)

2.5. OpenFlow protocol API Reference 361

ryu Documentation, Release 4.34

(continued from previous page)

}
}

Controller Role Status Message

class ryu.ofproto.ofproto_v1_4_parser.OFPRoleStatus(datapath, role=None, rea-

son=None, generation_id=None,
properties=None)
Role status message
The switch notifies controller of change of role.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER

reason One of the following values.

OFPCRR_MASTER_REQUEST
OFPCRR_CONFIG
OFPCRR_EXPERIMENTER

generation_id Master Election Generation ID

properties List of OFPRoleProp subclass instance

Example:

@set_ev_cls(ofp_event.EventOFPRoleStatus, MAIN_DISPATCHER)
def role_status_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.role == ofp.OFPCR_ROLE_NOCHANGE:
role = 'ROLE NOCHANGE'
elif msg.role == ofp.OFPCR_ROLE_EQUAL:
role = 'ROLE EQUAL'
elif msg.role == ofp.OFPCR_ROLE_MASTER:
role = 'ROLE MASTER'
else:
role = 'unknown'

if msg.reason == ofp.OFPCRR_MASTER_REQUEST:
reason = 'MASTER REQUEST'
elif msg.reason == ofp.OFPCRR_CONFIG:
reason = 'CONFIG'
elif msg.reason == ofp.OFPCRR_EXPERIMENTER:
reason = 'EXPERIMENTER'
else:
(continues on next page)

362 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

reason = 'unknown'

self.logger.debug('OFPRoleStatus received: role=%s reason=%s '

'generation_id=%d properties=%s', role, reason,
msg.generation_id, repr(msg.properties))

JSON Example:

{
"OFPRoleStatus": {
"generation_id": 7,
"properties": [
{
"OFPRolePropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPRolePropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPRolePropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"reason": 0,
"role": 2
}
}

Table Status Message

class ryu.ofproto.ofproto_v1_4_parser.OFPTableStatus(datapath, reason=None, ta-

ble=None)
Table status message

2.5. OpenFlow protocol API Reference 363

ryu Documentation, Release 4.34

The switch notifies controller of change of table status.

Attribute Description
reason One of the following values.

OFPTR_VACANCY_DOWN
OFPTR_VACANCY_UP

table OFPTableDesc instance

Example:

@set_ev_cls(ofp_event.EventOFPTableStatus, MAIN_DISPATCHER)
def table(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPTR_VACANCY_DOWN:
reason = 'VACANCY_DOWN'
elif msg.reason == ofp.OFPTR_VACANCY_UP:
reason = 'VACANCY_UP'
else:
reason = 'unknown'

self.logger.debug('OFPTableStatus received: reason=%s '

'table_id=%d config=0x%08x properties=%s',
reason, msg.table.table_id, msg.table.config,
repr(msg.table.properties))

JSON Example:

{
"OFPTableStatus": {
"reason": 3,
"table": {
"OFPTableDesc": {
"config": 0,
"length": 80,
"properties": [
{
"OFPTableModPropEviction": {
"flags": 0,
"length": 8,
"type": 2
}
},
{
"OFPTableModPropVacancy": {
"length": 8,
"type": 3,
"vacancy": 0,
"vacancy_down": 0,
"vacancy_up": 0
}
},
(continues on next page)

364 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPTableModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"table_id": 8
}
}
}
}

Request Forward Message

class ryu.ofproto.ofproto_v1_4_parser.OFPRequestForward(datapath, request=None)

Forwarded request message
The swtich forwards request messages from one controller to other controllers.

Attribute Description
request OFPGroupMod or OFPMeterMod instance

Example:

@set_ev_cls(ofp_event.EventOFPRequestForward, MAIN_DISPATCHER)
def request_forward_handler(self, ev):
msg = ev.msg
(continues on next page)

2.5. OpenFlow protocol API Reference 365

ryu Documentation, Release 4.34

(continued from previous page)

dp = msg.datapath
ofp = dp.ofproto

if msg.request.msg_type == ofp.OFPT_GROUP_MOD:
self.logger.debug(
'OFPRequestForward received: request=OFPGroupMod('
'command=%d, type=%d, group_id=%d, buckets=%s)',
msg.request.command, msg.request.type,
msg.request.group_id, msg.request.buckets)
elif msg.request.msg_type == ofp.OFPT_METER_MOD:
self.logger.debug(
'OFPRequestForward received: request=OFPMeterMod('
'command=%d, flags=%d, meter_id=%d, bands=%s)',
msg.request.command, msg.request.flags,
msg.request.meter_id, msg.request.bands)
else:
self.logger.debug(
'OFPRequestForward received: request=Unknown')

JSON Example:

{
"OFPRequestForward": {
"request": {
"OFPGroupMod": {
"buckets": [
{
"OFPBucket": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 2,
"type": 0
}
}
],
"len": 32,
"watch_group": 1,
"watch_port": 1,
"weight": 1
}
}
],
"command": 0,
"group_id": 1,
"type": 0
}
}
}
}

Symmetric Messages

366 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Hello

class ryu.ofproto.ofproto_v1_4_parser.OFPHello(datapath, elements=None)

Hello message
When connection is started, the hello message is exchanged between a switch and a controller.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
elements list of OFPHelloElemVersionBitmap instance

JSON Example:

{
"OFPHello": {
"elements": [
{
"OFPHelloElemVersionBitmap": {
"length": 8,
"type": 1,
"versions": [
1,
2,
3,
9,
10,
30
]
}
}
]
}
}

class ryu.ofproto.ofproto_v1_4_parser.OFPHelloElemVersionBitmap(versions,
type_=None,
length=None)
Version bitmap Hello Element

Attribute Description
versions list of versions of OpenFlow protocol a device supports

Echo Request

class ryu.ofproto.ofproto_v1_4_parser.OFPEchoRequest(datapath, data=None)

Echo request message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data

Example:

2.5. OpenFlow protocol API Reference 367

ryu Documentation, Release 4.34

def send_echo_request(self, datapath, data):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPEchoRequest(datapath, data)

datapath.send_msg(req)

JSON Example:

{
"OFPEchoRequest": {
"data": "aG9nZQ=="
}
}

Echo Reply

class ryu.ofproto.ofproto_v1_4_parser.OFPEchoReply(datapath, data=None)

Echo reply message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data

Example:

def send_echo_reply(self, datapath, data):

ofp_parser = datapath.ofproto_parser

reply = ofp_parser.OFPEchoReply(datapath, data)

datapath.send_msg(reply)

JSON Example:

{
"OFPEchoReply": {
"data": "aG9nZQ=="
}
}

368 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Error Message

class ryu.ofproto.ofproto_v1_4_parser.OFPErrorMsg(datapath, type_=None, code=None,

data=None, **kwargs)
Error message
The switch notifies controller of problems by this message.

Attribute Description
type High level type of error
code Details depending on the type
data Variable length data depending on the type and code

type attribute corresponds to type_ parameter of init.

Types and codes are defined in ryu.ofproto.ofproto.

If type == OFPET_EXPERIMENTER, this message has also the following attributes.

Attribute Description
exp_type Experimenter defined type
experimenter Experimenter ID

Example:

@set_ev_cls(ofp_event.EventOFPErrorMsg,
[HANDSHAKE_DISPATCHER, CONFIG_DISPATCHER, MAIN_DISPATCHER])
def error_msg_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPErrorMsg received: type=0x%02x code=0x%02x '

'message=%s',
msg.type, msg.code, utils.hex_array(msg.data))

JSON Example:

2.5. OpenFlow protocol API Reference 369

ryu Documentation, Release 4.34

{
"OFPErrorMsg": {
"code": 11,
"data": "ZnVnYWZ1Z2E=",
"type": 2
}
}

Experimenter

class ryu.ofproto.ofproto_v1_4_parser.OFPExperimenter(datapath, exper-

imenter=None,
exp_type=None, data=None)
Experimenter extension message

Attribute Description
experimenter Experimenter ID
exp_type Experimenter defined
data Experimenter defined arbitrary additional data

JSON Example:

{
"OFPExperimenter": {
"data": "bmF6bw==",
"exp_type": 123456789,
"experimenter": 98765432
}
}

Port Structures

class ryu.ofproto.ofproto_v1_4_parser.OFPPort(port_no=None, length=None,

hw_addr=None, name=None, con-
fig=None, state=None, properties=None)
Description of a port

370 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
port_no Port number and it uniquely identifies a port within a
switch.
length Length of ofp_port (excluding padding).
hw_addr MAC address for the port.
name Null-terminated string containing a human-readable
name for the interface.
config Bitmap of port configration flags.

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

state Bitmap of port state flags.

OFPPS_LINK_DOWN
OFPPS_BLOCKED
OFPPS_LIVE

properties List of OFPPortDescProp subclass instance

Flow Match Structure

class ryu.ofproto.ofproto_v1_4_parser.OFPMatch(type_=None, length=None, _or-

dered_fields=None, **kwargs)
Flow Match Structure
This class is implementation of the flow match structure having compose/query API.
You can define the flow match by the keyword arguments. The following arguments are available.

Argument Value Description

2.5. OpenFlow protocol API Reference 371

ryu Documentation, Release 4.34

Table 3 – continued from previous page

Argument Value Description
sctp_src Integer 16bit SCTP source port
sctp_dst Integer 16bit SCTP destination port
icmpv4_type Integer 8bit ICMP type
icmpv4_code Integer 8bit ICMP code
arp_op Integer 16bit ARP opcode
arp_spa IPv4 address ARP source IPv4 address
arp_tpa IPv4 address ARP target IPv4 address
arp_sha MAC address ARP source hardware address
arp_tha MAC address ARP target hardware address
ipv6_src IPv6 address IPv6 source address
ipv6_dst IPv6 address IPv6 destination address
ipv6_flabel Integer 32bit IPv6 Flow Label
icmpv6_type Integer 8bit ICMPv6 type
icmpv6_code Integer 8bit ICMPv6 code
ipv6_nd_target IPv6 address Target address for ND
ipv6_nd_sll MAC address Source link-layer for ND
ipv6_nd_tll MAC address Target link-layer for ND
mpls_label Integer 32bit MPLS label
mpls_tc Integer 8bit MPLS TC
mpls_bos Integer 8bit MPLS BoS bit
pbb_isid Integer 24bit PBB I-SID
tunnel_id Integer 64bit Logical Port Metadata
ipv6_exthdr Integer 16bit IPv6 Extension Header pseudo-field
pbb_uca Integer 8bit PBB UCA header field
tcp_flags Integer 16bit TCP flags (EXT-109 ONF Extension)
actset_output Integer 32bit Output port from action set metadata (EXT-233 ONF Extension)

Example:

Note: For the list of the supported Nicira experimenter matches, please refer to ryu.ofproto.nx_match.

Note: For VLAN id match field, special values are defined in OpenFlow Spec.
1) Packets with and without a VLAN tag
• Example:

372 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

match = parser.OFPMatch()

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

2) Only packets without a VLAN tag

• Example:

match = parser.OFPMatch(vlan_vid=0x0000)

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) x
VLAN-tagged(vlan_id=5) x

3) Only packets with a VLAN tag regardless of its value

• Example:

match = parser.OFPMatch(vlan_vid=(0x1000, 0x1000))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

4) Only packets with VLAN tag and VID equal

• Example:

match = parser.OFPMatch(vlan_vid=(0x1000 | 3))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) x

Flow Instruction Structures

class ryu.ofproto.ofproto_v1_4_parser.OFPInstructionGotoTable(table_id,
type_=None,
len_=None)
Goto table instruction
This instruction indicates the next table in the processing pipeline.

2.5. OpenFlow protocol API Reference 373

ryu Documentation, Release 4.34

Attribute Description
table_id Next table

class ryu.ofproto.ofproto_v1_4_parser.OFPInstructionWriteMetadata(metadata,
meta-
data_mask,
type_=None,
len_=None)
Write metadata instruction
This instruction writes the masked metadata value into the metadata field.

Attribute Description
metadata Metadata value to write
metadata_mask Metadata write bitmask

class ryu.ofproto.ofproto_v1_4_parser.OFPInstructionActions(type_, ac-

tions=None,
len_=None)
Actions instruction
This instruction writes/applies/clears the actions.

Attribute Description
type One of following values.

OFPIT_WRITE_ACTIONS
OFPIT_APPLY_ACTIONS
OFPIT_CLEAR_ACTIONS

actions list of OpenFlow action class

type attribute corresponds to type_ parameter of init.

class ryu.ofproto.ofproto_v1_4_parser.OFPInstructionMeter(meter_id=1,
type_=None,
len_=None)
Meter instruction
This instruction applies the meter.

Attribute Description
meter_id Meter instance

Action Structures

class ryu.ofproto.ofproto_v1_4_parser.OFPActionOutput(port, max_len=65509,

type_=None, len_=None)
Output action
This action indicates output a packet to the switch port.

374 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
port Output port
max_len Max length to send to controller

class ryu.ofproto.ofproto_v1_4_parser.OFPActionCopyTtlOut(type_=None,
len_=None)
Copy TTL Out action
This action copies the TTL from the next-to-outermost header with TTL to the outermost header with TTL.
class ryu.ofproto.ofproto_v1_4_parser.OFPActionCopyTtlIn(type_=None,
len_=None)
Copy TTL In action
This action copies the TTL from the outermost header with TTL to the next-to-outermost header with TTL.
class ryu.ofproto.ofproto_v1_4_parser.OFPActionSetMplsTtl(mpls_ttl, type_=None,
len_=None)
Set MPLS TTL action
This action sets the MPLS TTL.

Attribute Description
mpls_ttl MPLS TTL

class ryu.ofproto.ofproto_v1_4_parser.OFPActionDecMplsTtl(type_=None,
len_=None)
Decrement MPLS TTL action
This action decrements the MPLS TTL.
class ryu.ofproto.ofproto_v1_4_parser.OFPActionPushVlan(ethertype=33024,
type_=None, len_=None)
Push VLAN action
This action pushes a new VLAN tag to the packet.

Attribute Description
ethertype Ether type. The default is 802.1Q. (0x8100)

class ryu.ofproto.ofproto_v1_4_parser.OFPActionPopVlan(type_=None, len_=None)

Pop VLAN action
This action pops the outermost VLAN tag from the packet.
class ryu.ofproto.ofproto_v1_4_parser.OFPActionPushMpls(ethertype=34887,
type_=None, len_=None)
Push MPLS action
This action pushes a new MPLS header to the packet.

Attribute Description
ethertype Ether type

class ryu.ofproto.ofproto_v1_4_parser.OFPActionPopMpls(ethertype=2048,
type_=None, len_=None)
Pop MPLS action
This action pops the MPLS header from the packet.

2.5. OpenFlow protocol API Reference 375

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_4_parser.OFPActionSetQueue(queue_id, type_=None,

len_=None)
Set queue action
This action sets the queue id that will be used to map a flow to an already-configured queue on a port.

Attribute Description
queue_id Queue ID for the packets

class ryu.ofproto.ofproto_v1_4_parser.OFPActionGroup(group_id=0, type_=None,

len_=None)
Group action
This action indicates the group used to process the packet.

Attribute Description
group_id Group identifier

class ryu.ofproto.ofproto_v1_4_parser.OFPActionSetNwTtl(nw_ttl, type_=None,

len_=None)
Set IP TTL action
This action sets the IP TTL.

Attribute Description
nw_ttl IP TTL

class ryu.ofproto.ofproto_v1_4_parser.OFPActionDecNwTtl(type_=None, len_=None)

Decrement IP TTL action
This action decrements the IP TTL.
class ryu.ofproto.ofproto_v1_4_parser.OFPActionSetField(field=None, **kwargs)
Set field action
This action modifies a header field in the packet.
The set of keywords available for this is same as OFPMatch.
Example:

set_field = OFPActionSetField(eth_src="00:00:00:00:00:00")

class ryu.ofproto.ofproto_v1_4_parser.OFPActionPushPbb(ethertype, type_=None,

len_=None)
Push PBB action
This action pushes a new PBB header to the packet.

Attribute Description
ethertype Ether type

class ryu.ofproto.ofproto_v1_4_parser.OFPActionPopPbb(type_=None, len_=None)

Pop PBB action
This action pops the outermost PBB service instance header from the packet.

376 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_4_parser.OFPActionExperimenter(experimenter)
Experimenter action
This action is an extensible action for the experimenter.

Attribute Description
experimenter Experimenter ID

Note: For the list of the supported Nicira experimenter actions, please refer to ryu.ofproto.nx_actions.

2.5.6 OpenFlow v1.5 Messages and Structures

Controller-to-Switch Messages

Handshake

class ryu.ofproto.ofproto_v1_5_parser.OFPFeaturesRequest(datapath)
Features request message
The controller sends a feature request to the switch upon session establishment.
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.
Example:
def send_features_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPFeaturesRequest(datapath)
datapath.send_msg(req)

JSON Example:
{
"OFPFeaturesRequest": {}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPSwitchFeatures(datapath, data-

(continues on next page)

2.5. OpenFlow protocol API Reference 377

ryu Documentation, Release 4.34

(continued from previous page)

self.logger.debug('OFPSwitchFeatures received: '
'datapath_id=0x%016x n_buffers=%d '
'n_tables=%d auxiliary_id=%d '
'capabilities=0x%08x',
msg.datapath_id, msg.n_buffers, msg.n_tables,
msg.auxiliary_id, msg.capabilities)

JSON Example:
{
"OFPSwitchFeatures": {
"auxiliary_id": 0,
"capabilities": 79,
"datapath_id": 1,
"n_buffers": 255,
"n_tables": 255
}
}

Switch Configuration

class ryu.ofproto.ofproto_v1_5_parser.OFPSetConfig(datapath, flags=0,

miss_send_len=0)
Set config request message
The controller sends a set config request message to set configuraion parameters.

Attribute Description
flags Bitmap of the following flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:
def send_set_config(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPSetConfig(datapath, ofp.OFPC_FRAG_NORMAL, 256)

datapath.send_msg(req)

JSON Example:
{
"OFPSetConfig": {
"flags": 0,
"miss_send_len": 128
}
}

378 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPGetConfigRequest(datapath)
Get config request message
The controller sends a get config request to query configuration parameters in the switch.
Example:

def send_get_config_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetConfigRequest(datapath)
datapath.send_msg(req)

JSON Example:

{
"OFPGetConfigRequest": {}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGetConfigReply(datapath, flags=None,

miss_send_len=None)
Get config reply message
The switch responds to a configuration request with a get config reply message.

Attribute Description
flags Bitmap of the following flags.

OFPC_FRAG_NORMAL
OFPC_FRAG_DROP
OFPC_FRAG_REASM

miss_send_len Max bytes of new flow that datapath should send to

the controller

Example:

@set_ev_cls(ofp_event.EventOFPGetConfigReply, MAIN_DISPATCHER)
def get_config_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto
flags = []

if msg.flags & ofp.OFPC_FRAG_NORMAL:

JSON Example:

2.5. OpenFlow protocol API Reference 379

ryu Documentation, Release 4.34

{
"OFPGetConfigReply": {
"flags": 0,
"miss_send_len": 128
}
}

Modify State Messages

class ryu.ofproto.ofproto_v1_5_parser.OFPTableMod(datapath, table_id, config, proper-

ties)
Flow table configuration message
The controller sends this message to configure table state.

Attribute Description
table_id ID of the table (OFPTT_ALL indicates all tables)
config Bitmap of configuration flags.

OFPTC_EVICTION
OFPTC_VACANCY_EVENTS

properties List of OFPTableModProp subclass instance

Example:

def send_table_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:

{
"OFPTableMod": {
"config": 4,
"properties": [
{
"OFPTableModPropEviction": {
"flags": 2,
"length": 8,
"type": 2
}
}
],
"table_id": 255
}
}

380 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowMod(datapath, cookie=0,

OFPFC_ADD
OFPFC_MODIFY
OFPFC_MODIFY_STRICT
OFPFC_DELETE
OFPFC_DELETE_STRICT

idle_timeout Idle time before discarding (seconds)

OFPFF_SEND_FLOW_REM
OFPFF_CHECK_OVERLAP
OFPFF_RESET_COUNTS
OFPFF_NO_PKT_COUNTS
OFPFF_NO_BYT_COUNTS

importance Eviction precedence

match Instance of OFPMatch
instructions list of OFPInstruction* instance

Example:

def send_flow_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

(continues on next page)

2.5. OpenFlow protocol API Reference 381

ryu Documentation, Release 4.34

(continued from previous page)

cookie = cookie_mask = 0
table_id = 0
idle_timeout = hard_timeout = 0
priority = 32768
buffer_id = ofp.OFP_NO_BUFFER
importance = 0
match = ofp_parser.OFPMatch(in_port=1, eth_dst='ff:ff:ff:ff:ff:ff')
actions = [ofp_parser.OFPActionOutput(ofp.OFPP_NORMAL, 0)]
inst = [ofp_parser.OFPInstructionActions(ofp.OFPIT_APPLY_ACTIONS,
actions)]
req = ofp_parser.OFPFlowMod(datapath, cookie, cookie_mask,
table_id, ofp.OFPFC_ADD,
idle_timeout, hard_timeout,
priority, buffer_id,
ofp.OFPP_ANY, ofp.OFPG_ANY,
ofp.OFPFF_SEND_FLOW_REM,
importance,
match, inst)
datapath.send_msg(req)

JSON Example:
{
"OFPFlowMod": {
"buffer_id": 0,
"command": 0,
"cookie": 1311768467463790320,
"cookie_mask": 18446744073709551615,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 39032,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.9"
}
},
"len": 16,
"type": 25
}
},
{
"NXActionLearn": {
(continues on next page)

382 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"cookie": 0,
"experimenter": 8992,
"fin_hard_timeout": 0,
"fin_idle_timeout": 0,
"flags": 0,
"hard_timeout": 300,
"idle_timeout": 0,
"len": 96,
"priority": 1,
"specs": [
{
"NXFlowSpecMatch": {
"dst": [
"vlan_vid",
0
],
"n_bits": 12,
"src": [
"vlan_vid",
0
]
}
},
{
"NXFlowSpecMatch": {
"dst": [
"eth_dst_nxm",
0
],
"n_bits": 48,
"src": [
"eth_src_nxm",
0
]
}
},
{
"NXFlowSpecLoad": {
"dst": [
"vlan_vid",
0
],
"n_bits": 12,
"src": 0
}
},
{
"NXFlowSpecLoad": {
"dst": [
"tunnel_id_nxm",
0
],
"n_bits": 64,
"src": [
"tunnel_id_nxm",
0
]
(continues on next page)

2.5. OpenFlow protocol API Reference 383

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"NXFlowSpecOutput": {
"dst": "",
"n_bits": 32,
"src": [
"in_port",
0
]
}
}
],
"subtype": 16,
"table_id": 99,
"type": 65535
}
}
],
"len": 128,
"type": 4
}
},
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 100,
"type": 1
}
}
],
"match": {
"OFPMatch": {
"length": 70,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 43981
}
},
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "aa:bb:cc:99:88:77"
}
},
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2048
}
},
{
(continues on next page)

384 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 5095
}
},
{
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.1"
}
},
{
"OXMTlv": {
"field": "tunnel_id",
"mask": null,
"value": 50000
}
},
{
"OXMTlv": {
"field": "tun_ipv4_src",
"mask": null,
"value": "192.168.2.3"
}
},
{
"OXMTlv": {
"field": "tun_ipv4_dst",
"mask": null,
"value": "192.168.2.4"
}
}
],
"type": 1
}
},
"out_group": 0,
"out_port": 0,
"priority": 0,
"table_id": 2
}
}

2.5. OpenFlow protocol API Reference 385

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPInstructionActions": {
"actions": [
{
"NXActionConjunction": {
"clause": 1,
"experimenter": 8992,
"id": 11259375,
"len": 16,
"n_clauses": 2,
"subtype": 34,
"type": 65535
}
}
],
"len": 24,
"type": 4
}
}
],
"match": {
"OFPMatch": {
"length": 70,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 43981
}
},
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "aa:bb:cc:99:88:77"
}
},
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2048
}
},
{
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 5095
}
},
{
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.1"
(continues on next page)

386 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OXMTlv": {
"field": "tunnel_id",
"mask": null,
"value": 50000
}
},
{
"OXMTlv": {
"field": "tun_ipv4_src",
"mask": null,
"value": "192.168.2.3"
}
},
{
"OXMTlv": {
"field": "tun_ipv4_dst",
"mask": null,
"value": "192.168.2.4"
}
}
],
"type": 1
}
},
"out_group": 0,
"out_port": 0,
"priority": 0,
"table_id": 4
}
}

{
"OFPFlowMod": {
"buffer_id": 0,
"command": 0,
"cookie": 1311768467463790320,
"cookie_mask": 18446744073709551615,
"flags": 0,
"hard_timeout": 0,
"idle_timeout": 0,
"importance": 39032,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionSetField": {
(continues on next page)

2.5. OpenFlow protocol API Reference 387

ryu Documentation, Release 4.34

(continued from previous page)

"field": {
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.9"
}
},
"len": 16,
"type": 25
}
}
],
"len": 32,
"type": 4
}
},
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 100,
"type": 1
}
}
],
"match": {
"OFPMatch": {
"length": 12,
"oxm_fields": [
{
"OXMTlv": {
"field": "conj_id",
"mask": null,
"value": 11259375
}
}
],
"type": 1
}
},
"out_group": 0,
"out_port": 0,
"priority": 0,
"table_id": 3
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGroupMod(datapath, command=0,

type_=0, group_id=0, com-
mand_bucket_id=4294967295,
buckets=None, properties=None,
bucket_array_len=None)
Modify group entry message
The controller sends this message to modify the group table.

388 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
command One of the following values.

OFPGC_ADD
OFPGC_MODIFY
OFPGC_DELETE
OFPGC_INSERT_BUCKET
OFPGC_REMOVE_BUCKET

type One of the following values.

OFPGT_ALL
OFPGT_SELECT
OFPGT_INDIRECT
OFPGT_FF

group_id Group identifier.

command_bucket_id Bucket Id used as part of OF-
PGC_INSERT_BUCKET and OF-
PGC_REMOVE_BUCKET commands execution.
buckets List of OFPBucket instance
properties List of OFPGroupProp instance

type attribute corresponds to type_ parameter of init.

Example:
def send_group_mod(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

port = 1
max_len = 2000
actions = [ofp_parser.OFPActionOutput(port, max_len)]

weight = 100
watch_port = 0
watch_group = 0
buckets = [ofp_parser.OFPBucket(weight, watch_port, watch_group,
actions)]

group_id = 1
command_bucket_id=1
req = ofp_parser.OFPGroupMod(datapath, ofp.OFPGC_ADD,
ofp.OFPGT_SELECT, group_id,
command_bucket_id, buckets)
datapath.send_msg(req)

JSON Example:
{
"OFPGroupMod": {
"bucket_array_len": 56,
"buckets": [
(continues on next page)

2.5. OpenFlow protocol API Reference 389

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPBucket": {
"action_array_len": 24,
"actions": [
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.9"
}
},
"len": 16,
"type": 25
}
}
],
"bucket_id": 305419896,
"len": 56,
"properties": [
{
"OFPGroupBucketPropWeight": {
"length": 8,
"type": 0,
"weight": 52428
}
},
{
"OFPGroupBucketPropWatch": {
"length": 8,
"type": 1,
"watch": 56797
}
},
{
"OFPGroupBucketPropWatch": {
"length": 8,
"type": 2,
"watch": 4008636142
}
}
]
}
}
],
"command": 3,
"command_bucket_id": 3149642683,
"group_id": 2863311530,
"properties": [],
"type": 1
(continues on next page)

390 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPPortMod(datapath, port_no=0,

hw_addr=’00:00:00:00:00:00’, con-
fig=0, mask=0, properties=None)
Port modification message
The controller sneds this message to modify the behavior of the port.

Attribute Description
port_no Port number to modify
hw_addr The hardware address that must be the same as
hw_addr of OFPPort of OFPSwitchFeatures
config Bitmap of configuration flags.

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

mask Bitmap of configuration flags above to be changed

properties List of OFPPortModProp subclass instance

Example:

def send_port_mod(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

port_no = 3
hw_addr = 'fa:c8:e8:76:1d:7e'
config = 0
mask = (ofp.OFPPC_PORT_DOWN | ofp.OFPPC_NO_RECV |
ofp.OFPPC_NO_FWD | ofp.OFPPC_NO_PACKET_IN)
advertise = (ofp.OFPPF_10MB_HD | ofp.OFPPF_100MB_FD |
ofp.OFPPF_1GB_FD | ofp.OFPPF_COPPER |
ofp.OFPPF_AUTONEG | ofp.OFPPF_PAUSE |
ofp.OFPPF_PAUSE_ASYM)
properties = [ofp_parser.OFPPortModPropEthernet(advertise)]
req = ofp_parser.OFPPortMod(datapath, port_no, hw_addr, config,
mask, properties)
datapath.send_msg(req)

JSON Example:

{
"OFPPortMod": {
"config": 0,
"hw_addr": "00:11:00:00:11:11",
"mask": 0,
"port_no": 1,
"properties": [
{
(continues on next page)

2.5. OpenFlow protocol API Reference 391

ryu Documentation, Release 4.34

(continued from previous page)

"OFPPortModPropEthernet": {
"advertise": 4096,
"length": 8,
"type": 0
}
},
{
"OFPPortModPropOptical": {
"configure": 3,
"fl_offset": 2000,
"freq_lmda": 1500,
"grid_span": 3000,
"length": 24,
"tx_pwr": 300,
"type": 1
}
},
{
"OFPPortModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPPortModPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPPortModPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
]
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPMeterMod(datapath, command=0, flags=1,

meter_id=1, bands=None)
Meter modification message
The controller sends this message to modify the meter.

392 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
command One of the following values.

OFPMC_ADD
OFPMC_MODIFY
OFPMC_DELETE

flags Bitmap of the following flags.

OFPMF_KBPS
OFPMF_PKTPS
OFPMF_BURST
OFPMF_STATS

meter_id Meter instance

bands list of the following class instance.

OFPMeterBandDrop
OFPMeterBandDscpRemark
OFPMeterBandExperimenter

JSON Example:

{
"OFPMeterMod": {
"bands": [
{
"OFPMeterBandDrop": {
"burst_size": 10,
"len": 16,
"rate": 1000,
"type": 1
}
},
{
"OFPMeterBandDscpRemark": {
"burst_size": 10,
"len": 16,
"prec_level": 1,
"rate": 1000,
"type": 2
}
}
],
"command": 0,
"flags": 14,
"meter_id": 100
}
}

2.5. OpenFlow protocol API Reference 393

ryu Documentation, Release 4.34

Multipart Messages

class ryu.ofproto.ofproto_v1_5_parser.OFPDescStatsRequest(datapath, flags=0,

type_=None)
Description statistics request message
The controller uses this message to query description of the switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPDescStatsRequest": {
"flags": 0,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPDescStatsReply(datapath, type_=None,

**kwargs)
Description statistics reply message
The switch responds with this message to a description statistics request.

Attribute Description
body Instance of OFPDescStats

Example:

@set_ev_cls(ofp_event.EventOFPDescStatsReply, MAIN_DISPATCHER)
def desc_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('DescStats: mfr_desc=%s hw_desc=%s sw_desc=%s '

'serial_num=%s dp_desc=%s',
body.mfr_desc, body.hw_desc, body.sw_desc,
body.serial_num, body.dp_desc)

JSON Example:

{
"OFPDescStatsReply": {
"body": {
"OFPDescStats": {
"dp_desc": "dp",
"hw_desc": "hw",
(continues on next page)

394 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"mfr_desc": "mfr",
"serial_num": "serial",
"sw_desc": "sw"
}
},
"flags": 0,
"type": 0
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowDescStatsRequest(datapath,
flags=0, ta-
ble_id=255,
out_port=4294967295,
out_group=4294967295,
cookie=0,
cookie_mask=0,
match=None,
type_=None)
Individual flow descriptions request message
The controller uses this message to query individual flow descriptions.

Example:
def send_flow_desc_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

cookie = cookie_mask = 0
match = ofp_parser.OFPMatch(in_port=1)
req = ofp_parser.OFPFlowDescStatsRequest(datapath, 0,
ofp.OFPTT_ALL,
ofp.OFPP_ANY,
ofp.OFPG_ANY,
cookie, cookie_mask,
match)
datapath.send_msg(req)

JSON Example:
{
"OFPFlowDescStatsRequest": {
"cookie": 1234605616436508552,
"cookie_mask": 18446744073709551615,
"flags": 0,
(continues on next page)

2.5. OpenFlow protocol API Reference 395

ryu Documentation, Release 4.34

(continued from previous page)

"match": {
"OFPMatch": {
"length": 12,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 1
}
}
],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"table_id": 1,
"type": 1
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowDescStatsReply(datapath,
type_=None,
**kwargs)
Individual flow descriptions reply message
The switch responds with this message to an individual flow descriptions request.

Attribute Description
body List of OFPFlowDesc instance

Example:
@set_ev_cls(ofp_event.EventOFPFlowDescStatsReply, MAIN_DISPATCHER)
def flow_desc_reply_handler(self, ev):
flows = []
for stat in ev.msg.body:
flows.append('table_id=%s priority=%d '
'idle_timeout=%d hard_timeout=%d flags=0x%04x '
'importance=%d cookie=%d match=%s '
'stats=%s instructions=%s' %
(stat.table_id, stat.priority,
stat.idle_timeout, stat.hard_timeout,
stat.flags, stat.importance,
stat.cookie, stat.match,
stat.stats, stat.instructions))
self.logger.debug('FlowDesc: %s', flows)

JSON Example:
{
"OFPFlowDescStatsReply": {
"body": [
{
"OFPFlowDesc": {
(continues on next page)

396 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"cookie": 1234605616436508552,
"flags": 1,
"hard_timeout": 255,
"idle_timeout": 255,
"importance": 43690,
"instructions": [
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 2,
"type": 1
}
}
],
"length": 64,
"match": {
"OFPMatch": {
"length": 12,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 1
}
}
],
"type": 1
}
},
"priority": 5,
"stats": {
"OFPStats": {
"length": 12,
"oxs_fields": [
{
"OXSTlv": {
"field": "flow_count",
"value": 1
}
}
]
}
},
"table_id": 1
}
}
],
"flags": 0,
"type": 1
}
}

2.5. OpenFlow protocol API Reference 397

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowStatsRequest(datapath, flags=0,

Example:

def send_flow_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:

398 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowStatsReply(datapath, type_=None,

**kwargs)
Individual flow statistics reply message
The switch responds with this message to an individual flow statistics request.

Attribute Description
body List of OFPFlowStats instance

Example:

@set_ev_cls(ofp_event.EventOFPFlowStatsReply, MAIN_DISPATCHER)
def flow_stats_reply_handler(self, ev):
flows = []
for stat in ev.msg.body:
flows.append('table_id=%s reason=%d priority=%d '
'match=%s stats=%s' %
(stat.table_id, stat.reason, stat.priority,
stat.match, stat.stats))
self.logger.debug('FlowStats: %s', flows)

JSON Example:

{
"OFPFlowStatsReply": {
"body": [
{
"OFPFlowStats": {
"length": 40,
"match": {
"OFPMatch": {
"length": 12,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 1
}
}
],
"type": 1
}
},
"priority": 1,
"reason": 0,
"stats": {
"OFPStats": {
"length": 12,
"oxs_fields": [
{
"OXSTlv": {
"field": "flow_count",
"value": 1
}
}
]
(continues on next page)

2.5. OpenFlow protocol API Reference 399

ryu Documentation, Release 4.34

(continued from previous page)

}
},
"table_id": 1
}
}
],
"flags": 0,
"type": 17
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPAggregateStatsRequest(datapath,
flags, table_id,
out_port,
out_group,
cookie,
cookie_mask,
match,
type_=None)
Aggregate flow statistics request message
The controller uses this message to query aggregate flow statictics.

Example:
def send_aggregate_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:
{
"OFPAggregateStatsRequest": {
"cookie": 0,
"cookie_mask": 0,
"flags": 0,
(continues on next page)

400 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"match": {
"OFPMatch": {
"length": 4,
"oxm_fields": [],
"type": 1
}
},
"out_group": 4294967295,
"out_port": 4294967295,
"table_id": 255,
"type": 2
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPAggregateStatsReply(datapath,
type_=None,
**kwargs)
Aggregate flow statistics reply message
The switch responds with this message to an aggregate flow statistics request.

Attribute Description
body Instance of OFPAggregateStats

Example:
@set_ev_cls(ofp_event.EventOFPAggregateStatsReply, MAIN_DISPATCHER)
def aggregate_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('AggregateStats: stats=%s', body.stats)

JSON Example:
{
"OFPAggregateStatsReply": {
"body": {
"OFPAggregateStats": {
"length": 16,
"stats": {
"OFPStats": {
"length": 12,
"oxs_fields": [
{
"OXSTlv": {
"field": "flow_count",
"value": 1
}
}
]
}
}
}
},
"flags": 0,
"type": 2
(continues on next page)

2.5. OpenFlow protocol API Reference 401

ryu Documentation, Release 4.34

(continued from previous page)

}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPPortStatsRequest(datapath, flags,

port_no, type_=None)
Port statistics request message
The controller uses this message to query information about ports statistics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read (OFPP_ANY to all ports)

Example:

def send_port_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortStatsRequest(datapath, 0, ofp.OFPP_ANY)

datapath.send_msg(req)

JSON Example:

{
"OFPPortStatsRequest": {
"flags": 0,
"port_no": 4294967295,
"type": 4
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPPortStatsReply(datapath, type_=None,

**kwargs)
Port statistics reply message
The switch responds with this message to a port statistics request.

Attribute Description
body List of OFPPortStats instance

Example:

402 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

JSON Example:

{
"OFPPortStatsReply": {
"body": [
{
"OFPPortStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 224,
"port_no": 7,
"properties": [
{
"OFPPortStatsPropEthernet": {
"collisions": 0,
"length": 40,
"rx_crc_err": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"type": 0
}
},
{
"OFPPortStatsPropOptical": {
"bias_current": 300,
"flags": 3,
"length": 44,
"rx_freq_lmda": 1500,
"rx_grid_span": 500,
"rx_offset": 700,
"rx_pwr": 2000,
"temperature": 273,
"tx_freq_lmda": 1500,
"tx_grid_span": 500,
"tx_offset": 700,
"tx_pwr": 2000,
"type": 1
}
},
{
"OFPPortStatsPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPPortStatsPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
(continues on next page)

2.5. OpenFlow protocol API Reference 403

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OFPPortStatsPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"rx_bytes": 0,
"rx_dropped": 0,
"rx_errors": 0,
"rx_packets": 0,
"tx_bytes": 336,
"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
},
{
"OFPPortStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 120,
"port_no": 6,
"properties": [
{
"OFPPortStatsPropEthernet": {
"collisions": 0,
"length": 40,
"rx_crc_err": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"type": 0
}
}
],
"rx_bytes": 336,
"rx_dropped": 0,
"rx_errors": 0,
"rx_packets": 4,
"tx_bytes": 336,
"tx_dropped": 0,
"tx_errors": 0,
"tx_packets": 4
}
}
],
"flags": 0,
"type": 4
}
}

404 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPPortDescStatsRequest(datapath,
flags=0,
port_no=4294967295,
type_=None)
Port description request message
The controller uses this message to query description of one or all the ports.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read (OFPP_ANY to all ports)

Example:

def send_port_desc_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortDescStatsRequest(datapath, 0, ofp.OFPP_ANY)

datapath.send_msg(req)

JSON Example:

{
"OFPPortDescStatsRequest": {
"flags": 0,
"port_no": 48346,
"type": 13
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPPortDescStatsReply(datapath,
type_=None,
**kwargs)
Port description reply message
The switch responds with this message to a port description request.

Attribute Description
body List of OFPPort instance

Example:

JSON Example:

2.5. OpenFlow protocol API Reference 405

ryu Documentation, Release 4.34

406 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OFPPortDescPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"state": 4
}
},
{
"OFPPort": {
"config": 0,
"hw_addr": "f2:0b:a4:7d:f8:ea",
"length": 72,
"name": "Port6",
"port_no": 6,
"properties": [
{
"OFPPortDescPropEthernet": {
"advertised": 10240,
"curr": 10248,
"curr_speed": 5000,
"length": 32,
"max_speed": 5000,
"peer": 10248,
"supported": 10248,
"type": 0
}
}
],
"state": 4
}
}
],
"flags": 0,
"type": 13
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPQueueStatsRequest(datapath, flags=0,

port_no=4294967295,
queue_id=4294967295,
type_=None)
Queue statistics request message
The controller uses this message to query queue statictics.

2.5. OpenFlow protocol API Reference 407

ryu Documentation, Release 4.34

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read
queue_id ID of queue to read

Example:
def send_queue_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueStatsRequest(datapath, 0, ofp.OFPP_ANY,

ofp.OFPQ_ALL)
datapath.send_msg(req)

JSON Example:
{
"OFPQueueStatsRequest": {
"flags": 0,
"port_no": 43981,
"queue_id": 4294967295,
"type": 5
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPQueueStatsReply(datapath, type_=None,

**kwargs)
Queue statistics reply message
The switch responds with this message to an aggregate flow statistics request.

Attribute Description
body List of OFPQueueStats instance

Example:
@set_ev_cls(ofp_event.EventOFPQueueStatsReply, MAIN_DISPATCHER)
def queue_stats_reply_handler(self, ev):
queues = []
for stat in ev.msg.body:
queues.append('port_no=%d queue_id=%d '
'tx_bytes=%d tx_packets=%d tx_errors=%d '
'duration_sec=%d duration_nsec=%d'
'properties=%s' %
(stat.port_no, stat.queue_id,
stat.tx_bytes, stat.tx_packets, stat.tx_errors,
stat.duration_sec, stat.duration_nsec,
repr(stat.properties)))
self.logger.debug('QueueStats: %s', queues)

JSON Example:
{
"OFPQueueStatsReply": {
"body": [
(continues on next page)

408 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 104,
"port_no": 7,
"properties": [
{
"OFPQueueStatsPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPQueueStatsPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPQueueStatsPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
},
{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 48,
"port_no": 6,
"properties": [],
"queue_id": 1,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
(continues on next page)

2.5. OpenFlow protocol API Reference 409

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OFPQueueStats": {
"duration_nsec": 0,
"duration_sec": 0,
"length": 48,
"port_no": 7,
"properties": [],
"queue_id": 2,
"tx_bytes": 0,
"tx_errors": 0,
"tx_packets": 0
}
}
],
"flags": 0,
"type": 5
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPQueueDescStatsRequest(datapath,
flags=0,
port_no=4294967295,
queue_id=4294967295,
type_=None)
Queue description request message
The controller uses this message to query description of all the queues.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
port_no Port number to read (OFPP_ANY for all ports)
queue_id ID of queue to read (OFPQ_ALL for all queues)

Example:

def send_queue_desc_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPQueueDescStatsRequest(datapath, 0,
ofp.OFPP_ANY,
ofp.OFPQ_ALL)
datapath.send_msg(req)

JSON Example:

{
"OFPQueueDescStatsRequest": {
"flags": 0,
"port_no": 52651,
"queue_id": 57020,
"type": 15
}
}

410 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPQueueDescStatsReply(datapath,
type_=None,
**kwargs)
Queue description reply message
The switch responds with this message to a queue description request.

Attribute Description
body List of OFPQueueDesc instance

Example:

JSON Example:

{
"OFPQueueDescStatsReply": {
"body": [
{
"OFPQueueDesc": {
"len": 32,
"port_no": 7,
"properties": [
{
"OFPQueueDescPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
}
],
"queue_id": 0
}
},
{
"OFPQueueDesc": {
"len": 88,
"port_no": 8,
"properties": [
{
"OFPQueueDescPropMinRate": {
"length": 8,
"rate": 300,
"type": 1
}
},
{
"OFPQueueDescPropMaxRate": {
(continues on next page)

2.5. OpenFlow protocol API Reference 411

ryu Documentation, Release 4.34

(continued from previous page)

"length": 8,
"rate": 900,
"type": 2
}
},
{
"OFPQueueDescPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPQueueDescPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPQueueDescPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"queue_id": 1
}
}
],
"flags": 0,
"type": 15
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGroupStatsRequest(datapath, flags=0,

group_id=4294967292,
type_=None)
Group statistics request message
The controller uses this message to query statistics of one or more groups.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
group_id ID of group to read (OFPG_ALL to all groups)

412 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Example:

def send_group_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupStatsRequest(datapath, 0, ofp.OFPG_ALL)

datapath.send_msg(req)

JSON Example:

{
"OFPGroupStatsRequest": {
"flags": 0,
"group_id": 4294967292,
"type": 6
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGroupStatsReply(datapath, type_=None,

**kwargs)
Group statistics reply message
The switch responds with this message to a group statistics request.

Attribute Description
body List of OFPGroupStats instance

Example:

JSON Example:

{
"OFPGroupStatsReply": {
"body": [
{
"OFPGroupStats": {
"bucket_stats": [
{
"OFPBucketCounter": {
"byte_count": 2345,
"packet_count": 234
}
}
(continues on next page)

2.5. OpenFlow protocol API Reference 413

ryu Documentation, Release 4.34

(continued from previous page)

],
"byte_count": 12345,
"duration_nsec": 609036000,
"duration_sec": 9,
"group_id": 1,
"length": 56,
"packet_count": 123,
"ref_count": 2
}
}
],
"flags": 0,
"type": 6
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGroupDescStatsRequest(datapath,
flags=0,
group_id=4294967292,
type_=None)
Group description request message
The controller uses this message to list the set of groups on a switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
group_id ID of group to read (OFPG_ALL to all groups)

Example:

def send_group_desc_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupDescStatsRequest(datapath, 0, ofp.OFPG_ALL)

datapath.send_msg(req)

JSON Example:

{
"OFPGroupDescStatsRequest": {
"flags": 0,
"group_id": 52651,
"type": 7
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGroupDescStatsReply(datapath,
type_=None,
**kwargs)
Group description reply message
The switch responds with this message to a group description request.

Attribute Description
body List of OFPGroupDescStats instance

414 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Example:

@set_ev_cls(ofp_event.EventOFPGroupDescStatsReply, MAIN_DISPATCHER)
def group_desc_stats_reply_handler(self, ev):
descs = []
for stat in ev.msg.body:
descs.append('length=%d type=%d group_id=%d '
'buckets=%s properties=%s' %
(stat.length, stat.type, stat.group_id,
stat.bucket, repr(stat.properties)))
self.logger.debug('GroupDescStats: %s', descs)

JSON Example:

{
"OFPGroupDescStatsReply": {
"body": [
{
"OFPGroupDescStats": {
"bucket_array_len": 32,
"buckets": [
{
"OFPBucket": {
"action_array_len": 16,
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65509,
"port": 1,
"type": 0
}
}
],
"bucket_id": 65535,
"len": 32,
"properties": [
{
"OFPGroupBucketPropWeight": {
"length": 8,
"type": 0,
"weight": 65535
}
}
]
}
}
],
"group_id": 1,
"length": 48,
"properties": [],
"type": 1
}
}
],
"flags": 0,
"type": 7
}
(continues on next page)

2.5. OpenFlow protocol API Reference 415

ryu Documentation, Release 4.34

(continued from previous page)

}

class ryu.ofproto.ofproto_v1_5_parser.OFPGroupFeaturesStatsRequest(datapath,
flags=0,
type_=None)
Group features request message
The controller uses this message to list the capabilities of groups on a switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:
def send_group_features_stats_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGroupFeaturesStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:
{
"OFPGroupFeaturesStatsRequest": {
"flags": 0,
"type": 8
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGroupFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Group features reply message
The switch responds with this message to a group features request.

Attribute Description
body Instance of OFPGroupFeaturesStats

Example:
@set_ev_cls(ofp_event.EventOFPGroupFeaturesStatsReply, MAIN_DISPATCHER)
def group_features_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('GroupFeaturesStats: types=%d '

'capabilities=0x%08x max_groups=%s '
'actions=%s',
body.types, body.capabilities,
body.max_groups, body.actions)

JSON Example:
{
"OFPGroupFeaturesStatsReply": {
(continues on next page)

416 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"body": {
"OFPGroupFeaturesStats": {
"actions": [
67082241,
67082241,
67082241,
67082241
],
"capabilities": 5,
"max_groups": [
16777216,
16777216,
16777216,
16777216
],
"types": 15
}
},
"flags": 0,
"type": 8
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPMeterStatsRequest(datapath, flags=0, me-

ter_id=4294967295,
type_=None)
Meter statistics request message
The controller uses this message to query statistics for one or more meters.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
meter_id ID of meter to read (OFPM_ALL to all meters)

Example:

def send_meter_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterStatsRequest(datapath, 0, ofp.OFPM_ALL)

datapath.send_msg(req)

JSON Example:

{
"OFPMeterStatsRequest": {
"flags": 0,
"meter_id": 4294967295,
"type": 9
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPMeterStatsReply(datapath, type_=None,

**kwargs)
Meter statistics reply message

2.5. OpenFlow protocol API Reference 417

ryu Documentation, Release 4.34

The switch responds with this message to a meter statistics request.

Attribute Description
body List of OFPMeterStats instance

Example:

@set_ev_cls(ofp_event.EventOFPMeterStatsReply, MAIN_DISPATCHER)
def meter_stats_reply_handler(self, ev):
meters = []
for stat in ev.msg.body:
meters.append('meter_id=0x%08x len=%d ref_count=%d '
'packet_in_count=%d byte_in_count=%d '
'duration_sec=%d duration_nsec=%d '
'band_stats=%s' %
(stat.meter_id, stat.len, stat.ref_count,
stat.packet_in_count, stat.byte_in_count,
stat.duration_sec, stat.duration_nsec,
stat.band_stats))
self.logger.debug('MeterStats: %s', meters)

JSON Example:

{
"OFPMeterStatsReply": {
"body": [
{
"OFPMeterStats": {
"band_stats": [
{
"OFPMeterBandStats": {
"byte_band_count": 0,
"packet_band_count": 0
}
}
],
"byte_in_count": 0,
"duration_nsec": 480000,
"duration_sec": 0,
"ref_count": 0,
"len": 56,
"meter_id": 100,
"packet_in_count": 0
}
}
],
"flags": 0,
"type": 9
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPMeterDescStatsRequest(datapath,
flags=0, me-
ter_id=4294967295,
type_=None)
Meter description statistics request message
The controller uses this message to query configuration for one or more meters.

418 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
flags Zero or OFPMPF_REQ_MORE
meter_id ID of meter to read (OFPM_ALL to all meters)

Example:
def send_meter_desc_stats_request(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterDescStatsRequest(datapath, 0,
ofp.OFPM_ALL)
datapath.send_msg(req)

JSON Example:
{
"OFPMeterDescStatsRequest": {
"flags": 0,
"meter_id": 4294967295,
"type": 10
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPMeterDescStatsReply(datapath,
type_=None,
**kwargs)
Meter description statistics reply message
The switch responds with this message to a meter description statistics request.

Attribute Description
body List of OFPMeterDescStats instance

Example:
@set_ev_cls(ofp_event.EventOFPMeterDescStatsReply, MAIN_DISPATCHER)
def meter_desc_stats_reply_handler(self, ev):
configs = []
for stat in ev.msg.body:
configs.append('length=%d flags=0x%04x meter_id=0x%08x '
'bands=%s' %
(stat.length, stat.flags, stat.meter_id,
stat.bands))
self.logger.debug('MeterDescStats: %s', configs)

JSON Example:
{
"OFPMeterDescStatsReply": {
"body": [
{
"OFPMeterDescStats": {
"bands": [
{
"OFPMeterBandDrop": {
(continues on next page)

2.5. OpenFlow protocol API Reference 419

ryu Documentation, Release 4.34

(continued from previous page)

"burst_size": 10,
"len": 16,
"rate": 1000,
"type": 1
}
}
],
"flags": 14,
"length": 24,
"meter_id": 100
}
}
],
"flags": 0,
"type": 10
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPMeterFeaturesStatsRequest(datapath,
flags=0,
type_=None)
Meter features statistics request message
The controller uses this message to query the set of features of the metering subsystem.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_meter_features_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPMeterFeaturesStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPMeterFeaturesStatsRequest": {
"flags": 0,
"type": 11
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPMeterFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Meter features statistics reply message
The switch responds with this message to a meter features statistics request.

Attribute Description
body List of OFPMeterFeaturesStats instance

Example:

420 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

JSON Example:

{
"OFPMeterFeaturesStatsReply": {
"body": [
{
"OFPMeterFeaturesStats": {
"band_types": 2147483654,
"capabilities": 15,
"features": 3,
"max_bands": 255,
"max_color": 0,
"max_meter": 16777216
}
}
],
"flags": 0,
"type": 11
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPControllerStatusStatsRequest(datapath,
flags=0,
type_=None)
Controller status multipart request message
The controller uses this message to request the status, the roles and the control channels of other controllers
configured on the switch.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_controller_status_multipart_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPPortDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPControllerStatusStatsRequest": {
(continues on next page)

2.5. OpenFlow protocol API Reference 421

ryu Documentation, Release 4.34

(continued from previous page)

"flags": 0,
"type": 18
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPControllerStatusStatsReply(datapath,
type_=None,
**kwargs)
Controller status multipart reply message
The switch responds with this message to a controller status multipart request.

Attribute Description
body List of OFPControllerStatus instance

Example:

@set_ev_cls(ofp_event.EventOFPControllerStatusStatsReply,
MAIN_DISPATCHER)
def controller_status_multipart_reply_handler(self, ev):
status = []
for s in ev.msg.body:
status.append('short_id=%d role=%d reason=%d '
'channel_status=%d properties=%s' %
(s.short_id, s.role, s.reason,
s.channel_status, repr(s.properties)))
self.logger.debug('OFPControllerStatusStatsReply received: %s',
status)

JSON Example:

{
"OFPControllerStatusStatsReply": {
"body": [
{
"OFPControllerStatusStats": {
"channel_status": 1,
"length": 48,
"properties": [
{
"OFPControllerStatusPropUri": {
"length": 26,
"type": 0,
"uri": "tls:192.168.34.23:6653"
}
}
],
"reason": 1,
"role": 1,
"short_id": 65535
}
}
],
"flags": 0,
"type": 18
(continues on next page)

422 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPTableStatsRequest(datapath, flags,

type_=None)
Table statistics request message
The controller uses this message to query flow table statictics.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_table_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPTableStatsRequest": {
"flags": 0,
"type": 3
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPTableStatsReply(datapath, type_=None,

**kwargs)
Table statistics reply message
The switch responds with this message to a table statistics request.

Attribute Description
body List of OFPTableStats instance

Example:

JSON Example:

{
"OFPTableStatsReply": {
"body": [
(continues on next page)

2.5. OpenFlow protocol API Reference 423

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPTableStats": {
"active_count": 4,
"lookup_count": 4,
"matched_count": 4,
"table_id": 0
}
},
{
"OFPTableStats": {
"active_count": 4,
"lookup_count": 4,
"matched_count": 4,
"table_id": 1
}
}
],
"flags": 0,
"type": 3
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPTableDescStatsRequest(datapath,
flags=0,
type_=None)
Table description request message
The controller uses this message to query description of all the tables.

Attribute Description
flags Zero or OFPMPF_REQ_MORE

Example:

def send_table_desc_stats_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPTableDescStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPTableDescStatsRequest": {
"flags": 0,
"type": 14
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPTableDescStatsReply(datapath,
type_=None,
**kwargs)
Table description reply message
The switch responds with this message to a table description request.

424 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
body List of OFPTableDesc instance

Example:
@set_ev_cls(ofp_event.EventOFPTableDescStatsReply, MAIN_DISPATCHER)
def table_desc_stats_reply_handler(self, ev):
tables = []
for p in ev.msg.body:
tables.append('table_id=%d config=0x%08x properties=%s' %
(p.table_id, p.config, repr(p.properties)))
self.logger.debug('OFPTableDescStatsReply received: %s', tables)

JSON Example:
{
"OFPTableDescStatsReply": {
"body": [
{
"OFPTableDesc": {
"config": 0,
"length": 24,
"properties": [
{
"OFPTableModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
}
],
"table_id": 7
}
},
{
"OFPTableDesc": {
"config": 0,
"length": 80,
"properties": [
{
"OFPTableModPropEviction": {
"flags": 0,
"length": 8,
"type": 2
}
},
{
"OFPTableModPropVacancy": {
"length": 8,
"type": 3,
"vacancy": 0,
"vacancy_down": 0,
"vacancy_up": 0
}
},
(continues on next page)

2.5. OpenFlow protocol API Reference 425

ryu Documentation, Release 4.34

(continued from previous page)

class ryu.ofproto.ofproto_v1_5_parser.OFPTableFeaturesStatsRequest(datapath,
flags=0,
body=None,
type_=None)
Table features statistics request message
The controller uses this message to query table features.

Attribute Description
body List of OFPTableFeaturesStats instances. The default is [].

JSON Example:

426 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

{
"OFPTableFeaturesStatsRequest": {
"body": [
{
"OFPTableFeaturesStats": {
"capabilities": 4,
"command": 1,
"features": 1,
"length": 80,
"max_entries": 255,
"metadata_match": 18446744073709551615,
"metadata_write": 18446744073709551615,
"name": "table1",
"properties": [
{
"OFPTableFeaturePropOxmValues": {
"length": 14,
"oxm_values": [
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "aa:bb:cc:dd:ee:ff"
}
}
],
"type": 22
}
}
],
"table_id": 1
}
}
],
"flags": 0,
"type": 12
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPTableFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Table features statistics reply message
The switch responds with this message to a table features statistics request.

Attribute Description
body List of OFPTableFeaturesStats instance

JSON Example:
{
"OFPTableFeaturesStatsReply": {
"body": [
{
"OFPTableFeaturesStats": {
"capabilities": 4,
(continues on next page)

2.5. OpenFlow protocol API Reference 427

ryu Documentation, Release 4.34

(continued from previous page)

"command": 1,
"features": 1,
"length": 80,
"max_entries": 255,
"metadata_match": 18446744073709551615,
"metadata_write": 18446744073709551615,
"name": "table1",
"properties": [
{
"OFPTableFeaturePropOxmValues": {
"length": 14,
"oxm_values": [
{
"OXMTlv": {
"field": "eth_src",
"mask": null,
"value": "aa:bb:cc:dd:ee:ff"
}
}
],
"type": 22
}
}
],
"table_id": 1
}
}
],
"flags": 0,
"type": 12
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowMonitorRequest(datapath, flags=0,

428 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

OFPFMF_INITIAL
OFPFMF_ADD
OFPFMF_REMOVED
OFPFMF_MODIFY
OFPFMF_INSTRUCTIONS
OFPFMF_NO_ABBREV
OFPFMF_ONLY_OWN

table_id ID of table to monitor

command One of the following values.

OFPFMC_ADD
OFPFMC_MODIFY
OFPFMC_DELETE

match Instance of OFPMatch

Example:

def send_flow_monitor_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

monitor_flags = [ofp.OFPFMF_INITIAL, ofp.OFPFMF_ONLY_OWN]

JSON Example:

{
"OFPFlowMonitorRequest": {
"command": 0,
"flags": 0,
"match": {
"OFPMatch": {
"length": 14,
"oxm_fields": [
{
"OXMTlv": {
(continues on next page)

2.5. OpenFlow protocol API Reference 429

ryu Documentation, Release 4.34

(continued from previous page)

"field": "eth_dst",
"mask": null,
"value": "f2:0b:a4:7d:f8:ea"
}
}
],
"type": 1
}
},
"monitor_flags": 15,
"monitor_id": 100000000,
"out_group": 4294967295,
"out_port": 22,
"table_id": 33,
"type": 16
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowMonitorReply(datapath, type_=None,

**kwargs)
Flow monitor reply message
The switch responds with this message to a flow monitor request.

Attribute Description
body List of list of the following class instance.

OFPFlowMonitorFull
OFPFlowMonitorAbbrev
OFPFlowMonitorPaused

Example:

@set_ev_cls(ofp_event.EventOFPFlowMonitorReply, MAIN_DISPATCHER)
def flow_monitor_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto
flow_updates = []

for update in msg.body:

update_str = 'length=%d event=%d' %
(update.length, update.event)
if (update.event == ofp.OFPFME_INITIAL or
update.event == ofp.OFPFME_ADDED or
update.event == ofp.OFPFME_REMOVED or
update.event == ofp.OFPFME_MODIFIED):
update_str += 'table_id=%d reason=%d idle_timeout=%d '
'hard_timeout=%d priority=%d cookie=%d '
'match=%d instructions=%s' %
(update.table_id, update.reason,
update.idle_timeout, update.hard_timeout,
update.priority, update.cookie,
update.match, update.instructions)
(continues on next page)

430 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

elif update.event == ofp.OFPFME_ABBREV:
update_str += 'xid=%d' % (update.xid)
flow_updates.append(update_str)
self.logger.debug('FlowUpdates: %s', flow_updates)

2.5. OpenFlow protocol API Reference 431

ryu Documentation, Release 4.34

(continued from previous page)

"event": 4,
"length": 8,
"xid": 1234
}
},
{
"OFPFlowUpdatePaused": {
"event": 5,
"length": 8
}
}
],
"flags": 0,
"type": 16
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPBundleFeaturesStatsRequest(datapath,
flags=0,
fea-
ture_request_flags=0,
proper-
ties=None,
type_=None)
Bundle features request message
The controller uses this message to query a switch about its bundle capabilities, including whether it supports
atomic bundles, ordered bundles, and scheduled bundles.

Attribute Description
flags Zero or OFPMPF_REQ_MORE
feature_request_flags Bitmap of the following flags.

OFPBF_TIMESTAMP
OFPBF_TIME_SET_SCHED

properties List of OFPBundleFeaturesProp subclass in-

stance

Example:

def send_bundle_features_stats_request(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPBundleFeaturesStatsRequest(datapath, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPBundleFeaturesStatsRequest": {
"feature_request_flags": 3,
"flags": 0,
(continues on next page)

432 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"properties": [
{
"OFPBundleFeaturesPropTime": {
"length": 72,
"sched_accuracy": {
"OFPTime": {
"nanoseconds": 1717986918,
"seconds": 6148914691236517205
}
},
"sched_max_future": {
"OFPTime": {
"nanoseconds": 2290649224,
"seconds": 8608480567731124087
}
},
"sched_max_past": {
"OFPTime": {
"nanoseconds": 2863311530,
"seconds": 11068046444225730969
}
},
"timestamp": {
"OFPTime": {
"nanoseconds": 3435973836,
"seconds": 13527612320720337851
}
},
"type": 1
}
}
],
"type": 19
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPBundleFeaturesStatsReply(datapath,
type_=None,
**kwargs)
Bundle features reply message
The switch responds with this message to a bundle features request.

Attribute Description
body Instance of OFPBundleFeaturesStats

Example:
@set_ev_cls(ofp_event.EventOFPBundleFeaturesStatsReply, MAIN_DISPATCHER)
def bundle_features_stats_reply_handler(self, ev):
body = ev.msg.body

self.logger.debug('OFPBundleFeaturesStats: capabilities=%0x%08x '

'properties=%s',
body.capabilities, repr(body.properties))

JSON Example:

2.5. OpenFlow protocol API Reference 433

ryu Documentation, Release 4.34

{
"OFPBundleFeaturesStatsReply": {
"body": {
"OFPBundleFeaturesStats": {
"capabilities": 7,
"properties": [
{
"OFPBundleFeaturesPropTime": {
"length": 72,
"sched_accuracy": {
"OFPTime": {
"nanoseconds": 1717986918,
"seconds": 6148914691236517205
}
},
"sched_max_future": {
"OFPTime": {
"nanoseconds": 2290649224,
"seconds": 8608480567731124087
}
},
"sched_max_past": {
"OFPTime": {
"nanoseconds": 2863311530,
"seconds": 11068046444225730969
}
},
"timestamp": {
"OFPTime": {
"nanoseconds": 3435973836,
"seconds": 13527612320720337851
}
},
"type": 1
}
}
]
}
},
"flags": 0,
"type": 19
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPExperimenterStatsRequest(datapath,
flags, ex-
perimenter,
exp_type,
data,
type_=None)
Experimenter multipart request message

Attribute Description
flags Zero or OFPMPF_REQ_MORE
experimenter Experimenter ID
exp_type Experimenter defined
data Experimenter defined additional data

434 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

JSON Example:

{
"OFPExperimenterStatsRequest": {
"data": "aG9nZWhvZ2U=",
"exp_type": 3405678728,
"experimenter": 3735928495,
"flags": 0,
"type": 65535
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPExperimenterStatsReply(datapath,
type_=None,
**kwargs)
Experimenter multipart reply message

Attribute Description
body An OFPExperimenterMultipart instance

JSON Example:

{
"OFPExperimenterStatsReply": {
"body": {
"OFPExperimenterMultipart": {
"data": "dGVzdGRhdGE5OTk5OTk5OQ==",
"exp_type": 3405674359,
"experimenter": 3735928495
}
},
"flags": 0,
"type": 65535
}
}

Packet-Out Message

class ryu.ofproto.ofproto_v1_5_parser.OFPPacketOut(datapath, buffer_id=None,

match=None, actions=None,
data=None, actions_len=None)
Packet-Out message
The controller uses this message to send a packet out throught the switch.

Attribute Description
buffer_id ID assigned by datapath (OFP_NO_BUFFER if none)
match Instance of OFPMatch (in_port is mandatory in the match field)
actions list of OpenFlow action class
data Packet data of a binary type value or an instances of packet.Packet.

Example:

2.5. OpenFlow protocol API Reference 435

ryu Documentation, Release 4.34

def send_packet_out(self, datapath, buffer_id, in_port):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

match = OFPMatch(in_port=in_port)
actions = [ofp_parser.OFPActionOutput(ofp.OFPP_FLOOD, 0)]
req = ofp_parser.OFPPacketOut(datapath, buffer_id,
match, actions)
datapath.send_msg(req)

JSON Example:

{
"OFPPacketOut": {
"actions": [
{
"OFPActionOutput": {
"len": 16,
"max_len": 65535,
"port": 4294967291,
"type": 0
}
}
],
"actions_len": 16,
"buffer_id": 4294967295,
"data": "dGVzdA==",
"match": {
"OFPMatch": {
"length": 12,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 4294967040
}
}
],
"type": 1
}
}
}
}

Barrier Message

class ryu.ofproto.ofproto_v1_5_parser.OFPBarrierRequest(datapath)
Barrier request message
The controller sends this message to ensure message dependencies have been met or receive notifications for
completed operations.
Example:

436 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

def send_barrier_request(self, datapath):

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPBarrierRequest(datapath)
datapath.send_msg(req)

JSON Example:
{
"OFPBarrierRequest": {}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPBarrierReply(datapath)
Barrier reply message
The switch responds with this message to a barrier request.
Example:
@set_ev_cls(ofp_event.EventOFPBarrierReply, MAIN_DISPATCHER)
def barrier_reply_handler(self, ev):
self.logger.debug('OFPBarrierReply received')

JSON Example:
{
"OFPBarrierReply": {}
}

Role Request Message

class ryu.ofproto.ofproto_v1_5_parser.OFPRoleRequest(datapath, role=None,

short_id=None, genera-
tion_id=None)
Role request message
The controller uses this message to change its role.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

short_id ID number for the controller. The default is OFP-

CID_UNDEFINED.
generation_id Master Election Generation ID

Example:
def send_role_request(self, datapath):
ofp = datapath.ofproto
(continues on next page)

2.5. OpenFlow protocol API Reference 437

ryu Documentation, Release 4.34

(continued from previous page)

ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPRoleRequest(datapath, ofp.OFPCR_ROLE_EQUAL,

ofp.OFPCID_UNDEFINED, 0)
datapath.send_msg(req)

JSON Example:

{
"OFPRoleRequest": {
"generation_id": 1234605616436508552,
"role": 1,
"short_id": 43690
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPRoleReply(datapath, role=None,

short_id=None, genera-
tion_id=None)
Role reply message
The switch responds with this message to a role request.

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

short_id ID number for the controller. The default is OFP-

CID_UNDEFINED.
generation_id Master Election Generation ID

Example:

@set_ev_cls(ofp_event.EventOFPRoleReply, MAIN_DISPATCHER)
def role_reply_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

(continues on next page)

438 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

self.logger.debug('OFPRoleReply received: '
'role=%s short_id=%d, generation_id=%d',
role, msg.short_id, msg.generation_id)

JSON Example:

{
"OFPRoleReply": {
"generation_id": 1234605616436508552,
"role": 1,
"short_id": 43690
}
}

Bundle Messages

class ryu.ofproto.ofproto_v1_5_parser.OFPBundleCtrlMsg(datapath, bundle_id=None,

type_=None, flags=None,
properties=None)
Bundle control message
The controller uses this message to create, destroy and commit bundles

Attribute Description
bundle_id Id of the bundle
type One of the following values.

OFPBCT_OPEN_REQUEST
OFPBCT_OPEN_REPLY
OFPBCT_CLOSE_REQUEST
OFPBCT_CLOSE_REPLY
OFPBCT_COMMIT_REQUEST
OFPBCT_COMMIT_REPLY
OFPBCT_DISCARD_REQUEST
OFPBCT_DISCARD_REPLY

flags Bitmap of the following flags.

OFPBF_ATOMIC
OFPBF_ORDERED

properties List of OFPBundleProp subclass instance

Example:

def send_bundle_control(self, datapath):

ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPBundleCtrlMsg(datapath, 7,
ofp.OFPBCT_OPEN_REQUEST,
(continues on next page)

2.5. OpenFlow protocol API Reference 439

ryu Documentation, Release 4.34

(continued from previous page)

ofp.OFPBF_ATOMIC, [])
datapath.send_msg(req)

JSON Example:
{
"OFPBundleCtrlMsg": {
"bundle_id": 99999999,
"flags": 1,
"properties": [],
"type": 1
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPBundleAddMsg(datapath, bundle_id, flags,

message, properties)
Bundle add message
The controller uses this message to add a message to a bundle

Attribute Description
bundle_id Id of the bundle
flags Bitmap of the following flags.

OFPBF_ATOMIC
OFPBF_ORDERED

message MsgBase subclass instance

properties List of OFPBundleProp subclass instance

Example:
def send_bundle_add_message(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

msg = ofp_parser.OFPRoleRequest(datapath, ofp.OFPCR_ROLE_EQUAL, 0)

req = ofp_parser.OFPBundleAddMsg(datapath, 7, ofp.OFPBF_ATOMIC,

msg, [])
datapath.send_msg(req)

JSON Example:
{
"OFPBundleAddMsg": {
"bundle_id": 99999999,
"flags": 1,
"message": {
"OFPFlowMod": {
"buffer_id": 0,
"command": 0,
"cookie": 1311768467463790320,
"cookie_mask": 18446744073709551615,
"flags": 0,
(continues on next page)

440 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"hard_timeout": 0,
"idle_timeout": 0,
"importance": 39032,
"instructions": [
{
"OFPInstructionActions": {
"actions": [
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.9"
}
},
"len": 16,
"type": 25
}
},
{
"NXActionLearn": {
"cookie": 0,
"experimenter": 8992,
"fin_hard_timeout": 0,
"fin_idle_timeout": 0,
"flags": 0,
"hard_timeout": 300,
"idle_timeout": 0,
"len": 96,
"priority": 1,
"specs": [
{
"NXFlowSpecMatch": {
"dst": [
"vlan_vid",
0
],
"n_bits": 12,
"src": [
"vlan_vid",
0
]
}
},
{
"NXFlowSpecMatch": {
"dst": [
"eth_dst_nxm",
0
],
(continues on next page)

2.5. OpenFlow protocol API Reference 441

ryu Documentation, Release 4.34

(continued from previous page)

"n_bits": 48,
"src": [
"eth_src_nxm",
0
]
}
},
{
"NXFlowSpecLoad": {
"dst": [
"vlan_vid",
0
],
"n_bits": 12,
"src": 0
}
},
{
"NXFlowSpecLoad": {
"dst": [
"tunnel_id_nxm",
0
],
"n_bits": 64,
"src": [
"tunnel_id_nxm",
0
]
}
},
{
"NXFlowSpecOutput": {
"dst": "",
"n_bits": 32,
"src": [
"in_port",
0
]
}
}
],
"subtype": 16,
"table_id": 99,
"type": 65535
}
}
],
"len": 128,
"type": 4
}
},
{
"OFPInstructionGotoTable": {
"len": 8,
"table_id": 100,
"type": 1
}
(continues on next page)

442 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
],
"match": {
"OFPMatch": {
"length": 70,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 43981
}
},
{
"OXMTlv": {
"field": "eth_dst",
"mask": null,
"value": "aa:bb:cc:99:88:77"
}
},
{
"OXMTlv": {
"field": "eth_type",
"mask": null,
"value": 2048
}
},
{
"OXMTlv": {
"field": "vlan_vid",
"mask": null,
"value": 5095
}
},
{
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.1"
}
},
{
"OXMTlv": {
"field": "tunnel_id",
"mask": null,
"value": 50000
}
},
{
"OXMTlv": {
"field": "tun_ipv4_src",
"mask": null,
"value": "192.168.2.3"
}
},
{
"OXMTlv": {
(continues on next page)

2.5. OpenFlow protocol API Reference 443

ryu Documentation, Release 4.34

(continued from previous page)

"field": "tun_ipv4_dst",
"mask": null,
"value": "192.168.2.4"
}
}
],
"type": 1
}
},
"out_group": 0,
"out_port": 0,
"priority": 0,
"table_id": 2
}
},
"properties": []
}
}

Set Asynchronous Configuration Message

class ryu.ofproto.ofproto_v1_5_parser.OFPSetAsync(datapath, properties=None)

Set asynchronous configuration message
The controller sends this message to set the asynchronous messages that it wants to receive on a given OpneFlow
channel.

Attribute Description
properties List of OFPAsyncConfigProp subclass instances

Example:
def send_set_async(self, datapath):
ofp = datapath.ofproto
ofp_parser = datapath.ofproto_parser

JSON Example:
{
"OFPSetAsync": {
"properties": [
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 0
(continues on next page)

444 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 1
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 2
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 3
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 4
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 5
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 6
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 7
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 8
}
(continues on next page)

2.5. OpenFlow protocol API Reference 445

ryu Documentation, Release 4.34

(continued from previous page)

},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 9
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 10
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 11
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65534
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
]
}
}

446 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPGetAsyncRequest(datapath)
Get asynchronous configuration request message
The controller uses this message to query the asynchronous message.
Example:
def send_get_async_request(self, datapath):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPGetAsyncRequest(datapath)
datapath.send_msg(req)

JSON Example:
{
"OFPGetAsyncRequest": {}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPGetAsyncReply(datapath, properties=None)

Get asynchronous configuration reply message
The switch responds with this message to a get asynchronous configuration request.

Attribute Description
properties List of OFPAsyncConfigProp subclass instances

Example:
@set_ev_cls(ofp_event.EventOFPGetAsyncReply, MAIN_DISPATCHER)
def get_async_reply_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPGetAsyncReply received: '

'properties=%s', repr(msg.properties))

2.5. OpenFlow protocol API Reference 447

ryu Documentation, Release 4.34

(continued from previous page)

"mask": 3,
"type": 2
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 3
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 4
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 5
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 6
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 7
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 8
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 24,
"type": 9
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
(continues on next page)

448 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"type": 10
}
},
{
"OFPAsyncConfigPropReasons": {
"length": 8,
"mask": 3,
"type": 11
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65534
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPAsyncConfigPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
]
}
}

Asynchronous Messages

Packet-In Message

class ryu.ofproto.ofproto_v1_5_parser.OFPPacketIn(datapath, buffer_id=None, to-

tal_len=None, reason=None,
table_id=None, cookie=None,
match=None, data=None)
Packet-In message

2.5. OpenFlow protocol API Reference 449

ryu Documentation, Release 4.34

The switch sends the packet that received to the controller by this message.

Attribute Description
buffer_id ID assigned by datapath
total_len Full length of frame
reason Reason packet is being sent.

OFPR_TABLE_MISS
OFPR_APPLY_ACTION
OFPR_INVALID_TTL
OFPR_ACTION_SET
OFPR_GROUP
OFPR_PACKET_OUT

table_id ID of the table that was looked up

cookie Cookie of the flow entry that was looked up
match Instance of OFPMatch
data Ethernet frame

Example:
@set_ev_cls(ofp_event.EventOFPPacketIn, MAIN_DISPATCHER)
def packet_in_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

self.logger.debug('OFPPacketIn received: '

'buffer_id=%x total_len=%d reason=%s '
'table_id=%d cookie=%d match=%s data=%s',
msg.buffer_id, msg.total_len, reason,
msg.table_id, msg.cookie, msg.match,
utils.hex_array(msg.data))

JSON Example:
{
"OFPPacketIn": {
"buffer_id": 200,
"cookie": 0,
(continues on next page)

450 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"data": "aG9nZQ==",
"match": {
"OFPMatch": {
"length": 40,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 43981
}
},
{
"OXMTlv": {
"field": "tunnel_id",
"mask": null,
"value": 50000
}
},
{
"OXMTlv": {
"field": "tun_ipv4_src",
"mask": null,
"value": "192.168.2.3"
}
},
{
"OXMTlv": {
"field": "tun_ipv4_dst",
"mask": null,
"value": "192.168.2.4"
}
}
],
"type": 1
}
},
"reason": 0,
"table_id": 100,
"total_len": 1000
}
}

Flow Removed Message

class ryu.ofproto.ofproto_v1_5_parser.OFPFlowRemoved(datapath, table_id=None,

reason=None, prior-
ity=None, idle_timeout=None,
hard_timeout=None,
cookie=None, match=None,
stats=None)
Flow removed message
When flow entries time out or are deleted, the switch notifies controller with this message.

2.5. OpenFlow protocol API Reference 451

ryu Documentation, Release 4.34

Attribute Description
table_id ID of the table
reason One of the following values.

OFPRR_IDLE_TIMEOUT
OFPRR_HARD_TIMEOUT
OFPRR_DELETE
OFPRR_GROUP_DELETE
OFPRR_METER_DELETE
OFPRR_EVICTION

priority Priority level of flow entry

idle_timeout Idle timeout from original flow mod
hard_timeout Hard timeout from original flow mod
cookie Opaque controller-issued identifier
match Instance of OFPMatch
stats Instance of OFPStats

Example:

@set_ev_cls(ofp_event.EventOFPFlowRemoved, MAIN_DISPATCHER)
def flow_removed_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPRR_IDLE_TIMEOUT:
reason = 'IDLE TIMEOUT'
elif msg.reason == ofp.OFPRR_HARD_TIMEOUT:
reason = 'HARD TIMEOUT'
elif msg.reason == ofp.OFPRR_DELETE:
reason = 'DELETE'
elif msg.reason == ofp.OFPRR_GROUP_DELETE:
reason = 'GROUP DELETE'
elif msg.reason == ofp.OFPRR_METER_DELETE:
reason = 'METER DELETE'
elif msg.reason == ofp.OFPRR_EVICTION:
reason = 'EVICTION'
else:
reason = 'unknown'

self.logger.debug('OFPFlowRemoved received: '

'table_id=%d reason=%s priority=%d '
'idle_timeout=%d hard_timeout=%d cookie=%d '
'match=%s stats=%s',
msg.table_id, reason, msg.priority,
msg.idle_timeout, msg.hard_timeout, msg.cookie,
msg.match, msg.stats)

JSON Example:

{
"OFPFlowRemoved": {
"cookie": 1234605616436508552,
(continues on next page)

452 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

"hard_timeout": 255,
"idle_timeout": 255,
"match": {
"OFPMatch": {
"length": 12,
"oxm_fields": [
{
"OXMTlv": {
"field": "in_port",
"mask": null,
"value": 1
}
}
],
"type": 1
}
},
"priority": 1,
"reason": 0,
"stats": {
"OFPStats": {
"length": 12,
"oxs_fields": [
{
"OXSTlv": {
"field": "flow_count",
"value": 1
}
}
]
}
},
"table_id": 1
}
}

Port Status Message

class ryu.ofproto.ofproto_v1_5_parser.OFPPortStatus(datapath, reason=None,

desc=None)
Port status message
The switch notifies controller of change of ports.

Attribute Description
reason One of the following values.

OFPPR_ADD
OFPPR_DELETE
OFPPR_MODIFY

desc instance of OFPPort

Example:

2.5. OpenFlow protocol API Reference 453

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPPortStatus, MAIN_DISPATCHER)
def port_status_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPPR_ADD:
reason = 'ADD'
elif msg.reason == ofp.OFPPR_DELETE:
reason = 'DELETE'
elif msg.reason == ofp.OFPPR_MODIFY:
reason = 'MODIFY'
else:
reason = 'unknown'

self.logger.debug('OFPPortStatus received: reason=%s desc=%s',

reason, msg.desc)

JSON Example:

{
"OFPPortStatus": {
"desc": {
"OFPPort": {
"config": 0,
"hw_addr": "f2:0b:a4:d0:3f:70",
"length": 168,
"name": "\u79c1\u306e\u30dd\u30fc\u30c8",
"port_no": 7,
"properties": [
{
"OFPPortDescPropEthernet": {
"advertised": 10240,
"curr": 10248,
"curr_speed": 5000,
"length": 32,
"max_speed": 5000,
"peer": 10248,
"supported": 10248,
"type": 0
}
},
{
"OFPPortDescPropOptical": {
"length": 40,
"rx_grid_freq_lmda": 1500,
"rx_max_freq_lmda": 2000,
"rx_min_freq_lmda": 1000,
"supported": 1,
"tx_grid_freq_lmda": 1500,
"tx_max_freq_lmda": 2000,
"tx_min_freq_lmda": 1000,
"tx_pwr_max": 2000,
"tx_pwr_min": 1000,
"type": 1
}
},
(continues on next page)

454 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

Controller Role Status Message

class ryu.ofproto.ofproto_v1_5_parser.OFPRoleStatus(datapath, role=None, rea-

son=None, generation_id=None,
properties=None)
Role status message
The switch notifies controller of change of role.

2.5. OpenFlow protocol API Reference 455

ryu Documentation, Release 4.34

Attribute Description
role One of the following values.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER

reason One of the following values.

OFPCRR_MASTER_REQUEST
OFPCRR_CONFIG
OFPCRR_EXPERIMENTER

generation_id Master Election Generation ID

properties List of OFPRoleProp subclass instance

Example:
@set_ev_cls(ofp_event.EventOFPRoleStatus, MAIN_DISPATCHER)
def role_status_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

self.logger.debug('OFPRoleStatus received: role=%s reason=%s '

'generation_id=%d properties=%s', role, reason,
msg.generation_id, repr(msg.properties))

JSON Example:
{
"OFPRoleStatus": {
"generation_id": 17356517385562371090,
"properties": [],
"reason": 0,
"role": 3
}
(continues on next page)

456 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

(continued from previous page)

}

Table Status Message

class ryu.ofproto.ofproto_v1_5_parser.OFPTableStatus(datapath, reason=None, ta-

ble=None)
Table status message
The switch notifies controller of change of table status.

Attribute Description
reason One of the following values.

OFPTR_VACANCY_DOWN
OFPTR_VACANCY_UP

table OFPTableDesc instance

Example:

@set_ev_cls(ofp_event.EventOFPTableStatus, MAIN_DISPATCHER)
def table(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.reason == ofp.OFPTR_VACANCY_DOWN:
reason = 'VACANCY_DOWN'
elif msg.reason == ofp.OFPTR_VACANCY_UP:
reason = 'VACANCY_UP'
else:
reason = 'unknown'

self.logger.debug('OFPTableStatus received: reason=%s '

'table_id=%d config=0x%08x properties=%s',
reason, msg.table.table_id, msg.table.config,
repr(msg.table.properties))

JSON Example:

{
"OFPTableStatus": {
"reason": 3,
"table": {
"OFPTableDesc": {
"config": 0,
"length": 80,
"properties": [
{
"OFPTableModPropEviction": {
"flags": 0,
"length": 8,
"type": 2
(continues on next page)

2.5. OpenFlow protocol API Reference 457

ryu Documentation, Release 4.34

(continued from previous page)

}
},
{
"OFPTableModPropVacancy": {
"length": 8,
"type": 3,
"vacancy": 0,
"vacancy_down": 0,
"vacancy_up": 0
}
},
{
"OFPTableModPropExperimenter": {
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1
],
"exp_type": 1,
"experimenter": 101,
"length": 16,
"type": 65535
}
},
{
"OFPTableModPropExperimenter": {
"data": [
1,
2
],
"exp_type": 2,
"experimenter": 101,
"length": 20,
"type": 65535
}
}
],
"table_id": 8
}
}
}
}

Request Forward Message

class ryu.ofproto.ofproto_v1_5_parser.OFPRequestForward(datapath, request=None)

Forwarded request message
The swtich forwards request messages from one controller to other controllers.

458 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
request OFPGroupMod or OFPMeterMod instance

Example:
@set_ev_cls(ofp_event.EventOFPRequestForward, MAIN_DISPATCHER)
def request_forward_handler(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto

if msg.request.msg_type == ofp.OFPT_GROUP_MOD:
self.logger.debug(
'OFPRequestForward received: request=OFPGroupMod('
'command=%d, type=%d, group_id=%d, command_bucket_id=%d, '
'buckets=%s, properties=%s)',
msg.request.command, msg.request.type,
msg.request.group_id, msg.request.command_bucket_id,
msg.request.buckets, repr(msg.request.properties))
elif msg.request.msg_type == ofp.OFPT_METER_MOD:
self.logger.debug(
'OFPRequestForward received: request=OFPMeterMod('
'command=%d, flags=%d, meter_id=%d, bands=%s)',
msg.request.command, msg.request.flags,
msg.request.meter_id, msg.request.bands)
else:
self.logger.debug(
'OFPRequestForward received: request=Unknown')

JSON Example:
{
"OFPRequestForward": {
"request": {
"OFPGroupMod": {
"bucket_array_len": 56,
"buckets": [
{
"OFPBucket": {
"action_array_len": 24,
"actions": [
{
"OFPActionPopVlan": {
"len": 8,
"type": 18
}
},
{
"OFPActionSetField": {
"field": {
"OXMTlv": {
"field": "ipv4_dst",
"mask": null,
"value": "192.168.2.9"
}
},
"len": 16,
(continues on next page)

2.5. OpenFlow protocol API Reference 459

ryu Documentation, Release 4.34

(continued from previous page)

"type": 25
}
}
],
"bucket_id": 305419896,
"len": 56,
"properties": [
{
"OFPGroupBucketPropWeight": {
"length": 8,
"type": 0,
"weight": 52428
}
},
{
"OFPGroupBucketPropWatch": {
"length": 8,
"type": 1,
"watch": 56797
}
},
{
"OFPGroupBucketPropWatch": {
"length": 8,
"type": 2,
"watch": 4008636142
}
}
]
}
}
],
"command": 3,
"command_bucket_id": 3149642683,
"group_id": 2863311530,
"properties": [],
"type": 1
}
}
}
}

Controller Status Message

class ryu.ofproto.ofproto_v1_5_parser.OFPControllerStatus(datapath, sta-

tus=None)
Controller status message
The switch informs the controller about the status of the control channel it maintains with each controller.

Attribute Description
status OFPControllerStatusStats instance

Example:

460 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPControllerStatus, MAIN_DISPATCHER)
def table(self, ev):
msg = ev.msg
dp = msg.datapath
ofp = dp.ofproto
status = msg.status

if status.role == ofp.OFPCR_ROLE_NOCHANGE:
role = 'NOCHANGE'
elif status.role == ofp.OFPCR_ROLE_EQUAL:
role = 'EQUAL'
elif status.role == ofp.OFPCR_ROLE_MASTER:
role = 'MASTER'
elif status.role == ofp.OFPCR_ROLE_SLAVE:
role = 'SLAVE'
else:
role = 'unknown'

if status.reason == ofp.OFPCSR_REQUEST:
reason = 'REQUEST'
elif status.reason == ofp.OFPCSR_CHANNEL_STATUS:
reason = 'CHANNEL_STATUS'
elif status.reason == ofp.OFPCSR_ROLE:
reason = 'ROLE'
elif status.reason == ofp.OFPCSR_CONTROLLER_ADDED:
reason = 'CONTROLLER_ADDED'
elif status.reason == ofp.OFPCSR_CONTROLLER_REMOVED:
reason = 'CONTROLLER_REMOVED'
elif status.reason == ofp.OFPCSR_SHORT_ID:
reason = 'SHORT_ID'
elif status.reason == ofp.OFPCSR_EXPERIMENTER:
reason = 'EXPERIMENTER'
else:
reason = 'unknown'

if status.channel_status == OFPCT_STATUS_UP:
channel_status = 'UP'
if status.channel_status == OFPCT_STATUS_DOWN:
channel_status = 'DOWN'
else:
channel_status = 'unknown'

self.logger.debug('OFPControllerStatus received: short_id=%d'

'role=%s reason=%s channel_status=%s '
'properties=%s',
status.short_id, role, reason, channel_status,
repr(status.properties))

JSON Example:

{
"OFPControllerStatus": {
"status": {
"OFPControllerStatusStats": {
"channel_status": 1,
"length": 48,
"properties": [
(continues on next page)

2.5. OpenFlow protocol API Reference 461

ryu Documentation, Release 4.34

(continued from previous page)

{
"OFPControllerStatusPropUri": {
"length": 26,
"type": 0,
"uri": "tls:192.168.34.23:6653"
}
}
],
"reason": 1,
"role": 1,
"short_id": 65535
}
}
}
}

Symmetric Messages

Hello

class ryu.ofproto.ofproto_v1_5_parser.OFPHello(datapath, elements=None)

Attribute Description
elements list of OFPHelloElemVersionBitmap instance

JSON Example:
{
"OFPHello": {
"elements": [
{
"OFPHelloElemVersionBitmap": {
"length": 8,
"type": 1,
"versions": [
6
]
}
}
]
}
}

class ryu.ofproto.ofproto_v1_5_parser.OFPHelloElemVersionBitmap(versions,
type_=None,
length=None)
Version bitmap Hello Element

Attribute Description
versions list of versions of OpenFlow protocol a device supports

462 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Echo Request

class ryu.ofproto.ofproto_v1_5_parser.OFPEchoRequest(datapath, data=None)

Echo request message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data

Example:
def send_echo_request(self, datapath, data):
ofp_parser = datapath.ofproto_parser

req = ofp_parser.OFPEchoRequest(datapath, data)

datapath.send_msg(req)

JSON Example:
{
"OFPEchoRequest": {
"data": ""
}
}

Echo Reply

class ryu.ofproto.ofproto_v1_5_parser.OFPEchoReply(datapath, data=None)

Echo reply message
This message is handled by the Ryu framework, so the Ryu application do not need to process this typically.

Attribute Description
data An arbitrary length data

Example:
def send_echo_reply(self, datapath, data):
ofp_parser = datapath.ofproto_parser

reply = ofp_parser.OFPEchoReply(datapath, data)

datapath.send_msg(reply)

2.5. OpenFlow protocol API Reference 463

ryu Documentation, Release 4.34

JSON Example:

{
"OFPEchoReply": {
"data": ""
}
}

Error Message

class ryu.ofproto.ofproto_v1_5_parser.OFPErrorMsg(datapath, type_=None, code=None,

data=None, **kwargs)
Error message
The switch notifies controller of problems by this message.

Attribute Description
type High level type of error
code Details depending on the type
data Variable length data depending on the type and code

type attribute corresponds to type_ parameter of init.

Types and codes are defined in ryu.ofproto.ofproto.

If type == OFPET_EXPERIMENTER, this message has also the following attributes.

Attribute Description
exp_type Experimenter defined type
experimenter Experimenter ID

Example:

464 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

@set_ev_cls(ofp_event.EventOFPErrorMsg,
[HANDSHAKE_DISPATCHER, CONFIG_DISPATCHER, MAIN_DISPATCHER])
def error_msg_handler(self, ev):
msg = ev.msg

self.logger.debug('OFPErrorMsg received: type=0x%02x code=0x%02x '

'message=%s',
msg.type, msg.code, utils.hex_array(msg.data))

JSON Example:

{
"OFPErrorMsg": {
"code": 6,
"data": "Bg4ACAAAAAA=",
"type": 4
}
}

Experimenter

class ryu.ofproto.ofproto_v1_5_parser.OFPExperimenter(datapath, exper-

imenter=None,
exp_type=None, data=None)
Experimenter extension message

Attribute Description
experimenter Experimenter ID
exp_type Experimenter defined
data Experimenter defined arbitrary additional data

JSON Example:

{
"OFPErrorMsg": {
"code": null,
"data": "amlra2VuIGRhdGE=",
"exp_type": 60000,
"experimenter": 999999,
"type": 65535
}
}

Port Structures

class ryu.ofproto.ofproto_v1_5_parser.OFPPort(port_no=None, length=None,

hw_addr=None, name=None, con-
fig=None, state=None, properties=None)
Description of a port

2.5. OpenFlow protocol API Reference 465

ryu Documentation, Release 4.34

OFPPC_PORT_DOWN
OFPPC_NO_RECV
OFPPC_NO_FWD
OFPPC_NO_PACKET_IN

state Bitmap of port state flags.

OFPPS_LINK_DOWN
OFPPS_BLOCKED
OFPPS_LIVE

properties List of OFPPortDescProp subclass instance

Flow Match Structure

class ryu.ofproto.ofproto_v1_5_parser.OFPMatch(type_=None, length=None, _or-

Argument Value Description

466 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Table 4 – continued from previous page

Argument Value Description
sctp_src Integer 16bit SCTP source port
sctp_dst Integer 16bit SCTP destination port
icmpv4_type Integer 8bit ICMP type
icmpv4_code Integer 8bit ICMP code
arp_op Integer 16bit ARP opcode
arp_spa IPv4 address ARP source IPv4 address
arp_tpa IPv4 address ARP target IPv4 address
arp_sha MAC address ARP source hardware address
arp_tha MAC address ARP target hardware address
ipv6_src IPv6 address IPv6 source address
ipv6_dst IPv6 address IPv6 destination address
ipv6_flabel Integer 32bit IPv6 Flow Label
icmpv6_type Integer 8bit ICMPv6 type
icmpv6_code Integer 8bit ICMPv6 code
ipv6_nd_target IPv6 address Target address for ND
ipv6_nd_sll MAC address Source link-layer for ND
ipv6_nd_tll MAC address Target link-layer for ND
mpls_label Integer 32bit MPLS label
mpls_tc Integer 8bit MPLS TC
mpls_bos Integer 8bit MPLS BoS bit
pbb_isid Integer 24bit PBB I-SID
tunnel_id Integer 64bit Logical Port Metadata
ipv6_exthdr Integer 16bit IPv6 Extension Header pseudo-field
pbb_uca Integer 8bit PBB UCA header field
tcp_flags Integer 16bit TCP flags
actset_output Integer 32bit Output port from action set metadata
packet_type Integer 32bit Packet type value

Example:

Note: For the list of the supported Nicira experimenter matches, please refer to ryu.ofproto.nx_match.

Note: For VLAN id match field, special values are defined in OpenFlow Spec.
1) Packets with and without a VLAN tag
• Example:

2.5. OpenFlow protocol API Reference 467

ryu Documentation, Release 4.34

match = parser.OFPMatch()

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

2) Only packets without a VLAN tag

• Example:
match = parser.OFPMatch(vlan_vid=0x0000)

• Packet Matching

non-VLAN-tagged MATCH
VLAN-tagged(vlan_id=3) x
VLAN-tagged(vlan_id=5) x

3) Only packets with a VLAN tag regardless of its value

• Example:
match = parser.OFPMatch(vlan_vid=(0x1000, 0x1000))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) MATCH

4) Only packets with VLAN tag and VID equal

• Example:
match = parser.OFPMatch(vlan_vid=(0x1000 | 3))

• Packet Matching

non-VLAN-tagged x
VLAN-tagged(vlan_id=3) MATCH
VLAN-tagged(vlan_id=5) x

Flow Stats Structures

class ryu.ofproto.ofproto_v1_5_parser.OFPStats(length=None, _ordered_fields=None,

**kwargs)
Flow Stats Structure
This class is implementation of the flow stats structure having compose/query API.
You can define the flow stats by the keyword arguments. The following arguments are available.

468 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Argu- Value Description

ment
dura- Integer Time flow entry has been alive. This field is a tuple of two Integer 32bit. The first
tion 32bit*2 value is duration_sec and the second is duration_nsec.
idle_time Integer Time flow entry has been idle.
32bit*2
flow_countInteger Number of aggregated flow entries.
32bit
packet_count
Integer Number of packets matched by a flow entry.
64bit
byte_count Integer Number of bytes matched by a flow entry.
64bit

Example:
>>> # compose
>>> stats = parser.OFPStats(
... packet_count=100,
... duration=(100, 200)
>>> # query
>>> if 'duration' in stats:
... print stats['duration']
...
(100, 200)

Flow Instruction Structures

class ryu.ofproto.ofproto_v1_5_parser.OFPInstructionGotoTable(table_id,
type_=None,
len_=None)
Goto table instruction
This instruction indicates the next table in the processing pipeline.

Attribute Description
table_id Next table

class ryu.ofproto.ofproto_v1_5_parser.OFPInstructionWriteMetadata(metadata,
meta-
data_mask,
type_=None,
len_=None)
Write metadata instruction
This instruction writes the masked metadata value into the metadata field.

Attribute Description
metadata Metadata value to write
metadata_mask Metadata write bitmask

class ryu.ofproto.ofproto_v1_5_parser.OFPInstructionActions(type_, ac-

tions=None,
len_=None)
Actions instruction

2.5. OpenFlow protocol API Reference 469

ryu Documentation, Release 4.34

This instruction writes/applies/clears the actions.

Attribute Description
type One of following values.

OFPIT_WRITE_ACTIONS
OFPIT_APPLY_ACTIONS
OFPIT_CLEAR_ACTIONS

actions list of OpenFlow action class

type attribute corresponds to type_ parameter of init.

class ryu.ofproto.ofproto_v1_5_parser.OFPInstructionStatTrigger(flags,
thresholds,
type_=None,
len_=None)
Statistics triggers instruction
This instruction defines a set of statistics thresholds using OXS.

Attribute Description
flags Bitmap of the following flags.

OFPSTF_PERIODIC
OFPSTF_ONLY_FIRST

thresholds Instance of OFPStats

Action Structures

class ryu.ofproto.ofproto_v1_5_parser.OFPActionOutput(port, max_len=65509,

type_=None, len_=None)
Output action
This action indicates output a packet to the switch port.

Attribute Description
port Output port
max_len Max length to send to controller

class ryu.ofproto.ofproto_v1_5_parser.OFPActionCopyTtlOut(type_=None,
len_=None)
Copy TTL Out action
This action copies the TTL from the next-to-outermost header with TTL to the outermost header with TTL.
class ryu.ofproto.ofproto_v1_5_parser.OFPActionCopyTtlIn(type_=None,
len_=None)
Copy TTL In action
This action copies the TTL from the outermost header with TTL to the next-to-outermost header with TTL.
class ryu.ofproto.ofproto_v1_5_parser.OFPActionSetMplsTtl(mpls_ttl, type_=None,
len_=None)
Set MPLS TTL action

470 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

This action sets the MPLS TTL.

Attribute Description
mpls_ttl MPLS TTL

class ryu.ofproto.ofproto_v1_5_parser.OFPActionDecMplsTtl(type_=None,
len_=None)
Decrement MPLS TTL action
This action decrements the MPLS TTL.
class ryu.ofproto.ofproto_v1_5_parser.OFPActionPushVlan(ethertype=33024,
type_=None, len_=None)
Push VLAN action
This action pushes a new VLAN tag to the packet.

Attribute Description
ethertype Ether type. The default is 802.1Q. (0x8100)

class ryu.ofproto.ofproto_v1_5_parser.OFPActionPopVlan(type_=None, len_=None)

Pop VLAN action
This action pops the outermost VLAN tag from the packet.
class ryu.ofproto.ofproto_v1_5_parser.OFPActionPushMpls(ethertype=34887,
type_=None, len_=None)
Push MPLS action
This action pushes a new MPLS header to the packet.

Attribute Description
ethertype Ether type

class ryu.ofproto.ofproto_v1_5_parser.OFPActionPopMpls(ethertype=2048,
type_=None, len_=None)
Pop MPLS action
This action pops the MPLS header from the packet.
class ryu.ofproto.ofproto_v1_5_parser.OFPActionSetQueue(queue_id, type_=None,
len_=None)
Set queue action
This action sets the queue id that will be used to map a flow to an already-configured queue on a port.

Attribute Description
queue_id Queue ID for the packets

class ryu.ofproto.ofproto_v1_5_parser.OFPActionGroup(group_id=0, type_=None,

len_=None)
Group action
This action indicates the group used to process the packet.

Attribute Description
group_id Group identifier

2.5. OpenFlow protocol API Reference 471

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPActionSetNwTtl(nw_ttl, type_=None,

len_=None)
Set IP TTL action
This action sets the IP TTL.

Attribute Description
nw_ttl IP TTL

class ryu.ofproto.ofproto_v1_5_parser.OFPActionDecNwTtl(type_=None, len_=None)

Decrement IP TTL action
This action decrements the IP TTL.
class ryu.ofproto.ofproto_v1_5_parser.OFPActionSetField(field=None, **kwargs)
Set field action
This action modifies a header field in the packet.
The set of keywords available for this is same as OFPMatch which including with/without mask.
Example:

set_field = OFPActionSetField(eth_src="00:00:00:00:00:00")
set_field = OFPActionSetField(ipv4_src=("192.168.100.0",
"255.255.255.0"))

class ryu.ofproto.ofproto_v1_5_parser.OFPActionPushPbb(ethertype, type_=None,

len_=None)
Push PBB action
This action pushes a new PBB header to the packet.

Attribute Description
ethertype Ether type

class ryu.ofproto.ofproto_v1_5_parser.OFPActionPopPbb(type_=None, len_=None)

Pop PBB action
This action pops the outermost PBB service instance header from the packet.
class ryu.ofproto.ofproto_v1_5_parser.OFPActionCopyField(n_bits=0, src_offset=0,
dst_offset=0,
oxm_ids=None,
type_=None,
len_=None)
Copy Field action
This action copy value between header and register.

At- Description
tribute
n_bits Number of bits to copy.
src_offset
Starting bit offset in source.
dst_offset
Starting bit offset in destination.
oxm_idsList of OFPOxmId instances. The first element of this list, src_oxm_id, identifies the field where the
value is copied from. The second element of this list, dst_oxm_id, identifies the field where the value
is copied to. The default is [].

472 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

class ryu.ofproto.ofproto_v1_5_parser.OFPActionMeter(meter_id, type_=None,

len_=None)
Meter action
This action applies meter (rate limiter)

Attribute Description
meter_id Meter instance

class ryu.ofproto.ofproto_v1_5_parser.OFPActionExperimenter(experimenter)
Experimenter action
This action is an extensible action for the experimenter.

Attribute Description
experimenter Experimenter ID

Note: For the list of the supported Nicira experimenter actions, please refer to ryu.ofproto.nx_actions.

Controller Status Structure

class ryu.ofproto.ofproto_v1_5_parser.OFPControllerStatusStats(short_id=None,
role=None, rea-
son=None,
chan-
nel_status=None,
proper-
ties=None,
length=None)
Controller status structure

2.5. OpenFlow protocol API Reference 473

ryu Documentation, Release 4.34

Attribute Description
length Length of this entry.
short_id ID number which identifies the controller.
role Bitmap of controller’s role flags.

OFPCR_ROLE_NOCHANGE
OFPCR_ROLE_EQUAL
OFPCR_ROLE_MASTER
OFPCR_ROLE_SLAVE

reason Bitmap of controller status reason flags.

OFPCSR_REQUEST
OFPCSR_CHANNEL_STATUS
OFPCSR_ROLE
OFPCSR_CONTROLLER_ADDED
OFPCSR_CONTROLLER_REMOVED
OFPCSR_SHORT_ID
OFPCSR_EXPERIMENTER

channel_status Bitmap of control channel status flags.

OFPCT_STATUS_UP
OFPCT_STATUS_DOWN

properties List of OFPControllerStatusProp subclass

instance

2.6 Nicira Extension Structures

2.6.1 Nicira Extension Actions Structures

The followings shows the supported NXAction classes only in OpenFlow1.0

class ryu.ofproto.ofproto_v1_0_parser.NXActionSetQueue(queue_id, type_=None,

len_=None, vendor=None,
subtype=None)
Set queue action
This action sets the queue that should be used to queue when packets are output.
And equivalent to the followings action of ovs-ofctl command.

set_queue:queue

Attribute Description
queue_id Queue ID for the packets

474 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Note: This actions is supported by OFPActionSetQueue in OpenFlow1.2 or later.

Example:

actions += [parser.NXActionSetQueue(queue_id=10)]

class ryu.ofproto.ofproto_v1_0_parser.NXActionDecTtl(type_=None, len_=None, ven-

dor=None, subtype=None)
Decrement IP TTL action
This action decrements TTL of IPv4 packet or hop limit of IPv6 packet.
And equivalent to the followings action of ovs-ofctl command.

dec_ttl

Note: This actions is supported by OFPActionDecNwTtl in OpenFlow1.2 or later.

Example:

actions += [parser.NXActionDecTtl()]

class ryu.ofproto.ofproto_v1_0_parser.NXActionPushMpls(ethertype, type_=None,

len_=None, vendor=None,
subtype=None)
Push MPLS action
This action pushes a new MPLS header to the packet.
And equivalent to the followings action of ovs-ofctl command.

push_mpls:ethertype

Attribute Description
ethertype Ether type(The value must be either 0x8847 or 0x8848)

Note: This actions is supported by OFPActionPushMpls in OpenFlow1.2 or later.

Example:

match = parser.OFPMatch(dl_type=0x0800)
actions += [parser.NXActionPushMpls(ethertype=0x8847)]

class ryu.ofproto.ofproto_v1_0_parser.NXActionPopMpls(ethertype, type_=None,

len_=None, vendor=None,
subtype=None)
Pop MPLS action
This action pops the MPLS header from the packet.
And equivalent to the followings action of ovs-ofctl command.

2.6. Nicira Extension Structures 475

ryu Documentation, Release 4.34

pop_mpls:ethertype

Attribute Description
ethertype Ether type

Note: This actions is supported by OFPActionPopMpls in OpenFlow1.2 or later.

Example:

match = parser.OFPMatch(dl_type=0x8847)
actions += [parser.NXActionPushMpls(ethertype=0x0800)]

class ryu.ofproto.ofproto_v1_0_parser.NXActionSetMplsTtl(ttl, type_=None,

len_=None, ven-
dor=None, sub-
type=None)
Set MPLS TTL action
This action sets the MPLS TTL.
And equivalent to the followings action of ovs-ofctl command.

set_mpls_ttl:ttl

Attribute Description
ttl MPLS TTL

Note: This actions is supported by OFPActionSetMplsTtl in OpenFlow1.2 or later.

Example:

actions += [parser.NXActionSetMplsTil(ttl=128)]

class ryu.ofproto.ofproto_v1_0_parser.NXActionDecMplsTtl(type_=None, len_=None,

vendor=None, sub-
type=None)
Decrement MPLS TTL action
This action decrements the MPLS TTL.
And equivalent to the followings action of ovs-ofctl command.

dec_mpls_ttl

Note: This actions is supported by OFPActionDecMplsTtl in OpenFlow1.2 or later.

Example:

476 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

actions += [parser.NXActionDecMplsTil()]

class ryu.ofproto.ofproto_v1_0_parser.NXActionSetMplsLabel(label, type_=None,

len_=None, ven-
dor=None, sub-
type=None)
Set MPLS Lavel action
This action sets the MPLS Label.
And equivalent to the followings action of ovs-ofctl command.

set_mpls_label:label

Attribute Description
label MPLS Label

Note: This actions is supported by OFPActionSetField(mpls_label=label) in OpenFlow1.2 or

later.

Example:
actions += [parser.NXActionSetMplsLabel(label=0x10)]

class ryu.ofproto.ofproto_v1_0_parser.NXActionSetMplsTc(tc, type_=None,

len_=None, vendor=None,
subtype=None)
Set MPLS Tc action
This action sets the MPLS Tc.
And equivalent to the followings action of ovs-ofctl command.

set_mpls_tc:tc

Attribute Description
tc MPLS Tc

Note: This actions is supported by OFPActionSetField(mpls_label=tc) in OpenFlow1.2 or later.

Example:
actions += [parser.NXActionSetMplsLabel(tc=0x10)]

The followings shows the supported NXAction classes in OpenFlow1.0 or later

class ryu.ofproto.ofproto_v1_3_parser.NXActionPopQueue(type_=None, len_=None,

experimenter=None, sub-
type=None)
Pop queue action

2.6. Nicira Extension Structures 477

ryu Documentation, Release 4.34

This action restors the queue to the value it was before any set_queue actions were applied.
And equivalent to the followings action of ovs-ofctl command.

pop_queue

Example:

actions += [parser.NXActionPopQueue()]

class ryu.ofproto.ofproto_v1_3_parser.NXActionRegLoad(ofs_nbits, dst, value,

type_=None, len_=None,
experimenter=None, sub-
type=None)
Load literal value action
This action loads a literal value into a field or part of a field.
And equivalent to the followings action of ovs-ofctl command.

load:value->dst[start..end]

At- Description
tribute
ofs_nbits Start and End for the OXM/NXM field. Setting method refer to the nicira_ext.
ofs_nbits
dst OXM/NXM header for destination field
value OXM/NXM value to be loaded

Example:

actions += [parser.NXActionRegLoad(
ofs_nbits=nicira_ext.ofs_nbits(4, 31),
dst="eth_dst",
value=0x112233)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionRegLoad2(dst, value, mask=None,

set_field:value[/mask]->dst

Attribute Description
value OXM/NXM value to be loaded
mask Mask for destination field
dst OXM/NXM header for destination field

Example:

478 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

actions += [parser.NXActionRegLoad2(dst="tun_ipv4_src",
value="192.168.10.0",
mask="255.255.255.0")]

class ryu.ofproto.ofproto_v1_3_parser.NXActionNote(note, type_=None, len_=None,

experimenter=None, sub-
type=None)
Note action
This action does nothing at all.
And equivalent to the followings action of ovs-ofctl command.

note:[hh]..

Attribute Description
note A list of integer type values

Example:

actions += [parser.NXActionNote(note=[0xaa,0xbb,0xcc,0xdd])]

class ryu.ofproto.ofproto_v1_3_parser.NXActionSetTunnel(tun_id, type_=None,

len_=None, experi-
menter=None, sub-
type=None)
Set Tunnel action
This action sets the identifier (such as GRE) to the specified id.
And equivalent to the followings action of ovs-ofctl command.

Note: This actions is supported by OFPActionSetField in OpenFlow1.2 or later.

set_tunnel:id

Attribute Description
tun_id Tunnel ID(32bits)

Example:

actions += [parser.NXActionSetTunnel(tun_id=0xa)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionSetTunnel64(tun_id, type_=None,

len_=None, experi-
menter=None, sub-
type=None)
Set Tunnel action
This action outputs to a port that encapsulates the packet in a tunnel.
And equivalent to the followings action of ovs-ofctl command.

2.6. Nicira Extension Structures 479

ryu Documentation, Release 4.34

Note: This actions is supported by OFPActionSetField in OpenFlow1.2 or later.

set_tunnel64:id

Attribute Description
tun_id Tunnel ID(64bits)

Example:

actions += [parser.NXActionSetTunnel64(tun_id=0xa)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionRegMove(src_field, dst_field, n_bits,

src_ofs=0, dst_ofs=0,
type_=None, len_=None,
experimenter=None, sub-
type=None)
Move register action
This action copies the src to dst.
And equivalent to the followings action of ovs-ofctl command.

move:src[start..end]->dst[start..end ]

Attribute Description
src_field OXM/NXM header for source field
dst_field OXM/NXM header for destination field
n_bits Number of bits
src_ofs Starting bit offset in source
dst_ofs Starting bit offset in destination

Caution:
src_start and src_end difference and dst_start and dst_end difference must be the same.

Example:

actions += [parser.NXActionRegMove(src_field="reg0",
dst_field="reg1",
n_bits=5,
src_ofs=0
dst_ofs=10)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionResubmit(in_port=65528,
type_=None, len_=None,
experimenter=None, sub-
type=None)
Resubmit action
This action searches one of the switch’s flow tables.

480 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

And equivalent to the followings action of ovs-ofctl command.

resubmit:port

Attribute Description
in_port New in_port for checking flow table

Example:

actions += [parser.NXActionResubmit(in_port=8080)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionResubmitTable(in_port=65528,
table_id=255,
type_=None,
len_=None, ex-
perimenter=None,
subtype=None)
Resubmit action
This action searches one of the switch’s flow tables.
And equivalent to the followings action of ovs-ofctl command.

resubmit([port],[table])

Attribute Description
in_port New in_port for checking flow table
table_id Checking flow tables

Example:

actions += [parser.NXActionResubmitTable(in_port=8080,
table_id=10)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionOutputReg(ofs_nbits, src, max_len,

type_=None, len_=None,
experimenter=None, sub-
type=None)
Add output action
This action outputs the packet to the OpenFlow port number read from src.
And equivalent to the followings action of ovs-ofctl command.

output:src[start...end]

At- Description
tribute
ofs_nbits Start and End for the OXM/NXM field. Setting method refer to the nicira_ext.
ofs_nbits
src OXM/NXM header for source field
max_len Max length to send to controller

2.6. Nicira Extension Structures 481

ryu Documentation, Release 4.34

Example:

actions += [parser.NXActionOutputReg(
ofs_nbits=nicira_ext.ofs_nbits(4, 31),
src="reg0",
max_len=1024)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionOutputReg2(ofs_nbits, src, max_len,

output:src[start...end]

Note: Like the NXActionOutputReg but organized so that there is room for a 64-bit experimenter OXM as
’src’.

At- Description
tribute
ofs_nbits Start and End for the OXM/NXM field. Setting method refer to the nicira_ext.
ofs_nbits
src OXM/NXM header for source field
max_len Max length to send to controller

Example:

actions += [parser.NXActionOutputReg2(
ofs_nbits=nicira_ext.ofs_nbits(4, 31),
src="reg0",
max_len=1024)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionLearn(table_id, specs, idle_timeout=0,

hard_timeout=0, prior-
ity=32768, cookie=0,
flags=0, fin_idle_timeout=0,
fin_hard_timeout=0,
type_=None, len_=None, experi-
menter=None, subtype=None)
Adds or modifies flow action
This action adds or modifies a flow in OpenFlow table.
And equivalent to the followings action of ovs-ofctl command.

learn(argument[,argument]...)

482 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
table_id The table in which the new flow should be inserted
specs Adds a match criterion to the new flow
Please use the NXFlowSpecMatch in order to set
the following format

field=value
field[start..end] =

src[start..end] | field[start..end] |
Please use the NXFlowSpecLoad in order to set
the following format

load:value->dst

[start..end] | load:src[start..end] ->dst[start..end] |

Please use the NXFlowSpecOutput in order to set
the following format

output:field[start..end]

idle_timeout Idle time before discarding(seconds)

hard_timeout Max time before discarding(seconds)
priority Priority level of flow entry
cookie Cookie for new flow
flags send_flow_rem
fin_idle_timeout Idle timeout after FIN(seconds)
fin_hard_timeout Hard timeout after FIN(seconds)

Caution: The arguments specify the flow’s match fields, actions, and other properties, as follows. At least
one match criterion and one action argument should ordinarily be specified.

Example:
actions += [
parser.NXActionLearn(able_id=10,
specs=[parser.NXFlowSpecMatch(src=0x800,
dst=('eth_type_nxm', 0),
n_bits=16),
parser.NXFlowSpecMatch(src=('reg1', 1),
dst=('reg2', 3),
n_bits=5),
parser.NXFlowSpecMatch(src=('reg3', 1),
dst=('reg3', 1),
n_bits=5),
parser.NXFlowSpecLoad(src=0,
dst=('reg4', 3),
n_bits=5),
parser.NXFlowSpecLoad(src=('reg5', 1),
dst=('reg6', 3),
n_bits=5),
parser.NXFlowSpecOutput(src=('reg7', 1),
(continues on next page)

2.6. Nicira Extension Structures 483

ryu Documentation, Release 4.34

(continued from previous page)

dst="",
n_bits=5)],
idle_timeout=180,
hard_timeout=300,
priority=1,
cookie=0x64,
flags=ofproto.OFPFF_SEND_FLOW_REM,
fin_idle_timeout=180,
fin_hard_timeout=300)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionExit(type_=None, len_=None, experi-

menter=None, subtype=None)
Halt action
This action causes OpenvSwitch to immediately halt execution of further actions.
And equivalent to the followings action of ovs-ofctl command.

exit

Example:

actions += [parser.NXActionExit()]

class ryu.ofproto.ofproto_v1_3_parser.NXActionController(max_len, controller_id,

reason, type_=None,
len_=None, experi-
menter=None, sub-
type=None)
Send packet in message action
This action sends the packet to the OpenFlow controller as a packet in message.
And equivalent to the followings action of ovs-ofctl command.

controller(key=value...)

Attribute Description
max_len Max length to send to controller
controller_id Controller ID to send packet-in
reason Reason for sending the message

Example:

actions += [
parser.NXActionController(max_len=1024,
controller_id=1,
reason=ofproto.OFPR_INVALID_TTL)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionController2(type_=None,
len_=None, ven-
dor=None, sub-
type=None, **kwargs)
Send packet in message action

484 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

This action sends the packet to the OpenFlow controller as a packet in message.
And equivalent to the followings action of ovs-ofctl command.

controller(key=value...)

Attribute Description
max_len Max length to send to controller
controller_id Controller ID to send packet-in
reason Reason for sending the message
userdata Additional data to the controller in the packet-in message
pause Flag to pause pipeline to resume later

Example:
actions += [
parser.NXActionController(max_len=1024,
controller_id=1,
reason=ofproto.OFPR_INVALID_TTL,
userdata=[0xa,0xb,0xc],
pause=True)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionDecTtlCntIds(cnt_ids, type_=None,

len_=None, ex-
perimenter=None,
subtype=None)
Decrement TTL action
This action decrements TTL of IPv4 packet or hop limits of IPv6 packet.
And equivalent to the followings action of ovs-ofctl command.

dec_ttl(id1[,id2]...)

Attribute Description
cnt_ids Controller ids

Example:
actions += [parser.NXActionDecTtlCntIds(cnt_ids=[1,2,3])]

Note: If you want to set the following ovs-ofctl command. Please use OFPActionDecNwTtl.

dec_ttl

class ryu.ofproto.ofproto_v1_3_parser.NXActionStackPush(field, start, end,

type_=None, len_=None,
experimenter=None,
subtype=None)
Push field action
This action pushes field to top of the stack.

2.6. Nicira Extension Structures 485

ryu Documentation, Release 4.34

And equivalent to the followings action of ovs-ofctl command.

pop:dst[start...end]

Attribute Description
field OXM/NXM header for source field
start Start bit for source field
end End bit for source field

Example:

actions += [parser.NXActionStackPush(field="reg2",
start=0,
end=5)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionStackPop(field, start, end,

type_=None, len_=None,
experimenter=None, sub-
type=None)
Pop field action
This action pops field from top of the stack.
And equivalent to the followings action of ovs-ofctl command.

pop:src[start...end]

Attribute Description
field OXM/NXM header for destination field
start Start bit for destination field
end End bit for destination field

Example:

actions += [parser.NXActionStackPop(field="reg2",
start=0,
end=5)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionSample(probability, col-

lector_set_id=0,
obs_domain_id=0,
obs_point_id=0, type_=None,
len_=None, experi-
menter=None, subtype=None)
Sample packets action
This action samples packets and sends one sample for every sampled packet.
And equivalent to the followings action of ovs-ofctl command.

sample(argument[,argument]...)

486 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Attribute Description
probability The number of sampled packets
collec- The unsigned 32-bit integer identifier of the set of sample collectors to send sampled pack-
tor_set_id ets to
obs_domain_id The Unsigned 32-bit integer Observation Domain ID
obs_point_id The unsigned 32-bit integer Observation Point ID

Example:

actions += [parser.NXActionSample(probability=3,
collector_set_id=1,
obs_domain_id=2,
obs_point_id=3,)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionSample2(probability, col-

lector_set_id=0,
obs_domain_id=0,
obs_point_id=0, sam-
pling_port=0, type_=None,
len_=None, experi-
menter=None, sub-
type=None)
Sample packets action
This action samples packets and sends one sample for every sampled packet. ’sampling_port’ can be equal to
ingress port or one of egress ports.
And equivalent to the followings action of ovs-ofctl command.

sample(argument[,argument]...)

Example:

actions += [parser.NXActionSample2(probability=3,
collector_set_id=1,
obs_domain_id=2,
obs_point_id=3,
sampling_port=8080)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionFinTimeout(fin_idle_timeout,
fin_hard_timeout,
type_=None, len_=None,
experimenter=None,
subtype=None)
Change TCP timeout action

2.6. Nicira Extension Structures 487

ryu Documentation, Release 4.34

This action changes the idle timeout or hard timeout or both, of this OpenFlow rule when the rule matches a
TCP packet with the FIN or RST flag.
And equivalent to the followings action of ovs-ofctl command.

fin_timeout(argument[,argument]...)

Attribute Description
fin_idle_timeout Causes the flow to expire after the given number of seconds of inactivity
fin_idle_timeout Causes the flow to expire after the given number of second, regardless of activity

Example:

match = parser.OFPMatch(ip_proto=6, eth_type=0x0800)

actions += [parser.NXActionFinTimeout(fin_idle_timeout=30,
fin_hard_timeout=60)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionConjunction(clause, n_clauses,

id_, type_=None,
len_=None, experi-
menter=None, sub-
type=None)
Conjunctive matches action
This action ties groups of individual OpenFlow flows into higher-level conjunctive flows. Please refer to the
ovs-ofctl command manual for details.
And equivalent to the followings action of ovs-ofctl command.

conjunction(id,k/n)

Attribute Description
clause Number assigned to the flow’s dimension
n_clauses Specify the conjunctive flow’s match condition
id_ Conjunction ID

Example:

actions += [parser.NXActionConjunction(clause=1,
n_clauses=2,
id_=10)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionMultipath(fields, basis, algorithm,

max_link, arg, ofs_nbits,
dst, type_=None,
len_=None, experi-
menter=None, sub-
type=None)
Select multipath link action
This action selects multipath link based on the specified parameters. Please refer to the ovs-ofctl command
manual for details.
And equivalent to the followings action of ovs-ofctl command.

488 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

multipath(fields, basis, algorithm, n_links, arg, dst[start..end])

Attribute Description
fields One of NX_HASH_FIELDS_*
basis Universal hash parameter
algo- One of NX_MP_ALG_*.
rithm
max_link Number of output links
arg Algorithm-specific argument
ofs_nbits Start and End for the OXM/NXM field. Setting method refer to the nicira_ext.
ofs_nbits
dst OXM/NXM header for source field

Example:
actions += [parser.NXActionMultipath(
fields=nicira_ext.NX_HASH_FIELDS_SYMMETRIC_L4,
basis=1024,
algorithm=nicira_ext.NX_MP_ALG_HRW,
max_link=5,
arg=0,
ofs_nbits=nicira_ext.ofs_nbits(4, 31),
dst="reg2")]

class ryu.ofproto.ofproto_v1_3_parser.NXActionBundle(algorithm, fields, basis,

slave_type, n_slaves, ofs_nbits,
dst, slaves)
Select bundle link action
This action selects bundle link based on the specified parameters. Please refer to the ovs-ofctl command manual
for details.
And equivalent to the followings action of ovs-ofctl command.

bundle(fields, basis, algorithm, slave_type, slaves:[ s1, s2,...])

Attribute Description
algorithm One of NX_MP_ALG_*.
fields One of NX_HASH_FIELDS_*
basis Universal hash parameter
slave_type Type of slaves(must be NXM_OF_IN_PORT)
n_slaves Number of slaves
ofs_nbits Start and End for the OXM/NXM field. (must be zero)
dst OXM/NXM header for source field(must be zero)
slaves List of slaves

Example:
actions += [parser.NXActionBundle(
algorithm=nicira_ext.NX_MP_ALG_HRW,
fields=nicira_ext.NX_HASH_FIELDS_ETH_SRC,
basis=0,
(continues on next page)

2.6. Nicira Extension Structures 489

ryu Documentation, Release 4.34

(continued from previous page)

slave_type=nicira_ext.NXM_OF_IN_PORT,
n_slaves=2,
ofs_nbits=0,
dst=0,
slaves=[2, 3])]

class ryu.ofproto.ofproto_v1_3_parser.NXActionBundleLoad(algorithm, fields, basis,

slave_type, n_slaves,
ofs_nbits, dst, slaves)
Select bundle link action
This action has the same behavior as the bundle action, with one exception. Please refer to the ovs-ofctl com-
mand manual for details.
And equivalent to the followings action of ovs-ofctl command.

bundle_load(fields, basis, algorithm, slave_type, dst[start... emd], slaves:[ s1, s2,...]) |

Attribute Description
algorithm One of NX_MP_ALG_*.
fields One of NX_HASH_FIELDS_*
basis Universal hash parameter
slave_type Type of slaves(must be NXM_OF_IN_PORT)
n_slaves Number of slaves
ofs_nbits Start and End for the OXM/NXM field. Setting method refer to the nicira_ext.
ofs_nbits
dst OXM/NXM header for source field
slaves List of slaves

Example:

actions += [parser.NXActionBundleLoad(
algorithm=nicira_ext.NX_MP_ALG_HRW,
fields=nicira_ext.NX_HASH_FIELDS_ETH_SRC,
basis=0,
slave_type=nicira_ext.NXM_OF_IN_PORT,
n_slaves=2,
ofs_nbits=nicira_ext.ofs_nbits(4, 31),
dst="reg0",
slaves=[2, 3])]

class ryu.ofproto.ofproto_v1_3_parser.NXActionCT(flags, zone_src, zone_ofs_nbits, re-

circ_table, alg, actions, type_=None,
len_=None, experimenter=None,
subtype=None)
Pass traffic to the connection tracker action
This action sends the packet through the connection tracker.
And equivalent to the followings action of ovs-ofctl command.

ct(argument[,argument]...)

490 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

At- Description
tribute
flags Zero or more(Unspecified flag bits must be zero.)
zone_src OXM/NXM header for source field
zone_ofs_nbits
Start and End for the OXM/NXM field. Setting method refer to the nicira_ext.ofs_nbits.
If you need set the Immediate value for zone, zone_src must be set to None or empty character
string.
re- Recirculate to a specific table
circ_table
alg Well-known port number for the protocol
actions Zero or more actions may immediately follow this action

Note: If you set number to zone_src, Traceback occurs when you run the to_jsondict.

Example:

match = parser.OFPMatch(eth_type=0x0800, ct_state=(0,32))

actions += [parser.NXActionCT(
flags = 1,
zone_src = "reg0",
zone_ofs_nbits = nicira_ext.ofs_nbits(4, 31),
recirc_table = 4,
alg = 0,
actions = [])]

class ryu.ofproto.ofproto_v1_3_parser.NXActionNAT(flags, range_ipv4_min=”,

range_ipv4_max=”,
range_ipv6_min=”,
range_ipv6_max=”,
range_proto_min=None,
range_proto_max=None,
type_=None, len_=None, ex-
perimenter=None, subtype=None)
Network address translation action
This action sends the packet through the connection tracker.
And equivalent to the followings action of ovs-ofctl command.

Note: The following command image does not exist in ovs-ofctl command manual and has been created from
the command response.

nat(src=ip_min-ip_max : proto_min-proto-max)

2.6. Nicira Extension Structures 491

ryu Documentation, Release 4.34

Attribute Description
flags Zero or more(Unspecified flag bits must be zero.)
range_ipv4_min Range ipv4 address minimun
range_ipv4_max Range ipv4 address maximun
range_ipv6_min Range ipv6 address minimun
range_ipv6_max Range ipv6 address maximun
range_proto_min Range protocol minimum
range_proto_max Range protocol maximun

Caution: NXActionNAT must be defined in the actions in the NXActionCT.

Example:
match = parser.OFPMatch(eth_type=0x0800)
actions += [
parser.NXActionCT(
flags = 1,
zone_src = "reg0",
zone_ofs_nbits = nicira_ext.ofs_nbits(4, 31),
recirc_table = 255,
alg = 0,
actions = [
parser.NXActionNAT(
flags = 1,
range_ipv4_min = "10.1.12.0",
range_ipv4_max = "10.1.13.255",
range_ipv6_min = "",
range_ipv6_max = "",
range_proto_min = 1,
range_proto_max = 1023
)
]
)
]

class ryu.ofproto.ofproto_v1_3_parser.NXActionOutputTrunc(port, max_len,

type_=None,
len_=None, experi-
menter=None, sub-
type=None)
Truncate output action
This action truncate a packet into the specified size and outputs it.
And equivalent to the followings action of ovs-ofctl command.

output(port=port,max_len=max_len)

Attribute Description
port Output port
max_len Max bytes to send

Example:

492 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

actions += [parser.NXActionOutputTrunc(port=8080,
max_len=1024)]

class ryu.ofproto.ofproto_v1_3_parser.NXActionDecNshTtl(type_=None, len_=None,

vendor=None, sub-
type=None)
Decrement NSH TTL action
This action decrements the TTL in the Network Service Header(NSH).
This action was added in OVS v2.9.
And equivalent to the followings action of ovs-ofctl command.

dec_nsh_ttl

Example:

actions += [parser.NXActionDecNshTtl()]

class ryu.ofproto.ofproto_v1_3_parser.NXFlowSpecMatch(src, dst, n_bits)

Specification for adding match criterion
This class is used by NXActionLearn.
For the usage of this class, please refer to NXActionLearn.

Attribute Description
src OXM/NXM header and Start bit for source field
dst OXM/NXM header and Start bit for destination field
n_bits The number of bits from the start bit

class ryu.ofproto.ofproto_v1_3_parser.NXFlowSpecLoad(src, dst, n_bits)

Add NXAST_REG_LOAD actions
This class is used by NXActionLearn.
For the usage of this class, please refer to NXActionLearn.

Attribute Description
src OXM/NXM header and Start bit for source field
dst OXM/NXM header and Start bit for destination field
n_bits The number of bits from the start bit

class ryu.ofproto.ofproto_v1_3_parser.NXFlowSpecOutput(src, n_bits, dst=”)

Add an OFPAT_OUTPUT action
This class is used by NXActionLearn.
For the usage of this class, please refer to NXActionLearn.

Attribute Description
src OXM/NXM header and Start bit for source field
dst Must be ”
n_bits The number of bits from the start bit

2.6. Nicira Extension Structures 493

ryu Documentation, Release 4.34

ryu.ofproto.nicira_ext.ofs_nbits(start, end)
The utility method for ofs_nbits
This method is used in the class to set the ofs_nbits.
This method converts start/end bits into ofs_nbits required to specify the bit range of OXM/NXM fields.
ofs_nbits can be calculated as following:

ofs_nbits = (start << 6) + (end - start)

The parameter start/end means the OXM/NXM field of ovs-ofctl command.

field[start..end]

Attribute Description
start Start bit for OXM/NXM field
end End bit for OXM/NXM field

2.6.2 Nicira Extended Match Structures

The API of this class is the same as OFPMatch.

You can define the flow match by the keyword arguments. The following arguments are available.

Argument Value Description

in_port_nxm Integer 16bit OpenFlow port number.
eth_dst_nxm MAC address Ethernet destination address.
eth_src_nxm MAC address Ethernet source address.
eth_type_nxm Integer 16bit Ethernet type. Needed to support Nicira extensions that require the eth_type to be set. (i.e. tcp_
vlan_tci Integer 16bit VLAN TCI. Basically same as vlan_vid plus vlan_pcp.
nw_tos Integer 8bit IP ToS or IPv6 traffic class field dscp. Requires setting fields: eth_type_nxm = [0x0800 (IPv4)
ip_proto_nxm Integer 8bit IP protocol. Needed to support Nicira extensions that require the ip_proto to be set. (i.e. tcp_fl
ipv4_src_nxm IPv4 address IPv4 source address. Requires setting fields: eth_type_nxm = 0x0800 (IPv4)
ipv4_dst_nxm IPv4 address IPv4 destination address. Requires setting fields: eth_type_nxm = 0x0800 (IPv4)
tcp_src_nxm Integer 16bit TCP source port. Requires setting fields: eth_type_nxm = [0x0800 (IPv4)|0x86dd (IPv6)] and
tcp_dst_nxm Integer 16bit TCP destination port. Requires setting fields: eth_type_nxm = [0x0800 (IPv4)|0x86dd (IPv6)]
udp_src_nxm Integer 16bit UDP source port. Requires setting fields: eth_type_nxm = [0x0800 (IPv4)|0x86dd (IPv6)] and
udp_dst_nxm Integer 16bit UDP destination port. eth_type_nxm = [0x0800 (IPv4)|0x86dd (IPv6)] and ip_proto_nxm = 17
icmpv4_type_nxm Integer 8bit Type matches the ICMP type and code matches the ICMP code. Requires setting fields: eth_ty
icmpv4_code_nxm Integer 8bit Type matches the ICMP type and code matches the ICMP code. Requires setting fields: eth_ty
arp_op_nxm Integer 16bit Only ARP opcodes between 1 and 255 should be specified for matching. Requires setting field
arp_spa_nxm IPv4 address An address may be specified as an IP address or host name. Requires setting fields: eth_type_n
arp_tpa_nxm IPv4 address An address may be specified as an IP address or host name. Requires setting fields: eth_type_n
tunnel_id_nxm Integer 64bit Tunnel identifier.
arp_sha_nxm MAC address An address is specified as 6 pairs of hexadecimal digits delimited by colons. Requires setting fi
arp_tha_nxm MAC address An address is specified as 6 pairs of hexadecimal digits delimited by colons. Requires setting fi
ipv6_src_nxm IPv6 address IPv6 source address. Requires setting fields: eth_type_nxm = 0x86dd (IPv6)
ipv6_dst_nxm IPv6 address IPv6 destination address. Requires setting fields: eth_type_nxm = 0x86dd (IPv6)
icmpv6_type_nxm Integer 8bit Type matches the ICMP type and code matches the ICMP code. Requires setting fields: eth_ty
icmpv6_code_nxm Integer 8bit Type matches the ICMP type and code matches the ICMP code. Requires setting fields: eth_ty
nd_target IPv6 address The target address ipv6. Requires setting fields: eth_type_nxm = 0x86dd (IPv6) and ip_proto_

494 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

Table 5 – continued from previous pa

Argument Value Description
nd_sll MAC address The source link-layer address option. Requires setting fields: eth_type_nxm = 0x86dd (IPv6) a
nd_tll MAC address The target link-layer address option. Requires setting fields: eth_type_nxm = 0x86dd (IPv6) an
ip_frag Integer 8bit frag_type specifies what kind of IP fragments or non-fragments to match. Requires setting field
ipv6_label Integer 32bit Matches IPv6 flow label. Requires setting fields: eth_type_nxm = 0x86dd (IPv6)
ip_ecn_nxm Integer 8bit Matches ecn bits in IP ToS or IPv6 traffic class fields. Requires setting fields: eth_type_nxm =
nw_ttl Integer 8bit IP TTL or IPv6 hop limit value ttl. Requires setting fields: eth_type_nxm = [0x0800 (IPv4)|0x8
mpls_ttl Integer 8bit The TTL of the outer MPLS label stack entry of a packet. Requires setting fields: eth_type_nxm
tun_ipv4_src IPv4 address Tunnel IPv4 source address. Requires setting fields: eth_type_nxm = 0x0800 (IPv4)
tun_ipv4_dst IPv4 address Tunnel IPv4 destination address. Requires setting fields: eth_type_nxm = 0x0800 (IPv4)
pkt_mark Integer 32bit Packet metadata mark.
tcp_flags_nxm Integer 16bit TCP Flags. Requires setting fields: eth_type_nxm = [0x0800 (IP)|0x86dd (IPv6)] and ip_proto
conj_id Integer 32bit Conjunction ID used only with the conjunction action
tun_gbp_id Integer 16bit The group policy identifier in the VXLAN header.
tun_gbp_flags Integer 8bit The group policy flags in the VXLAN header.
tun_flags Integer 16bit Flags indicating various aspects of the tunnel encapsulation.
ct_state Integer 32bit Conntrack state.
ct_zone Integer 16bit Conntrack zone.
ct_mark Integer 32bit Conntrack mark.
ct_label Integer 128bit Conntrack label.
tun_ipv6_src IPv6 address Tunnel IPv6 source address. Requires setting fields: eth_type_nxm = 0x86dd (IPv6)
tun_ipv6_dst IPv6 address Tunnel IPv6 destination address. Requires setting fields: eth_type_nxm = 0x86dd (IPv6)
_recirc_id Integer 32bit ID for recirculation.
_dp_hash Integer 32bit Flow hash computed in Datapath.
nsh_flags Integer 8bit Flags field in NSH Base Header. Requires eth_type_nxm = 0x894f (NSH). Since OpenFlow 1.
nsh_mdtype Integer 8bit Metadata Type in NSH Base Header. Requires eth_type_nxm = 0x894f (NSH). Since OpenFlo
nsh_np Integer 8bit Next Protocol type in NSH Base Header. Requires eth_type_nxm = 0x894f (NSH). Since Open
nsh_spi Integer 32bit Service Path Identifier in NSH Service Path Header. Requires eth_type_nxm = 0x894f (NSH).
nsh_si Integer 8bit Service Index in NSH Service Path Header. Requires eth_type_nxm = 0x894f (NSH). Since Op
nsh_c<N> Integer 32bit Context fields in NSH Context Header. <N> is a number of 1-4. Requires eth_type_nxm = 0x8
nsh_ttl Integer 8bit TTL field in NSH Base Header. Requires eth_type_nxm = 0x894f (NSH). Since OpenFlow 1.3
reg<idx> Integer 32bit Packet register. <idx> is register number 0-15.
xxreg<idx> Integer 128bit Packet extended-extended register. <idx> is register number 0-3.

Note: Setting the TCP flags via the nicira extensions. This is required when using OVS version < 2.4. When using
the nxm fields, you need to use any nxm prereq fields as well or you will receive a OFPBMC_BAD_PREREQ error
Example:

# WILL NOT work

flag = tcp.TCP_ACK
match = parser.OFPMatch(
tcp_flags_nxm=(flag, flag),
ip_proto=inet.IPPROTO_TCP,
eth_type=eth_type)

# Works
flag = tcp.TCP_ACK
match = parser.OFPMatch(
tcp_flags_nxm=(flag, flag),
ip_proto_nxm=inet.IPPROTO_TCP,
eth_type_nxm=eth_type)

2.6. Nicira Extension Structures 495

ryu Documentation, Release 4.34

2.7 Ryu API Reference

class ryu.base.app_manager.RyuApp(*_args, **_kwargs)

The base class for Ryu applications.
RyuApp subclasses are instantiated after ryu-manager loaded all requested Ryu application modules. __init__
should call RyuApp.__init__ with the same arguments. It’s illegal to send any events in __init__.
The instance attribute ’name’ is the name of the class used for message routing among Ryu applications. (Cf.
send_event) It’s set to __class__.__name__ by RyuApp.__init__. It’s discouraged for subclasses to override
this.
OFP_VERSIONS = None
A list of supported OpenFlow versions for this RyuApp. The default is all versions supported by the
framework.
Examples:

OFP_VERSIONS = [ofproto_v1_0.OFP_VERSION,
ofproto_v1_2.OFP_VERSION]

If multiple Ryu applications are loaded in the system, the intersection of their OFP_VERSIONS is used.
_CONTEXTS = {}
A dictionary to specify contexts which this Ryu application wants to use. Its key is a name of context and
its value is an ordinary class which implements the context. The class is instantiated by app_manager and
the instance is shared among RyuApp subclasses which has _CONTEXTS member with the same key. A
RyuApp subclass can obtain a reference to the instance via its __init__’s kwargs as the following.
Example:

_CONTEXTS = {
'network': network.Network
}

def init(self, args, kwargs):

self.network = kwargs['network']

_EVENTS = []
A list of event classes which this RyuApp subclass would generate. This should be specified if and only if
event classes are defined in a different python module from the RyuApp subclass is.
close()
teardown method. The method name, close, is chosen for python context manager
classmethod context_iteritems()
Return iterator over the (key, contxt class) of application context
reply_to_request(req, rep)
Send a reply for a synchronous request sent by send_request. The first argument should be an instance of
EventRequestBase. The second argument should be an instance of EventReplyBase.
send_event(name, ev, state=None)
Send the specified event to the RyuApp instance specified by name.
send_event_to_observers(ev, state=None)
Send the specified event to all observers of this RyuApp.

496 Chapter 2. Writing Your Ryu Application

ryu Documentation, Release 4.34

send_request(req)
Make a synchronous request. Set req.sync to True, send it to a Ryu application specified by req.dst,
and block until receiving a reply. Returns the received reply. The argument should be an instance of
EventRequestBase.
start()
Hook that is called after startup initialization is done.
class ryu.controller.dpset.DPSet(*args, **kwargs)
DPSet application manages a set of switches (datapaths) connected to this controller.
Usage Example:

# ...(snip)...
from ryu.controller import dpset

class MyApp(app_manager.RyuApp):
_CONTEXTS = {
'dpset': dpset.DPSet,
}

def init(self, *args, **kwargs):

super(MyApp, self).__init__(*args, **kwargs)
# Stores DPSet instance to call its API in this app
self.dpset = kwargs['dpset']

def _my_handler(self):
# Get the datapath object which has the given dpid
dpid = 1
dp = self.dpset.get(dpid)
if dp is None:
self.logger.info('No such datapath: dpid=%d', dpid)

get(dp_id)
This method returns the ryu.controller.controller.Datapath instance for the given Datapath ID.
get_all()
This method returns a list of tuples which represents instances for switches connected to this controller.
The tuple consists of a Datapath ID and an instance of ryu.controller.controller.Datapath.
A return value looks like the following:

[ (dpid_A, Datapath_A), (dpid_B, Datapath_B), ... ]

get_port(dpid, port_no)
This method returns the ryu.controller.dpset.PortState instance for the given Datapath ID and the port
number. Raises ryu_exc.PortNotFound if no such a datapath connected to this controller or no such a port
exists.
get_ports(dpid)
This method returns a list of ryu.controller.dpset.PortState instances for the given Datapath ID. Raises
KeyError if no such a datapath connected to this controller.

2.7. Ryu API Reference 497

ryu Documentation, Release 4.34

498 Chapter 2. Writing Your Ryu Application

CHAPTER 3

Configuration

3.1 Setup TLS Connection

If you want to use secure channel to connect OpenFlow switches, you need to use TLS connection. This document
describes how to setup Ryu to connect to the Open vSwitch over TLS.

3.1.1 Configuring a Public Key Infrastructure

If you don’t have a PKI, the ovs-pki script included with Open vSwitch can help you. This section is based on the
INSTALL.SSL in the Open vSwitch source code.
NOTE: How to install Open vSwitch isn’t described in this document. Please refer to the Open vSwitch documents.
Create a PKI by using ovs-pki script:

% ovs-pki init
(Default directory is /usr/local/var/lib/openvswitch/pki)

The pki directory consists of controllerca and switchca subdirectories. Each directory contains CA files.
Create a controller private key and certificate:

% ovs-pki req+sign ctl controller

ctl-privkey.pem and ctl-cert.pem are generated in the current directory.

Create a switch private key and certificate:

% ovs-pki req+sign sc switch

sc-privkey.pem and sc-cert.pem are generated in the current directory.

499
ryu Documentation, Release 4.34

3.1.2 Testing TLS Connection

Configuring ovs-vswitchd to use CA files using the ovs-vsctl "set-ssl" command, e.g.:

% ovs-vsctl set-ssl /etc/openvswitch/sc-privkey.pem \

/etc/openvswitch/sc-cert.pem \
/usr/local/var/lib/openvswitch/pki/controllerca/cacert.pem
% ovs-vsctl add-br br0
% ovs-vsctl set-controller br0 ssl:127.0.0.1:6633

Substitute the correct file names, if they differ from the ones used above. You should use absolute file names.
Run Ryu with CA files:

% ryu-manager --ctl-privkey ctl-privkey.pem \

--ctl-cert ctl-cert.pem \
--ca-certs /usr/local/var/lib/openvswitch/pki/switchca/cacert.pem \
--verbose

You can see something like:

loading app ryu.controller.ofp_handler

instantiating app ryu.controller.ofp_handler
BRICK ofp_event
CONSUMES EventOFPSwitchFeatures
CONSUMES EventOFPErrorMsg
CONSUMES EventOFPHello
CONSUMES EventOFPEchoRequest
connected socket:<SSLSocket fileno=4 sock=127.0.0.1:6633 peer=127.0.0.1:61302> a
ddress:('127.0.0.1', 61302)
hello ev <ryu.controller.ofp_event.EventOFPHello object at 0x1047806d0>
move onto config mode
switch features ev version: 0x1 msg_type 0x6 xid 0xb0bb34e5 port OFPPhyPort(port
_no=65534, hw_addr='\x16\xdc\xa2\xe2}K', name='br0\x00\x00\x00\x00\x00\x00\x00\x
00\x00\x00\x00\x00\x00', config=0, state=0, curr=0, advertised=0, supported=0, p
eer=0)
move onto main mode

3.2 Topology Viewer

ryu.app.gui_topology.gui_topology provides topology visualization.

This depends on following ryu applications.

ryu.app.rest_topology Get node and link data.

ryu.app.ws_topology Being notified change of link up/down.
ryu.app.ofctl_rest Get flows of datapaths.

3.2.1 Usage

Run mininet (or join your real environment):

$ sudo mn --controller remote --topo tree,depth=3

500 Chapter 3. Configuration

ryu Documentation, Release 4.34

Run GUI application:

$ PYTHONPATH=. ./bin/ryu run --observe-links ryu/app/gui_topology/gui_topology.py

Access http://<ip address of ryu host>:8080 with your web browser.

3.2.2 Screenshot

3.2. Topology Viewer 501

ryu Documentation, Release 4.34

502 Chapter 3. Configuration

CHAPTER 4

Tests

4.1 Testing VRRP Module

This page describes how to test Ryu VRRP service

4.1.1 Running integrated tests

Some testing scripts are available.

• ryu/tests/integrated/test_vrrp_linux_multi.py
• ryu/tests/integrated/test_vrrp_multi.py
Each files include how to run in the comment. Please refer to it.

4.1.2 Running multiple Ryu VRRP in network namespace

The following command lines set up necessary bridges and interfaces.

And then run RYU-VRRP:

# ip netns add gateway1

# ip netns add gateway2

# brctl addbr vrrp-br0

# brctl addbr vrrp-br1

# ip link add veth0 type veth peer name veth0-br0

# ip link add veth1 type veth peer name veth1-br0
# ip link add veth2 type veth peer name veth2-br0
# ip link add veth3 type veth peer name veth3-br1
# ip link add veth4 type veth peer name veth4-br1
# ip link add veth5 type veth peer name veth5-br1
(continues on next page)

503
ryu Documentation, Release 4.34

(continued from previous page)

# brctl addif vrrp-br0 veth0-br0

# brctl addif vrrp-br0 veth1-br0
# brctl addif vrrp-br0 veth2-br0
# brctl addif vrrp-br1 veth3-br1
# brctl addif vrrp-br1 veth4-br1
# brctl addif vrrp-br1 veth5-br1

# ip link set vrrp-br0 up

# ip link set vrrp-br1 up

# ip link set veth0 up

# ip link set veth0-br0 up
# ip link set veth1-br0 up
# ip link set veth2-br0 up
# ip link set veth3-br1 up
# ip link set veth4-br1 up
# ip link set veth5 up
# ip link set veth5-br1 up

# ip link set veth1 netns gateway1

# ip link set veth2 netns gateway2
# ip link set veth3 netns gateway1
# ip link set veth4 netns gateway2

# ip netns exec gateway1 ip link set veth1 up

# ip netns exec gateway2 ip link set veth2 up
# ip netns exec gateway1 ip link set veth3 up
# ip netns exec gateway2 ip link set veth4 up

# ip netns exec gateway1 .ryu-vrrp veth1 '10.0.0.2' 254

# ip netns exec gateway2 .ryu-vrrp veth2 '10.0.0.3' 100

Caveats
Please make sure that all interfaces and bridges are UP. Don’t forget interfaces in netns gateway1/gateway2.

504 Chapter 4. Tests

ryu Documentation, Release 4.34

(continued from previous page)

|Linux Brirge vrrp-br0|
-----------------------
^ veth0-br0
|
V veth0

Here’s the helper executable, ryu-vrrp:

#!/usr/bin/env python
#
# Copyright (C) 2013 Nippon Telegraph and Telephone Corporation.
# Copyright (C) 2013 Isaku Yamahata <yamahata at valinux co jp>
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
# implied.
# See the License for the specific language governing permissions and
# limitations under the License.

from ryu.lib import hub

hub.patch()

# TODO:
# Right now, we have our own patched copy of ovs python bindings
# Once our modification is upstreamed and widely deployed,
# use it
#
# NOTE: this modifies sys.path and thus affects the following imports.
# eg. oslo.config.cfg.
import ryu.contrib

from oslo.config import cfg

import logging
import netaddr
import sys
import time

from ryu import log

log.early_init_log(logging.DEBUG)

from ryu import flags

from ryu import version
from ryu.base import app_manager
from ryu.controller import controller
from ryu.lib import mac as lib_mac
from ryu.lib.packet import vrrp
from ryu.services.protocols.vrrp import api as vrrp_api
from ryu.services.protocols.vrrp import event as vrrp_event

(continues on next page)

4.1. Testing VRRP Module 505

ryu Documentation, Release 4.34

(continued from previous page)

CONF = cfg.CONF

_VRID = 7
_IP_ADDRESS = '10.0.0.1'
_PRIORITY = 100

class VRRPTestRouter(app_manager.RyuApp):
def __init__(self, *args, **kwargs):
super(VRRPTestRouter, self).__init__(*args, **kwargs)
print args
self.logger.debug('vrrp_config %s', args)
self._ifname = args[0]
self._primary_ip_address = args[1]
self._priority = int(args[2])

def start(self):
print 'start'
hub.spawn(self._main)

def _main(self):
print self
interface = vrrp_event.VRRPInterfaceNetworkDevice(
lib_mac.DONTCARE, self._primary_ip_address, None, self._ifname)
self.logger.debug('%s', interface)

ip_addresses = [_IP_ADDRESS]
config = vrrp_event.VRRPConfig(
version=vrrp.VRRP_VERSION_V3, vrid=_VRID, priority=self._priority,
ip_addresses=ip_addresses)
self.logger.debug('%s', config)

rep = vrrp_api.vrrp_config(self, interface, config)

self.logger.debug('%s', rep)

def main():
vrrp_config = sys.argv[-3:]
sys.argv = sys.argv[:-3]
CONF(project='ryu', version='ryu-vrrp %s' % version)

log.init_log()
# always enable ofp for now.
app_lists = ['ryu.services.protocols.vrrp.manager',
'ryu.services.protocols.vrrp.dumper',
'ryu.services.protocols.vrrp.sample_manager']

app_mgr = app_manager.AppManager.get_instance()
app_mgr.load_apps(app_lists)
contexts = app_mgr.create_contexts()
app_mgr.instantiate_apps(**contexts)
vrrp_router = app_mgr.instantiate(VRRPTestRouter, *vrrp_config, **contexts)
vrrp_router.start()

while True:
time.sleep(999999)

(continues on next page)

506 Chapter 4. Tests

ryu Documentation, Release 4.34

(continued from previous page)

app_mgr.close()

if __name__ == "__main__":
main()

4.2 Testing OF-config support with LINC

This page describes how to setup LINC and test Ryu OF-config with it.
The procedure is as follows. Although all the procedure is written for reader’s convenience, please refer to LINC
document for latest informations of LINC.
https://github.com/FlowForwarding/LINC-Switch
The test procedure
• install Erlang environment
• build LINC
• configure LINC switch
• setup for LINC
• run LINC switch
• run Ryu test_of_config app
For getting/installing Ryu itself, please refer to https://ryu-sdn.org/

4.2.1 Install Erlang environment

Since LINC is written in Erlang, you need to install Erlang execution environment. Required version is R15B+.
The easiest way is to use binary package from https://www.erlang-solutions.com/downloads/download-erlang-otp
The distribution may also provide Erlang package.

4.2.2 build LINC

install necessary packages for build

install necessary build tools

On Ubuntu:

# apt-get install git-core bridge-utils libpcap0.8 libpcap-dev libcap2-bin uml-

˓→utilities

On RedHat/CentOS:

# yum install git sudo bridge-utils libpcap libpcap-devel libcap tunctl

Note that on RedHat/CentOS 5.x you need a newer version of libpcap:

4.2. Testing OF-config support with LINC 507

ryu Documentation, Release 4.34

# yum erase libpcap libpcap-devel

# yum install flex byacc
# wget http://www.tcpdump.org/release/libpcap-1.2.1.tar.gz
# tar xzf libpcap-1.2.1.tar.gz
# cd libpcap-1.2.1
# ./configure
# make && make install

get LINC repo and built

Clone LINC repo:

% git clone git://github.com/FlowForwarding/LINC-Switch.git

Then compile everything:

% cd LINC-Switch
% make

Note: At the time of this writing, test_of_config fails due to a bug of LINC. You can try this test with LINC which is
built by the following methods.

% cd LINC-Switch
% make
% cd deps/of_config
% git reset --hard f772af4b765984381ad024ca8e5b5b8c54362638
% cd ../..
% make offline

4.2.3 Setup LINC

edit LINC switch configuration file. rel/linc/releases/0.1/sys.config Here is the sample sys.config for
test_of_config.py to run.

[{linc,
[{of_config,enabled},
{capable_switch_ports,
[{port,1,[{interface,"linc-port"}]},
{port,2,[{interface,"linc-port2"}]},
{port,3,[{interface,"linc-port3"}]},
{port,4,[{interface,"linc-port4"}]}]},
{capable_switch_queues,
[
{queue,991,[{min_rate,10},{max_rate,120}]},
{queue,992,[{min_rate,10},{max_rate,130}]},
{queue,993,[{min_rate,200},{max_rate,300}]},
{queue,994,[{min_rate,400},{max_rate,900}]}
]},
{logical_switches,
[{switch,0,
[{backend,linc_us4},
(continues on next page)

508 Chapter 4. Tests

ryu Documentation, Release 4.34

(continued from previous page)

{controllers,[{"Switch0-Default-Controller","127.0.0.1",6633,tcp}]},
{controllers_listener,{"127.0.0.1",9998,tcp}},
{queues_status,enabled},
{ports,[{port,1,{queues,[]}},{port,2,{queues,[991,992]}}]}]}
,
{switch,7,
[{backend,linc_us3},
{controllers,[{"Switch7-Controller","127.0.0.1",6633,tcp}]},
{controllers_listener,disabled},
{queues_status,enabled},
{ports,[{port,4,{queues,[]}},{port,3,{queues,[993,994]}}]}]}
]}]},
{enetconf,
[{capabilities,
[{base,{1,0}},
{base,{1,1}},
{startup,{1,0}},
{'writable-running',{1,0}}]},
{callback_module,linc_ofconfig},
{sshd_ip,{127,0,0,1}},
{sshd_port,1830},
{sshd_user_passwords,[{"linc","linc"}]}]},
{lager,
[{handlers,
[{lager_console_backend,debug},
{lager_file_backend,
[{"log/error.log",error,10485760,"$D0",5},
{"log/console.log",info,10485760,"$D0",5}]}]}]},
{sasl,
[{sasl_error_logger,{file,"log/sasl-error.log"}},
{errlog_type,error},
{error_logger_mf_dir,"log/sasl"},
{error_logger_mf_maxbytes,10485760},
{error_logger_mf_maxfiles,5}]},
{sync,[{excluded_modules,[procket]}]}].

4.2.4 setup for LINC

As the above sys.config requires some network interface, create them:

# ip link add linc-port type veth peer name linc-port-peer

# ip link set linc-port up
# ip link add linc-port2 type veth peer name linc-port-peer2
# ip link set linc-port2 up
# ip link add linc-port3 type veth peer name linc-port-peer3
# ip link set linc-port3 up
# ip link add linc-port4 type veth peer name linc-port-peer4
# ip link set linc-port4 up

After stopping LINC, those created interfaces can be deleted:

# ip link delete linc-port

# ip link delete linc-port2
# ip link delete linc-port3
# ip link delete linc-port4

4.2. Testing OF-config support with LINC 509

ryu Documentation, Release 4.34

4.2.5 Starting LINC OpenFlow switch

Then run LINC:

# rel/linc/bin/linc console

4.2.6 Run Ryu test_of_config app

Run test_of_config app:

# ryu-manager --verbose ryu.tests.integrated.test_of_config ryu.app.rest

If you don’t install ryu and are working in the git repo directly:

# PYTHONPATH=. ./bin/ryu-manager --verbose ryu.tests.integrated.test_of_config ryu.

˓→app.rest

510 Chapter 4. Tests

CHAPTER 5

Snort Intergration

This document describes how to integrate Ryu with Snort.

5.1 Overview

There are two options can send alert to Ryu controller. The Option 1 is easier if you just want to demonstrate or test.
Since Snort need very large computation power for analyzing packets you can choose Option 2 to separate them.
[Option 1] Ryu and Snort are on the same machine
+---------------------+
| unixsock |
| Ryu == snort |
+----eth0-----eth1----+
| |
+-------+ +----------+ +-------+
| HostA |---| OFSwitch |---| HostB |
+-------+ +----------+ +-------+

The above depicts Ryu and Snort architecture. Ryu receives Snort alert packet via Unix Domain Socket . To monitor
packets between HostA and HostB, installing a flow that mirrors packets to Snort.
[Option 2] Ryu and Snort are on the different machines
+---------------+
| Snort eth0--|
| Sniffer | |
+-----eth1------+ |
| |
+-------+ +----------+ +-----------+
| HostA |---| OFSwitch |---| LAN (*CP) |
+-------+ +----------+ +-----------+
| |
+----------+ +----------+
(continues on next page)

511
ryu Documentation, Release 4.34

(continued from previous page)

| HostB | | Ryu |
+----------+ +----------+

*CP: Control Plane

The above depicts Ryu and Snort architecture. Ryu receives Snort alert packet via Network Socket . To monitor
packets between HostA and HostB, installing a flow that mirrors packets to Snort.

5.2 Installation Snort

Snort is an open source network intrusion prevention and detectionsystem developed by Sourcefire. If you are not
familiar with installing/setting up Snort, please referto snort setup guides.
http://www.snort.org/documents

5.3 Configure Snort

The configuration example is below:

• Add a snort rules file into /etc/snort/rules named Myrules.rules

alert icmp any any -> any any (msg:"Pinging...";sid:1000004;)

alert tcp any any -> any 80 (msg:"Port 80 is accessing"; sid:1000003;)

• Add the custom rules in /etc/snort/snort.conf

include $RULE_PATH/Myrules.rules

Configure NIC as a promiscuous mode.

$ sudo ifconfig eth1 promisc

5.4 Usage

[Option 1]
1. Modify the simple_switch_snort.py:

socket_config = {'unixsock': True}

# True: Unix Domain Socket Server [Option1]
# False: Network Socket Server [Option2]

2. Run Ryu with sample application:

$ sudo ./bin/ryu-manager ryu/app/simple_switch_snort.py

The incoming packets will all mirror to port 3 which should be connect to Snort network interface. You can modify
the mirror port by assign a new value in the self.snort_port = 3 of simple_switch_snort.py
3. Run Snort:

512 Chapter 5. Snort Intergration

ryu Documentation, Release 4.34

$ sudo -i
$ snort -i eth1 -A unsock -l /tmp -c /etc/snort/snort.conf

4. Send an ICMP packet from HostA (192.168.8.40) to HostB (192.168.8.50):

$ ping 192.168.8.50

5. You can see the result under next section.

[Option 2]
1. Modify the simple_switch_snort.py:
socket_config = {'unixsock': False}
# True: Unix Domain Socket Server [Option1]
# False: Network Socket Server [Option2]

2. Run Ryu with sample application (On the Controller):

$ ./bin/ryu-manager ryu/app/simple_switch_snort.py

3. Run Snort (On the Snort machine):

$ sudo -i
$ snort -i eth1 -A unsock -l /tmp -c /etc/snort/snort.conf

4. Run pigrelay.py (On the Snort machine):

$ sudo python pigrelay.py

This program listening snort alert messages from unix domain socket and sending it to Ryu using network socket.
You can clone the source code from this repo. https://github.com/John-Lin/pigrelay
5. Send an ICMP packet from HostA (192.168.8.40) to HostB (192.168.8.50):
$ ping 192.168.8.50

6. You can see the alert message below:

alertmsg: Pinging...
icmp(code=0,csum=19725,data=echo(data=array('B', [97, 98, 99, 100, 101, 102, 103,
˓→104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119,

˓→97, 98, 99, 100, 101, 102, 103, 104, 105]),id=1,seq=78),type=8)

ipv4(csum=42562,dst='192.168.8.50',flags=0,header_length=5,identification=724,
˓→offset=0,option=None,proto=1,src='192.168.8.40',tos=0,total_length=60,ttl=128,

˓→version=4)

ethernet(dst='00:23:54:5a:05:14',ethertype=2048,src='00:23:54:6c:1d:17')

alertmsg: Pinging...
icmp(code=0,csum=21773,data=echo(data=array('B', [97, 98, 99, 100, 101, 102, 103,
˓→104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119,

˓→97, 98, 99, 100, 101, 102, 103, 104, 105]),id=1,seq=78),type=0)

ipv4(csum=52095,dst='192.168.8.40',flags=0,header_length=5,identification=7575,
˓→offset=0,option=None,proto=1,src='192.168.8.50',tos=0,total_length=60,ttl=64,

˓→version=4) (continues on next page)

5.4. Usage 513

ryu Documentation, Release 4.34

(continued from previous page)

514 Chapter 5. Snort Intergration

CHAPTER 6

Built-in Ryu applications

Ryu has some built-in Ryu applications. Some of them are examples. Others provide some functionalities to other
Ryu applications.

6.1 ryu.app.ofctl

ryu.app.ofctl provides a convenient way to use OpenFlow messages synchronously.

OfctlService ryu application is automatically loaded if your Ryu application imports ofctl.api module.
Example:

import ryu.app.ofctl.api

OfctlService application internally uses OpenFlow barrier messages to ensure message boundaries. As OpenFlow
messages are asynchronous and some of messages does not have any replies on success, barriers are necessary for
correct error handling.

6.1.1 api module

ryu.app.ofctl.api.get_datapath(app, dpid=None)
Get datapath object by dpid.
Parameters
• app – Client RyuApp instance
• dpid – Datapath ID (int type) or None to get all datapath objects
Returns a object of datapath, a list of datapath objects when no dpid given or None when error.
Raises an exception if any of the given values is invalid.
Example:

515
ryu Documentation, Release 4.34

# ...(snip)...
import ryu.app.ofctl.api as ofctl_api

class MyApp(app_manager.RyuApp):

def _my_handler(self, ev):

# Get all datapath objects
result = ofctl_api.get_datapath(self)

# Get the datapath object which has the given dpid

result = ofctl_api.get_datapath(self, dpid=1)

ryu.app.ofctl.api.send_msg(app, msg, reply_cls=None, reply_multi=False)

Send an OpenFlow message and wait for reply messages.
Parameters
• app – Client RyuApp instance
• msg – An OpenFlow controller-to-switch message to send
• reply_cls – OpenFlow message class for expected replies. None means no replies are
expected. The default is None.
• reply_multi – True if multipart replies are expected. The default is False.
If no replies, returns None. If reply_multi=False, returns OpenFlow switch-to-controller message. If re-
ply_multi=True, returns a list of OpenFlow switch-to-controller messages.
Raise an exception on error.
Example:

# ...(snip)...
import ryu.app.ofctl.api as ofctl_api

class MyApp(app_manager.RyuApp):

def _my_handler(self, ev):

# ...(snip)...
msg = parser.OFPPortDescStatsRequest(datapath=datapath)
result = ofctl_api.send_msg(
self, msg,
reply_cls=parser.OFPPortDescStatsReply,
reply_multi=True)

6.1.2 exceptions

exception ryu.app.ofctl.exception.InvalidDatapath(result)
Datapath is invalid.
This can happen when the bridge disconnects.
exception ryu.app.ofctl.exception.OFError(result)
OFPErrorMsg is received.
exception ryu.app.ofctl.exception.UnexpectedMultiReply(result)
Two or more replies are received for reply_muiti=False request.

516 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

6.2 ryu.app.ofctl_rest

ryu.app.ofctl_rest provides REST APIs for retrieving the switch stats and Updating the switch stats. This application
helps you debug your application and get various statistics.
This application supports OpenFlow version 1.0, 1.2, 1.3, 1.4 and 1.5.

Contents

• ryu.app.ofctl_rest
– Retrieve the switch stats

* Get all switches

* Get the desc stats
* Get all flows stats
* Get flows stats filtered by fields
* Get aggregate flow stats
* Get aggregate flow stats filtered by fields
* Get table stats
* Get table features
* Get ports stats
* Get ports description
* Get queues stats
* Get queues config
* Get queues description
* Get groups stats
* Get group description stats
* Get group features stats
* Get meters stats
* Get meter config stats
* Get meter description stats
* Get meter features stats
* Get role
– Update the switch stats

* Add a flow entry

* Modify all matching flow entries
* Modify flow entry strictly
* Delete all matching flow entries
* Delete flow entry strictly

6.2. ryu.app.ofctl_rest 517

ryu Documentation, Release 4.34

* Delete all flow entries

* Add a group entry
* Modify a group entry
* Delete a group entry
* Modify the behavior of the port
* Add a meter entry
* Modify a meter entry
* Delete a meter entry
* Modify role
– Support for experimenter multipart

* Send a experimenter message

– Reference: Description of Match and Actions

* Description of Match on request messages

* Description of Actions on request messages

6.2.1 Retrieve the switch stats

Get all switches

Get the list of all switches which connected to the controller.

Usage:

Method GET
URI /stats/switches

Response message body:

Attribute Description Example

dpid Datapath ID 1

Example of use:

$ curl -X GET http://localhost:8080/stats/switches

[
1,
2,
3
]

Note: The result of the REST command is formatted for easy viewing.

518 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Get the desc stats

Get the desc stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/desc/<dpid>

Response message body:

Attribute Description Example

dpid Datapath ID "1"
mfr_desc Manufacturer description "Nicira, Inc.",
hw_desc Hardware description "Open vSwitch",
sw_desc Software description "2.3.90",
serial_num Serial number "None",
dp_desc Human readable description of datapath "None"

Example of use:

$ curl -X GET http://localhost:8080/stats/desc/1

{
"1": {
"mfr_desc": "Nicira, Inc.",
"hw_desc": "Open vSwitch",
"sw_desc": "2.3.90",
"serial_num": "None",
"dp_desc": "None"
}
}

Get all flows stats

Get all flows stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/flow/<dpid>

Response message body(OpenFlow1.3 or earlier):

6.2. ryu.app.ofctl_rest 519

ryu Documentation, Release 4.34

Attribute Description Example

dpid Datapath ID "1"
length Length of this entry 88
table_id Table ID 0
duration_sec Time flow has been alive in seconds 2
dura- Time flow has been alive in nanoseconds beyond dura- 6.76e+08
tion_nsec tion_sec
priority Priority of the entry 11111
idle_timeout Number of seconds idle before expiration 0
hard_timeout Number of seconds before expiration 0
flags Bitmap of OFPFF_* flags 1
cookie Opaque controller-issued identifier 1
packet_count Number of packets in flow 0
byte_count Number of bytes in flow 0
match Fields to match {"in_port":
1}
actions Instruction set ["OUT-
PUT:2"]

Response message body(OpenFlow1.4 or later):

Attribute Description Example

dpid Datapath ID "1"
length Length of this entry 88
table_id Table ID 0
dura- Time flow has been alive in seconds 2
tion_sec
dura- Time flow has been alive in nanoseconds be- 6.76e+08
tion_nsec yond duration_sec
priority Priority of the entry 11111
idle_timeout Number of seconds idle before expiration 0
hard_timeoutNumber of seconds before expiration 0
flags Bitmap of OFPFF_* flags 1
cookie Opaque controller-issued identifier 1
packet_countNumber of packets in flow 0
byte_count Number of bytes in flow 0
impor- Eviction precedence 0
tance
match Fields to match {"eth_type": 2054}
instruc- struct ofp_instruction_header [{"type":GOTO_TABLE",
tions "table_id":1}]

Example of use:
$ curl -X GET http://localhost:8080/stats/flow/1

Response (OpenFlow1.3 or earlier):

{
"1": [
{
"length": 88,
(continues on next page)

520 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

"table_id": 0,
"duration_sec": 2,
"duration_nsec": 6.76e+08,
"priority": 11111,
"idle_timeout": 0,
"hard_timeout": 0,
"flags": 1,
"cookie": 1,
"packet_count": 0,
"byte_count": 0,
"match": {
"in_port": 1
},
"actions": [
"OUTPUT:2"
]
}
]
}

Response (OpenFlow1.4 or later):

{
"1": [
{
"length": 88,
"table_id": 0,
"duration_sec": 2,
"duration_nsec": 6.76e+08,
"priority": 11111,
"idle_timeout": 0,
"hard_timeout": 0,
"flags": 1,
"cookie": 1,
"packet_count": 0,
"byte_count": 0,
"match": {
"eth_type": 2054
},
"importance": 0,
"instructions": [
{
"type": "APPLY_ACTIONS",
"actions": [
{
"port": 2,
"max_len": 0,
"type": "OUTPUT"
}
]
}
]
}
]
}

6.2. ryu.app.ofctl_rest 521

ryu Documentation, Release 4.34

Get flows stats filtered by fields

Get flows stats of the switch filtered by the OFPFlowStats fields. This is POST method version of Get all
flows stats.
Usage:

Method POST
URI /stats/flow/<dpid>

Request message body:

Attribute Description Example Default

table_id Table ID (int) 0 OF-
PTT_ALL
out_port Require matching entries to include this as an 2 OFPP_ANY
output port (int)
out_group Require matching entries to include this as an 1 OFPG_ANY
output group (int)
cookie Require matching entries to contain this cookie 1 0
value (int)
cookie_maskMask used to restrict the cookie bits that must 1 0
match (int)
match Fields to match (dict) {"in_port": {} #wild-
1} carded
priority Priority of the entry (int) (See Note) 11111 #wild-
carded

Note: OpenFlow Spec does not allow to filter flow entries by priority, but when with a large
amount of flow entries, filtering by priority is convenient to get statistics efficiently. So, this
app provides priority field for filtering.

Response message body: The same as Get all flows stats

Example of use:
$ curl -X POST -d '{
"table_id": 0,
"out_port": 2,
"cookie": 1,
"cookie_mask": 1,
"match":{
"in_port":1
}
}' http://localhost:8080/stats/flow/1

Response (OpenFlow1.3 or earlier):

{
"1": [
{
"length": 88,
"table_id": 0,
(continues on next page)

522 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

"duration_sec": 2,
"duration_nsec": 6.76e+08,
"priority": 11111,
"idle_timeout": 0,
"hard_timeout": 0,
"flags": 1,
"cookie": 1,
"packet_count": 0,
"byte_count": 0,
"match": {
"in_port": 1
},
"actions": [
"OUTPUT:2"
]
}
]
}

Response (OpenFlow1.4 or later):

6.2. ryu.app.ofctl_rest 523

ryu Documentation, Release 4.34

Get aggregate flow stats

Get aggregate flow stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/aggregateflow/<dpid>

Response message body:

Attribute Description Example

dpid Datapath ID "1"
packet_count Number of packets in flows 18
byte_count Number of bytes in flows 756
flow_count Number of flows 3

Example of use:

$ curl -X GET http://localhost:8080/stats/aggregateflow/1

{
"1": [
{
"packet_count": 18,
"byte_count": 756,
"flow_count": 3
}
]
}

Get aggregate flow stats filtered by fields

Get aggregate flow stats of the switch filtered by the OFPAggregateStats fields. This is POST method
version of Get aggregate flow stats.
Usage:

Method POST
URI /stats/aggregateflow/<dpid>

Request message body:

524 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Attribute Description Example Default

Response message body: The same as Get aggregate flow stats

Example of use:

$ curl -X POST -d '{

"table_id": 0,
"out_port": 2,
"cookie": 1,
"cookie_mask": 1,
"match":{
"in_port":1
}
}' http://localhost:8080/stats/aggregateflow/1

{
"1": [
{
"packet_count": 18,
"byte_count": 756,
"flow_count": 3
}
]
}

Get table stats

Get table stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/table/<dpid>

Response message body(OpenFlow1.0):

6.2. ryu.app.ofctl_rest 525

ryu Documentation, Release 4.34

Attribute Description Example

dpid Datapath ID "1"
table_id Table ID 0
name Name of Table "classifier"
max_entries Max number of entries supported 1e+06
wildcards Bitmap of OFPFW_* wildcards that are supported ["IN_PORT","DL_VLAN"]
by the table
ac- Number of active entries 0
tive_count
lookup_count Number of packets looked up in table 8
matched_countNumber of packets that hit table 0

Response message body(OpenFlow1.2):

At- Description Example

tribute
dpid Datapath ID "1"
table_id Table ID 0
name Name of Table "classifier"
match Bitmap of (1 << OFPXMT_*) that indicate the ["OFB_IN_PORT","OFB_METADATA"]
fields the table can match on
wild- Bitmap of (1 << OFPXMT_*) wildcards that are ["OFB_IN_PORT","OFB_METADATA"]
cards supported by the table
write_actionsBitmap of OFPAT_* that are supported by the table ["OUT-
with OFPIT_WRITE_ACTIONS PUT","SET_MPLS_TTL"]
ap- Bitmap of OFPAT_* that are supported by the table ["OUT-
ply_actions with OFPIT_APPLY_ACTIONS PUT","SET_MPLS_TTL"]
write_setfields
Bitmap of (1 << OFPXMT_*) header fields that ["OFB_IN_PORT","OFB_METADATA"]
can be set with OFPIT_WRITE_ACTIONS
ap- Bitmap of (1 << OFPXMT_*) header fields that ["OFB_IN_PORT","OFB_METADATA"]
ply_setfieldscan be set with OFPIT_APPLY_ACTIONS
meta- Bits of metadata table can match 18446744073709552000
data_match
meta- Bits of metadata table can write 18446744073709552000
data_write
instruc- Bitmap of OFPIT_* values supported ["GOTO_TABLE","WRITE_METADATA"]
tions
config Bitmap of OFPTC_* values []
max_entriesMax number of entries supported 1e+06
ac- Number of active entries 0
tive_count
lookup_count Number of packets looked up in table 0
matched_countNumber of packets that hit table 8

Response message body(OpenFlow1.3):

526 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Attribute Description Example

dpid Datapath ID "1"
table_id Table ID 0
active_count Number of active entries 0
lookup_count Number of packets looked up in table 8
matched_count Number of packets that hit table 0

Example of use:

$ curl -X GET http://localhost:8080/stats/table/1

Response (OpenFlow1.0):

{
"1": [
{
"table_id": 0,
"lookup_count": 8,
"max_entries": 1e+06,
"active_count": 0,
"name": "classifier",
"matched_count": 0,
"wildcards": [
"IN_PORT",
"DL_VLAN"
]
},
...
{
"table_id": 253,
"lookup_count": 0,
"max_entries": 1e+06,
"active_count": 0,
"name": "table253",
"matched_count": 0,
"wildcards": [
"IN_PORT",
"DL_VLAN"
]
}
]
}

Response (OpenFlow1.2):

{
"1": [
{
"apply_setfields": [
"OFB_IN_PORT",
"OFB_METADATA"
],
"match": [
"OFB_IN_PORT",
"OFB_METADATA"
],
(continues on next page)

6.2. ryu.app.ofctl_rest 527

ryu Documentation, Release 4.34

(continued from previous page)

"metadata_write": 18446744073709552000,
"config": [],
"instructions":[
"GOTO_TABLE",
"WRITE_METADATA"
],
"table_id": 0,
"metadata_match": 18446744073709552000,
"lookup_count": 8,
"wildcards": [
"OFB_IN_PORT",
"OFB_METADATA"
],
"write_setfields": [
"OFB_IN_PORT",
"OFB_METADATA"
],
"write_actions": [
"OUTPUT",
"SET_MPLS_TTL"
],
"name": "classifier",
"matched_count": 0,
"apply_actions": [
"OUTPUT",
"SET_MPLS_TTL"
],
"active_count": 0,
"max_entries": 1e+06
},
...
{
"apply_setfields": [
"OFB_IN_PORT",
"OFB_METADATA"
],
"match": [
"OFB_IN_PORT",
"OFB_METADATA"
],
"metadata_write": 18446744073709552000,
"config": [],
"instructions": [
"GOTO_TABLE",
"WRITE_METADATA"
],
"table_id": 253,
"metadata_match": 18446744073709552000,
"lookup_count": 0,
"wildcards": [
"OFB_IN_PORT",
"OFB_METADATA"
],
"write_setfields": [
"OFB_IN_PORT",
"OFB_METADATA"
],
(continues on next page)

528 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

"write_actions": [
"OUTPUT",
"SET_MPLS_TTL"
],
"name": "table253",
"matched_count": 0,
"apply_actions": [
"OUTPUT",
"SET_MPLS_TTL"
],
"active_count": 0,
"max_entries": 1e+06
}
]
}

Response (OpenFlow1.3):

{
"1": [
{
"active_count": 0,
"table_id": 0,
"lookup_count": 8,
"matched_count": 0
},
...
{
"active_count": 0,
"table_id": 253,
"lookup_count": 0,
"matched_count": 0
}
]
}

Get table features

Get table features of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/tablefeatures/<dpid>

Response message body:

6.2. ryu.app.ofctl_rest 529

ryu Documentation, Release 4.34

Attribute Description Example

dpid Datapath ID "1"
table_id Table ID 0
name Name of Table "table_0"
meta- Bits of metadata table can 18446744073709552000
data_match match
meta- Bits of metadata table can 18446744073709552000
data_write write
config Bitmap of OFPTC_* values 0
max_entries Max number of entries sup- 4096
ported
properties struct [{"type": "INSTRUC-
ofp_table_feature_prop_header TIONS","instruction_ids": [...]},...]

Example of use:

$ curl -X GET http://localhost:8080/stats/tablefeatures/1

{
"1": [
{
"metadata_write": 18446744073709552000,
"config": 0,
"table_id": 0,
"metadata_match": 18446744073709552000,
"max_entries": 4096,
"properties": [
{
"type": "INSTRUCTIONS",
"instruction_ids": [
{
"len": 4,
"type": 1
},
...
]
},
...
],
"name": "table_0"
},
{
"metadata_write": 18446744073709552000,
"config": 0,
"table_id": 1,
"metadata_match": 18446744073709552000,
"max_entries": 4096,
"properties": [
{
"type": "INSTRUCTIONS",
"instruction_ids": [
{
"len": 4,
"type": 1
},
(continues on next page)

530 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

...
]
},
...
],
"name": "table_1"
},
...
]
}

Get ports stats

Get ports stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/port/<dpid>[/<port>]

Note: Specification of port number is optional.

Response message body(OpenFlow1.3 or earlier):

Attribute Description Exam-

ple
dpid Datapath ID "1"
port_no Port number 1
rx_packets Number of received packets 9
tx_packets Number of transmitted packets 6
rx_bytes Number of received bytes 738
tx_bytes Number of transmitted bytes 252
rx_dropped Number of packets dropped by RX 0
tx_dropped Number of packets dropped by TX 0
rx_errors Number of receive errors 0
tx_errors Number of transmit errors 0
rx_frame_err Number of frame alignment errors 0
rx_over_err Number of packets with RX overrun 0
rx_crc_err Number of CRC errors 0
collisions Number of collisions 0
duration_sec Time port has been alive in seconds 12
dura- Time port has been alive in nanoseconds beyond duration_sec 9.76e+08
tion_nsec

Response message body(OpenFlow1.4 or later):

6.2. ryu.app.ofctl_rest 531

ryu Documentation, Release 4.34

At- Description Example

tribute
dpid Datapath ID "1"
port_no Port number 1
rx_packetsNumber of received packets 9
tx_packets Number of transmitted packets 6
rx_bytes Number of received bytes 738
tx_bytes Number of transmitted bytes 252
rx_droppedNumber of packets dropped by 0
RX
tx_droppedNumber of packets dropped by TX 0
rx_errors Number of receive errors 0
tx_errors Number of transmit errors 0
dura- Time port has been alive in sec- 12
tion_sec onds
dura- Time port has been alive in 9.76e+08
tion_nsec nanoseconds beyond duration_sec
proper- struct ofp_port_desc_prop_header [{"rx_frame_err": 0, "rx_over_err": 0,
ties "rx_crc_err": 0, "collisions": 0,...},...]

Example of use:

$ curl -X GET http://localhost:8080/stats/port/1

Response (OpenFlow1.3 or earlier):

{
"1": [
{
"port_no": 1,
"rx_packets": 9,
"tx_packets": 6,
"rx_bytes": 738,
"tx_bytes": 252,
"rx_dropped": 0,
"tx_dropped": 0,
"rx_errors": 0,
"tx_errors": 0,
"rx_frame_err": 0,
"rx_over_err": 0,
"rx_crc_err": 0,
"collisions": 0,
"duration_sec": 12,
"duration_nsec": 9.76e+08
},
{
:
:
}
]
}

Response (OpenFlow1.4 or later):

532 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

{
"1": [
{
"port_no": 1,
"rx_packets": 9,
"tx_packets": 6,
"rx_bytes": 738,
"tx_bytes": 252,
"rx_dropped": 0,
"tx_dropped": 0,
"rx_errors": 0,
"tx_errors": 0,
"duration_nsec": 12,
"duration_sec": 9.76e+08,
"properties": [
{
"rx_frame_err": 0,
"rx_over_err": 0,
"rx_crc_err": 0,
"collisions": 0,
"type": "ETHERNET"
},
{
"bias_current": 300,
"flags": 3,
"rx_freq_lmda": 1500,
"rx_grid_span": 500,
"rx_offset": 700,
"rx_pwr": 2000,
"temperature": 273,
"tx_freq_lmda": 1500,
"tx_grid_span": 500,
"tx_offset": 700,
"tx_pwr": 2000,
"type": "OPTICAL"
},
{
"data": [],
"exp_type": 0,
"experimenter": 101,
"type": "EXPERIMENTER"
},
{
:

:
}
]
}
]
}

Get ports description

Get ports description of the switch which specified with Datapath ID in URI.
Usage(OpenFlow1.4 or earlier):

6.2. ryu.app.ofctl_rest 533

ryu Documentation, Release 4.34

Method GET
URI /stats/portdesc/<dpid>

Usage(OpenFlow1.5 or later):

Method GET
URI /stats/portdesc/<dpid>/[<port>]

Note: Specification of port number is optional.

Response message body(OpenFlow1.3 or earlier):

Attribute Description Example

dpid Datapath ID "1"
port_no Port number 1
hw_addr Ethernet hardware address "0a:b6:d0:0c:e1:d7"
name Name of port "s1-eth1"
config Bitmap of OFPPC_* flags 0
state Bitmap of OFPPS_* flags 0
curr Current features 2112
advertised Features being advertised by the port 0
supported Features supported by the port 0
peer Features advertised by peer 0
curr_speed Current port bitrate in kbps 1e+07
max_speed Max port bitrate in kbps 0

Response message body(OpenFlow1.4 or later):

Attribute Description Example

dpid Datapath ID "1"
port_no Port number 1
hw_addr Ethernet hardware address "0a:b6:d0:0c:e1:d7"
name Name of port "s1-eth1"
config Bitmap of OFPPC_* flags 0
state Bitmap of OFPPS_* flags 0
length Length of this entry 168
properties struct ofp_port_desc_prop_header [{"length": 32, "curr": 10248,...}...]

Example of use:

$ curl -X GET http://localhost:8080/stats/portdesc/1

Response (OpenFlow1.3 or earlier):

{
"1": [
{
"port_no": 1,
"hw_addr": "0a:b6:d0:0c:e1:d7",
(continues on next page)

534 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

"name": "s1-eth1",
"config": 0,
"state": 0,
"curr": 2112,
"advertised": 0,
"supported": 0,
"peer": 0,
"curr_speed": 1e+07,
"max_speed": 0
},
{
:
:
}
]
}

Response (OpenFlow1.4 or later):

{
"1": [
{
"port_no": 1,
"hw_addr": "0a:b6:d0:0c:e1:d7",
"name": "s1-eth1",
"config": 0,
"state": 0,
"length": 168,
"properties": [
{
"length": 32,
"curr": 10248,
"advertised": 10240,
"supported": 10248,
"peer": 10248,
"curr_speed": 5000,
"max_speed": 5000,
"type": "ETHERNET"
},
{
"length": 40,
"rx_grid_freq_lmda": 1500,
"tx_grid_freq_lmda": 1500,
"rx_max_freq_lmda": 2000,
"tx_max_freq_lmda": 2000,
"rx_min_freq_lmda": 1000,
"tx_min_freq_lmda": 1000,
"tx_pwr_max": 2000,
"tx_pwr_min": 1000,
"supported": 1,
"type": "OPTICAL"
},
{
"data": [],
"exp_type": 0,
"experimenter": 101,
"length": 12,
(continues on next page)

6.2. ryu.app.ofctl_rest 535

ryu Documentation, Release 4.34

(continued from previous page)

"type": "EXPERIMENTER"
},
{
:

:
}
]
}
]
}

Get queues stats

Get queues stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/queue/<dpid>[/<port>[/<queue_id>]]

Note: Specification of port number and queue id are optional.

If you want to omitting the port number and setting the queue id, please specify the keyword
"ALL" to the port number.
e.g. GET http://localhost:8080/stats/queue/1/ALL/1

Response message body(OpenFlow1.3 or earlier):

Attribute Description Example

dpid Datapath ID "1"
port_no Port number 1
queue_id Queue ID 0
tx_bytes Number of transmitted bytes 0
tx_packets Number of transmitted packets 0
tx_errors Number of packets dropped due to overrun 0
duration_sec Time queue has been alive in seconds 4294963425
dura- Time queue has been alive in nanoseconds beyond dura- 3912967296
tion_nsec tion_sec

Response message body(OpenFlow1.4 or later):

536 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Attribute Description Example

dpid Datapath ID "1"
port_no Port number 1
queue_id Queue ID 0
tx_bytes Number of transmitted bytes 0
tx_packets Number of transmitted packets 0
tx_errors Number of packets dropped due to overrun 0
dura- Time queue has been alive in seconds 4294963425
tion_sec
dura- Time queue has been alive in nanoseconds be- 3912967296
tion_nsec yond duration_sec
length Length of this entry 104
properties struct ofp_queue_stats_prop_header [{"type": 65535,"length":
12,...},...]

Example of use:

$ curl -X GET http://localhost:8080/stats/queue/1

Response (OpenFlow1.3 or earlier):

{
"1": [
{
"port_no": 1,
"queue_id": 0,
"tx_bytes": 0,
"tx_packets": 0,
"tx_errors": 0,
"duration_sec": 4294963425,
"duration_nsec": 3912967296
},
{
"port_no": 1,
"queue_id": 1,
"tx_bytes": 0,
"tx_packets": 0,
"tx_errors": 0,
"duration_sec": 4294963425,
"duration_nsec": 3912967296
}
]
}

Response (OpenFlow1.4 or later):

{
"1": [
{
"port_no": 1,
"queue_id": 0,
"tx_bytes": 0,
"tx_packets": 0,
"tx_errors": 0,
"duration_sec": 4294963425,
(continues on next page)

6.2. ryu.app.ofctl_rest 537

ryu Documentation, Release 4.34

(continued from previous page)

"duration_nsec": 3912967296,
"length": 104,
"properties": [
{
"OFPQueueStatsPropExperimenter": {
"type": 65535,
"length": 16,
"data": [
1
],
"exp_type": 1,
"experimenter": 101
}
},
{
:

:
}
]
},
{
"port_no": 2,
"queue_id": 1,
"tx_bytes": 0,
"tx_packets": 0,
"tx_errors": 0,
"duration_sec": 4294963425,
"duration_nsec": 3912967296,
"length": 48,
"properties": []
}
]
}

Get queues config

Get queues config of the switch which specified with Datapath ID and Port in URI.
Usage:

Method GET
URI /stats/queueconfig/<dpid>/[<port>]

Note: Specification of port number is optional.

Caution: This message is deprecated in Openflow1.4. If OpenFlow 1.4 or later is in use,

please refer to Get queues description instead.

Response message body:

538 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Attribute Description Example

dpid Datapath ID "1"
port Port which was queried 1
queues struct ofp_packet_queue
– ID for the specific queue 2
queue_id
– port Port this queue is attached to 0
– proper- struct ofp_queue_prop_header prop- [{"property": "MIN_RATE","rate":
ties erties 80}]

Example of use:

$ curl -X GET http://localhost:8080/stats/queueconfig/1/1

{
"1": [
{
"port": 1,
"queues": [
{
"properties": [
{
"property": "MIN_RATE",
"rate": 80
}
],
"port": 0,
"queue_id": 1
},
{
"properties": [
{
"property": "MAX_RATE",
"rate": 120
}
],
"port": 2,
"queue_id": 2
},
{
"properties": [
{
"property": "EXPERIMENTER",
"data": [],
"experimenter": 999
}
],
"port": 3,
"queue_id": 3
}
]
}
]
}

6.2. ryu.app.ofctl_rest 539

ryu Documentation, Release 4.34

Get queues description

Get queues description of the switch which specified with Datapath ID, Port and Queue_id in URI.
Usage:

Method GET
URI /stats/queuedesc/<dpid>[/<port>/[<queue_id>]]

Note: Specification of port number and queue id are optional.

If you want to omitting the port number and setting the queue id, please specify the keyword
"ALL" to the port number.
e.g. GET http://localhost:8080/stats/queuedesc/1/ALL/1

Caution: This message is available in OpenFlow1.4 or later. If Openflow1.3 or earlier is

in use, please refer to Get queues config instead.

Response message body:

Attribute Description Example

dpid Datapath ID "1"
len Length in bytes of this queue desc 88
port_no Port which was queried 1
queue_id Queue ID 1
properties struct ofp_queue_desc_prop_header [{"length": 8, ...},...]

Example of use:
$ curl -X GET http://localhost:8080/stats/queuedesc/1/1/1

{
"1": [
{
"len": 88,
"port_no": 1,
"queue_id": 1,
"properties": [
{
"length": 8,
"rate": 300,
"type": "MIN_RATE"
},
{
"length": 8,
"rate": 900,
"type": "MAX_RATE"
},
{
"length": 16,
"exp_type": 0,
(continues on next page)

540 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

"experimenter": 101,
"data": [1],
"type": "EXPERIMENTER"
},
{
:

:
}
]
}
]
}

Get groups stats

Get groups stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/group/<dpid>[/<group_id>]

Note: Specification of group id is optional.

Response message body:

Attribute Description Exam-

ple
dpid Datapath ID "1"
length Length of this entry 56
group_id Group ID 1
ref_count Number of flows or groups that directly forward to this group 1
packet_count Number of packets processed by group 0
byte_count Number of bytes processed by group 0
duration_sec Time group has been alive in seconds 161
duration_nsec Time group has been alive in nanoseconds beyond dura- 3.03e+08
tion_sec
bucket_stats struct ofp_bucket_counter
– Number of packets processed by bucket 0
packet_count
– byte_count Number of bytes processed by bucket 0

Example of use:

$ curl -X GET http://localhost:8080/stats/group/1

6.2. ryu.app.ofctl_rest 541

ryu Documentation, Release 4.34

{
"1": [
{
"length": 56,
"group_id": 1,
"ref_count": 1,
"packet_count": 0,
"byte_count": 0,
"duration_sec": 161,
"duration_nsec": 3.03e+08,
"bucket_stats": [
{
"packet_count": 0,
"byte_count": 0
}
]
}
]
}

Get group description stats

Get group description stats of the switch which specified with Datapath ID in URI.
Usage(Openflow1.4 or earlier):

Method GET
URI /stats/groupdesc/<dpid>

Usage(Openflow1.5 or later):

Method GET
URI /stats/groupdesc/<dpid>/[<group_id>]

Note: Specification of group id is optional.

Response message body(Openflow1.3 or earlier):

Attribute Description Example

dpid Datapath ID "1"
type One of OFPGT_* "ALL"
group_id Group ID 1
buckets struct ofp_bucket
– weight Relative weight of bucket (Only defined for select groups) 0
– Port whose state affects whether this bucket is live (Only re- 4294967295
watch_port quired for fast failover groups)
– Group whose state affects whether this bucket is live (Only re- 4294967295
watch_group quired for fast failover groups)
– actions 0 or more actions associated with the bucket ["OUT-
PUT:1"]

542 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Response message body(Openflow1.4 or later):

At- Description Example

tribute
dpid Datapath ID "1"
type One of OFPGT_* "ALL"
group_id Group ID 1
length Length of this entry 40
buckets struct ofp_bucket
– weight Relative weight of bucket (Only defined for select 0
groups)
– Port whose state affects whether this bucket is live 4294967295
watch_port (Only required for fast failover groups)
– Group whose state affects whether this bucket is live 4294967295
watch_group(Only required for fast failover groups)
– len Length the bucket in bytes, including this header and 32
any adding to make it 64-bit aligned.
– ac- 0 or more actions associated with the bucket [{"OUTPUT:1",
tions "max_len": 65535,...}]

Example of use:

$ curl -X GET http://localhost:8080/stats/groupdesc/1

Response (Openflow1.3 or earlier):

{
"1": [
{
"type": "ALL",
"group_id": 1,
"buckets": [
{
"weight": 0,
"watch_port": 4294967295,
"watch_group": 4294967295,
"actions": [
"OUTPUT:1"
]
}
]
}
]
}

Response (Openflow1.4 or later):

{
"1": [
{
"type": "ALL",
"group_id": 1,
"length": 40,
"buckets": [
(continues on next page)

6.2. ryu.app.ofctl_rest 543

ryu Documentation, Release 4.34

(continued from previous page)

{
"weight": 1,
"watch_port": 1,
"watch_group": 1,
"len": 32,
"actions": [
{
"type": "OUTPUT",
"max_len": 65535,
"port": 2
}
]
}
]
}
]
}

Get group features stats

Get group features stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/groupfeatures/<dpid>

Response message body:

At- Description Example

tribute
dpid Datapath ID "1"
types Bitmap of (1 << OFPGT_*) []
values supported
capabil- Bitmap of OFPGFC_* capabil- ["SELECT_WEIGHT","SELECT_LIVENESS","CHAINING"]
ities ity supported
max_groupsMaximum number of groups for [{"ALL": 4294967040},...]
each type
actions Bitmaps of (1 << OFPAT_*) [{"ALL": ["OUTPUT",...]},...]
values supported

Example of use:
$ curl -X GET http://localhost:8080/stats/groupfeatures/1

{
"1": [
{
"types": [],
"capabilities": [
"SELECT_WEIGHT",
(continues on next page)

544 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

"SELECT_LIVENESS",
"CHAINING"
],
"max_groups": [
{
"ALL": 4294967040
},
{
"SELECT": 4294967040
},
{
"INDIRECT": 4294967040
},
{
"FF": 4294967040
}
],
"actions": [
{
"ALL": [
"OUTPUT",
"COPY_TTL_OUT",
"COPY_TTL_IN",
"SET_MPLS_TTL",
"DEC_MPLS_TTL",
"PUSH_VLAN",
"POP_VLAN",
"PUSH_MPLS",
"POP_MPLS",
"SET_QUEUE",
"GROUP",
"SET_NW_TTL",
"DEC_NW_TTL",
"SET_FIELD"
]
},
{
"SELECT": []
},
{
"INDIRECT": []
},
{
"FF": []
}
]
}
]
}

Get meters stats

Get meters stats of the switch which specified with Datapath ID in URI.
Usage:

6.2. ryu.app.ofctl_rest 545

ryu Documentation, Release 4.34

Method GET
URI /stats/meter/<dpid>[/<meter_id>]

Note: Specification of meter id is optional.

Response message body:

Attribute Description Exam-

ple
dpid Datapath ID "1"
meter_id Meter ID 1
len Length in bytes of this stats 56
flow_count Number of flows bound to meter 0
packet_in_count Number of packets in input 0
byte_in_count Number of bytes in input 0
duration_sec Time meter has been alive in seconds 37
duration_nsec Time meter has been alive in nanoseconds beyond dura- 988000
tion_sec
band_stats struct ofp_meter_band_stats
– Number of packets in band 0
packet_band_count
– byte_band_count Number of bytes in band 0

Example of use:

$ curl -X GET http://localhost:8080/stats/meter/1

{
"1": [
{
"meter_id": 1,
"len": 56,
"flow_count": 0,
"packet_in_count": 0,
"byte_in_count": 0,
"duration_sec": 37,
"duration_nsec": 988000,
"band_stats": [
{
"packet_band_count": 0,
"byte_band_count": 0
}
]
}
]
}

Get meter config stats

546 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Get meter description stats

Get meter config stats of the switch which specified with Datapath ID in URI.

Caution: This message has been renamed in openflow 1.5. If Openflow 1.4 or earlier is
in use, please used as Get meter description stats. If Openflow 1.5 or later is in use, please
used as Get meter description stats.

Usage(Openflow1.4 or earlier):

Method GET
URI /stats/meterconfig/<dpid>[/<meter_id>]

Usage(Openflow1.5 or later):

Method GET
URI /stats/meterdesc/<dpid>[/<meter_id>]

Note: Specification of meter id is optional.

Response message body:

Attribute Description Example

dpid Datapath ID "1"
flags All OFPMC_* that apply "KBPS"
meter_id Meter ID 1
bands struct ofp_meter_band_header
– type One of OFPMBT_* "DROP"
– rate Rate for this band 1000
– burst_size Size of bursts 0

Example of use:
$ curl -X GET http://localhost:8080/stats/meterconfig/1

{
"1": [
{
"flags": [
"KBPS"
],
"meter_id": 1,
"bands": [
{
"type": "DROP",
"rate": 1000,
"burst_size": 0
}
]
}
(continues on next page)

6.2. ryu.app.ofctl_rest 547

ryu Documentation, Release 4.34

(continued from previous page)

]
}

Get meter features stats

Get meter features stats of the switch which specified with Datapath ID in URI.
Usage:

Method GET
URI /stats/meterfeatures/<dpid>

Response message body:

Attribute Description Example

dpid Datapath ID "1"
max_meter Maximum number of meters 256
band_types Bitmaps of (1 << OFPMBT_*) values sup- ["DROP"]
ported
capabili- Bitmaps of "ofp_meter_flags" ["KBPS", "BURST",
ties "STATS"]
max_bands Maximum bands per meters 16
max_color Maximum color value 8

Example of use:

$ curl -X GET http://localhost:8080/stats/meterfeatures/1

{
"1": [
{
"max_meter": 256,
"band_types": [
"DROP"
],
"capabilities": [
"KBPS",
"BURST",
"STATS"
],
"max_bands": 16,
"max_color": 8
}
]
}

Get role

Get the current role of the controller from the switch.

Usage:

548 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Method GET
URI /stats/role/<dpid>

Response message body(Openflow1.4 or earlier):

Attribute Description Example

dpid Datapath ID 1
role One of OFPCR_ROLE_* "EQUAL"
generation_id Master Election Generation Id 0

Response message body(Openflow1.5 or later):

Attribute Description Example

dpid Datapath ID 1
role One of OFPCR_ROLE_* "EQUAL"
short_id ID number for the controller 0
generation_id Master Election Generation Id 0

Example of use:

$ curl -X GET http://localhost:8080/stats/role/1

Response (Openflow1.4 or earlier):

{
"1": [
{
"generation_id": 0,
"role": "EQUAL"
}
]
}

Response (Openflow1.5 or later):

{
"1": [
{
"generation_id": 0,
"role": "EQUAL",
"short_id": 0
}
]
}

6.2.2 Update the switch stats

Add a flow entry

Add a flow entry to the switch.

Usage:

6.2. ryu.app.ofctl_rest 549

ryu Documentation, Release 4.34

Method POST
URI /stats/flowentry/add

Request message body(Openflow1.3 or earlier):

At- Description Example Default

tribute
dpid Datapath ID (int) 1 (Mandatory)
cookie Opaque controller-issued identifier 1 0
(int)
cookie_maskMask used to restrict the cookie bits 1 0
(int)
table_id Table ID to put the flow in (int) 0 0
idle_timeoutIdle time before discarding (seconds) 30 0
(int)
hard_timeoutMax time before discarding (seconds) 30 0
(int)
priority Priority level of flow entry (int) 11111 0
buffer_id Buffered packet to apply to, or 1 OFP_NO_BUFFER
OFP_NO_BUFFER (int)
flags Bitmap of OFPFF_* flags (int) 1 0
match Fields to match (dict) {"in_port":1} {} #wild-
carded
actions Instruction set (list of dict) [{"type":"OUTPUT", [] #DROP
"port":2}]

Request message body(Openflow1.4 or later):

At- Description Example Default

tribute
dpid Datapath ID (int) 1 (Mandatory)
cookie Opaque controller-issued identifier 1 0
(int)
cookie_maskMask used to restrict the cookie bits 1 0
(int)
table_id Table ID to put the flow in (int) 0 0
idle_timeoutIdle time before discarding (sec- 30 0
onds) (int)
hard_timeout
Max time before discarding (sec- 30 0
onds) (int)
priority Priority level of flow entry (int) 11111 0
buffer_id Buffered packet to apply to, or 1 OFP_NO_BUFFER
OFP_NO_BUFFER (int)
flags Bitmap of OFPFF_* flags (int) 1 0
match Fields to match (dict) {"in_port":1} {} #wild-
carded
instruc- Instruction set (list of dict) [{"type":"METER", [] #DROP
tions "meter_id":2}]

550 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Note: For description of match and actions, please see Reference: Description of Match and Actions.

Example of use(Openflow1.3 or earlier):

$ curl -X POST -d '{

"dpid": 1,
"cookie": 1,
"cookie_mask": 1,
"table_id": 0,
"idle_timeout": 30,
"hard_timeout": 30,
"priority": 11111,
"flags": 1,
"match":{
"in_port":1
},
"actions":[
{
"type":"OUTPUT",
"port": 2
}
]
}' http://localhost:8080/stats/flowentry/add

$ curl -X POST -d '{

"dpid": 1,
"priority": 22222,
"match":{
"in_port":1
},
"actions":[
{
"type":"GOTO_TABLE",
"table_id": 1
}
]
}' http://localhost:8080/stats/flowentry/add

$ curl -X POST -d '{

"dpid": 1,
"priority": 33333,
"match":{
"in_port":1
},
"actions":[
{
"type":"WRITE_METADATA",
"metadata": 1,
"metadata_mask": 1
}
]
}' http://localhost:8080/stats/flowentry/add

$ curl -X POST -d '{

"dpid": 1,
(continues on next page)

6.2. ryu.app.ofctl_rest 551

ryu Documentation, Release 4.34

(continued from previous page)

"priority": 44444,
"match":{
"in_port":1
},
"actions":[
{
"type":"METER",
"meter_id": 1
}
]
}' http://localhost:8080/stats/flowentry/add

Example of use(Openflow1.4 or later):

$ curl -X POST -d '{
"dpid": 1,
"cookie": 1,
"cookie_mask": 1,
"table_id": 0,
"idle_timeout": 30,
"hard_timeout": 30,
"priority": 11111,
"flags": 1,
"match":{
"in_port":1
},
"instructions": [
{
"type": "APPLY_ACTIONS",
"actions": [
{
"max_len": 65535,
"port": 2,
"type": "OUTPUT"
}
]
}
]
}' http://localhost:8080/stats/flowentry/add

$ curl -X POST -d '{

"dpid": 1,
"priority": 22222,
"match":{
"in_port":1
},
"instructions": [
{
"type":"GOTO_TABLE",
"table_id": 1
}
]
}' http://localhost:8080/stats/flowentry/add

$ curl -X POST -d '{

"dpid": 1,
(continues on next page)

552 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

"priority": 33333,
"match":{
"in_port":1
},
"instructions": [
{
"type":"WRITE_METADATA",
"metadata": 1,
"metadata_mask": 1
}
]
}' http://localhost:8080/stats/flowentry/add

$ curl -X POST -d '{

"dpid": 1,
"priority": 44444,
"match":{
"in_port":1
},
"instructions": [
{
"type":"METER",
"meter_id": 1
}
]
}' http://localhost:8080/stats/flowentry/add

Note: To confirm flow entry registration, please see Get all flows stats or Get flows stats filtered by fields.

Modify all matching flow entries

Modify all matching flow entries of the switch.

Usage:

Method POST
URI /stats/flowentry/modify

Request message body:

6.2. ryu.app.ofctl_rest 553

ryu Documentation, Release 4.34

At- Description Example Default

Example of use:

$ curl -X POST -d '{

Modify flow entry strictly

Modify flow entry strictly matching wildcards and priority

Usage:

Method POST
URI /stats/flowentry/modify_strict

Request message body:

554 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

At- Description Example Default

Example of use:

$ curl -X POST -d '{

Delete all matching flow entries

Delete all matching flow entries of the switch.

Usage:

Method POST
URI /stats/flowentry/delete

6.2. ryu.app.ofctl_rest 555

ryu Documentation, Release 4.34

Request message body:

At- Description Example Default

tribute
dpid Datapath ID (int) 1 (Mandatory)
cookie Opaque controller-issued identifier 1 0
(int)
cookie_maskMask used to restrict the cookie bits 1 0
(int)
table_id Table ID to put the flow in (int) 0 0
idle_timeoutIdle time before discarding (seconds) 30 0
(int)
hard_timeoutMax time before discarding (seconds) 30 0
(int)
priority Priority level of flow entry (int) 11111 0
buffer_id Buffered packet to apply to, or 1 OFP_NO_BUFFER
OFP_NO_BUFFER (int)
out_port Output port (int) 1 OFPP_ANY
out_group Output group (int) 1 OFPG_ANY
flags Bitmap of OFPFF_* flags (int) 1 0
match Fields to match (dict) {"in_port":1} {} #wild-
carded
actions Instruction set (list of dict) [{"type":"OUTPUT", [] #DROP
"port":2}]

Example of use:

$ curl -X POST -d '{

Delete flow entry strictly

Delete flow entry strictly matching wildcards and priority.

Usage:

556 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Method POST
URI /stats/flowentry/delete_strict

Request message body:

At- Description Example Default

tribute
dpid Datapath ID (int) 1 (Mandatory)
cookie Opaque controller-issued identifier 1 0
(int)
cookie_maskMask used to restrict the cookie bits 1 0
(int)
table_id Table ID to put the flow in (int) 0 0
idle_timeoutIdle time before discarding (seconds) 30 0
(int)
hard_timeoutMax time before discarding (seconds) 30 0
(int)
priority Priority level of flow entry (int) 11111 0
buffer_id Buffered packet to apply to, or 1 OFP_NO_BUFFER
OFP_NO_BUFFER (int)
out_port Output port (int) 1 OFPP_ANY
out_group Output group (int) 1 OFPG_ANY
flags Bitmap of OFPFF_* flags (int) 1 0
match Fields to match (dict) {"in_port":1} {} #wild-
carded
actions Instruction set (list of dict) [{"type":"OUTPUT", [] #DROP
"port":2}]

Example of use:

$ curl -X POST -d '{

6.2. ryu.app.ofctl_rest 557

ryu Documentation, Release 4.34

Delete all flow entries

Delete all flow entries of the switch which specified with Datapath ID in URI.
Usage:

Method DELETE
URI /stats/flowentry/clear/<dpid>

Example of use:

$ curl -X DELETE http://localhost:8080/stats/flowentry/clear/1

Add a group entry

Add a group entry to the switch.

Usage:

Method POST
URI /stats/groupentry/add

Request message body:

At- Description Example De-

tribute fault
dpid Datapath ID (int) 1 (Manda-
tory)
type One of OFPGT_* (string) "ALL" "ALL"
group_id Group ID (int) 1 0
buckets struct ofp_bucket
– Relative weight of bucket (Only defined for se- 0 0
weight lect groups)
– Port whose state affects whether this bucket is 4294967295 OFPP_ANY
watch_portlive (Only required for fast failover groups)
– Group whose state affects whether this bucket is 4294967295 OFPG_ANY
watch_group
live (Only required for fast failover groups)
– 0 or more actions associated with the bucket (list [{"type": "OUT- []
actions of dict) PUT", "port": 1}] #DROP

Example of use:

$ curl -X POST -d '{

"dpid": 1,
"type": "ALL",
"group_id": 1,
"buckets": [
{
"actions": [
{
"type": "OUTPUT",
"port": 1
(continues on next page)

558 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

(continued from previous page)

}
]
}
]
}' http://localhost:8080/stats/groupentry/add

Note: To confirm group entry registration, please see Get group description stats.

Modify a group entry

Modify a group entry to the switch.

Usage:

Method POST
URI /stats/groupentry/modify

Request message body:

At- Description Example De-

Example of use:

$ curl -X POST -d '{

"dpid": 1,
"type": "ALL",
"group_id": 1,
"buckets": [
{
"actions": [
{
"type": "OUTPUT",
"port": 1
}
]
}
(continues on next page)

6.2. ryu.app.ofctl_rest 559

ryu Documentation, Release 4.34

(continued from previous page)

]
}' http://localhost:8080/stats/groupentry/modify

Delete a group entry

Delete a group entry to the switch.

Usage:

Method POST
URI /stats/groupentry/delete

Request message body:

Attribute Description Example Default

dpid Datapath ID (int) 1 (Mandatory)
group_id Group ID (int) 1 0

Example of use:

$ curl -X POST -d '{

"dpid": 1,
"group_id": 1
}' http://localhost:8080/stats/groupentry/delete

Modify the behavior of the port

Modify the behavior of the physical port.

Usage:

Method POST
URI /stats/portdesc/modify

Request message body:

Attribute Description Example Default

dpid Datapath ID (int) 1 (Mandatory)
port_no Port number (int) 1 0
config Bitmap of OFPPC_* flags (int) 1 0
mask Bitmap of OFPPC_* flags to be changed (int) 1 0

Example of use:

$ curl -X POST -d '{

"dpid": 1,
"port_no": 1,
"config": 1,
"mask": 1
}' http://localhost:8080/stats/portdesc/modify

560 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Note: To confirm port description, please see Get ports description.

Add a meter entry

Add a meter entry to the switch.

Usage:

Method POST
URI /stats/meterentry/add

Request message body:

Attribute Description Example Default

dpid Datapath ID (int) 1 (Mandatory)
flags Bitmap of OFPMF_* flags (list) ["KBPS"] [] #Empty
meter_id Meter ID (int) 1 0
bands struct ofp_meter_band_header
– type One of OFPMBT_* (string) "DROP" None
– rate Rate for this band (int) 1000 None
– burst_size Size of bursts (int) 100 None

Example of use:

$ curl -X POST -d '{

"dpid": 1,
"flags": "KBPS",
"meter_id": 1,
"bands": [
{
"type": "DROP",
"rate": 1000
}
]
}' http://localhost:8080/stats/meterentry/add

Note: To confirm meter entry registration, please see Get meter config stats.

Modify a meter entry

Modify a meter entry to the switch.

Usage:

Method POST
URI /stats/meterentry/modify

Request message body:

6.2. ryu.app.ofctl_rest 561

ryu Documentation, Release 4.34

Attribute Description Example Default

Example of use:

$ curl -X POST -d '{

"dpid": 1,
"meter_id": 1,
"flags": "KBPS",
"bands": [
{
"type": "DROP",
"rate": 1000
}
]
}' http://localhost:8080/stats/meterentry/modify

Delete a meter entry

Delete a meter entry to the switch.

Usage:

Method POST
URI /stats/meterentry/delete

Request message body:

Attribute Description Example Default

dpid Datapath ID (int) 1 (Mandatory)
meter_id Meter ID (int) 1 0

Example of use:

$ curl -X POST -d '{

"dpid": 1,
"meter_id": 1
}' http://localhost:8080/stats/meterentry/delete

Modify role

modify the role of the switch.

Usage:

562 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Method POST
URI /stats/role

Request message body:

Attribute Description Example Default

dpid Datapath ID (int) 1 (Mandatory)
role One of OFPCR_ROLE_*(string) "MASTER" OFPCR_ROLE_EQUAL

Example of use:
$ curl -X POST -d '{
"dpid": 1,
"role": "MASTER"
}' http://localhost:8080/stats/role

6.2.3 Support for experimenter multipart

Send a experimenter message

Send a experimenter message to the switch which specified with Datapath ID in URI.
Usage:

Method POST
URI /stats/experimenter/<dpid>

Request message body:

Attribute Description Example Default

dpid Datapath ID (int) 1 (Mandatory)
experimenter Experimenter ID (int) 1 0
exp_type Experimenter defined (int) 1 0
data_type Data format type ("ascii" or "base64") "ascii" "ascii"
data Data to send (string) "data" "" #Empty

Example of use:
$ curl -X POST -d '{
"dpid": 1,
"experimenter": 1,
"exp_type": 1,
"data_type": "ascii",
"data": "data"
}' http://localhost:8080/stats/experimenter/1

6.2.4 Reference: Description of Match and Actions

Description of Match on request messages

List of Match fields (OpenFlow1.0):

6.2. ryu.app.ofctl_rest 563

ryu Documentation, Release 4.34

Match Description Example

field
in_port Input switch port (int) {"in_port": 7}
dl_src Ethernet source address (string) {"dl_src": "aa:bb:cc:11:22:33"}
dl_dst Ethernet destination address (string) {"dl_dst": "aa:bb:cc:11:22:33"}
dl_vlan Input VLAN id (int) {"dl_vlan": 5}
dl_vlan_pcp Input VLAN priority (int) {"dl_vlan_pcp": 3, "dl_vlan": 3}
dl_type Ethernet frame type (int) {"dl_type": 123}
nw_tos IP ToS (int) {"nw_tos": 16, "dl_type": 2048}
nw_proto IP protocol or lower 8 bits of ARP op- {"nw_proto": 5, "dl_type": 2048}
code (int)
nw_src IPv4 source address (string) {"nw_src": "192.168.0.1", "dl_type":
2048}
nw_dst IPv4 destination address (string) {"nw_dst": "192.168.0.1/24",
"dl_type": 2048}
tp_src TCP/UDP source port (int) {"tp_src": 1, "nw_proto": 6,
"dl_type": 2048}
tp_dst TCP/UDP destination port (int) {"tp_dst": 2, "nw_proto": 6,
"dl_type": 2048}

Note: IPv4 address field can be described as IP Prefix like as follows.

IPv4 address:

"192.168.0.1"
"192.168.0.2/24"

List of Match fields (OpenFlow1.2 or later):

Match field Description Example

in_port Switch input port (int) {"in_port": 7}
in_phy_port Switch physical input port (int) {"in_phy_port": 5, "in_port": 3}
metadata Metadata passed between tables (int or string) {"metadata": 12345} or {"metadata": "0x1212
eth_dst Ethernet destination address (string) {"eth_dst": "aa:bb:cc:11:22:33/00:00:00:00:ff
eth_src Ethernet source address (string) {"eth_src": "aa:bb:cc:11:22:33"}
eth_type Ethernet frame type (int) {"eth_type": 2048}
vlan_vid VLAN id (int or string) See Example of VLAN ID match field
vlan_pcp VLAN priority (int) {"vlan_pcp": 3, "vlan_vid": 3}
ip_dscp IP DSCP (6 bits in ToS field) (int) {"ip_dscp": 3, "eth_type": 2048}
ip_ecn IP ECN (2 bits in ToS field) (int) {"ip_ecn": 0, "eth_type": 34525}
ip_proto IP protocol (int) {"ip_proto": 5, "eth_type": 34525}
ipv4_src IPv4 source address (string) {"ipv4_src": "192.168.0.1", "eth_type": 2048}
ipv4_dst IPv4 destination address (string) {"ipv4_dst": "192.168.10.10/255.255.255.0",
tcp_src TCP source port (int) {"tcp_src": 3, "ip_proto": 6, "eth_type": 2048
tcp_dst TCP destination port (int) {"tcp_dst": 5, "ip_proto": 6, "eth_type": 2048
udp_src UDP source port (int) {"udp_src": 2, "ip_proto": 17, "eth_type": 204
udp_dst UDP destination port (int) {"udp_dst": 6, "ip_proto": 17, "eth_type": 204
sctp_src SCTP source port (int) {"sctp_src": 99, "ip_proto": 132, "eth_type": 2
sctp_dst SCTP destination port (int) {"sctp_dst": 99, "ip_proto": 132, "eth_type": 2

564 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Table 1 – continued from previous page

Match field Description Example
icmpv4_type ICMP type (int) {"icmpv4_type": 5, "ip_proto": 1, "eth_type":
icmpv4_code ICMP code (int) {"icmpv4_code": 6, "ip_proto": 1, "eth_type":
arp_op ARP opcode (int) {"arp_op": 3, "eth_type": 2054}
arp_spa ARP source IPv4 address (string) {"arp_spa": "192.168.0.11", "eth_type": 2054
arp_tpa ARP target IPv4 address (string) {"arp_tpa": "192.168.0.44/24", "eth_type": 20
arp_sha ARP source hardware address (string) {"arp_sha": "aa:bb:cc:11:22:33", "eth_type": 2
arp_tha ARP target hardware address (string) {"arp_tha": "aa:bb:cc:11:22:33/00:00:00:00:ff
ipv6_src IPv6 source address (string) {"ipv6_src": "2001::aaaa:bbbb:cccc:1111", "e
ipv6_dst IPv6 destination address (string) {"ipv6_dst": "2001::ffff:cccc:bbbb:1111/64",
ipv6_flabel IPv6 Flow Label (int) {"ipv6_flabel": 2, "eth_type": 34525}
icmpv6_type ICMPv6 type (int) {"icmpv6_type": 3, "ip_proto": 58, "eth_type"
icmpv6_code ICMPv6 code (int) {"icmpv6_code": 4, "ip_proto": 58, "eth_type
ipv6_nd_target Target address for Neighbor Discovery (string) {"ipv6_nd_target": "2001::ffff:cccc:bbbb:1111
ipv6_nd_sll Source link-layer for Neighbor Discovery (string) {"ipv6_nd_sll": "aa:bb:cc:11:22:33", "icmpv6
ipv6_nd_tll Target link-layer for Neighbor Discovery (string) {"ipv6_nd_tll": "aa:bb:cc:11:22:33", "icmpv6
mpls_label MPLS label (int) {"mpls_label": 3, "eth_type": 34888}
mpls_tc MPLS Traffic Class (int) {"mpls_tc": 2, "eth_type": 34888}
mpls_bos MPLS BoS bit (int) (Openflow1.3+) {"mpls_bos": 1, "eth_type": 34888}
pbb_isid PBB I-SID (int or string) (Openflow1.3+) {"pbb_isid": 5, "eth_type": 35047} or{"pbb_i
tunnel_id Logical Port Metadata (int or string) (Openflow1.3+) {"tunnel_id": 7} or {"tunnel_id": "0x07/0xff"
ipv6_exthdr IPv6 Extension Header pseudo-field (int or string) (Openflow1.3+) {"ipv6_exthdr": 3, "eth_type": 34525} or {"ip
pbb_uca PBB UCA hander field(int) (Openflow1.4+) {"pbb_uca": 1, "eth_type": 35047}
tcp_flags TCP flags(int) (Openflow1.5+) {"tcp_flags": 2, "ip_proto": 6, "eth_type": 204
actset_output Output port from action set metadata(int) (Openflow1.5+) {"actset_output": 3}
packet_type Packet type value(int) (Openflow1.5+) {"packet_type": [1, 2048]}

Note: Some field can be described with mask like as follows.

Ethernet address:

"aa:bb:cc:11:22:33"
"aa:bb:cc:11:22:33/00:00:00:00:ff:ff"

IPv4 address:

"192.168.0.11"
"192.168.0.44/24"
"192.168.10.10/255.255.255.0"

IPv6 address:

"2001::ffff:cccc:bbbb:1111"
"2001::ffff:cccc:bbbb:2222/64"
"2001::ffff:cccc:bbbb:2222/ffff:ffff:ffff:ffff::0"

Metadata:

"0x1212121212121212"
"0x3434343434343434/0x01010101010101010"

6.2. ryu.app.ofctl_rest 565

ryu Documentation, Release 4.34

Example of VLAN ID match field

The following is available in OpenFlow1.0 or later.

• To match only packets with VLAN tag and VLAN ID equal value 5:

$ curl -X POST -d '{

"dpid": 1,
"match":{
"dl_vlan": 5
},
"actions":[
{
"type":"OUTPUT",
"port": 1
}
]
}' http://localhost:8080/stats/flowentry/add

Note: When "dl_vlan" field is described as decimal int value, OFPVID_PRESENT(0x1000) bit is auto-
matically applied.

The following is available in OpenFlow1.2 or later.

• To match only packets without a VLAN tag:

$ curl -X POST -d '{

"dpid": 1,
"match":{
"dl_vlan": "0x0000" # Describe OFPVID_NONE(0x0000)
},
"actions":[
{
"type":"OUTPUT",
"port": 1
}
]
}' http://localhost:8080/stats/flowentry/add

• To match only packets with a VLAN tag regardless of its value:

$ curl -X POST -d '{

"dpid": 1,
"match":{
"dl_vlan": "0x1000/0x1000" # Describe OFPVID_PRESENT(0x1000/
˓→0x1000)

},
"actions":[
{
"type":"OUTPUT",
"port": 1
}
]
}' http://localhost:8080/stats/flowentry/add

• To match only packets with VLAN tag and VLAN ID equal value 5:

566 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

$ curl -X POST -d '{

"dpid": 1,
"match":{
"dl_vlan": "0x1005" # Describe sum of VLAN-ID(e.g. 5) | OFPVID_
˓→PRESENT(0x1000)

},
"actions":[
{
"type":"OUTPUT",
"port": 1
}
]
}' http://localhost:8080/stats/flowentry/add

Note: When using the descriptions for OpenFlow1.2 or later, please describe "dl_vlan" field as hexadec-
imal string value, and OFPVID_PRESENT(0x1000) bit is NOT automatically applied.

Description of Actions on request messages

List of Actions (OpenFlow1.0):

Actions Description Example

OUTPUT Output packet from "port" {"type": "OUTPUT", "port": 3}
SET_VLAN_VID
Set the 802.1Q VLAN ID using {"type": "SET_VLAN_VID",
"vlan_vid" "vlan_vid": 5}
SET_VLAN_PCP
Set the 802.1Q priority using {"type": "SET_VLAN_PCP",
"vlan_pcp" "vlan_pcp": 3}
STRIP_VLAN Strip the 802.1Q header {"type": "STRIP_VLAN"}
SET_DL_SRC Set ethernet source address using {"type": "SET_DL_SRC", "dl_src":
"dl_src" "aa:bb:cc:11:22:33"}
SET_DL_DST Set ethernet destination address {"type": "SET_DL_DST", "dl_dst":
using "dl_dst" "aa:bb:cc:11:22:33"}
SET_NW_SRCIP source address using "nw_src" {"type": "SET_NW_SRC", "nw_src":
"10.0.0.1"}
SET_NW_DSTIP destination address using {"type": "SET_NW_DST", "nw_dst":
"nw_dst" "10.0.0.1"}
SET_NW_TOSSet IP ToS (DSCP field, 6 bits) us- {"type": "SET_NW_TOS", "nw_tos":
ing "nw_tos" 184}
SET_TP_SRC Set TCP/UDP source port using {"type": "SET_TP_SRC", "tp_src":
"tp_src" 8080}
SET_TP_DST Set TCP/UDP destination port us- {"type": "SET_TP_DST", "tp_dst":
ing "tp_dst" 8080}
ENQUEUE Output to queue with "queue_id" {"type": "ENQUEUE", "queue_id": 3,
attached to "port" "port": 1}

List of Actions (OpenFlow1.2 or later):

6.2. ryu.app.ofctl_rest 567

ryu Documentation, Release 4.34

Ac- Description Example

tions
OUT- Output packet from "port" {"type": "OUTPUT", "port": 3}
PUT
COPY_TTL_OUT
Copy TTL outwards {"type": "COPY_TTL_OUT"}
COPY_TTL_IN
Copy TTL inwards {"type": "COPY_TTL_IN"}
SET_MPLS_TTL
Set MPLS TTL using "mpls_ttl" {"type": "SET_MPLS_TTL", "mpls_ttl":
64}
DEC_MPLS_TTL
Decrement MPLS TTL {"type": "DEC_MPLS_TTL"}
PUSH_VLAN
Push a new VLAN tag with {"type": "PUSH_VLAN", "ethertype":
"ethertype" 33024}
POP_VLANPop the outer VLAN tag {"type": "POP_VLAN"}
PUSH_MPLS
Push a new MPLS tag with {"type": "PUSH_MPLS", "ethertype":
"ethertype" 34887}
POP_MPLSPop the outer MPLS tag with {"type": "POP_MPLS", "ethertype":
"ethertype" 2054}
SET_QUEUE
Set queue id using "queue_id" {"type": "SET_QUEUE", "queue_id": 7}
when outputting to a port
GROUP Apply group identified by {"type": "GROUP", "group_id": 5}
"group_id"
SET_NW_TTL
Set IP TTL using "nw_ttl" {"type": "SET_NW_TTL", "nw_ttl": 64}
DEC_NW_TTL
Decrement IP TTL {"type": "DEC_NW_TTL"}
SET_FIELD
Set a "field" using "value" (The See Example of set-field action
set of keywords available for
"field" is the same as match field)
PUSH_PBBPush a new PBB service tag with {"type": "PUSH_PBB", "ethertype":
"ethertype" (Openflow1.3+) 35047}
POP_PBB Pop the outer PBB service tag {"type": "POP_PBB"}
(Openflow1.3+)
COPY_FIELD
Copy value between header and {"type": "COPY_FIELD", "n_bits":
register (Openflow1.5+) 32, "src_offset": 1, "dst_offset": 2,
"src_oxm_id": "eth_src", "dst_oxm_id":
"eth_dst"}
ME- Apply meter identified by "me- {"type": "METER", "meter_id": 3}
TER ter_id" (Openflow1.5+)
EX- Extensible action for the experi- {"type": "EXPERIMENTER", "experi-
PERI- menter (Set "base64" or "ascii" to menter": 101, "data": "AAECAwQFBgc=",
MENTER "data_type" field) "data_type": "base64"}
GOTO_TABLE
(Instruction) Setup the next table {"type": "GOTO_TABLE", "table_id": 8}
identified by "table_id"
WRITE_METADATA
(Instruction) Setup the metadata {"type": "WRITE_METADATA", "meta-
field using "metadata" and "metadata": 0x3, "metadata_mask": 0x3}
data_mask"
ME- (Instruction) Apply meter identi- {"type": "METER", "meter_id": 3}
TER fied by "meter_id" (deprecated in
Openflow1.5)
WRITE_ACTIONS
(Instruction) Write the action(s) {"type": "WRITE_ACTIONS", ac-
onto the datapath action set tions":[{"type":"POP_VLAN",},{
"type":"OUTPUT", "port": 2}]}
CLEAR_ACTIONS
(Instruction) Clears all actions {"type": "CLEAR_ACTIONS"}
from the datapath action set

568 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Example of set-field action

To set VLAN ID to non-VLAN-tagged frame:

$ curl -X POST -d '{
"dpid": 1,
"match":{
"dl_type": "0x8000"
},
"actions":[
{
"type": "PUSH_VLAN", # Push a new VLAN tag if a input frame
˓→is non-VLAN-tagged

"ethertype": 33024 # Ethertype 0x8100(=33024): IEEE 802.1Q

˓→VLAN-tagged frame

},
{
"type": "SET_FIELD",
"field": "vlan_vid", # Set VLAN ID
"value": 4102 # Describe sum of vlan_id(e.g. 6) |
˓→OFPVID_PRESENT(0x1000=4096)

},
{
"type": "OUTPUT",
"port": 2
}
]
}' http://localhost:8080/stats/flowentry/add

6.3 ryu.app.rest_vtep

This sample application performs as VTEP for EVPN VXLAN and constructs a Single Subnet per EVI corresponding
to the VLAN Based service in [RFC7432].

Note: This app will invoke OVSDB request to the switches. Please set the manager address before calling the API of
this app.
$ sudo ovs-vsctl set-manager ptcp:6640
$ sudo ovs-vsctl show
...(snip)
Manager "ptcp:6640"
...(snip)

6.3.1 Usage Example

Environment

This example supposes the following environment:

Host A (172.17.0.1) Host B (172.17.0.2)
+--------------------+ +--------------------+
(continues on next page)

6.3. ryu.app.rest_vtep 569

ryu Documentation, Release 4.34

(continued from previous page)

| Ryu1 | --- BGP(EVPN) --- | Ryu2 |
+--------------------+ +--------------------+
| |
+--------------------+ +--------------------+
| s1 (OVS) | ===== vxlan ===== | s2 (OVS) |
+--------------------+ +--------------------+
(s1-eth1) (s1-eth2) (s2-eth1) (s2-eth2)
| | | |
+--------+ +--------+ +--------+ +--------+
| s1h1 | | s1h2 | | s2h1 | | s2h2 |
+--------+ +--------+ +--------+ +--------+

Configuration steps

1. Creates a new BGPSpeaker instance on each host.

On Host A:
(Host A)$ curl -X POST -d '{
"dpid": 1,
"as_number": 65000,
"router_id": "172.17.0.1"
}' http://localhost:8080/vtep/speakers | python -m json.tool

On Host B:
(Host B)$ curl -X POST -d '{
"dpid": 1,
"as_number": 65000,
"router_id": "172.17.0.2"
}' http://localhost:8080/vtep/speakers | python -m json.tool

2. Registers the neighbor for the speakers on each host.

On Host A:
(Host A)$ curl -X POST -d '{
"address": "172.17.0.2",
"remote_as": 65000
}' http://localhost:8080/vtep/neighbors |
python -m json.tool

On Host B:
(Host B)$ curl -X POST -d '{
"address": "172.17.0.1",
"remote_as": 65000
}' http://localhost:8080/vtep/neighbors |
python -m json.tool

3. Defines a new VXLAN network(VNI=10) on the Host A/B.

On Host A:
(Host A)$ curl -X POST -d '{
"vni": 10
}' http://localhost:8080/vtep/networks | python -m json.tool

570 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

On Host B:

(Host B)$ curl -X POST -d '{

"vni": 10
}' http://localhost:8080/vtep/networks | python -m json.tool

4. Registers the clients to the VXLAN network.

For "s1h1"(ip="10.0.0.11", mac="aa:bb:cc:00:00:11") on Host A:

(Host A)$ curl -X POST -d '{

"port": "s1-eth1",
"mac": "aa:bb:cc:00:00:11",
"ip": "10.0.0.11"
} ' http://localhost:8080/vtep/networks/10/clients |
python -m json.tool

For "s2h1"(ip="10.0.0.21", mac="aa:bb:cc:00:00:21") on Host B:

(Host B)$ curl -X POST -d '{

"port": "s2-eth1",
"mac": "aa:bb:cc:00:00:21",
"ip": "10.0.0.21"
} ' http://localhost:8080/vtep/networks/10/clients |
python -m json.tool

Testing

If BGP (EVPN) connection between Ryu1 and Ryu2 has been established, pings between the client s1h1 and s2h1
should work.

(s1h1)$ ping 10.0.0.21

Troubleshooting

If connectivity between s1h1 and s2h1 isn’t working, please check the followings.
1. Make sure that Host A and Host B have full network connectivity.

(Host A)$ ping 172.17.0.2

2. Make sure that BGP(EVPN) connection has been established.

(Host A)$ curl -X GET http://localhost:8080/vtep/neighbors |

python -m json.tool

...
{
"172.17.0.2": {
"EvpnNeighbor": {
"address": "172.17.0.2",
"remote_as": 65000,
"state": "up" # "up" shows the connection established
}
}
}

6.3. ryu.app.rest_vtep 571

ryu Documentation, Release 4.34

3. Make sure that BGP(EVPN) routes have been advertised.

(Host A)$ curl -X GET http://localhost:8080/vtep/networks |

python -m json.tool

...
{
"10": {
"EvpnNetwork": {
"clients": {
"aa:bb:cc:00:00:11": {
"EvpnClient": {
"ip": "10.0.0.11",
"mac": "aa:bb:cc:00:00:11",
"next_hop": "172.17.0.1",
"port": 1
}
},
"aa:bb:cc:00:00:21": { # route for "s2h1" on Host B
"EvpnClient": {
"ip": "10.0.0.21",
"mac": "aa:bb:cc:00:00:21",
"next_hop": "172.17.0.2",
"port": 3
}
}
},
"ethernet_tag_id": 0,
"route_dist": "65000:10",
"vni": 10
}
}
}

4. Make sure that the IPv6 is enabled on your environment. Some Ryu BGP features require the IPv6 connectivity to
bind sockets. Mininet seems to disable IPv6 on its installation.
For example:

$ sysctl net.ipv6.conf.all.disable_ipv6
net.ipv6.conf.all.disable_ipv6 = 0 # should NOT be enabled

$ grep GRUB_CMDLINE_LINUX_DEFAULT /etc/default/grub

# please remove "ipv6.disable=1" and reboot
GRUB_CMDLINE_LINUX_DEFAULT="ipv6.disable=1 quiet splash"

5. Make sure that your switch using the OpenFlow version 1.3. This application supports only the OpenFlow version
1.3.
For example:

$ ovs-vsctl get Bridge s1 protocols

["OpenFlow13"]

Note: At the time of this writing, we use the the following version of Ryu, Open vSwitch and Mininet.

572 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

$ ryu --version
ryu 4.19

$ ovs-vsctl --version
ovs-vsctl (Open vSwitch) 2.5.2 # APT packaged version of Ubuntu 16.04
Compiled Oct 17 2017 16:38:57
DB Schema 7.12.1

$ mn --version
2.2.1 # APT packaged version of Ubuntu 16.04

6.3.2 REST API

class ryu.app.rest_vtep.RestVtepController(req, link, data, **config)

add_speaker(req, **kwargs)
Creates a new BGPSpeaker instance.
Usage:

Method URI
POST /vtep/speakers

Request parameters:

Attribute Description
dpid ID of Datapath binding to speaker. (e.g. 1)
as_number AS number. (e.g. 65000)
router_id Router ID. (e.g. "172.17.0.1")

Example:
$ curl -X POST -d '{
"dpid": 1,
"as_number": 65000,
"router_id": "172.17.0.1"
}' http://localhost:8080/vtep/speakers | python -m json.tool

{
"172.17.0.1": {
"EvpnSpeaker": {
"as_number": 65000,
"dpid": 1,
"neighbors": {},
"router_id": "172.17.0.1"
}
}
}

get_speakers(_, **kwargs)
Gets the info of BGPSpeaker instance.
Usage:

6.3. ryu.app.rest_vtep 573

ryu Documentation, Release 4.34

Method URI
GET /vtep/speakers

Example:

$ curl -X GET http://localhost:8080/vtep/speakers |

python -m json.tool

{
"172.17.0.1": {
"EvpnSpeaker": {
"as_number": 65000,
"dpid": 1,
"neighbors": {
"172.17.0.2": {
"EvpnNeighbor": {
"address": "172.17.0.2",
"remote_as": 65000,
"state": "up"
}
}
},
"router_id": "172.17.0.1"
}
}
}

del_speaker(_, **kwargs)
Shutdowns BGPSpeaker instance.
Usage:

Method URI
DELETE /vtep/speakers

Example:

$ curl -X DELETE http://localhost:8080/vtep/speakers |

python -m json.tool

{
"172.17.0.1": {
"EvpnSpeaker": {
"as_number": 65000,
"dpid": 1,
"neighbors": {},
"router_id": "172.17.0.1"
}
}
}

add_neighbor(req, **kwargs)
Registers a new neighbor to the speaker.
Usage:

574 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Method URI
POST /vtep/neighbors

Request parameters:

Attribute Description
address IP address of neighbor. (e.g. "172.17.0.2")
remote_as AS number of neighbor. (e.g. 65000)

Example:

$ curl -X POST -d '{

"address": "172.17.0.2",
"remote_as": 65000
}' http://localhost:8080/vtep/neighbors |
python -m json.tool

{
"172.17.0.2": {
"EvpnNeighbor": {
"address": "172.17.0.2",
"remote_as": 65000,
"state": "down"
}
}
}

get_neighbors(_, **kwargs)
Gets a list of all neighbors.
Usage:

Method URI
GET /vtep/neighbors

Example:

$ curl -X GET http://localhost:8080/vtep/neighbors |

python -m json.tool

{
"172.17.0.2": {
"EvpnNeighbor": {
"address": "172.17.0.2",
"remote_as": 65000,
"state": "up"
}
}
}

get_neighbor(_, **kwargs)
Gets the neighbor for the specified address.
Usage:

6.3. ryu.app.rest_vtep 575

ryu Documentation, Release 4.34

Method URI
GET /vtep/neighbors/{address}

Request parameters:

Attribute Description
address IP address of neighbor. (e.g. "172.17.0.2")

Example:

$ curl -X GET http://localhost:8080/vtep/neighbors/172.17.0.2 |

python -m json.tool

{
"172.17.0.2": {
"EvpnNeighbor": {
"address": "172.17.0.2",
"remote_as": 65000,
"state": "up"
}
}
}

del_neighbor(_, **kwargs)
Unregister the specified neighbor from the speaker.
Usage:

Method URI
DELETE /vtep/speaker/neighbors/{address}

Request parameters:

Attribute Description
address IP address of neighbor. (e.g. "172.17.0.2")

Example:

$ curl -X DELETE http://localhost:8080/vtep/speaker/neighbors/172.17.0.2 |

python -m json.tool

{
"172.17.0.2": {
"EvpnNeighbor": {
"address": "172.17.0.2",
"remote_as": 65000,
"state": "up"
}
}
}

add_network(req, **kwargs)
Defines a new network.

576 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Usage:

Method URI
POST /vtep/networks

Request parameters:

Attribute Description
vni Virtual Network Identifier. (e.g. 10)

Example:

$ curl -X POST -d '{

"vni": 10
}' http://localhost:8080/vtep/networks | python -m json.tool

{
"10": {
"EvpnNetwork": {
"clients": {},
"ethernet_tag_id": 0,
"route_dist": "65000:10",
"vni": 10
}
}
}

get_networks(_, **kwargs)
Gets a list of all networks.
Usage:

Method URI
GET /vtep/networks

Example:

$ curl -X GET http://localhost:8080/vtep/networks |

python -m json.tool

{
"10": {
"EvpnNetwork": {
"clients": {
"aa:bb:cc:dd:ee:ff": {
"EvpnClient": {
"ip": "10.0.0.1",
"mac": "aa:bb:cc:dd:ee:ff",
"next_hop": "172.17.0.1",
"port": 1
}
}
},
"ethernet_tag_id": 0,
(continues on next page)

6.3. ryu.app.rest_vtep 577

ryu Documentation, Release 4.34

(continued from previous page)

"route_dist": "65000:10",
"vni": 10
}
}
}

get_network(_, **kwargs)
Gets the network for the specified VNI.
Usage:

Method URI
GET /vtep/networks/{vni}

Request parameters:

Attribute Description
vni Virtual Network Identifier. (e.g. 10)

Example:

$ curl -X GET http://localhost:8080/vtep/networks/10 |

python -m json.tool

del_network(_, **kwargs)
Deletes the network for the specified VNI.
Usage:

Method URI
DELETE /vtep/networks/{vni}

Request parameters:

578 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

Attribute Description
vni Virtual Network Identifier. (e.g. 10)

Example:

$ curl -X DELETE http://localhost:8080/vtep/networks/10 |

python -m json.tool

{
"10": {
"EvpnNetwork": {
"ethernet_tag_id": 10,
"clients": [
{
"EvpnClient": {
"ip": "10.0.0.11",
"mac": "e2:b1:0c:ba:42:ed",
"port": 1
}
}
],
"route_dist": "65000:100",
"vni": 10
}
}
}

add_client(req, **kwargs)
Registers a new client to the specified network.
Usage:

Method URI
POST /vtep/networks/{vni}/clients

Request parameters:

At- Description
tribute
vni Virtual Network Identifier. (e.g. 10)
port Port number to connect client. For convenience, port name can be specified and
automatically translated to port number. (e.g. "s1-eth1" or 1)
mac Client MAC address to register. (e.g. "aa:bb:cc:dd:ee:ff")
ip Client IP address. (e.g. "10.0.0.1")

Example:

$ curl -X POST -d '{

"port": "s1-eth1",
"mac": "aa:bb:cc:dd:ee:ff",
"ip": "10.0.0.1"
}' http://localhost:8080/vtep/networks/10/clients |
python -m json.tool

6.3. ryu.app.rest_vtep 579

ryu Documentation, Release 4.34

{
"10": {
"EvpnClient": {
"ip": "10.0.0.1",
"mac": "aa:bb:cc:dd:ee:ff",
"next_hop": "172.17.0.1",
"port": 1
}
}
}

del_client(_, **kwargs)
Registers a new client to the specified network.
Usage:

Method URI
DELETE /vtep/networks/{vni}/clients/{mac}

Request parameters:

Attribute Description
vni Virtual Network Identifier. (e.g. 10)
mac Client MAC address to register.

Example:

$ curl -X DELETE http://localhost:8080/vtep/networks/10/clients/

˓→aa:bb:cc:dd:ee:ff |

python -m json.tool

{
"10": {
"EvpnClient": {
"ip": "10.0.0.1",
"mac": "aa:bb:cc:dd:ee:ff",
"next_hop": "172.17.0.1",
"port": 1
}
}
}

6.4 ryu.services.protocols.bgp.application

This module provides a convenient application for using Ryu BGPSpeaker and for writing your BGP application.
It reads a configuration file which includes settings for neighbors, routes and some others. Please refer to ryu/
services/protocols/bgp/bgp_sample_conf.py for the sample configuration.
Usage Example:

$ ryu-manager ryu/services/protocols/bgp/application.py \
--bgp-app-config-file ryu/services/protocols/bgp/bgp_sample_conf.py

580 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

6.4.1 SSH Console

You can also use the SSH console and see the RIB and do some operations from this console. The SSH port and
username/password can be configured by the configuration file. You can check the help by hitting ’?’ key in this
interface.
Example:

$ ssh localhost -p 4990

Hello, this is Ryu BGP speaker (version 4.19).

bgpd> # Hit '?' key

clear - allows to reset BGP connections
help - show this help
quit - exit this session
set - set runtime settings
show - shows runtime state information
bgpd>
bgpd> show rib all
Status codes: * valid, > best
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Labels Next Hop Reason Metric LocPrf Path
*> 10.10.1.0/24 None 0.0.0.0 Only Path i
bgpd>

6.4.2 Integration with Other Applications

ryu.services.protocols.bgp.application.RyuBGPSpeaker will notifies the following events to

other Ryu applications.
• EventBestPathChanged
• EventAdjRibInChanged
• EventPeerDown
• EventPeerUp
To catch these events, specify @set_ev_cls() decorator to the event handlers in the Ryu applications.
Example Application:

# my_bgp_app.py

from ryu.base import app_manager

from ryu.controller.handler import set_ev_cls
from ryu.services.protocols.bgp import application as bgp_application

class MyBGPApp(app_manager.RyuApp):
_CONTEXTS = {
'ryubgpspeaker': bgp_application.RyuBGPSpeaker,
}

def init(self, *args, **kwargs):

super(MyBGPApp, self).__init__(*args, **kwargs)

(continues on next page)

6.4. ryu.services.protocols.bgp.application 581

ryu Documentation, Release 4.34

(continued from previous page)

# Stores "ryu.services.protocols.bgp.application.RyuBGPSpeaker"
# instance in order to call the APIs of
# "ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker" via
# "self.app.speaker".
# Please note at this time, "BGPSpeaker" is NOT instantiated yet.
self.app = kwargs['ryubgpspeaker']

@set_ev_cls(bgp_application.EventBestPathChanged)
def _best_patch_changed_handler(self, ev):
self.logger.info(
'Best path changed: is_withdraw=%s, path=%s',
ev.is_withdraw, ev.path)

Usage Example:

$ ryu-manager my_bgp_app.py \
--bgp-app-config-file ryu/services/protocols/bgp/bgp_sample_conf.py

Note: For the APIs for ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker, please refer to BGP

speaker library API Reference.

6.4.3 API Reference

exception ryu.services.protocols.bgp.application.ApplicationException(desc=None)
Specific Base exception related to BSPSpeaker.
class ryu.services.protocols.bgp.application.EventAdjRibInChanged(path,
is_withdraw,
peer_ip,
peer_as)
Event called when any adj-RIB-in path is changed due to UPDATE messages or remote peer’s down.
This event is the wrapper for adj_rib_in_change_handler of bgpspeaker.BGPSpeaker.
path attribute contains an instance of info_base.base.Path subclasses.
If is_withdraw attribute is True, path attribute has the information of the withdraw route.
peer_ip is the peer’s IP address who sent this path.
peer_as is the peer’s AS number who sent this path.
class ryu.services.protocols.bgp.application.EventBestPathChanged(path,
is_withdraw)
Event called when any best remote path is changed due to UPDATE messages or remote peer’s down.
This event is the wrapper for best_path_change_handler of bgpspeaker.BGPSpeaker.
path attribute contains an instance of info_base.base.Path subclasses.
If is_withdraw attribute is True, path attribute has the information of the withdraw route.
class ryu.services.protocols.bgp.application.EventPeerDown(remote_ip, re-
mote_as)
Event called when the session to the remote peer goes down.
This event is the wrapper for peer_down_handler of bgpspeaker.BGPSpeaker.

582 Chapter 6. Built-in Ryu applications

ryu Documentation, Release 4.34

remote_ip attribute is the IP address of the remote peer.

remote_as attribute is the AS number of the remote peer.
class ryu.services.protocols.bgp.application.EventPeerUp(remote_ip, remote_as)
Event called when the session to the remote peer goes up.
This event is the wrapper for peer_up_handler of bgpspeaker.BGPSpeaker.
remote_ip attribute is the IP address of the remote peer.
remote_as attribute is the AS number of the remote peer.
class ryu.services.protocols.bgp.application.RyuBGPSpeaker(*args, **kwargs)
Base application for implementing BGP applications.
start()
Hook that is called after startup initialization is done.
ryu.services.protocols.bgp.application.load_config(config_file)
Validates the given file for use as the settings file for BGPSpeaker and loads the configuration from the given
file as a module instance.
ryu.services.protocols.bgp.application.validate_rpc_host(ip)
Validates the given ip for use as RPC server address.

6.4. ryu.services.protocols.bgp.application 583

ryu Documentation, Release 4.34

584 Chapter 6. Built-in Ryu applications

CHAPTER 7

Indices and tables

• genindex
• modindex
• search

585
ryu Documentation, Release 4.34

586 Chapter 7. Indices and tables

Python Module Index

r ryu.lib.packet.packet_base, 19
ryu.app.cbench, 9 ryu.lib.packet.pbb, 86
ryu.app.ofctl.api, 515 ryu.lib.packet.sctp, 87
ryu.app.ofctl.exception, 516 ryu.lib.packet.slow, 98
ryu.app.rest_vtep, 569 ryu.lib.packet.stream_parser, 19
ryu.app.simple_switch, 9 ryu.lib.packet.tcp, 102
ryu.base.app_manager, 7 ryu.lib.packet.udp, 103
ryu.controller.controller, 7 ryu.lib.packet.vlan, 104
ryu.controller.dpset, 7 ryu.lib.packet.vrrp, 105
ryu.controller.ofp_event, 7 ryu.lib.packet.vxlan, 108
ryu.controller.ofp_handler, 7 ryu.lib.packet.zebra, 109
ryu.lib.netconf, 9 ryu.lib.xflow, 10
ryu.lib.of_config, 9 ryu.ofproto.nicira_ext, 494
ryu.lib.ovs, 9 ryu.ofproto.ofproto_v1_0, 8
ryu.lib.ovs.bridge, 135 ryu.ofproto.ofproto_v1_0_parser, 8
ryu.lib.ovs.vsctl, 134 ryu.ofproto.ofproto_v1_2, 8
ryu.lib.packet, 9 ryu.ofproto.ofproto_v1_2_parser, 8
ryu.lib.packet.arp, 20 ryu.ofproto.ofproto_v1_3, 8
ryu.lib.packet.bfd, 21 ryu.ofproto.ofproto_v1_3_parser, 8
ryu.lib.packet.bgp, 26 ryu.ofproto.ofproto_v1_4, 9
ryu.lib.packet.bmp, 41 ryu.ofproto.ofproto_v1_4_parser, 9
ryu.lib.packet.bpdu, 46 ryu.ofproto.ofproto_v1_5, 9
ryu.lib.packet.cfm, 51 ryu.ofproto.ofproto_v1_5_parser, 9
ryu.lib.packet.dhcp, 57 ryu.services.protocols.bgp.application,
ryu.lib.packet.dhcp6, 58 580
ryu.lib.packet.ethernet, 60 ryu.topology, 9
ryu.lib.packet.geneve, 61
ryu.lib.packet.gre, 62
ryu.lib.packet.icmp, 63
ryu.lib.packet.icmpv6, 65
ryu.lib.packet.igmp, 69
ryu.lib.packet.ipv4, 73
ryu.lib.packet.ipv6, 74
ryu.lib.packet.llc, 77
ryu.lib.packet.lldp, 79
ryu.lib.packet.mpls, 82
ryu.lib.packet.openflow, 83
ryu.lib.packet.ospf, 84
ryu.lib.packet.packet, 18

587
ryu Documentation, Release 4.34

588 Python Module Index

Index

Symbols (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
_CONTEXTS (ryu.base.app_manager.RyuApp attribute), method), 120
496 attribute_map_set()
_EVENTS (ryu.base.app_manager.RyuApp attribute), (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
496 method), 120
_TYPE (ryu.ofproto.ofproto_parser.MsgBase attribute), AttributeMap (class in
139 ryu.services.protocols.bgp.info_base.base),
129
A AttrLenError, 26
add_bond() (ryu.lib.ovs.bridge.OVSBridge method), auth (class in ryu.lib.packet.ipv6), 74
135 authenticate() (ryu.lib.packet.bfd.bfd method), 25
add_client() (ryu.app.rest_vtep.RestVtepController authenticate() (ryu.lib.packet.bfd.KeyedMD5
method), 579 method), 22
add_db_attribute() authenticate() (ryu.lib.packet.bfd.KeyedSHA1
(ryu.lib.ovs.bridge.OVSBridge method), 135 method), 23
add_gre_port() (ryu.lib.ovs.bridge.OVSBridge authenticate() (ryu.lib.packet.bfd.SimplePassword
method), 136 method), 24
add_neighbor() (ryu.app.rest_vtep.RestVtepController AuthFailure, 26
method), 574
add_network() (ryu.app.rest_vtep.RestVtepController
B
method), 576 BadBgpId, 31
add_protocol() (ryu.lib.packet.packet.Packet BadLen, 31
method), 18 BadMsg, 31
add_speaker() (ryu.app.rest_vtep.RestVtepController BadNotification, 31
method), 573 BadPeerAs, 31
add_tunnel_port() (ryu.lib.ovs.bridge.OVSBridge bfd (class in ryu.lib.packet.bfd), 25
method), 136 BFDAuth (class in ryu.lib.packet.bfd), 22
add_vxlan_port() (ryu.lib.ovs.bridge.OVSBridge BGPEvpnEsiLabelExtendedCommunity (class in
method), 136 ryu.lib.packet.bgp), 26
AdminReset, 26 BGPEvpnEsImportRTExtendedCommunity (class
AdminShutdown, 26 in ryu.lib.packet.bgp), 26
ApplicationException, 582 BGPEvpnMacMobilityExtendedCommunity
arp (class in ryu.lib.packet.arp), 20 (class in ryu.lib.packet.bgp), 26
arp_ip() (in module ryu.lib.packet.arp), 21 BgpExc, 31
ASPathFilter (class in BGPFlowSpecRedirectCommunity (class in
ryu.services.protocols.bgp.info_base.base), ryu.lib.packet.bgp), 27
129 BGPFlowSpecTPIDActionCommunity (class in
AttrFlagError, 26 ryu.lib.packet.bgp), 27
attribute_map_get() BGPFlowSpecTrafficActionCommunity (class
in ryu.lib.packet.bgp), 27

589
ryu Documentation, Release 4.34

BGPFlowSpecTrafficMarkingCommunity (class cause_unrecognized_param (class in

in ryu.lib.packet.bgp), 27 ryu.lib.packet.sctp), 89
BGPFlowSpecTrafficRateCommunity (class in cause_unresolvable_addr (class in
ryu.lib.packet.bgp), 27 ryu.lib.packet.sctp), 90
BGPFlowSpecVlanActionCommunity (class in cause_user_initiated_abort (class in
ryu.lib.packet.bgp), 27 ryu.lib.packet.sctp), 90
BGPKeepAlive (class in ryu.lib.packet.bgp), 28 cc_message (class in ryu.lib.packet.cfm), 51
BGPMessage (class in ryu.lib.packet.bgp), 28 cfm (class in ryu.lib.packet.cfm), 52
BGPNotification (class in ryu.lib.packet.bgp), 28 ChassisID (class in ryu.lib.packet.lldp), 80
BGPOpen (class in ryu.lib.packet.bgp), 29 chunk_abort (class in ryu.lib.packet.sctp), 90
BGPPathAttributePmsiTunnel (class in chunk_cookie_ack (class in ryu.lib.packet.sctp), 90
ryu.lib.packet.bgp), 30 chunk_cookie_echo (class in ryu.lib.packet.sctp), 91
BGPRouteRefresh (class in ryu.lib.packet.bgp), 30 chunk_cwr (class in ryu.lib.packet.sctp), 91
BGPSpeaker (class in chunk_data (class in ryu.lib.packet.sctp), 91
ryu.services.protocols.bgp.bgpspeaker), 119 chunk_ecn_echo (class in ryu.lib.packet.sctp), 92
BGPUpdate (class in ryu.lib.packet.bgp), 30 chunk_error (class in ryu.lib.packet.sctp), 92
bmp_server_add() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
chunk_heartbeat (class in ryu.lib.packet.sctp), 92
method), 120 chunk_heartbeat_ack (class in ryu.lib.packet.sctp),
bmp_server_del() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker 93
method), 120 chunk_init (class in ryu.lib.packet.sctp), 93
BMPInitiation (class in ryu.lib.packet.bmp), 41 chunk_init_ack (class in ryu.lib.packet.sctp), 93
BMPMessage (class in ryu.lib.packet.bmp), 42 chunk_sack (class in ryu.lib.packet.sctp), 94
BMPPeerDownNotification (class in chunk_shutdown (class in ryu.lib.packet.sctp), 94
ryu.lib.packet.bmp), 42 chunk_shutdown_ack (class in ryu.lib.packet.sctp),
BMPPeerMessage (class in ryu.lib.packet.bmp), 43 94
BMPPeerUpNotification (class in chunk_shutdown_complete (class in
ryu.lib.packet.bmp), 44 ryu.lib.packet.sctp), 95
BMPRouteMonitoring (class in ryu.lib.packet.bmp), clear_db_attribute()
44 (ryu.lib.ovs.bridge.OVSBridge method), 136
BMPStatisticsReport (class in clone() (ryu.services.protocols.bgp.info_base.base.ASPathFilter
ryu.lib.packet.bmp), 45 method), 129
BMPTermination (class in ryu.lib.packet.bmp), 46 clone() (ryu.services.protocols.bgp.info_base.base.AttributeMap
bpdu (class in ryu.lib.packet.bpdu), 51 method), 130
clone() (ryu.services.protocols.bgp.info_base.base.PrefixFilter
C method), 128
cause_cookie_while_shutdown (class in close() (ryu.base.app_manager.RyuApp method), 496
ryu.lib.packet.sctp), 87 CODE (ryu.lib.packet.bgp.BgpExc attribute), 31
cause_invalid_param (class in ryu.lib.packet.sctp), CollisionResolution, 31
87 ConfigurationBPDUs (class in ryu.lib.packet.bpdu),
cause_invalid_stream_id (class in 48
ryu.lib.packet.sctp), 87 ConnRejected, 32
cause_missing_param (class in ryu.lib.packet.sctp), context_iteritems()
87 (ryu.base.app_manager.RyuApp class method),
cause_no_userdata (class in ryu.lib.packet.sctp), 88 496
cause_out_of_resource (class in ControlFormatI (class in ryu.lib.packet.llc), 78
ryu.lib.packet.sctp), 88 ControlFormatS (class in ryu.lib.packet.llc), 78
cause_protocol_violation (class in ControlFormatU (class in ryu.lib.packet.llc), 78
ryu.lib.packet.sctp), 88 create() (ryu.lib.packet.vrrp.vrrpv2 static method),
cause_restart_with_new_addr (class in 107
ryu.lib.packet.sctp), 88 create() (ryu.lib.packet.vrrp.vrrpv3 static method),
cause_stale_cookie (class in ryu.lib.packet.sctp), 107
89 create_packet() (ryu.lib.packet.vrrp.vrrp method),
cause_unrecognized_chunk (class in 106
ryu.lib.packet.sctp), 89

590 Index
ryu Documentation, Release 4.34

D EventOFPPortStateChange (class in
data_tlv (class in ryu.lib.packet.cfm), 53 ryu.controller.ofp_event), 13
Datapath (class in ryu.controller.controller), 12 EventOFPStateChange (class in
db_get_map() (ryu.lib.ovs.bridge.OVSBridge ryu.controller.ofp_event), 13
method), 136 EventPeerDown (class in
db_get_val() (ryu.lib.ovs.bridge.OVSBridge ryu.services.protocols.bgp.application), 582
method), 136 EventPeerUp (class in
del_client() (ryu.app.rest_vtep.RestVtepController ryu.services.protocols.bgp.application), 583
method), 580 EventPortAdd (class in ryu.controller.dpset), 14
del_controller() (ryu.lib.ovs.bridge.OVSBridge EventPortDelete (class in ryu.controller.dpset), 14
method), 136 EventPortModify (class in ryu.controller.dpset), 14
del_neighbor() (ryu.app.rest_vtep.RestVtepController EventPrefix (class in
method), 576 ryu.services.protocols.bgp.bgpspeaker), 127
del_network() (ryu.app.rest_vtep.RestVtepController EventReplyBase (class in ryu.controller.event), 13
method), 578 EventRequestBase (class in ryu.controller.event), 13
del_port() (ryu.lib.ovs.bridge.OVSBridge method), EventTunnelKeyAdd (class in
136 ryu.controller.tunnels), 15
del_qos() (ryu.lib.ovs.bridge.OVSBridge method), EventTunnelKeyDel (class in
137 ryu.controller.tunnels), 16
del_speaker() (ryu.app.rest_vtep.RestVtepController EventTunnelPort (class in ryu.controller.tunnels),
method), 574 16
delete_port() (ryu.lib.ovs.bridge.OVSBridge evpn_prefix_add()
method), 137 (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
dest_unreach (class in ryu.lib.packet.icmp), 63 method), 121
dhcp (class in ryu.lib.packet.dhcp), 57 evpn_prefix_del()
dhcp6 (class in ryu.lib.packet.dhcp6), 59 (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
DPSet (class in ryu.controller.dpset), 497 method), 122
dst_opts (class in ryu.lib.packet.ipv6), 74 EvpnArbitraryEsi (class in ryu.lib.packet.bgp), 32
EvpnASBasedEsi (class in ryu.lib.packet.bgp), 32
E EvpnEsi (class in ryu.lib.packet.bgp), 32
echo (class in ryu.lib.packet.icmp), 64 EvpnEthernetAutoDiscoveryNLRI (class in
echo (class in ryu.lib.packet.icmpv6), 65 ryu.lib.packet.bgp), 32
End (class in ryu.lib.packet.lldp), 80 EvpnEthernetSegmentNLRI (class in
ethernet (class in ryu.lib.packet.ethernet), 60 ryu.lib.packet.bgp), 32
EvpnInclusiveMulticastEthernetTagNLRI
evaluate() (ryu.services.protocols.bgp.info_base.base.ASPathFilter
method), 129 (class in ryu.lib.packet.bgp), 32
EvpnIpPrefixNLRI
evaluate() (ryu.services.protocols.bgp.info_base.base.AttributeMap (class in ryu.lib.packet.bgp), 32
method), 130 EvpnL2BridgeEsi (class in ryu.lib.packet.bgp), 33
EvpnLACPEsi
evaluate() (ryu.services.protocols.bgp.info_base.base.PrefixFilter (class in ryu.lib.packet.bgp), 33
method), 129 EvpnMacBasedEsi (class in ryu.lib.packet.bgp), 33
EventAdjRibInChanged (class in EvpnMacIPAdvertisementNLRI (class in
ryu.services.protocols.bgp.application), 582 ryu.lib.packet.bgp), 33
EventBase (class in ryu.controller.event), 13 EvpnNLRI (class in ryu.lib.packet.bgp), 33
EventBestPathChanged (class in EvpnRouterIDEsi (class in ryu.lib.packet.bgp), 33
ryu.services.protocols.bgp.application), 582 EvpnUnknownEsi (class in ryu.lib.packet.bgp), 33
EventDP (class in ryu.controller.dpset), 13 EvpnUnknownNLRI (class in ryu.lib.packet.bgp), 33
EventMacAddress (class in ryu.controller.network),
15
F
EventNetworkDel (class in ryu.controller.network), find_db_attributes()
15 (ryu.lib.ovs.bridge.OVSBridge method), 137
EventNetworkPort (class in ryu.controller.network), FiniteStateMachineError, 33
14 flowspec_prefix_add()
EventOFPMsgBase (class in ryu.controller.ofp_event), (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
11 method), 122

Index 591
ryu Documentation, Release 4.34

flowspec_prefix_del() from_jsondict() (ryu.ofproto.ofproto_parser.MsgBase

(ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker class method), 139
method), 123 from_user() (ryu.lib.packet.bgp.FlowSpecIPv4NLRI
FlowSpecComponentUnknown (class in class method), 34
ryu.lib.packet.bgp), 33 from_user() (ryu.lib.packet.bgp.FlowSpecIPv6NLRI
FlowSpecDestinationMac (class in class method), 36
ryu.lib.packet.bgp), 34 from_user() (ryu.lib.packet.bgp.FlowSpecL2VPNNLRI
FlowSpecDestPort (class in ryu.lib.packet.bgp), 33 class method), 38
FlowSpecDestPrefix (class in ryu.lib.packet.bgp), from_user() (ryu.lib.packet.bgp.FlowSpecVPNv4NLRI
33 class method), 39
FlowSpecDSCP (class in ryu.lib.packet.bgp), 33 from_user() (ryu.lib.packet.bgp.FlowSpecVPNv6NLRI
FlowSpecEtherType (class in ryu.lib.packet.bgp), 34 class method), 39
FlowSpecFragment (class in ryu.lib.packet.bgp), 34
FlowSpecIcmpCode (class in ryu.lib.packet.bgp), 37 G
FlowSpecIcmpType (class in ryu.lib.packet.bgp), 37 geneve (class in ryu.lib.packet.geneve), 61
FlowSpecInnerVLANCoS (class in get() (ryu.controller.dpset.DPSet method), 497
ryu.lib.packet.bgp), 37 get_all() (ryu.controller.dpset.DPSet method), 497
FlowSpecInnerVLANID (class in ryu.lib.packet.bgp), get_controller() (ryu.lib.ovs.bridge.OVSBridge
37 method), 137
FlowSpecIPProtocol (class in ryu.lib.packet.bgp), get_datapath() (in module ryu.app.ofctl.api), 515
34 get_datapath_id() (ryu.lib.ovs.bridge.OVSBridge
FlowSpecIPv4NLRI (class in ryu.lib.packet.bgp), 34 method), 137
FlowSpecIPv6DestPrefix (class in get_db_attribute()
ryu.lib.packet.bgp), 36 (ryu.lib.ovs.bridge.OVSBridge method), 137
FlowSpecIPv6FlowLabel (class in get_neighbor() (ryu.app.rest_vtep.RestVtepController
ryu.lib.packet.bgp), 36 method), 575
FlowSpecIPv6Fragment (class in get_neighbors() (ryu.app.rest_vtep.RestVtepController
ryu.lib.packet.bgp), 36 method), 575
FlowSpecIPv6NLRI (class in ryu.lib.packet.bgp), 36 get_network() (ryu.app.rest_vtep.RestVtepController
FlowSpecIPv6SrcPrefix (class in method), 578
ryu.lib.packet.bgp), 37 get_networks() (ryu.app.rest_vtep.RestVtepController
FlowSpecL2VPNNLRI (class in ryu.lib.packet.bgp), 37 method), 577
FlowSpecLLCControl (class in ryu.lib.packet.bgp), get_ofport() (ryu.lib.ovs.bridge.OVSBridge
38 method), 137
FlowSpecLLCDSAP (class in ryu.lib.packet.bgp), 38 get_packet_type()
FlowSpecLLCSSAP (class in ryu.lib.packet.bgp), 38 (ryu.lib.packet.ethernet.ethernet class method),
FlowSpecNextHeader (class in ryu.lib.packet.bgp), 61
38 get_packet_type()
FlowSpecPacketLen (class in ryu.lib.packet.bgp), 38 (ryu.lib.packet.packet_base.PacketBase class
FlowSpecPort (class in ryu.lib.packet.bgp), 38 method), 19
FlowSpecSNAP (class in ryu.lib.packet.bgp), 38 get_packet_type() (ryu.lib.packet.udp.udp static
FlowSpecSourceMac (class in ryu.lib.packet.bgp), 38 method), 104
FlowSpecSrcPort (class in ryu.lib.packet.bgp), 38 get_packet_type() (ryu.lib.packet.vlan.svlan class
FlowSpecSrcPrefix (class in ryu.lib.packet.bgp), 39 method), 104
FlowSpecTCPFlags (class in ryu.lib.packet.bgp), 39 get_packet_type() (ryu.lib.packet.vlan.vlan class
FlowSpecVLANCoS (class in ryu.lib.packet.bgp), 39 method), 105
FlowSpecVLANID (class in ryu.lib.packet.bgp), 39 get_port() (ryu.controller.dpset.DPSet method), 497
FlowSpecVPNv4NLRI (class in ryu.lib.packet.bgp), 39 get_port_name_list()
FlowSpecVPNv6NLRI (class in ryu.lib.packet.bgp), 39 (ryu.lib.ovs.bridge.OVSBridge method), 137
fragment (class in ryu.lib.packet.ipv6), 74 get_ports() (ryu.controller.dpset.DPSet method),
from_jsondict() (ryu.lib.packet.bgp.BGPPathAttributePmsiTunnel
497
class method), 30 get_protocol() (ryu.lib.packet.packet.Packet
from_jsondict() (ryu.lib.packet.packet.Packet class method), 18
method), 18

592 Index
ryu Documentation, Release 4.34

get_protocols() (ryu.lib.packet.packet.Packet llc (class in ryu.lib.packet.llc), 78

method), 18 lldp (class in ryu.lib.packet.lldp), 81
get_speakers() (ryu.app.rest_vtep.RestVtepController load_config() (in module
method), 573 ryu.services.protocols.bgp.application), 583
get_vif_ports() (ryu.lib.ovs.bridge.OVSBridge loopback_message (class in ryu.lib.packet.cfm), 54
method), 138 loopback_reply (class in ryu.lib.packet.cfm), 54
gre (class in ryu.lib.packet.gre), 62 ltm_egress_identifier_tlv (class in
ryu.lib.packet.cfm), 54
H ltr_egress_identifier_tlv (class in
has_flags() (ryu.lib.packet.tcp.tcp method), 103 ryu.lib.packet.cfm), 55
header (class in ryu.lib.packet.ipv6), 75
HoldTimerExpired, 40 M
hop_opts (class in ryu.lib.packet.ipv6), 75 MalformedAsPath, 40
MalformedAttrList, 40
I MalformedOptionalParam, 40
icmp (class in ryu.lib.packet.icmp), 64 ManagementAddress (class in ryu.lib.packet.lldp), 80
icmpv6 (class in ryu.lib.packet.icmpv6), 65 MaxPrefixReached, 40
igmp (class in ryu.lib.packet.igmp), 70 MeticulousKeyedMD5 (class in ryu.lib.packet.bfd),
igmpv3_query (class in ryu.lib.packet.igmp), 71 23
igmpv3_report (class in ryu.lib.packet.igmp), 72 MeticulousKeyedSHA1 (class in ryu.lib.packet.bfd),
igmpv3_report_group (class in 24
ryu.lib.packet.igmp), 73 MissingWellKnown, 40
mld (class in ryu.lib.packet.icmpv6), 66
in_filter_get() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
method), 123 mldv2_query (class in ryu.lib.packet.icmpv6), 66
mldv2_report (class in ryu.lib.packet.icmpv6), 66
in_filter_set() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
method), 124 mldv2_report_group (class in
init() (ryu.lib.ovs.bridge.OVSBridge method), 138 ryu.lib.packet.icmpv6), 66
interface_status_tlv (class in mpls (class in ryu.lib.packet.mpls), 82
ryu.lib.packet.cfm), 53 MsgBase (class in ryu.ofproto.ofproto_parser), 139
InterfaceLinkParams (class in
ryu.lib.packet.zebra), 109 N
InvalidChecksum, 84 nd_neighbor (class in ryu.lib.packet.icmpv6), 67
InvalidDatapath, 516 nd_option_mtu (class in ryu.lib.packet.icmpv6), 67
InvalidNetworkField, 40 nd_option_pi (class in ryu.lib.packet.icmpv6), 67
InvalidNextHop, 40 nd_option_sla (class in ryu.lib.packet.icmpv6), 68
InvalidOriginError, 40 nd_option_tla (class in ryu.lib.packet.icmpv6), 68
ipv4 (class in ryu.lib.packet.ipv4), 73 nd_router_advert (class in ryu.lib.packet.icmpv6),
ipv6 (class in ryu.lib.packet.ipv6), 75 68
itag (class in ryu.lib.packet.pbb), 86 nd_router_solicit (class in
ryu.lib.packet.icmpv6), 68
K neighbor_add() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
KeyedMD5 (class in ryu.lib.packet.bfd), 22 method), 124
KeyedSHA1 (class in ryu.lib.packet.bfd), 23 neighbor_del() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
method), 125
L neighbor_get() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
label_from_bin() (in module ryu.lib.packet.mpls), method), 125
82 neighbor_reset() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeake
label_to_bin() (in module ryu.lib.packet.mpls), 82 method), 125
lacp (class in ryu.lib.packet.slow), 98 neighbor_state_get()
link_trace_message (class in ryu.lib.packet.cfm), (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
53 method), 125
link_trace_reply (class in ryu.lib.packet.cfm), 53 neighbor_update()
list_db_attributes() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
(ryu.lib.ovs.bridge.OVSBridge method), 138 method), 125

Index 593
ryu Documentation, Release 4.34

neighbors_get() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
NXActionOutputTrunc (class in
method), 125 ryu.ofproto.ofproto_v1_3_parser), 492
NextHopBlackhole (class in ryu.lib.packet.zebra), NXActionPopMpls (class in
109 ryu.ofproto.ofproto_v1_0_parser), 475
NextHopIFIndex (class in ryu.lib.packet.zebra), 109 NXActionPopQueue (class in
NextHopIFName (class in ryu.lib.packet.zebra), 109 ryu.ofproto.ofproto_v1_3_parser), 477
NextHopIPv4 (class in ryu.lib.packet.zebra), 109 NXActionPushMpls (class in
NextHopIPv4IFIndex (class in ryu.lib.packet.zebra), ryu.ofproto.ofproto_v1_0_parser), 475
109 NXActionRegLoad (class in
NextHopIPv4IFName (class in ryu.lib.packet.zebra), ryu.ofproto.ofproto_v1_3_parser), 478
109 NXActionRegLoad2 (class in
NextHopIPv6 (class in ryu.lib.packet.zebra), 109 ryu.ofproto.ofproto_v1_3_parser), 478
NextHopIPv6IFIndex (class in ryu.lib.packet.zebra), NXActionRegMove (class in
109 ryu.ofproto.ofproto_v1_3_parser), 480
NextHopIPv6IFName (class in ryu.lib.packet.zebra), NXActionResubmit (class in
109 ryu.ofproto.ofproto_v1_3_parser), 480
NotSync, 40 NXActionResubmitTable (class in
nvgre() (in module ryu.lib.packet.gre), 63 ryu.ofproto.ofproto_v1_3_parser), 481
NXActionBundle (class in NXActionSample (class in
ryu.ofproto.ofproto_v1_3_parser), 489 ryu.ofproto.ofproto_v1_3_parser), 486
NXActionBundleLoad (class in NXActionSample2 (class in
ryu.ofproto.ofproto_v1_3_parser), 490 ryu.ofproto.ofproto_v1_3_parser), 487
NXActionConjunction (class in NXActionSetMplsLabel (class in
ryu.ofproto.ofproto_v1_3_parser), 488 ryu.ofproto.ofproto_v1_0_parser), 477
NXActionController (class in NXActionSetMplsTc (class in
ryu.ofproto.ofproto_v1_3_parser), 484 ryu.ofproto.ofproto_v1_0_parser), 477
NXActionController2 (class in NXActionSetMplsTtl (class in
ryu.ofproto.ofproto_v1_3_parser), 484 ryu.ofproto.ofproto_v1_0_parser), 476
NXActionCT (class in NXActionSetQueue (class in
ryu.ofproto.ofproto_v1_3_parser), 490 ryu.ofproto.ofproto_v1_0_parser), 474
NXActionDecMplsTtl (class in NXActionSetTunnel (class in
ryu.ofproto.ofproto_v1_0_parser), 476 ryu.ofproto.ofproto_v1_3_parser), 479
NXActionDecNshTtl (class in NXActionSetTunnel64 (class in
ryu.ofproto.ofproto_v1_3_parser), 493 ryu.ofproto.ofproto_v1_3_parser), 479
NXActionDecTtl (class in NXActionStackPop (class in
ryu.ofproto.ofproto_v1_0_parser), 475 ryu.ofproto.ofproto_v1_3_parser), 486
NXActionDecTtlCntIds (class in NXActionStackPush (class in
ryu.ofproto.ofproto_v1_3_parser), 485 ryu.ofproto.ofproto_v1_3_parser), 485
NXActionExit (class in NXFlowSpecLoad (class in
ryu.ofproto.ofproto_v1_3_parser), 484 ryu.ofproto.ofproto_v1_3_parser), 493
NXActionFinTimeout (class in NXFlowSpecMatch (class in
ryu.ofproto.ofproto_v1_3_parser), 487 ryu.ofproto.ofproto_v1_3_parser), 493
NXActionLearn (class in NXFlowSpecOutput (class in
ryu.ofproto.ofproto_v1_3_parser), 482 ryu.ofproto.ofproto_v1_3_parser), 493
NXActionMultipath (class in
ryu.ofproto.ofproto_v1_3_parser), 488 O
NXActionNAT (class in OFError, 516
ryu.ofproto.ofproto_v1_3_parser), 491 ofp_msg_from_jsondict() (in module
NXActionNote (class in ryu.ofproto.ofproto_parser), 140
ryu.ofproto.ofproto_v1_3_parser), 479 OFP_VERSIONS (ryu.base.app_manager.RyuApp
NXActionOutputReg (class in attribute), 496
ryu.ofproto.ofproto_v1_3_parser), 481 OFPAction (class in ryu.ofproto.ofproto_v1_0_parser),
NXActionOutputReg2 (class in 162
ryu.ofproto.ofproto_v1_3_parser), 482

594 Index
ryu Documentation, Release 4.34

OFPActionCopyField (class in OFPActionHeader (class in

ryu.ofproto.ofproto_v1_5_parser), 472 ryu.ofproto.ofproto_v1_0_parser), 162
OFPActionCopyTtlIn (class in OFPActionMeter (class in
ryu.ofproto.ofproto_v1_2_parser), 212 ryu.ofproto.ofproto_v1_5_parser), 472
OFPActionCopyTtlIn (class in OFPActionNwAddr (class in
ryu.ofproto.ofproto_v1_3_parser), 277 ryu.ofproto.ofproto_v1_0_parser), 163
OFPActionCopyTtlIn (class in OFPActionOutput (class in
ryu.ofproto.ofproto_v1_4_parser), 375 ryu.ofproto.ofproto_v1_0_parser), 162
OFPActionCopyTtlIn (class in OFPActionOutput (class in
ryu.ofproto.ofproto_v1_5_parser), 470 ryu.ofproto.ofproto_v1_2_parser), 211
OFPActionCopyTtlOut (class in OFPActionOutput (class in
ryu.ofproto.ofproto_v1_2_parser), 212 ryu.ofproto.ofproto_v1_3_parser), 276
OFPActionCopyTtlOut (class in OFPActionOutput (class in
ryu.ofproto.ofproto_v1_3_parser), 277 ryu.ofproto.ofproto_v1_4_parser), 374
OFPActionCopyTtlOut (class in OFPActionOutput (class in
ryu.ofproto.ofproto_v1_4_parser), 375 ryu.ofproto.ofproto_v1_5_parser), 470
OFPActionCopyTtlOut (class in OFPActionPopMpls (class in
ryu.ofproto.ofproto_v1_5_parser), 470 ryu.ofproto.ofproto_v1_2_parser), 213
OFPActionDecMplsTtl (class in OFPActionPopMpls (class in
ryu.ofproto.ofproto_v1_2_parser), 212 ryu.ofproto.ofproto_v1_3_parser), 277
OFPActionDecMplsTtl (class in OFPActionPopMpls (class in
ryu.ofproto.ofproto_v1_3_parser), 276 ryu.ofproto.ofproto_v1_4_parser), 375
OFPActionDecMplsTtl (class in OFPActionPopMpls (class in
ryu.ofproto.ofproto_v1_4_parser), 375 ryu.ofproto.ofproto_v1_5_parser), 471
OFPActionDecMplsTtl (class in OFPActionPopPbb (class in
ryu.ofproto.ofproto_v1_5_parser), 471 ryu.ofproto.ofproto_v1_4_parser), 376
OFPActionDecNwTtl (class in OFPActionPopPbb (class in
ryu.ofproto.ofproto_v1_2_parser), 212 ryu.ofproto.ofproto_v1_5_parser), 472
OFPActionDecNwTtl (class in OFPActionPopVlan (class in
ryu.ofproto.ofproto_v1_3_parser), 277 ryu.ofproto.ofproto_v1_2_parser), 213
OFPActionDecNwTtl (class in OFPActionPopVlan (class in
ryu.ofproto.ofproto_v1_4_parser), 376 ryu.ofproto.ofproto_v1_3_parser), 277
OFPActionDecNwTtl (class in OFPActionPopVlan (class in
ryu.ofproto.ofproto_v1_5_parser), 472 ryu.ofproto.ofproto_v1_4_parser), 375
OFPActionDlAddr (class in OFPActionPopVlan (class in
ryu.ofproto.ofproto_v1_0_parser), 163 ryu.ofproto.ofproto_v1_5_parser), 471
OFPActionEnqueue (class in OFPActionPushMpls (class in
ryu.ofproto.ofproto_v1_0_parser), 164 ryu.ofproto.ofproto_v1_2_parser), 213
OFPActionExperimenter (class in OFPActionPushMpls (class in
ryu.ofproto.ofproto_v1_2_parser), 213 ryu.ofproto.ofproto_v1_3_parser), 277
OFPActionExperimenter (class in OFPActionPushMpls (class in
ryu.ofproto.ofproto_v1_3_parser), 278 ryu.ofproto.ofproto_v1_4_parser), 375
OFPActionExperimenter (class in OFPActionPushMpls (class in
ryu.ofproto.ofproto_v1_4_parser), 376 ryu.ofproto.ofproto_v1_5_parser), 471
OFPActionExperimenter (class in OFPActionPushPbb (class in
ryu.ofproto.ofproto_v1_5_parser), 473 ryu.ofproto.ofproto_v1_4_parser), 376
OFPActionGroup (class in OFPActionPushPbb (class in
ryu.ofproto.ofproto_v1_2_parser), 211 ryu.ofproto.ofproto_v1_5_parser), 472
OFPActionGroup (class in OFPActionPushVlan (class in
ryu.ofproto.ofproto_v1_3_parser), 276 ryu.ofproto.ofproto_v1_2_parser), 212
OFPActionGroup (class in OFPActionPushVlan (class in
ryu.ofproto.ofproto_v1_4_parser), 376 ryu.ofproto.ofproto_v1_3_parser), 277
OFPActionGroup (class in OFPActionPushVlan (class in
ryu.ofproto.ofproto_v1_5_parser), 471 ryu.ofproto.ofproto_v1_4_parser), 375

Index 595
ryu Documentation, Release 4.34

OFPActionPushVlan (class in OFPActionVlanPcp (class in

ryu.ofproto.ofproto_v1_5_parser), 471 ryu.ofproto.ofproto_v1_0_parser), 163
OFPActionSetDlDst (class in OFPActionVlanVid (class in
ryu.ofproto.ofproto_v1_0_parser), 163 ryu.ofproto.ofproto_v1_0_parser), 162
OFPActionSetDlSrc (class in OFPAggregateStatsReply (class in
ryu.ofproto.ofproto_v1_0_parser), 163 ryu.ofproto.ofproto_v1_0_parser), 151
OFPActionSetField (class in OFPAggregateStatsReply (class in
ryu.ofproto.ofproto_v1_2_parser), 213 ryu.ofproto.ofproto_v1_2_parser), 183
OFPActionSetField (class in OFPAggregateStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 277 ryu.ofproto.ofproto_v1_3_parser), 238
OFPActionSetField (class in OFPAggregateStatsReply (class in
ryu.ofproto.ofproto_v1_4_parser), 376 ryu.ofproto.ofproto_v1_4_parser), 309
OFPActionSetField (class in OFPAggregateStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 472 ryu.ofproto.ofproto_v1_5_parser), 401
OFPActionSetMplsTtl (class in OFPAggregateStatsRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 212 ryu.ofproto.ofproto_v1_0_parser), 150
OFPActionSetMplsTtl (class in OFPAggregateStatsRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 276 ryu.ofproto.ofproto_v1_2_parser), 182
OFPActionSetMplsTtl (class in OFPAggregateStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 375 ryu.ofproto.ofproto_v1_3_parser), 237
OFPActionSetMplsTtl (class in OFPAggregateStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 470 ryu.ofproto.ofproto_v1_4_parser), 308
OFPActionSetNwDst (class in OFPAggregateStatsRequest (class in
ryu.ofproto.ofproto_v1_0_parser), 163 ryu.ofproto.ofproto_v1_5_parser), 400
OFPActionSetNwSrc (class in OFPBarrierReply (class in
ryu.ofproto.ofproto_v1_0_parser), 163 ryu.ofproto.ofproto_v1_0_parser), 155
OFPActionSetNwTos (class in OFPBarrierReply (class in
ryu.ofproto.ofproto_v1_0_parser), 163 ryu.ofproto.ofproto_v1_2_parser), 197
OFPActionSetNwTtl (class in OFPBarrierReply (class in
ryu.ofproto.ofproto_v1_2_parser), 212 ryu.ofproto.ofproto_v1_3_parser), 258
OFPActionSetNwTtl (class in OFPBarrierReply (class in
ryu.ofproto.ofproto_v1_3_parser), 276 ryu.ofproto.ofproto_v1_4_parser), 339
OFPActionSetNwTtl (class in OFPBarrierReply (class in
ryu.ofproto.ofproto_v1_4_parser), 376 ryu.ofproto.ofproto_v1_5_parser), 437
OFPActionSetNwTtl (class in OFPBarrierRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 471 ryu.ofproto.ofproto_v1_0_parser), 155
OFPActionSetQueue (class in OFPBarrierRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 212 ryu.ofproto.ofproto_v1_2_parser), 196
OFPActionSetQueue (class in OFPBarrierRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 276 ryu.ofproto.ofproto_v1_3_parser), 257
OFPActionSetQueue (class in OFPBarrierRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 375 ryu.ofproto.ofproto_v1_4_parser), 339
OFPActionSetQueue (class in OFPBarrierRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 471 ryu.ofproto.ofproto_v1_5_parser), 436
OFPActionSetTpDst (class in OFPBundleAddMsg (class in
ryu.ofproto.ofproto_v1_0_parser), 164 ryu.ofproto.ofproto_v1_4_parser), 343
OFPActionSetTpSrc (class in OFPBundleAddMsg (class in
ryu.ofproto.ofproto_v1_0_parser), 164 ryu.ofproto.ofproto_v1_5_parser), 440
OFPActionStripVlan (class in OFPBundleCtrlMsg (class in
ryu.ofproto.ofproto_v1_0_parser), 163 ryu.ofproto.ofproto_v1_4_parser), 341
OFPActionTpPort (class in OFPBundleCtrlMsg (class in
ryu.ofproto.ofproto_v1_0_parser), 164 ryu.ofproto.ofproto_v1_5_parser), 439
OFPActionVendor (class in OFPBundleFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_0_parser), 164 ryu.ofproto.ofproto_v1_5_parser), 433

596 Index
ryu Documentation, Release 4.34

OFPBundleFeaturesStatsRequest (class in OFPErrorMsg (class in

ryu.ofproto.ofproto_v1_5_parser), 432 ryu.ofproto.ofproto_v1_3_parser), 268
OFPControllerStatus (class in OFPErrorMsg (class in
ryu.ofproto.ofproto_v1_5_parser), 460 ryu.ofproto.ofproto_v1_4_parser), 369
OFPControllerStatusStats (class in OFPErrorMsg (class in
ryu.ofproto.ofproto_v1_5_parser), 473 ryu.ofproto.ofproto_v1_5_parser), 464
OFPControllerStatusStatsReply (class in OFPExperimenter (class in
ryu.ofproto.ofproto_v1_5_parser), 422 ryu.ofproto.ofproto_v1_2_parser), 207
OFPControllerStatusStatsRequest (class in OFPExperimenter (class in
ryu.ofproto.ofproto_v1_5_parser), 421 ryu.ofproto.ofproto_v1_3_parser), 271
OFPDescStats (class in OFPExperimenter (class in
ryu.ofproto.ofproto_v1_2_parser), 176 ryu.ofproto.ofproto_v1_4_parser), 370
OFPDescStatsReply (class in OFPExperimenter (class in
ryu.ofproto.ofproto_v1_0_parser), 148 ryu.ofproto.ofproto_v1_5_parser), 465
OFPDescStatsReply (class in OFPExperimenterStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 228 ryu.ofproto.ofproto_v1_4_parser), 337
OFPDescStatsReply (class in OFPExperimenterStatsReply (class in
ryu.ofproto.ofproto_v1_4_parser), 300 ryu.ofproto.ofproto_v1_5_parser), 435
OFPDescStatsReply (class in OFPExperimenterStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 394 ryu.ofproto.ofproto_v1_4_parser), 337
OFPDescStatsRequest (class in OFPExperimenterStatsRequest (class in
ryu.ofproto.ofproto_v1_0_parser), 148 ryu.ofproto.ofproto_v1_5_parser), 434
OFPDescStatsRequest (class in OFPFeaturesRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 176 ryu.ofproto.ofproto_v1_0_parser), 140
OFPDescStatsRequest (class in OFPFeaturesRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 228 ryu.ofproto.ofproto_v1_2_parser), 164
OFPDescStatsRequest (class in OFPFeaturesRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 299 ryu.ofproto.ofproto_v1_3_parser), 213
OFPDescStatsRequest (class in OFPFeaturesRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 394 ryu.ofproto.ofproto_v1_4_parser), 278
OFPEchoReply (class in OFPFeaturesRequest (class in
ryu.ofproto.ofproto_v1_0_parser), 160 ryu.ofproto.ofproto_v1_5_parser), 377
OFPEchoReply (class in OFPFlowDescStatsReply (class in
ryu.ofproto.ofproto_v1_2_parser), 206 ryu.ofproto.ofproto_v1_5_parser), 396
OFPEchoReply (class in OFPFlowDescStatsRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 271 ryu.ofproto.ofproto_v1_5_parser), 395
OFPEchoReply (class in OFPFlowMod (class in
ryu.ofproto.ofproto_v1_4_parser), 368 ryu.ofproto.ofproto_v1_0_parser), 144
OFPEchoReply (class in OFPFlowMod (class in
ryu.ofproto.ofproto_v1_5_parser), 463 ryu.ofproto.ofproto_v1_2_parser), 169
OFPEchoRequest (class in OFPFlowMod (class in
ryu.ofproto.ofproto_v1_0_parser), 159 ryu.ofproto.ofproto_v1_3_parser), 217
OFPEchoRequest (class in OFPFlowMod (class in
ryu.ofproto.ofproto_v1_2_parser), 206 ryu.ofproto.ofproto_v1_4_parser), 282
OFPEchoRequest (class in OFPFlowMod (class in
ryu.ofproto.ofproto_v1_3_parser), 270 ryu.ofproto.ofproto_v1_5_parser), 380
OFPEchoRequest (class in OFPFlowMonitorReply (class in
ryu.ofproto.ofproto_v1_4_parser), 367 ryu.ofproto.ofproto_v1_4_parser), 335
OFPEchoRequest (class in OFPFlowMonitorReply (class in
ryu.ofproto.ofproto_v1_5_parser), 463 ryu.ofproto.ofproto_v1_5_parser), 430
OFPErrorMsg (class in OFPFlowMonitorRequest (class in
ryu.ofproto.ofproto_v1_0_parser), 159 ryu.ofproto.ofproto_v1_4_parser), 333
OFPErrorMsg (class in OFPFlowMonitorRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 204 ryu.ofproto.ofproto_v1_5_parser), 428

Index 597
ryu Documentation, Release 4.34

OFPFlowRemoved (class in OFPGetConfigRequest (class in

ryu.ofproto.ofproto_v1_0_parser), 157 ryu.ofproto.ofproto_v1_2_parser), 167
OFPFlowRemoved (class in OFPGetConfigRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 201 ryu.ofproto.ofproto_v1_3_parser), 215
OFPFlowRemoved (class in OFPGetConfigRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 265 ryu.ofproto.ofproto_v1_4_parser), 280
OFPFlowRemoved (class in OFPGetConfigRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 358 ryu.ofproto.ofproto_v1_5_parser), 378
OFPFlowRemoved (class in OFPGroupDescStats (class in
ryu.ofproto.ofproto_v1_5_parser), 451 ryu.ofproto.ofproto_v1_2_parser), 191
OFPFlowStats (class in OFPGroupDescStatsReply (class in
ryu.ofproto.ofproto_v1_2_parser), 178 ryu.ofproto.ofproto_v1_3_parser), 246
OFPFlowStatsReply (class in OFPGroupDescStatsReply (class in
ryu.ofproto.ofproto_v1_0_parser), 149 ryu.ofproto.ofproto_v1_4_parser), 327
OFPFlowStatsReply (class in OFPGroupDescStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 230 ryu.ofproto.ofproto_v1_5_parser), 414
OFPFlowStatsReply (class in OFPGroupDescStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 301 ryu.ofproto.ofproto_v1_2_parser), 190
OFPFlowStatsReply (class in OFPGroupDescStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 398 ryu.ofproto.ofproto_v1_3_parser), 246
OFPFlowStatsRequest (class in OFPGroupDescStatsRequest (class in
ryu.ofproto.ofproto_v1_0_parser), 149 ryu.ofproto.ofproto_v1_4_parser), 326
OFPFlowStatsRequest (class in OFPGroupDescStatsRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 177 ryu.ofproto.ofproto_v1_5_parser), 414
OFPFlowStatsRequest (class in OFPGroupFeaturesStats (class in
ryu.ofproto.ofproto_v1_3_parser), 229 ryu.ofproto.ofproto_v1_2_parser), 192
OFPFlowStatsRequest (class in OFPGroupFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_4_parser), 300 ryu.ofproto.ofproto_v1_3_parser), 248
OFPFlowStatsRequest (class in OFPGroupFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 397 ryu.ofproto.ofproto_v1_4_parser), 328
OFPGetAsyncReply (class in OFPGroupFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 261 ryu.ofproto.ofproto_v1_5_parser), 416
OFPGetAsyncReply (class in OFPGroupFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 347 ryu.ofproto.ofproto_v1_2_parser), 192
OFPGetAsyncReply (class in OFPGroupFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 447 ryu.ofproto.ofproto_v1_3_parser), 248
OFPGetAsyncRequest (class in OFPGroupFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 261 ryu.ofproto.ofproto_v1_4_parser), 328
OFPGetAsyncRequest (class in OFPGroupFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 347 ryu.ofproto.ofproto_v1_5_parser), 416
OFPGetAsyncRequest (class in OFPGroupMod (class in
ryu.ofproto.ofproto_v1_5_parser), 446 ryu.ofproto.ofproto_v1_2_parser), 172
OFPGetConfigReply (class in OFPGroupMod (class in
ryu.ofproto.ofproto_v1_0_parser), 143 ryu.ofproto.ofproto_v1_3_parser), 224
OFPGetConfigReply (class in OFPGroupMod (class in
ryu.ofproto.ofproto_v1_2_parser), 167 ryu.ofproto.ofproto_v1_4_parser), 295
OFPGetConfigReply (class in OFPGroupMod (class in
ryu.ofproto.ofproto_v1_3_parser), 215 ryu.ofproto.ofproto_v1_5_parser), 388
OFPGetConfigReply (class in OFPGroupStats (class in
ryu.ofproto.ofproto_v1_4_parser), 280 ryu.ofproto.ofproto_v1_2_parser), 190
OFPGetConfigReply (class in OFPGroupStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 379 ryu.ofproto.ofproto_v1_3_parser), 246
OFPGetConfigRequest (class in OFPGroupStatsReply (class in
ryu.ofproto.ofproto_v1_0_parser), 143 ryu.ofproto.ofproto_v1_4_parser), 325

598 Index
ryu Documentation, Release 4.34

OFPGroupStatsReply (class in OFPInstructionWriteMetadata (class in

ryu.ofproto.ofproto_v1_5_parser), 413 ryu.ofproto.ofproto_v1_5_parser), 469
OFPGroupStatsRequest (class in OFPMatch (class in ryu.ofproto.ofproto_v1_0_parser),
ryu.ofproto.ofproto_v1_2_parser), 189 161
OFPGroupStatsRequest (class in OFPMatch (class in ryu.ofproto.ofproto_v1_2_parser),
ryu.ofproto.ofproto_v1_3_parser), 245 208
OFPGroupStatsRequest (class in OFPMatch (class in ryu.ofproto.ofproto_v1_3_parser),
ryu.ofproto.ofproto_v1_4_parser), 325 272
OFPGroupStatsRequest (class in OFPMatch (class in ryu.ofproto.ofproto_v1_4_parser),
ryu.ofproto.ofproto_v1_5_parser), 412 371
OFPHello (class in ryu.ofproto.ofproto_v1_0_parser), OFPMatch (class in ryu.ofproto.ofproto_v1_5_parser),
159 466
OFPHello (class in ryu.ofproto.ofproto_v1_2_parser), OFPMeterConfigStatsReply (class in
206 ryu.ofproto.ofproto_v1_3_parser), 251
OFPHello (class in ryu.ofproto.ofproto_v1_3_parser), OFPMeterConfigStatsReply (class in
269 ryu.ofproto.ofproto_v1_4_parser), 331
OFPHello (class in ryu.ofproto.ofproto_v1_4_parser), OFPMeterConfigStatsRequest (class in
367 ryu.ofproto.ofproto_v1_3_parser), 250
OFPHello (class in ryu.ofproto.ofproto_v1_5_parser), OFPMeterConfigStatsRequest (class in
462 ryu.ofproto.ofproto_v1_4_parser), 331
OFPHelloElemVersionBitmap (class in OFPMeterDescStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 270 ryu.ofproto.ofproto_v1_5_parser), 419
OFPHelloElemVersionBitmap (class in OFPMeterDescStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 367 ryu.ofproto.ofproto_v1_5_parser), 418
OFPHelloElemVersionBitmap (class in OFPMeterFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 462 ryu.ofproto.ofproto_v1_3_parser), 252
OFPInstructionActions (class in OFPMeterFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_2_parser), 211 ryu.ofproto.ofproto_v1_4_parser), 333
OFPInstructionActions (class in OFPMeterFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 275 ryu.ofproto.ofproto_v1_5_parser), 420
OFPInstructionActions (class in OFPMeterFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 374 ryu.ofproto.ofproto_v1_3_parser), 252
OFPInstructionActions (class in OFPMeterFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 469 ryu.ofproto.ofproto_v1_4_parser), 332
OFPInstructionGotoTable (class in OFPMeterFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 210 ryu.ofproto.ofproto_v1_5_parser), 420
OFPInstructionGotoTable (class in OFPMeterMod (class in
ryu.ofproto.ofproto_v1_3_parser), 275 ryu.ofproto.ofproto_v1_3_parser), 227
OFPInstructionGotoTable (class in OFPMeterMod (class in
ryu.ofproto.ofproto_v1_4_parser), 373 ryu.ofproto.ofproto_v1_4_parser), 298
OFPInstructionGotoTable (class in OFPMeterMod (class in
ryu.ofproto.ofproto_v1_5_parser), 469 ryu.ofproto.ofproto_v1_5_parser), 392
OFPInstructionMeter (class in OFPMeterStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 276 ryu.ofproto.ofproto_v1_3_parser), 249
OFPInstructionMeter (class in OFPMeterStatsReply (class in
ryu.ofproto.ofproto_v1_4_parser), 374 ryu.ofproto.ofproto_v1_4_parser), 330
OFPInstructionStatTrigger (class in OFPMeterStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 470 ryu.ofproto.ofproto_v1_5_parser), 417
OFPInstructionWriteMetadata (class in OFPMeterStatsRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 211 ryu.ofproto.ofproto_v1_3_parser), 249
OFPInstructionWriteMetadata (class in OFPMeterStatsRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 275 ryu.ofproto.ofproto_v1_4_parser), 329
OFPInstructionWriteMetadata (class in OFPMeterStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 374 ryu.ofproto.ofproto_v1_5_parser), 417

Index 599
ryu Documentation, Release 4.34

OFPPacketIn (class in OFPPortStatsReply (class in

ryu.ofproto.ofproto_v1_0_parser), 156 ryu.ofproto.ofproto_v1_0_parser), 152
OFPPacketIn (class in OFPPortStatsReply (class in
ryu.ofproto.ofproto_v1_2_parser), 199 ryu.ofproto.ofproto_v1_3_parser), 240
OFPPacketIn (class in OFPPortStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 263 ryu.ofproto.ofproto_v1_4_parser), 314
OFPPacketIn (class in OFPPortStatsReply (class in
ryu.ofproto.ofproto_v1_4_parser), 350 ryu.ofproto.ofproto_v1_5_parser), 402
OFPPacketIn (class in OFPPortStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 449 ryu.ofproto.ofproto_v1_0_parser), 152
OFPPacketOut (class in OFPPortStatsRequest (class in
ryu.ofproto.ofproto_v1_0_parser), 154 ryu.ofproto.ofproto_v1_2_parser), 185
OFPPacketOut (class in OFPPortStatsRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 195 ryu.ofproto.ofproto_v1_3_parser), 240
OFPPacketOut (class in OFPPortStatsRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 256 ryu.ofproto.ofproto_v1_4_parser), 314
OFPPacketOut (class in OFPPortStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 338 ryu.ofproto.ofproto_v1_5_parser), 402
OFPPacketOut (class in OFPPortStatus (class in
ryu.ofproto.ofproto_v1_5_parser), 435 ryu.ofproto.ofproto_v1_0_parser), 158
OFPPhyPort (class in OFPPortStatus (class in
ryu.ofproto.ofproto_v1_0_parser), 160 ryu.ofproto.ofproto_v1_2_parser), 203
OFPPort (class in ryu.ofproto.ofproto_v1_2_parser), OFPPortStatus (class in
207 ryu.ofproto.ofproto_v1_3_parser), 267
OFPPort (class in ryu.ofproto.ofproto_v1_3_parser), OFPPortStatus (class in
272 ryu.ofproto.ofproto_v1_4_parser), 360
OFPPort (class in ryu.ofproto.ofproto_v1_4_parser), OFPPortStatus (class in
370 ryu.ofproto.ofproto_v1_5_parser), 453
OFPPort (class in ryu.ofproto.ofproto_v1_5_parser), OFPQueueDescStatsReply (class in
465 ryu.ofproto.ofproto_v1_4_parser), 323
OFPPortDescStatsReply (class in OFPQueueDescStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 242 ryu.ofproto.ofproto_v1_5_parser), 410
OFPPortDescStatsReply (class in OFPQueueDescStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 317 ryu.ofproto.ofproto_v1_4_parser), 322
OFPPortDescStatsReply (class in OFPQueueDescStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 405 ryu.ofproto.ofproto_v1_5_parser), 410
OFPPortDescStatsRequest (class in OFPQueueGetConfigReply (class in
ryu.ofproto.ofproto_v1_3_parser), 242 ryu.ofproto.ofproto_v1_0_parser), 148
OFPPortDescStatsRequest (class in OFPQueueGetConfigReply (class in
ryu.ofproto.ofproto_v1_4_parser), 317 ryu.ofproto.ofproto_v1_2_parser), 194
OFPPortDescStatsRequest (class in OFPQueueGetConfigReply (class in
ryu.ofproto.ofproto_v1_5_parser), 404 ryu.ofproto.ofproto_v1_3_parser), 254
OFPPortMod (class in OFPQueueGetConfigRequest (class in
ryu.ofproto.ofproto_v1_0_parser), 146 ryu.ofproto.ofproto_v1_0_parser), 148
OFPPortMod (class in OFPQueueGetConfigRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 174 ryu.ofproto.ofproto_v1_2_parser), 194
OFPPortMod (class in OFPQueueGetConfigRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 225 ryu.ofproto.ofproto_v1_3_parser), 254
OFPPortMod (class in OFPQueueStats (class in
ryu.ofproto.ofproto_v1_4_parser), 296 ryu.ofproto.ofproto_v1_2_parser), 188
OFPPortMod (class in OFPQueueStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 391 ryu.ofproto.ofproto_v1_0_parser), 154
OFPPortStats (class in OFPQueueStatsReply (class in
ryu.ofproto.ofproto_v1_2_parser), 186 ryu.ofproto.ofproto_v1_3_parser), 244

600 Index
ryu Documentation, Release 4.34

OFPQueueStatsReply (class in OFPStats (class in ryu.ofproto.ofproto_v1_5_parser),

ryu.ofproto.ofproto_v1_4_parser), 320 468
OFPQueueStatsReply (class in OFPSwitchFeatures (class in
ryu.ofproto.ofproto_v1_5_parser), 408 ryu.ofproto.ofproto_v1_0_parser), 141
OFPQueueStatsRequest (class in OFPSwitchFeatures (class in
ryu.ofproto.ofproto_v1_0_parser), 153 ryu.ofproto.ofproto_v1_2_parser), 165
OFPQueueStatsRequest (class in OFPSwitchFeatures (class in
ryu.ofproto.ofproto_v1_2_parser), 187 ryu.ofproto.ofproto_v1_3_parser), 214
OFPQueueStatsRequest (class in OFPSwitchFeatures (class in
ryu.ofproto.ofproto_v1_3_parser), 243 ryu.ofproto.ofproto_v1_4_parser), 278
OFPQueueStatsRequest (class in OFPSwitchFeatures (class in
ryu.ofproto.ofproto_v1_4_parser), 320 ryu.ofproto.ofproto_v1_5_parser), 377
OFPQueueStatsRequest (class in OFPTableDescStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 407 ryu.ofproto.ofproto_v1_4_parser), 311
OFPRequestForward (class in OFPTableDescStatsReply (class in
ryu.ofproto.ofproto_v1_4_parser), 365 ryu.ofproto.ofproto_v1_5_parser), 424
OFPRequestForward (class in OFPTableDescStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 458 ryu.ofproto.ofproto_v1_4_parser), 311
OFPRoleReply (class in OFPTableDescStatsRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 198 ryu.ofproto.ofproto_v1_5_parser), 424
OFPRoleReply (class in OFPTableFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 259 ryu.ofproto.ofproto_v1_3_parser), 253
OFPRoleReply (class in OFPTableFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_4_parser), 340 ryu.ofproto.ofproto_v1_4_parser), 314
OFPRoleReply (class in OFPTableFeaturesStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 438 ryu.ofproto.ofproto_v1_5_parser), 427
OFPRoleRequest (class in OFPTableFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_2_parser), 197 ryu.ofproto.ofproto_v1_3_parser), 253
OFPRoleRequest (class in OFPTableFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_3_parser), 258 ryu.ofproto.ofproto_v1_4_parser), 313
OFPRoleRequest (class in OFPTableFeaturesStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 340 ryu.ofproto.ofproto_v1_5_parser), 426
OFPRoleRequest (class in OFPTableMod (class in
ryu.ofproto.ofproto_v1_5_parser), 437 ryu.ofproto.ofproto_v1_2_parser), 168
OFPRoleStatus (class in OFPTableMod (class in
ryu.ofproto.ofproto_v1_4_parser), 362 ryu.ofproto.ofproto_v1_3_parser), 216
OFPRoleStatus (class in OFPTableMod (class in
ryu.ofproto.ofproto_v1_5_parser), 455 ryu.ofproto.ofproto_v1_4_parser), 281
OFPSetAsync (class in OFPTableMod (class in
ryu.ofproto.ofproto_v1_3_parser), 260 ryu.ofproto.ofproto_v1_5_parser), 380
OFPSetAsync (class in OFPTableStats (class in
ryu.ofproto.ofproto_v1_4_parser), 344 ryu.ofproto.ofproto_v1_2_parser), 184
OFPSetAsync (class in OFPTableStatsReply (class in
ryu.ofproto.ofproto_v1_5_parser), 444 ryu.ofproto.ofproto_v1_0_parser), 151
OFPSetConfig (class in OFPTableStatsReply (class in
ryu.ofproto.ofproto_v1_0_parser), 142 ryu.ofproto.ofproto_v1_3_parser), 239
OFPSetConfig (class in OFPTableStatsReply (class in
ryu.ofproto.ofproto_v1_2_parser), 166 ryu.ofproto.ofproto_v1_4_parser), 310
OFPSetConfig (class in OFPTableStatsReply (class in
ryu.ofproto.ofproto_v1_3_parser), 215 ryu.ofproto.ofproto_v1_5_parser), 423
OFPSetConfig (class in OFPTableStatsRequest (class in
ryu.ofproto.ofproto_v1_4_parser), 279 ryu.ofproto.ofproto_v1_0_parser), 151
OFPSetConfig (class in OFPTableStatsRequest (class in
ryu.ofproto.ofproto_v1_5_parser), 378 ryu.ofproto.ofproto_v1_2_parser), 184

Index 601
ryu Documentation, Release 4.34

OFPTableStatsRequest (class in param_cookie_preserve (class in

ryu.ofproto.ofproto_v1_3_parser), 238 ryu.lib.packet.sctp), 95
OFPTableStatsRequest (class in param_ecn (class in ryu.lib.packet.sctp), 95
ryu.ofproto.ofproto_v1_4_parser), 310 param_heartbeat (class in ryu.lib.packet.sctp), 95
OFPTableStatsRequest (class in param_host_addr (class in ryu.lib.packet.sctp), 96
ryu.ofproto.ofproto_v1_5_parser), 423 param_ipv4 (class in ryu.lib.packet.sctp), 96
OFPTableStatus (class in param_ipv6 (class in ryu.lib.packet.sctp), 96
ryu.ofproto.ofproto_v1_4_parser), 363 param_state_cookie (class in ryu.lib.packet.sctp),
OFPTableStatus (class in 97
ryu.ofproto.ofproto_v1_5_parser), 457 param_supported_addr (class in
OFPUnparseableMsg (class in ryu.lib.packet.sctp), 97
ryu.lib.packet.openflow), 83 param_unrecognized_param (class in
OFPVendor (class in ryu.ofproto.ofproto_v1_0_parser), ryu.lib.packet.sctp), 97
160 parse() (ryu.lib.packet.stream_parser.StreamParser
OFPVendorStatsReply (class in method), 19
ryu.ofproto.ofproto_v1_0_parser), 154 parser() (ryu.lib.packet.arp.arp class method), 20
OFPVendorStatsRequest (class in parser() (ryu.lib.packet.bfd.bfd class method), 26
ryu.ofproto.ofproto_v1_0_parser), 154 parser() (ryu.lib.packet.bgp.BGPKeepAlive class
ofs_nbits() (in module ryu.ofproto.nicira_ext), 493 method), 28
openflow (class in ryu.lib.packet.openflow), 83 parser() (ryu.lib.packet.bgp.BGPMessage class
opt_header (class in ryu.lib.packet.ipv6), 76 method), 28
OptAttrError, 40 parser() (ryu.lib.packet.bgp.BGPNotification class
option (class in ryu.lib.packet.dhcp), 58 method), 29
option (class in ryu.lib.packet.dhcp6), 60 parser() (ryu.lib.packet.bgp.BGPOpen class method),
Option (class in ryu.lib.packet.geneve), 61 29
option (class in ryu.lib.packet.ipv6), 76 parser() (ryu.lib.packet.bgp.BGPRouteRefresh class
OptionDataUnknown (class in ryu.lib.packet.geneve), method), 30
61 parser() (ryu.lib.packet.bgp.BGPUpdate class
options (class in ryu.lib.packet.dhcp), 58 method), 31
options (class in ryu.lib.packet.dhcp6), 60 parser() (ryu.lib.packet.bmp.BMPInitiation class
organization_specific_tlv (class in method), 42
ryu.lib.packet.cfm), 55 parser() (ryu.lib.packet.bmp.BMPMessage class
OrganizationallySpecific (class in method), 42
ryu.lib.packet.lldp), 80 parser() (ryu.lib.packet.bmp.BMPPeerDownNotification
ospf (in module ryu.lib.packet.ospf ), 86 class method), 43
OSPFDBDesc (class in ryu.lib.packet.ospf ), 84 parser() (ryu.lib.packet.bmp.BMPPeerMessage class
OSPFHello (class in ryu.lib.packet.ospf ), 84 method), 43
OSPFLSAck (class in ryu.lib.packet.ospf ), 84 parser() (ryu.lib.packet.bmp.BMPPeerUpNotification
OSPFLSReq (class in ryu.lib.packet.ospf ), 85 class method), 44
OSPFLSUpd (class in ryu.lib.packet.ospf ), 85 parser() (ryu.lib.packet.bmp.BMPRouteMonitoring
OSPFMessage (class in ryu.lib.packet.ospf ), 85 class method), 45
OtherConfChange, 40 parser() (ryu.lib.packet.bmp.BMPStatisticsReport
out_filter_get() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
class method), 45
method), 126 parser() (ryu.lib.packet.bmp.BMPTermination class
out_filter_set() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
method), 46
method), 126 parser() (ryu.lib.packet.bpdu.bpdu class method), 51
OutOfResource, 40 parser() (ryu.lib.packet.bpdu.ConfigurationBPDUs
OVSBridge (class in ryu.lib.ovs.bridge), 135 class method), 49
OVSBridgeNotFound, 138 parser() (ryu.lib.packet.bpdu.RstBPDUs class
method), 50
P parser() (ryu.lib.packet.bpdu.TopologyChangeNotificationBPDUs
pack() (ryu.lib.packet.bfd.bfd method), 26 class method), 50
Packet (class in ryu.lib.packet.packet), 18 parser() (ryu.lib.packet.cfm.cfm class method), 52
PacketBase (class in ryu.lib.packet.packet_base), 19 parser() (ryu.lib.packet.dhcp.dhcp class method), 57

602 Index
ryu Documentation, Release 4.34

parser() (ryu.lib.packet.dhcp6.dhcp6 class method), PmsiTunnelIdUnknown (class in ryu.lib.packet.bgp),

59 40
parser() (ryu.lib.packet.ethernet.ethernet class port_status_tlv (class in ryu.lib.packet.cfm), 55
method), 61 PortDescription (class in ryu.lib.packet.lldp), 80
parser() (ryu.lib.packet.geneve.geneve class method), PortID (class in ryu.lib.packet.lldp), 81
62 prefix_add() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
parser() (ryu.lib.packet.gre.gre class method), 62 method), 126
parser() (ryu.lib.packet.icmp.icmp class method), 64 prefix_del() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
parser() (ryu.lib.packet.icmpv6.icmpv6 class method), method), 126
65 PrefixFilter (class in
parser() (ryu.lib.packet.igmp.igmp class method), 71 ryu.services.protocols.bgp.info_base.base),
parser() (ryu.lib.packet.igmp.igmpv3_query class 128
method), 71
parser() (ryu.lib.packet.igmp.igmpv3_report class R
method), 72 Reader (class in ryu.lib.mrtlib), 130
parser() (ryu.lib.packet.ipv4.ipv4 class method), 73 Reader (class in ryu.lib.pcaplib), 116
parser() (ryu.lib.packet.ipv6.ipv6 class method), 75 register_packet_type()
parser() (ryu.lib.packet.llc.llc class method), 79 (ryu.lib.packet.packet_base.PacketBase class
parser() (ryu.lib.packet.lldp.lldp class method), 81 method), 20
parser() (ryu.lib.packet.mpls.mpls class method), 82 RegisteredNexthop (class in ryu.lib.packet.zebra),
parser() (ryu.lib.packet.openflow.openflow class 109
method), 83 remove_db_attribute()
parser() (ryu.lib.packet.ospf.OSPFDBDesc class (ryu.lib.ovs.bridge.OVSBridge method), 138
method), 84 reply_egress_tlv (class in ryu.lib.packet.cfm), 55
parser() (ryu.lib.packet.ospf.OSPFHello class reply_ingress_tlv (class in ryu.lib.packet.cfm), 56
method), 84 reply_to_request()
parser() (ryu.lib.packet.ospf.OSPFLSAck class (ryu.base.app_manager.RyuApp method),
method), 85 496
parser() (ryu.lib.packet.ospf.OSPFLSReq class RestVtepController (class in ryu.app.rest_vtep),
method), 85 573
parser() (ryu.lib.packet.ospf.OSPFLSUpd class rib_get() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
method), 85 method), 126
parser() (ryu.lib.packet.ospf.OSPFMessage class RouteTargetMembershipNLRI (class in
method), 85 ryu.lib.packet.bgp), 41
parser() (ryu.lib.packet.packet_base.PacketBase class routing (class in ryu.lib.packet.ipv6), 76
method), 19 routing_type3 (class in ryu.lib.packet.ipv6), 76
parser() (ryu.lib.packet.pbb.itag class method), 86 RoutingLoop, 41
parser() (ryu.lib.packet.sctp.sctp class method), 98 RstBPDUs (class in ryu.lib.packet.bpdu), 49
parser() (ryu.lib.packet.slow.lacp class method), 102 run_command() (ryu.lib.ovs.bridge.OVSBridge
parser() (ryu.lib.packet.slow.slow class method), 102 method), 138
parser() (ryu.lib.packet.tcp.tcp class method), 103 run_command() (ryu.lib.ovs.vsctl.VSCtl method), 134
parser() (ryu.lib.packet.udp.udp class method), 104 ryu.app.cbench (module), 9
parser() (ryu.lib.packet.vrrp.vrrp class method), 106 ryu.app.ofctl.api (module), 515
parser() (ryu.lib.packet.vrrp.vrrpv2 class method), ryu.app.ofctl.exception (module), 516
107 ryu.app.rest_vtep (module), 569
parser() (ryu.lib.packet.vrrp.vrrpv3 class method), ryu.app.simple_switch (module), 9
107 ryu.base.app_manager (module), 7
parser() (ryu.lib.packet.vxlan.vxlan class method), ryu.controller.controller (module), 7
108 ryu.controller.dpset (module), 7
parser() (ryu.lib.packet.zebra.ZebraMessage class ryu.controller.ofp_event (module), 7
method), 113 ryu.controller.ofp_handler (module), 7
parser_hdr() (ryu.lib.packet.bfd.BFDAuth class ryu.lib.netconf (module), 9
method), 22 ryu.lib.of_config (module), 9
PeerDeConfig, 40 ryu.lib.ovs (module), 9

Index 603
ryu Documentation, Release 4.34

ryu.lib.ovs.bridge (module), 135 ryu.services.protocols.bgp.application

ryu.lib.ovs.vsctl (module), 134 (module), 580
ryu.lib.packet (module), 9 ryu.topology (module), 9
ryu.lib.packet.arp (module), 20 RyuApp (class in ryu.base.app_manager), 496
ryu.lib.packet.bfd (module), 21 RyuBGPSpeaker (class in
ryu.lib.packet.bgp (module), 26 ryu.services.protocols.bgp.application), 583
ryu.lib.packet.bmp (module), 41
ryu.lib.packet.bpdu (module), 46 S
ryu.lib.packet.cfm (module), 51 sctp (class in ryu.lib.packet.sctp), 97
ryu.lib.packet.dhcp (module), 57 SEND_ERROR (ryu.lib.packet.bgp.BgpExc attribute), 31
ryu.lib.packet.dhcp6 (module), 58 send_event() (ryu.base.app_manager.RyuApp
ryu.lib.packet.ethernet (module), 60 method), 496
ryu.lib.packet.geneve (module), 61 send_event_to_observers()
ryu.lib.packet.gre (module), 62 (ryu.base.app_manager.RyuApp method),
ryu.lib.packet.icmp (module), 63 496
ryu.lib.packet.icmpv6 (module), 65 send_msg() (in module ryu.app.ofctl.api), 516
ryu.lib.packet.igmp (module), 69 send_request() (ryu.base.app_manager.RyuApp
ryu.lib.packet.ipv4 (module), 73 method), 496
ryu.lib.packet.ipv6 (module), 74 sender_id_tlv (class in ryu.lib.packet.cfm), 56
ryu.lib.packet.llc (module), 77 serialize() (ryu.lib.packet.arp.arp method), 20
ryu.lib.packet.lldp (module), 79 serialize() (ryu.lib.packet.bfd.bfd method), 26
ryu.lib.packet.mpls (module), 82 serialize() (ryu.lib.packet.bfd.KeyedMD5 method),
ryu.lib.packet.openflow (module), 83 23
ryu.lib.packet.ospf (module), 84 serialize() (ryu.lib.packet.bfd.KeyedSHA1 method),
ryu.lib.packet.packet (module), 18 23
ryu.lib.packet.packet_base (module), 19 serialize() (ryu.lib.packet.bfd.SimplePassword
ryu.lib.packet.pbb (module), 86 method), 24
ryu.lib.packet.sctp (module), 87 serialize() (ryu.lib.packet.bgp.BGPMessage
ryu.lib.packet.slow (module), 98 method), 28
ryu.lib.packet.stream_parser (module), 19 serialize() (ryu.lib.packet.bmp.BMPMessage
ryu.lib.packet.tcp (module), 102 method), 42
ryu.lib.packet.udp (module), 103 serialize() (ryu.lib.packet.bpdu.bpdu method), 51
ryu.lib.packet.vlan (module), 104 serialize() (ryu.lib.packet.bpdu.ConfigurationBPDUs
ryu.lib.packet.vrrp (module), 105 method), 49
ryu.lib.packet.vxlan (module), 108 serialize() (ryu.lib.packet.bpdu.RstBPDUs
ryu.lib.packet.zebra (module), 109 method), 50
ryu.lib.xflow (module), 10 serialize() (ryu.lib.packet.cfm.cfm method), 52
ryu.ofproto.nicira_ext (module), 494 serialize() (ryu.lib.packet.dhcp.dhcp method), 58
ryu.ofproto.ofproto_v1_0 (module), 8 serialize() (ryu.lib.packet.dhcp6.dhcp6 method), 60
ryu.ofproto.ofproto_v1_0_parser (module), serialize() (ryu.lib.packet.ethernet.ethernet
8 method), 61
ryu.ofproto.ofproto_v1_2 (module), 8 serialize() (ryu.lib.packet.geneve.geneve method),
ryu.ofproto.ofproto_v1_2_parser (module), 62
8 serialize() (ryu.lib.packet.gre.gre method), 63
ryu.ofproto.ofproto_v1_3 (module), 8 serialize() (ryu.lib.packet.icmp.icmp method), 64
ryu.ofproto.ofproto_v1_3_parser (module), serialize() (ryu.lib.packet.icmpv6.icmpv6 method),
8 65
ryu.ofproto.ofproto_v1_4 (module), 9 serialize() (ryu.lib.packet.igmp.igmp method), 71
ryu.ofproto.ofproto_v1_4_parser (module), serialize() (ryu.lib.packet.igmp.igmpv3_query
9 method), 72
ryu.ofproto.ofproto_v1_5 (module), 9 serialize() (ryu.lib.packet.igmp.igmpv3_report
ryu.ofproto.ofproto_v1_5_parser (module), method), 72
9 serialize() (ryu.lib.packet.ipv4.ipv4 method), 74
serialize() (ryu.lib.packet.ipv6.ipv6 method), 76

604 Index
ryu Documentation, Release 4.34

serialize() (ryu.lib.packet.llc.llc method), 79 try_parse() (ryu.lib.packet.bgp.StreamParser

serialize() (ryu.lib.packet.lldp.lldp method), 82 method), 41
serialize() (ryu.lib.packet.mpls.mpls method), 83 try_parse() (ryu.lib.packet.stream_parser.StreamParser
serialize() (ryu.lib.packet.openflow.openflow method), 19
method), 84 TTL (class in ryu.lib.packet.lldp), 81
serialize() (ryu.lib.packet.ospf.OSPFMessage
method), 86 U
serialize() (ryu.lib.packet.packet.Packet method), udp (class in ryu.lib.packet.udp), 103
18 UnacceptableHoldTime, 41
serialize() (ryu.lib.packet.packet_base.PacketBase UnexpectedMultiReply, 516
method), 20 UnRegWellKnowAttr, 41
serialize() (ryu.lib.packet.pbb.itag method), 86 UnsupportedOptParam, 41
serialize() (ryu.lib.packet.sctp.sctp method), 98 UnsupportedVersion, 41
serialize() (ryu.lib.packet.slow.lacp method), 102
serialize() (ryu.lib.packet.tcp.tcp method), 103 V
serialize() (ryu.lib.packet.udp.udp method), 104 valid_ovsdb_addr() (in module ryu.lib.ovs.vsctl),
serialize() (ryu.lib.packet.vrrp.vrrp method), 107 135
serialize() (ryu.lib.packet.vxlan.vxlan method), 108 validate_rpc_host() (in module
serialize() (ryu.lib.packet.zebra.ZebraMessage ryu.services.protocols.bgp.application), 583
method), 114 vlan (class in ryu.lib.packet.vlan), 104
serialize_hdr() (ryu.lib.packet.bfd.BFDAuth vni_from_bin() (in module ryu.lib.packet.vxlan),
method), 22 108
set_controller() (ryu.lib.ovs.bridge.OVSBridge vni_to_bin() (in module ryu.lib.packet.vxlan), 108
method), 138 vrf_add() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
set_db_attribute() method), 127
(ryu.lib.ovs.bridge.OVSBridge method), 138 vrf_del() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
set_ev_cls() (in module ryu.controller.handler), 12 method), 127
set_qos() (ryu.lib.ovs.bridge.OVSBridge method), vrfs_get() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
138 method), 127
shutdown() (ryu.services.protocols.bgp.bgpspeaker.BGPSpeaker
vrrp (class in ryu.lib.packet.vrrp), 106
method), 127 vrrpv2 (class in ryu.lib.packet.vrrp), 107
SimplePassword (class in ryu.lib.packet.bfd), 24 vrrpv3 (class in ryu.lib.packet.vrrp), 107
slow (class in ryu.lib.packet.slow), 102 VSCtl (class in ryu.lib.ovs.vsctl), 134
start() (ryu.base.app_manager.RyuApp method), 497 VSCtlCommand (class in ryu.lib.ovs.vsctl), 134
start() (ryu.services.protocols.bgp.application.RyuBGPSpeaker
vxlan (class in ryu.lib.packet.vxlan), 108
method), 583
StreamParser (class in ryu.lib.packet.bgp), 41 W
StreamParser (class in ryu.lib.packet.stream_parser),
Writer (class in ryu.lib.mrtlib), 131
19
Writer (class in ryu.lib.pcaplib), 116
StreamParser.TooSmallException, 19
SUB_CODE (ryu.lib.packet.bgp.BgpExc attribute), 31 Z
svlan (class in ryu.lib.packet.vlan), 104
SystemCapabilities (class in ryu.lib.packet.lldp), zebra (in module ryu.lib.packet.zebra), 115
81 ZebraBfdClientRegister (class in
SystemDescription (class in ryu.lib.packet.lldp), 81 ryu.lib.packet.zebra), 109
SystemName (class in ryu.lib.packet.lldp), 81 ZebraBfdDestinationDeregister (class in
ryu.lib.packet.zebra), 109
T ZebraBfdDestinationRegister (class in
ryu.lib.packet.zebra), 109
tcp (class in ryu.lib.packet.tcp), 102
ZebraBfdDestinationReply (class in
TimeExceeded (class in ryu.lib.packet.icmp), 63
ryu.lib.packet.zebra), 110
to_jsondict() (ryu.ofproto.ofproto_parser.MsgBase
ZebraBfdDestinationUpdate (class in
method), 139
ryu.lib.packet.zebra), 110
TopologyChangeNotificationBPDUs (class in
ZebraHello (class in ryu.lib.packet.zebra), 110
ryu.lib.packet.bpdu), 50

Index 605
ryu Documentation, Release 4.34

ZebraImportCheckUpdate (class in ZebraIPv6NexthopLookup (class in

ryu.lib.packet.zebra), 111 ryu.lib.packet.zebra), 111
ZebraImportRouteRegister (class in ZebraIPv6RouteAdd (class in ryu.lib.packet.zebra),
ryu.lib.packet.zebra), 112 111
ZebraImportRouteUnregister (class in ZebraIPv6RouteDelete (class in
ryu.lib.packet.zebra), 112 ryu.lib.packet.zebra), 111
ZebraInterfaceAdd (class in ryu.lib.packet.zebra), ZebraMessage (class in ryu.lib.packet.zebra), 113
112 ZebraMplsLabelsAdd (class in ryu.lib.packet.zebra),
ZebraInterfaceAddressAdd (class in 114
ryu.lib.packet.zebra), 112 ZebraMplsLabelsDelete (class in
ZebraInterfaceAddressDelete (class in ryu.lib.packet.zebra), 114
ryu.lib.packet.zebra), 112 ZebraNexthopRegister (class in
ZebraInterfaceBfdDestinationUpdate (class ryu.lib.packet.zebra), 114
in ryu.lib.packet.zebra), 112 ZebraNexthopUnregister (class in
ZebraInterfaceDelete (class in ryu.lib.packet.zebra), 114
ryu.lib.packet.zebra), 112 ZebraNexthopUpdate (class in ryu.lib.packet.zebra),
ZebraInterfaceDisableRadv (class in 114
ryu.lib.packet.zebra), 112 ZebraRedistributeAdd (class in
ZebraInterfaceDown (class in ryu.lib.packet.zebra), ryu.lib.packet.zebra), 114
112 ZebraRedistributeDefaultAdd (class in
ZebraInterfaceEnableRadv (class in ryu.lib.packet.zebra), 114
ryu.lib.packet.zebra), 112 ZebraRedistributeDefaultDelete (class in
ZebraInterfaceLinkParams (class in ryu.lib.packet.zebra), 114
ryu.lib.packet.zebra), 112 ZebraRedistributeDelete (class in
ZebraInterfaceNbrAddressAdd (class in ryu.lib.packet.zebra), 114
ryu.lib.packet.zebra), 112 ZebraRedistributeIPv4Add (class in
ZebraInterfaceNbrAddressDelete (class in ryu.lib.packet.zebra), 114
ryu.lib.packet.zebra), 113 ZebraRedistributeIPv4Delete (class in
ZebraInterfaceUp (class in ryu.lib.packet.zebra), ryu.lib.packet.zebra), 114
113 ZebraRedistributeIPv6Add (class in
ZebraInterfaceVrfUpdate (class in ryu.lib.packet.zebra), 115
ryu.lib.packet.zebra), 113 ZebraRedistributeIPv6Delete (class in
ZebraIPv4ImportLookup (class in ryu.lib.packet.zebra), 115
ryu.lib.packet.zebra), 110 ZebraRouterIDAdd (class in ryu.lib.packet.zebra),
ZebraIPv4NexthopAdd (class in 115
ryu.lib.packet.zebra), 110 ZebraRouterIDDelete (class in
ZebraIPv4NexthopDelete (class in ryu.lib.packet.zebra), 115
ryu.lib.packet.zebra), 110 ZebraRouterIDUpdate (class in
ZebraIPv4NexthopLookup (class in ryu.lib.packet.zebra), 115
ryu.lib.packet.zebra), 110 ZebraUnknownMessage (class in
ZebraIPv4NexthopLookupMRib (class in ryu.lib.packet.zebra), 115
ryu.lib.packet.zebra), 110 ZebraVrfAdd (class in ryu.lib.packet.zebra), 115
ZebraIPv4RouteAdd (class in ryu.lib.packet.zebra), ZebraVrfDelete (class in ryu.lib.packet.zebra), 115
110 ZebraVrfUnregister (class in ryu.lib.packet.zebra),
ZebraIPv4RouteDelete (class in 115
ryu.lib.packet.zebra), 110
ZebraIPv4RouteIPv6NexthopAdd (class in
ryu.lib.packet.zebra), 111
ZebraIPv6ImportLookup (class in
ryu.lib.packet.zebra), 111
ZebraIPv6NexthopAdd (class in
ryu.lib.packet.zebra), 111
ZebraIPv6NexthopDelete (class in
ryu.lib.packet.zebra), 111

606 Index

Ryu
No ratings yet
Ryu
473 pages
Ryu
No ratings yet
Ryu
151 pages
Ryu Controller
No ratings yet
Ryu Controller
21 pages
Ryu Book
No ratings yet
Ryu Book
190 pages
Ryu Book
No ratings yet
Ryu Book
149 pages
SDN Framework: Using Openflow 1.3
No ratings yet
SDN Framework: Using Openflow 1.3
183 pages
SDN Book PDF
No ratings yet
SDN Book PDF
183 pages
SDN Book
No ratings yet
SDN Book
183 pages
RYU Controller Tutorial
No ratings yet
RYU Controller Tutorial
3 pages
SDN Final
No ratings yet
SDN Final
18 pages
SDN Lab Manual
No ratings yet
SDN Lab Manual
12 pages
Frenetic Programmers Guide PDF
No ratings yet
Frenetic Programmers Guide PDF
150 pages
Frenetic Programmer's Guide
No ratings yet
Frenetic Programmer's Guide
150 pages
Docs Frrouting Org Dev Guide en Latest
No ratings yet
Docs Frrouting Org Dev Guide en Latest
206 pages
CCIE/CCDE Written Exam Evolving Technologies Study Guide
No ratings yet
CCIE/CCDE Written Exam Evolving Technologies Study Guide
180 pages
Frrouting Developers Guide
No ratings yet
Frrouting Developers Guide
315 pages
SDN Lab Manual
No ratings yet
SDN Lab Manual
11 pages
No - Ntnu Inspera 78072783 20696476
No ratings yet
No - Ntnu Inspera 78072783 20696476
90 pages
Reticulum Manual
No ratings yet
Reticulum Manual
165 pages
Reticulum Manual
No ratings yet
Reticulum Manual
187 pages
Frrouting Developers Guide
No ratings yet
Frrouting Developers Guide
321 pages
RDMA Aware Programming User Manual
No ratings yet
RDMA Aware Programming User Manual
247 pages
RDMA User Manual
No ratings yet
RDMA User Manual
216 pages
XORP User Manual
No ratings yet
XORP User Manual
193 pages
Reticulum Network Stack Guide
No ratings yet
Reticulum Network Stack Guide
163 pages
CCIE CCDE Written Exam Evolving Technologies Study Guide
100% (1)
CCIE CCDE Written Exam Evolving Technologies Study Guide
179 pages
SDN Lab Manual
No ratings yet
SDN Lab Manual
21 pages
Cgrates Readthedocs Io en v0.10
No ratings yet
Cgrates Readthedocs Io en v0.10
116 pages
Core Manual
No ratings yet
Core Manual
58 pages
Suricata Readthedocs Io en Suricata 4.0.4
No ratings yet
Suricata Readthedocs Io en Suricata 4.0.4
266 pages
Cisco DevNet Evolving Technologies
No ratings yet
Cisco DevNet Evolving Technologies
196 pages
SDN Lab Manual PDF
No ratings yet
SDN Lab Manual PDF
9 pages
Ros2 Tutorial Readthedocs Io en Latest
No ratings yet
Ros2 Tutorial Readthedocs Io en Latest
179 pages
Suricata User Guide: Release 4.1.0-Dev
No ratings yet
Suricata User Guide: Release 4.1.0-Dev
272 pages
Channelized Stm1 Interfaces
No ratings yet
Channelized Stm1 Interfaces
128 pages
DEVNET (Etech) - N. RUSSO (2021)
No ratings yet
DEVNET (Etech) - N. RUSSO (2021)
259 pages
Docs Suricata Io en Suricata 4.1.0 Rc2
No ratings yet
Docs Suricata Io en Suricata 4.1.0 Rc2
296 pages
Suricata
No ratings yet
Suricata
358 pages
Framework For Body Sensor Networks: Sameer Iyengar
No ratings yet
Framework For Body Sensor Networks: Sameer Iyengar
53 pages
Patroni
No ratings yet
Patroni
199 pages
Morgan Manual
No ratings yet
Morgan Manual
34 pages
Zephyr
No ratings yet
Zephyr
3,208 pages
Oxford Dic
No ratings yet
Oxford Dic
95 pages
Suricata Readthedocs Io en Suricata 5.0.3 PDF
No ratings yet
Suricata Readthedocs Io en Suricata 5.0.3 PDF
358 pages
Core Manual
100% (1)
Core Manual
68 pages
OMNet 4.0 Manual
No ratings yet
OMNet 4.0 Manual
361 pages
12 Factor Applications With Docker and Go (Tit Petric) (Z-Library)
100% (2)
12 Factor Applications With Docker and Go (Tit Petric) (Z-Library)
148 pages
SDN Lab Manual
No ratings yet
SDN Lab Manual
14 pages
API Foundations in Go
No ratings yet
API Foundations in Go
92 pages
Suricata
No ratings yet
Suricata
328 pages
Chalice
No ratings yet
Chalice
134 pages
Suricata User Guide: Release 4.1.0-Dev
No ratings yet
Suricata User Guide: Release 4.1.0-Dev
260 pages
Master Thesis
No ratings yet
Master Thesis
70 pages
SDN Lab Mannual Org v1
No ratings yet
SDN Lab Mannual Org v1
16 pages
A Gentle Introduction To ROS
No ratings yet
A Gentle Introduction To ROS
166 pages
Book ROS
No ratings yet
Book ROS
166 pages
GTNetS Manual
No ratings yet
GTNetS Manual
148 pages
Cumulus Linux Network Reference Design Guide
No ratings yet
Cumulus Linux Network Reference Design Guide
43 pages
Install C8000v
No ratings yet
Install C8000v
5 pages
Huawei SD-WAN Solution Technical Presentation
No ratings yet
Huawei SD-WAN Solution Technical Presentation
44 pages
CVD CampusWiredLANConfigurationFilesGuide AUG14
No ratings yet
CVD CampusWiredLANConfigurationFilesGuide AUG14
232 pages
FHS2 Series Laser Source
No ratings yet
FHS2 Series Laser Source
2 pages
Omniswitch 6360 Datasheet en
No ratings yet
Omniswitch 6360 Datasheet en
9 pages
Cisco Router Configuration Logs
No ratings yet
Cisco Router Configuration Logs
10 pages
Cracking WEP, WPA, WPA2 Networks
No ratings yet
Cracking WEP, WPA, WPA2 Networks
17 pages
Modicon M340 - BMXP342020
No ratings yet
Modicon M340 - BMXP342020
4 pages
Sockets and Ports Assignment
No ratings yet
Sockets and Ports Assignment
2 pages
EXOS Command Reference Guide 15 3
No ratings yet
EXOS Command Reference Guide 15 3
3,147 pages
Finger Print Training
No ratings yet
Finger Print Training
21 pages
Xid-2025857 1
No ratings yet
Xid-2025857 1
6 pages
GPON OLT Solution for Enterprises
No ratings yet
GPON OLT Solution for Enterprises
3 pages
Vlan Check
No ratings yet
Vlan Check
4 pages
SS7 ISUP Guide for Telecom Engineers
100% (1)
SS7 ISUP Guide for Telecom Engineers
28 pages
GPRS Tunnelling Protocol
No ratings yet
GPRS Tunnelling Protocol
9 pages
III B.Tech I Semester L T P C 3 1 0 3 16CSE313 Computer Networks
No ratings yet
III B.Tech I Semester L T P C 3 1 0 3 16CSE313 Computer Networks
2 pages
Mtcre PDF
No ratings yet
Mtcre PDF
7 pages
OSPF Protocol Overview & Key Concepts
No ratings yet
OSPF Protocol Overview & Key Concepts
5 pages
Nokia 7210 Service Access Switch: Benefits
No ratings yet
Nokia 7210 Service Access Switch: Benefits
9 pages
Ds-3E0518P-E/M 16-Port Gigabit Unmanaged Poe Switch: Feature and Function
No ratings yet
Ds-3E0518P-E/M 16-Port Gigabit Unmanaged Poe Switch: Feature and Function
5 pages
LicenseResourceInfo 20200706 142554
No ratings yet
LicenseResourceInfo 20200706 142554
8 pages
CTHDCN-2302-Troubleshooting Slow Traffic Flows On Nexus9k
No ratings yet
CTHDCN-2302-Troubleshooting Slow Traffic Flows On Nexus9k
23 pages
Hikvision Ds2cd7153e 28mm 2mp Network Mini Dome Camera
No ratings yet
Hikvision Ds2cd7153e 28mm 2mp Network Mini Dome Camera
1 page
Subnetting Router
100% (1)
Subnetting Router
13 pages
3GPP TS 32215-590
No ratings yet
3GPP TS 32215-590
67 pages
8.1.4.7 Packet Tracer - Subnetting Scenario 1
33% (6)
8.1.4.7 Packet Tracer - Subnetting Scenario 1
5 pages
Slides For Chapter 3: Networking and Internetworking: Distributed Systems: Concepts and Design
No ratings yet
Slides For Chapter 3: Networking and Internetworking: Distributed Systems: Concepts and Design
27 pages
GPRS and UMTS PS Network Planning
No ratings yet
GPRS and UMTS PS Network Planning
143 pages
Network Configuration and Troubleshooting Commands
No ratings yet
Network Configuration and Troubleshooting Commands
44 pages
OEO100040 LTE Scheduling Feature and Parameters ISSUE100pdf
No ratings yet
OEO100040 LTE Scheduling Feature and Parameters ISSUE100pdf
40 pages
XC220-G3v 2.0 Datasheet
No ratings yet
XC220-G3v 2.0 Datasheet
8 pages
Ubuntu Static IP Setup Guide
No ratings yet
Ubuntu Static IP Setup Guide
6 pages
Cisco ASA Firewall Configuration
No ratings yet
Cisco ASA Firewall Configuration
18 pages