[or-cvs] r10573: README and TODO added (topf/trunk)

[benedikt@xxxxxxxx]

Author: benedikt
Date: 2007-06-12 05:44:51 -0400 (Tue, 12 Jun 2007)
New Revision: 10573

Added:
   topf/trunk/README
   topf/trunk/TODO
   topf/trunk/utils/
Modified:
   topf/trunk/tor-dir-fuzz.rb
Log:
README and TODO added

Added: topf/trunk/README
===================================================================
--- topf/trunk/README	                        (rev 0)
+++ topf/trunk/README	2007-06-12 09:44:51 UTC (rev 10573)
@@ -0,0 +1,31 @@
+(T)he (O)nion (P)rotocol (F)uzzer
+
+This is my Google Summer of Code Project where i try to build a
+fuzz-testing application for the variouse Tor-Protocols.
+
+First step is to implement stanadalone fuzzing tools to later add
+a kind of observer that controls these tools on a testing network
+in an automated fassion.
+
+For the definition of the variouse headers i choosed the ruby bit-struct library
+which was made primary for parsing and generating low-level c-like structures. 
+Here i use them to build up block-based definitions like the ones used in the famouse 
+spike-fuzzer. Cause every block in these structures has also a given type the
+fuzzing method can choose suitable tests for these fields. 
+At the moment the choose of the tests is random but im working on a permutation algorithm
+to try to do as much possible combinations.
+
+If you want to use the fuzzing library for fuzzing tor you have to include lib/topf.rb 
+which includes every needed file for this purpose. Also there exists a lib/fuzz-generic.rb
+which can be used to build custom fuzzers for other purposes.
+
+In the stuff/ directory one can find files that are needed by the applications to work
+like RSA-keys.
+
+The utils/ directory was created to store helper or small-ruby tools that can be used 
+for various purposes
+
+If you have any questions you can mail me to: 
+benedikt(dot)boss(at)gmail(dot)com
+
+HAVE FUN!

Added: topf/trunk/TODO
===================================================================
--- topf/trunk/TODO	                        (rev 0)
+++ topf/trunk/TODO	2007-06-12 09:44:51 UTC (rev 10573)
@@ -0,0 +1,7 @@
+- Fix pkcs1 signature
+- add more tests
+- implement other tor protocols 
+- calculate all possible permutations instead of random probing
+- implement fancy web frontend
+- easy to install and setup testing network
+- distributed testing

Modified: topf/trunk/tor-dir-fuzz.rb
===================================================================
--- topf/trunk/tor-dir-fuzz.rb	2007-06-12 09:27:41 UTC (rev 10572)
+++ topf/trunk/tor-dir-fuzz.rb	2007-06-12 09:44:51 UTC (rev 10573)
@@ -14,7 +14,7 @@
     raise "option missing" if !host or !port or !keyFile
 
     reset = 0
-    rd = TOP::Dir::RouterDescriptor.new( keyFile, host, port )
+    rd = TOPF::Dir::RouterDescriptor.new( keyFile, host, port )
     dirServer = Net::HTTP.new(host, port)
 
     begin
@@ -23,7 +23,7 @@
             response, body = dirServer.post "/tor/", rd.to_s
             rd.fuzz!
             if (reset += 1) == 10
-                rd = TOP::Dir::RouterDescriptor.new
+                rd = TOPF::Dir::RouterDescriptor.new
                 reset = 0
             end
         end