switching to simualtion testport

[avr-crypto-lib.git] / USAGE.streamciphers

diff --git a/USAGE.streamciphers b/USAGE.streamciphers
index 68fb1974568c53a614a9fba3f25c967b3b147a44..aed1a565c43d59c992beff99c9b2476e32536cec 100644 (file)
--- a/USAGE.streamciphers
+++ b/USAGE.streamciphers
@@ -3,33 +3,33 @@
 ====================================
 
 Author: Daniel Otte
 ====================================
 
 Author: Daniel Otte

-email:  daniel.otte@rub.de
+email:  bg@nerilex.org

  
  
 0. Foreword
  
  
 0. Foreword

- This file will describe how to use the streramcipher implementations provided
+ This file will describe how to use the streamcipher implementations provided

  by this library. It will not only show how to call the cryptographic functions
  but also discuss a little how to build security mechanisms from that.
 
 1. What a streamcipher does
  by this library. It will not only show how to call the cryptographic functions
  but also discuss a little how to build security mechanisms from that.
 
 1. What a streamcipher does

- A streamcipher normaly generates a deterministic, random looking stream of 
+ A streamcipher normally generates a deterministic, random looking stream of 

  bits, known as keystream. For encryption purpose this keystream is XORed with
  the data stream. So decryption is exactly the same as encryption. The 
  bits, known as keystream. For encryption purpose this keystream is XORed with
  the data stream. So decryption is exactly the same as encryption. The 

- datastream is XORed with the keystream giving the plaintext. So both sides need
- exactly the same streamcipher in the same state.
+ data-stream is XORed with the keystream giving the plaintext. So both sides 
+ need exactly the same streamcipher in the same state.

   
 1.1. high frequent parameters:
   
 1.1. high frequent parameters:

-       outputsize: 8 bit, 1 bit
+       output-size: 8 bit, 1 bit

        keysize: 64 bit, 80 bit, 128 bit
        IVsize: 64 bit
 
 2. Parts of a streamcipher
   * generation algorithm
        keysize: 64 bit, 80 bit, 128 bit
        IVsize: 64 bit
 
 2. Parts of a streamcipher
   * generation algorithm

-  * initialisation algorithm
+  * initialization algorithm

   * state
  As we can see all streamciphers seem to utilize an internal state which
   * state
  As we can see all streamciphers seem to utilize an internal state which

- determines the output. This state is initialized by the initialisation 
- algorithm with a key and an IV (initialisation vector). It is very important
+ determines the output. This state is initialized by the initialization 
+ algorithm with a key and an IV (initialization vector). It is very important

  for security that _never_ the same key with the same IV is used again. The
  IV is not required to be kept secret.
  
  for security that _never_ the same key with the same IV is used again. The
  IV is not required to be kept secret.
  


@@ -39,7 +39,7 @@ email:  daniel.otte@rub.de
  components).
  Generally the API of the implemented streamciphers consists of:
  
  components).
  Generally the API of the implemented streamciphers consists of:
  

- *_init function, which implements the initialisation
+ *_init function, which implements the initialization

  *_gen  function, which implements the streamcipher algorithm and generates a 
         keystream output
  *_ctx_t context type, which contains internal state information
  *_gen  function, which implements the streamcipher algorithm and generates a 
         keystream output
  *_ctx_t context type, which contains internal state information


@@ -51,8 +51,8 @@ email:  daniel.otte@rub.de
 3.1.2 sizes in bits and bytes
  Working with cryptographical functions involves working with different lengths.
  Some times you want to know it in bits and sometimes in bytes. To reduce
 3.1.2 sizes in bits and bytes
  Working with cryptographical functions involves working with different lengths.
  Some times you want to know it in bits and sometimes in bytes. To reduce

- frustration and to avoid bugs we suffix a length parameter with either _b or _B
- depending on the meaning. _b means in bits and _B means in bytes 
+ frustration and to avoid bugs we suffix a length parameter with either _b or
+ _B depending on the meaning. _b means in bits and _B means in bytes 

  (big b big word).  
  
 3.2. *_init function
  (big b big word).  
  
 3.2. *_init function


@@ -68,4 +68,4 @@ email:  daniel.otte@rub.de
  parameter and returns a fixed length part of the keystream as return value.
  
 
  parameter and returns a fixed length part of the keystream as return value.
  
 

- 
\ No newline at end of file
+