2 * Copyright (c) 2006 - 2007 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
6 * Portions Copyright (c) 2009 Apple Inc. All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
19 * 3. Neither the name of the Institute nor the names of its contributors
20 * may be used to endorse or promote products derived from this software
21 * without specific prior written permission.
23 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
39 * @page page_peer Hx509 crypto selecting functions
41 * Peer info structures are used togeter with hx509_crypto_select() to
42 * select the best avaible crypto algorithm to use.
44 * See the library functions here: @ref hx509_peer
48 * Allocate a new peer info structure an init it to default values.
50 * @param context A hx509 context.
51 * @param peer return an allocated peer, free with hx509_peer_info_free().
53 * @return An hx509 error code, see hx509_get_error_string().
58 HX509_LIB_FUNCTION
int HX509_LIB_CALL
59 hx509_peer_info_alloc(hx509_context context
, hx509_peer_info
*peer
)
61 *peer
= calloc(1, sizeof(**peer
));
63 hx509_set_error_string(context
, 0, ENOMEM
, "out of memory");
71 free_cms_alg(hx509_peer_info peer
)
75 for (i
= 0; i
< peer
->len
; i
++)
76 free_AlgorithmIdentifier(&peer
->val
[i
]);
84 * Free a peer info structure.
86 * @param peer peer info to be freed.
91 HX509_LIB_FUNCTION
void HX509_LIB_CALL
92 hx509_peer_info_free(hx509_peer_info peer
)
97 hx509_cert_free(peer
->cert
);
99 memset(peer
, 0, sizeof(*peer
));
104 * Set the certificate that remote peer is using.
106 * @param peer peer info to update
107 * @param cert cerificate of the remote peer.
109 * @return An hx509 error code, see hx509_get_error_string().
111 * @ingroup hx509_peer
114 HX509_LIB_FUNCTION
int HX509_LIB_CALL
115 hx509_peer_info_set_cert(hx509_peer_info peer
,
119 hx509_cert_free(peer
->cert
);
120 peer
->cert
= hx509_cert_ref(cert
);
125 * Add an additional algorithm that the peer supports.
127 * @param context A hx509 context.
128 * @param peer the peer to set the new algorithms for
129 * @param val an AlgorithmsIdentier to add
131 * @return An hx509 error code, see hx509_get_error_string().
133 * @ingroup hx509_peer
136 HX509_LIB_FUNCTION
int HX509_LIB_CALL
137 hx509_peer_info_add_cms_alg(hx509_context context
,
138 hx509_peer_info peer
,
139 const AlgorithmIdentifier
*val
)
144 ptr
= realloc(peer
->val
, sizeof(peer
->val
[0]) * (peer
->len
+ 1));
146 hx509_set_error_string(context
, 0, ENOMEM
, "out of memory");
150 ret
= copy_AlgorithmIdentifier(val
, &peer
->val
[peer
->len
]);
154 hx509_set_error_string(context
, 0, ret
, "out of memory");
159 * Set the algorithms that the peer supports.
161 * @param context A hx509 context.
162 * @param peer the peer to set the new algorithms for
163 * @param val array of supported AlgorithmsIdentiers
164 * @param len length of array val.
166 * @return An hx509 error code, see hx509_get_error_string().
168 * @ingroup hx509_peer
171 HX509_LIB_FUNCTION
int HX509_LIB_CALL
172 hx509_peer_info_set_cms_algs(hx509_context context
,
173 hx509_peer_info peer
,
174 const AlgorithmIdentifier
*val
,
181 peer
->val
= calloc(len
, sizeof(*peer
->val
));
182 if (peer
->val
== NULL
) {
184 hx509_set_error_string(context
, 0, ENOMEM
, "out of memory");
188 for (i
= 0; i
< len
; i
++) {
190 ret
= copy_AlgorithmIdentifier(&val
[i
], &peer
->val
[i
]);
192 hx509_clear_error_string(context
);
206 HX509_LIB_FUNCTION
int HX509_LIB_CALL
207 hx509_peer_info_parse_smime(hx509_peer_info peer
,
208 const heim_octet_string
*data
)
213 HX509_LIB_FUNCTION
int HX509_LIB_CALL
214 hx509_peer_info_unparse_smime(hx509_peer_info peer
,
215 heim_octet_string
*data
)
221 * For storing hx509_peer_info to be able to cache them.
224 HX509_LIB_FUNCTION
int HX509_LIB_CALL
225 hx509_peer_info_parse(hx509_peer_info peer
,
226 const heim_octet_string
*data
)
231 HX509_LIB_FUNCTION
int HX509_LIB_CALL
232 hx509_peer_info_unparse(hx509_peer_info peer
,
233 heim_octet_string
*data
)