tree: ddbf780c778d01f08b4d26eb852662649f62db7e [path history] [tgz]
  1. .abat-automerge
  2. .gitignore
  3. .hooks/
  4. AUTHORS
  5. INTERNALS
  6. LoxiGen.mk
  7. Makefile
  8. README.md
  9. TODO
  10. c_gen/
  11. generic_utils.py
  12. java_gen/
  13. lang_c.py
  14. lang_java.py
  15. lang_python.py
  16. lang_wireshark.py
  17. loxi_front_end/
  18. loxi_ir.py
  19. loxi_utils/
  20. loxigen.py
  21. of_g.py
  22. openflow_input/
  23. py_gen/
  24. pyparsing.py
  25. tenjin.py
  26. test_data/
  27. utest/
  28. 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 and Python, with Java on the way).

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 and python.

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.