Changeset 105

Timestamp:

07/13/16 13:18:34 (8 years ago)

Author:

tim

Message:

.

File:

• wiki/Overview.wiki (modified) (8 diffs)

wiki/Overview.wiki

@@ -1 +1 @@
 Here you will find a brief overview of the tools and libraries provided by Bletchley.  For further details, see the individual tool usage statements, pydoc documentation, and of course the <a href="https://github.com/ecbftw/bletchley">source code</a>.
 
-= Installation = 
+<h1>Installation</h1>
 See: <a href="https://github.com/ecbftw/bletchley/blob/master/trunk/INSTALL">INSTALL</a>
 
-= Command Line Tools =
+<h1>Command Line Tools</h1>
 
-== bletchley-analyze ==
+<h2> bletchley-analyze </h2>
 
 Analyzes samples of encrypted data in an attempt to decode samples to
@@ -39 +39 @@
 As an example, several tokens were encrypted using ECB mode and encoded
 using base64, and then percent (URL) encoded:
-{{{
+<pre>
 zRW5bHxcRYHHqi0nriqOzg%3D%3D
 meU8SyxVHE3Hqi0nriqOzg%3D%3D
 vTA9eA4hhbFlktsbYI4hIg%3D%3D
 meU8SyxVHE1lktsbYI4hIg%3D%3D
-}}}
+</pre>
 
 These tokens were then fed to <code>bletchley-analyze</code>:
-<img src="https://raw.githubusercontent.com/ecbftw/bletchley/master/wiki/images/bletchley-analyze.png" />
+<img src="https://code.blindspotsecurity.com/trac/bletchley/export/head/wiki/images/bletchley-analyze.png" />
 
 1. <i>Bletchley's blobtools module currently supports 36 encoding variants,
@@ -54 +54 @@
 
 
-== bletchley-encode ==
+<h2> bletchley-encode </h2>
 A simple tool to encode arbitrary data using a specified encoding chain.
 See the usage statement for more information.  A quick example:
-{{{
+<pre>
 $ echo 'Mallory Is My Friend.' | bletchley-encode -e percent/upper-plus,base64/rfc3548
 TWFsbG9yeSBJcyBNeSBGcmllbmQuCg%3D%3D
-}}}
+</pre>
 
 NOTE: The encoding chain is applied from right to left in order to be consistent with other tools.  
@@ -67 +67 @@
 
 
-== bletchley-decode ==
+<h2> bletchley-decode </h2>
 A simple tool to decode data using a specified encoding chain.  See the
 usage statement for more information.  A quick example:
-{{{
+<pre>
 $ echo 'TWFsbG9yeSBJcyBNeSBGcmllbmQuCg%3D%3D' | bletchley-decode -e percent/upper-plus,base64/rfc3548
 Mallory Is My Friend.
-}}}
+</pre>
 
-== bletchley-http2py ==
+<h2> bletchley-http2py </h2>
 This script parses an HTTP request (provided via stdin or as a text
 file) and generates a Python script that sends (approximately) the same
@@ -82 +82 @@
 browser.  For more information, see the script's usage statement.
 
-== bletchley-nextrand ==
+<h2> bletchley-nextrand </h2>
 A simple program which computes the state of a Java Random class
 instance given two sequential outputs of 
@@ -89 +89 @@
 
 
-= Libraries =
+<h1>Libraries</h1>
 
 Start with '<code>pydoc3 bletchley</code>'.  The following provides a brief overview of what each module is for.
 
 
-== blobtools ==
+<h2> blobtools </h2>
 This module contains the code which handles base analysis of encrypted
 token encodings.  It can be used to automatically detect the most likely
@@ -101 +101 @@
 
 
-== buffertools ==
+<h2> buffertools </h2>
 This module contains a collection of tools mean to help one manipulate
 binary buffers of ciphertext.
 
 
-== CBC ==
+<h2> CBC </h2>
 The CBC module contains various tools for attacking CBC encrypted data.
 In particular, it contains the POA class which automates padding oracle
@@ -115 +115 @@
 
 
-= Support =
+<h1>Support</h1>
 
-Having trouble?  Submit an issue <a href="https://github.com/ecbftw/bletchley/issues">here</a>, or 
+Having trouble?  Submit an issue <a href="/trac/bletchley/newticket">here</a>, or 
 ask on the <a href="https://groups.google.com/d/forum/bletchley-devel">email list</a>.
 
 
-= Contributing =
+<h1>Contributing</h1>
 
 We welcome any kind of help with the project, from new tools to bug
-fixes and documentation.  You might want to start with our 
-<a href="https://github.com/ecbftw/bletchley/blob/master/trunk/doc/TODO">TODO</a>
+fixes and documentation.  You might want to start with our <a href="/trunk/doc/TODO">TODO</a>
 list.  Note that the GitHub repository is currently just a static mirror, so please don't submit pull requests.
 To submit a patch, please post an issue or submit it to the <a href="https://groups.google.com/d/forum/bletchley-devel">email list</a> and we'll merge it.