Gitiles
Code Review Sign In
gerrit.onosproject.org / onos-loxi / 538d51fa08b24c9cba96bf12306e9f75fa41ba78
commit538d51fa08b24c9cba96bf12306e9f75fa41ba78[log] [tgz]
authorPatryk Konopka <p.konopka2@samsung.com>Wed Mar 01 10:14:52 2017 +0100
committerYuta HIGUCHI <y-higuchi@opennetworking.org>Tue Jun 20 15:45:08 2017 +0000
tree13f76e32f658e931a7eb026da74d87764e8e3f8d
parent9816afaf4716c89be4fa5a3e85155d4b7a1644ea [diff]
[ONOS-6064] Support for IPv6 tunnel (currently supported in Open vSwitch 2.6.0)

Change-Id: Iff47f110ee25b4a65830c939bbd540350e07575d
3 files changed
tree: 13f76e32f658e931a7eb026da74d87764e8e3f8d
  1. .abat-automerge
  2. .build/
  3. .gitignore
  4. .gitreview
  5. .hooks/
  6. AUTHORS
  7. INTERNALS
  8. LoxiGen.mk
  9. Makefile
  10. README.md
  11. TODO
  12. c_gen/
  13. cmdline.py
  14. docker.sh
  15. docker/
  16. generic_utils.py
  17. java_gen/
  18. lang_c.py
  19. lang_java.py
  20. lang_python.py
  21. lang_wireshark.py
  22. loxi_front_end/
  23. loxi_globals.py
  24. loxi_ir/
  25. loxi_utils/
  26. loxigen.py
  27. openflow_input/
  28. py_gen/
  29. pyparsing.py
  30. setup.cfg
  31. template_utils.py
  32. tenjin.py
  33. test_data/
  34. utest/
  35. wireshark_gen/
README.md

Introduction

LoxiGen is a tool that generates OpenFlow protocol libraries for a number of languages. It is composed of a frontend that parses wire protocol descriptions and a backend for each supported language (currently C, Python, and Java, with an auto-generated wireshark dissector in Lua on the way).

LoxiGen currently supports OpenFlow Versions 1.0, 1.1, 1.2, and 1.3.1, 1.4.1, and 1.5.1. Versions 1.0, 1.3.1 and 1.4.1 are actively used in production. Support for versions 1.1 and 1.2 is considered experimental. Support for 1.5.1 is currently experimental and limited to the Java backend.

Loxigen is free and open source software. The Loxigen tool itself is licensed under the Eclipse Public License, version 1.0 (EPL), with an exception allowing for the distribution of the generated artifacts under terms of your choice (copyright notices must be retained, see the loxigen.py header for details.)

Prerequisites

Running the unit tests requires nosetests. You can install it via easy_install,

easy_install nose

pip,

pip install nose

or via your distribution's package manager (example for Debian/Ubuntu):

sudo apt-get install python-nose

Nosetests is only required for running the unit tests, not for running LoxiGen itself. We do ask you to install it and use it before submitting pull requests, though.

Running the Java unit tests requires Maven 3: sudo apt-get install maven.

Usage

You can run LoxiGen directly from the repository. There's no need to install it, and it has no dependencies beyond Python 2.7+.

To generate the libraries for all languages:

make

To generate the library for a single language:

make c

The currently supported languages are c, python and java. There is an experimental backend that generates a lua wireshark dissector (wireshark).

The generated libraries will be under the loxi_output directory. This can be changed with the LOXI_OUTPUT_DIR environment variable when using the Makefile.

Each generated library comes with its own set of documentation in the standard format for that language. Please see that documentation for more details on using the generated libraries.

Contributing

Please fork the repository on GitHub and send us a pull request. You might also be interested in the INTERNALS file which has notes about how LoxiGen works.

Loxigen comes with a set of internal unit-tests, as well as with a set of tests for the generated artifacts. Be sure to run

make check-all

and correct any problems before submitting a pull request.