]> git.lizzy.rs Git - rust.git/blob - compiler/rustc_interface/src/passes.rs
Simplify box_region macros
[rust.git] / compiler / rustc_interface / src / passes.rs
1 use crate::interface::{Compiler, Result};
2 use crate::proc_macro_decls;
3 use crate::util;
4
5 use rustc_ast::mut_visit::MutVisitor;
6 use rustc_ast::{self as ast, visit};
7 use rustc_codegen_ssa::back::link::emit_metadata;
8 use rustc_codegen_ssa::traits::CodegenBackend;
9 use rustc_data_structures::steal::Steal;
10 use rustc_data_structures::sync::{par_iter, Lrc, OnceCell, ParallelIterator, WorkerLocal};
11 use rustc_data_structures::temp_dir::MaybeTempDir;
12 use rustc_data_structures::{box_region_allow_access, declare_box_region_type, parallel};
13 use rustc_errors::{ErrorReported, PResult};
14 use rustc_expand::base::ExtCtxt;
15 use rustc_hir::def_id::LOCAL_CRATE;
16 use rustc_hir::Crate;
17 use rustc_lint::LintStore;
18 use rustc_metadata::creader::CStore;
19 use rustc_middle::arena::Arena;
20 use rustc_middle::dep_graph::DepGraph;
21 use rustc_middle::middle;
22 use rustc_middle::middle::cstore::{CrateStore, MetadataLoader, MetadataLoaderDyn};
23 use rustc_middle::ty::query::Providers;
24 use rustc_middle::ty::{self, GlobalCtxt, ResolverOutputs, TyCtxt};
25 use rustc_mir as mir;
26 use rustc_mir_build as mir_build;
27 use rustc_parse::{parse_crate_from_file, parse_crate_from_source_str};
28 use rustc_passes::{self, hir_stats, layout_test};
29 use rustc_plugin_impl as plugin;
30 use rustc_query_impl::Queries as TcxQueries;
31 use rustc_resolve::{Resolver, ResolverArenas};
32 use rustc_session::config::{CrateType, Input, OutputFilenames, OutputType, PpMode, PpSourceMode};
33 use rustc_session::lint;
34 use rustc_session::output::{filename_for_input, filename_for_metadata};
35 use rustc_session::search_paths::PathKind;
36 use rustc_session::Session;
37 use rustc_span::symbol::{Ident, Symbol};
38 use rustc_trait_selection::traits;
39 use rustc_typeck as typeck;
40 use tracing::{info, warn};
41
42 use rustc_serialize::json;
43 use tempfile::Builder as TempFileBuilder;
44
45 use std::any::Any;
46 use std::cell::RefCell;
47 use std::ffi::OsString;
48 use std::io::{self, BufWriter, Write};
49 use std::lazy::SyncLazy;
50 use std::path::PathBuf;
51 use std::rc::Rc;
52 use std::{env, fs, iter};
53
54 pub fn parse<'a>(sess: &'a Session, input: &Input) -> PResult<'a, ast::Crate> {
55     let krate = sess.time("parse_crate", || match input {
56         Input::File(file) => parse_crate_from_file(file, &sess.parse_sess),
57         Input::Str { input, name } => {
58             parse_crate_from_source_str(name.clone(), input.clone(), &sess.parse_sess)
59         }
60     })?;
61
62     if sess.opts.debugging_opts.ast_json_noexpand {
63         println!("{}", json::as_json(&krate));
64     }
65
66     if sess.opts.debugging_opts.input_stats {
67         eprintln!("Lines of code:             {}", sess.source_map().count_lines());
68         eprintln!("Pre-expansion node count:  {}", count_nodes(&krate));
69     }
70
71     if let Some(ref s) = sess.opts.debugging_opts.show_span {
72         rustc_ast_passes::show_span::run(sess.diagnostic(), s, &krate);
73     }
74
75     if sess.opts.debugging_opts.hir_stats {
76         hir_stats::print_ast_stats(&krate, "PRE EXPANSION AST STATS");
77     }
78
79     Ok(krate)
80 }
81
82 fn count_nodes(krate: &ast::Crate) -> usize {
83     let mut counter = rustc_ast_passes::node_count::NodeCounter::new();
84     visit::walk_crate(&mut counter, krate);
85     counter.count
86 }
87
88 declare_box_region_type!(
89     pub BoxedResolver,
90     (&mut Resolver<'_>) -> (Result<ast::Crate>, ResolverOutputs)
91 );
92
93 /// Runs the "early phases" of the compiler: initial `cfg` processing, loading compiler plugins,
94 /// syntax expansion, secondary `cfg` expansion, synthesis of a test
95 /// harness if one is to be provided, injection of a dependency on the
96 /// standard library and prelude, and name resolution.
97 ///
98 /// Returns [`None`] if we're aborting after handling -W help.
99 pub fn configure_and_expand(
100     sess: Lrc<Session>,
101     lint_store: Lrc<LintStore>,
102     metadata_loader: Box<MetadataLoaderDyn>,
103     krate: ast::Crate,
104     crate_name: &str,
105 ) -> Result<(ast::Crate, BoxedResolver)> {
106     tracing::trace!("configure_and_expand");
107     // Currently, we ignore the name resolution data structures for the purposes of dependency
108     // tracking. Instead we will run name resolution and include its output in the hash of each
109     // item, much like we do for macro expansion. In other words, the hash reflects not just
110     // its contents but the results of name resolution on those contents. Hopefully we'll push
111     // this back at some point.
112     let crate_name = crate_name.to_string();
113     let (result, resolver) = BoxedResolver::new(static move |mut action| {
114         let _ = action;
115         let sess = &*sess;
116         let resolver_arenas = Resolver::arenas();
117         let res = configure_and_expand_inner(
118             sess,
119             &lint_store,
120             krate,
121             &crate_name,
122             &resolver_arenas,
123             &*metadata_loader,
124         );
125         let mut resolver = match res {
126             Err(v) => {
127                 yield BoxedResolver::initial_yield(Err(v));
128                 panic!()
129             }
130             Ok((krate, resolver)) => {
131                 action = yield BoxedResolver::initial_yield(Ok(krate));
132                 resolver
133             }
134         };
135         box_region_allow_access!((&mut Resolver<'_>), (&mut resolver), action);
136         resolver.into_outputs()
137     });
138     result.map(|k| (k, resolver))
139 }
140
141 impl BoxedResolver {
142     pub fn to_resolver_outputs(resolver: Rc<RefCell<BoxedResolver>>) -> ResolverOutputs {
143         match Rc::try_unwrap(resolver) {
144             Ok(resolver) => resolver.into_inner().complete(),
145             Err(resolver) => resolver.borrow_mut().access(|resolver| resolver.clone_outputs()),
146         }
147     }
148 }
149
150 pub fn register_plugins<'a>(
151     sess: &'a Session,
152     metadata_loader: &'a dyn MetadataLoader,
153     register_lints: impl Fn(&Session, &mut LintStore),
154     mut krate: ast::Crate,
155     crate_name: &str,
156 ) -> Result<(ast::Crate, Lrc<LintStore>)> {
157     krate = sess.time("attributes_injection", || {
158         rustc_builtin_macros::cmdline_attrs::inject(
159             krate,
160             &sess.parse_sess,
161             &sess.opts.debugging_opts.crate_attr,
162         )
163     });
164
165     let (krate, features) = rustc_expand::config::features(sess, krate);
166     // these need to be set "early" so that expansion sees `quote` if enabled.
167     sess.init_features(features);
168
169     let crate_types = util::collect_crate_types(sess, &krate.attrs);
170     sess.init_crate_types(crate_types);
171
172     let disambiguator = util::compute_crate_disambiguator(sess);
173     sess.crate_disambiguator.set(disambiguator).expect("not yet initialized");
174     rustc_incremental::prepare_session_directory(sess, &crate_name, disambiguator)?;
175
176     if sess.opts.incremental.is_some() {
177         sess.time("incr_comp_garbage_collect_session_directories", || {
178             if let Err(e) = rustc_incremental::garbage_collect_session_directories(sess) {
179                 warn!(
180                     "Error while trying to garbage collect incremental \
181                      compilation cache directory: {}",
182                     e
183                 );
184             }
185         });
186     }
187
188     sess.time("recursion_limit", || {
189         middle::limits::update_limits(sess, &krate);
190     });
191
192     let mut lint_store = rustc_lint::new_lint_store(
193         sess.opts.debugging_opts.no_interleave_lints,
194         sess.unstable_options(),
195     );
196     register_lints(&sess, &mut lint_store);
197
198     let registrars =
199         sess.time("plugin_loading", || plugin::load::load_plugins(sess, metadata_loader, &krate));
200     sess.time("plugin_registration", || {
201         let mut registry = plugin::Registry { lint_store: &mut lint_store };
202         for registrar in registrars {
203             registrar(&mut registry);
204         }
205     });
206
207     let lint_store = Lrc::new(lint_store);
208     sess.init_lint_store(lint_store.clone());
209
210     Ok((krate, lint_store))
211 }
212
213 fn pre_expansion_lint(
214     sess: &Session,
215     lint_store: &LintStore,
216     krate: &ast::Crate,
217     crate_name: &str,
218 ) {
219     sess.prof.generic_activity_with_arg("pre_AST_expansion_lint_checks", crate_name).run(|| {
220         rustc_lint::check_ast_crate(
221             sess,
222             lint_store,
223             &krate,
224             true,
225             None,
226             rustc_lint::BuiltinCombinedPreExpansionLintPass::new(),
227         );
228     });
229 }
230
231 fn configure_and_expand_inner<'a>(
232     sess: &'a Session,
233     lint_store: &'a LintStore,
234     mut krate: ast::Crate,
235     crate_name: &str,
236     resolver_arenas: &'a ResolverArenas<'a>,
237     metadata_loader: &'a MetadataLoaderDyn,
238 ) -> Result<(ast::Crate, Resolver<'a>)> {
239     tracing::trace!("configure_and_expand_inner");
240     pre_expansion_lint(sess, lint_store, &krate, crate_name);
241
242     let mut resolver = Resolver::new(sess, &krate, crate_name, metadata_loader, &resolver_arenas);
243     rustc_builtin_macros::register_builtin_macros(&mut resolver);
244
245     krate = sess.time("crate_injection", || {
246         let alt_std_name = sess.opts.alt_std_name.as_ref().map(|s| Symbol::intern(s));
247         rustc_builtin_macros::standard_library_imports::inject(
248             krate,
249             &mut resolver,
250             &sess,
251             alt_std_name,
252         )
253     });
254
255     util::check_attr_crate_type(&sess, &krate.attrs, &mut resolver.lint_buffer());
256
257     // Expand all macros
258     krate = sess.time("macro_expand_crate", || {
259         // Windows dlls do not have rpaths, so they don't know how to find their
260         // dependencies. It's up to us to tell the system where to find all the
261         // dependent dlls. Note that this uses cfg!(windows) as opposed to
262         // targ_cfg because syntax extensions are always loaded for the host
263         // compiler, not for the target.
264         //
265         // This is somewhat of an inherently racy operation, however, as
266         // multiple threads calling this function could possibly continue
267         // extending PATH far beyond what it should. To solve this for now we
268         // just don't add any new elements to PATH which are already there
269         // within PATH. This is basically a targeted fix at #17360 for rustdoc
270         // which runs rustc in parallel but has been seen (#33844) to cause
271         // problems with PATH becoming too long.
272         let mut old_path = OsString::new();
273         if cfg!(windows) {
274             old_path = env::var_os("PATH").unwrap_or(old_path);
275             let mut new_path = sess.host_filesearch(PathKind::All).search_path_dirs();
276             for path in env::split_paths(&old_path) {
277                 if !new_path.contains(&path) {
278                     new_path.push(path);
279                 }
280             }
281             env::set_var(
282                 "PATH",
283                 &env::join_paths(
284                     new_path.iter().filter(|p| env::join_paths(iter::once(p)).is_ok()),
285                 )
286                 .unwrap(),
287             );
288         }
289
290         // Create the config for macro expansion
291         let features = sess.features_untracked();
292         let cfg = rustc_expand::expand::ExpansionConfig {
293             features: Some(&features),
294             recursion_limit: sess.recursion_limit(),
295             trace_mac: sess.opts.debugging_opts.trace_macros,
296             should_test: sess.opts.test,
297             span_debug: sess.opts.debugging_opts.span_debug,
298             proc_macro_backtrace: sess.opts.debugging_opts.proc_macro_backtrace,
299             ..rustc_expand::expand::ExpansionConfig::default(crate_name.to_string())
300         };
301
302         let extern_mod_loaded = |ident: Ident, attrs, items, span| {
303             let krate = ast::Crate { attrs, items, span, proc_macros: vec![] };
304             pre_expansion_lint(sess, lint_store, &krate, &ident.name.as_str());
305             (krate.attrs, krate.items)
306         };
307         let mut ecx = ExtCtxt::new(&sess, cfg, &mut resolver, Some(&extern_mod_loaded));
308
309         // Expand macros now!
310         let krate = sess.time("expand_crate", || ecx.monotonic_expander().expand_crate(krate));
311
312         // The rest is error reporting
313
314         sess.time("check_unused_macros", || {
315             ecx.check_unused_macros();
316         });
317
318         let mut missing_fragment_specifiers: Vec<_> = ecx
319             .sess
320             .parse_sess
321             .missing_fragment_specifiers
322             .borrow()
323             .iter()
324             .map(|(span, node_id)| (*span, *node_id))
325             .collect();
326         missing_fragment_specifiers.sort_unstable_by_key(|(span, _)| *span);
327
328         let recursion_limit_hit = ecx.reduced_recursion_limit.is_some();
329
330         for (span, node_id) in missing_fragment_specifiers {
331             let lint = lint::builtin::MISSING_FRAGMENT_SPECIFIER;
332             let msg = "missing fragment specifier";
333             resolver.lint_buffer().buffer_lint(lint, node_id, span, msg);
334         }
335         if cfg!(windows) {
336             env::set_var("PATH", &old_path);
337         }
338
339         if recursion_limit_hit {
340             // If we hit a recursion limit, exit early to avoid later passes getting overwhelmed
341             // with a large AST
342             Err(ErrorReported)
343         } else {
344             Ok(krate)
345         }
346     })?;
347
348     sess.time("maybe_building_test_harness", || {
349         rustc_builtin_macros::test_harness::inject(&sess, &mut resolver, &mut krate)
350     });
351
352     if let Some(PpMode::Source(PpSourceMode::EveryBodyLoops)) = sess.opts.pretty {
353         tracing::debug!("replacing bodies with loop {{}}");
354         util::ReplaceBodyWithLoop::new(&mut resolver).visit_crate(&mut krate);
355     }
356
357     let has_proc_macro_decls = sess.time("AST_validation", || {
358         rustc_ast_passes::ast_validation::check_crate(sess, &krate, &mut resolver.lint_buffer())
359     });
360
361     let crate_types = sess.crate_types();
362     let is_proc_macro_crate = crate_types.contains(&CrateType::ProcMacro);
363
364     // For backwards compatibility, we don't try to run proc macro injection
365     // if rustdoc is run on a proc macro crate without '--crate-type proc-macro' being
366     // specified. This should only affect users who manually invoke 'rustdoc', as
367     // 'cargo doc' will automatically pass the proper '--crate-type' flags.
368     // However, we do emit a warning, to let such users know that they should
369     // start passing '--crate-type proc-macro'
370     if has_proc_macro_decls && sess.opts.actually_rustdoc && !is_proc_macro_crate {
371         let mut msg = sess.diagnostic().struct_warn(
372             &"Trying to document proc macro crate \
373             without passing '--crate-type proc-macro to rustdoc",
374         );
375
376         msg.warn("The generated documentation may be incorrect");
377         msg.emit()
378     } else {
379         krate = sess.time("maybe_create_a_macro_crate", || {
380             let num_crate_types = crate_types.len();
381             let is_test_crate = sess.opts.test;
382             rustc_builtin_macros::proc_macro_harness::inject(
383                 &sess,
384                 &mut resolver,
385                 krate,
386                 is_proc_macro_crate,
387                 has_proc_macro_decls,
388                 is_test_crate,
389                 num_crate_types,
390                 sess.diagnostic(),
391             )
392         });
393     }
394
395     // Done with macro expansion!
396
397     if sess.opts.debugging_opts.input_stats {
398         eprintln!("Post-expansion node count: {}", count_nodes(&krate));
399     }
400
401     if sess.opts.debugging_opts.hir_stats {
402         hir_stats::print_ast_stats(&krate, "POST EXPANSION AST STATS");
403     }
404
405     if sess.opts.debugging_opts.ast_json {
406         println!("{}", json::as_json(&krate));
407     }
408
409     resolver.resolve_crate(&krate);
410
411     // Needs to go *after* expansion to be able to check the results of macro expansion.
412     sess.time("complete_gated_feature_checking", || {
413         rustc_ast_passes::feature_gate::check_crate(&krate, sess);
414     });
415
416     // Add all buffered lints from the `ParseSess` to the `Session`.
417     sess.parse_sess.buffered_lints.with_lock(|buffered_lints| {
418         info!("{} parse sess buffered_lints", buffered_lints.len());
419         for early_lint in buffered_lints.drain(..) {
420             resolver.lint_buffer().add_early_lint(early_lint);
421         }
422     });
423
424     Ok((krate, resolver))
425 }
426
427 pub fn lower_to_hir<'res, 'tcx>(
428     sess: &'tcx Session,
429     lint_store: &LintStore,
430     resolver: &'res mut Resolver<'_>,
431     dep_graph: &'res DepGraph,
432     krate: &'res ast::Crate,
433     arena: &'tcx rustc_ast_lowering::Arena<'tcx>,
434 ) -> Crate<'tcx> {
435     // We're constructing the HIR here; we don't care what we will
436     // read, since we haven't even constructed the *input* to
437     // incr. comp. yet.
438     dep_graph.assert_ignored();
439
440     // Lower AST to HIR.
441     let hir_crate = rustc_ast_lowering::lower_crate(
442         sess,
443         &krate,
444         resolver,
445         rustc_parse::nt_to_tokenstream,
446         arena,
447     );
448
449     if sess.opts.debugging_opts.hir_stats {
450         hir_stats::print_hir_stats(&hir_crate);
451     }
452
453     sess.time("early_lint_checks", || {
454         rustc_lint::check_ast_crate(
455             sess,
456             lint_store,
457             &krate,
458             false,
459             Some(std::mem::take(resolver.lint_buffer())),
460             rustc_lint::BuiltinCombinedEarlyLintPass::new(),
461         )
462     });
463
464     // Discard hygiene data, which isn't required after lowering to HIR.
465     if !sess.opts.debugging_opts.keep_hygiene_data {
466         rustc_span::hygiene::clear_syntax_context_map();
467     }
468
469     hir_crate
470 }
471
472 // Returns all the paths that correspond to generated files.
473 fn generated_output_paths(
474     sess: &Session,
475     outputs: &OutputFilenames,
476     exact_name: bool,
477     crate_name: &str,
478 ) -> Vec<PathBuf> {
479     let mut out_filenames = Vec::new();
480     for output_type in sess.opts.output_types.keys() {
481         let file = outputs.path(*output_type);
482         match *output_type {
483             // If the filename has been overridden using `-o`, it will not be modified
484             // by appending `.rlib`, `.exe`, etc., so we can skip this transformation.
485             OutputType::Exe if !exact_name => {
486                 for crate_type in sess.crate_types().iter() {
487                     let p = filename_for_input(sess, *crate_type, crate_name, outputs);
488                     out_filenames.push(p);
489                 }
490             }
491             OutputType::DepInfo if sess.opts.debugging_opts.dep_info_omit_d_target => {
492                 // Don't add the dep-info output when omitting it from dep-info targets
493             }
494             _ => {
495                 out_filenames.push(file);
496             }
497         }
498     }
499     out_filenames
500 }
501
502 // Runs `f` on every output file path and returns the first non-None result, or None if `f`
503 // returns None for every file path.
504 fn check_output<F, T>(output_paths: &[PathBuf], f: F) -> Option<T>
505 where
506     F: Fn(&PathBuf) -> Option<T>,
507 {
508     for output_path in output_paths {
509         if let Some(result) = f(output_path) {
510             return Some(result);
511         }
512     }
513     None
514 }
515
516 fn output_contains_path(output_paths: &[PathBuf], input_path: &PathBuf) -> bool {
517     let input_path = input_path.canonicalize().ok();
518     if input_path.is_none() {
519         return false;
520     }
521     let check = |output_path: &PathBuf| {
522         if output_path.canonicalize().ok() == input_path { Some(()) } else { None }
523     };
524     check_output(output_paths, check).is_some()
525 }
526
527 fn output_conflicts_with_dir(output_paths: &[PathBuf]) -> Option<PathBuf> {
528     let check = |output_path: &PathBuf| output_path.is_dir().then(|| output_path.clone());
529     check_output(output_paths, check)
530 }
531
532 fn escape_dep_filename(filename: &String) -> String {
533     // Apparently clang and gcc *only* escape spaces:
534     // http://llvm.org/klaus/clang/commit/9d50634cfc268ecc9a7250226dd5ca0e945240d4
535     filename.replace(" ", "\\ ")
536 }
537
538 // Makefile comments only need escaping newlines and `\`.
539 // The result can be unescaped by anything that can unescape `escape_default` and friends.
540 fn escape_dep_env(symbol: Symbol) -> String {
541     let s = symbol.as_str();
542     let mut escaped = String::with_capacity(s.len());
543     for c in s.chars() {
544         match c {
545             '\n' => escaped.push_str(r"\n"),
546             '\r' => escaped.push_str(r"\r"),
547             '\\' => escaped.push_str(r"\\"),
548             _ => escaped.push(c),
549         }
550     }
551     escaped
552 }
553
554 fn write_out_deps(
555     sess: &Session,
556     boxed_resolver: &Steal<Rc<RefCell<BoxedResolver>>>,
557     outputs: &OutputFilenames,
558     out_filenames: &[PathBuf],
559 ) {
560     // Write out dependency rules to the dep-info file if requested
561     if !sess.opts.output_types.contains_key(&OutputType::DepInfo) {
562         return;
563     }
564     let deps_filename = outputs.path(OutputType::DepInfo);
565
566     let result = (|| -> io::Result<()> {
567         // Build a list of files used to compile the output and
568         // write Makefile-compatible dependency rules
569         let mut files: Vec<String> = sess
570             .source_map()
571             .files()
572             .iter()
573             .filter(|fmap| fmap.is_real_file())
574             .filter(|fmap| !fmap.is_imported())
575             .map(|fmap| escape_dep_filename(&fmap.name.prefer_local().to_string()))
576             .collect();
577
578         if let Some(ref backend) = sess.opts.debugging_opts.codegen_backend {
579             files.push(backend.to_string());
580         }
581
582         if sess.binary_dep_depinfo() {
583             boxed_resolver.borrow().borrow_mut().access(|resolver| {
584                 for cnum in resolver.cstore().crates_untracked() {
585                     let source = resolver.cstore().crate_source_untracked(cnum);
586                     if let Some((path, _)) = source.dylib {
587                         files.push(escape_dep_filename(&path.display().to_string()));
588                     }
589                     if let Some((path, _)) = source.rlib {
590                         files.push(escape_dep_filename(&path.display().to_string()));
591                     }
592                     if let Some((path, _)) = source.rmeta {
593                         files.push(escape_dep_filename(&path.display().to_string()));
594                     }
595                 }
596             });
597         }
598
599         let mut file = BufWriter::new(fs::File::create(&deps_filename)?);
600         for path in out_filenames {
601             writeln!(file, "{}: {}\n", path.display(), files.join(" "))?;
602         }
603
604         // Emit a fake target for each input file to the compilation. This
605         // prevents `make` from spitting out an error if a file is later
606         // deleted. For more info see #28735
607         for path in files {
608             writeln!(file, "{}:", path)?;
609         }
610
611         // Emit special comments with information about accessed environment variables.
612         let env_depinfo = sess.parse_sess.env_depinfo.borrow();
613         if !env_depinfo.is_empty() {
614             let mut envs: Vec<_> = env_depinfo
615                 .iter()
616                 .map(|(k, v)| (escape_dep_env(*k), v.map(escape_dep_env)))
617                 .collect();
618             envs.sort_unstable();
619             writeln!(file)?;
620             for (k, v) in envs {
621                 write!(file, "# env-dep:{}", k)?;
622                 if let Some(v) = v {
623                     write!(file, "={}", v)?;
624                 }
625                 writeln!(file)?;
626             }
627         }
628
629         Ok(())
630     })();
631
632     match result {
633         Ok(_) => {
634             if sess.opts.json_artifact_notifications {
635                 sess.parse_sess
636                     .span_diagnostic
637                     .emit_artifact_notification(&deps_filename, "dep-info");
638             }
639         }
640         Err(e) => sess.fatal(&format!(
641             "error writing dependencies to `{}`: {}",
642             deps_filename.display(),
643             e
644         )),
645     }
646 }
647
648 pub fn prepare_outputs(
649     sess: &Session,
650     compiler: &Compiler,
651     krate: &ast::Crate,
652     boxed_resolver: &Steal<Rc<RefCell<BoxedResolver>>>,
653     crate_name: &str,
654 ) -> Result<OutputFilenames> {
655     let _timer = sess.timer("prepare_outputs");
656
657     // FIXME: rustdoc passes &[] instead of &krate.attrs here
658     let outputs = util::build_output_filenames(
659         &compiler.input,
660         &compiler.output_dir,
661         &compiler.output_file,
662         &krate.attrs,
663         sess,
664     );
665
666     let output_paths =
667         generated_output_paths(sess, &outputs, compiler.output_file.is_some(), &crate_name);
668
669     // Ensure the source file isn't accidentally overwritten during compilation.
670     if let Some(ref input_path) = compiler.input_path {
671         if sess.opts.will_create_output_file() {
672             if output_contains_path(&output_paths, input_path) {
673                 sess.err(&format!(
674                     "the input file \"{}\" would be overwritten by the generated \
675                         executable",
676                     input_path.display()
677                 ));
678                 return Err(ErrorReported);
679             }
680             if let Some(dir_path) = output_conflicts_with_dir(&output_paths) {
681                 sess.err(&format!(
682                     "the generated executable for the input file \"{}\" conflicts with the \
683                         existing directory \"{}\"",
684                     input_path.display(),
685                     dir_path.display()
686                 ));
687                 return Err(ErrorReported);
688             }
689         }
690     }
691
692     write_out_deps(sess, boxed_resolver, &outputs, &output_paths);
693
694     let only_dep_info = sess.opts.output_types.contains_key(&OutputType::DepInfo)
695         && sess.opts.output_types.len() == 1;
696
697     if !only_dep_info {
698         if let Some(ref dir) = compiler.output_dir {
699             if fs::create_dir_all(dir).is_err() {
700                 sess.err("failed to find or create the directory specified by `--out-dir`");
701                 return Err(ErrorReported);
702             }
703         }
704     }
705
706     Ok(outputs)
707 }
708
709 pub static DEFAULT_QUERY_PROVIDERS: SyncLazy<Providers> = SyncLazy::new(|| {
710     let providers = &mut Providers::default();
711     providers.analysis = analysis;
712     proc_macro_decls::provide(providers);
713     plugin::build::provide(providers);
714     rustc_middle::hir::provide(providers);
715     mir::provide(providers);
716     mir_build::provide(providers);
717     rustc_privacy::provide(providers);
718     typeck::provide(providers);
719     ty::provide(providers);
720     traits::provide(providers);
721     rustc_passes::provide(providers);
722     rustc_resolve::provide(providers);
723     rustc_traits::provide(providers);
724     rustc_ty_utils::provide(providers);
725     rustc_metadata::provide(providers);
726     rustc_lint::provide(providers);
727     rustc_symbol_mangling::provide(providers);
728     rustc_codegen_ssa::provide(providers);
729     *providers
730 });
731
732 pub static DEFAULT_EXTERN_QUERY_PROVIDERS: SyncLazy<Providers> = SyncLazy::new(|| {
733     let mut extern_providers = *DEFAULT_QUERY_PROVIDERS;
734     rustc_metadata::provide_extern(&mut extern_providers);
735     rustc_codegen_ssa::provide_extern(&mut extern_providers);
736     extern_providers
737 });
738
739 pub struct QueryContext<'tcx> {
740     gcx: &'tcx GlobalCtxt<'tcx>,
741 }
742
743 impl<'tcx> QueryContext<'tcx> {
744     pub fn enter<F, R>(&mut self, f: F) -> R
745     where
746         F: FnOnce(TyCtxt<'tcx>) -> R,
747     {
748         let icx = ty::tls::ImplicitCtxt::new(self.gcx);
749         ty::tls::enter_context(&icx, |_| f(icx.tcx))
750     }
751 }
752
753 pub fn create_global_ctxt<'tcx>(
754     compiler: &'tcx Compiler,
755     lint_store: Lrc<LintStore>,
756     krate: &'tcx Crate<'tcx>,
757     dep_graph: DepGraph,
758     resolver_outputs: ResolverOutputs,
759     outputs: OutputFilenames,
760     crate_name: &str,
761     queries: &'tcx OnceCell<TcxQueries<'tcx>>,
762     global_ctxt: &'tcx OnceCell<GlobalCtxt<'tcx>>,
763     arena: &'tcx WorkerLocal<Arena<'tcx>>,
764 ) -> QueryContext<'tcx> {
765     let sess = &compiler.session();
766
767     let def_path_table = resolver_outputs.definitions.def_path_table();
768     let query_result_on_disk_cache =
769         rustc_incremental::load_query_result_cache(sess, def_path_table);
770
771     let codegen_backend = compiler.codegen_backend();
772     let mut local_providers = *DEFAULT_QUERY_PROVIDERS;
773     codegen_backend.provide(&mut local_providers);
774
775     let mut extern_providers = *DEFAULT_EXTERN_QUERY_PROVIDERS;
776     codegen_backend.provide(&mut extern_providers);
777     codegen_backend.provide_extern(&mut extern_providers);
778
779     if let Some(callback) = compiler.override_queries {
780         callback(sess, &mut local_providers, &mut extern_providers);
781     }
782
783     let queries = queries.get_or_init(|| TcxQueries::new(local_providers, extern_providers));
784
785     let gcx = sess.time("setup_global_ctxt", || {
786         global_ctxt.get_or_init(|| {
787             TyCtxt::create_global_ctxt(
788                 sess,
789                 lint_store,
790                 arena,
791                 resolver_outputs,
792                 krate,
793                 dep_graph,
794                 query_result_on_disk_cache,
795                 queries.as_dyn(),
796                 &crate_name,
797                 outputs,
798             )
799         })
800     });
801
802     QueryContext { gcx }
803 }
804
805 /// Runs the resolution, type-checking, region checking and other
806 /// miscellaneous analysis passes on the crate.
807 fn analysis(tcx: TyCtxt<'_>, (): ()) -> Result<()> {
808     rustc_passes::hir_id_validator::check_crate(tcx);
809
810     let sess = tcx.sess;
811     let mut entry_point = None;
812
813     sess.time("misc_checking_1", || {
814         parallel!(
815             {
816                 entry_point = sess.time("looking_for_entry_point", || tcx.entry_fn(()));
817
818                 sess.time("looking_for_plugin_registrar", || tcx.ensure().plugin_registrar_fn(()));
819
820                 sess.time("looking_for_derive_registrar", || {
821                     tcx.ensure().proc_macro_decls_static(())
822                 });
823
824                 let cstore = tcx
825                     .cstore_as_any()
826                     .downcast_ref::<CStore>()
827                     .expect("`tcx.cstore` is not a `CStore`");
828                 cstore.report_unused_deps(tcx);
829             },
830             {
831                 par_iter(&tcx.hir().krate().modules).for_each(|(&module, _)| {
832                     tcx.ensure().check_mod_loops(module);
833                     tcx.ensure().check_mod_attrs(module);
834                     tcx.ensure().check_mod_naked_functions(module);
835                     tcx.ensure().check_mod_unstable_api_usage(module);
836                     tcx.ensure().check_mod_const_bodies(module);
837                 });
838             }
839         );
840     });
841
842     // passes are timed inside typeck
843     typeck::check_crate(tcx)?;
844
845     sess.time("misc_checking_2", || {
846         parallel!(
847             {
848                 sess.time("match_checking", || {
849                     tcx.par_body_owners(|def_id| {
850                         tcx.ensure().check_match(def_id.to_def_id());
851                     });
852                 });
853             },
854             {
855                 sess.time("liveness_and_intrinsic_checking", || {
856                     par_iter(&tcx.hir().krate().modules).for_each(|(&module, _)| {
857                         // this must run before MIR dump, because
858                         // "not all control paths return a value" is reported here.
859                         //
860                         // maybe move the check to a MIR pass?
861                         tcx.ensure().check_mod_liveness(module);
862                         tcx.ensure().check_mod_intrinsics(module);
863                     });
864                 });
865             }
866         );
867     });
868
869     sess.time("MIR_borrow_checking", || {
870         tcx.par_body_owners(|def_id| tcx.ensure().mir_borrowck(def_id));
871     });
872
873     sess.time("MIR_effect_checking", || {
874         for def_id in tcx.body_owners() {
875             tcx.ensure().thir_check_unsafety(def_id);
876             if !tcx.sess.opts.debugging_opts.thir_unsafeck {
877                 mir::transform::check_unsafety::check_unsafety(tcx, def_id);
878             }
879
880             if tcx.hir().body_const_context(def_id).is_some() {
881                 tcx.ensure()
882                     .mir_drops_elaborated_and_const_checked(ty::WithOptConstParam::unknown(def_id));
883             }
884         }
885     });
886
887     sess.time("layout_testing", || layout_test::test_layout(tcx));
888
889     // Avoid overwhelming user with errors if borrow checking failed.
890     // I'm not sure how helpful this is, to be honest, but it avoids a
891     // lot of annoying errors in the ui tests (basically,
892     // lint warnings and so on -- kindck used to do this abort, but
893     // kindck is gone now). -nmatsakis
894     if sess.has_errors() {
895         return Err(ErrorReported);
896     }
897
898     sess.time("misc_checking_3", || {
899         parallel!(
900             {
901                 tcx.ensure().privacy_access_levels(());
902
903                 parallel!(
904                     {
905                         tcx.ensure().check_private_in_public(());
906                     },
907                     {
908                         sess.time("death_checking", || rustc_passes::dead::check_crate(tcx));
909                     },
910                     {
911                         sess.time("unused_lib_feature_checking", || {
912                             rustc_passes::stability::check_unused_or_stable_features(tcx)
913                         });
914                     },
915                     {
916                         sess.time("lint_checking", || {
917                             rustc_lint::check_crate(tcx, || {
918                                 rustc_lint::BuiltinCombinedLateLintPass::new()
919                             });
920                         });
921                     }
922                 );
923             },
924             {
925                 sess.time("privacy_checking_modules", || {
926                     par_iter(&tcx.hir().krate().modules).for_each(|(&module, _)| {
927                         tcx.ensure().check_mod_privacy(module);
928                     });
929                 });
930             }
931         );
932     });
933
934     Ok(())
935 }
936
937 fn encode_and_write_metadata(
938     tcx: TyCtxt<'_>,
939     outputs: &OutputFilenames,
940 ) -> (middle::cstore::EncodedMetadata, bool) {
941     #[derive(PartialEq, Eq, PartialOrd, Ord)]
942     enum MetadataKind {
943         None,
944         Uncompressed,
945         Compressed,
946     }
947
948     let metadata_kind = tcx
949         .sess
950         .crate_types()
951         .iter()
952         .map(|ty| match *ty {
953             CrateType::Executable | CrateType::Staticlib | CrateType::Cdylib => MetadataKind::None,
954
955             CrateType::Rlib => MetadataKind::Uncompressed,
956
957             CrateType::Dylib | CrateType::ProcMacro => MetadataKind::Compressed,
958         })
959         .max()
960         .unwrap_or(MetadataKind::None);
961
962     let metadata = match metadata_kind {
963         MetadataKind::None => middle::cstore::EncodedMetadata::new(),
964         MetadataKind::Uncompressed | MetadataKind::Compressed => tcx.encode_metadata(),
965     };
966
967     let _prof_timer = tcx.sess.prof.generic_activity("write_crate_metadata");
968
969     let need_metadata_file = tcx.sess.opts.output_types.contains_key(&OutputType::Metadata);
970     if need_metadata_file {
971         let crate_name = &tcx.crate_name(LOCAL_CRATE).as_str();
972         let out_filename = filename_for_metadata(tcx.sess, crate_name, outputs);
973         // To avoid races with another rustc process scanning the output directory,
974         // we need to write the file somewhere else and atomically move it to its
975         // final destination, with an `fs::rename` call. In order for the rename to
976         // always succeed, the temporary file needs to be on the same filesystem,
977         // which is why we create it inside the output directory specifically.
978         let metadata_tmpdir = TempFileBuilder::new()
979             .prefix("rmeta")
980             .tempdir_in(out_filename.parent().unwrap())
981             .unwrap_or_else(|err| tcx.sess.fatal(&format!("couldn't create a temp dir: {}", err)));
982         let metadata_tmpdir = MaybeTempDir::new(metadata_tmpdir, tcx.sess.opts.cg.save_temps);
983         let metadata_filename = emit_metadata(tcx.sess, &metadata.raw_data, &metadata_tmpdir);
984         if let Err(e) = util::non_durable_rename(&metadata_filename, &out_filename) {
985             tcx.sess.fatal(&format!("failed to write {}: {}", out_filename.display(), e));
986         }
987         if tcx.sess.opts.json_artifact_notifications {
988             tcx.sess
989                 .parse_sess
990                 .span_diagnostic
991                 .emit_artifact_notification(&out_filename, "metadata");
992         }
993     }
994
995     let need_metadata_module = metadata_kind == MetadataKind::Compressed;
996
997     (metadata, need_metadata_module)
998 }
999
1000 /// Runs the codegen backend, after which the AST and analysis can
1001 /// be discarded.
1002 pub fn start_codegen<'tcx>(
1003     codegen_backend: &dyn CodegenBackend,
1004     tcx: TyCtxt<'tcx>,
1005     outputs: &OutputFilenames,
1006 ) -> Box<dyn Any> {
1007     info!("Pre-codegen\n{:?}", tcx.debug_stats());
1008
1009     let (metadata, need_metadata_module) = encode_and_write_metadata(tcx, outputs);
1010
1011     let codegen = tcx.sess.time("codegen_crate", move || {
1012         codegen_backend.codegen_crate(tcx, metadata, need_metadata_module)
1013     });
1014
1015     // Don't run these test assertions when not doing codegen. Compiletest tries to build
1016     // build-fail tests in check mode first and expects it to not give an error in that case.
1017     if tcx.sess.opts.output_types.should_codegen() {
1018         rustc_incremental::assert_module_sources::assert_module_sources(tcx);
1019         rustc_symbol_mangling::test::report_symbol_names(tcx);
1020     }
1021
1022     info!("Post-codegen\n{:?}", tcx.debug_stats());
1023
1024     if tcx.sess.opts.output_types.contains_key(&OutputType::Mir) {
1025         if let Err(e) = mir::transform::dump_mir::emit_mir(tcx, outputs) {
1026             tcx.sess.err(&format!("could not emit MIR: {}", e));
1027             tcx.sess.abort_if_errors();
1028         }
1029     }
1030
1031     codegen
1032 }