2 * algif_rng: User-space interface for random number generators
4 * This file provides the user-space API for random number generators.
6 * Copyright (C) 2014, Stephan Mueller <smueller@chronox.de>
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, and the entire permission notice in its entirety,
13 * including the disclaimer of warranties.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
17 * 3. The name of the author may not be used to endorse or promote
18 * products derived from this software without specific prior
21 * ALTERNATIVELY, this product may be distributed under the terms of
22 * the GNU General Public License, in which case the provisions of the GPL2
23 * are required INSTEAD OF the above restrictions. (This clause is
24 * necessary due to a potential bad interaction between the GPL and
25 * the restrictions contained in a BSD-style copyright.)
27 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
28 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
29 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
30 * WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
31 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
33 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
34 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
35 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
36 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
37 * USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
41 #include <linux/module.h>
42 #include <crypto/rng.h>
43 #include <linux/random.h>
44 #include <crypto/if_alg.h>
45 #include <linux/net.h>
48 MODULE_LICENSE("GPL");
49 MODULE_AUTHOR("Stephan Mueller <smueller@chronox.de>");
50 MODULE_DESCRIPTION("User-space interface for random number generators");
55 struct crypto_rng
*drng
;
58 static int rng_recvmsg(struct socket
*sock
, struct msghdr
*msg
, size_t len
,
61 struct sock
*sk
= sock
->sk
;
62 struct alg_sock
*ask
= alg_sk(sk
);
63 struct rng_ctx
*ctx
= ask
->private;
74 * although not strictly needed, this is a precaution against coding
77 memset(result
, 0, len
);
80 * The enforcement of a proper seeding of an RNG is done within an
81 * RNG implementation. Some RNGs (DRBG, krng) do not need specific
82 * seeding as they automatically seed. The X9.31 DRNG will return
83 * an error if it was not seeded properly.
85 genlen
= crypto_rng_get_bytes(ctx
->drng
, result
, len
);
89 err
= memcpy_to_msg(msg
, result
, len
);
90 memzero_explicit(result
, len
);
92 return err
? err
: len
;
95 static struct proto_ops algif_rng_ops
= {
98 .connect
= sock_no_connect
,
99 .socketpair
= sock_no_socketpair
,
100 .getname
= sock_no_getname
,
101 .ioctl
= sock_no_ioctl
,
102 .listen
= sock_no_listen
,
103 .shutdown
= sock_no_shutdown
,
104 .getsockopt
= sock_no_getsockopt
,
105 .mmap
= sock_no_mmap
,
106 .bind
= sock_no_bind
,
107 .accept
= sock_no_accept
,
108 .setsockopt
= sock_no_setsockopt
,
109 .poll
= sock_no_poll
,
110 .sendmsg
= sock_no_sendmsg
,
111 .sendpage
= sock_no_sendpage
,
113 .release
= af_alg_release
,
114 .recvmsg
= rng_recvmsg
,
117 static void *rng_bind(const char *name
, u32 type
, u32 mask
)
119 return crypto_alloc_rng(name
, type
, mask
);
122 static void rng_release(void *private)
124 crypto_free_rng(private);
127 static void rng_sock_destruct(struct sock
*sk
)
129 struct alg_sock
*ask
= alg_sk(sk
);
130 struct rng_ctx
*ctx
= ask
->private;
132 sock_kfree_s(sk
, ctx
, ctx
->len
);
133 af_alg_release_parent(sk
);
136 static int rng_accept_parent(void *private, struct sock
*sk
)
139 struct alg_sock
*ask
= alg_sk(sk
);
140 unsigned int len
= sizeof(*ctx
);
142 ctx
= sock_kmalloc(sk
, len
, GFP_KERNEL
);
149 * No seeding done at that point -- if multiple accepts are
150 * done on one RNG instance, each resulting FD points to the same
156 sk
->sk_destruct
= rng_sock_destruct
;
161 static int rng_setkey(void *private, const u8
*seed
, unsigned int seedlen
)
164 * Check whether seedlen is of sufficient size is done in RNG
167 return crypto_rng_reset(private, (u8
*)seed
, seedlen
);
170 static const struct af_alg_type algif_type_rng
= {
172 .release
= rng_release
,
173 .accept
= rng_accept_parent
,
174 .setkey
= rng_setkey
,
175 .ops
= &algif_rng_ops
,
180 static int __init
rng_init(void)
182 return af_alg_register_type(&algif_type_rng
);
185 static void __exit
rng_exit(void)
187 int err
= af_alg_unregister_type(&algif_type_rng
);
191 module_init(rng_init
);
192 module_exit(rng_exit
);