Module config 

Contains infrastructure for configuring the compiler, including parsing command-line options.

Modules

cfg 🔒

cfg and check-cfg configuration

dep_tracking 🔒

Command-line arguments passed to the compiler have to be incorporated with the dependency tracking system for incremental compilation. This module provides some utilities to make this more convenient.

externs 🔒

This module contains code to help parse and manipulate --extern arguments.

mitigation_coverage

native_libs 🔒

Parser for the -l command-line option, which links the generated crate to a native library.

nightly_options

parse

print_request 🔒

Code for dealing with --print requests.

sigpipe

NOTE: Keep these constants in sync with library/std/src/sys/pal/unix/mod.rs!

Macros

define_output_types 🔒

Structs

BranchProtection

CheckCfg

The parsed --check-cfg options.

CodegenOptions

CodegenRetagOptions

The different settings that the -Z codegen-emit-retag flag can have.

CollectedOptions

CoverageOptions

Individual flag values controlled by -Zcoverage-options.

ExtendedTargetModifierInfo

Extended target modifier info. For example, when external target modifier is ‘-Zregparm=2’: Target modifier enum value + user value (‘2’) from external crate is converted into description: prefix (‘Z’), name (‘regparm’), tech value (‘Some(2)’).

ExternEntry

Externs

Use tree-based collections to cheaply get a deterministic Hash implementation. Do not switch BTreeMap or BTreeSet out for an unsorted container type! That would break dependency tracking for command-line arguments.

InstrumentMcountOpts

InstrumentXRay

Settings for -Z instrument-xray flag.

Jobs

None for frontend and backend means everything is single-threaded and synchronization can be disabled.

JsonConfig

Possible json config files

LinkSelfContained

The different values -C link-self-contained can take: a list of individually enabled or disabled components used during linking, coming from the rustc distribution, instead of being found somewhere on the host system.

LinkerFeaturesCli

The different values that -C linker-features can take on the CLI: a list of individually enabled or disabled features used during linking.

LocationDetail

The different settings that can be enabled via the -Z location-detail flag.

NextSolverConfig

OptionDesc

Options

The top-level command-line options struct.

OutputFilenames

OutputTypes

Use tree-based collections to cheaply get a deterministic Hash implementation. Do not switch BTreeMap out for an unsorted container type! That would break dependency tracking for command-line arguments. Also only hash keys, since tracking should only depend on the output types, not the paths they’re written to.

PacRet

PatchableFunctionEntry

-Z patchable-function-entry representation - how many nops to put before and after function entry.

PrintRequest

RustcOptGroup

Sysroot

TargetModifier

A recorded -Zopt_name=opt_value (or -Copt_name=opt_value) which alter the ABI or effectiveness of exploit mitigations.

UnstableOptions

Enums

AnnotateMoves

The different settings that the -Z annotate-moves flag can have.

AutoDiff

The different settings that the -Z autodiff flag can have.

CFGuard

The different settings that the -C control-flow-guard flag can have.

CFProtection

The different settings that the -Z cf-protection flag can have.

CodegenOptionsTargetModifiers

CoverageLevel

Controls whether branch coverage is enabled.

DebugInfo

DebugInfoCompression

DumpMonoStatsFormat

Which format to use for -Z dump-mono-stats

EntryFnType

ErrorOutputType

The type of diagnostics output to generate.

ExpectedValues

ExternLocation

FmtDebug

Values for the -Z fmt-debug flag.

FunctionReturn

The different settings that the -Zfunction-return flag can have.

IncrementalStateAssertion

Used with -Z assert-incr-state.

InliningThreshold

Input

InstrumentCoverage

The different settings that the -C instrument-coverage flag can have.

InstrumentMcount

The different settings that the -Z Instrument-mcount flag can have.

JsonUnusedExterns

Report unused externs in event stream

LinkerJobs

LinkerPluginLto

Lto

This is what the LtoCli values get mapped to after resolving defaults and and taking other command line options into account.

LtoCli

The different settings that the -C lto flag can have.

MirIncludeSpans

Whether extra span comments are included when dumping MIR, via the -Z mir-include-spans flag. By default, only enabled in the NLL MIR dumps, and disabled in all other passes.

MirStripDebugInfo

Offload

OptLevel

OptionKind

OptionStability

OptionsTargetModifiers

OutFileName

OutputType

PAuthKey

Passes

PointerAuthOption

Polonius

-Zpolonius values, enabling the borrow checker polonius analysis, and which version: legacy, or future prototype.

PpHirMode

PpMode

Pretty print mode

PpSourceMode

PrintCategory

PrintKind

ProcMacroExecutionStrategy

How to run proc-macro code when building this crate

ResolveDocLinks

SplitDwarfKind

Split debug-information is enabled by -C split-debuginfo, this enum is only used if split debug-information is enabled (in either Packed or Unpacked modes), and the platform uses DWARF for debug-information.

Strip

The different settings that the -C strip flag can have.

SwitchWithOptPath

SymbolManglingVersion

UnstableOptionsTargetModifiers

WasiExecModel

Constants

CG_OPTIONS

DWARF_OBJECT_EXT

MAX_FILENAME_LENGTH

NATIVE_CPU

Special CPU name requesting the CPU of the current host.

RLINK_EXT

RUST_CGU_EXT

Z_OPTIONS

Statics

EDITION_STRING 🔒

EMIT_HELP 🔒

Functions

build_configuration

build_session_options

build_target_config

check_error_format_stability 🔒

collect_print_requests

file_path_mapping 🔒

get_cmd_lint_options

host_tuple

Get the host triple out of the build environment. This ensures that our idea of the host triple is the same as for the set of libraries we’ve actually built. We can’t just take LLVM’s host triple because they normalize all ix86 architectures to i386.

make_crate_type_option

make_opt

maybe_strip_file_name 🔒

Ensure the filename is not too long, as some filesystems have a limit. If the filename is too long, hash part of it and append the hash to the filename. This is a workaround for long crate names generating overly long filenames.

parse_color

Parses the --color flag.

parse_crate_edition

parse_crate_types_from_list

parse_error_format

Parses the --error-format flag.

parse_externs

parse_jobs_all 🔒

parse_jobs_one 🔒

parse_json

Parse the --json flag.

parse_opt_level 🔒

parse_output_types 🔒

parse_pretty 🔒

parse_remap_path_prefix 🔒

parse_remap_path_scope

parse_target_triple

rustc_optgroups

Returns all rustc command line options, including metadata for each option, such as whether the option is stable.

select_debuginfo 🔒

should_override_cgus_and_disable_thinlto 🔒

split_out_file_name 🔒

Type Aliases

Cfg

The parsed --cfg options that define the compilation environment of the crate, used to drive conditional compilation.