| //! This module implements run-time feature detection. |
| //! |
| //! The `is_{arch}_feature_detected!("feature-name")` macros take the name of a |
| //! feature as a string-literal, and return a boolean indicating whether the |
| //! feature is enabled at run-time or not. |
| //! |
| //! These macros do two things: |
| //! * map the string-literal into an integer stored as a `Feature` enum, |
| //! * call a `os::check_for(x: Feature)` function that returns `true` if the |
| //! feature is enabled. |
| //! |
| //! The `Feature` enums are also implemented in the `arch/{target_arch}.rs` |
| //! modules. |
| //! |
| //! The `check_for` functions are, in general, Operating System dependent. Most |
| //! architectures do not allow user-space programs to query the feature bits |
| //! due to security concerns (x86 is the big exception). These functions are |
| //! implemented in the `os/{target_os}.rs` modules. |
| |
| #[macro_use] |
| mod error_macros; |
| |
| cfg_if! { |
| if #[cfg(any(target_arch = "x86", target_arch = "x86_64"))] { |
| #[path = "arch/x86.rs"] |
| #[macro_use] |
| mod arch; |
| } else if #[cfg(target_arch = "arm")] { |
| #[path = "arch/arm.rs"] |
| #[macro_use] |
| mod arch; |
| } else if #[cfg(target_arch = "aarch64")] { |
| #[path = "arch/aarch64.rs"] |
| #[macro_use] |
| mod arch; |
| } else if #[cfg(target_arch = "powerpc")] { |
| #[path = "arch/powerpc.rs"] |
| #[macro_use] |
| mod arch; |
| } else if #[cfg(target_arch = "powerpc64")] { |
| #[path = "arch/powerpc64.rs"] |
| #[macro_use] |
| mod arch; |
| } else if #[cfg(target_arch = "mips")] { |
| #[path = "arch/mips.rs"] |
| #[macro_use] |
| mod arch; |
| } else if #[cfg(target_arch = "mips64")] { |
| #[path = "arch/mips64.rs"] |
| #[macro_use] |
| mod arch; |
| } else { |
| // Unimplemented architecture: |
| mod arch { |
| pub enum Feature { |
| Null |
| } |
| } |
| } |
| } |
| pub use self::arch::Feature; |
| |
| mod bit; |
| mod cache; |
| |
| cfg_if! { |
| if #[cfg(any(target_arch = "x86", target_arch = "x86_64"))] { |
| // On x86/x86_64 no OS specific functionality is required. |
| #[path = "os/x86.rs"] |
| mod os; |
| } else if #[cfg(all(target_os = "linux", feature = "use_std"))] { |
| #[path = "os/linux/mod.rs"] |
| mod os; |
| } else if #[cfg(target_os = "freebsd")] { |
| #[cfg(target_arch = "aarch64")] |
| #[path = "os/aarch64.rs"] |
| mod aarch64; |
| #[path = "os/freebsd/mod.rs"] |
| mod os; |
| } else { |
| #[path = "os/other.rs"] |
| mod os; |
| } |
| } |
| pub use self::os::check_for; |