xref: /minix3/crypto/external/bsd/heimdal/dist/lib/krb5/generate_subkey.c (revision ebfedea0ce5bbe81e252ddf32d732e40fb633fae)
1*ebfedea0SLionel Sambuc /*	$NetBSD: generate_subkey.c,v 1.1.1.1 2011/04/13 18:15:33 elric Exp $	*/
2*ebfedea0SLionel Sambuc 
3*ebfedea0SLionel Sambuc /*
4*ebfedea0SLionel Sambuc  * Copyright (c) 1997 - 2001 Kungliga Tekniska Högskolan
5*ebfedea0SLionel Sambuc  * (Royal Institute of Technology, Stockholm, Sweden).
6*ebfedea0SLionel Sambuc  * All rights reserved.
7*ebfedea0SLionel Sambuc  *
8*ebfedea0SLionel Sambuc  * Redistribution and use in source and binary forms, with or without
9*ebfedea0SLionel Sambuc  * modification, are permitted provided that the following conditions
10*ebfedea0SLionel Sambuc  * are met:
11*ebfedea0SLionel Sambuc  *
12*ebfedea0SLionel Sambuc  * 1. Redistributions of source code must retain the above copyright
13*ebfedea0SLionel Sambuc  *    notice, this list of conditions and the following disclaimer.
14*ebfedea0SLionel Sambuc  *
15*ebfedea0SLionel Sambuc  * 2. Redistributions in binary form must reproduce the above copyright
16*ebfedea0SLionel Sambuc  *    notice, this list of conditions and the following disclaimer in the
17*ebfedea0SLionel Sambuc  *    documentation and/or other materials provided with the distribution.
18*ebfedea0SLionel Sambuc  *
19*ebfedea0SLionel Sambuc  * 3. Neither the name of the Institute nor the names of its contributors
20*ebfedea0SLionel Sambuc  *    may be used to endorse or promote products derived from this software
21*ebfedea0SLionel Sambuc  *    without specific prior written permission.
22*ebfedea0SLionel Sambuc  *
23*ebfedea0SLionel Sambuc  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
24*ebfedea0SLionel Sambuc  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25*ebfedea0SLionel Sambuc  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26*ebfedea0SLionel Sambuc  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
27*ebfedea0SLionel Sambuc  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28*ebfedea0SLionel Sambuc  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29*ebfedea0SLionel Sambuc  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30*ebfedea0SLionel Sambuc  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31*ebfedea0SLionel Sambuc  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32*ebfedea0SLionel Sambuc  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33*ebfedea0SLionel Sambuc  * SUCH DAMAGE.
34*ebfedea0SLionel Sambuc  */
35*ebfedea0SLionel Sambuc 
36*ebfedea0SLionel Sambuc #include "krb5_locl.h"
37*ebfedea0SLionel Sambuc 
38*ebfedea0SLionel Sambuc /**
39*ebfedea0SLionel Sambuc  * Generate subkey, from keyblock
40*ebfedea0SLionel Sambuc  *
41*ebfedea0SLionel Sambuc  * @param context kerberos context
42*ebfedea0SLionel Sambuc  * @param key session key
43*ebfedea0SLionel Sambuc  * @param etype encryption type of subkey, if ETYPE_NULL, use key's enctype
44*ebfedea0SLionel Sambuc  * @param subkey returned new, free with krb5_free_keyblock().
45*ebfedea0SLionel Sambuc  *
46*ebfedea0SLionel Sambuc  * @return 0 on success or a Kerberos 5 error code
47*ebfedea0SLionel Sambuc  *
48*ebfedea0SLionel Sambuc * @ingroup krb5_crypto
49*ebfedea0SLionel Sambuc  */
50*ebfedea0SLionel Sambuc 
51*ebfedea0SLionel Sambuc KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
krb5_generate_subkey_extended(krb5_context context,const krb5_keyblock * key,krb5_enctype etype,krb5_keyblock ** subkey)52*ebfedea0SLionel Sambuc krb5_generate_subkey_extended(krb5_context context,
53*ebfedea0SLionel Sambuc 			      const krb5_keyblock *key,
54*ebfedea0SLionel Sambuc 			      krb5_enctype etype,
55*ebfedea0SLionel Sambuc 			      krb5_keyblock **subkey)
56*ebfedea0SLionel Sambuc {
57*ebfedea0SLionel Sambuc     krb5_error_code ret;
58*ebfedea0SLionel Sambuc 
59*ebfedea0SLionel Sambuc     ALLOC(*subkey, 1);
60*ebfedea0SLionel Sambuc     if (*subkey == NULL) {
61*ebfedea0SLionel Sambuc 	krb5_set_error_message(context, ENOMEM,N_("malloc: out of memory", ""));
62*ebfedea0SLionel Sambuc 	return ENOMEM;
63*ebfedea0SLionel Sambuc     }
64*ebfedea0SLionel Sambuc 
65*ebfedea0SLionel Sambuc     if (etype == ETYPE_NULL)
66*ebfedea0SLionel Sambuc 	etype = key->keytype; /* use session key etype */
67*ebfedea0SLionel Sambuc 
68*ebfedea0SLionel Sambuc     /* XXX should we use the session key as input to the RF? */
69*ebfedea0SLionel Sambuc     ret = krb5_generate_random_keyblock(context, etype, *subkey);
70*ebfedea0SLionel Sambuc     if (ret != 0) {
71*ebfedea0SLionel Sambuc 	free(*subkey);
72*ebfedea0SLionel Sambuc 	*subkey = NULL;
73*ebfedea0SLionel Sambuc     }
74*ebfedea0SLionel Sambuc 
75*ebfedea0SLionel Sambuc     return ret;
76*ebfedea0SLionel Sambuc }
77*ebfedea0SLionel Sambuc 
78