compiler/rustc_passes/src/dead.rs

   1 // This implements the dead-code warning pass. It follows middle::reachable
   2 // closely. The idea is that all reachable symbols are live, codes called
   3 // from live codes are live, and everything else is dead.
   4
   5 use itertools::Itertools;
   6 use rustc_data_structures::fx::{FxHashMap, FxHashSet};
   7 use rustc_errors::MultiSpan;
   8 use rustc_hir as hir;
   9 use rustc_hir::def::{CtorOf, DefKind, Res};
  10 use rustc_hir::def_id::{DefId, LocalDefId};
  11 use rustc_hir::intravisit::{self, Visitor};
  12 use rustc_hir::{Node, PatKind, TyKind};
  13 use rustc_middle::middle::codegen_fn_attrs::CodegenFnAttrFlags;
  14 use rustc_middle::middle::privacy::Level;
  15 use rustc_middle::ty::query::Providers;
  16 use rustc_middle::ty::{self, DefIdTree, TyCtxt};
  17 use rustc_session::lint;
  18 use rustc_span::symbol::{sym, Symbol};
  19 use std::mem;
  20
  21 use crate::errors::{
  22     ChangeFieldsToBeOfUnitType, IgnoredDerivedImpls, MultipleDeadCodes, ParentInfo,
  23     UselessAssignment,
  24 };
  25
  26 // Any local node that may call something in its body block should be
  27 // explored. For example, if it's a live Node::Item that is a
  28 // function, then we should explore its block to check for codes that
  29 // may need to be marked as live.
  30 fn should_explore(tcx: TyCtxt<'_>, def_id: LocalDefId) -> bool {
  31     matches!(
  32         tcx.hir().find_by_def_id(def_id),
  33         Some(
  34             Node::Item(..)
  35                 | Node::ImplItem(..)
  36                 | Node::ForeignItem(..)
  37                 | Node::TraitItem(..)
  38                 | Node::Variant(..)
  39                 | Node::AnonConst(..)
  40         )
  41     )
  42 }
  43
  44 struct MarkSymbolVisitor<'tcx> {
  45     worklist: Vec<LocalDefId>,
  46     tcx: TyCtxt<'tcx>,
  47     maybe_typeck_results: Option<&'tcx ty::TypeckResults<'tcx>>,
  48     live_symbols: FxHashSet<LocalDefId>,
  49     repr_has_repr_c: bool,
  50     repr_has_repr_simd: bool,
  51     in_pat: bool,
  52     ignore_variant_stack: Vec<DefId>,
  53     // maps from tuple struct constructors to tuple struct items
  54     struct_constructors: FxHashMap<LocalDefId, LocalDefId>,
  55     // maps from ADTs to ignored derived traits (e.g. Debug and Clone)
  56     // and the span of their respective impl (i.e., part of the derive
  57     // macro)
  58     ignored_derived_traits: FxHashMap<LocalDefId, Vec<(DefId, DefId)>>,
  59 }
  60
  61 impl<'tcx> MarkSymbolVisitor<'tcx> {
  62     /// Gets the type-checking results for the current body.
  63     /// As this will ICE if called outside bodies, only call when working with
  64     /// `Expr` or `Pat` nodes (they are guaranteed to be found only in bodies).
  65     #[track_caller]
  66     fn typeck_results(&self) -> &'tcx ty::TypeckResults<'tcx> {
  67         self.maybe_typeck_results
  68             .expect("`MarkSymbolVisitor::typeck_results` called outside of body")
  69     }
  70
  71     fn check_def_id(&mut self, def_id: DefId) {
  72         if let Some(def_id) = def_id.as_local() {
  73             if should_explore(self.tcx, def_id) || self.struct_constructors.contains_key(&def_id) {
  74                 self.worklist.push(def_id);
  75             }
  76             self.live_symbols.insert(def_id);
  77         }
  78     }
  79
  80     fn insert_def_id(&mut self, def_id: DefId) {
  81         if let Some(def_id) = def_id.as_local() {
  82             debug_assert!(!should_explore(self.tcx, def_id));
  83             self.live_symbols.insert(def_id);
  84         }
  85     }
  86
  87     fn handle_res(&mut self, res: Res) {
  88         match res {
  89             Res::Def(DefKind::Const | DefKind::AssocConst | DefKind::TyAlias, def_id) => {
  90                 self.check_def_id(def_id);
  91             }
  92             _ if self.in_pat => {}
  93             Res::PrimTy(..) | Res::SelfCtor(..) | Res::Local(..) => {}
  94             Res::Def(DefKind::Ctor(CtorOf::Variant, ..), ctor_def_id) => {
  95                 let variant_id = self.tcx.parent(ctor_def_id);
  96                 let enum_id = self.tcx.parent(variant_id);
  97                 self.check_def_id(enum_id);
  98                 if !self.ignore_variant_stack.contains(&ctor_def_id) {
  99                     self.check_def_id(variant_id);
 100                 }
 101             }
 102             Res::Def(DefKind::Variant, variant_id) => {
 103                 let enum_id = self.tcx.parent(variant_id);
 104                 self.check_def_id(enum_id);
 105                 if !self.ignore_variant_stack.contains(&variant_id) {
 106                     self.check_def_id(variant_id);
 107                 }
 108             }
 109             Res::Def(_, def_id) => self.check_def_id(def_id),
 110             Res::SelfTyParam { trait_: t } => self.check_def_id(t),
 111             Res::SelfTyAlias { alias_to: i, .. } => self.check_def_id(i),
 112             Res::ToolMod | Res::NonMacroAttr(..) | Res::Err => {}
 113         }
 114     }
 115
 116     fn lookup_and_handle_method(&mut self, id: hir::HirId) {
 117         if let Some(def_id) = self.typeck_results().type_dependent_def_id(id) {
 118             self.check_def_id(def_id);
 119         } else {
 120             bug!("no type-dependent def for method");
 121         }
 122     }
 123
 124     fn handle_field_access(&mut self, lhs: &hir::Expr<'_>, hir_id: hir::HirId) {
 125         match self.typeck_results().expr_ty_adjusted(lhs).kind() {
 126             ty::Adt(def, _) => {
 127                 let index = self.tcx.field_index(hir_id, self.typeck_results());
 128                 self.insert_def_id(def.non_enum_variant().fields[index].did);
 129             }
 130             ty::Tuple(..) => {}
 131             _ => span_bug!(lhs.span, "named field access on non-ADT"),
 132         }
 133     }
 134
 135     #[allow(dead_code)] // FIXME(81658): should be used + lint reinstated after #83171 relands.
 136     fn handle_assign(&mut self, expr: &'tcx hir::Expr<'tcx>) {
 137         if self
 138             .typeck_results()
 139             .expr_adjustments(expr)
 140             .iter()
 141             .any(|adj| matches!(adj.kind, ty::adjustment::Adjust::Deref(_)))
 142         {
 143             self.visit_expr(expr);
 144         } else if let hir::ExprKind::Field(base, ..) = expr.kind {
 145             // Ignore write to field
 146             self.handle_assign(base);
 147         } else {
 148             self.visit_expr(expr);
 149         }
 150     }
 151
 152     #[allow(dead_code)] // FIXME(81658): should be used + lint reinstated after #83171 relands.
 153     fn check_for_self_assign(&mut self, assign: &'tcx hir::Expr<'tcx>) {
 154         fn check_for_self_assign_helper<'tcx>(
 155             typeck_results: &'tcx ty::TypeckResults<'tcx>,
 156             lhs: &'tcx hir::Expr<'tcx>,
 157             rhs: &'tcx hir::Expr<'tcx>,
 158         ) -> bool {
 159             match (&lhs.kind, &rhs.kind) {
 160                 (hir::ExprKind::Path(ref qpath_l), hir::ExprKind::Path(ref qpath_r)) => {
 161                     if let (Res::Local(id_l), Res::Local(id_r)) = (
 162                         typeck_results.qpath_res(qpath_l, lhs.hir_id),
 163                         typeck_results.qpath_res(qpath_r, rhs.hir_id),
 164                     ) {
 165                         if id_l == id_r {
 166                             return true;
 167                         }
 168                     }
 169                     return false;
 170                 }
 171                 (hir::ExprKind::Field(lhs_l, ident_l), hir::ExprKind::Field(lhs_r, ident_r)) => {
 172                     if ident_l == ident_r {
 173                         return check_for_self_assign_helper(typeck_results, lhs_l, lhs_r);
 174                     }
 175                     return false;
 176                 }
 177                 _ => {
 178                     return false;
 179                 }
 180             }
 181         }
 182
 183         if let hir::ExprKind::Assign(lhs, rhs, _) = assign.kind
 184             && check_for_self_assign_helper(self.typeck_results(), lhs, rhs)
 185                 && !assign.span.from_expansion()
 186         {
 187                 let is_field_assign = matches!(lhs.kind, hir::ExprKind::Field(..));
 188                 self.tcx.emit_spanned_lint(
 189                     lint::builtin::DEAD_CODE,
 190                     assign.hir_id,
 191                     assign.span,
 192                     UselessAssignment { is_field_assign, ty: self.typeck_results().expr_ty(lhs) }
 193                 )
 194         }
 195     }
 196
 197     fn handle_field_pattern_match(
 198         &mut self,
 199         lhs: &hir::Pat<'_>,
 200         res: Res,
 201         pats: &[hir::PatField<'_>],
 202     ) {
 203         let variant = match self.typeck_results().node_type(lhs.hir_id).kind() {
 204             ty::Adt(adt, _) => adt.variant_of_res(res),
 205             _ => span_bug!(lhs.span, "non-ADT in struct pattern"),
 206         };
 207         for pat in pats {
 208             if let PatKind::Wild = pat.pat.kind {
 209                 continue;
 210             }
 211             let index = self.tcx.field_index(pat.hir_id, self.typeck_results());
 212             self.insert_def_id(variant.fields[index].did);
 213         }
 214     }
 215
 216     fn handle_tuple_field_pattern_match(
 217         &mut self,
 218         lhs: &hir::Pat<'_>,
 219         res: Res,
 220         pats: &[hir::Pat<'_>],
 221         dotdot: hir::DotDotPos,
 222     ) {
 223         let variant = match self.typeck_results().node_type(lhs.hir_id).kind() {
 224             ty::Adt(adt, _) => adt.variant_of_res(res),
 225             _ => span_bug!(lhs.span, "non-ADT in tuple struct pattern"),
 226         };
 227         let dotdot = dotdot.as_opt_usize().unwrap_or(pats.len());
 228         let first_n = pats.iter().enumerate().take(dotdot);
 229         let missing = variant.fields.len() - pats.len();
 230         let last_n = pats.iter().enumerate().skip(dotdot).map(|(idx, pat)| (idx + missing, pat));
 231         for (idx, pat) in first_n.chain(last_n) {
 232             if let PatKind::Wild = pat.kind {
 233                 continue;
 234             }
 235             self.insert_def_id(variant.fields[idx].did);
 236         }
 237     }
 238
 239     fn mark_live_symbols(&mut self) {
 240         let mut scanned = FxHashSet::default();
 241         while let Some(id) = self.worklist.pop() {
 242             if !scanned.insert(id) {
 243                 continue;
 244             }
 245
 246             // in the case of tuple struct constructors we want to check the item, not the generated
 247             // tuple struct constructor function
 248             let id = self.struct_constructors.get(&id).copied().unwrap_or(id);
 249
 250             if let Some(node) = self.tcx.hir().find_by_def_id(id) {
 251                 self.live_symbols.insert(id);
 252                 self.visit_node(node);
 253             }
 254         }
 255     }
 256
 257     /// Automatically generated items marked with `rustc_trivial_field_reads`
 258     /// will be ignored for the purposes of dead code analysis (see PR #85200
 259     /// for discussion).
 260     fn should_ignore_item(&mut self, def_id: DefId) -> bool {
 261         if let Some(impl_of) = self.tcx.impl_of_method(def_id) {
 262             if !self.tcx.has_attr(impl_of, sym::automatically_derived) {
 263                 return false;
 264             }
 265
 266             if let Some(trait_of) = self.tcx.trait_id_of_impl(impl_of)
 267                 && self.tcx.has_attr(trait_of, sym::rustc_trivial_field_reads)
 268             {
 269                 let trait_ref = self.tcx.impl_trait_ref(impl_of).unwrap();
 270                 if let ty::Adt(adt_def, _) = trait_ref.self_ty().kind()
 271                     && let Some(adt_def_id) = adt_def.did().as_local()
 272                 {
 273                     self.ignored_derived_traits
 274                         .entry(adt_def_id)
 275                         .or_default()
 276                         .push((trait_of, impl_of));
 277                 }
 278                 return true;
 279             }
 280         }
 281
 282         return false;
 283     }
 284
 285     fn visit_node(&mut self, node: Node<'tcx>) {
 286         if let Node::ImplItem(hir::ImplItem { owner_id, .. }) = node
 287             && self.should_ignore_item(owner_id.to_def_id())
 288         {
 289             return;
 290         }
 291
 292         let had_repr_c = self.repr_has_repr_c;
 293         let had_repr_simd = self.repr_has_repr_simd;
 294         self.repr_has_repr_c = false;
 295         self.repr_has_repr_simd = false;
 296         match node {
 297             Node::Item(item) => match item.kind {
 298                 hir::ItemKind::Struct(..) | hir::ItemKind::Union(..) => {
 299                     let def = self.tcx.adt_def(item.owner_id);
 300                     self.repr_has_repr_c = def.repr().c();
 301                     self.repr_has_repr_simd = def.repr().simd();
 302
 303                     intravisit::walk_item(self, &item)
 304                 }
 305                 hir::ItemKind::ForeignMod { .. } => {}
 306                 _ => intravisit::walk_item(self, &item),
 307             },
 308             Node::TraitItem(trait_item) => {
 309                 intravisit::walk_trait_item(self, trait_item);
 310             }
 311             Node::ImplItem(impl_item) => {
 312                 let item = self.tcx.local_parent(impl_item.owner_id.def_id);
 313                 if self.tcx.impl_trait_ref(item).is_none() {
 314                     //// If it's a type whose items are live, then it's live, too.
 315                     //// This is done to handle the case where, for example, the static
 316                     //// method of a private type is used, but the type itself is never
 317                     //// called directly.
 318                     let self_ty = self.tcx.type_of(item);
 319                     match *self_ty.kind() {
 320                         ty::Adt(def, _) => self.check_def_id(def.did()),
 321                         ty::Foreign(did) => self.check_def_id(did),
 322                         ty::Dynamic(data, ..) => {
 323                             if let Some(def_id) = data.principal_def_id() {
 324                                 self.check_def_id(def_id)
 325                             }
 326                         }
 327                         _ => {}
 328                     }
 329                 }
 330                 intravisit::walk_impl_item(self, impl_item);
 331             }
 332             Node::ForeignItem(foreign_item) => {
 333                 intravisit::walk_foreign_item(self, &foreign_item);
 334             }
 335             _ => {}
 336         }
 337         self.repr_has_repr_simd = had_repr_simd;
 338         self.repr_has_repr_c = had_repr_c;
 339     }
 340
 341     fn mark_as_used_if_union(&mut self, adt: ty::AdtDef<'tcx>, fields: &[hir::ExprField<'_>]) {
 342         if adt.is_union() && adt.non_enum_variant().fields.len() > 1 && adt.did().is_local() {
 343             for field in fields {
 344                 let index = self.tcx.field_index(field.hir_id, self.typeck_results());
 345                 self.insert_def_id(adt.non_enum_variant().fields[index].did);
 346             }
 347         }
 348     }
 349 }
 350
 351 impl<'tcx> Visitor<'tcx> for MarkSymbolVisitor<'tcx> {
 352     fn visit_nested_body(&mut self, body: hir::BodyId) {
 353         let old_maybe_typeck_results =
 354             self.maybe_typeck_results.replace(self.tcx.typeck_body(body));
 355         let body = self.tcx.hir().body(body);
 356         self.visit_body(body);
 357         self.maybe_typeck_results = old_maybe_typeck_results;
 358     }
 359
 360     fn visit_variant_data(&mut self, def: &'tcx hir::VariantData<'tcx>) {
 361         let tcx = self.tcx;
 362         let has_repr_c = self.repr_has_repr_c;
 363         let has_repr_simd = self.repr_has_repr_simd;
 364         let live_fields = def.fields().iter().filter_map(|f| {
 365             let def_id = tcx.hir().local_def_id(f.hir_id);
 366             if has_repr_c || (f.is_positional() && has_repr_simd) {
 367                 return Some(def_id);
 368             }
 369             if !tcx.visibility(f.hir_id.owner.def_id).is_public() {
 370                 return None;
 371             }
 372             if tcx.visibility(def_id).is_public() { Some(def_id) } else { None }
 373         });
 374         self.live_symbols.extend(live_fields);
 375
 376         intravisit::walk_struct_def(self, def);
 377     }
 378
 379     fn visit_expr(&mut self, expr: &'tcx hir::Expr<'tcx>) {
 380         match expr.kind {
 381             hir::ExprKind::Path(ref qpath @ hir::QPath::TypeRelative(..)) => {
 382                 let res = self.typeck_results().qpath_res(qpath, expr.hir_id);
 383                 self.handle_res(res);
 384             }
 385             hir::ExprKind::MethodCall(..) => {
 386                 self.lookup_and_handle_method(expr.hir_id);
 387             }
 388             hir::ExprKind::Field(ref lhs, ..) => {
 389                 self.handle_field_access(&lhs, expr.hir_id);
 390             }
 391             hir::ExprKind::Struct(ref qpath, ref fields, _) => {
 392                 let res = self.typeck_results().qpath_res(qpath, expr.hir_id);
 393                 self.handle_res(res);
 394                 if let ty::Adt(adt, _) = self.typeck_results().expr_ty(expr).kind() {
 395                     self.mark_as_used_if_union(*adt, fields);
 396                 }
 397             }
 398             _ => (),
 399         }
 400
 401         intravisit::walk_expr(self, expr);
 402     }
 403
 404     fn visit_arm(&mut self, arm: &'tcx hir::Arm<'tcx>) {
 405         // Inside the body, ignore constructions of variants
 406         // necessary for the pattern to match. Those construction sites
 407         // can't be reached unless the variant is constructed elsewhere.
 408         let len = self.ignore_variant_stack.len();
 409         self.ignore_variant_stack.extend(arm.pat.necessary_variants());
 410         intravisit::walk_arm(self, arm);
 411         self.ignore_variant_stack.truncate(len);
 412     }
 413
 414     fn visit_pat(&mut self, pat: &'tcx hir::Pat<'tcx>) {
 415         self.in_pat = true;
 416         match pat.kind {
 417             PatKind::Struct(ref path, ref fields, _) => {
 418                 let res = self.typeck_results().qpath_res(path, pat.hir_id);
 419                 self.handle_field_pattern_match(pat, res, fields);
 420             }
 421             PatKind::Path(ref qpath) => {
 422                 let res = self.typeck_results().qpath_res(qpath, pat.hir_id);
 423                 self.handle_res(res);
 424             }
 425             PatKind::TupleStruct(ref qpath, ref fields, dotdot) => {
 426                 let res = self.typeck_results().qpath_res(qpath, pat.hir_id);
 427                 self.handle_tuple_field_pattern_match(pat, res, fields, dotdot);
 428             }
 429             _ => (),
 430         }
 431
 432         intravisit::walk_pat(self, pat);
 433         self.in_pat = false;
 434     }
 435
 436     fn visit_path(&mut self, path: &'tcx hir::Path<'tcx>, _: hir::HirId) {
 437         self.handle_res(path.res);
 438         intravisit::walk_path(self, path);
 439     }
 440
 441     fn visit_ty(&mut self, ty: &'tcx hir::Ty<'tcx>) {
 442         if let TyKind::OpaqueDef(item_id, _, _) = ty.kind {
 443             let item = self.tcx.hir().item(item_id);
 444             intravisit::walk_item(self, item);
 445         }
 446         intravisit::walk_ty(self, ty);
 447     }
 448
 449     fn visit_anon_const(&mut self, c: &'tcx hir::AnonConst) {
 450         // When inline const blocks are used in pattern position, paths
 451         // referenced by it should be considered as used.
 452         let in_pat = mem::replace(&mut self.in_pat, false);
 453
 454         self.live_symbols.insert(self.tcx.hir().local_def_id(c.hir_id));
 455         intravisit::walk_anon_const(self, c);
 456
 457         self.in_pat = in_pat;
 458     }
 459 }
 460
 461 fn has_allow_dead_code_or_lang_attr_helper(
 462     tcx: TyCtxt<'_>,
 463     id: hir::HirId,
 464     lint: &'static lint::Lint,
 465 ) -> bool {
 466     let attrs = tcx.hir().attrs(id);
 467     if tcx.sess.contains_name(attrs, sym::lang) {
 468         return true;
 469     }
 470
 471     // Stable attribute for #[lang = "panic_impl"]
 472     if tcx.sess.contains_name(attrs, sym::panic_handler) {
 473         return true;
 474     }
 475
 476     let def_id = tcx.hir().local_def_id(id);
 477     if tcx.def_kind(def_id).has_codegen_attrs() {
 478         let cg_attrs = tcx.codegen_fn_attrs(def_id);
 479
 480         // #[used], #[no_mangle], #[export_name], etc also keeps the item alive
 481         // forcefully, e.g., for placing it in a specific section.
 482         if cg_attrs.contains_extern_indicator()
 483             || cg_attrs.flags.contains(CodegenFnAttrFlags::USED)
 484             || cg_attrs.flags.contains(CodegenFnAttrFlags::USED_LINKER)
 485         {
 486             return true;
 487         }
 488     }
 489
 490     tcx.lint_level_at_node(lint, id).0 == lint::Allow
 491 }
 492
 493 fn has_allow_dead_code_or_lang_attr(tcx: TyCtxt<'_>, id: hir::HirId) -> bool {
 494     has_allow_dead_code_or_lang_attr_helper(tcx, id, lint::builtin::DEAD_CODE)
 495 }
 496
 497 // These check_* functions seeds items that
 498 //   1) We want to explicitly consider as live:
 499 //     * Item annotated with #[allow(dead_code)]
 500 //         - This is done so that if we want to suppress warnings for a
 501 //           group of dead functions, we only have to annotate the "root".
 502 //           For example, if both `f` and `g` are dead and `f` calls `g`,
 503 //           then annotating `f` with `#[allow(dead_code)]` will suppress
 504 //           warning for both `f` and `g`.
 505 //     * Item annotated with #[lang=".."]
 506 //         - This is because lang items are always callable from elsewhere.
 507 //   or
 508 //   2) We are not sure to be live or not
 509 //     * Implementations of traits and trait methods
 510 fn check_item<'tcx>(
 511     tcx: TyCtxt<'tcx>,
 512     worklist: &mut Vec<LocalDefId>,
 513     struct_constructors: &mut FxHashMap<LocalDefId, LocalDefId>,
 514     id: hir::ItemId,
 515 ) {
 516     let allow_dead_code = has_allow_dead_code_or_lang_attr(tcx, id.hir_id());
 517     if allow_dead_code {
 518         worklist.push(id.owner_id.def_id);
 519     }
 520
 521     match tcx.def_kind(id.owner_id) {
 522         DefKind::Enum => {
 523             let item = tcx.hir().item(id);
 524             if let hir::ItemKind::Enum(ref enum_def, _) = item.kind {
 525                 let hir = tcx.hir();
 526                 if allow_dead_code {
 527                     worklist.extend(
 528                         enum_def.variants.iter().map(|variant| hir.local_def_id(variant.id)),
 529                     );
 530                 }
 531
 532                 for variant in enum_def.variants {
 533                     if let Some(ctor_hir_id) = variant.data.ctor_hir_id() {
 534                         struct_constructors
 535                             .insert(hir.local_def_id(ctor_hir_id), hir.local_def_id(variant.id));
 536                     }
 537                 }
 538             }
 539         }
 540         DefKind::Impl => {
 541             let of_trait = tcx.impl_trait_ref(id.owner_id);
 542
 543             if of_trait.is_some() {
 544                 worklist.push(id.owner_id.def_id);
 545             }
 546
 547             // get DefIds from another query
 548             let local_def_ids = tcx
 549                 .associated_item_def_ids(id.owner_id)
 550                 .iter()
 551                 .filter_map(|def_id| def_id.as_local());
 552
 553             // And we access the Map here to get HirId from LocalDefId
 554             for id in local_def_ids {
 555                 if of_trait.is_some()
 556                     || has_allow_dead_code_or_lang_attr(tcx, tcx.hir().local_def_id_to_hir_id(id))
 557                 {
 558                     worklist.push(id);
 559                 }
 560             }
 561         }
 562         DefKind::Struct => {
 563             let item = tcx.hir().item(id);
 564             if let hir::ItemKind::Struct(ref variant_data, _) = item.kind
 565                 && let Some(ctor_hir_id) = variant_data.ctor_hir_id()
 566             {
 567                 struct_constructors.insert(tcx.hir().local_def_id(ctor_hir_id), item.owner_id.def_id);
 568             }
 569         }
 570         DefKind::GlobalAsm => {
 571             // global_asm! is always live.
 572             worklist.push(id.owner_id.def_id);
 573         }
 574         _ => {}
 575     }
 576 }
 577
 578 fn check_trait_item<'tcx>(tcx: TyCtxt<'tcx>, worklist: &mut Vec<LocalDefId>, id: hir::TraitItemId) {
 579     use hir::TraitItemKind::{Const, Fn};
 580     if matches!(tcx.def_kind(id.owner_id), DefKind::AssocConst | DefKind::AssocFn) {
 581         let trait_item = tcx.hir().trait_item(id);
 582         if matches!(trait_item.kind, Const(_, Some(_)) | Fn(_, hir::TraitFn::Provided(_)))
 583             && has_allow_dead_code_or_lang_attr(tcx, trait_item.hir_id())
 584         {
 585             worklist.push(trait_item.owner_id.def_id);
 586         }
 587     }
 588 }
 589
 590 fn check_foreign_item<'tcx>(
 591     tcx: TyCtxt<'tcx>,
 592     worklist: &mut Vec<LocalDefId>,
 593     id: hir::ForeignItemId,
 594 ) {
 595     if matches!(tcx.def_kind(id.owner_id), DefKind::Static(_) | DefKind::Fn)
 596         && has_allow_dead_code_or_lang_attr(tcx, id.hir_id())
 597     {
 598         worklist.push(id.owner_id.def_id);
 599     }
 600 }
 601
 602 fn create_and_seed_worklist<'tcx>(
 603     tcx: TyCtxt<'tcx>,
 604 ) -> (Vec<LocalDefId>, FxHashMap<LocalDefId, LocalDefId>) {
 605     let effective_visibilities = &tcx.effective_visibilities(());
 606     // see `MarkSymbolVisitor::struct_constructors`
 607     let mut struct_constructors = Default::default();
 608     let mut worklist = effective_visibilities
 609         .iter()
 610         .filter_map(|(&id, effective_vis)| {
 611             effective_vis.is_public_at_level(Level::Reachable).then_some(id)
 612         })
 613         // Seed entry point
 614         .chain(tcx.entry_fn(()).and_then(|(def_id, _)| def_id.as_local()))
 615         .collect::<Vec<_>>();
 616
 617     let crate_items = tcx.hir_crate_items(());
 618     for id in crate_items.items() {
 619         check_item(tcx, &mut worklist, &mut struct_constructors, id);
 620     }
 621
 622     for id in crate_items.trait_items() {
 623         check_trait_item(tcx, &mut worklist, id);
 624     }
 625
 626     for id in crate_items.foreign_items() {
 627         check_foreign_item(tcx, &mut worklist, id);
 628     }
 629
 630     (worklist, struct_constructors)
 631 }
 632
 633 fn live_symbols_and_ignored_derived_traits<'tcx>(
 634     tcx: TyCtxt<'tcx>,
 635     (): (),
 636 ) -> (FxHashSet<LocalDefId>, FxHashMap<LocalDefId, Vec<(DefId, DefId)>>) {
 637     let (worklist, struct_constructors) = create_and_seed_worklist(tcx);
 638     let mut symbol_visitor = MarkSymbolVisitor {
 639         worklist,
 640         tcx,
 641         maybe_typeck_results: None,
 642         live_symbols: Default::default(),
 643         repr_has_repr_c: false,
 644         repr_has_repr_simd: false,
 645         in_pat: false,
 646         ignore_variant_stack: vec![],
 647         struct_constructors,
 648         ignored_derived_traits: FxHashMap::default(),
 649     };
 650     symbol_visitor.mark_live_symbols();
 651     (symbol_visitor.live_symbols, symbol_visitor.ignored_derived_traits)
 652 }
 653
 654 struct DeadVariant {
 655     def_id: LocalDefId,
 656     name: Symbol,
 657     level: lint::Level,
 658 }
 659
 660 struct DeadVisitor<'tcx> {
 661     tcx: TyCtxt<'tcx>,
 662     live_symbols: &'tcx FxHashSet<LocalDefId>,
 663     ignored_derived_traits: &'tcx FxHashMap<LocalDefId, Vec<(DefId, DefId)>>,
 664 }
 665
 666 enum ShouldWarnAboutField {
 667     Yes(bool), // positional?
 668     No,
 669 }
 670
 671 impl<'tcx> DeadVisitor<'tcx> {
 672     fn should_warn_about_field(&mut self, field: &ty::FieldDef) -> ShouldWarnAboutField {
 673         if self.live_symbols.contains(&field.did.expect_local()) {
 674             return ShouldWarnAboutField::No;
 675         }
 676         let field_type = self.tcx.type_of(field.did);
 677         if field_type.is_phantom_data() {
 678             return ShouldWarnAboutField::No;
 679         }
 680         let is_positional = field.name.as_str().starts_with(|c: char| c.is_ascii_digit());
 681         if is_positional
 682             && self
 683                 .tcx
 684                 .layout_of(self.tcx.param_env(field.did).and(field_type))
 685                 .map_or(true, |layout| layout.is_zst())
 686         {
 687             return ShouldWarnAboutField::No;
 688         }
 689         ShouldWarnAboutField::Yes(is_positional)
 690     }
 691
 692     fn warn_multiple_dead_codes(
 693         &self,
 694         dead_codes: &[LocalDefId],
 695         participle: &str,
 696         parent_item: Option<LocalDefId>,
 697         is_positional: bool,
 698     ) {
 699         let Some(&first_id) = dead_codes.first() else {
 700             return;
 701         };
 702         let tcx = self.tcx;
 703         let names: Vec<_> =
 704             dead_codes.iter().map(|&def_id| tcx.item_name(def_id.to_def_id())).collect();
 705         let spans: Vec<_> = dead_codes
 706             .iter()
 707             .map(|&def_id| match tcx.def_ident_span(def_id) {
 708                 Some(s) => s.with_ctxt(tcx.def_span(def_id).ctxt()),
 709                 None => tcx.def_span(def_id),
 710             })
 711             .collect();
 712
 713         let descr = tcx.def_kind(first_id).descr(first_id.to_def_id());
 714         let num = dead_codes.len();
 715         let multiple = num > 6;
 716         let name_list = names.into();
 717
 718         let lint = if is_positional {
 719             lint::builtin::UNUSED_TUPLE_STRUCT_FIELDS
 720         } else {
 721             lint::builtin::DEAD_CODE
 722         };
 723
 724         let parent_info = if let Some(parent_item) = parent_item {
 725             let parent_descr = tcx.def_kind(parent_item).descr(parent_item.to_def_id());
 726             Some(ParentInfo {
 727                 num,
 728                 descr,
 729                 parent_descr,
 730                 span: tcx.def_ident_span(parent_item).unwrap(),
 731             })
 732         } else {
 733             None
 734         };
 735
 736         let encl_def_id = parent_item.unwrap_or(first_id);
 737         let ignored_derived_impls =
 738             if let Some(ign_traits) = self.ignored_derived_traits.get(&encl_def_id) {
 739                 let trait_list = ign_traits
 740                     .iter()
 741                     .map(|(trait_id, _)| self.tcx.item_name(*trait_id))
 742                     .collect::<Vec<_>>();
 743                 let trait_list_len = trait_list.len();
 744                 Some(IgnoredDerivedImpls {
 745                     name: self.tcx.item_name(encl_def_id.to_def_id()),
 746                     trait_list: trait_list.into(),
 747                     trait_list_len,
 748                 })
 749             } else {
 750                 None
 751             };
 752
 753         let diag = if is_positional {
 754             MultipleDeadCodes::UnusedTupleStructFields {
 755                 multiple,
 756                 num,
 757                 descr,
 758                 participle,
 759                 name_list,
 760                 change_fields_suggestion: ChangeFieldsToBeOfUnitType { num, spans: spans.clone() },
 761                 parent_info,
 762                 ignored_derived_impls,
 763             }
 764         } else {
 765             MultipleDeadCodes::DeadCodes {
 766                 multiple,
 767                 num,
 768                 descr,
 769                 participle,
 770                 name_list,
 771                 parent_info,
 772                 ignored_derived_impls,
 773             }
 774         };
 775
 776         self.tcx.emit_spanned_lint(
 777             lint,
 778             tcx.hir().local_def_id_to_hir_id(first_id),
 779             MultiSpan::from_spans(spans.clone()),
 780             diag,
 781         );
 782     }
 783
 784     fn warn_dead_fields_and_variants(
 785         &self,
 786         def_id: LocalDefId,
 787         participle: &str,
 788         dead_codes: Vec<DeadVariant>,
 789         is_positional: bool,
 790     ) {
 791         let mut dead_codes = dead_codes
 792             .iter()
 793             .filter(|v| !v.name.as_str().starts_with('_'))
 794             .map(|v| v)
 795             .collect::<Vec<&DeadVariant>>();
 796         if dead_codes.is_empty() {
 797             return;
 798         }
 799         dead_codes.sort_by_key(|v| v.level);
 800         for (_, group) in &dead_codes.into_iter().group_by(|v| v.level) {
 801             self.warn_multiple_dead_codes(
 802                 &group.map(|v| v.def_id).collect::<Vec<_>>(),
 803                 participle,
 804                 Some(def_id),
 805                 is_positional,
 806             );
 807         }
 808     }
 809
 810     fn warn_dead_code(&mut self, id: LocalDefId, participle: &str) {
 811         self.warn_multiple_dead_codes(&[id], participle, None, false);
 812     }
 813
 814     fn check_definition(&mut self, def_id: LocalDefId) {
 815         if self.live_symbols.contains(&def_id) {
 816             return;
 817         }
 818         let hir_id = self.tcx.hir().local_def_id_to_hir_id(def_id);
 819         if has_allow_dead_code_or_lang_attr(self.tcx, hir_id) {
 820             return;
 821         }
 822         let Some(name) = self.tcx.opt_item_name(def_id.to_def_id()) else {
 823             return
 824         };
 825         if name.as_str().starts_with('_') {
 826             return;
 827         }
 828         match self.tcx.def_kind(def_id) {
 829             DefKind::AssocConst
 830             | DefKind::AssocFn
 831             | DefKind::Fn
 832             | DefKind::Static(_)
 833             | DefKind::Const
 834             | DefKind::TyAlias
 835             | DefKind::Enum
 836             | DefKind::Union
 837             | DefKind::ForeignTy => self.warn_dead_code(def_id, "used"),
 838             DefKind::Struct => self.warn_dead_code(def_id, "constructed"),
 839             DefKind::Variant | DefKind::Field => bug!("should be handled specially"),
 840             _ => {}
 841         }
 842     }
 843 }
 844
 845 fn check_mod_deathness(tcx: TyCtxt<'_>, module: LocalDefId) {
 846     let (live_symbols, ignored_derived_traits) = tcx.live_symbols_and_ignored_derived_traits(());
 847     let mut visitor = DeadVisitor { tcx, live_symbols, ignored_derived_traits };
 848
 849     let module_items = tcx.hir_module_items(module);
 850
 851     for item in module_items.items() {
 852         if !live_symbols.contains(&item.owner_id.def_id) {
 853             let parent = tcx.local_parent(item.owner_id.def_id);
 854             if parent != module && !live_symbols.contains(&parent) {
 855                 // We already have diagnosed something.
 856                 continue;
 857             }
 858             visitor.check_definition(item.owner_id.def_id);
 859             continue;
 860         }
 861
 862         let def_kind = tcx.def_kind(item.owner_id);
 863         if let DefKind::Struct | DefKind::Union | DefKind::Enum = def_kind {
 864             let adt = tcx.adt_def(item.owner_id);
 865             let mut dead_variants = Vec::new();
 866
 867             for variant in adt.variants() {
 868                 let def_id = variant.def_id.expect_local();
 869                 if !live_symbols.contains(&def_id) {
 870                     // Record to group diagnostics.
 871                     let hir_id = tcx.hir().local_def_id_to_hir_id(def_id);
 872                     let level = tcx.lint_level_at_node(lint::builtin::DEAD_CODE, hir_id).0;
 873                     dead_variants.push(DeadVariant { def_id, name: variant.name, level });
 874                     continue;
 875                 }
 876
 877                 let mut is_positional = false;
 878                 let dead_fields = variant
 879                     .fields
 880                     .iter()
 881                     .filter_map(|field| {
 882                         let def_id = field.did.expect_local();
 883                         let hir_id = tcx.hir().local_def_id_to_hir_id(def_id);
 884                         if let ShouldWarnAboutField::Yes(is_pos) =
 885                             visitor.should_warn_about_field(&field)
 886                         {
 887                             let level = tcx
 888                                 .lint_level_at_node(
 889                                     if is_pos {
 890                                         is_positional = true;
 891                                         lint::builtin::UNUSED_TUPLE_STRUCT_FIELDS
 892                                     } else {
 893                                         lint::builtin::DEAD_CODE
 894                                     },
 895                                     hir_id,
 896                                 )
 897                                 .0;
 898                             Some(DeadVariant { def_id, name: field.name, level })
 899                         } else {
 900                             None
 901                         }
 902                     })
 903                     .collect();
 904                 visitor.warn_dead_fields_and_variants(def_id, "read", dead_fields, is_positional)
 905             }
 906
 907             visitor.warn_dead_fields_and_variants(
 908                 item.owner_id.def_id,
 909                 "constructed",
 910                 dead_variants,
 911                 false,
 912             );
 913         }
 914     }
 915
 916     for impl_item in module_items.impl_items() {
 917         visitor.check_definition(impl_item.owner_id.def_id);
 918     }
 919
 920     for foreign_item in module_items.foreign_items() {
 921         visitor.check_definition(foreign_item.owner_id.def_id);
 922     }
 923
 924     // We do not warn trait items.
 925 }
 926
 927 pub(crate) fn provide(providers: &mut Providers) {
 928     *providers =
 929         Providers { live_symbols_and_ignored_derived_traits, check_mod_deathness, ..*providers };
 930 }