NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
random.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2013-2021 Regents of the University of California.
4  *
5  * This file is part of ndn-cxx library (NDN C++ library with eXperimental eXtensions).
6  *
7  * ndn-cxx library is free software: you can redistribute it and/or modify it under the
8  * terms of the GNU Lesser General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later version.
10  *
11  * ndn-cxx library is distributed in the hope that it will be useful, but WITHOUT ANY
12  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
13  * PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
14  *
15  * You should have received copies of the GNU General Public License and GNU Lesser
16  * General Public License along with ndn-cxx, e.g., in COPYING.md file. If not, see
17  * <http://www.gnu.org/licenses/>.
18  *
19  * See AUTHORS.md for complete list of ndn-cxx authors and contributors.
20  */
21 
22 #include "ndn-cxx/util/random.hpp"
24 
25 namespace ndn {
26 namespace random {
27 
28 uint32_t
30 {
31  uint32_t random;
32  generateSecureBytes({reinterpret_cast<uint8_t*>(&random), sizeof(random)});
33  return random;
34 }
35 
36 uint64_t
38 {
39  uint64_t random;
40  generateSecureBytes({reinterpret_cast<uint8_t*>(&random), sizeof(random)});
41  return random;
42 }
43 
44 void
45 generateSecureBytes(span<uint8_t> buf)
46 {
47  if (RAND_bytes(buf.data(), buf.size()) != 1) {
48  NDN_THROW(std::runtime_error("Failed to generate random bytes (error code " +
49  to_string(ERR_get_error()) + ")"));
50  }
51 }
52 
55 {
56  thread_local std::mt19937 rng = [] {
57  std::random_device rd;
58  // seed with 256 bits of entropy
59  std::seed_seq seeds{rd(), rd(), rd(), rd(), rd(), rd(), rd(), rd()};
60  return std::mt19937{seeds};
61  }();
62  return rng;
63 }
64 
65 uint32_t
67 {
68  thread_local std::uniform_int_distribution<uint32_t> distribution;
69  return distribution(getRandomNumberEngine());
70 }
71 
72 uint64_t
74 {
75  thread_local std::uniform_int_distribution<uint64_t> distribution;
76  return distribution(getRandomNumberEngine());
77 }
78 
79 } // namespace random
80 } // namespace ndn
Copyright (c) 2011-2015 Regents of the University of California.
uint64_t generateSecureWord64()
Generate a cryptographically secure random integer from the range [0, 2^64)
Definition: random.cpp:37
std::string to_string(const T &val)
Definition: backports.hpp:86
std::mt19937 RandomNumberEngine
Definition: random.hpp:57
void generateSecureBytes(span< uint8_t > buf)
Fill buffer with cryptographically secure random bytes.
Definition: random.cpp:45
#define NDN_THROW(e)
Definition: exception.hpp:61
uint32_t generateWord32()
Generate a non-cryptographically-secure random integer in the range [0, 2^32)
Definition: random.cpp:66
uint32_t generateSecureWord32()
Generate a cryptographically secure random integer from the range [0, 2^32)
Definition: random.cpp:29
RandomNumberEngine & getRandomNumberEngine()
Returns a reference to a thread-local instance of a properly seeded PRNG.
Definition: random.cpp:54
uint64_t generateWord64()
Generate a non-cryptographically-secure random integer in the range [0, 2^64)
Definition: random.cpp:73