@database "Simple Cypher"
@version 1.0


@node main "Contents"

                                       @{b}Simple Cypher
                                  Version 1.00 (15 May 1999)
                                       Written by Oovis @{ub}
  
                           @{"Introduction" link Intro} What is this then?
                           
                           @{"Installation" link install} How do I install it?
                           
                           @{"   Usage    " link howto} How do I use it?

                           @{"   Author   " link oovis} Who wrote it?

                           @{"  History.  " link versions} What's changed?
 


                I'm cracking keys for the Amiga RC5-64 Challenge team. Are you?
 
                      visit http://distributed.amiga.org for information.

@endnode

@node howto "Simple Cypher - usage"

 Simple Cypher can be started from Workbench, or a Shell window.

 Once started Simple Cypher will open its own window, and ask you for the following information;
 
 a) the name of the file to be decoded/encoded
 
 b) the name you wish to give this file to save as, once processed
 
 then either of the following;
 
 i) the text you wish to use as your Cypher Key, or
 
 ii) if you enter -f, a new line will appear for the name of the text file to use as the key.
 
 
 
 The cypher key can be up to 256 characters long. If you input more text than this SCS will
simply truncate any data you enter.

 Simple Cypher will automatically recognise a file encoded by itself and will decode it.



Examples;


 1> SimpleCypher

 ( window opens)
 
 
 File to process = ram:TextFile.TXT
 Save as         = ram:CodedFile.TXT
 Cypher key      = Amiga The Greatest
 
 
 or
 
 
1> SimpleCypher 

 (window opens)
 
 File to process = ram:TextFile.TXT
 Save as         = ram:CodedFile.TXT
 Cypher key      = -f
 Cypher Key file = s:KeyFile.TXT
 
 
 Both of these options will take TextFile.TXT and encode it to produce CodedFile.TXT. The 
difference between the two is that in the first case the text "Amiga The Greatest" is used as
the key, whereas in the second case the contents of the file Keyfile.txt is used (up to 256
characters). The idea of the use of a text file is so that longer key files can be used without
the problem of a mis-type causing data to be incorrectly en/decoded.


 The encoded output file will be 12 bytes longer than the original. This is normal as a 12 byte
header is added to the start of the file so that an encoded file can be recognised. When this
file is decoded this header is removed and the file is restored to its original size.


 If enough people ask for it, I may add a proper routine to give you a directory window instead
of having to type the names of the files by hand. We'll see.


 @{b}NOTICE@{ub} You must note that the cypher keys are case sensitive, this means that
         t is not the same as T, and will produce different results.
         
@endnode




@node Intro "Simple Cypher - introduction"

 Simple Cypher will encode/decode any files using a key-code entered by you.
 
 This allows you to protect files against anyone else reading them, or running them.
 
 The algorithm used means that you must ensure you enter the key-code exactly, as the file will
not decode properly without the exact data. This means that T and t are completely different,
for example.

 This program is not intended to be completely fool-proof, but it should provide enough
security to deter most people.


 
@endnode

@node oovis "Simple Cypher - author"

 This program was written by Oovis.
 
 I began this program as a passtime, and to keep my programming skills from getting rusty.
 
 The program was written in 100% assembler as I haven't learned to write C yet, and probably
never will now.


 Send bug reports, greetings etc. to me via oovis@messages.co.uk

 
 
 
 This program is FREEWARE. Feel free to use it, spread it, or ignore it. It's your choice.
 
 This program is provided as is, without warranty as to use, purpose or effect. The author of
the program will not be held liable for any loss or damage, either physical or financial,
arising from the use or misuse of this program, or any data entered into it, or produced by it.

 With this version of the program there is NO way of decoding any data without the correct key
code. You must bear this in mind if you encode data. Future versions of the program may
contain a way of decoding the key code, but for obvious security reasons, this has not been
attempted. 
  
 
 
 


 
@endnode

@node versions "History"

1.00  (17/05/99)  Initial Release via Amiga Format magazine coverCD

@endnode

@node install "Simple Cypher - Installation"

 There are two versions of Simple Cypher in the archive;
 
 SimpleCypher     - This is for machines with at least a 68020 processor (A600 and above)
 
 SimpleCypher000  - This is for machines with a 68000 processor (A500)
 
 
 Simple Cypher requires no libraries or external files. simply copy the required version to
somewhere in your search path, e.g. C:    Sys:Utilities    Sys:Tools

@endnode