run-make-support: add clang and llvm-readobj command wrappers

Author: jieyouxu

src/tools/run-make-support/src/clang.rs

@@ -0,0 +1,73 @@
+use std::env;
+use std::path::Path;
+use std::process::Command;
+
+usecrate::{bin_name, handle_failed_output, tmp_dir};
+
+/// Construct a new `clang` invocation. `clang` is not always available for all targets.
+pubfnclang() -> Clang{
+Clang::new()
+}
+
+/// A `clang` invocation builder.
+#[derive(Debug)]
+pubstructClang{
+cmd:Command,
+}
+
+crate::impl_common_helpers!(Clang);
+
+implClang{
+/// Construct a new `clang` invocation. `clang` is not always available for all targets.
+pubfnnew() -> Self{
+let clang =
+ env::var("CLANG").expect("`CLANG` not specified, but this is required to find `clang`");
+let cmd = Command::new(clang);
+Self{ cmd }
+}
+
+/// Provide an input file.
+pubfninput<P:AsRef<Path>>(&mutself,path:P) -> &mutSelf{
+self.cmd.arg(path.as_ref());
+self
+}
+
+/// Specify the name of the executable. The executable will be placed under `$TMPDIR`, and the
+/// extension will be determined by [`bin_name`].
+pubfnout_exe(&mutself,name:&str) -> &mutSelf{
+self.cmd.arg("-o");
+self.cmd.arg(tmp_dir().join(bin_name(name)));
+self
+}
+
+/// Specify which target triple clang should target.
+pubfntarget(&mutself,target_triple:&str) -> &mutSelf{
+self.cmd.arg("-target");
+self.cmd.arg(target_triple);
+self
+}
+
+/// Pass `-nostdlib` to disable linking the C standard library.
+pubfnno_stdlib(&mutself) -> &mutSelf{
+self.cmd.arg("-nostdlib");
+self
+}
+
+/// Specify architecture.
+pubfnarch(&mutself,arch:&str) -> &mutSelf{
+self.cmd.arg(format!("-march={arch}"));
+self
+}
+
+/// Specify LTO settings.
+pubfnlto(&mutself,lto:&str) -> &mutSelf{
+self.cmd.arg(format!("-flto={lto}"));
+self
+}
+
+/// Specify which ld to use.
+pubfnuse_ld(&mutself,ld:&str) -> &mutSelf{
+self.cmd.arg(format!("-fuse-ld={ld}"));
+self
+}
+}

src/tools/run-make-support/src/lib.rs

@@ -4,6 +4,8 @@
 //! as `object` or `wasmparser`, they can be re-exported and be made available through this library.
 
 pubmod cc;
+pubmod clang;
+pubmod llvm_readobj;
 pubmod run;
 pubmod rustc;
 pubmod rustdoc;
@@ -17,6 +19,8 @@ pub use regex;
 pubuse wasmparser;
 
 pubuse cc::{cc, extra_c_flags, extra_cxx_flags,Cc};
+pubuse clang::{clang,Clang};
+pubuse llvm_readobj::{llvm_readobj,LlvmReadobj};
 pubuse run::{run, run_fail};
 pubuse rustc::{aux_build, rustc,Rustc};
 pubuse rustdoc::{bare_rustdoc, rustdoc,Rustdoc};

src/tools/run-make-support/src/llvm_readobj.rs

@@ -0,0 +1,44 @@
+use std::env;
+use std::path::{Path,PathBuf};
+use std::process::Command;
+
+usecrate::handle_failed_output;
+
+/// Construct a new `llvm-readobj` invocation. This assumes that `llvm-readobj` is available
+/// at `$LLVM_BIN_DIR/llvm-readobj`.
+pubfnllvm_readobj() -> LlvmReadobj{
+LlvmReadobj::new()
+}
+
+/// A `llvm-readobj` invocation builder.
+#[derive(Debug)]
+pubstructLlvmReadobj{
+cmd:Command,
+}
+
+crate::impl_common_helpers!(LlvmReadobj);
+
+implLlvmReadobj{
+/// Construct a new `llvm-readobj` invocation. This assumes that `llvm-readobj` is available
+/// at `$LLVM_BIN_DIR/llvm-readobj`.
+pubfnnew() -> Self{
+let llvm_bin_dir = env::var("LLVM_BIN_DIR")
+.expect("`LLVM_BIN_DIR` not specified, but this is required to find `llvm-readobj`");
+let llvm_bin_dir = PathBuf::from(llvm_bin_dir);
+let llvm_readobj = llvm_bin_dir.join("llvm-readobj");
+let cmd = Command::new(llvm_readobj);
+Self{ cmd }
+}
+
+/// Provide an input file.
+pubfninput<P:AsRef<Path>>(&mutself,path:P) -> &mutSelf{
+self.cmd.arg(path.as_ref());
+self
+}
+
+/// Pass `--file-header` to display file headers.
+pubfnfile_header(&mutself) -> &mutSelf{
+self.cmd.arg("--file-header");
+self
+}
+}