]> git.lizzy.rs Git - rust.git/blob - src/librustc_driver/driver.rs
2a1a3b481b3bf51d01bdf5b85f454b826e1c8331
[rust.git] / src / librustc_driver / driver.rs
1 // Copyright 2012-2015 The Rust Project Developers. See the COPYRIGHT
2 // file at the top-level directory of this distribution and at
3 // http://rust-lang.org/COPYRIGHT.
4 //
5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
8 // option. This file may not be copied, modified, or distributed
9 // except according to those terms.
10
11 use rustc::dep_graph::DepGraph;
12 use rustc::hir::{self, map as hir_map};
13 use rustc::hir::lowering::lower_crate;
14 use rustc_data_structures::fingerprint::Fingerprint;
15 use rustc_data_structures::stable_hasher::StableHasher;
16 use rustc_mir as mir;
17 use rustc::session::{CompileResult, CrateDisambiguator, Session};
18 use rustc::session::CompileIncomplete;
19 use rustc::session::config::{self, Input, OutputFilenames, OutputType};
20 use rustc::session::search_paths::PathKind;
21 use rustc::lint;
22 use rustc::middle::{self, reachable, resolve_lifetime, stability};
23 use rustc::middle::privacy::AccessLevels;
24 use rustc::ty::{self, AllArenas, Resolutions, TyCtxt};
25 use rustc::traits;
26 use rustc::util::common::{install_panic_hook, time, ErrorReported};
27 use rustc::util::profiling::ProfileCategory;
28 use rustc_allocator as allocator;
29 use rustc_borrowck as borrowck;
30 use rustc_incremental;
31 use rustc_resolve::{MakeGlobMap, Resolver, ResolverArenas};
32 use rustc_metadata::creader::CrateLoader;
33 use rustc_metadata::cstore::{self, CStore};
34 use rustc_traits;
35 use rustc_codegen_utils::codegen_backend::CodegenBackend;
36 use rustc_typeck as typeck;
37 use rustc_privacy;
38 use rustc_plugin::registry::Registry;
39 use rustc_plugin as plugin;
40 use rustc_passes::{self, ast_validation, hir_stats, loops, rvalue_promotion};
41 use super::Compilation;
42
43 use serialize::json;
44
45 use std::any::Any;
46 use std::env;
47 use std::ffi::OsString;
48 use std::fs;
49 use std::io::{self, Write};
50 use std::iter;
51 use std::path::{Path, PathBuf};
52 use rustc_data_structures::sync::{self, Lrc, Lock};
53 use std::sync::mpsc;
54 use syntax::{self, ast, attr, diagnostics, visit};
55 use syntax::early_buffered_lints::BufferedEarlyLint;
56 use syntax::ext::base::ExtCtxt;
57 use syntax::fold::Folder;
58 use syntax::parse::{self, PResult};
59 use syntax::util::node_count::NodeCounter;
60 use syntax::util::lev_distance::find_best_match_for_name;
61 use syntax::symbol::Symbol;
62 use syntax_pos::{FileName, hygiene};
63 use syntax_ext;
64
65 use proc_macro_decls;
66 use pretty::ReplaceBodyWithLoop;
67
68 use profile;
69
70 #[cfg(not(parallel_queries))]
71 pub fn spawn_thread_pool<F: FnOnce(config::Options) -> R + sync::Send, R: sync::Send>(
72     opts: config::Options,
73     f: F
74 ) -> R {
75     ty::tls::GCX_PTR.set(&Lock::new(0), || {
76         f(opts)
77     })
78 }
79
80 #[cfg(parallel_queries)]
81 pub fn spawn_thread_pool<F: FnOnce(config::Options) -> R + sync::Send, R: sync::Send>(
82     opts: config::Options,
83     f: F
84 ) -> R {
85     use syntax;
86     use syntax_pos;
87     use rayon::{ThreadPoolBuilder, ThreadPool};
88
89     let gcx_ptr = &Lock::new(0);
90
91     let config = ThreadPoolBuilder::new()
92         .num_threads(Session::query_threads_from_opts(&opts))
93         .deadlock_handler(|| unsafe { ty::query::handle_deadlock() })
94         .stack_size(::STACK_SIZE);
95
96     let with_pool = move |pool: &ThreadPool| {
97         pool.install(move || f(opts))
98     };
99
100     syntax::GLOBALS.with(|syntax_globals| {
101         syntax_pos::GLOBALS.with(|syntax_pos_globals| {
102             // The main handler run for each Rayon worker thread and sets up
103             // the thread local rustc uses. syntax_globals and syntax_pos_globals are
104             // captured and set on the new threads. ty::tls::with_thread_locals sets up
105             // thread local callbacks from libsyntax
106             let main_handler = move |worker: &mut dyn FnMut()| {
107                 syntax::GLOBALS.set(syntax_globals, || {
108                     syntax_pos::GLOBALS.set(syntax_pos_globals, || {
109                         ty::tls::with_thread_locals(|| {
110                             ty::tls::GCX_PTR.set(gcx_ptr, || {
111                                 worker()
112                             })
113                         })
114                     })
115                 })
116             };
117
118             ThreadPool::scoped_pool(config, main_handler, with_pool).unwrap()
119         })
120     })
121 }
122
123 pub fn compile_input(
124     codegen_backend: Box<dyn CodegenBackend>,
125     sess: &Session,
126     cstore: &CStore,
127     input_path: &Option<PathBuf>,
128     input: &Input,
129     outdir: &Option<PathBuf>,
130     output: &Option<PathBuf>,
131     addl_plugins: Option<Vec<String>>,
132     control: &CompileController,
133 ) -> CompileResult {
134     macro_rules! controller_entry_point {
135         ($point: ident, $tsess: expr, $make_state: expr, $phase_result: expr) => {{
136             let state = &mut $make_state;
137             let phase_result: &CompileResult = &$phase_result;
138             if phase_result.is_ok() || control.$point.run_callback_on_error {
139                 (control.$point.callback)(state);
140             }
141
142             if control.$point.stop == Compilation::Stop {
143                 // FIXME: shouldn't this return Err(CompileIncomplete::Stopped)
144                 // if there are no errors?
145                 return $tsess.compile_status();
146             }
147         }}
148     }
149
150     if sess.profile_queries() {
151         profile::begin(sess);
152     }
153
154     // We need nested scopes here, because the intermediate results can keep
155     // large chunks of memory alive and we want to free them as soon as
156     // possible to keep the peak memory usage low
157     let (outputs, ongoing_codegen, dep_graph) = {
158         let krate = match phase_1_parse_input(control, sess, input) {
159             Ok(krate) => krate,
160             Err(mut parse_error) => {
161                 parse_error.emit();
162                 return Err(CompileIncomplete::Errored(ErrorReported));
163             }
164         };
165
166         let (krate, registry) = {
167             let mut compile_state =
168                 CompileState::state_after_parse(input, sess, outdir, output, krate, &cstore);
169             controller_entry_point!(after_parse, sess, compile_state, Ok(()));
170
171             (compile_state.krate.unwrap(), compile_state.registry)
172         };
173
174         let outputs = build_output_filenames(input, outdir, output, &krate.attrs, sess);
175         let crate_name =
176             ::rustc_codegen_utils::link::find_crate_name(Some(sess), &krate.attrs, input);
177         install_panic_hook();
178
179         let ExpansionResult {
180             expanded_crate,
181             defs,
182             analysis,
183             resolutions,
184             mut hir_forest,
185         } = {
186             phase_2_configure_and_expand(
187                 sess,
188                 &cstore,
189                 krate,
190                 registry,
191                 &crate_name,
192                 addl_plugins,
193                 control.make_glob_map,
194                 |expanded_crate| {
195                     let mut state = CompileState::state_after_expand(
196                         input,
197                         sess,
198                         outdir,
199                         output,
200                         &cstore,
201                         expanded_crate,
202                         &crate_name,
203                     );
204                     controller_entry_point!(after_expand, sess, state, Ok(()));
205                     Ok(())
206                 },
207             )?
208         };
209
210         let output_paths = generated_output_paths(sess, &outputs, output.is_some(), &crate_name);
211
212         // Ensure the source file isn't accidentally overwritten during compilation.
213         if let Some(ref input_path) = *input_path {
214             if sess.opts.will_create_output_file() {
215                 if output_contains_path(&output_paths, input_path) {
216                     sess.err(&format!(
217                         "the input file \"{}\" would be overwritten by the generated \
218                          executable",
219                         input_path.display()
220                     ));
221                     return Err(CompileIncomplete::Stopped);
222                 }
223                 if let Some(dir_path) = output_conflicts_with_dir(&output_paths) {
224                     sess.err(&format!(
225                         "the generated executable for the input file \"{}\" conflicts with the \
226                          existing directory \"{}\"",
227                         input_path.display(),
228                         dir_path.display()
229                     ));
230                     return Err(CompileIncomplete::Stopped);
231                 }
232             }
233         }
234
235         write_out_deps(sess, &outputs, &output_paths);
236         if sess.opts.output_types.contains_key(&OutputType::DepInfo)
237             && sess.opts.output_types.len() == 1
238         {
239             return Ok(());
240         }
241
242         if let &Some(ref dir) = outdir {
243             if fs::create_dir_all(dir).is_err() {
244                 sess.err("failed to find or create the directory specified by --out-dir");
245                 return Err(CompileIncomplete::Stopped);
246             }
247         }
248
249         let arenas = AllArenas::new();
250
251         // Construct the HIR map
252         let hir_map = time(sess, "indexing hir", || {
253             hir_map::map_crate(sess, cstore, &mut hir_forest, &defs)
254         });
255
256         {
257             hir_map.dep_graph.assert_ignored();
258             controller_entry_point!(
259                 after_hir_lowering,
260                 sess,
261                 CompileState::state_after_hir_lowering(
262                     input,
263                     sess,
264                     outdir,
265                     output,
266                     &arenas,
267                     &cstore,
268                     &hir_map,
269                     &analysis,
270                     &resolutions,
271                     &expanded_crate,
272                     &hir_map.krate(),
273                     &outputs,
274                     &crate_name
275                 ),
276                 Ok(())
277             );
278         }
279
280         let opt_crate = if control.keep_ast {
281             Some(&expanded_crate)
282         } else {
283             drop(expanded_crate);
284             None
285         };
286
287         phase_3_run_analysis_passes(
288             &*codegen_backend,
289             control,
290             sess,
291             cstore,
292             hir_map,
293             analysis,
294             resolutions,
295             &arenas,
296             &crate_name,
297             &outputs,
298             |tcx, analysis, rx, result| {
299                 {
300                     // Eventually, we will want to track plugins.
301                     tcx.dep_graph.with_ignore(|| {
302                         let mut state = CompileState::state_after_analysis(
303                             input,
304                             sess,
305                             outdir,
306                             output,
307                             opt_crate,
308                             tcx.hir().krate(),
309                             &analysis,
310                             tcx,
311                             &crate_name,
312                         );
313                         (control.after_analysis.callback)(&mut state);
314                     });
315
316                     if control.after_analysis.stop == Compilation::Stop {
317                         return result.and_then(|_| Err(CompileIncomplete::Stopped));
318                     }
319                 }
320
321                 result?;
322
323                 if log_enabled!(::log::Level::Info) {
324                     println!("Pre-codegen");
325                     tcx.print_debug_stats();
326                 }
327
328                 let ongoing_codegen = phase_4_codegen(&*codegen_backend, tcx, rx);
329
330                 if log_enabled!(::log::Level::Info) {
331                     println!("Post-codegen");
332                     tcx.print_debug_stats();
333                 }
334
335                 if tcx.sess.opts.output_types.contains_key(&OutputType::Mir) {
336                     if let Err(e) = mir::transform::dump_mir::emit_mir(tcx, &outputs) {
337                         sess.err(&format!("could not emit MIR: {}", e));
338                         sess.abort_if_errors();
339                     }
340                 }
341
342                 Ok((outputs.clone(), ongoing_codegen, tcx.dep_graph.clone()))
343             },
344         )??
345     };
346
347     if sess.opts.debugging_opts.print_type_sizes {
348         sess.code_stats.borrow().print_type_sizes();
349     }
350
351     codegen_backend.join_codegen_and_link(ongoing_codegen, sess, &dep_graph, &outputs)?;
352
353     if sess.opts.debugging_opts.perf_stats {
354         sess.print_perf_stats();
355     }
356
357     if sess.opts.debugging_opts.self_profile {
358         sess.print_profiler_results();
359     }
360
361     if sess.opts.debugging_opts.profile_json {
362         sess.save_json_results();
363     }
364
365     controller_entry_point!(
366         compilation_done,
367         sess,
368         CompileState::state_when_compilation_done(input, sess, outdir, output),
369         Ok(())
370     );
371
372     Ok(())
373 }
374
375 pub fn source_name(input: &Input) -> FileName {
376     match *input {
377         Input::File(ref ifile) => ifile.clone().into(),
378         Input::Str { ref name, .. } => name.clone(),
379     }
380 }
381
382 /// CompileController is used to customize compilation, it allows compilation to
383 /// be stopped and/or to call arbitrary code at various points in compilation.
384 /// It also allows for various flags to be set to influence what information gets
385 /// collected during compilation.
386 ///
387 /// This is a somewhat higher level controller than a Session - the Session
388 /// controls what happens in each phase, whereas the CompileController controls
389 /// whether a phase is run at all and whether other code (from outside the
390 /// compiler) is run between phases.
391 ///
392 /// Note that if compilation is set to stop and a callback is provided for a
393 /// given entry point, the callback is called before compilation is stopped.
394 ///
395 /// Expect more entry points to be added in the future.
396 pub struct CompileController<'a> {
397     pub after_parse: PhaseController<'a>,
398     pub after_expand: PhaseController<'a>,
399     pub after_hir_lowering: PhaseController<'a>,
400     pub after_analysis: PhaseController<'a>,
401     pub compilation_done: PhaseController<'a>,
402
403     // FIXME we probably want to group the below options together and offer a
404     // better API, rather than this ad-hoc approach.
405     pub make_glob_map: MakeGlobMap,
406     // Whether the compiler should keep the ast beyond parsing.
407     pub keep_ast: bool,
408     // -Zcontinue-parse-after-error
409     pub continue_parse_after_error: bool,
410
411     /// Allows overriding default rustc query providers,
412     /// after `default_provide` has installed them.
413     pub provide: Box<dyn Fn(&mut ty::query::Providers) + 'a>,
414     /// Same as `provide`, but only for non-local crates,
415     /// applied after `default_provide_extern`.
416     pub provide_extern: Box<dyn Fn(&mut ty::query::Providers) + 'a>,
417 }
418
419 impl<'a> CompileController<'a> {
420     pub fn basic() -> CompileController<'a> {
421         CompileController {
422             after_parse: PhaseController::basic(),
423             after_expand: PhaseController::basic(),
424             after_hir_lowering: PhaseController::basic(),
425             after_analysis: PhaseController::basic(),
426             compilation_done: PhaseController::basic(),
427             make_glob_map: MakeGlobMap::No,
428             keep_ast: false,
429             continue_parse_after_error: false,
430             provide: box |_| {},
431             provide_extern: box |_| {},
432         }
433     }
434 }
435
436 /// This implementation makes it easier to create a custom driver when you only want to hook
437 /// into callbacks from `CompileController`.
438 ///
439 /// # Example
440 ///
441 /// ```no_run
442 /// # extern crate rustc_driver;
443 /// # use rustc_driver::driver::CompileController;
444 /// let mut controller = CompileController::basic();
445 /// controller.after_analysis.callback = Box::new(move |_state| {});
446 /// rustc_driver::run_compiler(&[], Box::new(controller), None, None);
447 /// ```
448 impl<'a> ::CompilerCalls<'a> for CompileController<'a> {
449     fn early_callback(
450         &mut self,
451         matches: &::getopts::Matches,
452         sopts: &config::Options,
453         cfg: &ast::CrateConfig,
454         descriptions: &::errors::registry::Registry,
455         output: ::ErrorOutputType,
456     ) -> Compilation {
457         ::RustcDefaultCalls.early_callback(
458             matches,
459             sopts,
460             cfg,
461             descriptions,
462             output,
463         )
464     }
465     fn no_input(
466         &mut self,
467         matches: &::getopts::Matches,
468         sopts: &config::Options,
469         cfg: &ast::CrateConfig,
470         odir: &Option<PathBuf>,
471         ofile: &Option<PathBuf>,
472         descriptions: &::errors::registry::Registry,
473     ) -> Option<(Input, Option<PathBuf>)> {
474         ::RustcDefaultCalls.no_input(
475             matches,
476             sopts,
477             cfg,
478             odir,
479             ofile,
480             descriptions,
481         )
482     }
483     fn late_callback(
484         &mut self,
485         codegen_backend: &dyn (::CodegenBackend),
486         matches: &::getopts::Matches,
487         sess: &Session,
488         cstore: &CStore,
489         input: &Input,
490         odir: &Option<PathBuf>,
491         ofile: &Option<PathBuf>,
492     ) -> Compilation {
493         ::RustcDefaultCalls
494             .late_callback(codegen_backend, matches, sess, cstore, input, odir, ofile)
495     }
496     fn build_controller(
497         self: Box<Self>,
498         _: &Session,
499         _: &::getopts::Matches
500     ) -> CompileController<'a> {
501         *self
502     }
503 }
504
505 pub struct PhaseController<'a> {
506     pub stop: Compilation,
507     // If true then the compiler will try to run the callback even if the phase
508     // ends with an error. Note that this is not always possible.
509     pub run_callback_on_error: bool,
510     pub callback: Box<dyn Fn(&mut CompileState) + 'a>,
511 }
512
513 impl<'a> PhaseController<'a> {
514     pub fn basic() -> PhaseController<'a> {
515         PhaseController {
516             stop: Compilation::Continue,
517             run_callback_on_error: false,
518             callback: box |_| {},
519         }
520     }
521 }
522
523 /// State that is passed to a callback. What state is available depends on when
524 /// during compilation the callback is made. See the various constructor methods
525 /// (`state_*`) in the impl to see which data is provided for any given entry point.
526 pub struct CompileState<'a, 'tcx: 'a> {
527     pub input: &'a Input,
528     pub session: &'tcx Session,
529     pub krate: Option<ast::Crate>,
530     pub registry: Option<Registry<'a>>,
531     pub cstore: Option<&'tcx CStore>,
532     pub crate_name: Option<&'a str>,
533     pub output_filenames: Option<&'a OutputFilenames>,
534     pub out_dir: Option<&'a Path>,
535     pub out_file: Option<&'a Path>,
536     pub arenas: Option<&'tcx AllArenas<'tcx>>,
537     pub expanded_crate: Option<&'a ast::Crate>,
538     pub hir_crate: Option<&'a hir::Crate>,
539     pub hir_map: Option<&'a hir_map::Map<'tcx>>,
540     pub resolutions: Option<&'a Resolutions>,
541     pub analysis: Option<&'a ty::CrateAnalysis>,
542     pub tcx: Option<TyCtxt<'a, 'tcx, 'tcx>>,
543 }
544
545 impl<'a, 'tcx> CompileState<'a, 'tcx> {
546     fn empty(input: &'a Input, session: &'tcx Session, out_dir: &'a Option<PathBuf>) -> Self {
547         CompileState {
548             input,
549             session,
550             out_dir: out_dir.as_ref().map(|s| &**s),
551             out_file: None,
552             arenas: None,
553             krate: None,
554             registry: None,
555             cstore: None,
556             crate_name: None,
557             output_filenames: None,
558             expanded_crate: None,
559             hir_crate: None,
560             hir_map: None,
561             resolutions: None,
562             analysis: None,
563             tcx: None,
564         }
565     }
566
567     fn state_after_parse(
568         input: &'a Input,
569         session: &'tcx Session,
570         out_dir: &'a Option<PathBuf>,
571         out_file: &'a Option<PathBuf>,
572         krate: ast::Crate,
573         cstore: &'tcx CStore,
574     ) -> Self {
575         CompileState {
576             // Initialize the registry before moving `krate`
577             registry: Some(Registry::new(&session, krate.span)),
578             krate: Some(krate),
579             cstore: Some(cstore),
580             out_file: out_file.as_ref().map(|s| &**s),
581             ..CompileState::empty(input, session, out_dir)
582         }
583     }
584
585     fn state_after_expand(
586         input: &'a Input,
587         session: &'tcx Session,
588         out_dir: &'a Option<PathBuf>,
589         out_file: &'a Option<PathBuf>,
590         cstore: &'tcx CStore,
591         expanded_crate: &'a ast::Crate,
592         crate_name: &'a str,
593     ) -> Self {
594         CompileState {
595             crate_name: Some(crate_name),
596             cstore: Some(cstore),
597             expanded_crate: Some(expanded_crate),
598             out_file: out_file.as_ref().map(|s| &**s),
599             ..CompileState::empty(input, session, out_dir)
600         }
601     }
602
603     fn state_after_hir_lowering(
604         input: &'a Input,
605         session: &'tcx Session,
606         out_dir: &'a Option<PathBuf>,
607         out_file: &'a Option<PathBuf>,
608         arenas: &'tcx AllArenas<'tcx>,
609         cstore: &'tcx CStore,
610         hir_map: &'a hir_map::Map<'tcx>,
611         analysis: &'a ty::CrateAnalysis,
612         resolutions: &'a Resolutions,
613         krate: &'a ast::Crate,
614         hir_crate: &'a hir::Crate,
615         output_filenames: &'a OutputFilenames,
616         crate_name: &'a str,
617     ) -> Self {
618         CompileState {
619             crate_name: Some(crate_name),
620             arenas: Some(arenas),
621             cstore: Some(cstore),
622             hir_map: Some(hir_map),
623             analysis: Some(analysis),
624             resolutions: Some(resolutions),
625             expanded_crate: Some(krate),
626             hir_crate: Some(hir_crate),
627             output_filenames: Some(output_filenames),
628             out_file: out_file.as_ref().map(|s| &**s),
629             ..CompileState::empty(input, session, out_dir)
630         }
631     }
632
633     fn state_after_analysis(
634         input: &'a Input,
635         session: &'tcx Session,
636         out_dir: &'a Option<PathBuf>,
637         out_file: &'a Option<PathBuf>,
638         krate: Option<&'a ast::Crate>,
639         hir_crate: &'a hir::Crate,
640         analysis: &'a ty::CrateAnalysis,
641         tcx: TyCtxt<'a, 'tcx, 'tcx>,
642         crate_name: &'a str,
643     ) -> Self {
644         CompileState {
645             analysis: Some(analysis),
646             tcx: Some(tcx),
647             expanded_crate: krate,
648             hir_crate: Some(hir_crate),
649             crate_name: Some(crate_name),
650             out_file: out_file.as_ref().map(|s| &**s),
651             ..CompileState::empty(input, session, out_dir)
652         }
653     }
654
655     fn state_when_compilation_done(
656         input: &'a Input,
657         session: &'tcx Session,
658         out_dir: &'a Option<PathBuf>,
659         out_file: &'a Option<PathBuf>,
660     ) -> Self {
661         CompileState {
662             out_file: out_file.as_ref().map(|s| &**s),
663             ..CompileState::empty(input, session, out_dir)
664         }
665     }
666 }
667
668 pub fn phase_1_parse_input<'a>(
669     control: &CompileController,
670     sess: &'a Session,
671     input: &Input,
672 ) -> PResult<'a, ast::Crate> {
673     sess.diagnostic()
674         .set_continue_after_error(control.continue_parse_after_error);
675     hygiene::set_default_edition(sess.edition());
676
677     if sess.profile_queries() {
678         profile::begin(sess);
679     }
680
681     sess.profiler(|p| p.start_activity(ProfileCategory::Parsing));
682     let krate = time(sess, "parsing", || match *input {
683         Input::File(ref file) => parse::parse_crate_from_file(file, &sess.parse_sess),
684         Input::Str {
685             ref input,
686             ref name,
687         } => parse::parse_crate_from_source_str(name.clone(), input.clone(), &sess.parse_sess),
688     })?;
689     sess.profiler(|p| p.end_activity(ProfileCategory::Parsing));
690
691     sess.diagnostic().set_continue_after_error(true);
692
693     if sess.opts.debugging_opts.ast_json_noexpand {
694         println!("{}", json::as_json(&krate));
695     }
696
697     if sess.opts.debugging_opts.input_stats {
698         println!(
699             "Lines of code:             {}",
700             sess.source_map().count_lines()
701         );
702         println!("Pre-expansion node count:  {}", count_nodes(&krate));
703     }
704
705     if let Some(ref s) = sess.opts.debugging_opts.show_span {
706         syntax::show_span::run(sess.diagnostic(), s, &krate);
707     }
708
709     if sess.opts.debugging_opts.hir_stats {
710         hir_stats::print_ast_stats(&krate, "PRE EXPANSION AST STATS");
711     }
712
713     Ok(krate)
714 }
715
716 fn count_nodes(krate: &ast::Crate) -> usize {
717     let mut counter = NodeCounter::new();
718     visit::walk_crate(&mut counter, krate);
719     counter.count
720 }
721
722 // For continuing compilation after a parsed crate has been
723 // modified
724
725 pub struct ExpansionResult {
726     pub expanded_crate: ast::Crate,
727     pub defs: hir_map::Definitions,
728     pub analysis: ty::CrateAnalysis,
729     pub resolutions: Resolutions,
730     pub hir_forest: hir_map::Forest,
731 }
732
733 pub struct InnerExpansionResult<'a, 'b: 'a> {
734     pub expanded_crate: ast::Crate,
735     pub resolver: Resolver<'a, 'b>,
736     pub hir_forest: hir_map::Forest,
737 }
738
739 /// Run the "early phases" of the compiler: initial `cfg` processing,
740 /// loading compiler plugins (including those from `addl_plugins`),
741 /// syntax expansion, secondary `cfg` expansion, synthesis of a test
742 /// harness if one is to be provided, injection of a dependency on the
743 /// standard library and prelude, and name resolution.
744 ///
745 /// Returns `None` if we're aborting after handling -W help.
746 pub fn phase_2_configure_and_expand<F>(
747     sess: &Session,
748     cstore: &CStore,
749     krate: ast::Crate,
750     registry: Option<Registry>,
751     crate_name: &str,
752     addl_plugins: Option<Vec<String>>,
753     make_glob_map: MakeGlobMap,
754     after_expand: F,
755 ) -> Result<ExpansionResult, CompileIncomplete>
756 where
757     F: FnOnce(&ast::Crate) -> CompileResult,
758 {
759     // Currently, we ignore the name resolution data structures for the purposes of dependency
760     // tracking. Instead we will run name resolution and include its output in the hash of each
761     // item, much like we do for macro expansion. In other words, the hash reflects not just
762     // its contents but the results of name resolution on those contents. Hopefully we'll push
763     // this back at some point.
764     let mut crate_loader = CrateLoader::new(sess, &cstore, &crate_name);
765     let resolver_arenas = Resolver::arenas();
766     let result = phase_2_configure_and_expand_inner(
767         sess,
768         cstore,
769         krate,
770         registry,
771         crate_name,
772         addl_plugins,
773         make_glob_map,
774         &resolver_arenas,
775         &mut crate_loader,
776         after_expand,
777     );
778     match result {
779         Ok(InnerExpansionResult {
780             expanded_crate,
781             resolver,
782             hir_forest,
783         }) => Ok(ExpansionResult {
784             expanded_crate,
785             defs: resolver.definitions,
786             hir_forest,
787             resolutions: Resolutions {
788                 freevars: resolver.freevars,
789                 export_map: resolver.export_map,
790                 trait_map: resolver.trait_map,
791                 maybe_unused_trait_imports: resolver.maybe_unused_trait_imports,
792                 maybe_unused_extern_crates: resolver.maybe_unused_extern_crates,
793                 extern_prelude: resolver.extern_prelude.iter().map(|(ident, entry)| {
794                     (ident.name, entry.introduced_by_item)
795                 }).collect(),
796             },
797
798             analysis: ty::CrateAnalysis {
799                 access_levels: Lrc::new(AccessLevels::default()),
800                 name: crate_name.to_string(),
801                 glob_map: if resolver.make_glob_map {
802                     Some(resolver.glob_map)
803                 } else {
804                     None
805                 },
806             },
807         }),
808         Err(x) => Err(x),
809     }
810 }
811
812 /// Same as phase_2_configure_and_expand, but doesn't let you keep the resolver
813 /// around
814 pub fn phase_2_configure_and_expand_inner<'a, 'b: 'a, F>(
815     sess: &'a Session,
816     cstore: &'a CStore,
817     mut krate: ast::Crate,
818     registry: Option<Registry>,
819     crate_name: &str,
820     addl_plugins: Option<Vec<String>>,
821     make_glob_map: MakeGlobMap,
822     resolver_arenas: &'a ResolverArenas<'a>,
823     crate_loader: &'a mut CrateLoader<'b>,
824     after_expand: F,
825 ) -> Result<InnerExpansionResult<'a, 'b>, CompileIncomplete>
826 where
827     F: FnOnce(&ast::Crate) -> CompileResult,
828 {
829     krate = time(sess, "attributes injection", || {
830         syntax::attr::inject(krate, &sess.parse_sess, &sess.opts.debugging_opts.crate_attr)
831     });
832
833     let (mut krate, features) = syntax::config::features(
834         krate,
835         &sess.parse_sess,
836         sess.edition(),
837     );
838     // these need to be set "early" so that expansion sees `quote` if enabled.
839     sess.init_features(features);
840
841     let crate_types = collect_crate_types(sess, &krate.attrs);
842     sess.crate_types.set(crate_types);
843
844     let disambiguator = compute_crate_disambiguator(sess);
845     sess.crate_disambiguator.set(disambiguator);
846     rustc_incremental::prepare_session_directory(sess, &crate_name, disambiguator);
847
848     if sess.opts.incremental.is_some() {
849         time(sess, "garbage collect incremental cache directory", || {
850             if let Err(e) = rustc_incremental::garbage_collect_session_directories(sess) {
851                 warn!(
852                     "Error while trying to garbage collect incremental \
853                      compilation cache directory: {}",
854                     e
855                 );
856             }
857         });
858     }
859
860     // If necessary, compute the dependency graph (in the background).
861     let future_dep_graph = if sess.opts.build_dep_graph() {
862         Some(rustc_incremental::load_dep_graph(sess))
863     } else {
864         None
865     };
866
867     time(sess, "recursion limit", || {
868         middle::recursion_limit::update_limits(sess, &krate);
869     });
870
871     krate = time(sess, "crate injection", || {
872         let alt_std_name = sess.opts.alt_std_name.as_ref().map(|s| &**s);
873         syntax::std_inject::maybe_inject_crates_ref(krate, alt_std_name, sess.edition())
874     });
875
876     let mut addl_plugins = Some(addl_plugins);
877     let registrars = time(sess, "plugin loading", || {
878         plugin::load::load_plugins(
879             sess,
880             &cstore,
881             &krate,
882             crate_name,
883             addl_plugins.take().unwrap(),
884         )
885     });
886
887     let mut registry = registry.unwrap_or_else(|| Registry::new(sess, krate.span));
888
889     time(sess, "plugin registration", || {
890         if sess.features_untracked().rustc_diagnostic_macros {
891             registry.register_macro(
892                 "__diagnostic_used",
893                 diagnostics::plugin::expand_diagnostic_used,
894             );
895             registry.register_macro(
896                 "__register_diagnostic",
897                 diagnostics::plugin::expand_register_diagnostic,
898             );
899             registry.register_macro(
900                 "__build_diagnostic_array",
901                 diagnostics::plugin::expand_build_diagnostic_array,
902             );
903         }
904
905         for registrar in registrars {
906             registry.args_hidden = Some(registrar.args);
907             (registrar.fun)(&mut registry);
908         }
909     });
910
911     let Registry {
912         syntax_exts,
913         early_lint_passes,
914         late_lint_passes,
915         lint_groups,
916         llvm_passes,
917         attributes,
918         ..
919     } = registry;
920
921     sess.track_errors(|| {
922         let mut ls = sess.lint_store.borrow_mut();
923         for pass in early_lint_passes {
924             ls.register_early_pass(Some(sess), true, pass);
925         }
926         for pass in late_lint_passes {
927             ls.register_late_pass(Some(sess), true, pass);
928         }
929
930         for (name, (to, deprecated_name)) in lint_groups {
931             ls.register_group(Some(sess), true, name, deprecated_name, to);
932         }
933
934         *sess.plugin_llvm_passes.borrow_mut() = llvm_passes;
935         *sess.plugin_attributes.borrow_mut() = attributes.clone();
936     })?;
937
938     // Lint plugins are registered; now we can process command line flags.
939     if sess.opts.describe_lints {
940         super::describe_lints(&sess, &sess.lint_store.borrow(), true);
941         return Err(CompileIncomplete::Stopped);
942     }
943
944     time(sess, "pre ast expansion lint checks", || {
945         lint::check_ast_crate(sess, &krate, true)
946     });
947
948     let mut resolver = Resolver::new(
949         sess,
950         cstore,
951         &krate,
952         crate_name,
953         make_glob_map,
954         crate_loader,
955         &resolver_arenas,
956     );
957     syntax_ext::register_builtins(&mut resolver, syntax_exts, sess.features_untracked().quote);
958
959     // Expand all macros
960     sess.profiler(|p| p.start_activity(ProfileCategory::Expansion));
961     krate = time(sess, "expansion", || {
962         // Windows dlls do not have rpaths, so they don't know how to find their
963         // dependencies. It's up to us to tell the system where to find all the
964         // dependent dlls. Note that this uses cfg!(windows) as opposed to
965         // targ_cfg because syntax extensions are always loaded for the host
966         // compiler, not for the target.
967         //
968         // This is somewhat of an inherently racy operation, however, as
969         // multiple threads calling this function could possibly continue
970         // extending PATH far beyond what it should. To solve this for now we
971         // just don't add any new elements to PATH which are already there
972         // within PATH. This is basically a targeted fix at #17360 for rustdoc
973         // which runs rustc in parallel but has been seen (#33844) to cause
974         // problems with PATH becoming too long.
975         let mut old_path = OsString::new();
976         if cfg!(windows) {
977             old_path = env::var_os("PATH").unwrap_or(old_path);
978             let mut new_path = sess.host_filesearch(PathKind::All).get_dylib_search_paths();
979             for path in env::split_paths(&old_path) {
980                 if !new_path.contains(&path) {
981                     new_path.push(path);
982                 }
983             }
984             env::set_var(
985                 "PATH",
986                 &env::join_paths(
987                     new_path
988                         .iter()
989                         .filter(|p| env::join_paths(iter::once(p)).is_ok()),
990                 ).unwrap(),
991             );
992         }
993
994         // Create the config for macro expansion
995         let features = sess.features_untracked();
996         let cfg = syntax::ext::expand::ExpansionConfig {
997             features: Some(&features),
998             recursion_limit: *sess.recursion_limit.get(),
999             trace_mac: sess.opts.debugging_opts.trace_macros,
1000             should_test: sess.opts.test,
1001             ..syntax::ext::expand::ExpansionConfig::default(crate_name.to_string())
1002         };
1003
1004         let mut ecx = ExtCtxt::new(&sess.parse_sess, cfg, &mut resolver);
1005         let err_count = ecx.parse_sess.span_diagnostic.err_count();
1006
1007         // Expand macros now!
1008         let krate = time(sess, "expand crate", || {
1009             ecx.monotonic_expander().expand_crate(krate)
1010         });
1011
1012         // The rest is error reporting
1013
1014         time(sess, "check unused macros", || {
1015             ecx.check_unused_macros();
1016         });
1017
1018         let mut missing_fragment_specifiers: Vec<_> = ecx.parse_sess
1019             .missing_fragment_specifiers
1020             .borrow()
1021             .iter()
1022             .cloned()
1023             .collect();
1024         missing_fragment_specifiers.sort();
1025
1026         for span in missing_fragment_specifiers {
1027             let lint = lint::builtin::MISSING_FRAGMENT_SPECIFIER;
1028             let msg = "missing fragment specifier";
1029             sess.buffer_lint(lint, ast::CRATE_NODE_ID, span, msg);
1030         }
1031         if ecx.parse_sess.span_diagnostic.err_count() - ecx.resolve_err_count > err_count {
1032             ecx.parse_sess.span_diagnostic.abort_if_errors();
1033         }
1034         if cfg!(windows) {
1035             env::set_var("PATH", &old_path);
1036         }
1037         krate
1038     });
1039     sess.profiler(|p| p.end_activity(ProfileCategory::Expansion));
1040
1041     krate = time(sess, "maybe building test harness", || {
1042         syntax::test::modify_for_testing(
1043             &sess.parse_sess,
1044             &mut resolver,
1045             sess.opts.test,
1046             krate,
1047             sess.diagnostic(),
1048             &sess.features_untracked(),
1049         )
1050     });
1051
1052     // If we're actually rustdoc then there's no need to actually compile
1053     // anything, so switch everything to just looping
1054     if sess.opts.actually_rustdoc {
1055         krate = ReplaceBodyWithLoop::new(sess).fold_crate(krate);
1056     }
1057
1058     // If we're in rustdoc we're always compiling as an rlib, but that'll trip a
1059     // bunch of checks in the `modify` function below. For now just skip this
1060     // step entirely if we're rustdoc as it's not too useful anyway.
1061     if !sess.opts.actually_rustdoc {
1062         krate = time(sess, "maybe creating a macro crate", || {
1063             let crate_types = sess.crate_types.borrow();
1064             let num_crate_types = crate_types.len();
1065             let is_proc_macro_crate = crate_types.contains(&config::CrateType::ProcMacro);
1066             let is_test_crate = sess.opts.test;
1067             syntax_ext::proc_macro_decls::modify(
1068                 &sess.parse_sess,
1069                 &mut resolver,
1070                 krate,
1071                 is_proc_macro_crate,
1072                 is_test_crate,
1073                 num_crate_types,
1074                 sess.diagnostic(),
1075             )
1076         });
1077     }
1078
1079     // Expand global allocators, which are treated as an in-tree proc macro
1080     krate = time(sess, "creating allocators", || {
1081         allocator::expand::modify(
1082             &sess.parse_sess,
1083             &mut resolver,
1084             krate,
1085             crate_name.to_string(),
1086             sess.diagnostic(),
1087         )
1088     });
1089
1090     // Add all buffered lints from the `ParseSess` to the `Session`.
1091     sess.parse_sess.buffered_lints.with_lock(|buffered_lints| {
1092         info!("{} parse sess buffered_lints", buffered_lints.len());
1093         for BufferedEarlyLint{id, span, msg, lint_id} in buffered_lints.drain(..) {
1094             let lint = lint::Lint::from_parser_lint_id(lint_id);
1095             sess.buffer_lint(lint, id, span, &msg);
1096         }
1097     });
1098
1099     // Done with macro expansion!
1100
1101     after_expand(&krate)?;
1102
1103     if sess.opts.debugging_opts.input_stats {
1104         println!("Post-expansion node count: {}", count_nodes(&krate));
1105     }
1106
1107     if sess.opts.debugging_opts.hir_stats {
1108         hir_stats::print_ast_stats(&krate, "POST EXPANSION AST STATS");
1109     }
1110
1111     if sess.opts.debugging_opts.ast_json {
1112         println!("{}", json::as_json(&krate));
1113     }
1114
1115     time(sess, "AST validation", || {
1116         ast_validation::check_crate(sess, &krate)
1117     });
1118
1119     time(sess, "name resolution", || -> CompileResult {
1120         resolver.resolve_crate(&krate);
1121         Ok(())
1122     })?;
1123
1124     // Needs to go *after* expansion to be able to check the results of macro expansion.
1125     time(sess, "complete gated feature checking", || {
1126         sess.track_errors(|| {
1127             syntax::feature_gate::check_crate(
1128                 &krate,
1129                 &sess.parse_sess,
1130                 &sess.features_untracked(),
1131                 &attributes,
1132                 sess.opts.unstable_features,
1133             );
1134         })
1135     })?;
1136
1137     // Unresolved macros might be due to mistyped `#[macro_use]`,
1138     // so abort after checking for unknown attributes. (#49074)
1139     if resolver.found_unresolved_macro {
1140         sess.diagnostic().abort_if_errors();
1141     }
1142
1143     // Lower ast -> hir.
1144     // First, we need to collect the dep_graph.
1145     let dep_graph = match future_dep_graph {
1146         None => DepGraph::new_disabled(),
1147         Some(future) => {
1148             let (prev_graph, prev_work_products) =
1149                 time(sess, "blocked while dep-graph loading finishes", || {
1150                     future
1151                         .open()
1152                         .unwrap_or_else(|e| rustc_incremental::LoadResult::Error {
1153                             message: format!("could not decode incremental cache: {:?}", e),
1154                         })
1155                         .open(sess)
1156                 });
1157             DepGraph::new(prev_graph, prev_work_products)
1158         }
1159     };
1160     let hir_forest = time(sess, "lowering ast -> hir", || {
1161         let hir_crate = lower_crate(sess, cstore, &dep_graph, &krate, &mut resolver);
1162
1163         if sess.opts.debugging_opts.hir_stats {
1164             hir_stats::print_hir_stats(&hir_crate);
1165         }
1166
1167         hir_map::Forest::new(hir_crate, &dep_graph)
1168     });
1169
1170     time(sess, "early lint checks", || {
1171         lint::check_ast_crate(sess, &krate, false)
1172     });
1173
1174     // Discard hygiene data, which isn't required after lowering to HIR.
1175     if !sess.opts.debugging_opts.keep_hygiene_data {
1176         syntax::ext::hygiene::clear_markings();
1177     }
1178
1179     Ok(InnerExpansionResult {
1180         expanded_crate: krate,
1181         resolver,
1182         hir_forest,
1183     })
1184 }
1185
1186 pub fn default_provide(providers: &mut ty::query::Providers) {
1187     hir::provide(providers);
1188     borrowck::provide(providers);
1189     mir::provide(providers);
1190     reachable::provide(providers);
1191     resolve_lifetime::provide(providers);
1192     rustc_privacy::provide(providers);
1193     typeck::provide(providers);
1194     ty::provide(providers);
1195     traits::provide(providers);
1196     reachable::provide(providers);
1197     rustc_passes::provide(providers);
1198     rustc_traits::provide(providers);
1199     middle::region::provide(providers);
1200     cstore::provide(providers);
1201     lint::provide(providers);
1202 }
1203
1204 pub fn default_provide_extern(providers: &mut ty::query::Providers) {
1205     cstore::provide_extern(providers);
1206 }
1207
1208 /// Run the resolution, typechecking, region checking and other
1209 /// miscellaneous analysis passes on the crate. Return various
1210 /// structures carrying the results of the analysis.
1211 pub fn phase_3_run_analysis_passes<'tcx, F, R>(
1212     codegen_backend: &dyn CodegenBackend,
1213     control: &CompileController,
1214     sess: &'tcx Session,
1215     cstore: &'tcx CStore,
1216     hir_map: hir_map::Map<'tcx>,
1217     mut analysis: ty::CrateAnalysis,
1218     resolutions: Resolutions,
1219     arenas: &'tcx AllArenas<'tcx>,
1220     name: &str,
1221     output_filenames: &OutputFilenames,
1222     f: F,
1223 ) -> Result<R, CompileIncomplete>
1224 where
1225     F: for<'a> FnOnce(
1226         TyCtxt<'a, 'tcx, 'tcx>,
1227         ty::CrateAnalysis,
1228         mpsc::Receiver<Box<dyn Any + Send>>,
1229         CompileResult,
1230     ) -> R,
1231 {
1232     let query_result_on_disk_cache = time(sess, "load query result cache", || {
1233         rustc_incremental::load_query_result_cache(sess)
1234     });
1235
1236     time(sess, "looking for entry point", || {
1237         middle::entry::find_entry_point(sess, &hir_map, name)
1238     });
1239
1240     sess.plugin_registrar_fn
1241         .set(time(sess, "looking for plugin registrar", || {
1242             plugin::build::find_plugin_registrar(sess.diagnostic(), &hir_map)
1243         }));
1244     sess.proc_macro_decls_static
1245         .set(proc_macro_decls::find(&hir_map));
1246
1247     time(sess, "loop checking", || loops::check_crate(sess, &hir_map));
1248
1249     let mut local_providers = ty::query::Providers::default();
1250     default_provide(&mut local_providers);
1251     codegen_backend.provide(&mut local_providers);
1252     (control.provide)(&mut local_providers);
1253
1254     let mut extern_providers = local_providers;
1255     default_provide_extern(&mut extern_providers);
1256     codegen_backend.provide_extern(&mut extern_providers);
1257     (control.provide_extern)(&mut extern_providers);
1258
1259     let (tx, rx) = mpsc::channel();
1260
1261     TyCtxt::create_and_enter(
1262         sess,
1263         cstore,
1264         local_providers,
1265         extern_providers,
1266         arenas,
1267         resolutions,
1268         hir_map,
1269         query_result_on_disk_cache,
1270         name,
1271         tx,
1272         output_filenames,
1273         |tcx| {
1274             // Do some initialization of the DepGraph that can only be done with the
1275             // tcx available.
1276             rustc_incremental::dep_graph_tcx_init(tcx);
1277
1278             time(sess, "attribute checking", || {
1279                 hir::check_attr::check_crate(tcx)
1280             });
1281
1282             time(sess, "stability checking", || {
1283                 stability::check_unstable_api_usage(tcx)
1284             });
1285
1286             // passes are timed inside typeck
1287             match typeck::check_crate(tcx) {
1288                 Ok(x) => x,
1289                 Err(x) => {
1290                     f(tcx, analysis, rx, Err(x));
1291                     return Err(x);
1292                 }
1293             }
1294
1295             time(sess, "rvalue promotion", || {
1296                 rvalue_promotion::check_crate(tcx)
1297             });
1298
1299             analysis.access_levels =
1300                 time(sess, "privacy checking", || rustc_privacy::check_crate(tcx));
1301
1302             time(sess, "intrinsic checking", || {
1303                 middle::intrinsicck::check_crate(tcx)
1304             });
1305
1306             time(sess, "match checking", || mir::matchck_crate(tcx));
1307
1308             // this must run before MIR dump, because
1309             // "not all control paths return a value" is reported here.
1310             //
1311             // maybe move the check to a MIR pass?
1312             time(sess, "liveness checking", || {
1313                 middle::liveness::check_crate(tcx)
1314             });
1315
1316             time(sess, "borrow checking", || {
1317                 if tcx.use_ast_borrowck() {
1318                     borrowck::check_crate(tcx);
1319                 }
1320             });
1321
1322             time(sess,
1323                  "MIR borrow checking",
1324                  || tcx.par_body_owners(|def_id| { tcx.mir_borrowck(def_id); }));
1325
1326             time(sess, "dumping chalk-like clauses", || {
1327                 rustc_traits::lowering::dump_program_clauses(tcx);
1328             });
1329
1330             time(sess, "MIR effect checking", || {
1331                 for def_id in tcx.body_owners() {
1332                     mir::transform::check_unsafety::check_unsafety(tcx, def_id)
1333                 }
1334             });
1335             // Avoid overwhelming user with errors if type checking failed.
1336             // I'm not sure how helpful this is, to be honest, but it avoids
1337             // a
1338             // lot of annoying errors in the compile-fail tests (basically,
1339             // lint warnings and so on -- kindck used to do this abort, but
1340             // kindck is gone now). -nmatsakis
1341             if sess.err_count() > 0 {
1342                 return Ok(f(tcx, analysis, rx, sess.compile_status()));
1343             }
1344
1345             time(sess, "death checking", || middle::dead::check_crate(tcx));
1346
1347             time(sess, "unused lib feature checking", || {
1348                 stability::check_unused_or_stable_features(tcx)
1349             });
1350
1351             time(sess, "lint checking", || lint::check_crate(tcx));
1352
1353             return Ok(f(tcx, analysis, rx, tcx.sess.compile_status()));
1354         },
1355     )
1356 }
1357
1358 /// Run the codegen backend, after which the AST and analysis can
1359 /// be discarded.
1360 pub fn phase_4_codegen<'a, 'tcx>(
1361     codegen_backend: &dyn CodegenBackend,
1362     tcx: TyCtxt<'a, 'tcx, 'tcx>,
1363     rx: mpsc::Receiver<Box<dyn Any + Send>>,
1364 ) -> Box<dyn Any> {
1365     time(tcx.sess, "resolving dependency formats", || {
1366         ::rustc::middle::dependency_format::calculate(tcx)
1367     });
1368
1369     tcx.sess.profiler(|p| p.start_activity(ProfileCategory::Codegen));
1370     let codegen = time(tcx.sess, "codegen", move || codegen_backend.codegen_crate(tcx, rx));
1371     tcx.sess.profiler(|p| p.end_activity(ProfileCategory::Codegen));
1372     if tcx.sess.profile_queries() {
1373         profile::dump(&tcx.sess, "profile_queries".to_string())
1374     }
1375
1376     codegen
1377 }
1378
1379 fn escape_dep_filename(filename: &FileName) -> String {
1380     // Apparently clang and gcc *only* escape spaces:
1381     // http://llvm.org/klaus/clang/commit/9d50634cfc268ecc9a7250226dd5ca0e945240d4
1382     filename.to_string().replace(" ", "\\ ")
1383 }
1384
1385 // Returns all the paths that correspond to generated files.
1386 fn generated_output_paths(
1387     sess: &Session,
1388     outputs: &OutputFilenames,
1389     exact_name: bool,
1390     crate_name: &str,
1391 ) -> Vec<PathBuf> {
1392     let mut out_filenames = Vec::new();
1393     for output_type in sess.opts.output_types.keys() {
1394         let file = outputs.path(*output_type);
1395         match *output_type {
1396             // If the filename has been overridden using `-o`, it will not be modified
1397             // by appending `.rlib`, `.exe`, etc., so we can skip this transformation.
1398             OutputType::Exe if !exact_name => for crate_type in sess.crate_types.borrow().iter() {
1399                 let p = ::rustc_codegen_utils::link::filename_for_input(
1400                     sess,
1401                     *crate_type,
1402                     crate_name,
1403                     outputs,
1404                 );
1405                 out_filenames.push(p);
1406             },
1407             OutputType::DepInfo if sess.opts.debugging_opts.dep_info_omit_d_target => {
1408                 // Don't add the dep-info output when omitting it from dep-info targets
1409             }
1410             _ => {
1411                 out_filenames.push(file);
1412             }
1413         }
1414     }
1415     out_filenames
1416 }
1417
1418 // Runs `f` on every output file path and returns the first non-None result, or None if `f`
1419 // returns None for every file path.
1420 fn check_output<F, T>(output_paths: &[PathBuf], f: F) -> Option<T>
1421 where
1422     F: Fn(&PathBuf) -> Option<T>,
1423 {
1424     for output_path in output_paths {
1425         if let Some(result) = f(output_path) {
1426             return Some(result);
1427         }
1428     }
1429     None
1430 }
1431
1432 pub fn output_contains_path(output_paths: &[PathBuf], input_path: &PathBuf) -> bool {
1433     let input_path = input_path.canonicalize().ok();
1434     if input_path.is_none() {
1435         return false;
1436     }
1437     let check = |output_path: &PathBuf| {
1438         if output_path.canonicalize().ok() == input_path {
1439             Some(())
1440         } else {
1441             None
1442         }
1443     };
1444     check_output(output_paths, check).is_some()
1445 }
1446
1447 pub fn output_conflicts_with_dir(output_paths: &[PathBuf]) -> Option<PathBuf> {
1448     let check = |output_path: &PathBuf| {
1449         if output_path.is_dir() {
1450             Some(output_path.clone())
1451         } else {
1452             None
1453         }
1454     };
1455     check_output(output_paths, check)
1456 }
1457
1458 fn write_out_deps(sess: &Session, outputs: &OutputFilenames, out_filenames: &[PathBuf]) {
1459     // Write out dependency rules to the dep-info file if requested
1460     if !sess.opts.output_types.contains_key(&OutputType::DepInfo) {
1461         return;
1462     }
1463     let deps_filename = outputs.path(OutputType::DepInfo);
1464
1465     let result = (|| -> io::Result<()> {
1466         // Build a list of files used to compile the output and
1467         // write Makefile-compatible dependency rules
1468         let files: Vec<String> = sess.source_map()
1469             .files()
1470             .iter()
1471             .filter(|fmap| fmap.is_real_file())
1472             .filter(|fmap| !fmap.is_imported())
1473             .map(|fmap| escape_dep_filename(&fmap.name))
1474             .collect();
1475         let mut file = fs::File::create(&deps_filename)?;
1476         for path in out_filenames {
1477             writeln!(file, "{}: {}\n", path.display(), files.join(" "))?;
1478         }
1479
1480         // Emit a fake target for each input file to the compilation. This
1481         // prevents `make` from spitting out an error if a file is later
1482         // deleted. For more info see #28735
1483         for path in files {
1484             writeln!(file, "{}:", path)?;
1485         }
1486         Ok(())
1487     })();
1488
1489     if let Err(e) = result {
1490         sess.fatal(&format!(
1491             "error writing dependencies to `{}`: {}",
1492             deps_filename.display(),
1493             e
1494         ));
1495     }
1496 }
1497
1498 pub fn collect_crate_types(session: &Session, attrs: &[ast::Attribute]) -> Vec<config::CrateType> {
1499     // Unconditionally collect crate types from attributes to make them used
1500     let attr_types: Vec<config::CrateType> = attrs
1501         .iter()
1502         .filter_map(|a| {
1503             if a.check_name("crate_type") {
1504                 match a.value_str() {
1505                     Some(ref n) if *n == "rlib" => Some(config::CrateType::Rlib),
1506                     Some(ref n) if *n == "dylib" => Some(config::CrateType::Dylib),
1507                     Some(ref n) if *n == "cdylib" => Some(config::CrateType::Cdylib),
1508                     Some(ref n) if *n == "lib" => Some(config::default_lib_output()),
1509                     Some(ref n) if *n == "staticlib" => Some(config::CrateType::Staticlib),
1510                     Some(ref n) if *n == "proc-macro" => Some(config::CrateType::ProcMacro),
1511                     Some(ref n) if *n == "bin" => Some(config::CrateType::Executable),
1512                     Some(ref n) => {
1513                         let crate_types = vec![
1514                             Symbol::intern("rlib"),
1515                             Symbol::intern("dylib"),
1516                             Symbol::intern("cdylib"),
1517                             Symbol::intern("lib"),
1518                             Symbol::intern("staticlib"),
1519                             Symbol::intern("proc-macro"),
1520                             Symbol::intern("bin")
1521                         ];
1522
1523                         if let ast::MetaItemKind::NameValue(spanned) = a.meta().unwrap().node {
1524                             let span = spanned.span;
1525                             let lev_candidate = find_best_match_for_name(
1526                                 crate_types.iter(),
1527                                 &n.as_str(),
1528                                 None
1529                             );
1530                             if let Some(candidate) = lev_candidate {
1531                                 session.buffer_lint_with_diagnostic(
1532                                     lint::builtin::UNKNOWN_CRATE_TYPES,
1533                                     ast::CRATE_NODE_ID,
1534                                     span,
1535                                     "invalid `crate_type` value",
1536                                     lint::builtin::BuiltinLintDiagnostics::
1537                                         UnknownCrateTypes(
1538                                             span,
1539                                             "did you mean".to_string(),
1540                                             format!("\"{}\"", candidate)
1541                                         )
1542                                 );
1543                             } else {
1544                                 session.buffer_lint(
1545                                     lint::builtin::UNKNOWN_CRATE_TYPES,
1546                                     ast::CRATE_NODE_ID,
1547                                     span,
1548                                     "invalid `crate_type` value"
1549                                 );
1550                             }
1551                         }
1552                         None
1553                     }
1554                     None => {
1555                         session
1556                             .struct_span_err(a.span, "`crate_type` requires a value")
1557                             .note("for example: `#![crate_type=\"lib\"]`")
1558                             .emit();
1559                         None
1560                     }
1561                 }
1562             } else {
1563                 None
1564             }
1565         })
1566         .collect();
1567
1568     // If we're generating a test executable, then ignore all other output
1569     // styles at all other locations
1570     if session.opts.test {
1571         return vec![config::CrateType::Executable];
1572     }
1573
1574     // Only check command line flags if present. If no types are specified by
1575     // command line, then reuse the empty `base` Vec to hold the types that
1576     // will be found in crate attributes.
1577     let mut base = session.opts.crate_types.clone();
1578     if base.is_empty() {
1579         base.extend(attr_types);
1580         if base.is_empty() {
1581             base.push(::rustc_codegen_utils::link::default_output_for_target(
1582                 session,
1583             ));
1584         } else {
1585             base.sort();
1586             base.dedup();
1587         }
1588     }
1589
1590     base.retain(|crate_type| {
1591         let res = !::rustc_codegen_utils::link::invalid_output_for_target(session, *crate_type);
1592
1593         if !res {
1594             session.warn(&format!(
1595                 "dropping unsupported crate type `{}` for target `{}`",
1596                 *crate_type, session.opts.target_triple
1597             ));
1598         }
1599
1600         res
1601     });
1602
1603     base
1604 }
1605
1606 pub fn compute_crate_disambiguator(session: &Session) -> CrateDisambiguator {
1607     use std::hash::Hasher;
1608
1609     // The crate_disambiguator is a 128 bit hash. The disambiguator is fed
1610     // into various other hashes quite a bit (symbol hashes, incr. comp. hashes,
1611     // debuginfo type IDs, etc), so we don't want it to be too wide. 128 bits
1612     // should still be safe enough to avoid collisions in practice.
1613     let mut hasher = StableHasher::<Fingerprint>::new();
1614
1615     let mut metadata = session.opts.cg.metadata.clone();
1616     // We don't want the crate_disambiguator to dependent on the order
1617     // -C metadata arguments, so sort them:
1618     metadata.sort();
1619     // Every distinct -C metadata value is only incorporated once:
1620     metadata.dedup();
1621
1622     hasher.write(b"metadata");
1623     for s in &metadata {
1624         // Also incorporate the length of a metadata string, so that we generate
1625         // different values for `-Cmetadata=ab -Cmetadata=c` and
1626         // `-Cmetadata=a -Cmetadata=bc`
1627         hasher.write_usize(s.len());
1628         hasher.write(s.as_bytes());
1629     }
1630
1631     // Also incorporate crate type, so that we don't get symbol conflicts when
1632     // linking against a library of the same name, if this is an executable.
1633     let is_exe = session
1634         .crate_types
1635         .borrow()
1636         .contains(&config::CrateType::Executable);
1637     hasher.write(if is_exe { b"exe" } else { b"lib" });
1638
1639     CrateDisambiguator::from(hasher.finish())
1640 }
1641
1642 pub fn build_output_filenames(
1643     input: &Input,
1644     odir: &Option<PathBuf>,
1645     ofile: &Option<PathBuf>,
1646     attrs: &[ast::Attribute],
1647     sess: &Session,
1648 ) -> OutputFilenames {
1649     match *ofile {
1650         None => {
1651             // "-" as input file will cause the parser to read from stdin so we
1652             // have to make up a name
1653             // We want to toss everything after the final '.'
1654             let dirpath = (*odir).as_ref().cloned().unwrap_or_default();
1655
1656             // If a crate name is present, we use it as the link name
1657             let stem = sess.opts
1658                 .crate_name
1659                 .clone()
1660                 .or_else(|| attr::find_crate_name(attrs).map(|n| n.to_string()))
1661                 .unwrap_or_else(|| input.filestem().to_owned());
1662
1663             OutputFilenames {
1664                 out_directory: dirpath,
1665                 out_filestem: stem,
1666                 single_output_file: None,
1667                 extra: sess.opts.cg.extra_filename.clone(),
1668                 outputs: sess.opts.output_types.clone(),
1669             }
1670         }
1671
1672         Some(ref out_file) => {
1673             let unnamed_output_types = sess.opts
1674                 .output_types
1675                 .values()
1676                 .filter(|a| a.is_none())
1677                 .count();
1678             let ofile = if unnamed_output_types > 1 {
1679                 sess.warn(
1680                     "due to multiple output types requested, the explicitly specified \
1681                      output file name will be adapted for each output type",
1682                 );
1683                 None
1684             } else {
1685                 Some(out_file.clone())
1686             };
1687             if *odir != None {
1688                 sess.warn("ignoring --out-dir flag due to -o flag");
1689             }
1690             if !sess.opts.cg.extra_filename.is_empty() {
1691                 sess.warn("ignoring -C extra-filename flag due to -o flag");
1692             }
1693
1694             OutputFilenames {
1695                 out_directory: out_file.parent().unwrap_or_else(|| Path::new("")).to_path_buf(),
1696                 out_filestem: out_file
1697                     .file_stem()
1698                     .unwrap_or_default()
1699                     .to_str()
1700                     .unwrap()
1701                     .to_string(),
1702                 single_output_file: ofile,
1703                 extra: sess.opts.cg.extra_filename.clone(),
1704                 outputs: sess.opts.output_types.clone(),
1705             }
1706         }
1707     }
1708 }