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.1 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 25 /** 26 * qcrypto_random_bytes: 27 * @buf: the buffer to fill 28 * @buflen: length of @buf in bytes 29 * @errp: pointer to a NULL-initialized error object 30 * 31 * Fill @buf with @buflen bytes of cryptographically strong 32 * random data 33 * 34 * Returns 0 on success, -1 on error 35 */ 36 int qcrypto_random_bytes(void *buf, 37 size_t buflen, 38 Error **errp); 39 40 /** 41 * qcrypto_random_init: 42 * @errp: pointer to a NULL-initialized error object 43 * 44 * Initializes the handles used by qcrypto_random_bytes 45 * 46 * Returns 0 on success, -1 on error 47 */ 48 int qcrypto_random_init(Error **errp); 49 50 #endif /* QCRYPTO_RANDOM_H */ 51