Home | History | Annotate | Line # | Download | only in libarchive
      1 /*
      2    BLAKE2 reference source code package - reference C implementations
      3 
      4    Copyright 2012, Samuel Neves <sneves (at) dei.uc.pt>.  You may use this under the
      5    terms of the CC0, the OpenSSL Licence, or the Apache Public License 2.0, at
      6    your option.  The terms of these licenses can be found at:
      7 
      8    - CC0 1.0 Universal : http://creativecommons.org/publicdomain/zero/1.0
      9    - OpenSSL license   : https://www.openssl.org/source/license.html
     10    - Apache 2.0        : http://www.apache.org/licenses/LICENSE-2.0
     11 
     12    More information about the BLAKE2 hash function can be found at
     13    https://blake2.net.
     14 */
     15 
     16 #ifndef ARCHIVE_BLAKE2_H
     17 #define ARCHIVE_BLAKE2_H
     18 
     19 #include <stddef.h>
     20 #include <stdint.h>
     21 
     22 #if defined(_MSC_VER)
     23 #define BLAKE2_PACKED(x) __pragma(pack(push, 1)) x __pragma(pack(pop))
     24 #elif defined(__GNUC__)
     25 #define BLAKE2_PACKED(x) x __attribute__((packed))
     26 #else
     27 #define BLAKE2_PACKED(x) _Pragma("pack 1") x _Pragma("pack 0")
     28 #endif
     29 
     30 #if defined(__cplusplus)
     31 extern "C" {
     32 #endif
     33 
     34   enum blake2s_constant
     35   {
     36     BLAKE2S_BLOCKBYTES = 64,
     37     BLAKE2S_OUTBYTES   = 32,
     38     BLAKE2S_KEYBYTES   = 32,
     39     BLAKE2S_SALTBYTES  = 8,
     40     BLAKE2S_PERSONALBYTES = 8
     41   };
     42 
     43   enum blake2b_constant
     44   {
     45     BLAKE2B_BLOCKBYTES = 128,
     46     BLAKE2B_OUTBYTES   = 64,
     47     BLAKE2B_KEYBYTES   = 64,
     48     BLAKE2B_SALTBYTES  = 16,
     49     BLAKE2B_PERSONALBYTES = 16
     50   };
     51 
     52   typedef struct blake2s_state__
     53   {
     54     uint32_t h[8];
     55     uint32_t t[2];
     56     uint32_t f[2];
     57     uint8_t  buf[BLAKE2S_BLOCKBYTES];
     58     size_t   buflen;
     59     size_t   outlen;
     60     uint8_t  last_node;
     61   } blake2s_state;
     62 
     63   typedef struct blake2b_state__
     64   {
     65     uint64_t h[8];
     66     uint64_t t[2];
     67     uint64_t f[2];
     68     uint8_t  buf[BLAKE2B_BLOCKBYTES];
     69     size_t   buflen;
     70     size_t   outlen;
     71     uint8_t  last_node;
     72   } blake2b_state;
     73 
     74   typedef struct blake2sp_state__
     75   {
     76     blake2s_state S[8][1];
     77     blake2s_state R[1];
     78     uint8_t       buf[8 * BLAKE2S_BLOCKBYTES];
     79     size_t        buflen;
     80     size_t        outlen;
     81   } blake2sp_state;
     82 
     83   typedef struct blake2bp_state__
     84   {
     85     blake2b_state S[4][1];
     86     blake2b_state R[1];
     87     uint8_t       buf[4 * BLAKE2B_BLOCKBYTES];
     88     size_t        buflen;
     89     size_t        outlen;
     90   } blake2bp_state;
     91 
     92   BLAKE2_PACKED(struct blake2s_param__
     93   {
     94     uint8_t  digest_length; /* 1 */
     95     uint8_t  key_length;    /* 2 */
     96     uint8_t  fanout;        /* 3 */
     97     uint8_t  depth;         /* 4 */
     98     uint32_t leaf_length;   /* 8 */
     99     uint32_t node_offset;  /* 12 */
    100     uint16_t xof_length;    /* 14 */
    101     uint8_t  node_depth;    /* 15 */
    102     uint8_t  inner_length;  /* 16 */
    103     /* uint8_t  reserved[0]; */
    104     uint8_t  salt[BLAKE2S_SALTBYTES]; /* 24 */
    105     uint8_t  personal[BLAKE2S_PERSONALBYTES];  /* 32 */
    106   });
    107 
    108   typedef struct blake2s_param__ blake2s_param;
    109 
    110   BLAKE2_PACKED(struct blake2b_param__
    111   {
    112     uint8_t  digest_length; /* 1 */
    113     uint8_t  key_length;    /* 2 */
    114     uint8_t  fanout;        /* 3 */
    115     uint8_t  depth;         /* 4 */
    116     uint32_t leaf_length;   /* 8 */
    117     uint32_t node_offset;   /* 12 */
    118     uint32_t xof_length;    /* 16 */
    119     uint8_t  node_depth;    /* 17 */
    120     uint8_t  inner_length;  /* 18 */
    121     uint8_t  reserved[14];  /* 32 */
    122     uint8_t  salt[BLAKE2B_SALTBYTES]; /* 48 */
    123     uint8_t  personal[BLAKE2B_PERSONALBYTES];  /* 64 */
    124   });
    125 
    126   typedef struct blake2b_param__ blake2b_param;
    127 
    128   typedef struct blake2xs_state__
    129   {
    130     blake2s_state S[1];
    131     blake2s_param P[1];
    132   } blake2xs_state;
    133 
    134   typedef struct blake2xb_state__
    135   {
    136     blake2b_state S[1];
    137     blake2b_param P[1];
    138   } blake2xb_state;
    139 
    140   /* Padded structs result in a compile-time error */
    141   enum {
    142     BLAKE2_DUMMY_1 = 1/(sizeof(blake2s_param) == BLAKE2S_OUTBYTES),
    143     BLAKE2_DUMMY_2 = 1/(sizeof(blake2b_param) == BLAKE2B_OUTBYTES)
    144   };
    145 
    146   /* Streaming API */
    147   int blake2s_init( blake2s_state *S, size_t outlen );
    148   int blake2s_init_key( blake2s_state *S, size_t outlen, const void *key, size_t keylen );
    149   int blake2s_init_param( blake2s_state *S, const blake2s_param *P );
    150   int blake2s_update( blake2s_state *S, const void *in, size_t inlen );
    151   int blake2s_final( blake2s_state *S, void *out, size_t outlen );
    152 
    153   int blake2b_init( blake2b_state *S, size_t outlen );
    154   int blake2b_init_key( blake2b_state *S, size_t outlen, const void *key, size_t keylen );
    155   int blake2b_init_param( blake2b_state *S, const blake2b_param *P );
    156   int blake2b_update( blake2b_state *S, const void *in, size_t inlen );
    157   int blake2b_final( blake2b_state *S, void *out, size_t outlen );
    158 
    159   int blake2sp_init( blake2sp_state *S, size_t outlen );
    160   int blake2sp_init_key( blake2sp_state *S, size_t outlen, const void *key, size_t keylen );
    161   int blake2sp_update( blake2sp_state *S, const void *in, size_t inlen );
    162   int blake2sp_final( blake2sp_state *S, void *out, size_t outlen );
    163 
    164   int blake2bp_init( blake2bp_state *S, size_t outlen );
    165   int blake2bp_init_key( blake2bp_state *S, size_t outlen, const void *key, size_t keylen );
    166   int blake2bp_update( blake2bp_state *S, const void *in, size_t inlen );
    167   int blake2bp_final( blake2bp_state *S, void *out, size_t outlen );
    168 
    169   /* Variable output length API */
    170   int blake2xs_init( blake2xs_state *S, const size_t outlen );
    171   int blake2xs_init_key( blake2xs_state *S, const size_t outlen, const void *key, size_t keylen );
    172   int blake2xs_update( blake2xs_state *S, const void *in, size_t inlen );
    173   int blake2xs_final(blake2xs_state *S, void *out, size_t outlen);
    174 
    175   int blake2xb_init( blake2xb_state *S, const size_t outlen );
    176   int blake2xb_init_key( blake2xb_state *S, const size_t outlen, const void *key, size_t keylen );
    177   int blake2xb_update( blake2xb_state *S, const void *in, size_t inlen );
    178   int blake2xb_final(blake2xb_state *S, void *out, size_t outlen);
    179 
    180   /* Simple API */
    181   int blake2s( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
    182   int blake2b( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
    183 
    184   int blake2sp( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
    185   int blake2bp( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
    186 
    187   int blake2xs( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
    188   int blake2xb( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
    189 
    190   /* This is simply an alias for blake2b */
    191   int blake2( void *out, size_t outlen, const void *in, size_t inlen, const void *key, size_t keylen );
    192 
    193 #if defined(__cplusplus)
    194 }
    195 #endif
    196 
    197 #endif
    198