b917da4cbd
There are three backend impls provided. The preferred is gnutls, which is backed by nettle in modern distros. The gcrypt impl is provided for cases where QEMU build against gnutls is disabled, but crypto is still desired. No nettle impl is provided, since it is non-trivial to use the nettle APIs for random numbers. Users of nettle should ensure gnutls is enabled for QEMU. Reviewed-by: Fam Zheng <famz@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com> Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
45 lines
1.3 KiB
C
45 lines
1.3 KiB
C
/*
|
|
* QEMU Crypto random number provider
|
|
*
|
|
* Copyright (c) 2015-2016 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
|
|
#ifndef QCRYPTO_RANDOM_H__
|
|
#define QCRYPTO_RANDOM_H__
|
|
|
|
#include "qemu-common.h"
|
|
#include "qapi/error.h"
|
|
|
|
|
|
/**
|
|
* qcrypto_random_bytes:
|
|
* @buf: the buffer to fill
|
|
* @buflen: length of @buf in bytes
|
|
* @errp: pointer to a NULL-initialized error object
|
|
*
|
|
* Fill @buf with @buflen bytes of cryptographically strong
|
|
* random data
|
|
*
|
|
* Returns 0 on sucess, -1 on error
|
|
*/
|
|
int qcrypto_random_bytes(uint8_t *buf,
|
|
size_t buflen,
|
|
Error **errp);
|
|
|
|
|
|
#endif /* QCRYPTO_RANDOM_H__ */
|