src/third_party/openssl/openssl/include/openssl/poly1305.h

   1 /*
   2  *  Poly1305
   3  *
   4  *  Created on: Jun, 2013
   5  *  Author: Elie Bursztein (elieb@google.com)
   6  *
   7  *  Adapted from the estream code by D. Bernstein.
   8  */
   9 /* ====================================================================
  10  * Copyright (c) 2011-2013 The OpenSSL Project.  All rights reserved.
  11  *
  12  * Redistribution and use in source and binary forms, with or without
  13  * modification, are permitted provided that the following conditions
  14  * are met:
  15  *
  16  * 1. Redistributions of source code must retain the above copyright
  17  *    notice, this list of conditions and the following disclaimer.
  18  *
  19  * 2. Redistributions in binary form must reproduce the above copyright
  20  *    notice, this list of conditions and the following disclaimer in
  21  *    the documentation and/or other materials provided with the
  22  *    distribution.
  23  *
  24  * 3. All advertising materials mentioning features or use of this
  25  *    software must display the following acknowledgment:
  26  *    "This product includes software developed by the OpenSSL Project
  27  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  28  *
  29  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  30  *    endorse or promote products derived from this software without
  31  *    prior written permission. For written permission, please contact
  32  *    licensing@OpenSSL.org.
  33  *
  34  * 5. Products derived from this software may not be called "OpenSSL"
  35  *    nor may "OpenSSL" appear in their names without prior written
  36  *    permission of the OpenSSL Project.
  37  *
  38  * 6. Redistributions of any form whatsoever must retain the following
  39  *    acknowledgment:
  40  *    "This product includes software developed by the OpenSSL Project
  41  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  42  *
  43  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  44  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  45  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  46  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
  47  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  48  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  49  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  50  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  51  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  52  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  53  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  54  * OF THE POSSIBILITY OF SUCH DAMAGE.
  55  * ====================================================================
  56  */
  57
  58 #ifndef HEADER_POLY1305_H_
  59 #define HEADER_POLY1305_H_
  60
  61 #include <stdint.h>
  62 #include <openssl/opensslconf.h>
  63
  64 #if defined(OPENSSL_NO_POLY1305)
  65 #error Poly1305 support is disabled.
  66 #endif
  67
  68 typedef unsigned char poly1305_state[512];
  69
  70 /* poly1305_init sets up |state| so that it can be used to calculate an
  71  * authentication tag with the one-time key |key|. Note that |key| is a
  72  * one-time key and therefore there is no `reset' method because that would
  73  * enable several messages to be authenticated with the same key. */
  74 extern void CRYPTO_poly1305_init(poly1305_state* state,
  75                                  const unsigned char key[32]);
  76
  77 /* poly1305_update processes |in_len| bytes from |in|. It can be called zero or
  78  * more times after poly1305_init. */
  79 extern void CRYPTO_poly1305_update(poly1305_state* state,
  80                                    const unsigned char *in,
  81                                    size_t in_len);
  82
  83 /* poly1305_finish completes the poly1305 calculation and writes a 16 byte
  84  * authentication tag to |mac|. */
  85 extern void CRYPTO_poly1305_finish(poly1305_state* state,
  86                                    unsigned char mac[16]);
  87
  88 #endif  /* HEADER_POLY1305_H_ */