diff options
| author | Steven Fackler <[email protected]> | 2017-09-28 23:56:03 -0400 |
|---|---|---|
| committer | GitHub <[email protected]> | 2017-09-28 23:56:03 -0400 |
| commit | c3fc4944276182cd4d030509f07febfc31e874ff (patch) | |
| tree | db01d713d2245785768c08bf4d681ef3aa198d61 /openssl | |
| parent | Merge pull request #738 from johnthagen/readme (diff) | |
| parent | Fix doc test and move external documentation link to rand_bytes function (diff) | |
| download | rust-openssl-c3fc4944276182cd4d030509f07febfc31e874ff.tar.xz rust-openssl-c3fc4944276182cd4d030509f07febfc31e874ff.zip | |
Merge pull request #737 from johnthagen/rand
Document rand module
Diffstat (limited to 'openssl')
| -rw-r--r-- | openssl/src/rand.rs | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/openssl/src/rand.rs b/openssl/src/rand.rs index c1c49e7b..da52ef5f 100644 --- a/openssl/src/rand.rs +++ b/openssl/src/rand.rs @@ -1,9 +1,37 @@ +//! Utilities for secure random number generation. +//! +//! # Examples +//! +//! To generate a buffer with cryptographically strong bytes: +//! +//! ``` +//! use openssl::rand::rand_bytes; +//! +//! let mut buf = [0; 256]; +//! rand_bytes(&mut buf).unwrap(); +//! ``` use libc::c_int; use ffi; use cvt; use error::ErrorStack; +/// Fill buffer with cryptographically strong pseudo-random bytes. +/// +/// # Examples +/// +/// To generate a buffer with cryptographically strong bytes: +/// +/// ``` +/// use openssl::rand::rand_bytes; +/// +/// let mut buf = [0; 256]; +/// rand_bytes(&mut buf).unwrap(); +/// ``` +/// +/// # External OpenSSL Documentation +/// +/// [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(); |