Crate rustc_driver_impl 

The Rust compiler.

Note

This API is completely unstable and subject to change.

Modules

args

pretty

The various pretty-printing routines.

print 🔒

session_diagnostics 🔒

signal_handler 🔒

Signal handler for rustc Primarily used to extract a backtrace from stack overflow

Macros

do_not_use_print 🔒

do_not_use_safe_print 🔒

version

Prints version information

Structs

TimePassesCallbacks

Enums

Compilation

Whether to stop or continue compilation.

Constants

DEFAULT_BUG_REPORT_URL

EXIT_FAILURE

Exit status code used for compilation failures and invalid flags.

EXIT_SUCCESS

Exit status code used for successful compilation and help output.

Statics

DEFAULT_LOCALE_RESOURCE

Raw content of Fluent resource for this crate, generated by fluent_messages macro, imported by rustc_driver to include all crates’ resources in one bundle.

DEFAULT_LOCALE_RESOURCES

ICE_PATH 🔒

USING_INTERNAL_FEATURES

Traits

Callbacks

Functions

catch_fatal_errors

Runs a closure and catches unwinds triggered by fatal errors.

catch_with_exit_code

Variant of catch_fatal_errors for the interface::Result return type that also computes the exit code.

default_translator

describe_codegen_flags 🔒

describe_debug_flags 🔒

describe_flag_categories

Show help for flag categories shared between rustdoc and rustc.

describe_lints

Write to stdout lint command options, together with a list of all available lints

diagnostics_registry

dump_feature_usage_metrics 🔒

get_backend_from_raw_matches 🔒

Get the codegen backend based on the raw Matches.

handle_explain 🔒

handle_options

Process command line options. Emits messages as appropriate. If compilation should continue, returns a getopts::Matches object parsed from args, otherwise returns None.

ice_path 🔒

ice_path_with_config 🔒

init_logger

This allows tools to enable rust logging without having to magically match rustc’s tracing crate version. In contrast to init_rustc_env_logger it allows you to choose the logger config directly rather than having to set an environment variable.

init_logger_with_additional_layer

This allows tools to enable rust logging without having to magically match rustc’s tracing crate version. In contrast to init_rustc_env_logger, it allows you to choose the logger config directly rather than having to set an environment variable. Moreover, in contrast to init_logger, it allows you to add a custom tracing layer via build_subscriber, for example || Registry::default().with(custom_layer).

init_rustc_env_logger

This allows tools to enable rust logging without having to magically match rustc’s tracing crate version.

install_ctrlc_handler

Install our usual ctrlc handler, which sets [rustc_const_eval::CTRL_C_RECEIVED]. Making this handler optional lets tools can install a different handler, if they wish.

install_ice_hook

Installs a panic hook that will print the ICE message on unexpected panics.

list_metadata 🔒

main

make_input 🔒

Extract input (string or file and optional path) from matches. This handles reading from stdin if - is provided.

make_output 🔒

Extract output directory and file from matches.

parse_crate_attrs 🔒

print_crate_info 🔒

print_flag_list 🔒

print_wall_help 🔒

process_rlink 🔒

report_ice 🔒

Prints the ICE message, including query stack, but without backtrace.

run_compiler

This is the primary entry point for rustc.

show_md_content_with_pager 🔒

If color is always or auto, try to print pretty (formatted & colorized) markdown. If that fails or color is never, print the raw markdown.

usage 🔒

warn_on_confusing_output_filename_flag 🔒

Warn if -o is used without a space between the flag name and the value and the value is a high-value confusables, e.g. -optimize instead of -o optimize, see issue #142812.