Crate rustc_incremental

Support for serializing the dep-graph and reloading it.

Modules

• assert_dep_graph 🔒
  This pass is only used for the UNIT TESTS and DEBUGGING NEEDS around dependency graph construction. It serves two purposes; it will dump graphs in graphviz form to disk, and it searches for #[rustc_if_this_changed] and #[rustc_then_this_would_need] annotations. These annotations can be used to test whether paths exist in the graph. These checks run after codegen, so they view the the final state of the dependency graph. Note that there are similar assertions found in persist::dirty_clean which check the initial state of the dependency graph, just after it has been loaded from disk.
• assert_module_sources
  This pass is only used for UNIT TESTS related to incremental compilation. It tests whether a particular .o file will be re-used from a previous compilation or whether it must be regenerated.
• errors 🔒
• persist 🔒
  When in incremental mode, this pass dumps out the dependency graph into the given directory. At the same time, it also hashes the various HIR nodes.

Enums

• LoadResult
  Represents the result of an attempt to load incremental compilation data.

Statics

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

Functions

• copy_cgu_workproduct_to_incr_comp_cache_dir
  Copies a CGU work product to the incremental compilation directory, so next compilation can find and reuse it.
• delete_workproduct_files
  Removes files for a given work product.
• finalize_session_directory
  This function finalizes and thus ‘publishes’ the session directory by renaming it to s-{timestamp}-{svh} and releasing the file lock. If there have been compilation errors, however, this function will just delete the presumably invalid session directory.
• garbage_collect_session_directories
  Runs garbage collection for the current session.
• in_incr_comp_dir
  Returns the path for a given filename within the incremental compilation directory, not necessarily from the current session.
• in_incr_comp_dir_sess
  Returns the path for a given filename within the incremental compilation directory in the current session.
• load_query_result_cache
  Attempts to load the query result cache from disk
• prepare_session_directory
  Allocates the private session directory.
• save_dep_graph
  Saves and writes the DepGraph to the file system.
• save_work_product_index
  Saves the work product index.
• setup_dep_graph
  Setups the dependency graph by loading an existing graph from disk and set up streaming of a new graph to an incremental session directory.