//! This file was mostly taken from the llvm-sys crate. //! (https://bitbucket.org/tari/llvm-sys.rs/raw/94361c1083a88f439b9d24c59b2d2831517413d7/build.rs) use lazy_static::lazy_static; use regex::Regex; use semver::Version; use std::env; use std::ffi::OsStr; use std::io::{self, ErrorKind}; use std::path::PathBuf; use std::process::Command; // Version of the llvm-sys crate that we (through inkwell) depend on. const LLVM_SYS_MAJOR_VERSION: &str = "80"; const LLVM_SYS_MINOR_VERSION: &str = "0"; // Environment variables that can guide compilation // // When adding new ones, they should also be added to main() to force a // rebuild if they are changed. lazy_static! { /// A single path to search for LLVM in (containing bin/llvm-config) static ref ENV_LLVM_PREFIX: String = format!("LLVM_SYS_{}_PREFIX", LLVM_SYS_MAJOR_VERSION); /// If exactly "YES", ignore the version blacklist static ref ENV_IGNORE_BLACKLIST: String = format!("LLVM_SYS_{}_IGNORE_BLACKLIST", LLVM_SYS_MAJOR_VERSION); /// If set, enforce precise correspondence between crate and binary versions. static ref ENV_STRICT_VERSIONING: String = format!("LLVM_SYS_{}_STRICT_VERSIONING", LLVM_SYS_MAJOR_VERSION); /// If set, do not attempt to strip irrelevant options for llvm-config --cflags static ref ENV_NO_CLEAN_CXXFLAGS: String = format!("LLVM_SYS_{}_NO_CLEAN_CXXFLAGS", LLVM_SYS_MAJOR_VERSION); /// If set and targeting MSVC, force the debug runtime library static ref ENV_USE_DEBUG_MSVCRT: String = format!("LLVM_SYS_{}_USE_DEBUG_MSVCRT", LLVM_SYS_MAJOR_VERSION); /// If set, always link against libffi static ref ENV_FORCE_FFI: String = format!("LLVM_SYS_{}_FFI_WORKAROUND", LLVM_SYS_MAJOR_VERSION); } lazy_static! { /// LLVM version used by this version of the crate. static ref CRATE_VERSION: Version = { Version::new(LLVM_SYS_MAJOR_VERSION.parse::().unwrap() / 10, LLVM_SYS_MINOR_VERSION.parse::().unwrap() % 10, 0) }; static ref LLVM_CONFIG_BINARY_NAMES: Vec = { vec![ "llvm-config".into(), format!("llvm-config-{}", CRATE_VERSION.major), format!("llvm-config-{}.{}", CRATE_VERSION.major, CRATE_VERSION.minor), format!("llvm-config{}{}", CRATE_VERSION.major, CRATE_VERSION.minor), ] }; /// Filesystem path to an llvm-config binary for the correct version. static ref LLVM_CONFIG_PATH: PathBuf = { // Try llvm-config via PATH first. if let Some(name) = locate_system_llvm_config() { return name.into(); } else { println!("Didn't find usable system-wide LLVM."); } // Did the user give us a binary path to use? If yes, try // to use that and fail if it doesn't work. if let Some(path) = env::var_os(&*ENV_LLVM_PREFIX) { for binary_name in LLVM_CONFIG_BINARY_NAMES.iter() { let mut pb: PathBuf = path.clone().into(); pb.push("bin"); pb.push(binary_name); let ver = llvm_version(&pb) .expect(&format!("Failed to execute {:?}", &pb)); if is_compatible_llvm(&ver) { return pb; } else { println!("LLVM binaries specified by {} are the wrong version. (Found {}, need {}.)", *ENV_LLVM_PREFIX, ver, *CRATE_VERSION); } } } println!("No suitable version of LLVM was found system-wide or pointed to by {}. Consider using `llvmenv` to compile an appropriate copy of LLVM, and refer to the llvm-sys documentation for more information. llvm-sys: https://crates.io/crates/llvm-sys llvmenv: https://crates.io/crates/llvmenv", *ENV_LLVM_PREFIX); panic!("Could not find a compatible version of LLVM"); }; } /// Try to find a system-wide version of llvm-config that is compatible with /// this crate. /// /// Returns None on failure. fn locate_system_llvm_config() -> Option<&'static str> { for binary_name in LLVM_CONFIG_BINARY_NAMES.iter() { match llvm_version(binary_name) { Ok(ref version) if is_compatible_llvm(version) => { // Compatible version found. Nice. return Some(binary_name); } Ok(version) => { // Version mismatch. Will try further searches, but warn that // we're not using the system one. println!( "Found LLVM version {} on PATH, but need {}.", version, *CRATE_VERSION ); } Err(ref e) if e.kind() == ErrorKind::NotFound => { // Looks like we failed to execute any llvm-config. Keep // searching. } // Some other error, probably a weird failure. Give up. Err(e) => panic!("Failed to search PATH for llvm-config: {}", e), } } None } /// Check whether the given version of LLVM is blacklisted, /// returning `Some(reason)` if it is. fn is_blacklisted_llvm(llvm_version: &Version) -> Option<&'static str> { static BLACKLIST: &'static [(u64, u64, u64, &'static str)] = &[]; if let Some(x) = env::var_os(&*ENV_IGNORE_BLACKLIST) { if &x == "YES" { println!( "cargo:warning=Ignoring blacklist entry for LLVM {}", llvm_version ); return None; } else { println!( "cargo:warning={} is set but not exactly \"YES\"; blacklist is still honored.", *ENV_IGNORE_BLACKLIST ); } } for &(major, minor, patch, reason) in BLACKLIST.iter() { let bad_version = Version { major: major, minor: minor, patch: patch, pre: vec![], build: vec![], }; if &bad_version == llvm_version { return Some(reason); } } None } /// Check whether the given LLVM version is compatible with this version of /// the crate. fn is_compatible_llvm(llvm_version: &Version) -> bool { if let Some(reason) = is_blacklisted_llvm(llvm_version) { println!( "Found LLVM {}, which is blacklisted: {}", llvm_version, reason ); return false; } let strict = env::var_os(&*ENV_STRICT_VERSIONING).is_some() || cfg!(feature = "strict-versioning"); if strict { llvm_version.major == CRATE_VERSION.major && llvm_version.minor == CRATE_VERSION.minor } else { llvm_version.major >= CRATE_VERSION.major || (llvm_version.major == CRATE_VERSION.major && llvm_version.minor >= CRATE_VERSION.minor) } } /// Get the output from running `llvm-config` with the given argument. /// /// Lazily searches for or compiles LLVM as configured by the environment /// variables. fn llvm_config(arg: &str) -> String { llvm_config_ex(&*LLVM_CONFIG_PATH, arg).expect("Surprising failure from llvm-config") } /// Invoke the specified binary as llvm-config. /// /// Explicit version of the `llvm_config` function that bubbles errors /// up. fn llvm_config_ex>(binary: S, arg: &str) -> io::Result { Command::new(binary) .arg(arg) .arg("--link-static") // Don't use dylib for >= 3.9 .output() .map(|output| { String::from_utf8(output.stdout).expect("Output from llvm-config was not valid UTF-8") }) } /// Get the LLVM version using llvm-config. fn llvm_version>(binary: S) -> io::Result { let version_str = llvm_config_ex(binary.as_ref(), "--version")?; // LLVM isn't really semver and uses version suffixes to build // version strings like '3.8.0svn', so limit what we try to parse // to only the numeric bits. let re = Regex::new(r"^(?P\d+)\.(?P\d+)(?:\.(?P\d+))??").unwrap(); let c = re .captures(&version_str) .expect("Could not determine LLVM version from llvm-config."); // some systems don't have a patch number but Version wants it so we just append .0 if it isn't // there let s = match c.name("patch") { None => format!("{}.0", &c[0]), Some(_) => c[0].to_string(), }; Ok(Version::parse(&s).unwrap()) } fn get_llvm_cxxflags() -> String { let output = llvm_config("--cxxflags"); // llvm-config includes cflags from its own compilation with --cflags that // may not be relevant to us. In particularly annoying cases, these might // include flags that aren't understood by the default compiler we're // using. Unless requested otherwise, clean CFLAGS of options that are // known to be possibly-harmful. let no_clean = env::var_os(&*ENV_NO_CLEAN_CXXFLAGS).is_some(); if no_clean || cfg!(target_env = "msvc") { // MSVC doesn't accept -W... options, so don't try to strip them and // possibly strip something that should be retained. Also do nothing if // the user requests it. return output; } output .split(&[' ', '\n'][..]) .filter(|word| !word.starts_with("-W")) .filter(|word| word != &"-fno-exceptions") .collect::>() .join(" ") } fn is_llvm_debug() -> bool { // Has to be either Debug or Release llvm_config("--build-mode").contains("Debug") } fn main() { println!("cargo:rustc-link-lib=static=llvm-backend"); println!("cargo:rerun-if-changed=build.rs"); println!("cargo:rerun-if-changed=cpp/object_loader.cpp"); println!("cargo:rerun-if-changed=cpp/object_loader.hh"); println!("cargo:rerun-if-env-changed={}", &*ENV_LLVM_PREFIX); println!("cargo:rerun-if-env-changed={}", &*ENV_IGNORE_BLACKLIST); println!("cargo:rerun-if-env-changed={}", &*ENV_STRICT_VERSIONING); println!("cargo:rerun-if-env-changed={}", &*ENV_NO_CLEAN_CXXFLAGS); println!("cargo:rerun-if-env-changed={}", &*ENV_USE_DEBUG_MSVCRT); println!("cargo:rerun-if-env-changed={}", &*ENV_FORCE_FFI); std::env::set_var("CXXFLAGS", get_llvm_cxxflags()); cc::Build::new() .cpp(true) .file("cpp/object_loader.cpp") .compile("llvm-backend"); // Enable "nightly" cfg if the current compiler is nightly. if rustc_version::version_meta().unwrap().channel == rustc_version::Channel::Nightly { println!("cargo:rustc-cfg=nightly"); } let use_debug_msvcrt = env::var_os(&*ENV_USE_DEBUG_MSVCRT).is_some(); if cfg!(target_env = "msvc") && (use_debug_msvcrt || is_llvm_debug()) { println!("cargo:rustc-link-lib={}", "msvcrtd"); } // Link libffi if the user requested this workaround. // See https://bitbucket.org/tari/llvm-sys.rs/issues/12/ let force_ffi = env::var_os(&*ENV_FORCE_FFI).is_some(); if force_ffi { println!("cargo:rustc-link-lib=dylib={}", "ffi"); } }