1 //! Performs autodetection of the host for the purposes of running 2 //! Cranelift to generate code to run on the same machine. 3 4 #![deny(missing_docs)] 5 6 use cranelift_codegen::isa; 7 use cranelift_codegen::settings::Configurable; 8 use target_lexicon::Triple; 9 10 #[cfg(all(target_arch = "riscv64", target_os = "linux"))] 11 mod riscv; 12 13 /// Return an `isa` builder configured for the current host 14 /// machine, or `Err(())` if the host machine is not supported 15 /// in the current configuration. 16 pub fn builder() -> Result<isa::Builder, &'static str> { 17 builder_with_options(true) 18 } 19 20 /// Return an `isa` builder configured for the current host 21 /// machine, or `Err(())` if the host machine is not supported 22 /// in the current configuration. 23 /// 24 /// Selects the given backend variant specifically; this is 25 /// useful when more than one backend exists for a given target 26 /// (e.g., on x86-64). 27 pub fn builder_with_options(infer_native_flags: bool) -> Result<isa::Builder, &'static str> { 28 let mut isa_builder = isa::lookup(Triple::host()).map_err(|err| match err { 29 isa::LookupError::SupportDisabled => "support for architecture disabled at compile time", 30 isa::LookupError::Unsupported => "unsupported architecture", 31 })?; 32 if infer_native_flags { 33 self::infer_native_flags(&mut isa_builder)?; 34 } 35 Ok(isa_builder) 36 } 37 38 /// Return an `isa` builder configured for the current host 39 /// machine, or `Err(())` if the host machine is not supported 40 /// in the current configuration. 41 /// 42 /// Selects the given backend variant specifically; this is 43 /// useful when more than one backend exists for a given target 44 /// (e.g., on x86-64). 45 pub fn infer_native_flags(isa_builder: &mut dyn Configurable) -> Result<(), &'static str> { 46 #[cfg(target_arch = "x86_64")] 47 { 48 if !std::is_x86_feature_detected!("sse2") { 49 return Err("x86 support requires SSE2"); 50 } 51 52 if std::is_x86_feature_detected!("sse3") { 53 isa_builder.enable("has_sse3").unwrap(); 54 } 55 if std::is_x86_feature_detected!("ssse3") { 56 isa_builder.enable("has_ssse3").unwrap(); 57 } 58 if std::is_x86_feature_detected!("sse4.1") { 59 isa_builder.enable("has_sse41").unwrap(); 60 } 61 if std::is_x86_feature_detected!("sse4.2") { 62 isa_builder.enable("has_sse42").unwrap(); 63 } 64 if std::is_x86_feature_detected!("popcnt") { 65 isa_builder.enable("has_popcnt").unwrap(); 66 } 67 if std::is_x86_feature_detected!("avx") { 68 isa_builder.enable("has_avx").unwrap(); 69 } 70 if std::is_x86_feature_detected!("avx2") { 71 isa_builder.enable("has_avx2").unwrap(); 72 } 73 if std::is_x86_feature_detected!("fma") { 74 isa_builder.enable("has_fma").unwrap(); 75 } 76 if std::is_x86_feature_detected!("bmi1") { 77 isa_builder.enable("has_bmi1").unwrap(); 78 } 79 if std::is_x86_feature_detected!("bmi2") { 80 isa_builder.enable("has_bmi2").unwrap(); 81 } 82 if std::is_x86_feature_detected!("avx512bitalg") { 83 isa_builder.enable("has_avx512bitalg").unwrap(); 84 } 85 if std::is_x86_feature_detected!("avx512dq") { 86 isa_builder.enable("has_avx512dq").unwrap(); 87 } 88 if std::is_x86_feature_detected!("avx512f") { 89 isa_builder.enable("has_avx512f").unwrap(); 90 } 91 if std::is_x86_feature_detected!("avx512vl") { 92 isa_builder.enable("has_avx512vl").unwrap(); 93 } 94 if std::is_x86_feature_detected!("avx512vbmi") { 95 isa_builder.enable("has_avx512vbmi").unwrap(); 96 } 97 if std::is_x86_feature_detected!("lzcnt") { 98 isa_builder.enable("has_lzcnt").unwrap(); 99 } 100 } 101 102 #[cfg(target_arch = "aarch64")] 103 { 104 if std::arch::is_aarch64_feature_detected!("lse") { 105 isa_builder.enable("has_lse").unwrap(); 106 } 107 108 if std::arch::is_aarch64_feature_detected!("paca") { 109 isa_builder.enable("has_pauth").unwrap(); 110 } 111 112 if std::arch::is_aarch64_feature_detected!("fp16") { 113 isa_builder.enable("has_fp16").unwrap(); 114 } 115 116 if cfg!(target_os = "macos") { 117 // Pointer authentication is always available on Apple Silicon. 118 isa_builder.enable("sign_return_address").unwrap(); 119 // macOS enforces the use of the B key for return addresses. 120 isa_builder.enable("sign_return_address_with_bkey").unwrap(); 121 } 122 } 123 124 // There is no is_s390x_feature_detected macro yet, so for now 125 // we use getauxval from the libc crate directly. 126 #[cfg(all(target_arch = "s390x", target_os = "linux"))] 127 { 128 let v = unsafe { libc::getauxval(libc::AT_HWCAP) }; 129 const HWCAP_S390X_VXRS_EXT2: libc::c_ulong = 32768; 130 if (v & HWCAP_S390X_VXRS_EXT2) != 0 { 131 isa_builder.enable("has_vxrs_ext2").unwrap(); 132 // There is no separate HWCAP bit for mie2, so assume 133 // that any machine with vxrs_ext2 also has mie2. 134 isa_builder.enable("has_mie2").unwrap(); 135 } 136 } 137 138 // `is_riscv_feature_detected` is nightly only for now, use 139 // getauxval from the libc crate directly as a temporary measure. 140 #[cfg(all(target_arch = "riscv64", target_os = "linux"))] 141 { 142 // Try both hwcap and cpuinfo 143 // HWCAP only returns single letter extensions, cpuinfo returns all of 144 // them but may not be available in some systems (QEMU < 8.1). 145 riscv::hwcap_detect(isa_builder)?; 146 147 // Ignore errors for cpuinfo. QEMU versions prior to 8.1 do not emulate 148 // the cpuinfo interface, so we can't rely on it being present for now. 149 let _ = riscv::cpuinfo_detect(isa_builder); 150 } 151 152 // On all other architectures (e.g. wasm32) we won't infer any native flags, 153 // but still need to use the `isa_builder` to avoid compiler warnings. 154 let _ = isa_builder; 155 Ok(()) 156 } 157 158 /// Version number of this crate. 159 pub const VERSION: &str = env!("CARGO_PKG_VERSION"); 160 161 #[cfg(test)] 162 mod tests { 163 use super::builder; 164 use cranelift_codegen::isa::CallConv; 165 use cranelift_codegen::settings; 166 167 #[test] 168 fn test() { 169 if let Ok(isa_builder) = builder() { 170 let flag_builder = settings::builder(); 171 let isa = isa_builder 172 .finish(settings::Flags::new(flag_builder)) 173 .unwrap(); 174 175 if cfg!(all(target_os = "macos", target_arch = "aarch64")) { 176 assert_eq!(isa.default_call_conv(), CallConv::AppleAarch64); 177 } else if cfg!(unix) { 178 assert_eq!(isa.default_call_conv(), CallConv::SystemV); 179 } else if cfg!(windows) { 180 assert_eq!(isa.default_call_conv(), CallConv::WindowsFastcall); 181 } 182 183 if cfg!(target_pointer_width = "64") { 184 assert_eq!(isa.pointer_bits(), 64); 185 } else if cfg!(target_pointer_width = "32") { 186 assert_eq!(isa.pointer_bits(), 32); 187 } else if cfg!(target_pointer_width = "16") { 188 assert_eq!(isa.pointer_bits(), 16); 189 } 190 } 191 } 192 } 193