2 * A virtio device implementing a hardware random number generator.
4 * Copyright 2012 Red Hat, Inc.
7 * This work is licensed under the terms of the GNU GPL, version 2 or
8 * (at your option) any later version. See the COPYING file in the
14 #include "qapi/qmp/qerror.h"
15 #include "hw/virtio/virtio.h"
16 #include "hw/virtio/virtio-rng.h"
17 #include "sysemu/rng.h"
19 static bool is_guest_ready(VirtIORNG *vrng)
21 VirtIODevice *vdev = VIRTIO_DEVICE(vrng);
22 if (virtio_queue_ready(vrng->vq)
23 && (vdev->status & VIRTIO_CONFIG_S_DRIVER_OK)) {
29 static size_t get_request_size(VirtQueue *vq, unsigned quota)
33 virtqueue_get_avail_bytes(vq, &in, &out, quota, 0);
37 static void virtio_rng_process(VirtIORNG *vrng);
39 /* Send data from a char device over to the guest */
40 static void chr_read(void *opaque, const void *buf, size_t size)
42 VirtIORNG *vrng = opaque;
43 VirtIODevice *vdev = VIRTIO_DEVICE(vrng);
44 VirtQueueElement elem;
48 if (!is_guest_ready(vrng)) {
52 vrng->quota_remaining -= size;
55 while (offset < size) {
56 if (!virtqueue_pop(vrng->vq, &elem)) {
59 len = iov_from_buf(elem.in_sg, elem.in_num,
60 0, buf + offset, size - offset);
63 virtqueue_push(vrng->vq, &elem, len);
65 virtio_notify(vdev, vrng->vq);
68 static void virtio_rng_process(VirtIORNG *vrng)
73 if (!is_guest_ready(vrng)) {
77 if (vrng->quota_remaining < 0) {
80 quota = MIN((uint64_t)vrng->quota_remaining, (uint64_t)UINT32_MAX);
82 size = get_request_size(vrng->vq, quota);
83 size = MIN(vrng->quota_remaining, size);
85 rng_backend_request_entropy(vrng->rng, size, chr_read, vrng);
89 static void handle_input(VirtIODevice *vdev, VirtQueue *vq)
91 VirtIORNG *vrng = VIRTIO_RNG(vdev);
92 virtio_rng_process(vrng);
95 static uint32_t get_features(VirtIODevice *vdev, uint32_t f)
100 static void virtio_rng_save(QEMUFile *f, void *opaque)
102 VirtIODevice *vdev = opaque;
104 virtio_save(vdev, f);
107 static int virtio_rng_load(QEMUFile *f, void *opaque, int version_id)
109 VirtIORNG *vrng = opaque;
110 VirtIODevice *vdev = VIRTIO_DEVICE(vrng);
112 if (version_id != 1) {
115 virtio_load(vdev, f);
117 /* We may have an element ready but couldn't process it due to a quota
118 * limit. Make sure to try again after live migration when the quota may
121 virtio_rng_process(vrng);
126 static void check_rate_limit(void *opaque)
128 VirtIORNG *vrng = opaque;
130 vrng->quota_remaining = vrng->conf.max_bytes;
131 virtio_rng_process(vrng);
132 qemu_mod_timer(vrng->rate_limit_timer,
133 qemu_get_clock_ms(vm_clock) + vrng->conf.period_ms);
136 static int virtio_rng_device_init(VirtIODevice *vdev)
138 DeviceState *qdev = DEVICE(vdev);
139 VirtIORNG *vrng = VIRTIO_RNG(vdev);
140 Error *local_err = NULL;
142 if (vrng->conf.rng == NULL) {
143 vrng->conf.default_backend = RNG_RANDOM(object_new(TYPE_RNG_RANDOM));
145 object_property_add_child(OBJECT(qdev),
147 OBJECT(vrng->conf.default_backend),
150 object_property_set_link(OBJECT(qdev),
151 OBJECT(vrng->conf.default_backend),
155 virtio_init(vdev, "virtio-rng", VIRTIO_ID_RNG, 0);
157 vrng->rng = vrng->conf.rng;
158 if (vrng->rng == NULL) {
159 qerror_report(QERR_INVALID_PARAMETER_VALUE, "rng", "a valid object");
163 rng_backend_open(vrng->rng, &local_err);
165 qerror_report_err(local_err);
166 error_free(local_err);
170 vrng->vq = virtio_add_queue(vdev, 8, handle_input);
172 assert(vrng->conf.max_bytes <= INT64_MAX);
173 vrng->quota_remaining = vrng->conf.max_bytes;
175 vrng->rate_limit_timer = qemu_new_timer_ms(vm_clock,
176 check_rate_limit, vrng);
178 qemu_mod_timer(vrng->rate_limit_timer,
179 qemu_get_clock_ms(vm_clock) + vrng->conf.period_ms);
181 register_savevm(qdev, "virtio-rng", -1, 1, virtio_rng_save,
182 virtio_rng_load, vrng);
187 static int virtio_rng_device_exit(DeviceState *qdev)
189 VirtIORNG *vrng = VIRTIO_RNG(qdev);
190 VirtIODevice *vdev = VIRTIO_DEVICE(qdev);
192 qemu_del_timer(vrng->rate_limit_timer);
193 qemu_free_timer(vrng->rate_limit_timer);
194 unregister_savevm(qdev, "virtio-rng", vrng);
195 virtio_cleanup(vdev);
199 static Property virtio_rng_properties[] = {
200 DEFINE_VIRTIO_RNG_PROPERTIES(VirtIORNG, conf),
201 DEFINE_PROP_END_OF_LIST(),
204 static void virtio_rng_class_init(ObjectClass *klass, void *data)
206 DeviceClass *dc = DEVICE_CLASS(klass);
207 VirtioDeviceClass *vdc = VIRTIO_DEVICE_CLASS(klass);
208 dc->exit = virtio_rng_device_exit;
209 dc->props = virtio_rng_properties;
210 set_bit(DEVICE_CATEGORY_MISC, dc->categories);
211 vdc->init = virtio_rng_device_init;
212 vdc->get_features = get_features;
215 static void virtio_rng_initfn(Object *obj)
217 VirtIORNG *vrng = VIRTIO_RNG(obj);
219 object_property_add_link(obj, "rng", TYPE_RNG_BACKEND,
220 (Object **)&vrng->conf.rng, NULL);
223 static const TypeInfo virtio_rng_info = {
224 .name = TYPE_VIRTIO_RNG,
225 .parent = TYPE_VIRTIO_DEVICE,
226 .instance_size = sizeof(VirtIORNG),
227 .instance_init = virtio_rng_initfn,
228 .class_init = virtio_rng_class_init,
231 static void virtio_register_types(void)
233 type_register_static(&virtio_rng_info);
236 type_init(virtio_register_types)