cx_blake2.h

Go to the documentation of this file.

/*
   BLAKE2 reference source code package - reference C implementations
 
   Copyright 2012, Samuel Neves <sneves@dei.uc.pt>.  You may use this under the
   terms of the CC0, the OpenSSL Licence, or the Apache Public License 2.0, at
   your option.  The terms of these licenses can be found at:
 
   - CC0 1.0 Universal : http://creativecommons.org/publicdomain/zero/1.0
   - OpenSSL license   : https://www.openssl.org/source/license.html
   - Apache 2.0        : http://www.apache.org/licenses/LICENSE-2.0
 
   More information about the BLAKE2 hash function can be found at
   https://blake2.net.
*/
 
#ifndef CX_BLAKE2_H
#define CX_BLAKE2_H
 
#ifdef HAVE_BLAKE2
 
#include "lcx_blake2.h"
#include <stddef.h>
#include <stdint.h>
 
#if defined(_MSC_VER)
#define BLAKE2_PACKED(x) __pragma(pack(push, 1)) x __pragma(pack(pop))
#else
#define BLAKE2_PACKED(x) x __attribute__((packed))
#endif
 
#if defined(__cplusplus)
extern "C" {
#endif
enum blake2s_constant {
    BLAKE2S_BLOCKBYTES    = 64,
    BLAKE2S_OUTBYTES      = 32,
    BLAKE2S_KEYBYTES      = 32,
    BLAKE2S_SALTBYTES     = 8,
    BLAKE2S_PERSONALBYTES = 8
};
 
BLAKE2_PACKED(struct blake2s_param__ {
    uint8_t  digest_length; /* 1 */
    uint8_t  key_length;    /* 2 */
    uint8_t  fanout;        /* 3 */
    uint8_t  depth;         /* 4 */
    uint32_t leaf_length;   /* 8 */
    uint32_t node_offset;   /* 12 */
    uint16_t xof_length;    /* 14 */
    uint8_t  node_depth;    /* 15 */
    uint8_t  inner_length;  /* 16 */
    /* uint8_t  reserved[0]; */
    uint8_t salt[BLAKE2S_SALTBYTES];         /* 24 */
    uint8_t personal[BLAKE2S_PERSONALBYTES]; /* 32 */
});
 
typedef struct blake2s_param__ blake2s_param;
 
BLAKE2_PACKED(struct blake2b_param__ {
    uint8_t  digest_length;                   /* 1 */
    uint8_t  key_length;                      /* 2 */
    uint8_t  fanout;                          /* 3 */
    uint8_t  depth;                           /* 4 */
    uint32_t leaf_length;                     /* 8 */
    uint32_t node_offset;                     /* 12 */
    uint32_t xof_length;                      /* 16 */
    uint8_t  node_depth;                      /* 17 */
    uint8_t  inner_length;                    /* 18 */
    uint8_t  reserved[14];                    /* 32 */
    uint8_t  salt[BLAKE2B_SALTBYTES];         /* 48 */
    uint8_t  personal[BLAKE2B_PERSONALBYTES]; /* 64 */
});
 
typedef struct blake2b_param__ blake2b_param;
 
/* Padded structs result in a compile-time error */
enum {
    BLAKE2_DUMMY_1 = 1 / (sizeof(blake2s_param) == BLAKE2S_OUTBYTES),
    BLAKE2_DUMMY_2 = 1 / (sizeof(blake2b_param) == BLAKE2B_OUTBYTES)
};
 
/* Streaming API */
 
int  blake2b_init(blake2b_state *S,
                  size_t         outlen,
                  unsigned char *salt,
                  size_t         salt_len,
                  unsigned char *personal,
                  size_t         personal_len);
int  blake2b_init_key(blake2b_state *S, size_t outlen, const void *key, size_t keylen);
int  blake2b_init_param(blake2b_state *S, const blake2b_param *P);
void blake2b_update(blake2b_state *S, const void *in, size_t inlen);
int  blake2b_final(blake2b_state *S, void *out, size_t outlen);
 
/* Simple API */
int blake2b(void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen);
 
/* This is simply an alias for blake2b */
int blake2(void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen);
 
#if defined(__cplusplus)
}
#endif
 
#endif  // HAVE_BLAKE2
 
#endif  // CX_BLAKE2_H