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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
/* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */
/*
* Copyright (c) 2004-2008 Apple Inc. All Rights Reserved.
*
* Export of this software from the United States of America may require
* a specific license from the United States Government. It is the
* responsibility of any person or organization contemplating export to
* obtain such a license before exporting.
*
* WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
* distribute this software and its documentation for any purpose and
* without fee is hereby granted, provided that the above copyright
* notice appear in all copies and that both that copyright notice and
* this permission notice appear in supporting documentation, and that
* the name of Apple Inc. not be used in advertising or publicity pertaining
* to distribution of the software without specific, written prior
* permission. Apple Inc. makes no representations about the suitability of
* this software for any purpose. It is provided "as is" without express
* or implied warranty.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
* WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*/
/*
* pkinit_apple_utils.h - PKINIT utilities, Mac OS X version
*
* Created 19 May 2004 by Doug Mitchell.
*/
#ifndef _PKINIT_APPLE_UTILS_H_
#define _PKINIT_APPLE_UTILS_H_
#include <krb5/krb5.h>
#include <Security/SecAsn1Coder.h>
#include <Security/cssmapple.h>
#include <CoreFoundation/CoreFoundation.h>
#ifdef __cplusplus
extern "C" {
#endif
#ifndef PKI_DEBUG
#define PKI_DEBUG 0
#endif
#if PKI_DEBUG
#include <stdio.h>
#define pkiDebug(args...) printf(args)
#define pkiCssmErr(str, rtn) cssmPerror(str, rtn)
#else
#define pkiDebug(args...)
#define pkiCssmErr(str, rtn)
#endif /* PKI_DEBUG */
/*
* Macros used to initialize a declared CSSM_DATA and krb5_data to zero/NULL values.
*/
#define INIT_CDATA(cd) cd = {0, NULL}
#define INIT_KDATA(kd) kd = {0, 0, NULL}
/* attach/detach to/from CL */
CSSM_RETURN pkiClDetachUnload(CSSM_CL_HANDLE clHand);
CSSM_CL_HANDLE pkiClStartup(void);
/*
* CSSM_DATA <--> krb5_ui_4
*/
krb5_error_code pkiDataToInt(
const CSSM_DATA *cdata,
krb5_int32 *i); /* RETURNED */
krb5_error_code pkiIntToData(
krb5_int32 num,
CSSM_DATA *cdata, /* allocated in coder space and RETURNED */
SecAsn1CoderRef coder);
/*
* raw data --> krb5_data
*/
krb5_error_code pkiDataToKrb5Data(
const void *data,
unsigned dataLen,
krb5_data *kd); /* content mallocd and RETURNED */
/*
* CSSM_DATA <--> krb5_data
*
* CSSM_DATA data is managed by a SecAsn1CoderRef; krb5_data.data is mallocd.
*/
krb5_error_code pkiCssmDataToKrb5Data(
const CSSM_DATA *cd,
krb5_data *kd); /* content mallocd and RETURNED */
krb5_error_code pkiKrb5DataToCssm(
const krb5_data *kd,
CSSM_DATA *cdata, /* allocated in coder space and RETURNED */
SecAsn1CoderRef coder);
/*
* CFDataRef --> krb5_data, mallocing the destination contents.
*/
krb5_error_code pkiCfDataToKrb5Data(
CFDataRef cfData,
krb5_data *kd); /* content mallocd and RETURNED */
/*
* Non-mallocing conversion between CSSM_DATA and krb5_data
*/
#define PKI_CSSM_TO_KRB_DATA(cd, kd) \
do { \
(kd)->data = (char *)(cd)->Data; \
(kd)->length = (cd)->Length; \
} while (0)
#define PKI_KRB_TO_CSSM_DATA(kd, cd) \
do { \
(cd)->Data = (uint8 *)(kd)->data; \
(cd)->Length = (kd)->length; \
} while (0)
/*
* Compare to CSSM_DATAs. Return TRUE if they're the same else FALSE.
*/
krb5_boolean pkiCompareCssmData(
const CSSM_DATA *d1,
const CSSM_DATA *d2);
/*
* krb5_timestamp <--> a mallocd string in generalized format
*/
krb5_error_code pkiKrbTimestampToStr(
krb5_timestamp kts,
char **str); /* mallocd and RETURNED */
krb5_error_code pkiTimeStrToKrbTimestamp(
const char *str,
unsigned len,
krb5_timestamp *kts); /* RETURNED */
/*
* How many items in a NULL-terminated array of pointers?
*/
unsigned pkiNssArraySize(
const void **array);
#ifdef __cplusplus
}
#endif
#endif /* _PKINIT_APPLE_UTILS_H_ */
|
