Lightweight Cryptography Primitives
 All Data Structures Files Functions Variables Typedefs Macros Pages
gimli24.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2020 Southern Storm Software, Pty Ltd.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included
12  * in all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20  * DEALINGS IN THE SOFTWARE.
21  */
22 
23 #ifndef LWCRYPTO_GIMLI24_H
24 #define LWCRYPTO_GIMLI24_H
25 
26 #include "aead-common.h"
27 
42 #ifdef __cplusplus
43 extern "C" {
44 #endif
45 
49 #define GIMLI24_KEY_SIZE 32
50 
54 #define GIMLI24_NONCE_SIZE 16
55 
59 #define GIMLI24_TAG_SIZE 16
60 
64 #define GIMLI24_HASH_SIZE 32
65 
69 typedef union
70 {
71  struct {
72  unsigned char state[48];
73  unsigned char count;
74  unsigned char mode;
75  } s;
76  unsigned long long align;
79 
83 extern aead_cipher_t const gimli24_cipher;
84 
91 
115  (unsigned char *c, unsigned long long *clen,
116  const unsigned char *m, unsigned long long mlen,
117  const unsigned char *ad, unsigned long long adlen,
118  const unsigned char *nsec,
119  const unsigned char *npub,
120  const unsigned char *k);
121 
146  (unsigned char *m, unsigned long long *mlen,
147  unsigned char *nsec,
148  const unsigned char *c, unsigned long long clen,
149  const unsigned char *ad, unsigned long long adlen,
150  const unsigned char *npub,
151  const unsigned char *k);
152 
164 int gimli24_hash
165  (unsigned char *out, const unsigned char *in, unsigned long long inlen);
166 
175 
186  (gimli24_hash_state_t *state, const unsigned char *in,
187  unsigned long long inlen);
188 
199  (gimli24_hash_state_t *state, unsigned char *out,
200  unsigned long long outlen);
201 
214  (gimli24_hash_state_t *state, unsigned char *out);
215 
216 #ifdef __cplusplus
217 }
218 #endif
219 
220 #endif
Meta-information about an AEAD cipher.
Definition: aead-common.h:185
Definitions that are common across AEAD schemes.
int gimli24_aead_decrypt(unsigned char *m, unsigned long long *mlen, unsigned char *nsec, const unsigned char *c, unsigned long long clen, const unsigned char *ad, unsigned long long adlen, const unsigned char *npub, const unsigned char *k)
Decrypts and authenticates a packet with GIMLI-24 using the full AEAD mode.
Definition: gimli24.c:177
Meta-information about a hash algorithm that is related to an AEAD.
Definition: aead-common.h:204
void gimli24_hash_finalize(gimli24_hash_state_t *state, unsigned char *out)
Returns the final hash value from a GIMLI-24-HASH hashing operation.
Definition: gimli24.c:327
void gimli24_hash_init(gimli24_hash_state_t *state)
Initializes the state for a GIMLI-24-HASH hashing operation.
Definition: gimli24.c:228
void gimli24_hash_squeeze(gimli24_hash_state_t *state, unsigned char *out, unsigned long long outlen)
Squeezes output data from an GIMLI-24-HASH state.
Definition: gimli24.c:281
int gimli24_hash(unsigned char *out, const unsigned char *in, unsigned long long inlen)
Hashes a block of input data with GIMLI-24 to generate a hash value.
Definition: gimli24.c:211
void gimli24_hash_absorb(gimli24_hash_state_t *state, const unsigned char *in, unsigned long long inlen)
Aborbs more input data into a GIMLI-24-HASH state.
Definition: gimli24.c:238
unsigned char mode
Definition: gimli24.h:74
unsigned char count
Definition: gimli24.h:73
State information for GIMLI-24-HASH incremental modes.
Definition: gimli24.h:69
aead_cipher_t const gimli24_cipher
Meta-information block for the GIMLI-24 cipher.
Definition: gimli24.c:27
unsigned long long align
Definition: gimli24.h:76
aead_hash_algorithm_t const gimli24_hash_algorithm
Meta-information block for the GIMLI-24-HASH algorithm.
Definition: gimli24.c:37
int gimli24_aead_encrypt(unsigned char *c, unsigned long long *clen, const unsigned char *m, unsigned long long mlen, const unsigned char *ad, unsigned long long adlen, const unsigned char *nsec, const unsigned char *npub, const unsigned char *k)
Encrypts and authenticates a packet with GIMLI-24 using the full AEAD mode.
Definition: gimli24.c:145