1/*
2 * Copyright (c) 2010 Apple Inc. All Rights Reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23
24#ifndef	_CC_HmacSPI_H_
25#define _CC_HmacSPI_H_
26
27#include <CommonCrypto/CommonHMAC.h>
28#include <CommonCrypto/CommonDigest.h>
29#include <CommonCrypto/CommonDigestSPI.h>
30
31#include <stdint.h>
32#include <sys/types.h>
33
34#include <Availability.h>
35#ifdef __cplusplus
36extern "C" {
37#endif
38
39typedef CCHmacContext * CCHmacContextRef;
40
41CCHmacContextRef
42CCHmacCreate(CCDigestAlg alg, const void *key, size_t keyLength)
43__OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_5_0);
44
45/* Create a clone of an initialized CCHmacContextRef - you must do this before use.  */
46CCHmacContextRef
47CCHmacClone(CCHmacContextRef ctx)
48__OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_7_0);
49
50/* Update and Final are reused from existing api, type changed from struct CCHmacContext * to CCHmacContextRef though */
51
52void
53CCHmacDestroy(CCHmacContextRef ctx)
54__OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_5_0);
55
56size_t
57CCHmacOutputSizeFromRef(CCHmacContextRef ctx)
58__OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_5_0);
59
60
61size_t
62CCHmacOutputSize(CCDigestAlg alg)
63__OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_5_0);
64
65/*
66 * Stateless, one-shot HMAC function using digest constants
67 * Output is written to caller-supplied buffer, as in CCHmacFinal().
68 */
69void CCHmacOneShot(
70            CCDigestAlg alg,  /* kCCHmacSHA1, kCCHmacMD5 */
71            const void *key,
72            size_t keyLength,           /* length of key in bytes */
73            const void *data,
74            size_t dataLength,          /* length of data in bytes */
75            void *macOut)               /* MAC written here */
76__OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_7_0);
77
78
79
80#ifdef __cplusplus
81}
82#endif
83
84#endif /* _CC_HmacSPI_H_ */
85