1 use crate::interface::{Compiler, Result};
2 use crate::passes::{self, BoxedResolver, QueryContext};
4 use rustc::arena::Arena;
5 use rustc::dep_graph::DepGraph;
8 use rustc::lint::LintStore;
9 use rustc::session::config::{OutputFilenames, OutputType};
10 use rustc::session::Session;
11 use rustc::ty::steal::Steal;
12 use rustc::ty::{AllArenas, GlobalCtxt, ResolverOutputs};
13 use rustc::util::common::ErrorReported;
14 use rustc_codegen_utils::codegen_backend::CodegenBackend;
15 use rustc_data_structures::sync::{Lrc, Once, WorkerLocal};
16 use rustc_hir::def_id::LOCAL_CRATE;
17 use rustc_incremental::DepGraphFuture;
19 use std::cell::{Ref, RefCell, RefMut};
22 use syntax::{self, ast};
24 /// Represent the result of a query.
25 /// This result can be stolen with the `take` method and generated with the `compute` method.
27 result: RefCell<Option<Result<T>>>,
31 fn compute<F: FnOnce() -> Result<T>>(&self, f: F) -> Result<&Query<T>> {
32 let mut result = self.result.borrow_mut();
36 result.as_ref().unwrap().as_ref().map(|_| self).map_err(|err| *err)
39 /// Takes ownership of the query result. Further attempts to take or peek the query
40 /// result will panic unless it is generated by calling the `compute` method.
41 pub fn take(&self) -> T {
42 self.result.borrow_mut().take().expect("missing query result").unwrap()
45 /// Borrows the query result using the RefCell. Panics if the result is stolen.
46 pub fn peek(&self) -> Ref<'_, T> {
47 Ref::map(self.result.borrow(), |r| {
48 r.as_ref().unwrap().as_ref().expect("missing query result")
52 /// Mutably borrows the query result using the RefCell. Panics if the result is stolen.
53 pub fn peek_mut(&self) -> RefMut<'_, T> {
54 RefMut::map(self.result.borrow_mut(), |r| {
55 r.as_mut().unwrap().as_mut().expect("missing query result")
60 impl<T> Default for Query<T> {
61 fn default() -> Self {
62 Query { result: RefCell::new(None) }
66 pub struct Queries<'tcx> {
67 compiler: &'tcx Compiler,
68 gcx: Once<GlobalCtxt<'tcx>>,
70 all_arenas: AllArenas,
71 arena: WorkerLocal<Arena<'tcx>>,
73 dep_graph_future: Query<Option<DepGraphFuture>>,
74 parse: Query<ast::Crate>,
75 crate_name: Query<String>,
76 register_plugins: Query<(ast::Crate, Lrc<LintStore>)>,
77 expansion: Query<(ast::Crate, Steal<Rc<RefCell<BoxedResolver>>>, Lrc<LintStore>)>,
78 dep_graph: Query<DepGraph>,
79 lower_to_hir: Query<(&'tcx map::Forest<'tcx>, Steal<ResolverOutputs>)>,
80 prepare_outputs: Query<OutputFilenames>,
81 global_ctxt: Query<QueryContext<'tcx>>,
82 ongoing_codegen: Query<Box<dyn Any>>,
85 impl<'tcx> Queries<'tcx> {
86 pub fn new(compiler: &'tcx Compiler) -> Queries<'tcx> {
90 all_arenas: AllArenas::new(),
91 arena: WorkerLocal::new(|_| Arena::default()),
92 dep_graph_future: Default::default(),
93 parse: Default::default(),
94 crate_name: Default::default(),
95 register_plugins: Default::default(),
96 expansion: Default::default(),
97 dep_graph: Default::default(),
98 lower_to_hir: Default::default(),
99 prepare_outputs: Default::default(),
100 global_ctxt: Default::default(),
101 ongoing_codegen: Default::default(),
105 fn session(&self) -> &Lrc<Session> {
108 fn codegen_backend(&self) -> &Lrc<Box<dyn CodegenBackend>> {
109 &self.compiler.codegen_backend()
112 pub fn dep_graph_future(&self) -> Result<&Query<Option<DepGraphFuture>>> {
113 self.dep_graph_future.compute(|| {
118 .then(|| rustc_incremental::load_dep_graph(self.session())))
122 pub fn parse(&self) -> Result<&Query<ast::Crate>> {
123 self.parse.compute(|| {
124 passes::parse(self.session(), &self.compiler.input).map_err(|mut parse_error| {
131 pub fn register_plugins(&self) -> Result<&Query<(ast::Crate, Lrc<LintStore>)>> {
132 self.register_plugins.compute(|| {
133 let crate_name = self.crate_name()?.peek().clone();
134 let krate = self.parse()?.take();
136 let empty: &(dyn Fn(&Session, &mut lint::LintStore) + Sync + Send) = &|_, _| {};
137 let result = passes::register_plugins(
139 &*self.codegen_backend().metadata_loader(),
140 self.compiler.register_lints.as_ref().map(|p| &**p).unwrap_or_else(|| empty),
145 // Compute the dependency graph (in the background). We want to do
146 // this as early as possible, to give the DepGraph maximum time to
147 // load before dep_graph() is called, but it also can't happen
148 // until after rustc_incremental::prepare_session_directory() is
149 // called, which happens within passes::register_plugins().
150 self.dep_graph_future().ok();
156 pub fn crate_name(&self) -> Result<&Query<String>> {
157 self.crate_name.compute(|| {
158 Ok(match self.compiler.crate_name {
159 Some(ref crate_name) => crate_name.clone(),
161 let parse_result = self.parse()?;
162 let krate = parse_result.peek();
163 rustc_codegen_utils::link::find_crate_name(
164 Some(self.session()),
166 &self.compiler.input,
175 ) -> Result<&Query<(ast::Crate, Steal<Rc<RefCell<BoxedResolver>>>, Lrc<LintStore>)>> {
176 self.expansion.compute(|| {
177 let crate_name = self.crate_name()?.peek().clone();
178 let (krate, lint_store) = self.register_plugins()?.take();
179 let _timer = self.session().timer("configure_and_expand");
180 passes::configure_and_expand(
181 self.session().clone(),
183 self.codegen_backend().metadata_loader(),
187 .map(|(krate, resolver)| {
188 (krate, Steal::new(Rc::new(RefCell::new(resolver))), lint_store)
193 pub fn dep_graph(&self) -> Result<&Query<DepGraph>> {
194 self.dep_graph.compute(|| {
195 Ok(match self.dep_graph_future()?.take() {
196 None => DepGraph::new_disabled(),
198 let (prev_graph, prev_work_products) =
199 self.session().time("blocked_on_dep_graph_loading", || {
202 .unwrap_or_else(|e| rustc_incremental::LoadResult::Error {
203 message: format!("could not decode incremental cache: {:?}", e),
205 .open(self.session())
207 DepGraph::new(prev_graph, prev_work_products)
215 ) -> Result<&Query<(&'tcx map::Forest<'tcx>, Steal<ResolverOutputs>)>> {
216 self.lower_to_hir.compute(|| {
217 let expansion_result = self.expansion()?;
218 let peeked = expansion_result.peek();
219 let krate = &peeked.0;
220 let resolver = peeked.1.steal();
221 let lint_store = &peeked.2;
222 let hir = resolver.borrow_mut().access(|resolver| {
223 passes::lower_to_hir(
227 &*self.dep_graph()?.peek(),
232 let hir = self.arena.alloc(hir);
233 Ok((hir, Steal::new(BoxedResolver::to_resolver_outputs(resolver))))
237 pub fn prepare_outputs(&self) -> Result<&Query<OutputFilenames>> {
238 self.prepare_outputs.compute(|| {
239 let expansion_result = self.expansion()?;
240 let (krate, boxed_resolver, _) = &*expansion_result.peek();
241 let crate_name = self.crate_name()?;
242 let crate_name = crate_name.peek();
243 passes::prepare_outputs(
253 pub fn global_ctxt(&'tcx self) -> Result<&Query<QueryContext<'tcx>>> {
254 self.global_ctxt.compute(|| {
255 let crate_name = self.crate_name()?.peek().clone();
256 let outputs = self.prepare_outputs()?.peek().clone();
257 let lint_store = self.expansion()?.peek().2.clone();
258 let hir = self.lower_to_hir()?.peek();
259 let (ref hir_forest, ref resolver_outputs) = &*hir;
260 let _timer = self.session().timer("create_global_ctxt");
261 Ok(passes::create_global_ctxt(
265 resolver_outputs.steal(),
275 pub fn ongoing_codegen(&'tcx self) -> Result<&Query<Box<dyn Any>>> {
276 self.ongoing_codegen.compute(|| {
277 let outputs = self.prepare_outputs()?;
278 self.global_ctxt()?.peek_mut().enter(|tcx| {
279 tcx.analysis(LOCAL_CRATE).ok();
281 // Don't do code generation if there were any errors
282 self.session().compile_status()?;
284 Ok(passes::start_codegen(&***self.codegen_backend(), tcx, &*outputs.peek()))
289 pub fn linker(&'tcx self) -> Result<Linker> {
290 let dep_graph = self.dep_graph()?;
291 let prepare_outputs = self.prepare_outputs()?;
292 let ongoing_codegen = self.ongoing_codegen()?;
294 let sess = self.session().clone();
295 let codegen_backend = self.codegen_backend().clone();
299 dep_graph: dep_graph.peek().clone(),
300 prepare_outputs: prepare_outputs.take(),
301 ongoing_codegen: ongoing_codegen.take(),
310 prepare_outputs: OutputFilenames,
311 ongoing_codegen: Box<dyn Any>,
312 codegen_backend: Lrc<Box<dyn CodegenBackend>>,
316 pub fn link(self) -> Result<()> {
319 .join_codegen_and_link(
320 self.ongoing_codegen,
323 &self.prepare_outputs,
325 .map_err(|_| ErrorReported);
326 let prof = self.sess.prof.clone();
327 let dep_graph = self.dep_graph;
328 prof.generic_activity("drop_dep_graph").run(move || drop(dep_graph));
334 pub fn enter<F, T>(&self, f: F) -> T
336 F: for<'tcx> FnOnce(&'tcx Queries<'tcx>) -> T,
338 let mut _timer = None;
339 let queries = Queries::new(&self);
340 let ret = f(&queries);
342 if self.session().opts.debugging_opts.query_stats {
343 if let Ok(gcx) = queries.global_ctxt() {
344 gcx.peek().print_stats();
348 _timer = Some(self.session().timer("free_global_ctxt"));
353 // This method is different to all the other methods in `Compiler` because
354 // it lacks a `Queries` entry. It's also not currently used. It does serve
355 // as an example of how `Compiler` can be used, with additional steps added
356 // between some passes. And see `rustc_driver::run_compiler` for a more
358 pub fn compile(&self) -> Result<()> {
359 let linker = self.enter(|queries| {
360 queries.prepare_outputs()?;
362 if self.session().opts.output_types.contains_key(&OutputType::DepInfo)
363 && self.session().opts.output_types.len() == 1
368 queries.global_ctxt()?;
370 // Drop AST after creating GlobalCtxt to free memory.
371 mem::drop(queries.expansion()?.take());
373 queries.ongoing_codegen()?;
375 let linker = queries.linker()?;
379 if let Some(linker) = linker {