crypto/external/bsd/openssh/dist/umac.h

   1 /*      $NetBSD$        */
   2 /* $OpenBSD: umac.h,v 1.1 2007/06/07 19:37:34 pvalchev Exp $ */
   3 /* -----------------------------------------------------------------------
   4  *
   5  * umac.h -- C Implementation UMAC Message Authentication
   6  *
   7  * Version 0.93a of rfc4418.txt -- 2006 July 14
   8  *
   9  * For a full description of UMAC message authentication see the UMAC
  10  * world-wide-web page at http://www.cs.ucdavis.edu/~rogaway/umac
  11  * Please report bugs and suggestions to the UMAC webpage.
  12  *
  13  * Copyright (c) 1999-2004 Ted Krovetz
  14  *
  15  * Permission to use, copy, modify, and distribute this software and
  16  * its documentation for any purpose and with or without fee, is hereby
  17  * granted provided that the above copyright notice appears in all copies
  18  * and in supporting documentation, and that the name of the copyright
  19  * holder not be used in advertising or publicity pertaining to
  20  * distribution of the software without specific, written prior permission.
  21  *
  22  * Comments should be directed to Ted Krovetz (tdk@acm.org)
  23  *
  24  * ---------------------------------------------------------------------- */
  25
  26  /* ////////////////////// IMPORTANT NOTES /////////////////////////////////
  27   *
  28   * 1) This version does not work properly on messages larger than 16MB
  29   *
  30   * 2) If you set the switch to use SSE2, then all data must be 16-byte
  31   *    aligned
  32   *
  33   * 3) When calling the function umac(), it is assumed that msg is in
  34   * a writable buffer of length divisible by 32 bytes. The message itself
  35   * does not have to fill the entire buffer, but bytes beyond msg may be
  36   * zeroed.
  37   *
  38   * 4) Two free AES implementations are supported by this implementation of
  39   * UMAC. Paulo Barreto's version is in the public domain and can be found
  40   * at http://www.esat.kuleuven.ac.be/~rijmen/rijndael/ (search for
  41   * "Barreto"). The only two files needed are rijndael-alg-fst.c and
  42   * rijndael-alg-fst.h.
  43   * Brian Gladman's version is distributed with GNU Public lisence
  44   * and can be found at http://fp.gladman.plus.com/AES/index.htm. It
  45   * includes a fast IA-32 assembly version.
  46   *
  47   /////////////////////////////////////////////////////////////////////// */
  48 #ifndef HEADER_UMAC_H
  49 #define HEADER_UMAC_H
  50
  51
  52 #ifdef __cplusplus
  53     extern "C" {
  54 #endif
  55
  56 struct umac_ctx *umac_new(u_char key[]);
  57 /* Dynamically allocate a umac_ctx struct, initialize variables,
  58  * generate subkeys from key.
  59  */
  60
  61 #if 0
  62 int umac_reset(struct umac_ctx *ctx);
  63 /* Reset a umac_ctx to begin authenicating a new message */
  64 #endif
  65
  66 int umac_update(struct umac_ctx *ctx, u_char *input, long len);
  67 /* Incorporate len bytes pointed to by input into context ctx */
  68
  69 int umac_final(struct umac_ctx *ctx, u_char tag[], u_char nonce[8]);
  70 /* Incorporate any pending data and the ctr value, and return tag.
  71  * This function returns error code if ctr < 0.
  72  */
  73
  74 int umac_delete(struct umac_ctx *ctx);
  75 /* Deallocate the context structure */
  76
  77 #if 0
  78 int umac(struct umac_ctx *ctx, u_char *input,
  79          long len, u_char tag[],
  80          u_char nonce[8]);
  81 /* All-in-one implementation of the functions Reset, Update and Final */
  82 #endif
  83
  84 /* uhash.h */
  85
  86
  87 #if 0
  88 typedef struct uhash_ctx *uhash_ctx_t;
  89   /* The uhash_ctx structure is defined by the implementation of the    */
  90   /* UHASH functions.                                                   */
  91
  92 uhash_ctx_t uhash_alloc(u_char key[16]);
  93   /* Dynamically allocate a uhash_ctx struct and generate subkeys using */
  94   /* the kdf and kdf_key passed in. If kdf_key_len is 0 then RC6 is     */
  95   /* used to generate key with a fixed key. If kdf_key_len > 0 but kdf  */
  96   /* is NULL then the first 16 bytes pointed at by kdf_key is used as a */
  97   /* key for an RC6 based KDF.                                          */
  98
  99 int uhash_free(uhash_ctx_t ctx);
 100
 101 int uhash_set_params(uhash_ctx_t ctx,
 102                    void       *params);
 103
 104 int uhash_reset(uhash_ctx_t ctx);
 105
 106 int uhash_update(uhash_ctx_t ctx,
 107                u_char       *input,
 108                long        len);
 109
 110 int uhash_final(uhash_ctx_t ctx,
 111               u_char        ouput[]);
 112
 113 int uhash(uhash_ctx_t ctx,
 114         u_char       *input,
 115         long        len,
 116         u_char        output[]);
 117
 118 #endif
 119
 120 #ifdef __cplusplus
 121     }
 122 #endif
 123
 124 #endif /* HEADER_UMAC_H */