1 /* 2 * QEMU Crypto random number provider 3 * 4 * Copyright (c) 2015-2016 Red Hat, Inc. 5 * 6 * This library is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU Lesser General Public 8 * License as published by the Free Software Foundation; either 9 * version 2 of the License, or (at your option) any later version. 10 * 11 * This library is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14 * Lesser General Public License for more details. 15 * 16 * You should have received a copy of the GNU Lesser General Public 17 * License along with this library; if not, see <http://www.gnu.org/licenses/>. 18 * 19 */ 20 21 #ifndef QCRYPTO_RANDOM_H 22 #define QCRYPTO_RANDOM_H 23 24 #include "qemu-common.h" 25 26 /** 27 * qcrypto_random_bytes: 28 * @buf: the buffer to fill 29 * @buflen: length of @buf in bytes 30 * @errp: pointer to a NULL-initialized error object 31 * 32 * Fill @buf with @buflen bytes of cryptographically strong 33 * random data 34 * 35 * Returns 0 on success, -1 on error 36 */ 37 int qcrypto_random_bytes(uint8_t *buf, 38 size_t buflen, 39 Error **errp); 40 41 /** 42 * qcrypto_random_init: 43 * @errp: pointer to a NULL-initialized error object 44 * 45 * Initializes the handles used by qcrypto_random_bytes 46 * 47 * Returns 0 on success, -1 on error 48 */ 49 int qcrypto_random_init(Error **errp); 50 51 #endif /* QCRYPTO_RANDOM_H */ 52