| use super::command::Command; |
| use super::symbol_export; |
| use crate::errors; |
| use rustc_span::symbol::sym; |
| |
| use std::ffi::{OsStr, OsString}; |
| use std::fs::{self, File}; |
| use std::io::prelude::*; |
| use std::io::{self, BufWriter}; |
| use std::path::{Path, PathBuf}; |
| use std::{env, mem, str}; |
| |
| use rustc_hir::def_id::{CrateNum, LOCAL_CRATE}; |
| use rustc_metadata::find_native_static_library; |
| use rustc_middle::middle::dependency_format::Linkage; |
| use rustc_middle::middle::exported_symbols; |
| use rustc_middle::middle::exported_symbols::{ExportedSymbol, SymbolExportInfo, SymbolExportKind}; |
| use rustc_middle::ty::TyCtxt; |
| use rustc_session::config::{self, CrateType, DebugInfo, LinkerPluginLto, Lto, OptLevel, Strip}; |
| use rustc_session::Session; |
| use rustc_target::spec::{Cc, LinkOutputKind, LinkerFlavor, Lld}; |
| |
| use cc::windows_registry; |
| |
| /// Disables non-English messages from localized linkers. |
| /// Such messages may cause issues with text encoding on Windows (#35785) |
| /// and prevent inspection of linker output in case of errors, which we occasionally do. |
| /// This should be acceptable because other messages from rustc are in English anyway, |
| /// and may also be desirable to improve searchability of the linker diagnostics. |
| pub fn disable_localization(linker: &mut Command) { |
| // No harm in setting both env vars simultaneously. |
| // Unix-style linkers. |
| linker.env("LC_ALL", "C"); |
| // MSVC's `link.exe`. |
| linker.env("VSLANG", "1033"); |
| } |
| |
| /// The third parameter is for env vars, used on windows to set up the |
| /// path for MSVC to find its DLLs, and gcc to find its bundled |
| /// toolchain |
| pub fn get_linker<'a>( |
| sess: &'a Session, |
| linker: &Path, |
| flavor: LinkerFlavor, |
| self_contained: bool, |
| target_cpu: &'a str, |
| ) -> Box<dyn Linker + 'a> { |
| let msvc_tool = windows_registry::find_tool(sess.opts.target_triple.triple(), "link.exe"); |
| |
| // If our linker looks like a batch script on Windows then to execute this |
| // we'll need to spawn `cmd` explicitly. This is primarily done to handle |
| // emscripten where the linker is `emcc.bat` and needs to be spawned as |
| // `cmd /c emcc.bat ...`. |
| // |
| // This worked historically but is needed manually since #42436 (regression |
| // was tagged as #42791) and some more info can be found on #44443 for |
| // emscripten itself. |
| let mut cmd = match linker.to_str() { |
| Some(linker) if cfg!(windows) && linker.ends_with(".bat") => Command::bat_script(linker), |
| _ => match flavor { |
| LinkerFlavor::Gnu(Cc::No, Lld::Yes) |
| | LinkerFlavor::Darwin(Cc::No, Lld::Yes) |
| | LinkerFlavor::WasmLld(Cc::No) |
| | LinkerFlavor::Msvc(Lld::Yes) => Command::lld(linker, flavor.lld_flavor()), |
| LinkerFlavor::Msvc(Lld::No) |
| if sess.opts.cg.linker.is_none() && sess.target.linker.is_none() => |
| { |
| Command::new(msvc_tool.as_ref().map_or(linker, |t| t.path())) |
| } |
| _ => Command::new(linker), |
| }, |
| }; |
| |
| // UWP apps have API restrictions enforced during Store submissions. |
| // To comply with the Windows App Certification Kit, |
| // MSVC needs to link with the Store versions of the runtime libraries (vcruntime, msvcrt, etc). |
| let t = &sess.target; |
| if matches!(flavor, LinkerFlavor::Msvc(..)) && t.vendor == "uwp" { |
| if let Some(ref tool) = msvc_tool { |
| let original_path = tool.path(); |
| if let Some(root_lib_path) = original_path.ancestors().nth(4) { |
| let arch = match t.arch.as_ref() { |
| "x86_64" => Some("x64"), |
| "x86" => Some("x86"), |
| "aarch64" => Some("arm64"), |
| "arm" => Some("arm"), |
| _ => None, |
| }; |
| if let Some(ref a) = arch { |
| // FIXME: Move this to `fn linker_with_args`. |
| let mut arg = OsString::from("/LIBPATH:"); |
| arg.push(format!("{}\\lib\\{}\\store", root_lib_path.display(), a)); |
| cmd.arg(&arg); |
| } else { |
| warn!("arch is not supported"); |
| } |
| } else { |
| warn!("MSVC root path lib location not found"); |
| } |
| } else { |
| warn!("link.exe not found"); |
| } |
| } |
| |
| // The compiler's sysroot often has some bundled tools, so add it to the |
| // PATH for the child. |
| let mut new_path = sess.get_tools_search_paths(self_contained); |
| let mut msvc_changed_path = false; |
| if sess.target.is_like_msvc { |
| if let Some(ref tool) = msvc_tool { |
| cmd.args(tool.args()); |
| for (k, v) in tool.env() { |
| if k == "PATH" { |
| new_path.extend(env::split_paths(v)); |
| msvc_changed_path = true; |
| } else { |
| cmd.env(k, v); |
| } |
| } |
| } |
| } |
| |
| if !msvc_changed_path { |
| if let Some(path) = env::var_os("PATH") { |
| new_path.extend(env::split_paths(&path)); |
| } |
| } |
| cmd.env("PATH", env::join_paths(new_path).unwrap()); |
| |
| // FIXME: Move `/LIBPATH` addition for uwp targets from the linker construction |
| // to the linker args construction. |
| assert!(cmd.get_args().is_empty() || sess.target.vendor == "uwp"); |
| match flavor { |
| LinkerFlavor::Unix(Cc::No) if sess.target.os == "l4re" => { |
| Box::new(L4Bender::new(cmd, sess)) as Box<dyn Linker> |
| } |
| LinkerFlavor::Unix(Cc::No) if sess.target.os == "aix" => { |
| Box::new(AixLinker::new(cmd, sess)) as Box<dyn Linker> |
| } |
| LinkerFlavor::WasmLld(Cc::No) => Box::new(WasmLd::new(cmd, sess)) as Box<dyn Linker>, |
| LinkerFlavor::Gnu(cc, _) |
| | LinkerFlavor::Darwin(cc, _) |
| | LinkerFlavor::WasmLld(cc) |
| | LinkerFlavor::Unix(cc) => Box::new(GccLinker { |
| cmd, |
| sess, |
| target_cpu, |
| hinted_static: None, |
| is_ld: cc == Cc::No, |
| is_gnu: flavor.is_gnu(), |
| }) as Box<dyn Linker>, |
| LinkerFlavor::Msvc(..) => Box::new(MsvcLinker { cmd, sess }) as Box<dyn Linker>, |
| LinkerFlavor::EmCc => Box::new(EmLinker { cmd, sess }) as Box<dyn Linker>, |
| LinkerFlavor::Bpf => Box::new(BpfLinker { cmd, sess }) as Box<dyn Linker>, |
| LinkerFlavor::Llbc => Box::new(LlbcLinker { cmd, sess }) as Box<dyn Linker>, |
| LinkerFlavor::Ptx => Box::new(PtxLinker { cmd, sess }) as Box<dyn Linker>, |
| } |
| } |
| |
| /// Linker abstraction used by `back::link` to build up the command to invoke a |
| /// linker. |
| /// |
| /// This trait is the total list of requirements needed by `back::link` and |
| /// represents the meaning of each option being passed down. This trait is then |
| /// used to dispatch on whether a GNU-like linker (generally `ld.exe`) or an |
| /// MSVC linker (e.g., `link.exe`) is being used. |
| pub trait Linker { |
| fn cmd(&mut self) -> &mut Command; |
| fn set_output_kind(&mut self, output_kind: LinkOutputKind, out_filename: &Path); |
| fn link_dylib_by_name(&mut self, name: &str, verbatim: bool, as_needed: bool); |
| fn link_framework_by_name(&mut self, _name: &str, _verbatim: bool, _as_needed: bool) { |
| bug!("framework linked with unsupported linker") |
| } |
| fn link_staticlib_by_name(&mut self, name: &str, verbatim: bool, whole_archive: bool); |
| fn link_staticlib_by_path(&mut self, path: &Path, whole_archive: bool); |
| fn include_path(&mut self, path: &Path); |
| fn framework_path(&mut self, path: &Path); |
| fn output_filename(&mut self, path: &Path); |
| fn add_object(&mut self, path: &Path); |
| fn gc_sections(&mut self, keep_metadata: bool); |
| fn no_gc_sections(&mut self); |
| fn full_relro(&mut self); |
| fn partial_relro(&mut self); |
| fn no_relro(&mut self); |
| fn optimize(&mut self); |
| fn pgo_gen(&mut self); |
| fn control_flow_guard(&mut self); |
| fn ehcont_guard(&mut self); |
| fn debuginfo(&mut self, strip: Strip, natvis_debugger_visualizers: &[PathBuf]); |
| fn no_crt_objects(&mut self); |
| fn no_default_libraries(&mut self); |
| fn export_symbols(&mut self, tmpdir: &Path, crate_type: CrateType, symbols: &[String]); |
| fn subsystem(&mut self, subsystem: &str); |
| fn linker_plugin_lto(&mut self); |
| fn add_eh_frame_header(&mut self) {} |
| fn add_no_exec(&mut self) {} |
| fn add_as_needed(&mut self) {} |
| fn reset_per_library_state(&mut self) {} |
| fn linker_arg(&mut self, arg: &OsStr, verbatim: bool) { |
| self.linker_args(&[arg], verbatim); |
| } |
| fn linker_args(&mut self, args: &[&OsStr], _verbatim: bool) { |
| args.into_iter().for_each(|a| { |
| self.cmd().arg(a); |
| }); |
| } |
| } |
| |
| impl dyn Linker + '_ { |
| pub fn arg(&mut self, arg: impl AsRef<OsStr>) { |
| self.cmd().arg(arg); |
| } |
| |
| pub fn args(&mut self, args: impl IntoIterator<Item: AsRef<OsStr>>) { |
| self.cmd().args(args); |
| } |
| |
| pub fn take_cmd(&mut self) -> Command { |
| mem::replace(self.cmd(), Command::new("")) |
| } |
| } |
| |
| pub struct GccLinker<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| target_cpu: &'a str, |
| hinted_static: Option<bool>, // Keeps track of the current hinting mode. |
| // Link as ld |
| is_ld: bool, |
| is_gnu: bool, |
| } |
| |
| impl<'a> GccLinker<'a> { |
| fn linker_arg(&mut self, arg: impl AsRef<OsStr>) { |
| Linker::linker_arg(self, arg.as_ref(), false); |
| } |
| fn linker_args(&mut self, args: &[impl AsRef<OsStr>]) { |
| let args_vec: Vec<&OsStr> = args.iter().map(|x| x.as_ref()).collect(); |
| Linker::linker_args(self, &args_vec, false); |
| } |
| |
| fn takes_hints(&self) -> bool { |
| // Really this function only returns true if the underlying linker |
| // configured for a compiler is binutils `ld.bfd` and `ld.gold`. We |
| // don't really have a foolproof way to detect that, so rule out some |
| // platforms where currently this is guaranteed to *not* be the case: |
| // |
| // * On OSX they have their own linker, not binutils' |
| // * For WebAssembly the only functional linker is LLD, which doesn't |
| // support hint flags |
| !self.sess.target.is_like_osx && !self.sess.target.is_like_wasm |
| } |
| |
| // Some platforms take hints about whether a library is static or dynamic. |
| // For those that support this, we ensure we pass the option if the library |
| // was flagged "static" (most defaults are dynamic) to ensure that if |
| // libfoo.a and libfoo.so both exist that the right one is chosen. |
| fn hint_static(&mut self) { |
| if !self.takes_hints() { |
| return; |
| } |
| if self.hinted_static != Some(true) { |
| self.linker_arg("-Bstatic"); |
| self.hinted_static = Some(true); |
| } |
| } |
| |
| fn hint_dynamic(&mut self) { |
| if !self.takes_hints() { |
| return; |
| } |
| if self.hinted_static != Some(false) { |
| self.linker_arg("-Bdynamic"); |
| self.hinted_static = Some(false); |
| } |
| } |
| |
| fn push_linker_plugin_lto_args(&mut self, plugin_path: Option<&OsStr>) { |
| if let Some(plugin_path) = plugin_path { |
| let mut arg = OsString::from("-plugin="); |
| arg.push(plugin_path); |
| self.linker_arg(&arg); |
| } |
| |
| let opt_level = match self.sess.opts.optimize { |
| config::OptLevel::No => "O0", |
| config::OptLevel::Less => "O1", |
| config::OptLevel::Default | config::OptLevel::Size | config::OptLevel::SizeMin => "O2", |
| config::OptLevel::Aggressive => "O3", |
| }; |
| |
| if let Some(path) = &self.sess.opts.unstable_opts.profile_sample_use { |
| self.linker_arg(&format!("-plugin-opt=sample-profile={}", path.display())); |
| }; |
| self.linker_args(&[ |
| &format!("-plugin-opt={opt_level}"), |
| &format!("-plugin-opt=mcpu={}", self.target_cpu), |
| ]); |
| } |
| |
| fn build_dylib(&mut self, out_filename: &Path) { |
| // On mac we need to tell the linker to let this library be rpathed |
| if self.sess.target.is_like_osx { |
| if !self.is_ld { |
| self.cmd.arg("-dynamiclib"); |
| } |
| |
| self.linker_arg("-dylib"); |
| |
| // Note that the `osx_rpath_install_name` option here is a hack |
| // purely to support rustbuild right now, we should get a more |
| // principled solution at some point to force the compiler to pass |
| // the right `-Wl,-install_name` with an `@rpath` in it. |
| if self.sess.opts.cg.rpath || self.sess.opts.unstable_opts.osx_rpath_install_name { |
| let mut rpath = OsString::from("@rpath/"); |
| rpath.push(out_filename.file_name().unwrap()); |
| self.linker_args(&[OsString::from("-install_name"), rpath]); |
| } |
| } else { |
| self.cmd.arg("-shared"); |
| if self.sess.target.is_like_windows { |
| // The output filename already contains `dll_suffix` so |
| // the resulting import library will have a name in the |
| // form of libfoo.dll.a |
| let implib_name = |
| out_filename.file_name().and_then(|file| file.to_str()).map(|file| { |
| format!( |
| "{}{}{}", |
| self.sess.target.staticlib_prefix, |
| file, |
| self.sess.target.staticlib_suffix |
| ) |
| }); |
| if let Some(implib_name) = implib_name { |
| let implib = out_filename.parent().map(|dir| dir.join(&implib_name)); |
| if let Some(implib) = implib { |
| self.linker_arg(&format!("--out-implib={}", (*implib).to_str().unwrap())); |
| } |
| } |
| } |
| } |
| } |
| } |
| |
| impl<'a> Linker for GccLinker<'a> { |
| /// Passes a series of arguments directly to the linker. |
| /// |
| /// When the linker is ld-like, the arguments are simply appended to the command. When the |
| /// linker is not ld-like such as when using a compiler as a linker, the arguments are joined by |
| /// commas to form an argument that is then prepended with `-Wl`. In this situation, only a |
| /// single argument is appended to the command to ensure that the order of the arguments is |
| /// preserved by the compiler. |
| fn linker_args(&mut self, args: &[&OsStr], verbatim: bool) { |
| if self.is_ld || verbatim { |
| args.into_iter().for_each(|a| { |
| self.cmd.arg(a); |
| }); |
| } else { |
| if !args.is_empty() { |
| let mut s = OsString::from("-Wl"); |
| for a in args { |
| s.push(","); |
| s.push(a); |
| } |
| self.cmd.arg(s); |
| } |
| } |
| } |
| |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, output_kind: LinkOutputKind, out_filename: &Path) { |
| match output_kind { |
| LinkOutputKind::DynamicNoPicExe => { |
| if !self.is_ld && self.is_gnu { |
| self.cmd.arg("-no-pie"); |
| } |
| } |
| LinkOutputKind::DynamicPicExe => { |
| // noop on windows w/ gcc & ld, error w/ lld |
| if !self.sess.target.is_like_windows { |
| // `-pie` works for both gcc wrapper and ld. |
| self.cmd.arg("-pie"); |
| } |
| } |
| LinkOutputKind::StaticNoPicExe => { |
| // `-static` works for both gcc wrapper and ld. |
| self.cmd.arg("-static"); |
| if !self.is_ld && self.is_gnu { |
| self.cmd.arg("-no-pie"); |
| } |
| } |
| LinkOutputKind::StaticPicExe => { |
| if !self.is_ld { |
| // Note that combination `-static -pie` doesn't work as expected |
| // for the gcc wrapper, `-static` in that case suppresses `-pie`. |
| self.cmd.arg("-static-pie"); |
| } else { |
| // `--no-dynamic-linker` and `-z text` are not strictly necessary for producing |
| // a static pie, but currently passed because gcc and clang pass them. |
| // The former suppresses the `INTERP` ELF header specifying dynamic linker, |
| // which is otherwise implicitly injected by ld (but not lld). |
| // The latter doesn't change anything, only ensures that everything is pic. |
| self.cmd.args(&["-static", "-pie", "--no-dynamic-linker", "-z", "text"]); |
| } |
| } |
| LinkOutputKind::DynamicDylib => self.build_dylib(out_filename), |
| LinkOutputKind::StaticDylib => { |
| self.cmd.arg("-static"); |
| self.build_dylib(out_filename); |
| } |
| LinkOutputKind::WasiReactorExe => { |
| self.linker_args(&["--entry", "_initialize"]); |
| } |
| } |
| // VxWorks compiler driver introduced `--static-crt` flag specifically for rustc, |
| // it switches linking for libc and similar system libraries to static without using |
| // any `#[link]` attributes in the `libc` crate, see #72782 for details. |
| // FIXME: Switch to using `#[link]` attributes in the `libc` crate |
| // similarly to other targets. |
| if self.sess.target.os == "vxworks" |
| && matches!( |
| output_kind, |
| LinkOutputKind::StaticNoPicExe |
| | LinkOutputKind::StaticPicExe |
| | LinkOutputKind::StaticDylib |
| ) |
| { |
| self.cmd.arg("--static-crt"); |
| } |
| } |
| |
| fn link_dylib_by_name(&mut self, name: &str, verbatim: bool, as_needed: bool) { |
| if self.sess.target.os == "illumos" && name == "c" { |
| // libc will be added via late_link_args on illumos so that it will |
| // appear last in the library search order. |
| // FIXME: This should be replaced by a more complete and generic |
| // mechanism for controlling the order of library arguments passed |
| // to the linker. |
| return; |
| } |
| if !as_needed { |
| if self.sess.target.is_like_osx { |
| // FIXME(81490): ld64 doesn't support these flags but macOS 11 |
| // has -needed-l{} / -needed_library {} |
| // but we have no way to detect that here. |
| self.sess.dcx().emit_warn(errors::Ld64UnimplementedModifier); |
| } else if self.is_gnu && !self.sess.target.is_like_windows { |
| self.linker_arg("--no-as-needed"); |
| } else { |
| self.sess.dcx().emit_warn(errors::LinkerUnsupportedModifier); |
| } |
| } |
| self.hint_dynamic(); |
| self.cmd.arg(format!("-l{}{name}", if verbatim && self.is_gnu { ":" } else { "" },)); |
| if !as_needed { |
| if self.sess.target.is_like_osx { |
| // See above FIXME comment |
| } else if self.is_gnu && !self.sess.target.is_like_windows { |
| self.linker_arg("--as-needed"); |
| } |
| } |
| } |
| |
| fn link_framework_by_name(&mut self, name: &str, _verbatim: bool, as_needed: bool) { |
| self.hint_dynamic(); |
| if !as_needed { |
| // FIXME(81490): ld64 as of macOS 11 supports the -needed_framework |
| // flag but we have no way to detect that here. |
| // self.cmd.arg("-needed_framework").arg(name); |
| self.sess.dcx().emit_warn(errors::Ld64UnimplementedModifier); |
| } |
| self.cmd.arg("-framework").arg(name); |
| } |
| |
| fn link_staticlib_by_name(&mut self, name: &str, verbatim: bool, whole_archive: bool) { |
| self.hint_static(); |
| let colon = if verbatim && self.is_gnu { ":" } else { "" }; |
| if !whole_archive { |
| self.cmd.arg(format!("-l{colon}{name}")); |
| } else if self.sess.target.is_like_osx { |
| // -force_load is the macOS equivalent of --whole-archive, but it |
| // involves passing the full path to the library to link. |
| self.linker_arg("-force_load"); |
| self.linker_arg(find_native_static_library(name, verbatim, self.sess)); |
| } else { |
| self.linker_arg("--whole-archive"); |
| self.cmd.arg(format!("-l{colon}{name}")); |
| self.linker_arg("--no-whole-archive"); |
| } |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, whole_archive: bool) { |
| self.hint_static(); |
| if !whole_archive { |
| self.cmd.arg(path); |
| } else if self.sess.target.is_like_osx { |
| self.linker_arg("-force_load"); |
| self.linker_arg(path); |
| } else { |
| self.linker_arg("--whole-archive"); |
| self.linker_arg(path); |
| self.linker_arg("--no-whole-archive"); |
| } |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| fn framework_path(&mut self, path: &Path) { |
| self.cmd.arg("-F").arg(path); |
| } |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| fn full_relro(&mut self) { |
| self.linker_args(&["-z", "relro", "-z", "now"]); |
| } |
| fn partial_relro(&mut self) { |
| self.linker_args(&["-z", "relro"]); |
| } |
| fn no_relro(&mut self) { |
| self.linker_args(&["-z", "norelro"]); |
| } |
| |
| fn gc_sections(&mut self, keep_metadata: bool) { |
| // The dead_strip option to the linker specifies that functions and data |
| // unreachable by the entry point will be removed. This is quite useful |
| // with Rust's compilation model of compiling libraries at a time into |
| // one object file. For example, this brings hello world from 1.7MB to |
| // 458K. |
| // |
| // Note that this is done for both executables and dynamic libraries. We |
| // won't get much benefit from dylibs because LLVM will have already |
| // stripped away as much as it could. This has not been seen to impact |
| // link times negatively. |
| // |
| // -dead_strip can't be part of the pre_link_args because it's also used |
| // for partial linking when using multiple codegen units (-r). So we |
| // insert it here. |
| if self.sess.target.is_like_osx { |
| self.linker_arg("-dead_strip"); |
| |
| // If we're building a dylib, we don't use --gc-sections because LLVM |
| // has already done the best it can do, and we also don't want to |
| // eliminate the metadata. If we're building an executable, however, |
| // --gc-sections drops the size of hello world from 1.8MB to 597K, a 67% |
| // reduction. |
| } else if (self.is_gnu || self.sess.target.is_like_wasm) && !keep_metadata { |
| self.linker_arg("--gc-sections"); |
| } |
| } |
| |
| fn no_gc_sections(&mut self) { |
| if self.is_gnu || self.sess.target.is_like_wasm { |
| self.linker_arg("--no-gc-sections"); |
| } |
| } |
| |
| fn optimize(&mut self) { |
| if !self.is_gnu && !self.sess.target.is_like_wasm { |
| return; |
| } |
| |
| // GNU-style linkers support optimization with -O. GNU ld doesn't |
| // need a numeric argument, but other linkers do. |
| if self.sess.opts.optimize == config::OptLevel::Default |
| || self.sess.opts.optimize == config::OptLevel::Aggressive |
| { |
| self.linker_arg("-O1"); |
| } |
| } |
| |
| fn pgo_gen(&mut self) { |
| if !self.is_gnu { |
| return; |
| } |
| |
| // If we're doing PGO generation stuff and on a GNU-like linker, use the |
| // "-u" flag to properly pull in the profiler runtime bits. |
| // |
| // This is because LLVM otherwise won't add the needed initialization |
| // for us on Linux (though the extra flag should be harmless if it |
| // does). |
| // |
| // See https://reviews.llvm.org/D14033 and https://reviews.llvm.org/D14030. |
| // |
| // Though it may be worth to try to revert those changes upstream, since |
| // the overhead of the initialization should be minor. |
| self.cmd.arg("-u"); |
| self.cmd.arg("__llvm_profile_runtime"); |
| } |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn debuginfo(&mut self, strip: Strip, _: &[PathBuf]) { |
| // MacOS linker doesn't support stripping symbols directly anymore. |
| if self.sess.target.is_like_osx { |
| return; |
| } |
| |
| match strip { |
| Strip::None => {} |
| Strip::Debuginfo => { |
| // The illumos linker does not support --strip-debug although |
| // it does support --strip-all as a compatibility alias for -s. |
| // The --strip-debug case is handled by running an external |
| // `strip` utility as a separate step after linking. |
| if !self.sess.target.is_like_solaris { |
| self.linker_arg("--strip-debug"); |
| } |
| } |
| Strip::Symbols => { |
| self.linker_arg("--strip-all"); |
| } |
| } |
| match self.sess.opts.unstable_opts.debuginfo_compression { |
| config::DebugInfoCompression::None => {} |
| config::DebugInfoCompression::Zlib => { |
| self.linker_arg("--compress-debug-sections=zlib"); |
| } |
| config::DebugInfoCompression::Zstd => { |
| self.linker_arg("--compress-debug-sections=zstd"); |
| } |
| } |
| } |
| |
| fn no_crt_objects(&mut self) { |
| if !self.is_ld { |
| self.cmd.arg("-nostartfiles"); |
| } |
| } |
| |
| fn no_default_libraries(&mut self) { |
| if !self.is_ld { |
| self.cmd.arg("-nodefaultlibs"); |
| } |
| } |
| |
| fn export_symbols(&mut self, tmpdir: &Path, crate_type: CrateType, symbols: &[String]) { |
| // Symbol visibility in object files typically takes care of this. |
| if crate_type == CrateType::Executable { |
| let should_export_executable_symbols = |
| self.sess.opts.unstable_opts.export_executable_symbols; |
| if self.sess.target.override_export_symbols.is_none() |
| && !should_export_executable_symbols |
| { |
| return; |
| } |
| } |
| |
| // We manually create a list of exported symbols to ensure we don't expose any more. |
| // The object files have far more public symbols than we actually want to export, |
| // so we hide them all here. |
| |
| if !self.sess.target.limit_rdylib_exports { |
| return; |
| } |
| |
| let is_windows = self.sess.target.is_like_windows; |
| let path = tmpdir.join(if is_windows { "list.def" } else { "list" }); |
| |
| debug!("EXPORTED SYMBOLS:"); |
| |
| if self.sess.target.is_like_osx { |
| // Write a plain, newline-separated list of symbols |
| let res: io::Result<()> = try { |
| let mut f = BufWriter::new(File::create(&path)?); |
| for sym in symbols { |
| debug!(" _{sym}"); |
| writeln!(f, "_{sym}")?; |
| } |
| }; |
| if let Err(error) = res { |
| self.sess.dcx().emit_fatal(errors::LibDefWriteFailure { error }); |
| } |
| } else if is_windows { |
| let res: io::Result<()> = try { |
| let mut f = BufWriter::new(File::create(&path)?); |
| |
| // .def file similar to MSVC one but without LIBRARY section |
| // because LD doesn't like when it's empty |
| writeln!(f, "EXPORTS")?; |
| for symbol in symbols { |
| debug!(" _{symbol}"); |
| writeln!(f, " {symbol}")?; |
| } |
| }; |
| if let Err(error) = res { |
| self.sess.dcx().emit_fatal(errors::LibDefWriteFailure { error }); |
| } |
| } else { |
| // Write an LD version script |
| let res: io::Result<()> = try { |
| let mut f = BufWriter::new(File::create(&path)?); |
| writeln!(f, "{{")?; |
| if !symbols.is_empty() { |
| writeln!(f, " global:")?; |
| for sym in symbols { |
| debug!(" {sym};"); |
| writeln!(f, " {sym};")?; |
| } |
| } |
| writeln!(f, "\n local:\n *;\n}};")?; |
| }; |
| if let Err(error) = res { |
| self.sess.dcx().emit_fatal(errors::VersionScriptWriteFailure { error }); |
| } |
| } |
| |
| if self.sess.target.is_like_osx { |
| self.linker_args(&[OsString::from("-exported_symbols_list"), path.into()]); |
| } else if self.sess.target.is_like_solaris { |
| self.linker_args(&[OsString::from("-M"), path.into()]); |
| } else { |
| if is_windows { |
| self.linker_arg(path); |
| } else { |
| let mut arg = OsString::from("--version-script="); |
| arg.push(path); |
| self.linker_arg(arg); |
| self.linker_arg("--no-undefined-version"); |
| } |
| } |
| } |
| |
| fn subsystem(&mut self, subsystem: &str) { |
| self.linker_arg("--subsystem"); |
| self.linker_arg(&subsystem); |
| } |
| |
| fn reset_per_library_state(&mut self) { |
| self.hint_dynamic(); // Reset to default before returning the composed command line. |
| } |
| |
| fn linker_plugin_lto(&mut self) { |
| match self.sess.opts.cg.linker_plugin_lto { |
| LinkerPluginLto::Disabled => { |
| // Nothing to do |
| } |
| LinkerPluginLto::LinkerPluginAuto => { |
| self.push_linker_plugin_lto_args(None); |
| } |
| LinkerPluginLto::LinkerPlugin(ref path) => { |
| self.push_linker_plugin_lto_args(Some(path.as_os_str())); |
| } |
| } |
| } |
| |
| // Add the `GNU_EH_FRAME` program header which is required to locate unwinding information. |
| // Some versions of `gcc` add it implicitly, some (e.g. `musl-gcc`) don't, |
| // so we just always add it. |
| fn add_eh_frame_header(&mut self) { |
| self.linker_arg("--eh-frame-hdr"); |
| } |
| |
| fn add_no_exec(&mut self) { |
| if self.sess.target.is_like_windows { |
| self.linker_arg("--nxcompat"); |
| } else if self.is_gnu { |
| self.linker_args(&["-z", "noexecstack"]); |
| } |
| } |
| |
| fn add_as_needed(&mut self) { |
| if self.is_gnu && !self.sess.target.is_like_windows { |
| self.linker_arg("--as-needed"); |
| } else if self.sess.target.is_like_solaris { |
| // -z ignore is the Solaris equivalent to the GNU ld --as-needed option |
| self.linker_args(&["-z", "ignore"]); |
| } |
| } |
| } |
| |
| pub struct MsvcLinker<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| } |
| |
| impl<'a> Linker for MsvcLinker<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, output_kind: LinkOutputKind, out_filename: &Path) { |
| match output_kind { |
| LinkOutputKind::DynamicNoPicExe |
| | LinkOutputKind::DynamicPicExe |
| | LinkOutputKind::StaticNoPicExe |
| | LinkOutputKind::StaticPicExe => {} |
| LinkOutputKind::DynamicDylib | LinkOutputKind::StaticDylib => { |
| self.cmd.arg("/DLL"); |
| let mut arg: OsString = "/IMPLIB:".into(); |
| arg.push(out_filename.with_extension("dll.lib")); |
| self.cmd.arg(arg); |
| } |
| LinkOutputKind::WasiReactorExe => { |
| panic!("can't link as reactor on non-wasi target"); |
| } |
| } |
| } |
| |
| fn link_dylib_by_name(&mut self, name: &str, verbatim: bool, _as_needed: bool) { |
| self.cmd.arg(format!("{}{}", name, if verbatim { "" } else { ".lib" })); |
| } |
| |
| fn link_staticlib_by_name(&mut self, name: &str, verbatim: bool, whole_archive: bool) { |
| let prefix = if whole_archive { "/WHOLEARCHIVE:" } else { "" }; |
| let suffix = if verbatim { "" } else { ".lib" }; |
| self.cmd.arg(format!("{prefix}{name}{suffix}")); |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, whole_archive: bool) { |
| if !whole_archive { |
| self.cmd.arg(path); |
| } else { |
| let mut arg = OsString::from("/WHOLEARCHIVE:"); |
| arg.push(path); |
| self.cmd.arg(arg); |
| } |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| |
| fn gc_sections(&mut self, _keep_metadata: bool) { |
| // MSVC's ICF (Identical COMDAT Folding) link optimization is |
| // slow for Rust and thus we disable it by default when not in |
| // optimization build. |
| if self.sess.opts.optimize != config::OptLevel::No { |
| self.cmd.arg("/OPT:REF,ICF"); |
| } else { |
| // It is necessary to specify NOICF here, because /OPT:REF |
| // implies ICF by default. |
| self.cmd.arg("/OPT:REF,NOICF"); |
| } |
| } |
| |
| fn no_gc_sections(&mut self) { |
| self.cmd.arg("/OPT:NOREF,NOICF"); |
| } |
| |
| fn full_relro(&mut self) { |
| // noop |
| } |
| |
| fn partial_relro(&mut self) { |
| // noop |
| } |
| |
| fn no_relro(&mut self) { |
| // noop |
| } |
| |
| fn no_crt_objects(&mut self) { |
| // noop |
| } |
| |
| fn no_default_libraries(&mut self) { |
| self.cmd.arg("/NODEFAULTLIB"); |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| let mut arg = OsString::from("/LIBPATH:"); |
| arg.push(path); |
| self.cmd.arg(&arg); |
| } |
| |
| fn output_filename(&mut self, path: &Path) { |
| let mut arg = OsString::from("/OUT:"); |
| arg.push(path); |
| self.cmd.arg(&arg); |
| } |
| |
| fn framework_path(&mut self, _path: &Path) { |
| bug!("frameworks are not supported on windows") |
| } |
| |
| fn optimize(&mut self) { |
| // Needs more investigation of `/OPT` arguments |
| } |
| |
| fn pgo_gen(&mut self) { |
| // Nothing needed here. |
| } |
| |
| fn control_flow_guard(&mut self) { |
| self.cmd.arg("/guard:cf"); |
| } |
| |
| fn ehcont_guard(&mut self) { |
| if self.sess.target.pointer_width == 64 { |
| self.cmd.arg("/guard:ehcont"); |
| } |
| } |
| |
| fn debuginfo(&mut self, _strip: Strip, natvis_debugger_visualizers: &[PathBuf]) { |
| // This will cause the Microsoft linker to generate a PDB file |
| // from the CodeView line tables in the object files. |
| self.cmd.arg("/DEBUG"); |
| |
| // Default to emitting only the file name of the PDB file into |
| // the binary instead of the full path. Emitting the full path |
| // may leak private information (such as user names). |
| // See https://github.com/rust-lang/rust/issues/87825. |
| // |
| // This default behavior can be overridden by explicitly passing |
| // `-Clink-arg=/PDBALTPATH:...` to rustc. |
| self.cmd.arg("/PDBALTPATH:%_PDB%"); |
| |
| // This will cause the Microsoft linker to embed .natvis info into the PDB file |
| let natvis_dir_path = self.sess.sysroot.join("lib\\rustlib\\etc"); |
| if let Ok(natvis_dir) = fs::read_dir(&natvis_dir_path) { |
| for entry in natvis_dir { |
| match entry { |
| Ok(entry) => { |
| let path = entry.path(); |
| if path.extension() == Some("natvis".as_ref()) { |
| let mut arg = OsString::from("/NATVIS:"); |
| arg.push(path); |
| self.cmd.arg(arg); |
| } |
| } |
| Err(error) => { |
| self.sess.dcx().emit_warn(errors::NoNatvisDirectory { error }); |
| } |
| } |
| } |
| } |
| |
| // This will cause the Microsoft linker to embed .natvis info for all crates into the PDB file |
| for path in natvis_debugger_visualizers { |
| let mut arg = OsString::from("/NATVIS:"); |
| arg.push(path); |
| self.cmd.arg(arg); |
| } |
| } |
| |
| // Currently the compiler doesn't use `dllexport` (an LLVM attribute) to |
| // export symbols from a dynamic library. When building a dynamic library, |
| // however, we're going to want some symbols exported, so this function |
| // generates a DEF file which lists all the symbols. |
| // |
| // The linker will read this `*.def` file and export all the symbols from |
| // the dynamic library. Note that this is not as simple as just exporting |
| // all the symbols in the current crate (as specified by `codegen.reachable`) |
| // but rather we also need to possibly export the symbols of upstream |
| // crates. Upstream rlibs may be linked statically to this dynamic library, |
| // in which case they may continue to transitively be used and hence need |
| // their symbols exported. |
| fn export_symbols(&mut self, tmpdir: &Path, crate_type: CrateType, symbols: &[String]) { |
| // Symbol visibility takes care of this typically |
| if crate_type == CrateType::Executable { |
| let should_export_executable_symbols = |
| self.sess.opts.unstable_opts.export_executable_symbols; |
| if !should_export_executable_symbols { |
| return; |
| } |
| } |
| |
| let path = tmpdir.join("lib.def"); |
| let res: io::Result<()> = try { |
| let mut f = BufWriter::new(File::create(&path)?); |
| |
| // Start off with the standard module name header and then go |
| // straight to exports. |
| writeln!(f, "LIBRARY")?; |
| writeln!(f, "EXPORTS")?; |
| for symbol in symbols { |
| debug!(" _{symbol}"); |
| writeln!(f, " {symbol}")?; |
| } |
| }; |
| if let Err(error) = res { |
| self.sess.dcx().emit_fatal(errors::LibDefWriteFailure { error }); |
| } |
| let mut arg = OsString::from("/DEF:"); |
| arg.push(path); |
| self.cmd.arg(&arg); |
| } |
| |
| fn subsystem(&mut self, subsystem: &str) { |
| // Note that previous passes of the compiler validated this subsystem, |
| // so we just blindly pass it to the linker. |
| self.cmd.arg(&format!("/SUBSYSTEM:{subsystem}")); |
| |
| // Windows has two subsystems we're interested in right now, the console |
| // and windows subsystems. These both implicitly have different entry |
| // points (starting symbols). The console entry point starts with |
| // `mainCRTStartup` and the windows entry point starts with |
| // `WinMainCRTStartup`. These entry points, defined in system libraries, |
| // will then later probe for either `main` or `WinMain`, respectively to |
| // start the application. |
| // |
| // In Rust we just always generate a `main` function so we want control |
| // to always start there, so we force the entry point on the windows |
| // subsystem to be `mainCRTStartup` to get everything booted up |
| // correctly. |
| // |
| // For more information see RFC #1665 |
| if subsystem == "windows" { |
| self.cmd.arg("/ENTRY:mainCRTStartup"); |
| } |
| } |
| |
| fn linker_plugin_lto(&mut self) { |
| // Do nothing |
| } |
| |
| fn add_no_exec(&mut self) { |
| self.cmd.arg("/NXCOMPAT"); |
| } |
| } |
| |
| pub struct EmLinker<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| } |
| |
| impl<'a> Linker for EmLinker<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, _output_kind: LinkOutputKind, _out_filename: &Path) {} |
| |
| fn link_dylib_by_name(&mut self, name: &str, _verbatim: bool, _as_needed: bool) { |
| // Emscripten always links statically |
| self.cmd.arg("-l").arg(name); |
| } |
| |
| fn link_staticlib_by_name(&mut self, name: &str, _verbatim: bool, _whole_archive: bool) { |
| self.cmd.arg("-l").arg(name); |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, _whole_archive: bool) { |
| self.cmd.arg(path); |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| |
| fn full_relro(&mut self) { |
| // noop |
| } |
| |
| fn partial_relro(&mut self) { |
| // noop |
| } |
| |
| fn no_relro(&mut self) { |
| // noop |
| } |
| |
| fn framework_path(&mut self, _path: &Path) { |
| bug!("frameworks are not supported on Emscripten") |
| } |
| |
| fn gc_sections(&mut self, _keep_metadata: bool) { |
| // noop |
| } |
| |
| fn no_gc_sections(&mut self) { |
| // noop |
| } |
| |
| fn optimize(&mut self) { |
| // Emscripten performs own optimizations |
| self.cmd.arg(match self.sess.opts.optimize { |
| OptLevel::No => "-O0", |
| OptLevel::Less => "-O1", |
| OptLevel::Default => "-O2", |
| OptLevel::Aggressive => "-O3", |
| OptLevel::Size => "-Os", |
| OptLevel::SizeMin => "-Oz", |
| }); |
| } |
| |
| fn pgo_gen(&mut self) { |
| // noop, but maybe we need something like the gnu linker? |
| } |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn debuginfo(&mut self, _strip: Strip, _: &[PathBuf]) { |
| // Preserve names or generate source maps depending on debug info |
| // For more information see https://emscripten.org/docs/tools_reference/emcc.html#emcc-g |
| self.cmd.arg(match self.sess.opts.debuginfo { |
| DebugInfo::None => "-g0", |
| DebugInfo::Limited | DebugInfo::LineTablesOnly | DebugInfo::LineDirectivesOnly => { |
| "--profiling-funcs" |
| } |
| DebugInfo::Full => "-g", |
| }); |
| } |
| |
| fn no_crt_objects(&mut self) {} |
| |
| fn no_default_libraries(&mut self) { |
| self.cmd.arg("-nodefaultlibs"); |
| } |
| |
| fn export_symbols(&mut self, _tmpdir: &Path, _crate_type: CrateType, symbols: &[String]) { |
| debug!("EXPORTED SYMBOLS:"); |
| |
| self.cmd.arg("-s"); |
| |
| let mut arg = OsString::from("EXPORTED_FUNCTIONS="); |
| let encoded = serde_json::to_string( |
| &symbols.iter().map(|sym| "_".to_owned() + sym).collect::<Vec<_>>(), |
| ) |
| .unwrap(); |
| debug!("{encoded}"); |
| |
| arg.push(encoded); |
| |
| self.cmd.arg(arg); |
| } |
| |
| fn subsystem(&mut self, _subsystem: &str) { |
| // noop |
| } |
| |
| fn linker_plugin_lto(&mut self) { |
| // Do nothing |
| } |
| } |
| |
| pub struct WasmLd<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| } |
| |
| impl<'a> WasmLd<'a> { |
| fn new(mut cmd: Command, sess: &'a Session) -> WasmLd<'a> { |
| // If the atomics feature is enabled for wasm then we need a whole bunch |
| // of flags: |
| // |
| // * `--shared-memory` - the link won't even succeed without this, flags |
| // the one linear memory as `shared` |
| // |
| // * `--max-memory=1G` - when specifying a shared memory this must also |
| // be specified. We conservatively choose 1GB but users should be able |
| // to override this with `-C link-arg`. |
| // |
| // * `--import-memory` - it doesn't make much sense for memory to be |
| // exported in a threaded module because typically you're |
| // sharing memory and instantiating the module multiple times. As a |
| // result if it were exported then we'd just have no sharing. |
| // |
| // On wasm32-unknown-unknown, we also export symbols for glue code to use: |
| // * `--export=*tls*` - when `#[thread_local]` symbols are used these |
| // symbols are how the TLS segments are initialized and configured. |
| if sess.target_features.contains(&sym::atomics) { |
| cmd.arg("--shared-memory"); |
| cmd.arg("--max-memory=1073741824"); |
| cmd.arg("--import-memory"); |
| if sess.target.os == "unknown" { |
| cmd.arg("--export=__wasm_init_tls"); |
| cmd.arg("--export=__tls_size"); |
| cmd.arg("--export=__tls_align"); |
| cmd.arg("--export=__tls_base"); |
| } |
| } |
| WasmLd { cmd, sess } |
| } |
| } |
| |
| impl<'a> Linker for WasmLd<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, output_kind: LinkOutputKind, _out_filename: &Path) { |
| match output_kind { |
| LinkOutputKind::DynamicNoPicExe |
| | LinkOutputKind::DynamicPicExe |
| | LinkOutputKind::StaticNoPicExe |
| | LinkOutputKind::StaticPicExe => {} |
| LinkOutputKind::DynamicDylib | LinkOutputKind::StaticDylib => { |
| self.cmd.arg("--no-entry"); |
| } |
| LinkOutputKind::WasiReactorExe => { |
| self.cmd.arg("--entry"); |
| self.cmd.arg("_initialize"); |
| } |
| } |
| } |
| |
| fn link_dylib_by_name(&mut self, name: &str, _verbatim: bool, _as_needed: bool) { |
| self.cmd.arg("-l").arg(name); |
| } |
| |
| fn link_staticlib_by_name(&mut self, name: &str, _verbatim: bool, whole_archive: bool) { |
| if !whole_archive { |
| self.cmd.arg("-l").arg(name); |
| } else { |
| self.cmd.arg("--whole-archive").arg("-l").arg(name).arg("--no-whole-archive"); |
| } |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, whole_archive: bool) { |
| if !whole_archive { |
| self.cmd.arg(path); |
| } else { |
| self.cmd.arg("--whole-archive").arg(path).arg("--no-whole-archive"); |
| } |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| |
| fn framework_path(&mut self, _path: &Path) { |
| panic!("frameworks not supported") |
| } |
| |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| |
| fn full_relro(&mut self) {} |
| |
| fn partial_relro(&mut self) {} |
| |
| fn no_relro(&mut self) {} |
| |
| fn gc_sections(&mut self, _keep_metadata: bool) { |
| self.cmd.arg("--gc-sections"); |
| } |
| |
| fn no_gc_sections(&mut self) { |
| self.cmd.arg("--no-gc-sections"); |
| } |
| |
| fn optimize(&mut self) { |
| // The -O flag is, as of late 2023, only used for merging of strings and debuginfo, and |
| // only differentiates -O0 and -O1. It does not apply to LTO. |
| self.cmd.arg(match self.sess.opts.optimize { |
| OptLevel::No => "-O0", |
| OptLevel::Less => "-O1", |
| OptLevel::Default => "-O2", |
| OptLevel::Aggressive => "-O3", |
| // Currently LLD doesn't support `Os` and `Oz`, so pass through `O2` |
| // instead. |
| OptLevel::Size => "-O2", |
| OptLevel::SizeMin => "-O2", |
| }); |
| } |
| |
| fn pgo_gen(&mut self) {} |
| |
| fn debuginfo(&mut self, strip: Strip, _: &[PathBuf]) { |
| match strip { |
| Strip::None => {} |
| Strip::Debuginfo => { |
| self.cmd.arg("--strip-debug"); |
| } |
| Strip::Symbols => { |
| self.cmd.arg("--strip-all"); |
| } |
| } |
| } |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn no_crt_objects(&mut self) {} |
| |
| fn no_default_libraries(&mut self) {} |
| |
| fn export_symbols(&mut self, _tmpdir: &Path, _crate_type: CrateType, symbols: &[String]) { |
| for sym in symbols { |
| self.cmd.arg("--export").arg(&sym); |
| } |
| |
| // LLD will hide these otherwise-internal symbols since it only exports |
| // symbols explicitly passed via the `--export` flags above and hides all |
| // others. Various bits and pieces of wasm32-unknown-unknown tooling use |
| // this, so be sure these symbols make their way out of the linker as well. |
| if self.sess.target.os == "unknown" { |
| self.cmd.arg("--export=__heap_base"); |
| self.cmd.arg("--export=__data_end"); |
| } |
| } |
| |
| fn subsystem(&mut self, _subsystem: &str) {} |
| |
| fn linker_plugin_lto(&mut self) { |
| match self.sess.opts.cg.linker_plugin_lto { |
| LinkerPluginLto::Disabled => { |
| // Nothing to do |
| } |
| LinkerPluginLto::LinkerPluginAuto => { |
| self.push_linker_plugin_lto_args(); |
| } |
| LinkerPluginLto::LinkerPlugin(_) => { |
| self.push_linker_plugin_lto_args(); |
| } |
| } |
| } |
| } |
| |
| impl<'a> WasmLd<'a> { |
| fn push_linker_plugin_lto_args(&mut self) { |
| let opt_level = match self.sess.opts.optimize { |
| config::OptLevel::No => "O0", |
| config::OptLevel::Less => "O1", |
| config::OptLevel::Default => "O2", |
| config::OptLevel::Aggressive => "O3", |
| // wasm-ld only handles integer LTO opt levels. Use O2 |
| config::OptLevel::Size | config::OptLevel::SizeMin => "O2", |
| }; |
| self.cmd.arg(&format!("--lto-{opt_level}")); |
| } |
| } |
| |
| /// Linker shepherd script for L4Re (Fiasco) |
| pub struct L4Bender<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| hinted_static: bool, |
| } |
| |
| impl<'a> Linker for L4Bender<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, _output_kind: LinkOutputKind, _out_filename: &Path) {} |
| |
| fn link_dylib_by_name(&mut self, _name: &str, _verbatim: bool, _as_needed: bool) { |
| bug!("dylibs are not supported on L4Re"); |
| } |
| |
| fn link_staticlib_by_name(&mut self, name: &str, _verbatim: bool, whole_archive: bool) { |
| self.hint_static(); |
| if !whole_archive { |
| self.cmd.arg(format!("-PC{name}")); |
| } else { |
| self.cmd.arg("--whole-archive").arg(format!("-l{name}")).arg("--no-whole-archive"); |
| } |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, whole_archive: bool) { |
| self.hint_static(); |
| if !whole_archive { |
| self.cmd.arg(path); |
| } else { |
| self.cmd.arg("--whole-archive").arg(path).arg("--no-whole-archive"); |
| } |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| fn framework_path(&mut self, _: &Path) { |
| bug!("frameworks are not supported on L4Re"); |
| } |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| |
| fn full_relro(&mut self) { |
| self.cmd.arg("-z").arg("relro"); |
| self.cmd.arg("-z").arg("now"); |
| } |
| |
| fn partial_relro(&mut self) { |
| self.cmd.arg("-z").arg("relro"); |
| } |
| |
| fn no_relro(&mut self) { |
| self.cmd.arg("-z").arg("norelro"); |
| } |
| |
| fn gc_sections(&mut self, keep_metadata: bool) { |
| if !keep_metadata { |
| self.cmd.arg("--gc-sections"); |
| } |
| } |
| |
| fn no_gc_sections(&mut self) { |
| self.cmd.arg("--no-gc-sections"); |
| } |
| |
| fn optimize(&mut self) { |
| // GNU-style linkers support optimization with -O. GNU ld doesn't |
| // need a numeric argument, but other linkers do. |
| if self.sess.opts.optimize == config::OptLevel::Default |
| || self.sess.opts.optimize == config::OptLevel::Aggressive |
| { |
| self.cmd.arg("-O1"); |
| } |
| } |
| |
| fn pgo_gen(&mut self) {} |
| |
| fn debuginfo(&mut self, strip: Strip, _: &[PathBuf]) { |
| match strip { |
| Strip::None => {} |
| Strip::Debuginfo => { |
| self.cmd().arg("--strip-debug"); |
| } |
| Strip::Symbols => { |
| self.cmd().arg("--strip-all"); |
| } |
| } |
| } |
| |
| fn no_default_libraries(&mut self) { |
| self.cmd.arg("-nostdlib"); |
| } |
| |
| fn export_symbols(&mut self, _: &Path, _: CrateType, _: &[String]) { |
| // ToDo, not implemented, copy from GCC |
| self.sess.dcx().emit_warn(errors::L4BenderExportingSymbolsUnimplemented); |
| return; |
| } |
| |
| fn subsystem(&mut self, subsystem: &str) { |
| self.cmd.arg(&format!("--subsystem {subsystem}")); |
| } |
| |
| fn reset_per_library_state(&mut self) { |
| self.hint_static(); // Reset to default before returning the composed command line. |
| } |
| |
| fn linker_plugin_lto(&mut self) {} |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn no_crt_objects(&mut self) {} |
| } |
| |
| impl<'a> L4Bender<'a> { |
| pub fn new(cmd: Command, sess: &'a Session) -> L4Bender<'a> { |
| L4Bender { cmd: cmd, sess: sess, hinted_static: false } |
| } |
| |
| fn hint_static(&mut self) { |
| if !self.hinted_static { |
| self.cmd.arg("-static"); |
| self.hinted_static = true; |
| } |
| } |
| } |
| |
| /// Linker for AIX. |
| pub struct AixLinker<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| hinted_static: Option<bool>, |
| } |
| |
| impl<'a> AixLinker<'a> { |
| pub fn new(cmd: Command, sess: &'a Session) -> AixLinker<'a> { |
| AixLinker { cmd: cmd, sess: sess, hinted_static: None } |
| } |
| |
| fn hint_static(&mut self) { |
| if self.hinted_static != Some(true) { |
| self.cmd.arg("-bstatic"); |
| self.hinted_static = Some(true); |
| } |
| } |
| |
| fn hint_dynamic(&mut self) { |
| if self.hinted_static != Some(false) { |
| self.cmd.arg("-bdynamic"); |
| self.hinted_static = Some(false); |
| } |
| } |
| |
| fn build_dylib(&mut self, _out_filename: &Path) { |
| self.cmd.arg("-bM:SRE"); |
| self.cmd.arg("-bnoentry"); |
| // FIXME: Use CreateExportList utility to create export list |
| // and remove -bexpfull. |
| self.cmd.arg("-bexpfull"); |
| } |
| } |
| |
| impl<'a> Linker for AixLinker<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, output_kind: LinkOutputKind, out_filename: &Path) { |
| match output_kind { |
| LinkOutputKind::DynamicDylib => { |
| self.hint_dynamic(); |
| self.build_dylib(out_filename); |
| } |
| LinkOutputKind::StaticDylib => { |
| self.hint_static(); |
| self.build_dylib(out_filename); |
| } |
| _ => {} |
| } |
| } |
| |
| fn link_dylib_by_name(&mut self, name: &str, _verbatim: bool, _as_needed: bool) { |
| self.hint_dynamic(); |
| self.cmd.arg(format!("-l{name}")); |
| } |
| |
| fn link_staticlib_by_name(&mut self, name: &str, verbatim: bool, whole_archive: bool) { |
| self.hint_static(); |
| if !whole_archive { |
| self.cmd.arg(format!("-l{name}")); |
| } else { |
| let mut arg = OsString::from("-bkeepfile:"); |
| arg.push(find_native_static_library(name, verbatim, self.sess)); |
| self.cmd.arg(arg); |
| } |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, whole_archive: bool) { |
| self.hint_static(); |
| if !whole_archive { |
| self.cmd.arg(path); |
| } else { |
| let mut arg = OsString::from("-bkeepfile:"); |
| arg.push(path); |
| self.cmd.arg(arg); |
| } |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| |
| fn framework_path(&mut self, _: &Path) { |
| bug!("frameworks are not supported on AIX"); |
| } |
| |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| |
| fn full_relro(&mut self) {} |
| |
| fn partial_relro(&mut self) {} |
| |
| fn no_relro(&mut self) {} |
| |
| fn gc_sections(&mut self, _keep_metadata: bool) { |
| self.cmd.arg("-bgc"); |
| } |
| |
| fn no_gc_sections(&mut self) { |
| self.cmd.arg("-bnogc"); |
| } |
| |
| fn optimize(&mut self) {} |
| |
| fn pgo_gen(&mut self) { |
| self.cmd.arg("-bdbg:namedsects:ss"); |
| } |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn debuginfo(&mut self, _: Strip, _: &[PathBuf]) {} |
| |
| fn no_crt_objects(&mut self) {} |
| |
| fn no_default_libraries(&mut self) {} |
| |
| fn export_symbols(&mut self, tmpdir: &Path, _crate_type: CrateType, symbols: &[String]) { |
| let path = tmpdir.join("list.exp"); |
| let res: io::Result<()> = try { |
| let mut f = BufWriter::new(File::create(&path)?); |
| // FIXME: use llvm-nm to generate export list. |
| for symbol in symbols { |
| debug!(" _{symbol}"); |
| writeln!(f, " {symbol}")?; |
| } |
| }; |
| if let Err(e) = res { |
| self.sess.dcx().fatal(format!("failed to write export file: {e}")); |
| } |
| self.cmd.arg(format!("-bE:{}", path.to_str().unwrap())); |
| } |
| |
| fn subsystem(&mut self, _subsystem: &str) {} |
| |
| fn reset_per_library_state(&mut self) { |
| self.hint_dynamic(); |
| } |
| |
| fn linker_plugin_lto(&mut self) {} |
| |
| fn add_eh_frame_header(&mut self) {} |
| |
| fn add_no_exec(&mut self) {} |
| |
| fn add_as_needed(&mut self) {} |
| } |
| |
| fn for_each_exported_symbols_include_dep<'tcx>( |
| tcx: TyCtxt<'tcx>, |
| crate_type: CrateType, |
| mut callback: impl FnMut(ExportedSymbol<'tcx>, SymbolExportInfo, CrateNum), |
| ) { |
| for &(symbol, info) in tcx.exported_symbols(LOCAL_CRATE).iter() { |
| callback(symbol, info, LOCAL_CRATE); |
| } |
| |
| let formats = tcx.dependency_formats(()); |
| let deps = formats.iter().find_map(|(t, list)| (*t == crate_type).then_some(list)).unwrap(); |
| |
| for (index, dep_format) in deps.iter().enumerate() { |
| let cnum = CrateNum::new(index + 1); |
| // For each dependency that we are linking to statically ... |
| if *dep_format == Linkage::Static { |
| for &(symbol, info) in tcx.exported_symbols(cnum).iter() { |
| callback(symbol, info, cnum); |
| } |
| } |
| } |
| } |
| |
| pub(crate) fn exported_symbols(tcx: TyCtxt<'_>, crate_type: CrateType) -> Vec<String> { |
| if let Some(ref exports) = tcx.sess.target.override_export_symbols { |
| return exports.iter().map(ToString::to_string).collect(); |
| } |
| |
| if let CrateType::ProcMacro = crate_type { |
| exported_symbols_for_proc_macro_crate(tcx) |
| } else { |
| exported_symbols_for_non_proc_macro(tcx, crate_type) |
| } |
| } |
| |
| fn exported_symbols_for_non_proc_macro(tcx: TyCtxt<'_>, crate_type: CrateType) -> Vec<String> { |
| let mut symbols = Vec::new(); |
| let export_threshold = symbol_export::crates_export_threshold(&[crate_type]); |
| for_each_exported_symbols_include_dep(tcx, crate_type, |symbol, info, cnum| { |
| if info.level.is_below_threshold(export_threshold) { |
| symbols.push(symbol_export::exporting_symbol_name_for_instance_in_crate( |
| tcx, symbol, cnum, |
| )); |
| } |
| }); |
| |
| symbols |
| } |
| |
| fn exported_symbols_for_proc_macro_crate(tcx: TyCtxt<'_>) -> Vec<String> { |
| // `exported_symbols` will be empty when !should_codegen. |
| if !tcx.sess.opts.output_types.should_codegen() { |
| return Vec::new(); |
| } |
| |
| let stable_crate_id = tcx.stable_crate_id(LOCAL_CRATE); |
| let proc_macro_decls_name = tcx.sess.generate_proc_macro_decls_symbol(stable_crate_id); |
| let metadata_symbol_name = exported_symbols::metadata_symbol_name(tcx); |
| |
| vec![proc_macro_decls_name, metadata_symbol_name] |
| } |
| |
| pub(crate) fn linked_symbols( |
| tcx: TyCtxt<'_>, |
| crate_type: CrateType, |
| ) -> Vec<(String, SymbolExportKind)> { |
| match crate_type { |
| CrateType::Executable | CrateType::Cdylib | CrateType::Dylib => (), |
| CrateType::Staticlib | CrateType::ProcMacro | CrateType::Rlib => { |
| return Vec::new(); |
| } |
| } |
| |
| let mut symbols = Vec::new(); |
| |
| let export_threshold = symbol_export::crates_export_threshold(&[crate_type]); |
| for_each_exported_symbols_include_dep(tcx, crate_type, |symbol, info, cnum| { |
| if info.level.is_below_threshold(export_threshold) || info.used { |
| symbols.push(( |
| symbol_export::linking_symbol_name_for_instance_in_crate(tcx, symbol, cnum), |
| info.kind, |
| )); |
| } |
| }); |
| |
| symbols |
| } |
| |
| /// Much simplified and explicit CLI for the NVPTX linker. The linker operates |
| /// with bitcode and uses LLVM backend to generate a PTX assembly. |
| pub struct PtxLinker<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| } |
| |
| impl<'a> Linker for PtxLinker<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, _output_kind: LinkOutputKind, _out_filename: &Path) {} |
| |
| fn link_dylib_by_name(&mut self, _name: &str, _verbatim: bool, _as_needed: bool) { |
| panic!("external dylibs not supported") |
| } |
| |
| fn link_staticlib_by_name(&mut self, _name: &str, _verbatim: bool, _whole_archive: bool) { |
| panic!("staticlibs not supported") |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, _whole_archive: bool) { |
| self.cmd.arg("--rlib").arg(path); |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| |
| fn debuginfo(&mut self, _strip: Strip, _: &[PathBuf]) { |
| self.cmd.arg("--debug"); |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg("--bitcode").arg(path); |
| } |
| |
| fn optimize(&mut self) { |
| match self.sess.lto() { |
| Lto::Thin | Lto::Fat | Lto::ThinLocal => { |
| self.cmd.arg("-Olto"); |
| } |
| |
| Lto::No => {} |
| } |
| } |
| |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| |
| fn framework_path(&mut self, _path: &Path) { |
| panic!("frameworks not supported") |
| } |
| |
| fn full_relro(&mut self) {} |
| |
| fn partial_relro(&mut self) {} |
| |
| fn no_relro(&mut self) {} |
| |
| fn gc_sections(&mut self, _keep_metadata: bool) {} |
| |
| fn no_gc_sections(&mut self) {} |
| |
| fn pgo_gen(&mut self) {} |
| |
| fn no_crt_objects(&mut self) {} |
| |
| fn no_default_libraries(&mut self) {} |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn export_symbols(&mut self, _tmpdir: &Path, _crate_type: CrateType, _symbols: &[String]) {} |
| |
| fn subsystem(&mut self, _subsystem: &str) {} |
| |
| fn linker_plugin_lto(&mut self) {} |
| } |
| |
| /// The `self-contained` LLVM bitcode linker |
| pub struct LlbcLinker<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| } |
| |
| impl<'a> Linker for LlbcLinker<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, _output_kind: LinkOutputKind, _out_filename: &Path) {} |
| |
| fn link_dylib_by_name(&mut self, _name: &str, _verbatim: bool, _as_needed: bool) { |
| panic!("external dylibs not supported") |
| } |
| |
| fn link_staticlib_by_name(&mut self, _name: &str, _verbatim: bool, _whole_archive: bool) { |
| panic!("staticlibs not supported") |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, _whole_archive: bool) { |
| self.cmd.arg(path); |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| |
| fn debuginfo(&mut self, _strip: Strip, _: &[PathBuf]) { |
| self.cmd.arg("--debug"); |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| |
| fn optimize(&mut self) { |
| match self.sess.opts.optimize { |
| OptLevel::No => "-O0", |
| OptLevel::Less => "-O1", |
| OptLevel::Default => "-O2", |
| OptLevel::Aggressive => "-O3", |
| OptLevel::Size => "-Os", |
| OptLevel::SizeMin => "-Oz", |
| }; |
| } |
| |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| |
| fn framework_path(&mut self, _path: &Path) { |
| panic!("frameworks not supported") |
| } |
| |
| fn full_relro(&mut self) {} |
| |
| fn partial_relro(&mut self) {} |
| |
| fn no_relro(&mut self) {} |
| |
| fn gc_sections(&mut self, _keep_metadata: bool) {} |
| |
| fn no_gc_sections(&mut self) {} |
| |
| fn pgo_gen(&mut self) {} |
| |
| fn no_crt_objects(&mut self) {} |
| |
| fn no_default_libraries(&mut self) {} |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn export_symbols(&mut self, _tmpdir: &Path, _crate_type: CrateType, symbols: &[String]) { |
| match _crate_type { |
| CrateType::Cdylib => { |
| for sym in symbols { |
| self.cmd.arg("--export-symbol").arg(sym); |
| } |
| } |
| _ => (), |
| } |
| } |
| |
| fn subsystem(&mut self, _subsystem: &str) {} |
| |
| fn linker_plugin_lto(&mut self) {} |
| } |
| |
| pub struct BpfLinker<'a> { |
| cmd: Command, |
| sess: &'a Session, |
| } |
| |
| impl<'a> Linker for BpfLinker<'a> { |
| fn cmd(&mut self) -> &mut Command { |
| &mut self.cmd |
| } |
| |
| fn set_output_kind(&mut self, _output_kind: LinkOutputKind, _out_filename: &Path) {} |
| |
| fn link_dylib_by_name(&mut self, _name: &str, _verbatim: bool, _as_needed: bool) { |
| panic!("external dylibs not supported") |
| } |
| |
| fn link_staticlib_by_name(&mut self, _name: &str, _verbatim: bool, _whole_archive: bool) { |
| panic!("staticlibs not supported") |
| } |
| |
| fn link_staticlib_by_path(&mut self, path: &Path, _whole_archive: bool) { |
| self.cmd.arg(path); |
| } |
| |
| fn include_path(&mut self, path: &Path) { |
| self.cmd.arg("-L").arg(path); |
| } |
| |
| fn debuginfo(&mut self, _strip: Strip, _: &[PathBuf]) { |
| self.cmd.arg("--debug"); |
| } |
| |
| fn add_object(&mut self, path: &Path) { |
| self.cmd.arg(path); |
| } |
| |
| fn optimize(&mut self) { |
| self.cmd.arg(match self.sess.opts.optimize { |
| OptLevel::No => "-O0", |
| OptLevel::Less => "-O1", |
| OptLevel::Default => "-O2", |
| OptLevel::Aggressive => "-O3", |
| OptLevel::Size => "-Os", |
| OptLevel::SizeMin => "-Oz", |
| }); |
| } |
| |
| fn output_filename(&mut self, path: &Path) { |
| self.cmd.arg("-o").arg(path); |
| } |
| |
| fn framework_path(&mut self, _path: &Path) { |
| panic!("frameworks not supported") |
| } |
| |
| fn full_relro(&mut self) {} |
| |
| fn partial_relro(&mut self) {} |
| |
| fn no_relro(&mut self) {} |
| |
| fn gc_sections(&mut self, _keep_metadata: bool) {} |
| |
| fn no_gc_sections(&mut self) {} |
| |
| fn pgo_gen(&mut self) {} |
| |
| fn no_crt_objects(&mut self) {} |
| |
| fn no_default_libraries(&mut self) {} |
| |
| fn control_flow_guard(&mut self) {} |
| |
| fn ehcont_guard(&mut self) {} |
| |
| fn export_symbols(&mut self, tmpdir: &Path, _crate_type: CrateType, symbols: &[String]) { |
| let path = tmpdir.join("symbols"); |
| let res: io::Result<()> = try { |
| let mut f = BufWriter::new(File::create(&path)?); |
| for sym in symbols { |
| writeln!(f, "{sym}")?; |
| } |
| }; |
| if let Err(error) = res { |
| self.sess.dcx().emit_fatal(errors::SymbolFileWriteFailure { error }); |
| } else { |
| self.cmd.arg("--export-symbols").arg(&path); |
| } |
| } |
| |
| fn subsystem(&mut self, _subsystem: &str) {} |
| |
| fn linker_plugin_lto(&mut self) {} |
| } |
