mdw@git.distorted.org.uk Git - storin/blob - README

   1 Storin: a block cipher for digital signal processors
   2
   3
   4 Storin is an 8-round SP network designed to play to the strengths of
   5 digital signal processors.
   6
   7 Files included:
   8
   9 configure               A shell script to set up the Storin build
  10                         environment on your computer.
  11
  12 configure.in            The m4 source code for configure.
  13
  14 aclocal.m4              Some m4 macros used by configure.in.
  15
  16 Makefile.in             A skeleton Makefile for building Storin.
  17
  18 Makefile.am             The Automake source for Makefile.in
  19
  20 bits.c, bits.h          Bit-manipulation macros.
  21
  22 arith24.c, arith24.h    Some simple 24-bit arithmetic.
  23
  24 matrix.c, matrix.h      Matrix arithmetic over Z_{2^{24}}.
  25
  26 storin.c, storin.h      The main cipher implementation.
  27
  28 sha.c, sha.h            Implementation of SHA-1.
  29
  30 dsarand.c, dsarand.h    SHA-1 based random number generator, suitable
  31                         for generating DSA parameters using the FIPS-180
  32                         algorithm.
  33
  34 fibrand.c, fibrand.h    A fast non-secure Fibonacci generator with a
  35                         long period, a large state and good properties.
  36
  37 lcrand.c, lcrand.h      A non-secure linear congruential generator with
  38                         good statistical properties used for seeding
  39                         fibrand.
  40
  41 storin-mktab.c          A program for building Storin matrices.  It uses
  42                         dsarand to provide confidence that `trap doors'
  43                         haven't been inserted in the matrix.
  44
  45 storin-tests.c          A program for making Storin test vectors.  It
  46                         outputs test vectors in mLib/Catacomb format.
  47
  48 sym.c, sym.h            An efficient extensible hashtable, used by
  49                         diffan.
  50
  51 diffan.c                A program to perform differential analysis of
  52                         the matrix multiplication.
  53
  54 sac.c                   A program to perform statistical testing of
  55                         three Storin rounds to ensure strict avalanche.
  56
  57 storin.ps               A paper, in PostScript, defining the Storin
  58                         cipher and providing some preliminary analysis.
  59
  60 storin.tex              The TeX source to the Storin paper.
  61
  62 storin.tests            A file of test vectors useful for testing your
  63                         implementation.
  64
  65 storin.debug            A file showing a Storin key schedule and
  66                         encryption, with all intermediate values.
  67                         Useful when you're trying to produce your own
  68                         implementation.
  69
  70
  71 Programs built:
  72
  73 storin-debug            Generates storin.debug.
  74
  75 storin-tests            Generates storin.tests.
  76
  77 storin-mktab            Generates the Storin matrix and its inverse,
  78                         given a seed string.
  79
  80 diffan                  Performs a statistical differential analysis of
  81                         the matrix multiplication.
  82
  83 sac                     Performs statistical testing of Storin for
  84                         strict avalanche.
  85
  86
  87 The software is provided under two licences.  It is up to you which you
  88 want to use:
  89
  90   * A slightly modified version of the BSD licence, without the
  91     `advertising materials' clause.
  92
  93   * The GNU General Public Licence.
  94
  95 The latter is provided in order make it explicitly clear that the author
  96 has no objections to this software being distributed under the GPL.
  97
  98 Verbatim copies of the paper may be distributed with or without charge,
  99 but altering its text or meaning is not allowed.
 100
 101 Local variables:
 102 mode: text
 103 End: