53 lines
1.1 KiB
Rust
53 lines
1.1 KiB
Rust
//! Utilities for secure random number generation.
|
|
//!
|
|
//! # Examples
|
|
//!
|
|
//! To generate a buffer with cryptographically strong bytes:
|
|
//!
|
|
//! ```
|
|
//! use boring2::rand::rand_bytes;
|
|
//!
|
|
//! let mut buf = [0; 256];
|
|
//! rand_bytes(&mut buf).unwrap();
|
|
//! ```
|
|
use crate::ffi;
|
|
use libc::c_int;
|
|
|
|
use crate::cvt;
|
|
use crate::error::ErrorStack;
|
|
|
|
/// Fill buffer with cryptographically strong pseudo-random bytes.
|
|
///
|
|
/// This corresponds to [`RAND_bytes`].
|
|
///
|
|
/// # Examples
|
|
///
|
|
/// To generate a buffer with cryptographically strong bytes:
|
|
///
|
|
/// ```
|
|
/// use boring2::rand::rand_bytes;
|
|
///
|
|
/// let mut buf = [0; 256];
|
|
/// rand_bytes(&mut buf).unwrap();
|
|
/// ```
|
|
///
|
|
/// [`RAND_bytes`]: https://www.openssl.org/docs/man1.1.0/crypto/RAND_bytes.html
|
|
pub fn rand_bytes(buf: &mut [u8]) -> Result<(), ErrorStack> {
|
|
unsafe {
|
|
ffi::init();
|
|
assert!(buf.len() <= c_int::MAX as usize);
|
|
cvt(ffi::RAND_bytes(buf.as_mut_ptr(), buf.len())).map(|_| ())
|
|
}
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod tests {
|
|
use super::rand_bytes;
|
|
|
|
#[test]
|
|
fn test_rand_bytes() {
|
|
let mut buf = [0; 32];
|
|
rand_bytes(&mut buf).unwrap();
|
|
}
|
|
}
|