Changeset 29


Ignore:
Timestamp:
12/21/12 22:52:30 (12 years ago)
Author:
tmorgan
Message:

more docs

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/Overview.wiki

    r25 r29  
    3737</ul>
    3838
    39 bletchley-analyze can read from stdin or from a file.  Tokens are
     39<code>bletchley-analyze</code> can read from stdin or from a file.  Tokens are
    4040delimited with newlines.  Various options are provided to give the
    4141analyst control over the block sizes and encoding used during analysis.
     
    4343
    4444As an example, several tokens were encrypted using ECB mode and encoded
    45 using base64, and then percent (URL) encoding:
     45using base64, and then percent (URL) encoded:
    4646{{{
    4747zRW5bHxcRYHHqi0nriqOzg%3D%3D
     
    5151}}}
    5252
    53 These tokens were then fed to bletchley-analyze:
     53These tokens were then fed to <code>bletchley-analyze</code>:
    5454<img src="http://bletchley.googlecode.com/svn/wiki/images/bletchley-analyze.png" />
    5555
    56561. <i>Bletchley's blobtools module currently supports 33 encoding variants,
    5757including various forms of hexadecimal, base32, base64, and percent
    58 encodings.</i>
     58encodings. Try '<code>-e ?</code>' to list them.</i>
    5959
    6060
    6161== bletchley-encode ==
    62 TODO
     62A simple tool to encode arbitrary data using a specified encoding chain.
     63See the usage statement for more information.  A quick example:
     64{{{
     65$ echo 'Mallory Is My Friend.' | bletchley-encode -e percent/upper-plus,base64/rfc3548
     66TWFsbG9yeSBJcyBNeSBGcmllbmQuCg%3D%3D
     67}}}
     68
     69NOTE: The encoding chain is applied from right to left in order to be consistent with other tools. 
     70That is, one can use the same encoding chain ordering for
     71<code>bletchley-encode</code>, <code>bletchley-decode</code>, and <code>bletchley-analyze</code>.
     72
    6373
    6474== bletchley-decode ==
    65 TODO
     75A simple tool to decode data using a specified encoding chain.  See the
     76usage statement for more information.  A quick example:
     77{{{
     78$ echo 'TWFsbG9yeSBJcyBNeSBGcmllbmQuCg%3D%3D' | bletchley-decode -e percent/upper-plus,base64/rfc3548
     79Mallory Is My Friend.
     80}}}
    6681
    6782== bletchley-http2py ==
    68 TODO
     83This script parses an HTTP request (provided via stdin or as a text
     84file) and generates a Python script that sends (approximately) the same
     85request.  This is useful when one wants to repeatedly send variations of
     86a request that was observed to be sent by an application or web
     87browser.  For more information, see the script's usage statement.
    6988
    7089== bletchley-nextrand ==
    71 TODO
     90A simple program which computes the state of a Java Random class
     91instance given two sequential outputs of
     92<code><a href="http://docs.oracle.com/javase/6/docs/api/java/util/Random.html#nextInt()">nextInt()</a></code>.
     93For more information, see the usage statement.
    7294
    7395
     
    7597
    7698TODO
     99
     100(Hint: start with 'pydoc bletchley')
Note: See TracChangeset for help on using the changeset viewer.