mod expressions; mod functions; mod handle_set_map; mod statements; mod types; use crate::{arena, compact::functions::FunctionTracer}; use handle_set_map::{HandleMap, HandleSet}; /// Remove unused types, expressions, and constants from `module`. /// /// Assuming that all globals, named constants, special types, /// functions and entry points in `module` are used, determine which /// types, constants, and expressions (both function-local and global /// constant expressions) are actually used, and remove the rest, /// adjusting all handles as necessary. The result should be a module /// functionally identical to the original. /// /// This may be useful to apply to modules generated in the snapshot /// tests. Our backends often generate temporary names based on handle /// indices, which means that adding or removing unused arena entries /// can affect the output even though they have no semantic effect. /// Such meaningless changes add noise to snapshot diffs, making /// accurate patch review difficult. Compacting the modules before /// generating snapshots makes the output independent of unused arena /// entries. /// /// # Panics /// /// If `module` has not passed validation, this may panic. pub fn compact(module: &mut crate::Module) { let mut module_tracer = ModuleTracer::new(module); // We treat all globals as used by definition. log::trace!("tracing global variables"); { for (_, global) in module.global_variables.iter() { log::trace!("tracing global {:?}", global.name); module_tracer.types_used.insert(global.ty); if let Some(init) = global.init { module_tracer.const_expressions_used.insert(init); } } } // We treat all special types as used by definition. module_tracer.trace_special_types(&module.special_types); // We treat all named constants as used by definition. for (handle, constant) in module.constants.iter() { if constant.name.is_some() { module_tracer.constants_used.insert(handle); module_tracer.const_expressions_used.insert(constant.init); } } // We assume that all functions are used. // // Observe which types, constant expressions, constants, and // expressions each function uses, and produce maps for each // function from pre-compaction to post-compaction expression // handles. log::trace!("tracing functions"); let function_maps: Vec = module .functions .iter() .map(|(_, f)| { log::trace!("tracing function {:?}", f.name); let mut function_tracer = module_tracer.as_function(f); function_tracer.trace(); FunctionMap::from(function_tracer) }) .collect(); // Similarly, observe what each entry point actually uses. log::trace!("tracing entry points"); let entry_point_maps: Vec = module .entry_points .iter() .map(|e| { log::trace!("tracing entry point {:?}", e.function.name); let mut used = module_tracer.as_function(&e.function); used.trace(); FunctionMap::from(used) }) .collect(); // Given that the above steps have marked all the constant // expressions used directly by globals, constants, functions, and // entry points, walk the constant expression arena to find all // constant expressions used, directly or indirectly. module_tracer.as_const_expression().trace_expressions(); // Constants' initializers are taken care of already, because // expression tracing sees through constants. But we still need to // note type usage. for (handle, constant) in module.constants.iter() { if module_tracer.constants_used.contains(handle) { module_tracer.types_used.insert(constant.ty); } } // Treat all named types as used. for (handle, ty) in module.types.iter() { log::trace!("tracing type {:?}, name {:?}", handle, ty.name); if ty.name.is_some() { module_tracer.types_used.insert(handle); } } // Propagate usage through types. module_tracer.as_type().trace_types(); // Now that we know what is used and what is never touched, // produce maps from the `Handle`s that appear in `module` now to // the corresponding `Handle`s that will refer to the same items // in the compacted module. let module_map = ModuleMap::from(module_tracer); // Drop unused types from the type arena. // // `FastIndexSet`s don't have an underlying Vec that we can // steal, compact in place, and then rebuild the `FastIndexSet` // from. So we have to rebuild the type arena from scratch. log::trace!("compacting types"); let mut new_types = arena::UniqueArena::new(); for (old_handle, mut ty, span) in module.types.drain_all() { if let Some(expected_new_handle) = module_map.types.try_adjust(old_handle) { module_map.adjust_type(&mut ty); let actual_new_handle = new_types.insert(ty, span); assert_eq!(actual_new_handle, expected_new_handle); } } module.types = new_types; log::trace!("adjusting special types"); module_map.adjust_special_types(&mut module.special_types); // Drop unused constant expressions, reusing existing storage. log::trace!("adjusting constant expressions"); module.const_expressions.retain_mut(|handle, expr| { if module_map.const_expressions.used(handle) { module_map.adjust_expression(expr, &module_map.const_expressions); true } else { false } }); // Drop unused constants in place, reusing existing storage. log::trace!("adjusting constants"); module.constants.retain_mut(|handle, constant| { if module_map.constants.used(handle) { module_map.types.adjust(&mut constant.ty); module_map.const_expressions.adjust(&mut constant.init); true } else { false } }); // Adjust global variables' types and initializers. log::trace!("adjusting global variables"); for (_, global) in module.global_variables.iter_mut() { log::trace!("adjusting global {:?}", global.name); module_map.types.adjust(&mut global.ty); if let Some(ref mut init) = global.init { module_map.const_expressions.adjust(init); } } // Temporary storage to help us reuse allocations of existing // named expression tables. let mut reused_named_expressions = crate::NamedExpressions::default(); // Compact each function. for ((_, function), map) in module.functions.iter_mut().zip(function_maps.iter()) { log::trace!("compacting function {:?}", function.name); map.compact(function, &module_map, &mut reused_named_expressions); } // Compact each entry point. for (entry, map) in module.entry_points.iter_mut().zip(entry_point_maps.iter()) { log::trace!("compacting entry point {:?}", entry.function.name); map.compact( &mut entry.function, &module_map, &mut reused_named_expressions, ); } } struct ModuleTracer<'module> { module: &'module crate::Module, types_used: HandleSet, constants_used: HandleSet, const_expressions_used: HandleSet, } impl<'module> ModuleTracer<'module> { fn new(module: &'module crate::Module) -> Self { Self { module, types_used: HandleSet::for_arena(&module.types), constants_used: HandleSet::for_arena(&module.constants), const_expressions_used: HandleSet::for_arena(&module.const_expressions), } } fn trace_special_types(&mut self, special_types: &crate::SpecialTypes) { let crate::SpecialTypes { ref ray_desc, ref ray_intersection, ref predeclared_types, } = *special_types; if let Some(ray_desc) = *ray_desc { self.types_used.insert(ray_desc); } if let Some(ray_intersection) = *ray_intersection { self.types_used.insert(ray_intersection); } for (_, &handle) in predeclared_types { self.types_used.insert(handle); } } fn as_type(&mut self) -> types::TypeTracer { types::TypeTracer { types: &self.module.types, types_used: &mut self.types_used, } } fn as_const_expression(&mut self) -> expressions::ExpressionTracer { expressions::ExpressionTracer { expressions: &self.module.const_expressions, constants: &self.module.constants, types_used: &mut self.types_used, constants_used: &mut self.constants_used, expressions_used: &mut self.const_expressions_used, const_expressions_used: None, } } pub fn as_function<'tracer>( &'tracer mut self, function: &'tracer crate::Function, ) -> FunctionTracer<'tracer> { FunctionTracer { function, constants: &self.module.constants, types_used: &mut self.types_used, constants_used: &mut self.constants_used, const_expressions_used: &mut self.const_expressions_used, expressions_used: HandleSet::for_arena(&function.expressions), } } } struct ModuleMap { types: HandleMap, constants: HandleMap, const_expressions: HandleMap, } impl From> for ModuleMap { fn from(used: ModuleTracer) -> Self { ModuleMap { types: HandleMap::from_set(used.types_used), constants: HandleMap::from_set(used.constants_used), const_expressions: HandleMap::from_set(used.const_expressions_used), } } } impl ModuleMap { fn adjust_special_types(&self, special: &mut crate::SpecialTypes) { let crate::SpecialTypes { ref mut ray_desc, ref mut ray_intersection, ref mut predeclared_types, } = *special; if let Some(ref mut ray_desc) = *ray_desc { self.types.adjust(ray_desc); } if let Some(ref mut ray_intersection) = *ray_intersection { self.types.adjust(ray_intersection); } for handle in predeclared_types.values_mut() { self.types.adjust(handle); } } } struct FunctionMap { expressions: HandleMap, } impl From> for FunctionMap { fn from(used: FunctionTracer) -> Self { FunctionMap { expressions: HandleMap::from_set(used.expressions_used), } } }