From 673c811f85f57214b8be0cf69d6252ccc404bc11 Mon Sep 17 00:00:00 2001 From: Yoshihiro Kaneko Date: Mon, 2 Sep 2013 19:21:20 +0900 Subject: doc: update reference page for ofproto. Signed-off-by: Yoshihiro Kaneko Signed-off-by: FUJITA Tomonori --- doc/source/conf.py | 2 +- doc/source/ofproto_ref.rst | 471 ++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 468 insertions(+), 5 deletions(-) (limited to 'doc/source') diff --git a/doc/source/conf.py b/doc/source/conf.py index dcc95945..b953ea8d 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -27,7 +27,7 @@ from ryu import version as ryu_version # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. -extensions = [ 'sphinx.ext.autodoc' ] +extensions = [ 'sphinx.ext.autodoc', 'sphinx.ext.autosummary' ] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] diff --git a/doc/source/ofproto_ref.rst b/doc/source/ofproto_ref.rst index 17a19c97..7740749c 100644 --- a/doc/source/ofproto_ref.rst +++ b/doc/source/ofproto_ref.rst @@ -2,8 +2,471 @@ OpenFlow protocol API Reference ******************************* -.. toctree:: - :maxdepth: 2 +| :ref:`OpenFlow v1.2 Messages and Structures ` +| :ref:`OpenFlow v1.3 Messages and Structures ` + +.. _OpenFlow-v1.2: + +OpenFlow v1.2 Messages and Structures +===================================== +.. py:currentmodule:: ryu.ofproto.ofproto_v1_2_parser + +Controller-to-Switch Messages +----------------------------- + +Handshake +^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPFeaturesRequest + OFPSwitchFeatures + +Switch Configuration +^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPSetConfig + OFPGetConfigRequest + OFPGetConfigReply + +Flow Table Configuration +^^^^^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPTableMod + +Modify State Messages +^^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPFlowMod + OFPGroupMod + OFPPortMod + +Read State Messages +^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPDescStatsRequest + OFPDescStats + OFPFlowStatsRequest + OFPFlowStats + OFPAggregateStatsRequest + OFPAggregateStatsReply + OFPTableStatsRequest + OFPTableStats + OFPPortStatsRequest + OFPPortStats + OFPQueueStatsRequest + OFPQueueStats + OFPGroupStatsRequest + OFPGroupStats + OFPGroupDescStatsRequest + OFPGroupDescStats + OFPGroupFeaturesStatsRequest + OFPGroupFeaturesStats + +Queue Configuration Messages +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPQueueGetConfigRequest + OFPQueueGetConfigReply + +Packet-Out Message +^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPPacketOut + +Barrier Message +^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPBarrierRequest + OFPBarrierReply + +Role Request Message +^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPRoleRequest + OFPRoleReply + + +Asynchronous Messages +--------------------- + +Packet-In Message +^^^^^^^^^^^^^^^^^ + +.. autosummary:: + + OFPPacketIn + +Flow Removed Message +^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + + OFPFlowRemoved + +Port Status Message +^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPPortStatus + +Error Message +^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPErrorMsg + + +Symmetric Messages +------------------ + +Hello +^^^^^ + +.. autosummary:: + :nosignatures: + + OFPHello + +Echo Request +^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPEchoRequest + +Echo Reply +^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPEchoReply + +Experimenter +^^^^^^^^^^^^ +.. autosummary:: + :nosignatures: + + OFPExperimenter + + +Flow Match Structure +-------------------- + +.. autosummary:: + :nosignatures: + + OFPMatch + + +Flow Instruction Structures +--------------------------- + +.. autosummary:: + :nosignatures: + + OFPInstructionGotoTable + OFPInstructionWriteMetadata + OFPInstructionActions + + +Action Structures +----------------- + +.. autosummary:: + :nosignatures: + + OFPActionOutput + OFPActionGroup + OFPActionSetQueue + OFPActionSetMplsTtl + OFPActionDecMplsTtl + OFPActionSetNwTtl + OFPActionDecNwTtl + OFPActionCopyTtlOut + OFPActionCopyTtlIn + OFPActionPushVlan + OFPActionPushMpls + OFPActionPopVlan + OFPActionPopMpls + OFPActionSetField + OFPActionExperimenter + + +.. _OpenFlow-v1.3: + +OpenFlow v1.3 Messages and Structures +===================================== +.. py:currentmodule:: ryu.ofproto.ofproto_v1_3_parser + +Controller-to-Switch Messages +----------------------------- + +Handshake +^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPFeaturesRequest + OFPSwitchFeatures + +Switch Configuration +^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPSetConfig + OFPGetConfigRequest + OFPGetConfigReply + +Flow Table Configuration +^^^^^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPTableMod + +Modify State Messages +^^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPFlowMod + OFPGroupMod + OFPPortMod + OFPMeterMod + +Multipart Messages +^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPDescStatsRequest + OFPDescStatsReply + OFPFlowStatsRequest + OFPFlowStatsReply + OFPAggregateStatsRequest + OFPAggregateStatsReply + OFPTableStatsRequest + OFPTableStatsReply + OFPPortStatsRequest + OFPPortStatsReply + OFPPortDescStatsRequest + OFPPortDescStatsReply + OFPQueueStatsRequest + OFPQueueStatsReply + OFPGroupStatsRequest + OFPGroupStatsReply + OFPGroupDescStatsRequest + OFPGroupDescStatsReply + OFPGroupFeaturesStatsRequest + OFPGroupFeaturesStatsReply + OFPMeterStatsRequest + OFPMeterStatsReply + OFPMeterConfigStatsRequest + OFPMeterConfigStatsReply + OFPMeterFeaturesStatsRequest + OFPMeterFeaturesStatsReply + +Queue Configuration Messages +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPQueueGetConfigRequest + OFPQueueGetConfigReply + +Packet-Out Message +^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPPacketOut + +Barrier Message +^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPBarrierRequest + OFPBarrierReply + +Role Request Message +^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPRoleRequest + OFPRoleReply + +Set Asynchronous Configuration Message +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPSetAsync + OFPGetAsyncRequest + OFPGetAsyncReply + + +Asynchronous Messages +--------------------- + +.. autosummary:: + :nosignatures: + + +Packet-In Message +^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPPacketIn + +Flow Removed Message +^^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPFlowRemoved + +Port Status Message +^^^^^^^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPPortStatus + +Error Message +^^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPErrorMsg + + +Symmetric Messages +------------------ + +Hello +^^^^^ + +.. autosummary:: + :nosignatures: + + OFPHello + OFPHelloElemVersionBitmap + +Echo Request +^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPEchoRequest + +Echo Reply +^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPEchoReply + +Experimenter +^^^^^^^^^^^^ + +.. autosummary:: + :nosignatures: + + OFPExperimenter + + +Flow Match Structure +-------------------- + +.. autosummary:: + :nosignatures: + + OFPMatch + + +Flow Instruction Structures +--------------------------- + +.. autosummary:: + :nosignatures: + + OFPInstructionGotoTable + OFPInstructionWriteMetadata + OFPInstructionActions + OFPInstructionMeter + + +Action Structures +----------------- + +.. autosummary:: + :nosignatures: + + OFPActionOutput + OFPActionGroup + OFPActionSetQueue + OFPActionSetMplsTtl + OFPActionDecMplsTtl + OFPActionSetNwTtl + OFPActionDecNwTtl + OFPActionCopyTtlOut + OFPActionCopyTtlIn + OFPActionPushVlan + OFPActionPushMpls + OFPActionPopVlan + OFPActionPopMpls + OFPActionSetField + OFPActionExperimenter - ofproto_v1_2_ref.rst - ofproto_v1_3_ref.rst -- cgit v1.2.3