3 * $Id: key-data.c,v 1.5 2004/03/28 01:58:47 mdw Exp $
5 * Encoding and decoding of key data
7 * (c) 1999 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of Catacomb.
14 * Catacomb is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * Catacomb is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with Catacomb; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Revision history --------------------------------------------------*
32 * $Log: key-data.c,v $
33 * Revision 1.5 2004/03/28 01:58:47 mdw
34 * Generate, store and retreive elliptic curve keys.
36 * Revision 1.4 2000/07/16 19:51:58 mdw
37 * Shut stupid compiler up.
39 * Revision 1.3 2000/06/17 11:26:03 mdw
40 * key_structfind: track minor data structure change, and cope if the
41 * subkey isn't available.
43 * Revision 1.2 2000/02/12 18:21:02 mdw
44 * Overhaul of key management (again).
46 * Revision 1.1 1999/12/22 15:47:48 mdw
47 * Major key-management revision.
51 /*----- Header files ------------------------------------------------------*/
57 #include <mLib/base64.h>
58 #include <mLib/bits.h>
59 #include <mLib/dstr.h>
67 /*----- Setting new values ------------------------------------------------*/
69 /* --- @key_binary@ --- *
71 * Arguments: @key_data *k@ = pointer to key data block
72 * @const void *p@ = pointer to key data
73 * @size_t sz@ = size of the key data
77 * Use: Sets a binary key in a key data block.
80 void key_binary(key_data
*k
, const void *p
, size_t sz
)
82 k
->e
= (k
->e
& ~KF_ENCMASK
) | KENC_BINARY
;
83 k
->u
.k
.k
= sub_alloc(sz
);
84 memcpy(k
->u
.k
.k
, p
, sz
);
88 /* --- @key_encrypted@ --- *
90 * Arguments: @key_data *k@ = pointer to key data block
91 * @const void *p@ = pointer to key data
92 * @size_t sz@ = size of the key data
96 * Use: Sets an encrypted key in a key data block.
99 void key_encrypted(key_data
*k
, const void *p
, size_t sz
)
101 k
->e
= (k
->e
& ~KF_ENCMASK
) | KENC_ENCRYPT
;
102 k
->u
.k
.k
= sub_alloc(sz
);
103 memcpy(k
->u
.k
.k
, p
, sz
);
107 /* --- @key_mp@ --- *
109 * Arguments: @key_data *k@ = pointer to key data block
110 * @mp *m@ = pointer to the value to set
114 * Use: Sets a multiprecision integer key in a key block.
117 void key_mp(key_data
*k
, mp
*m
)
119 k
->e
= (k
->e
& ~KF_ENCMASK
) | KENC_MP
;
123 /* --- @key_string@ --- *
125 * Arguments: @key_data *k@ = pointer to key data block
126 * @const char *p@ = pointer to the value to set
130 * Use: Sets a plain string in a key block.
133 void key_string(key_data
*k
, const char *p
)
135 k
->e
= (k
->e
& ~KF_ENCMASK
) | KENC_STRING
;
139 /* --- @key_ec@ --- *
141 * Arguments: @key_data *k@ = pointer to key data block
142 * @const ec *e@ = pointer to the value to set
146 * Use: Sets an elliptic curve point in a key block.
149 void key_ec(key_data
*k
, const ec
*e
)
151 k
->e
= (k
->e
& ~KF_ENCMASK
) | KENC_EC
;
156 /* --- @key_structure@ --- *
158 * Arguments: @key_data *k@ = pointer to key data block
162 * Use: Initializes a structured key type.
165 void key_structure(key_data
*k
)
171 /* --- @key_structfind@ --- *
173 * Arguments: @key_data *k@ = pointer to key data block
174 * @const char *tag@ = pointer to tag string
176 * Returns: Pointer to key data block, or null.
178 * Use: Looks up the tag in a structured key.
181 key_data
*key_structfind(key_data
*k
, const char *tag
)
184 assert(((void)"Key is not structured",
185 (k
->e
& KF_ENCMASK
) == KENC_STRUCT
));
186 ks
= sym_find(&k
->u
.s
, tag
, -1, 0, 0);
192 /* --- @key_structcreate@ --- *
194 * Arguments: @key_data *k@ = pointer to key data block
195 * @const char *tag@ = pointer to tag string
197 * Returns: Pointer to newly created key data.
199 * Use: Creates a new uninitialized subkey.
202 key_data
*key_structcreate(key_data
*k
, const char *tag
)
207 assert(((void)"Key is not structured", k
->e
== KENC_STRUCT
));
208 ks
= sym_find(&k
->u
.s
, tag
, -1, sizeof(*ks
), &f
);
215 /*----- Miscellaneous operations ------------------------------------------*/
217 /* --- @key_destroy@ --- *
219 * Arguments: @key_data *k@ = pointer to key data to destroy
223 * Use: Destroys a lump of key data.
226 void key_destroy(key_data
*k
)
228 switch (k
->e
& KF_ENCMASK
) {
232 memset(k
->u
.k
.k
, 0, k
->u
.k
.sz
);
233 sub_free(k
->u
.k
.k
, k
->u
.k
.sz
);
248 for (sym_mkiter(&i
, &k
->u
.s
); (ks
= sym_next(&i
)) != 0; ) {
249 if (!(ks
->k
.e
& KF_TEMP
))
252 sym_destroy(&k
->u
.s
);
257 /* --- @key_do@ --- *
259 * Arguments: @key_data *k@ = pointer to key data block
260 * @const key_filter *kf@ = pointer to filter block
261 * @dstr *d@ = pointer to base string
262 * @int (*func)(key_data *kd, dstr *d, void *p@ = function
263 * @void *p@ = argument to function
265 * Returns: Nonzero return code from function, or zero.
267 * Use: Runs a function over all the leaves of a key.
270 int key_do(key_data
*k
, const key_filter
*kf
, dstr
*d
,
271 int (*func
)(key_data */
*kd*/
, dstr */
*d*/
, void */
*p*/
),
274 if (!KEY_MATCH(k
, kf
))
276 if ((k
->e
& KF_ENCMASK
) != KENC_STRUCT
)
277 return (func(k
, d
, p
));
286 for (sym_mkiter(&i
, &k
->u
.s
); (ks
= sym_next(&i
)) != 0; ) {
289 dstr_putf(d
, ".%s", SYM_NAME(ks
));
291 if ((rc
= key_do(&ks
->k
, kf
, d
, func
, p
)) != 0)
298 /* --- @key_copy@ --- *
300 * Arguments: @key_data *kd@ = pointer to destination data block
301 * @key_data *k@ = pointer to source data block
302 * @const key_filter *kf@ = pointer to filter block
304 * Returns: Nonzero if an item was actually copied.
306 * Use: Copies a chunk of key data from one place to another.
309 int key_copy(key_data
*kd
, key_data
*k
, const key_filter
*kf
)
313 if (!KEY_MATCH(kd
, kf
))
315 switch (k
->e
& KF_ENCMASK
) {
317 /* --- Plain binary data --- */
321 kd
->u
.k
.k
= sub_alloc(k
->u
.k
.sz
);
322 memcpy(kd
->u
.k
.k
, k
->u
.k
.k
, k
->u
.k
.sz
);
323 kd
->u
.k
.sz
= k
->u
.k
.sz
;
326 /* --- Multiprecision integers --- */
329 kd
->u
.m
= MP_COPY(k
->u
.m
);
332 /* --- Strings --- */
335 kd
->u
.p
= xstrdup(k
->u
.p
);
338 /* --- Elliptic curve points --- */
342 EC_COPY(&kd
->u
.e
, &k
->u
.e
);
345 /* --- Structured key data --- */
352 sym_create(&kd
->u
.s
);
353 for (sym_mkiter(&i
, &k
->u
.s
); (ks
= sym_next(&i
)) != 0; ) {
355 key_struct
*kks
= sym_find(&kd
->u
.s
, SYM_NAME(ks
), -1,
357 assert(((void)"Duplicate subkey tags", !f
));
358 if (key_copy(&kks
->k
, &ks
->k
, kf
))
361 sym_remove(&kd
->u
.s
, kks
);
364 sym_destroy(&kd
->u
.s
);
372 /*----- That's all, folks -------------------------------------------------*/