Debian Codegraph @

.cargo/vendor/getrandom/src/backends.rs

raw
1 //! System-specific implementations.
2 //!
3 //! This module should provide `fill_inner` with the signature
4 //! `fn fill_inner(dest: &mut [MaybeUninit<u8>]) -> Result<(), Error>`.
5 //! The function MUST fully initialize `dest` when `Ok(())` is returned;
6 //! the function may need to use `sanitizer::unpoison` as well.
7 //! The function MUST NOT ever write uninitialized bytes into `dest`,
8 //! regardless of what value it returns.
9
10 cfg_if! {
11 if #[cfg(getrandom_backend = "custom")] {
12 mod custom;
13 pub use custom::*;
14 } else if #[cfg(getrandom_backend = "linux_getrandom")] {
15 mod getrandom;
16 mod sanitizer;
17 pub use getrandom::*;
18 } else if #[cfg(getrandom_backend = "linux_raw")] {
19 mod linux_raw;
20 mod sanitizer;
21 pub use linux_raw::*;
22 } else if #[cfg(getrandom_backend = "rdrand")] {
23 mod rdrand;
24 pub use rdrand::*;
25 } else if #[cfg(getrandom_backend = "rndr")] {
26 mod rndr;
27 pub use rndr::*;
28 } else if #[cfg(getrandom_backend = "efi_rng")] {
29 mod efi_rng;
30 pub use efi_rng::*;
31 } else if #[cfg(getrandom_backend = "windows_legacy")] {
32 mod windows_legacy;
33 pub use windows_legacy::*;
34 } else if #[cfg(getrandom_backend = "wasm_js")] {
35 cfg_if! {
36 if #[cfg(feature = "wasm_js")] {
37 mod wasm_js;
38 pub use wasm_js::*;
39 } else {
40 compile_error!(concat!(
41 "The \"wasm_js\" backend requires the `wasm_js` feature \
42 for `getrandom`. For more information see: \
43 https://docs.rs/getrandom/", env!("CARGO_PKG_VERSION"), "/#webassembly-support"
44 ));
45 }
46 }
47 } else if #[cfg(getrandom_backend = "unsupported")] {
48 mod unsupported;
49 pub use unsupported::*;
50 } else if #[cfg(all(target_os = "linux", target_env = ""))] {
51 mod linux_raw;
52 mod sanitizer;
53 pub use linux_raw::*;
54 } else if #[cfg(target_os = "espidf")] {
55 mod esp_idf;
56 pub use esp_idf::*;
57 } else if #[cfg(any(
58 target_os = "haiku",
59 target_os = "redox",
60 target_os = "nto",
61 target_os = "aix",
62 ))] {
63 mod use_file;
64 pub use use_file::*;
65 } else if #[cfg(any(
66 target_os = "macos",
67 target_os = "openbsd",
68 target_os = "vita",
69 target_os = "emscripten",
70 ))] {
71 mod getentropy;
72 pub use getentropy::*;
73 } else if #[cfg(any(
74 // Rust supports Android API level 19 (KitKat) [0] and the next upgrade targets
75 // level 21 (Lollipop) [1], while `getrandom(2)` was added only in
76 // level 23 (Marshmallow). Note that it applies only to the "old" `target_arch`es,
77 // RISC-V Android targets sufficiently new API level, same will apply for potential
78 // new Android `target_arch`es.
79 // [0]: https://blog.rust-lang.org/2023/01/09/android-ndk-update-r25.html
80 // [1]: https://github.com/rust-lang/rust/pull/120593
81 all(
82 target_os = "android",
83 any(
84 target_arch = "aarch64",
85 target_arch = "arm",
86 target_arch = "x86",
87 target_arch = "x86_64",
88 ),
89 ),
90 // Only on these `target_arch`es Rust supports Linux kernel versions (3.2+)
91 // that precede the version (3.17) in which `getrandom(2)` was added:
92 // https://doc.rust-lang.org/stable/rustc/platform-support.html
93 all(
94 target_os = "linux",
95 any(
96 target_arch = "aarch64",
97 target_arch = "arm",
98 target_arch = "powerpc",
99 target_arch = "powerpc64",
100 target_arch = "s390x",
101 target_arch = "x86",
102 target_arch = "x86_64",
103 // Minimum supported Linux kernel version for MUSL targets
104 // is not specified explicitly (as of Rust 1.77) and they
105 // are used in practice to target pre-3.17 kernels.
106 all(
107 target_env = "musl",
108 not(
109 any(
110 target_arch = "riscv64",
111 target_arch = "riscv32",
112 ),
113 ),
114 ),
115 ),
116 )
117 ))] {
118 mod use_file;
119 mod linux_android_with_fallback;
120 mod sanitizer;
121 pub use linux_android_with_fallback::*;
122 } else if #[cfg(any(
123 target_os = "android",
124 target_os = "linux",
125 target_os = "dragonfly",
126 target_os = "freebsd",
127 target_os = "hurd",
128 target_os = "illumos",
129 target_os = "cygwin",
130 // Check for target_arch = "arm" to only include the 3DS. Does not
131 // include the Nintendo Switch (which is target_arch = "aarch64").
132 all(target_os = "horizon", target_arch = "arm"),
133 ))] {
134 mod getrandom;
135 #[cfg(any(target_os = "android", target_os = "linux"))]
136 mod sanitizer;
137 pub use getrandom::*;
138 } else if #[cfg(target_os = "solaris")] {
139 mod solaris;
140 pub use solaris::*;
141 } else if #[cfg(target_os = "netbsd")] {
142 mod netbsd;
143 pub use netbsd::*;
144 } else if #[cfg(target_os = "fuchsia")] {
145 mod fuchsia;
146 pub use fuchsia::*;
147 } else if #[cfg(any(
148 target_os = "ios",
149 target_os = "visionos",
150 target_os = "watchos",
151 target_os = "tvos",
152 ))] {
153 mod apple_other;
154 pub use apple_other::*;
155 } else if #[cfg(all(target_arch = "wasm32", target_os = "wasi"))] {
156 cfg_if! {
157 if #[cfg(target_env = "p1")] {
158 mod wasi_p1;
159 pub use wasi_p1::*;
160 } else if #[cfg(target_env = "p2")] {
161 mod wasi_p2;
162 pub use wasi_p2::*;
163 } else {
164 compile_error!(
165 "Unknown version of WASI (only previews 1 and 2 are supported) \
166 or Rust version older than 1.80 was used"
167 );
168 }
169 }
170 } else if #[cfg(target_os = "hermit")] {
171 mod hermit;
172 pub use hermit::*;
173 } else if #[cfg(target_os = "vxworks")] {
174 mod vxworks;
175 pub use vxworks::*;
176 } else if #[cfg(target_os = "solid_asp3")] {
177 mod solid;
178 pub use solid::*;
179 } else if #[cfg(all(windows, target_vendor = "win7"))] {
180 mod windows_legacy;
181 pub use windows_legacy::*;
182 } else if #[cfg(windows)] {
183 mod windows;
184 pub use windows::*;
185 } else if #[cfg(all(target_arch = "x86_64", target_env = "sgx"))] {
186 mod rdrand;
187 pub use rdrand::*;
188 } else if #[cfg(all(target_arch = "wasm32", any(target_os = "unknown", target_os = "none")))] {
189 cfg_if! {
190 if #[cfg(feature = "wasm_js")] {
191 mod wasm_js;
192 pub use wasm_js::*;
193 } else {
194 compile_error!(concat!(
195 "The wasm32-unknown-unknown targets are not supported by default; \
196 you may need to enable the \"wasm_js\" configuration flag. Note \
197 that enabling the `wasm_js` feature flag alone is insufficient. \
198 For more information see: \
199 https://docs.rs/getrandom/", env!("CARGO_PKG_VERSION"), "/#webassembly-support"
200 ));
201 }
202 }
203 } else {
204 compile_error!(concat!(
205 "target is not supported. You may need to define a custom backend see: \
206 https://docs.rs/getrandom/", env!("CARGO_PKG_VERSION"), "/#custom-backend"
207 ));
208 }
209 }