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