2012-06-25 23:34:09 +08:00
|
|
|
/*
|
|
|
|
* QEMU Random Number Generator Backend
|
|
|
|
*
|
|
|
|
* Copyright IBM, Corp. 2012
|
|
|
|
*
|
|
|
|
* Authors:
|
|
|
|
* Anthony Liguori <aliguori@us.ibm.com>
|
|
|
|
*
|
|
|
|
* This work is licensed under the terms of the GNU GPL, version 2 or later.
|
|
|
|
* See the COPYING file in the top-level directory.
|
|
|
|
*/
|
|
|
|
|
2016-01-30 01:49:54 +08:00
|
|
|
#include "qemu/osdep.h"
|
2013-04-08 22:55:25 +08:00
|
|
|
#include "sysemu/rng-random.h"
|
|
|
|
#include "sysemu/rng.h"
|
include/qemu/osdep.h: Don't include qapi/error.h
Commit 57cb38b included qapi/error.h into qemu/osdep.h to get the
Error typedef. Since then, we've moved to include qemu/osdep.h
everywhere. Its file comment explains: "To avoid getting into
possible circular include dependencies, this file should not include
any other QEMU headers, with the exceptions of config-host.h,
compiler.h, os-posix.h and os-win32.h, all of which are doing a
similar job to this file and are under similar constraints."
qapi/error.h doesn't do a similar job, and it doesn't adhere to
similar constraints: it includes qapi-types.h. That's in excess of
100KiB of crap most .c files don't actually need.
Add the typedef to qemu/typedefs.h, and include that instead of
qapi/error.h. Include qapi/error.h in .c files that need it and don't
get it now. Include qapi-types.h in qom/object.h for uint16List.
Update scripts/clean-includes accordingly. Update it further to match
reality: replace config.h by config-target.h, add sysemu/os-posix.h,
sysemu/os-win32.h. Update the list of includes in the qemu/osdep.h
comment quoted above similarly.
This reduces the number of objects depending on qapi/error.h from "all
of them" to less than a third. Unfortunately, the number depending on
qapi-types.h shrinks only a little. More work is needed for that one.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
[Fix compilation without the spice devel packages. - Paolo]
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2016-03-14 16:01:28 +08:00
|
|
|
#include "qapi/error.h"
|
2012-12-18 01:19:43 +08:00
|
|
|
#include "qapi/qmp/qerror.h"
|
2012-12-18 01:20:00 +08:00
|
|
|
#include "qemu/main-loop.h"
|
2019-05-23 22:35:07 +08:00
|
|
|
#include "qemu/module.h"
|
2012-06-25 23:34:09 +08:00
|
|
|
|
2016-04-15 09:36:08 +08:00
|
|
|
struct RngRandom
|
2012-06-25 23:34:09 +08:00
|
|
|
{
|
|
|
|
RngBackend parent;
|
|
|
|
|
|
|
|
int fd;
|
|
|
|
char *filename;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A simple and incomplete backend to request entropy from /dev/random.
|
|
|
|
*
|
|
|
|
* This backend exposes an additional "filename" property that can be used to
|
|
|
|
* set the filename to use to open the backend.
|
|
|
|
*/
|
|
|
|
|
|
|
|
static void entropy_available(void *opaque)
|
|
|
|
{
|
2016-04-15 09:36:08 +08:00
|
|
|
RngRandom *s = RNG_RANDOM(opaque);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
2016-03-03 21:16:11 +08:00
|
|
|
while (!QSIMPLEQ_EMPTY(&s->parent.requests)) {
|
|
|
|
RngRequest *req = QSIMPLEQ_FIRST(&s->parent.requests);
|
2016-03-03 16:37:18 +08:00
|
|
|
ssize_t len;
|
2012-06-25 23:34:09 +08:00
|
|
|
|
2016-03-03 16:37:18 +08:00
|
|
|
len = read(s->fd, req->data, req->size);
|
|
|
|
if (len < 0 && errno == EAGAIN) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
g_assert(len != -1);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
2016-03-03 16:37:18 +08:00
|
|
|
req->receive_entropy(req->opaque, req->data, len);
|
|
|
|
|
|
|
|
rng_backend_finalize_request(&s->parent, req);
|
|
|
|
}
|
|
|
|
|
|
|
|
/* We've drained all requests, the fd handler can be reset. */
|
2012-06-25 23:34:09 +08:00
|
|
|
qemu_set_fd_handler(s->fd, NULL, NULL, NULL);
|
|
|
|
}
|
|
|
|
|
2016-03-03 16:37:18 +08:00
|
|
|
static void rng_random_request_entropy(RngBackend *b, RngRequest *req)
|
2012-06-25 23:34:09 +08:00
|
|
|
{
|
2016-04-15 09:36:08 +08:00
|
|
|
RngRandom *s = RNG_RANDOM(b);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
2016-03-03 21:16:11 +08:00
|
|
|
if (QSIMPLEQ_EMPTY(&s->parent.requests)) {
|
2016-03-03 16:37:18 +08:00
|
|
|
/* If there are no pending requests yet, we need to
|
|
|
|
* install our fd handler. */
|
|
|
|
qemu_set_fd_handler(s->fd, entropy_available, NULL, s);
|
2012-06-25 23:34:09 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static void rng_random_opened(RngBackend *b, Error **errp)
|
|
|
|
{
|
2016-04-15 09:36:08 +08:00
|
|
|
RngRandom *s = RNG_RANDOM(b);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
|
|
|
if (s->filename == NULL) {
|
2015-03-17 18:54:50 +08:00
|
|
|
error_setg(errp, QERR_INVALID_PARAMETER_VALUE,
|
|
|
|
"filename", "a valid filename");
|
2012-06-25 23:34:09 +08:00
|
|
|
} else {
|
2020-07-21 20:25:21 +08:00
|
|
|
s->fd = qemu_open_old(s->filename, O_RDONLY | O_NONBLOCK);
|
2012-06-25 23:34:09 +08:00
|
|
|
if (s->fd == -1) {
|
2013-06-08 02:28:02 +08:00
|
|
|
error_setg_file_open(errp, errno, s->filename);
|
2012-06-25 23:34:09 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static char *rng_random_get_filename(Object *obj, Error **errp)
|
|
|
|
{
|
2016-04-15 09:36:08 +08:00
|
|
|
RngRandom *s = RNG_RANDOM(obj);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
2014-12-04 17:26:55 +08:00
|
|
|
return g_strdup(s->filename);
|
2012-06-25 23:34:09 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
static void rng_random_set_filename(Object *obj, const char *filename,
|
|
|
|
Error **errp)
|
|
|
|
{
|
|
|
|
RngBackend *b = RNG_BACKEND(obj);
|
2016-04-15 09:36:08 +08:00
|
|
|
RngRandom *s = RNG_RANDOM(obj);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
|
|
|
if (b->opened) {
|
2015-03-17 18:54:50 +08:00
|
|
|
error_setg(errp, QERR_PERMISSION_DENIED);
|
2012-06-25 23:34:09 +08:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2014-05-31 04:02:18 +08:00
|
|
|
g_free(s->filename);
|
2012-06-25 23:34:09 +08:00
|
|
|
s->filename = g_strdup(filename);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void rng_random_init(Object *obj)
|
|
|
|
{
|
2016-04-15 09:36:08 +08:00
|
|
|
RngRandom *s = RNG_RANDOM(obj);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
VirtIO-RNG: Update default entropy source to `/dev/urandom`
When QEMU exposes a VirtIO-RNG device to the guest, that device needs a
source of entropy, and that source needs to be "non-blocking", like
`/dev/urandom`. However, currently QEMU defaults to the problematic
`/dev/random`, which on Linux is "blocking" (as in, it waits until
sufficient entropy is available).
Why prefer `/dev/urandom` over `/dev/random`?
---------------------------------------------
The man pages of urandom(4) and random(4) state:
"The /dev/random device is a legacy interface which dates back to a
time where the cryptographic primitives used in the implementation
of /dev/urandom were not widely trusted. It will return random
bytes only within the estimated number of bits of fresh noise in the
entropy pool, blocking if necessary. /dev/random is suitable for
applications that need high quality randomness, and can afford
indeterminate delays."
Further, the "Usage" section of the said man pages state:
"The /dev/random interface is considered a legacy interface, and
/dev/urandom is preferred and sufficient in all use cases, with the
exception of applications which require randomness during early boot
time; for these applications, getrandom(2) must be used instead,
because it will block until the entropy pool is initialized.
"If a seed file is saved across reboots as recommended below (all
major Linux distributions have done this since 2000 at least), the
output is cryptographically secure against attackers without local
root access as soon as it is reloaded in the boot sequence, and
perfectly adequate for network encryption session keys. Since reads
from /dev/random may block, users will usually want to open it in
nonblocking mode (or perform a read with timeout), and provide some
sort of user notification if the desired entropy is not immediately
available."
And refer to random(7) for a comparison of `/dev/random` and
`/dev/urandom`.
What about other OSes?
----------------------
`/dev/urandom` exists and works on OS-X, FreeBSD, DragonFlyBSD, NetBSD
and OpenBSD, which cover all the non-Linux platforms we explicitly
support, aside from Windows.
On Windows `/dev/random` doesn't work either so we don't regress.
This is actually another argument in favour of using the newly
proposed 'rng-builtin' backend by default, as that will work on
Windows.
- - -
Given the above, change the entropy source for VirtIO-RNG device to
`/dev/urandom`.
Related discussion in these[1][2] past threads.
[1] https://lists.nongnu.org/archive/html/qemu-devel/2018-06/msg08335.html
-- "RNG: Any reason QEMU doesn't default to `/dev/urandom`?"
[2] https://lists.nongnu.org/archive/html/qemu-devel/2018-09/msg02724.html
-- "[RFC] Virtio RNG: Consider changing the default entropy source to
/dev/urandom"
Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Laurent Vivier <lvivier@redhat.com>
Message-Id: <20190529143106.11789-2-lvivier@redhat.com>
Signed-off-by: Laurent Vivier <laurent@vivier.eu>
2019-05-29 22:31:03 +08:00
|
|
|
s->filename = g_strdup("/dev/urandom");
|
2013-12-21 06:21:06 +08:00
|
|
|
s->fd = -1;
|
2012-06-25 23:34:09 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
static void rng_random_finalize(Object *obj)
|
|
|
|
{
|
2016-04-15 09:36:08 +08:00
|
|
|
RngRandom *s = RNG_RANDOM(obj);
|
2012-06-25 23:34:09 +08:00
|
|
|
|
|
|
|
if (s->fd != -1) {
|
2013-12-21 06:21:06 +08:00
|
|
|
qemu_set_fd_handler(s->fd, NULL, NULL, NULL);
|
2013-03-01 20:53:55 +08:00
|
|
|
qemu_close(s->fd);
|
2012-06-25 23:34:09 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
g_free(s->filename);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void rng_random_class_init(ObjectClass *klass, void *data)
|
|
|
|
{
|
|
|
|
RngBackendClass *rbc = RNG_BACKEND_CLASS(klass);
|
|
|
|
|
|
|
|
rbc->request_entropy = rng_random_request_entropy;
|
|
|
|
rbc->opened = rng_random_opened;
|
2020-09-22 06:10:25 +08:00
|
|
|
object_class_property_add_str(klass, "filename",
|
|
|
|
rng_random_get_filename,
|
|
|
|
rng_random_set_filename);
|
|
|
|
|
2012-06-25 23:34:09 +08:00
|
|
|
}
|
|
|
|
|
2013-01-10 23:19:07 +08:00
|
|
|
static const TypeInfo rng_random_info = {
|
2012-06-25 23:34:09 +08:00
|
|
|
.name = TYPE_RNG_RANDOM,
|
|
|
|
.parent = TYPE_RNG_BACKEND,
|
2016-04-15 09:36:08 +08:00
|
|
|
.instance_size = sizeof(RngRandom),
|
2012-06-25 23:34:09 +08:00
|
|
|
.class_init = rng_random_class_init,
|
|
|
|
.instance_init = rng_random_init,
|
|
|
|
.instance_finalize = rng_random_finalize,
|
|
|
|
};
|
|
|
|
|
|
|
|
static void register_types(void)
|
|
|
|
{
|
|
|
|
type_register_static(&rng_random_info);
|
|
|
|
}
|
|
|
|
|
|
|
|
type_init(register_types);
|