chiark - git - mdw - storin/blob - storin.h

   1 /* -*-c-*-
   2  *
   3  * $Id: storin.h,v 1.1 2000/05/21 11:28:30 mdw Exp $
   4  *
   5  * Block cipher optimized for DSPs
   6  *
   7  * (c) 2000 Mark Wooding
   8  */
   9
  10 /*----- Licensing notice --------------------------------------------------*
  11  *
  12  * Copyright (c) 2000 Mark Wooding
  13  * All rights reserved.
  14  *
  15  * Redistribution and use in source and binary forms, with or without
  16  * modification, are permitted provided that the following conditions are
  17  * met:
  18  *
  19  * 1. Redistributions of source code must retain the above copyright
  20  *    notice, this list of conditions and the following disclaimer.
  21  *
  22  * 2, Redistributions in binary form must reproduce the above copyright
  23  *    notice, this list of conditions and the following disclaimer in the
  24  *    documentation and/or other materials provided with the distribution.
  25  *
  26  * 3. The name of the authors may not be used to endorse or promote
  27  *    products derived from this software without specific prior written
  28  *    permission.
  29  *
  30  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
  31  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  32  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
  33  * NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
  34  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  35  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  36  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  37  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  38  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  39  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  40  * POSSIBILITY OF SUCH DAMAGE.
  41  *
  42  * Instead of accepting the above terms, you may redistribute and/or modify
  43  * this software under the terms of either the GNU General Public License,
  44  * or the GNU Library General Public License, published by the Free
  45  * Software Foundation; either version 2 of the License, or (at your
  46  * option) any later version.
  47  */
  48
  49 /*----- Revision history --------------------------------------------------*
  50  *
  51  * $Log: storin.h,v $
  52  * Revision 1.1  2000/05/21 11:28:30  mdw
  53  * Initial check-in.
  54  *
  55  */
  56
  57 #ifndef STORIN_H
  58 #define STORIN_H
  59
  60 #ifdef __cplusplus
  61   extern "C" {
  62 #endif
  63
  64 /*----- Header files ------------------------------------------------------*/
  65
  66 #ifndef BITS_H
  67 #  include "bits.h"
  68 #endif
  69
  70 /*----- Magic numbers -----------------------------------------------------*/
  71
  72 #define STORIN_BLKSZ 12
  73 #define STORIN_KEYSZ 12
  74 #define STORIN_CLASS (N, L, 96)
  75
  76 #define STORIN_ROUNDS 8
  77
  78 /*----- Data structures ---------------------------------------------------*/
  79
  80 typedef struct storin_ctx {
  81   uint24 k[4 * (STORIN_ROUNDS + 1)];
  82 } storin_ctx;
  83
  84 /*----- Functions provided ------------------------------------------------*/
  85
  86 /* --- @storin_init24@ --- *
  87  *
  88  * Arguments:   @storin_ctx *k@ = pointer to cipher context to initialize
  89  *              @const uint24 *buf@ = pointer to buffer of key material
  90  *              @size_t sz@ = size of the key material
  91  *
  92  * Returns:     ---
  93  *
  94  * Use:         Initializes the cipher for use.
  95  */
  96
  97 extern void storin_init24(storin_ctx */*k*/,
  98                           const uint24 */*buf*/, size_t /*sz*/);
  99
 100 /* --- @storin_eblk24@, @storin_dblk24@ --- *
 101  *
 102  * Arguments:   @const storin_ctx *k@ = pointer to cipher context
 103  *              @const uint24 s[4]@ = pointer to source block
 104  *              @uint24 d[4]@ = pointer to destination block
 105  *
 106  * Returns:     ---
 107  *
 108  * Use:         Low-level block encryption and decryption.
 109  */
 110
 111 extern void storin_eblk24(const storin_ctx */*k*/,
 112                           const uint24 */*s*/, uint24 */*d*/);
 113 extern void storin_dblk24(const storin_ctx */*k*/,
 114                           const uint24 */*s*/, uint24 */*d*/);
 115
 116 /*----- That's all, folks -------------------------------------------------*/
 117
 118 #ifdef __cplusplus
 119   }
 120 #endif
 121
 122 #endif