X-Git-Url: https://git.saurik.com/apple/security.git/blobdiff_plain/80e2389990082500d76eb566d4946be3e786c3ef..d8f41ccd20de16f8ebe2ccc84d47bf1cb2b26bbb:/Security/libsecurity_transform/lib/SecDigestTransform.h?ds=sidebyside

diff --git a/Security/libsecurity_transform/lib/SecDigestTransform.h b/Security/libsecurity_transform/lib/SecDigestTransform.h
new file mode 100644
index 00000000..3c838c11
--- /dev/null
+++ b/Security/libsecurity_transform/lib/SecDigestTransform.h
@@ -0,0 +1,150 @@
+#ifndef __TRANSFORM_DIGEST__
+#define __TRANSFORM_DIGEST__
+
+
+/*
+ * Copyright (c) 2010-2011 Apple Inc. All Rights Reserved.
+ * 
+ * @APPLE_LICENSE_HEADER_START@
+ * 
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this
+ * file.
+ * 
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.
+ * 
+ * @APPLE_LICENSE_HEADER_END@
+ */
+
+#include "SecTransform.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+/*!
+	@abstract
+		Specifies an MD2 digest
+*/
+extern const CFStringRef kSecDigestMD2;
+
+/*!
+	@abstract
+		Specifies an MD4 digest
+ */
+extern const CFStringRef kSecDigestMD4;
+
+/*!
+	@abstract
+		Specifies an MD5 digest
+ */
+extern const CFStringRef kSecDigestMD5;
+
+/*!
+	@abstract
+		Specifies a SHA1 digest
+ */
+extern const CFStringRef kSecDigestSHA1;
+
+/*!
+	@abstract
+		Specifies a SHA2 digest.
+ */
+extern const CFStringRef kSecDigestSHA2;
+
+/*!
+	@abstract
+		Specifies an HMAC using the MD5 digest algorithm.
+ */
+extern const CFStringRef kSecDigestHMACMD5;
+
+/*!
+	@abstract
+		Specifies an HMAC using the SHA1 digest algorithm.
+ */
+extern const CFStringRef kSecDigestHMACSHA1;
+
+/*!
+	@abstract
+		Specifies an HMAC using one of the SHA2 digest algorithms.
+ */
+extern const CFStringRef kSecDigestHMACSHA2;
+
+
+/*!
+	@constant kSecDigestTypeAttribute
+		Used with SecTransformGetAttribute to query the attribute type.
+		Returns one of the strings defined in the previous section.
+ */
+extern const CFStringRef kSecDigestTypeAttribute;
+
+/*!
+	@constant kSecDigestLengthAttribute
+		Used with SecTransformGetAttribute to query the length attribute.
+		Returns a CFNumberRef that contains the length.
+ */
+extern const CFStringRef kSecDigestLengthAttribute;
+
+/*!
+	@constant kSecDigestHMACKeyAttribute
+		When set and used with one of the HMAC digest types, sets the key
+		for the HMAC operation.  The data type for this attribute must be
+		a CFDataRef.  If this value is not set, the transform will assume
+		a zero length key.
+*/
+extern const CFStringRef kSecDigestHMACKeyAttribute;
+
+/*!
+	@function SecDigestTransformCreate
+	@abstract			Creates a digest computation object.
+	@param digestType	The type of digest to compute.  You may pass NULL
+						for this parameter, in which case an appropriate
+						algorithm will be chosen for you.
+	@param digestLength	The desired digest length.  Note that certain
+						algorithms may only support certain sizes. You may
+						pass 0 for this parameter, in which case an
+						appropriate length will be chosen for you.
+	@param error		A pointer to a CFErrorRef.  This pointer will be set
+						if an error occurred.  This value may be NULL if you
+						do not want an error returned.
+	@result				A pointer to a SecTransformRef object.  This object must
+						be released with CFRelease when you are done with
+						it.  This function will return NULL if an error
+						occurred.
+	@discussion			This function creates a transform which computes a
+						cryptographic digest.
+*/
+
+SecTransformRef SecDigestTransformCreate(CFTypeRef digestType,
+										 CFIndex digestLength,
+										 CFErrorRef* error
+										 )
+										 __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_NA);
+
+
+/*!
+	@function SecDigestTransformGetTypeID
+	@abstract			Return the CFTypeID of a SecDigestTransform
+	@result			The CFTypeID
+*/
+
+CFTypeID SecDigestTransformGetTypeID()
+										 __OSX_AVAILABLE_STARTING(__MAC_10_7,__IPHONE_NA);
+
+
+#ifdef __cplusplus
+};
+#endif
+
+
+#endif