Some major restructuring
Updated README with some warnings.
Added data-plane-only class to allow controlling the dataplane
ports without needing a controller connection.
Subclassed this to allow sending only a packet without doing
any flow mods; both tagged or untagged.
Added the ability to pass a parameter to a test through th
config structure. Use --param=N.
Used the above to set the VLAN id in a tagged pkt in the new test.
Break up description/name in --list when name is long
Restructured pktact.py into different routines, moving a lot of
the base functionality into testutils.py. This allows packet
modification tests to be done independently.
In the process, added support for using tagged and untagged
packets in the tests. Several tests remain to be implemented.
diff --git a/README b/README
index 596d91a..371bbd6 100644
--- a/README
+++ b/README
@@ -4,43 +4,6 @@
Copyright (c) 2010 The Board of Trustees of The Leland Stanford
Junior University
-
-
-=Warning=
-
-==Risks==
-This is still '''experimental''' and it requires root privilege to
-control the dataplane ports. As a consequence, there may be
-'''risks''' to the machine on which this is running.
-Use caution.
-
-==Recovering From Problems==
-
-If the test script, oft, becomes unresponsive, you may find that ^C does not
-break out of the script. In this case you have two options:
-
-* Use ^Z to interrupt the script and return to the shell prompt.
-* Start another terminal window to the same machine.
-
-In either case, you then need to kill the process that is hung. Use the
-following commands:
-
- me@host> ps aux | grep oft
- root 4 0.0 0.0 0 0 ? S< Jul07 0:00 [ksoftirqd/0]
- ...
- root 14066 3.2 0.6 149888 25344 pts/4 Tl 09:27 0:00 python ./oft ...
- me 14074 0.0 0.0 7452 876 pts/4 R+ 09:28 0:00 grep oft
-
- me@host> sudo kill -9 14066
-
-where 14066 is the process ID of the hung process. (Replace it with the PID for your process.)
-
-==Preliminary Work==
-
-This is still preliminary work and there are bugs in the
-framework that need to be ironed out. Please report any issues
-to dtalayco@stanford.edu.
-
Warning
+++++++
@@ -48,8 +11,22 @@
control the dataplane ports. As a consequence, there may be
risks to the machine on which this is running. Use caution.
-Recovering From Problems
-++++++++++++++++++++++++
+Rebuilding
+++++++++++
+
+If you ever make a change to the code in src/oftest/python...
+you must rebuild and reinstall the source code. See Step (2)
+in the Longer Start below.
+
+If you see
+
+ WARNING:..:Could not import file ...
+
+There is likely a Python error in the file. Try invoking the
+Python cli and importing the file directly to get more information.
+
+Recovering From Crash
++++++++++++++++++++++
If the test script, oft, becomes unresponsive, you may find that ^C
does not break out of the script. In this case you have two options:
@@ -75,6 +52,7 @@
framework that need to be ironed out. Please report any issues
to dtalayco@stanford.edu.
+
Introduction
++++++++++++