/pox

The POX network software platform
  1. Python 97.7%
  2. C++ 1.5%
  3. Other 0.8%
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

@MurphyMc
MurphyMc arp_helper: Fix regression 
d8bbb33 made some improvements to arp_helper, but seems to have
been committed and forgotten about before the changes were actually
complete.  This finishes things off by removing vestiges of
use_port_mac and replacing them with the normalized source MAC
behaviors provided by send_arp_reply() and send_arp_request(),
doing a little refactoring and adding some docstring along the way.

Closes #202.  Thanks to @nemethf for the report.
Latest commit 412a6ad Nov 23, 2017
Permalink
Failed to load latest commit information.
ext Add skeleton component Jun 3, 2013
pox arp_helper: Fix regression Nov 23, 2017
tests lib.addresses: Finish OUI resolution Jul 18, 2014
tools tools: Put some more info in pox-log.py Aug 8, 2013
.gitignore gitignore: Ignore .class files (Jython) Nov 18, 2014
.pylint add a skeleton .pylint config Feb 4, 2012
LICENSE Remove appendix from LICENSE Mar 13, 2013
NOTICE Changes related to license switch Mar 13, 2013
README README: Slight clarification Aug 4, 2013
debug-pox.py Add debug-pox.py Jan 16, 2012
pox.py pox.py: Enable assertions Jul 24, 2013
setup.cfg reinstantiated logging.cfg (moved to tests/) Jun 6, 2012

README 

POX is a networking software platform written in Python

POX started life as an OpenFlow controller, but can now also function
as an OpenFlow switch, and can be useful for writing networking software
in general.

POX officially requires Python 2.7 (though much of it will work fine
fine with Python 2.6), and should run under Linux, Mac OS, and Windows.
(And just about anywhere else -- we've run it on Android phones,
under FreeBSD, Haiku, and elsewhere.  All you need is Python!)
You can place a pypy distribution alongside pox.py (in a directory
named "pypy"), and POX will run with pypy (this can be a significant
performance boost!).

POX currently communicates with OpenFlow 1.0 switches and includes
special support for the Open vSwitch/Nicira extensions.

pox.py boots up POX. It takes a list of module names on the command line,
locates the modules, calls their launch() function (if it exists), and
then transitions to the "up" state.

Modules are looked for everywhere that Python normally looks, plus the
"pox" and "ext" directories.  Thus, you can do the following:

  ./pox.py forwarding.l2_learning

You can pass options to the modules by specifying options after the module
name.  These are passed to the module's launch() funcion.  For example,
to set the address or port of the controller, invoke as follows:

  ./pox.py openflow.of_01 --address=10.1.1.1 --port=6634

pox.py also supports a few command line options of its own which should
be given first:
 --verbose      print stack traces for initialization exceptions
 --no-openflow  don't start the openflow module automatically