Linux Audio

Check our new training course

Loading...
v3.1
 
  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
 27static struct virtqueue *vq;
 28static unsigned int data_avail;
 29static DECLARE_COMPLETION(have_data);
 30static bool busy;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 31
 32static void random_recv_done(struct virtqueue *vq)
 33{
 
 
 34	/* We can get spurious callbacks, e.g. shared IRQs + virtio_pci. */
 35	if (!virtqueue_get_buf(vq, &data_avail))
 36		return;
 37
 38	complete(&have_data);
 
 
 39}
 40
 41/* The host will fill any buffer we give it with sweet, sweet randomness. */
 42static void register_buffer(u8 *buf, size_t size)
 43{
 44	struct scatterlist sg;
 45
 46	sg_init_one(&sg, buf, size);
 
 
 
 
 47
 48	/* There should always be room for one buffer. */
 49	if (virtqueue_add_buf(vq, &sg, 0, 1, buf) < 0)
 50		BUG();
 51
 52	virtqueue_kick(vq);
 53}
 54
 55static int virtio_read(struct hwrng *rng, void *buf, size_t size, bool wait)
 
 56{
 
 
 
 
 
 
 
 
 57
 58	if (!busy) {
 59		busy = true;
 60		init_completion(&have_data);
 61		register_buffer(buf, size);
 
 
 
 
 
 
 
 
 
 
 
 
 
 62	}
 63
 64	if (!wait)
 65		return 0;
 66
 67	wait_for_completion(&have_data);
 68
 69	busy = false;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 70
 71	return data_avail;
 72}
 73
 74static void virtio_cleanup(struct hwrng *rng)
 75{
 76	if (busy)
 77		wait_for_completion(&have_data);
 
 78}
 79
 
 
 
 
 80
 81static struct hwrng virtio_hwrng = {
 82	.name		= "virtio",
 83	.cleanup	= virtio_cleanup,
 84	.read		= virtio_read,
 85};
 
 
 
 
 
 
 86
 87static int virtrng_probe(struct virtio_device *vdev)
 88{
 89	int err;
 
 
 
 
 90
 91	/* We expect a single virtqueue. */
 92	vq = virtio_find_single_vq(vdev, random_recv_done, "input");
 93	if (IS_ERR(vq))
 94		return PTR_ERR(vq);
 95
 96	err = hwrng_register(&virtio_hwrng);
 97	if (err) {
 98		vdev->config->del_vqs(vdev);
 99		return err;
100	}
101
 
 
 
 
 
102	return 0;
 
 
 
 
 
 
103}
104
105static void __devexit virtrng_remove(struct virtio_device *vdev)
106{
107	vdev->config->reset(vdev);
108	hwrng_unregister(&virtio_hwrng);
 
 
 
 
 
 
 
109	vdev->config->del_vqs(vdev);
 
 
 
 
 
 
 
110}
111
112static struct virtio_device_id id_table[] = {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
113	{ VIRTIO_ID_RNG, VIRTIO_DEV_ANY_ID },
114	{ 0 },
115};
116
117static struct virtio_driver virtio_rng_driver = {
118	.driver.name =	KBUILD_MODNAME,
119	.driver.owner =	THIS_MODULE,
120	.id_table =	id_table,
121	.probe =	virtrng_probe,
122	.remove =	__devexit_p(virtrng_remove),
 
 
 
 
 
123};
124
125static int __init init(void)
126{
127	return register_virtio_driver(&virtio_rng_driver);
128}
129
130static void __exit fini(void)
131{
132	unregister_virtio_driver(&virtio_rng_driver);
133}
134module_init(init);
135module_exit(fini);
136
137MODULE_DEVICE_TABLE(virtio, id_table);
138MODULE_DESCRIPTION("Virtio random number driver");
139MODULE_LICENSE("GPL");
v6.2
  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 <linux/err.h>
  8#include <linux/hw_random.h>
  9#include <linux/scatterlist.h>
 10#include <linux/spinlock.h>
 11#include <linux/virtio.h>
 12#include <linux/virtio_rng.h>
 13#include <linux/module.h>
 14#include <linux/slab.h>
 15
 16static DEFINE_IDA(rng_index_ida);
 17
 18struct virtrng_info {
 19	struct hwrng hwrng;
 20	struct virtqueue *vq;
 21	char name[25];
 22	int index;
 23	bool hwrng_register_done;
 24	bool hwrng_removed;
 25	/* data transfer */
 26	struct completion have_data;
 27	unsigned int data_avail;
 28	unsigned int data_idx;
 29	/* minimal size returned by rng_buffer_size() */
 30#if SMP_CACHE_BYTES < 32
 31	u8 data[32];
 32#else
 33	u8 data[SMP_CACHE_BYTES];
 34#endif
 35};
 36
 37static void random_recv_done(struct virtqueue *vq)
 38{
 39	struct virtrng_info *vi = vq->vdev->priv;
 40
 41	/* We can get spurious callbacks, e.g. shared IRQs + virtio_pci. */
 42	if (!virtqueue_get_buf(vi->vq, &vi->data_avail))
 43		return;
 44
 45	vi->data_idx = 0;
 46
 47	complete(&vi->have_data);
 48}
 49
 50static void request_entropy(struct virtrng_info *vi)
 
 51{
 52	struct scatterlist sg;
 53
 54	reinit_completion(&vi->have_data);
 55	vi->data_avail = 0;
 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 (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_simple_get(&rng_index_ida, 0, 0, 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_simple_remove(&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_simple_remove(&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
211#ifdef CONFIG_PM_SLEEP
212static int virtrng_freeze(struct virtio_device *vdev)
213{
214	remove_common(vdev);
215	return 0;
216}
217
218static int virtrng_restore(struct virtio_device *vdev)
219{
220	int err;
221
222	err = probe_common(vdev);
223	if (!err) {
224		struct virtrng_info *vi = vdev->priv;
225
226		/*
227		 * Set hwrng_removed to ensure that virtio_read()
228		 * does not block waiting for data before the
229		 * registration is complete.
230		 */
231		vi->hwrng_removed = true;
232		err = hwrng_register(&vi->hwrng);
233		if (!err) {
234			vi->hwrng_register_done = true;
235			vi->hwrng_removed = false;
236		}
237	}
238
239	return err;
240}
241#endif
242
243static const struct virtio_device_id id_table[] = {
244	{ VIRTIO_ID_RNG, VIRTIO_DEV_ANY_ID },
245	{ 0 },
246};
247
248static struct virtio_driver virtio_rng_driver = {
249	.driver.name =	KBUILD_MODNAME,
250	.driver.owner =	THIS_MODULE,
251	.id_table =	id_table,
252	.probe =	virtrng_probe,
253	.remove =	virtrng_remove,
254	.scan =		virtrng_scan,
255#ifdef CONFIG_PM_SLEEP
256	.freeze =	virtrng_freeze,
257	.restore =	virtrng_restore,
258#endif
259};
260
261module_virtio_driver(virtio_rng_driver);
 
 
 
 
 
 
 
 
 
 
 
262MODULE_DEVICE_TABLE(virtio, id_table);
263MODULE_DESCRIPTION("Virtio random number driver");
264MODULE_LICENSE("GPL");