Loading...
1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * Randomness driver for virtio
4 * Copyright (C) 2007, 2008 Rusty Russell IBM Corporation
5 */
6
7#include <asm/barrier.h>
8#include <linux/err.h>
9#include <linux/hw_random.h>
10#include <linux/scatterlist.h>
11#include <linux/spinlock.h>
12#include <linux/virtio.h>
13#include <linux/virtio_rng.h>
14#include <linux/module.h>
15#include <linux/slab.h>
16
17static DEFINE_IDA(rng_index_ida);
18
19struct virtrng_info {
20 struct hwrng hwrng;
21 struct virtqueue *vq;
22 char name[25];
23 int index;
24 bool hwrng_register_done;
25 bool hwrng_removed;
26 /* data transfer */
27 struct completion have_data;
28 unsigned int data_avail;
29 unsigned int data_idx;
30 /* minimal size returned by rng_buffer_size() */
31#if SMP_CACHE_BYTES < 32
32 u8 data[32];
33#else
34 u8 data[SMP_CACHE_BYTES];
35#endif
36};
37
38static void random_recv_done(struct virtqueue *vq)
39{
40 struct virtrng_info *vi = vq->vdev->priv;
41 unsigned int len;
42
43 /* We can get spurious callbacks, e.g. shared IRQs + virtio_pci. */
44 if (!virtqueue_get_buf(vi->vq, &len))
45 return;
46
47 smp_store_release(&vi->data_avail, len);
48 complete(&vi->have_data);
49}
50
51static void request_entropy(struct virtrng_info *vi)
52{
53 struct scatterlist sg;
54
55 reinit_completion(&vi->have_data);
56 vi->data_idx = 0;
57
58 sg_init_one(&sg, vi->data, sizeof(vi->data));
59
60 /* There should always be room for one buffer. */
61 virtqueue_add_inbuf(vi->vq, &sg, 1, vi->data, GFP_KERNEL);
62
63 virtqueue_kick(vi->vq);
64}
65
66static unsigned int copy_data(struct virtrng_info *vi, void *buf,
67 unsigned int size)
68{
69 size = min_t(unsigned int, size, vi->data_avail);
70 memcpy(buf, vi->data + vi->data_idx, size);
71 vi->data_idx += size;
72 vi->data_avail -= size;
73 if (vi->data_avail == 0)
74 request_entropy(vi);
75 return size;
76}
77
78static int virtio_read(struct hwrng *rng, void *buf, size_t size, bool wait)
79{
80 int ret;
81 struct virtrng_info *vi = (struct virtrng_info *)rng->priv;
82 unsigned int chunk;
83 size_t read;
84
85 if (vi->hwrng_removed)
86 return -ENODEV;
87
88 read = 0;
89
90 /* copy available data */
91 if (smp_load_acquire(&vi->data_avail)) {
92 chunk = copy_data(vi, buf, size);
93 size -= chunk;
94 read += chunk;
95 }
96
97 if (!wait)
98 return read;
99
100 /* We have already copied available entropy,
101 * so either size is 0 or data_avail is 0
102 */
103 while (size != 0) {
104 /* data_avail is 0 but a request is pending */
105 ret = wait_for_completion_killable(&vi->have_data);
106 if (ret < 0)
107 return ret;
108 /* if vi->data_avail is 0, we have been interrupted
109 * by a cleanup, but buffer stays in the queue
110 */
111 if (vi->data_avail == 0)
112 return read;
113
114 chunk = copy_data(vi, buf + read, size);
115 size -= chunk;
116 read += chunk;
117 }
118
119 return read;
120}
121
122static void virtio_cleanup(struct hwrng *rng)
123{
124 struct virtrng_info *vi = (struct virtrng_info *)rng->priv;
125
126 complete(&vi->have_data);
127}
128
129static int probe_common(struct virtio_device *vdev)
130{
131 int err, index;
132 struct virtrng_info *vi = NULL;
133
134 vi = kzalloc(sizeof(struct virtrng_info), GFP_KERNEL);
135 if (!vi)
136 return -ENOMEM;
137
138 vi->index = index = ida_alloc(&rng_index_ida, GFP_KERNEL);
139 if (index < 0) {
140 err = index;
141 goto err_ida;
142 }
143 sprintf(vi->name, "virtio_rng.%d", index);
144 init_completion(&vi->have_data);
145
146 vi->hwrng = (struct hwrng) {
147 .read = virtio_read,
148 .cleanup = virtio_cleanup,
149 .priv = (unsigned long)vi,
150 .name = vi->name,
151 };
152 vdev->priv = vi;
153
154 /* We expect a single virtqueue. */
155 vi->vq = virtio_find_single_vq(vdev, random_recv_done, "input");
156 if (IS_ERR(vi->vq)) {
157 err = PTR_ERR(vi->vq);
158 goto err_find;
159 }
160
161 virtio_device_ready(vdev);
162
163 /* we always have a pending entropy request */
164 request_entropy(vi);
165
166 return 0;
167
168err_find:
169 ida_free(&rng_index_ida, index);
170err_ida:
171 kfree(vi);
172 return err;
173}
174
175static void remove_common(struct virtio_device *vdev)
176{
177 struct virtrng_info *vi = vdev->priv;
178
179 vi->hwrng_removed = true;
180 vi->data_avail = 0;
181 vi->data_idx = 0;
182 complete(&vi->have_data);
183 if (vi->hwrng_register_done)
184 hwrng_unregister(&vi->hwrng);
185 virtio_reset_device(vdev);
186 vdev->config->del_vqs(vdev);
187 ida_free(&rng_index_ida, vi->index);
188 kfree(vi);
189}
190
191static int virtrng_probe(struct virtio_device *vdev)
192{
193 return probe_common(vdev);
194}
195
196static void virtrng_remove(struct virtio_device *vdev)
197{
198 remove_common(vdev);
199}
200
201static void virtrng_scan(struct virtio_device *vdev)
202{
203 struct virtrng_info *vi = vdev->priv;
204 int err;
205
206 err = hwrng_register(&vi->hwrng);
207 if (!err)
208 vi->hwrng_register_done = true;
209}
210
211static int virtrng_freeze(struct virtio_device *vdev)
212{
213 remove_common(vdev);
214 return 0;
215}
216
217static int virtrng_restore(struct virtio_device *vdev)
218{
219 int err;
220
221 err = probe_common(vdev);
222 if (!err) {
223 struct virtrng_info *vi = vdev->priv;
224
225 /*
226 * Set hwrng_removed to ensure that virtio_read()
227 * does not block waiting for data before the
228 * registration is complete.
229 */
230 vi->hwrng_removed = true;
231 err = hwrng_register(&vi->hwrng);
232 if (!err) {
233 vi->hwrng_register_done = true;
234 vi->hwrng_removed = false;
235 }
236 }
237
238 return err;
239}
240
241static const struct virtio_device_id id_table[] = {
242 { VIRTIO_ID_RNG, VIRTIO_DEV_ANY_ID },
243 { 0 },
244};
245
246static struct virtio_driver virtio_rng_driver = {
247 .driver.name = KBUILD_MODNAME,
248 .driver.owner = THIS_MODULE,
249 .id_table = id_table,
250 .probe = virtrng_probe,
251 .remove = virtrng_remove,
252 .scan = virtrng_scan,
253 .freeze = pm_sleep_ptr(virtrng_freeze),
254 .restore = pm_sleep_ptr(virtrng_restore),
255};
256
257module_virtio_driver(virtio_rng_driver);
258MODULE_DEVICE_TABLE(virtio, id_table);
259MODULE_DESCRIPTION("Virtio random number driver");
260MODULE_LICENSE("GPL");
1/*
2 * Randomness driver for virtio
3 * Copyright (C) 2007, 2008 Rusty Russell IBM Corporation
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18 */
19
20#include <linux/err.h>
21#include <linux/hw_random.h>
22#include <linux/scatterlist.h>
23#include <linux/spinlock.h>
24#include <linux/virtio.h>
25#include <linux/virtio_rng.h>
26#include <linux/module.h>
27
28static DEFINE_IDA(rng_index_ida);
29
30struct virtrng_info {
31 struct hwrng hwrng;
32 struct virtqueue *vq;
33 struct completion have_data;
34 char name[25];
35 unsigned int data_avail;
36 int index;
37 bool busy;
38 bool hwrng_register_done;
39 bool hwrng_removed;
40};
41
42static void random_recv_done(struct virtqueue *vq)
43{
44 struct virtrng_info *vi = vq->vdev->priv;
45
46 /* We can get spurious callbacks, e.g. shared IRQs + virtio_pci. */
47 if (!virtqueue_get_buf(vi->vq, &vi->data_avail))
48 return;
49
50 complete(&vi->have_data);
51}
52
53/* The host will fill any buffer we give it with sweet, sweet randomness. */
54static void register_buffer(struct virtrng_info *vi, u8 *buf, size_t size)
55{
56 struct scatterlist sg;
57
58 sg_init_one(&sg, buf, size);
59
60 /* There should always be room for one buffer. */
61 virtqueue_add_inbuf(vi->vq, &sg, 1, buf, GFP_KERNEL);
62
63 virtqueue_kick(vi->vq);
64}
65
66static int virtio_read(struct hwrng *rng, void *buf, size_t size, bool wait)
67{
68 int ret;
69 struct virtrng_info *vi = (struct virtrng_info *)rng->priv;
70
71 if (vi->hwrng_removed)
72 return -ENODEV;
73
74 if (!vi->busy) {
75 vi->busy = true;
76 init_completion(&vi->have_data);
77 register_buffer(vi, buf, size);
78 }
79
80 if (!wait)
81 return 0;
82
83 ret = wait_for_completion_killable(&vi->have_data);
84 if (ret < 0)
85 return ret;
86
87 vi->busy = false;
88
89 return vi->data_avail;
90}
91
92static void virtio_cleanup(struct hwrng *rng)
93{
94 struct virtrng_info *vi = (struct virtrng_info *)rng->priv;
95
96 if (vi->busy)
97 wait_for_completion(&vi->have_data);
98}
99
100static int probe_common(struct virtio_device *vdev)
101{
102 int err, index;
103 struct virtrng_info *vi = NULL;
104
105 vi = kzalloc(sizeof(struct virtrng_info), GFP_KERNEL);
106 if (!vi)
107 return -ENOMEM;
108
109 vi->index = index = ida_simple_get(&rng_index_ida, 0, 0, GFP_KERNEL);
110 if (index < 0) {
111 err = index;
112 goto err_ida;
113 }
114 sprintf(vi->name, "virtio_rng.%d", index);
115 init_completion(&vi->have_data);
116
117 vi->hwrng = (struct hwrng) {
118 .read = virtio_read,
119 .cleanup = virtio_cleanup,
120 .priv = (unsigned long)vi,
121 .name = vi->name,
122 .quality = 1000,
123 };
124 vdev->priv = vi;
125
126 /* We expect a single virtqueue. */
127 vi->vq = virtio_find_single_vq(vdev, random_recv_done, "input");
128 if (IS_ERR(vi->vq)) {
129 err = PTR_ERR(vi->vq);
130 goto err_find;
131 }
132
133 return 0;
134
135err_find:
136 ida_simple_remove(&rng_index_ida, index);
137err_ida:
138 kfree(vi);
139 return err;
140}
141
142static void remove_common(struct virtio_device *vdev)
143{
144 struct virtrng_info *vi = vdev->priv;
145
146 vi->hwrng_removed = true;
147 vi->data_avail = 0;
148 complete(&vi->have_data);
149 vdev->config->reset(vdev);
150 vi->busy = false;
151 if (vi->hwrng_register_done)
152 hwrng_unregister(&vi->hwrng);
153 vdev->config->del_vqs(vdev);
154 ida_simple_remove(&rng_index_ida, vi->index);
155 kfree(vi);
156}
157
158static int virtrng_probe(struct virtio_device *vdev)
159{
160 return probe_common(vdev);
161}
162
163static void virtrng_remove(struct virtio_device *vdev)
164{
165 remove_common(vdev);
166}
167
168static void virtrng_scan(struct virtio_device *vdev)
169{
170 struct virtrng_info *vi = vdev->priv;
171 int err;
172
173 err = hwrng_register(&vi->hwrng);
174 if (!err)
175 vi->hwrng_register_done = true;
176}
177
178#ifdef CONFIG_PM_SLEEP
179static int virtrng_freeze(struct virtio_device *vdev)
180{
181 remove_common(vdev);
182 return 0;
183}
184
185static int virtrng_restore(struct virtio_device *vdev)
186{
187 return probe_common(vdev);
188}
189#endif
190
191static struct virtio_device_id id_table[] = {
192 { VIRTIO_ID_RNG, VIRTIO_DEV_ANY_ID },
193 { 0 },
194};
195
196static struct virtio_driver virtio_rng_driver = {
197 .driver.name = KBUILD_MODNAME,
198 .driver.owner = THIS_MODULE,
199 .id_table = id_table,
200 .probe = virtrng_probe,
201 .remove = virtrng_remove,
202 .scan = virtrng_scan,
203#ifdef CONFIG_PM_SLEEP
204 .freeze = virtrng_freeze,
205 .restore = virtrng_restore,
206#endif
207};
208
209module_virtio_driver(virtio_rng_driver);
210MODULE_DEVICE_TABLE(virtio, id_table);
211MODULE_DESCRIPTION("Virtio random number driver");
212MODULE_LICENSE("GPL");