osrandom 0.1.1

An interface to the OS' secure random number generator
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

[![License BSD-2-Clause](https://img.shields.io/badge/License-BSD--2--Clause-blue.svg)](https://opensource.org/licenses/BSD-2-Clause)
[![License MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![docs.rs](https://docs.rs/osrandom/badge.svg)](https://docs.rs/osrandom)
[![crates.io](https://img.shields.io/crates/v/osrandom.svg)](https://crates.io/crates/crypto_api_osrandom)
[![Download numbers](https://img.shields.io/crates/d/osrandom.svg)](https://crates.io/crates/osrandom)
[![AppVeyor CI](https://ci.appveyor.com/api/projects/status/github/KizzyCode/osrandom-rust?svg=true)](https://ci.appveyor.com/project/KizzyCode/osrandom-rust)
[![dependency status](https://deps.rs/crate/osrandom/latest/status.svg)](https://deps.rs/crate/osrandom)


# osrandom
Welcome to `osrandom` 🎉

A really minimal wrapper around your operating system's cryptographically secure random number generator.


## APIs used
The following native APIs are used:
- macOS/iOS: `SecRandomCopyBytes` from the built-in `Security.framework`
- FreeBSD/OpenBSD/NetBSD: `arc4random_buf` (which does not use ARC4 anymore but a secure PRF like
  [ChaCha20](https://cr.yp.to/chacha.html))
- Windows: `CryptGenRandom` with `PROV_RSA_FULL` as provider
- Linux-GNU: `getrandom` for glibc versions >= 2.25 or `/dev/urandom` for ancient distributions
- Linux-MUSL: `/dev/urandom` for ancient distributions