Struct cargo::core::compiler::build_context::target_info::TargetInfo

pub struct TargetInfo {
    crate_type_process: ProcessBuilder,
    crate_types: RefCell<HashMap<CrateType, Option<(String, String)>>>,
    cfg: Vec<Cfg>,
    support_split_debuginfo: Vec<String>,
    pub sysroot: PathBuf,
    pub sysroot_target_libdir: PathBuf,
    pub rustflags: Vec<String>,
    pub rustdocflags: Vec<String>,
    pub support_check_cfg: bool,
}

Information about the platform target gleaned from querying rustc.

RustcTargetData keeps several of these, one for the host and the others for other specified targets. If no target is specified, it uses a clone from the host.

Fields

crate_type_process: ProcessBuilder

A base process builder for discovering crate type information. In particular, this is used to determine the output filename prefix and suffix for a crate type.

crate_types: RefCell<HashMap<CrateType, Option<(String, String)>>>

Cache of output filename prefixes and suffixes.

The key is the crate type name (like cdylib) and the value is Some((prefix, suffix)), for example libcargo.so would be Some(("lib", ".so")). The value is None if the crate type is not supported.

cfg: Vec<Cfg>

cfg information extracted from rustc --print=cfg.

support_split_debuginfo: Vec<String>

Supported values for -Csplit-debuginfo= flag, queried from rustc

sysroot: PathBuf

Path to the sysroot.

sysroot_target_libdir: PathBuf

Path to the “lib” directory in the sysroot which rustc uses for linking target libraries.

rustflags: Vec<String>

Extra flags to pass to rustc, see extra_args.

rustdocflags: Vec<String>

Extra flags to pass to rustdoc, see extra_args.

support_check_cfg: bool

Whether or not rustc (stably) supports the --check-cfg flag.

Can be removed once the minimum supported rustc version of Cargo is at minimum 1.80.0.

Implementations

impl TargetInfo

pub fn new( gctx: &GlobalContext, requested_kinds: &[CompileKind], rustc: &Rustc, kind: CompileKind ) -> CargoResult<TargetInfo>

Learns the information of target platform from rustc invocation(s).

Generally, the first time calling this function is expensive, as it may query rustc several times. To reduce the cost, output of each rustc invocation is cached by Rustc::cached_output.

Search Tricky to learn why querying rustc several times is needed.

fn not_user_specific_cfg(cfg: &CargoResult<Cfg>) -> bool

pub fn cfg(&self) -> &[Cfg]

All the target Cfg settings.

fn file_types( &self, crate_type: &CrateType, flavor: FileFlavor, target_triple: &str ) -> CargoResult<Option<Vec<FileType>>>

Returns the list of file types generated by the given crate type.

Returns None if the target does not support the given crate type.

fn discover_crate_type( &self, crate_type: &CrateType ) -> CargoResult<Option<(String, String)>>

pub fn rustc_outputs( &self, mode: CompileMode, target_kind: &TargetKind, target_triple: &str ) -> CargoResult<(Vec<FileType>, Vec<CrateType>)>

Returns all the file types generated by rustc for the given mode/target_kind.

The first value is a Vec of file types generated, the second value is a list of CrateTypes that are not supported by the given target.

fn calc_rustc_outputs( &self, target_kind: &TargetKind, target_triple: &str ) -> CargoResult<(Vec<FileType>, Vec<CrateType>)>

pub fn supports_debuginfo_split(&self, split: InternedString) -> bool

Checks if the debuginfo-split value is supported by this target

Trait Implementations

impl Clone for TargetInfo

fn clone(&self) -> TargetInfo

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 368 bytes