Security-57336.1.9.tar.gz

[apple/security.git] / OSX / libsecurity_keychain / Security / cssmdatetime.h

diff --git a/OSX/libsecurity_keychain/Security/cssmdatetime.h b/OSX/libsecurity_keychain/Security/cssmdatetime.h
new file mode 100644 (file)
index 0000000..eb9af16
--- /dev/null
+++ b/OSX/libsecurity_keychain/Security/cssmdatetime.h
@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 1997-2002,2004,2011,2014 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@
+ */
+
+
+/*
+ *  cssmdatetime.h -- defines for the CSSM date and time utilities for the Mac
+ */
+#ifndef _SECURITY_CSSMDATETIME_H_
+#define _SECURITY_CSSMDATETIME_H_
+
+#include <Security/cssm.h>
+#include <CoreFoundation/CFDate.h>
+
+namespace Security
+{
+
+namespace CSSMDateTimeUtils
+{
+
+// Get the current time.
+extern void GetCurrentMacLongDateTime(sint64 &outMacDate);
+
+extern void TimeStringToMacSeconds(const CSSM_DATA &inUTCTime, uint32 &ioMacDate);
+extern void TimeStringToMacLongDateTime(const CSSM_DATA &inUTCTime, sint64 &outMacDate);
+
+// Length of inLength is an input parameter and must be 14 or 16.
+// The outData parameter must point to a buffer of at least inLength bytes.
+extern void MacSecondsToTimeString(uint32 inMacDate, uint32 inLength, void *outData);
+extern void MacLongDateTimeToTimeString(const sint64 &inMacDate,
+                                        uint32 inLength, void *outData);
+
+// outCssmDate must be a pointer to a 16 byte buffer.
+extern void CFDateToCssmDate(CFDateRef date, char *outCssmDate);
+
+// cssmDate must be a pointer to a 16 byte buffer formatted as follows: "YYYYMMDDhhmmssZ\0".
+extern void CssmDateToCFDate(const char *cssmDate, CFDateRef *outCFDate);
+
+// cssmDate must be a pointer to a string buffer formatted as follows: "[YY]YYMMDDhhmmssZ[\0]".
+// handles UTC (2-digit year) or generalized (4-digit year) date strings; terminated or not.
+// also handles localized time formats: "[YY]MMDDhhmmssThhmm" (where T=[+,-]).
+extern int CssmDateStringToCFDate(const char *cssmDate, unsigned int len, CFDateRef *outCFDate);
+
+} // end namespace CSSMDateTimeUtils
+
+} // end namespace Security
+
+#endif // !_SECURITY_CSSMDATETIME_H_