summaryrefslogtreecommitdiffstats
path: root/security/nss/lib/freebl/cmac.h
blob: 6a6f42c7976c126d4204b24e97c9d9e9ad8cd7ef (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef _CMAC_H_
#define _CMAC_H_

typedef struct CMACContextStr CMACContext;

SEC_BEGIN_PROTOS

/* Enum for identifying the underlying block cipher we're using internally. */
typedef enum {
    CMAC_AES = 0
} CMACCipher;

/* Initialize an existing CMACContext struct. */
SECStatus CMAC_Init(CMACContext *ctx, CMACCipher type,
                    const unsigned char *key, unsigned int key_len);

/* Allocate and initialize a new CMAC context with the specified cipher and
 * key. */
CMACContext *CMAC_Create(CMACCipher type, const unsigned char *key,
                         unsigned int key_len);

/* Called automatically by CMAC_*{Create,Init}(...). Only useful for restarting
 * an already-started CMAC instance. */
SECStatus CMAC_Begin(CMACContext *ctx);

/* Add the specified bytes into the CMAC state. */
SECStatus CMAC_Update(CMACContext *ctx, const unsigned char *data,
                      unsigned int data_len);

/* Finalize the CMAC state and return the result. */
SECStatus CMAC_Finish(CMACContext *ctx, unsigned char *result,
                      unsigned int *result_len,
                      unsigned int max_result_len);

/* Note: CMAC_Clone isn't implemented here because AES doesn't expose a
 * context-cloning operation. */

/* Destroy a CMAC context, optionally freeing it. */
void CMAC_Destroy(CMACContext *ctx, PRBool free_it);

SEC_END_PROTOS

#endif