No empty .Rs/.Re
[netbsd-mini2440.git] / crypto / dist / heimdal / lib / hx509 / peer.c
blob94c415712d3cd95ccaf0d7998a310c29e9f400e9
1 /*
2 * Copyright (c) 2006 - 2007 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
4 * All rights reserved.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * 3. Neither the name of the Institute nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 * SUCH DAMAGE.
34 #include "hx_locl.h"
35 __RCSID("$Heimdal: peer.c 22345 2007-12-26 19:03:51Z lha $"
36 "$NetBSD$");
38 /**
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
47 /**
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().
55 * @ingroup hx509_peer
58 int
59 hx509_peer_info_alloc(hx509_context context, hx509_peer_info *peer)
61 *peer = calloc(1, sizeof(**peer));
62 if (*peer == NULL) {
63 hx509_set_error_string(context, 0, ENOMEM, "out of memory");
64 return ENOMEM;
66 return 0;
70 static void
71 free_cms_alg(hx509_peer_info peer)
73 if (peer->val) {
74 size_t i;
75 for (i = 0; i < peer->len; i++)
76 free_AlgorithmIdentifier(&peer->val[i]);
77 free(peer->val);
78 peer->val = NULL;
79 peer->len = 0;
83 /**
84 * Free a peer info structure.
86 * @param peer peer info to be freed.
88 * @ingroup hx509_peer
91 void
92 hx509_peer_info_free(hx509_peer_info peer)
94 if (peer == NULL)
95 return;
96 if (peer->cert)
97 hx509_cert_free(peer->cert);
98 free_cms_alg(peer);
99 memset(peer, 0, sizeof(*peer));
100 free(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
115 hx509_peer_info_set_cert(hx509_peer_info peer,
116 hx509_cert cert)
118 if (peer->cert)
119 hx509_cert_free(peer->cert);
120 peer->cert = hx509_cert_ref(cert);
121 return 0;
125 * Set the algorithms that the peer supports.
127 * @param context A hx509 context.
128 * @param peer the peer to set the new algorithms for
129 * @param val array of supported AlgorithmsIdentiers
130 * @param len length of array val.
132 * @return An hx509 error code, see hx509_get_error_string().
134 * @ingroup hx509_peer
138 hx509_peer_info_set_cms_algs(hx509_context context,
139 hx509_peer_info peer,
140 const AlgorithmIdentifier *val,
141 size_t len)
143 size_t i;
145 free_cms_alg(peer);
147 peer->val = calloc(len, sizeof(*peer->val));
148 if (peer->val == NULL) {
149 peer->len = 0;
150 hx509_set_error_string(context, 0, ENOMEM, "out of memory");
151 return ENOMEM;
153 peer->len = len;
154 for (i = 0; i < len; i++) {
155 int ret;
156 ret = copy_AlgorithmIdentifier(&val[i], &peer->val[i]);
157 if (ret) {
158 hx509_clear_error_string(context);
159 free_cms_alg(peer);
160 return ret;
163 return 0;
166 #if 0
169 * S/MIME
173 hx509_peer_info_parse_smime(hx509_peer_info peer,
174 const heim_octet_string *data)
176 return 0;
180 hx509_peer_info_unparse_smime(hx509_peer_info peer,
181 heim_octet_string *data)
183 return 0;
187 * For storing hx509_peer_info to be able to cache them.
191 hx509_peer_info_parse(hx509_peer_info peer,
192 const heim_octet_string *data)
194 return 0;
198 hx509_peer_info_unparse(hx509_peer_info peer,
199 heim_octet_string *data)
201 return 0;
203 #endif