rustc_passes/

check_attr.rs

// FIXME(jdonszelmann): should become rustc_attr_validation
//! This module implements some validity checks for attributes.
//! In particular it verifies that `#[inline]` and `#[repr]` attributes are
//! attached to items that actually support them and if there are
//! conflicts between multiple such attributes attached to the same
//! item.

use std::cell::Cell;
use std::slice;

use rustc_abi::ExternAbi;
use rustc_ast::ast;
use rustc_attr_parsing::{AttributeParser, Late};
use rustc_data_structures::thin_vec::ThinVec;
use rustc_data_structures::unord::UnordMap;
use rustc_errors::{DiagCtxtHandle, IntoDiagArg, MultiSpan, msg};
use rustc_feature::BUILTIN_ATTRIBUTE_MAP;
use rustc_hir::attrs::diagnostic::Directive;
use rustc_hir::attrs::{
    AttributeKind, CrateType, DocAttribute, DocInline, EiiDecl, EiiImpl, EiiImplResolution,
    InlineAttr, LintAttribute, ReprAttr, SanitizerSet,
};
use rustc_hir::def::DefKind;
use rustc_hir::def_id::LocalModDefId;
use rustc_hir::intravisit::{self, Visitor};
use rustc_hir::{
    self as hir, Attribute, CRATE_HIR_ID, Constness, FnSig, ForeignItem, GenericParamKind, HirId,
    Item, ItemKind, MethodKind, Node, ParamName, Safety, Target, TraitItem, find_attr,
};
use rustc_macros::Diagnostic;
use rustc_middle::hir::nested_filter;
use rustc_middle::middle::resolve_bound_vars::ObjectLifetimeDefault;
use rustc_middle::query::Providers;
use rustc_middle::traits::ObligationCause;
use rustc_middle::ty::error::{ExpectedFound, TypeError};
use rustc_middle::ty::{self, TyCtxt, TypingMode};
use rustc_middle::{bug, span_bug};
use rustc_session::lint;
use rustc_session::lint::builtin::{
    CONFLICTING_REPR_HINTS, INVALID_DOC_ATTRIBUTES, MALFORMED_DIAGNOSTIC_FORMAT_LITERALS,
    MISPLACED_DIAGNOSTIC_ATTRIBUTES, UNUSED_ATTRIBUTES,
};
use rustc_session::parse::feature_err;
use rustc_span::edition::Edition;
use rustc_span::{DUMMY_SP, Ident, Span, Symbol, sym};
use rustc_trait_selection::error_reporting::InferCtxtErrorExt;
use rustc_trait_selection::infer::{TyCtxtInferExt, ValuePairs};
use rustc_trait_selection::traits::ObligationCtxt;

use crate::errors;

#[derive(Diagnostic)]
#[diag("`#[diagnostic::on_unimplemented]` can only be applied to trait definitions")]
struct DiagnosticOnUnimplementedOnlyForTraits;

#[derive(Diagnostic)]
#[diag("`#[diagnostic::on_const]` can only be applied to trait impls")]
struct DiagnosticOnConstOnlyForTraitImpls {
    #[label("not a trait impl")]
    item_span: Span,
}

#[derive(Diagnostic)]
#[diag("`#[diagnostic::on_const]` can only be applied to non-const trait impls")]
struct DiagnosticOnConstOnlyForNonConstTraitImpls {
    #[label("this is a const trait impl")]
    item_span: Span,
}

#[derive(Diagnostic)]
#[diag("`#[diagnostic::on_move]` can only be applied to enums, structs or unions")]
struct DiagnosticOnMoveOnlyForAdt;

fn target_from_impl_item<'tcx>(tcx: TyCtxt<'tcx>, impl_item: &hir::ImplItem<'_>) -> Target {
    match impl_item.kind {
        hir::ImplItemKind::Const(..) => Target::AssocConst,
        hir::ImplItemKind::Fn(..) => {
            let parent_def_id = tcx.hir_get_parent_item(impl_item.hir_id()).def_id;
            let containing_item = tcx.hir_expect_item(parent_def_id);
            let containing_impl_is_for_trait = match &containing_item.kind {
                hir::ItemKind::Impl(impl_) => impl_.of_trait.is_some(),
                _ => bug!("parent of an ImplItem must be an Impl"),
            };
            if containing_impl_is_for_trait {
                Target::Method(MethodKind::Trait { body: true })
            } else {
                Target::Method(MethodKind::Inherent)
            }
        }
        hir::ImplItemKind::Type(..) => Target::AssocTy,
    }
}

#[derive(Clone, Copy)]
enum ItemLike<'tcx> {
    Item(&'tcx Item<'tcx>),
    ForeignItem,
}

#[derive(Copy, Clone)]
pub(crate) enum ProcMacroKind {
    FunctionLike,
    Derive,
    Attribute,
}

impl IntoDiagArg for ProcMacroKind {
    fn into_diag_arg(self, _: &mut Option<std::path::PathBuf>) -> rustc_errors::DiagArgValue {
        match self {
            ProcMacroKind::Attribute => "attribute proc macro",
            ProcMacroKind::Derive => "derive proc macro",
            ProcMacroKind::FunctionLike => "function-like proc macro",
        }
        .into_diag_arg(&mut None)
    }
}

struct CheckAttrVisitor<'tcx> {
    tcx: TyCtxt<'tcx>,

    // Whether or not this visitor should abort after finding errors
    abort: Cell<bool>,
}

impl<'tcx> CheckAttrVisitor<'tcx> {
    fn dcx(&self) -> DiagCtxtHandle<'tcx> {
        self.tcx.dcx()
    }

    /// Checks any attribute.
    fn check_attributes(
        &self,
        hir_id: HirId,
        span: Span,
        target: Target,
        item: Option<ItemLike<'_>>,
    ) {
        let attrs = self.tcx.hir_attrs(hir_id);
        for attr in attrs {
            match attr {
                Attribute::Parsed(AttributeKind::ProcMacro(_)) => {
                    self.check_proc_macro(hir_id, target, ProcMacroKind::FunctionLike)
                }
                Attribute::Parsed(AttributeKind::ProcMacroAttribute(_)) => {
                    self.check_proc_macro(hir_id, target, ProcMacroKind::Attribute);
                }
                Attribute::Parsed(AttributeKind::ProcMacroDerive { .. }) => {
                    self.check_proc_macro(hir_id, target, ProcMacroKind::Derive)
                }
                Attribute::Parsed(AttributeKind::Inline(InlineAttr::Force { .. }, ..)) => {} // handled separately below
                Attribute::Parsed(AttributeKind::Inline(kind, attr_span)) => {
                    self.check_inline(hir_id, *attr_span, kind, target)
                }
                Attribute::Parsed(AttributeKind::LoopMatch(attr_span)) => {
                    self.check_loop_match(hir_id, *attr_span, target)
                }
                Attribute::Parsed(AttributeKind::ConstContinue(attr_span)) => {
                    self.check_const_continue(hir_id, *attr_span, target)
                }
                Attribute::Parsed(AttributeKind::AllowInternalUnsafe(attr_span) | AttributeKind::AllowInternalUnstable(.., attr_span)) => {
                    self.check_macro_only_attr(*attr_span, span, target, attrs)
                }
                Attribute::Parsed(AttributeKind::RustcAllowConstFnUnstable(_, first_span)) => {
                    self.check_rustc_allow_const_fn_unstable(hir_id, *first_span, span, target)
                }
                Attribute::Parsed(AttributeKind::Deprecated { span: attr_span, .. }) => {
                    self.check_deprecated(hir_id, *attr_span, target)
                }
                Attribute::Parsed(AttributeKind::TargetFeature{ attr_span, ..}) => {
                    self.check_target_feature(hir_id, *attr_span, target, attrs)
                }
                Attribute::Parsed(AttributeKind::RustcDumpObjectLifetimeDefaults) => {
                    self.check_dump_object_lifetime_defaults(hir_id);
                }
                &Attribute::Parsed(AttributeKind::RustcPubTransparent(attr_span)) => {
                    self.check_rustc_pub_transparent(attr_span, span, attrs)
                }
                Attribute::Parsed(AttributeKind::RustcAlign {..}) => {

                }
                Attribute::Parsed(AttributeKind::Naked(..)) => {
                    self.check_naked(hir_id, target)
                }
                Attribute::Parsed(AttributeKind::TrackCaller(attr_span)) => {
                    self.check_track_caller(hir_id, *attr_span, attrs, target)
                }
                Attribute::Parsed(AttributeKind::NonExhaustive(attr_span)) => {
                    self.check_non_exhaustive(*attr_span, span, target, item)
                }
                &Attribute::Parsed(AttributeKind::FfiPure(attr_span)) => {
                    self.check_ffi_pure(attr_span, attrs)
                }
                Attribute::Parsed(AttributeKind::MayDangle(attr_span)) => {
                    self.check_may_dangle(hir_id, *attr_span)
                }
                &Attribute::Parsed(AttributeKind::Sanitize { on_set, off_set, rtsan: _, span: attr_span}) => {
                    self.check_sanitize(attr_span, on_set | off_set, span, target);
                },
                Attribute::Parsed(AttributeKind::Link(_, attr_span)) => {
                    self.check_link(hir_id, *attr_span, span, target)
                },
                Attribute::Parsed(AttributeKind::MacroExport { span, .. }) => {
                    self.check_macro_export(hir_id, *span, target)
                },
                Attribute::Parsed(AttributeKind::RustcLegacyConstGenerics{attr_span, fn_indexes}) => {
                    self.check_rustc_legacy_const_generics(item, *attr_span, fn_indexes)
                },
                Attribute::Parsed(AttributeKind::Doc(attr)) => self.check_doc_attrs(attr, hir_id, target),
                Attribute::Parsed(AttributeKind::EiiImpls(impls)) => {
                     self.check_eii_impl(impls, target)
                },
                Attribute::Parsed(AttributeKind::RustcMustImplementOneOf { attr_span, fn_names }) => {
                    self.check_rustc_must_implement_one_of(*attr_span, fn_names, hir_id,target)
                },
                Attribute::Parsed(AttributeKind::DoNotRecommend{attr_span}) => {self.check_do_not_recommend(*attr_span, hir_id, target, item)},
                Attribute::Parsed(AttributeKind::OnUnimplemented{span, directive}) => {self.check_diagnostic_on_unimplemented(*span, hir_id, target,directive.as_deref())},
                Attribute::Parsed(AttributeKind::OnConst{span, ..}) => {self.check_diagnostic_on_const(*span, hir_id, target, item)}
                Attribute::Parsed(AttributeKind::OnMove { span, directive }) => {
                    self.check_diagnostic_on_move(*span, hir_id, target, directive.as_deref())
                },
                Attribute::Parsed(AttributeKind::LintAttributes(sub_attrs)) => self.check_lint_attr(hir_id, sub_attrs),
                Attribute::Parsed(
                    // tidy-alphabetical-start
                    AttributeKind::RustcAllowIncoherentImpl(..)
                    | AttributeKind::AutomaticallyDerived(..)
                    | AttributeKind::CfgAttrTrace
                    | AttributeKind::CfgTrace(..)
                    | AttributeKind::CfiEncoding { .. }
                    | AttributeKind::Cold(..)
                    | AttributeKind::CollapseDebugInfo(..)
                    | AttributeKind::CompilerBuiltins
                    | AttributeKind::Coroutine(..)
                    | AttributeKind::Coverage (..)
                    | AttributeKind::CrateName { .. }
                    | AttributeKind::CrateType(..)
                    | AttributeKind::CustomMir(..)
                    | AttributeKind::DebuggerVisualizer(..)
                    | AttributeKind::DefaultLibAllocator
                    // `#[doc]` is actually a lot more than just doc comments, so is checked below
                    | AttributeKind::DocComment {..}
                    | AttributeKind::EiiDeclaration { .. }
                    | AttributeKind::ExportName { .. }
                    | AttributeKind::ExportStable
                    | AttributeKind::Feature(..)
                    | AttributeKind::FfiConst(..)
                    | AttributeKind::Fundamental
                    | AttributeKind::Ignore { .. }
                    | AttributeKind::InstructionSet(..)
                    | AttributeKind::Lang(..)
                    | AttributeKind::LinkName { .. }
                    | AttributeKind::LinkOrdinal { .. }
                    | AttributeKind::LinkSection { .. }
                    | AttributeKind::Linkage(..)
                    | AttributeKind::MacroEscape( .. )
                    | AttributeKind::MacroUse { .. }
                    | AttributeKind::Marker(..)
                    | AttributeKind::MoveSizeLimit { .. }
                    | AttributeKind::MustNotSupend { .. }
                    | AttributeKind::MustUse { .. }
                    | AttributeKind::NeedsAllocator
                    | AttributeKind::NeedsPanicRuntime
                    | AttributeKind::NoBuiltins
                    | AttributeKind::NoCore { .. }
                    | AttributeKind::NoImplicitPrelude(..)
                    | AttributeKind::NoLink
                    | AttributeKind::NoMain
                    | AttributeKind::NoMangle(..)
                    | AttributeKind::NoStd { .. }
                    | AttributeKind::Optimize(..)
                    | AttributeKind::PanicRuntime
                    | AttributeKind::PatchableFunctionEntry { .. }
                    | AttributeKind::Path(..)
                    | AttributeKind::PatternComplexityLimit { .. }
                    | AttributeKind::PinV2(..)
                    | AttributeKind::Pointee(..)
                    | AttributeKind::PreludeImport
                    | AttributeKind::ProfilerRuntime
                    | AttributeKind::RecursionLimit { .. }
                    | AttributeKind::ReexportTestHarnessMain(..)
                    | AttributeKind::RegisterTool(..)
                    // handled below this loop and elsewhere
                    | AttributeKind::Repr { .. }
                    | AttributeKind::RustcAbi { .. }
                    | AttributeKind::RustcAllocator
                    | AttributeKind::RustcAllocatorZeroed
                    | AttributeKind::RustcAllocatorZeroedVariant { .. }
                    | AttributeKind::RustcAsPtr(..)
                    | AttributeKind::RustcAutodiff(..)
                    | AttributeKind::RustcBodyStability { .. }
                    | AttributeKind::RustcBuiltinMacro { .. }
                    | AttributeKind::RustcCaptureAnalysis
                    | AttributeKind::RustcCguTestAttr(..)
                    | AttributeKind::RustcClean(..)
                    | AttributeKind::RustcCoherenceIsCore(..)
                    | AttributeKind::RustcCoinductive(..)
                    | AttributeKind::RustcConfusables { .. }
                    | AttributeKind::RustcConstStability { .. }
                    | AttributeKind::RustcConstStableIndirect
                    | AttributeKind::RustcConversionSuggestion
                    | AttributeKind::RustcDeallocator
                    | AttributeKind::RustcDefPath(..)
                    | AttributeKind::RustcDelayedBugFromInsideQuery
                    | AttributeKind::RustcDenyExplicitImpl(..)
                    | AttributeKind::RustcDeprecatedSafe2024 {..}
                    | AttributeKind::RustcDiagnosticItem(..)
                    | AttributeKind::RustcDoNotConstCheck
                    | AttributeKind::RustcDocPrimitive(..)
                    | AttributeKind::RustcDummy
                    | AttributeKind::RustcDumpDefParents
                    | AttributeKind::RustcDumpInferredOutlives
                    | AttributeKind::RustcDumpItemBounds
                    | AttributeKind::RustcDumpPredicates
                    | AttributeKind::RustcDumpUserArgs
                    | AttributeKind::RustcDumpVariances
                    | AttributeKind::RustcDumpVariancesOfOpaques
                    | AttributeKind::RustcDumpVtable(..)
                    | AttributeKind::RustcDynIncompatibleTrait(..)
                    | AttributeKind::RustcEffectiveVisibility
                    | AttributeKind::RustcEiiForeignItem
                    | AttributeKind::RustcEvaluateWhereClauses
                    | AttributeKind::RustcHasIncoherentInherentImpls
                    | AttributeKind::RustcHiddenTypeOfOpaques
                    | AttributeKind::RustcIfThisChanged(..)
                    | AttributeKind::RustcInheritOverflowChecks
                    | AttributeKind::RustcInsignificantDtor
                    | AttributeKind::RustcIntrinsic
                    | AttributeKind::RustcIntrinsicConstStableIndirect
                    | AttributeKind::RustcLayout(..)
                    | AttributeKind::RustcLayoutScalarValidRangeEnd(..)
                    | AttributeKind::RustcLayoutScalarValidRangeStart(..)
                    | AttributeKind::RustcLintOptDenyFieldAccess { .. }
                    | AttributeKind::RustcLintOptTy
                    | AttributeKind::RustcLintQueryInstability
                    | AttributeKind::RustcLintUntrackedQueryInformation
                    | AttributeKind::RustcMacroTransparency(_)
                    | AttributeKind::RustcMain
                    | AttributeKind::RustcMir(_)
                    | AttributeKind::RustcNeverReturnsNullPtr
                    | AttributeKind::RustcNeverTypeOptions {..}
                    | AttributeKind::RustcNoImplicitAutorefs
                    | AttributeKind::RustcNoImplicitBounds
                    | AttributeKind::RustcNoMirInline
                    | AttributeKind::RustcNonConstTraitMethod
                    | AttributeKind::RustcNonnullOptimizationGuaranteed
                    | AttributeKind::RustcNounwind
                    | AttributeKind::RustcObjcClass { .. }
                    | AttributeKind::RustcObjcSelector { .. }
                    | AttributeKind::RustcOffloadKernel
                    | AttributeKind::RustcParenSugar(..)
                    | AttributeKind::RustcPassByValue (..)
                    | AttributeKind::RustcPassIndirectlyInNonRusticAbis(..)
                    | AttributeKind::RustcPreserveUbChecks
                    | AttributeKind::RustcProcMacroDecls
                    | AttributeKind::RustcReallocator
                    | AttributeKind::RustcRegions
                    | AttributeKind::RustcReservationImpl(..)
                    | AttributeKind::RustcScalableVector { .. }
                    | AttributeKind::RustcShouldNotBeCalledOnConstItems(..)
                    | AttributeKind::RustcSimdMonomorphizeLaneLimit(..)
                    | AttributeKind::RustcSkipDuringMethodDispatch { .. }
                    | AttributeKind::RustcSpecializationTrait(..)
                    | AttributeKind::RustcStdInternalSymbol (..)
                    | AttributeKind::RustcStrictCoherence(..)
                    | AttributeKind::RustcSymbolName(..)
                    | AttributeKind::RustcTestMarker(..)
                    | AttributeKind::RustcThenThisWouldNeed(..)
                    | AttributeKind::RustcTrivialFieldReads
                    | AttributeKind::RustcUnsafeSpecializationMarker(..)
                    | AttributeKind::ShouldPanic { .. }
                    | AttributeKind::Stability { .. }
                    | AttributeKind::TestRunner(..)
                    | AttributeKind::ThreadLocal
                    | AttributeKind::TypeLengthLimit { .. }
                    | AttributeKind::UnstableFeatureBound(..)
                    | AttributeKind::Used { .. }
                    | AttributeKind::WindowsSubsystem(..)
                    // tidy-alphabetical-end
                ) => { /* do nothing  */ }
                Attribute::Unparsed(_) => {
                    match attr.path().as_slice() {
                        [name, rest@..] => {
                            match BUILTIN_ATTRIBUTE_MAP.get(name) {
                                Some(_) => {
                                    if rest.len() > 0 && AttributeParser::<Late>::is_parsed_attribute(slice::from_ref(name)) {
                                        // Check if we tried to use a builtin attribute as an attribute namespace, like `#[must_use::skip]`.
                                        // This check is here to solve https://github.com/rust-lang/rust/issues/137590
                                        // An error is already produced for this case elsewhere
                                        continue
                                    }

                                    span_bug!(
                                        attr.span(),
                                        "builtin attribute {name:?} not handled by `CheckAttrVisitor`"
                                    )
                                }
                                None => (),
                            }
                        }
                        [] => unreachable!(),
                    }
                }
            }

            self.check_unused_attribute(hir_id, attr)
        }

        self.check_repr(attrs, span, target, item, hir_id);
        self.check_rustc_force_inline(hir_id, attrs, target);
        self.check_mix_no_mangle_export(hir_id, attrs);
    }

    fn check_rustc_must_implement_one_of(
        &self,
        attr_span: Span,
        list: &ThinVec<Ident>,
        hir_id: HirId,
        target: Target,
    ) {
        // Ignoring invalid targets because TyCtxt::associated_items emits bug if the target isn't valid
        // the parser has already produced an error for the target being invalid
        if !matches!(target, Target::Trait) {
            return;
        }

        let def_id = hir_id.owner.def_id;

        let items = self.tcx.associated_items(def_id);
        // Check that all arguments of `#[rustc_must_implement_one_of]` reference
        // functions in the trait with default implementations
        for ident in list {
            let item = items
                .filter_by_name_unhygienic(ident.name)
                .find(|item| item.ident(self.tcx) == *ident);

            match item {
                Some(item) if matches!(item.kind, ty::AssocKind::Fn { .. }) => {
                    if !item.defaultness(self.tcx).has_value() {
                        self.tcx.dcx().emit_err(errors::FunctionNotHaveDefaultImplementation {
                            span: self.tcx.def_span(item.def_id),
                            note_span: attr_span,
                        });
                    }
                }
                Some(item) => {
                    self.dcx().emit_err(errors::MustImplementNotFunction {
                        span: self.tcx.def_span(item.def_id),
                        span_note: errors::MustImplementNotFunctionSpanNote { span: attr_span },
                        note: errors::MustImplementNotFunctionNote {},
                    });
                }
                None => {
                    self.dcx().emit_err(errors::FunctionNotFoundInTrait { span: ident.span });
                }
            }
        }
        // Check for duplicates

        let mut set: UnordMap<Symbol, Span> = Default::default();

        for ident in &*list {
            if let Some(dup) = set.insert(ident.name, ident.span) {
                self.tcx
                    .dcx()
                    .emit_err(errors::FunctionNamesDuplicated { spans: vec![dup, ident.span] });
            }
        }
    }

    fn check_eii_impl(&self, impls: &[EiiImpl], target: Target) {
        for EiiImpl { span, inner_span, resolution, impl_marked_unsafe, is_default: _ } in impls {
            match target {
                Target::Fn => {}
                _ => {
                    self.dcx().emit_err(errors::EiiImplNotFunction { span: *span });
                }
            }

            if let EiiImplResolution::Macro(eii_macro) = resolution
                && find_attr!(self.tcx, *eii_macro, EiiDeclaration(EiiDecl { impl_unsafe, .. }) if *impl_unsafe)
                && !impl_marked_unsafe
            {
                self.dcx().emit_err(errors::EiiImplRequiresUnsafe {
                    span: *span,
                    name: self.tcx.item_name(*eii_macro),
                    suggestion: errors::EiiImplRequiresUnsafeSuggestion {
                        left: inner_span.shrink_to_lo(),
                        right: inner_span.shrink_to_hi(),
                    },
                });
            }
        }
    }

    /// Checks if `#[diagnostic::do_not_recommend]` is applied on a trait impl
    fn check_do_not_recommend(
        &self,
        attr_span: Span,
        hir_id: HirId,
        target: Target,
        item: Option<ItemLike<'_>>,
    ) {
        if !matches!(target, Target::Impl { .. })
            || matches!(
                item,
                Some(ItemLike::Item(hir::Item {  kind: hir::ItemKind::Impl(_impl),.. }))
                    if _impl.of_trait.is_none()
            )
        {
            self.tcx.emit_node_span_lint(
                MISPLACED_DIAGNOSTIC_ATTRIBUTES,
                hir_id,
                attr_span,
                errors::IncorrectDoNotRecommendLocation,
            );
        }
    }

    /// Checks if `#[diagnostic::on_unimplemented]` is applied to a trait definition
    fn check_diagnostic_on_unimplemented(
        &self,
        attr_span: Span,
        hir_id: HirId,
        target: Target,
        directive: Option<&Directive>,
    ) {
        if !matches!(target, Target::Trait) {
            self.tcx.emit_node_span_lint(
                MISPLACED_DIAGNOSTIC_ATTRIBUTES,
                hir_id,
                attr_span,
                DiagnosticOnUnimplementedOnlyForTraits,
            );
        }

        if let Some(directive) = directive {
            if let Node::Item(Item {
                kind: ItemKind::Trait(_, _, _, trait_name, generics, _, _),
                ..
            }) = self.tcx.hir_node(hir_id)
            {
                directive.visit_params(&mut |argument_name, span| {
                    let has_generic = generics.params.iter().any(|p| {
                        if !matches!(p.kind, GenericParamKind::Lifetime { .. })
                            && let ParamName::Plain(name) = p.name
                            && name.name == argument_name
                        {
                            true
                        } else {
                            false
                        }
                    });
                    if !has_generic {
                        self.tcx.emit_node_span_lint(
                            MALFORMED_DIAGNOSTIC_FORMAT_LITERALS,
                            hir_id,
                            span,
                            errors::UnknownFormatParameterForOnUnimplementedAttr {
                                argument_name,
                                trait_name: *trait_name,
                                help: !directive.is_rustc_attr,
                            },
                        )
                    }
                })
            }
        }
    }

    /// Checks if `#[diagnostic::on_const]` is applied to a trait impl
    fn check_diagnostic_on_const(
        &self,
        attr_span: Span,
        hir_id: HirId,
        target: Target,
        item: Option<ItemLike<'_>>,
    ) {
        if target == (Target::Impl { of_trait: true }) {
            match item.unwrap() {
                ItemLike::Item(it) => match it.expect_impl().constness {
                    Constness::Const => {
                        let item_span = self.tcx.hir_span(hir_id);
                        self.tcx.emit_node_span_lint(
                            MISPLACED_DIAGNOSTIC_ATTRIBUTES,
                            hir_id,
                            attr_span,
                            DiagnosticOnConstOnlyForNonConstTraitImpls { item_span },
                        );
                        return;
                    }
                    Constness::NotConst => return,
                },
                ItemLike::ForeignItem => {}
            }
        }
        let item_span = self.tcx.hir_span(hir_id);
        self.tcx.emit_node_span_lint(
            MISPLACED_DIAGNOSTIC_ATTRIBUTES,
            hir_id,
            attr_span,
            DiagnosticOnConstOnlyForTraitImpls { item_span },
        );

        // We don't check the validity of generic args here...whose generics would that be, anyway?
        // The traits' or the impls'?
    }

    /// Checks if `#[diagnostic::on_move]` is applied to an ADT definition
    fn check_diagnostic_on_move(
        &self,
        attr_span: Span,
        hir_id: HirId,
        target: Target,
        directive: Option<&Directive>,
    ) {
        if !matches!(target, Target::Enum | Target::Struct | Target::Union) {
            self.tcx.emit_node_span_lint(
                MISPLACED_DIAGNOSTIC_ATTRIBUTES,
                hir_id,
                attr_span,
                DiagnosticOnMoveOnlyForAdt,
            );
        }

        if let Some(directive) = directive {
            if let Node::Item(Item {
                kind:
                    ItemKind::Struct(_, generics, _)
                    | ItemKind::Enum(_, generics, _)
                    | ItemKind::Union(_, generics, _),
                ..
            }) = self.tcx.hir_node(hir_id)
            {
                directive.visit_params(&mut |argument_name, span| {
                    let has_generic = generics.params.iter().any(|p| {
                        if !matches!(p.kind, GenericParamKind::Lifetime { .. })
                            && let ParamName::Plain(name) = p.name
                            && name.name == argument_name
                        {
                            true
                        } else {
                            false
                        }
                    });
                    if !has_generic {
                        self.tcx.emit_node_span_lint(
                            MALFORMED_DIAGNOSTIC_FORMAT_LITERALS,
                            hir_id,
                            span,
                            errors::OnMoveMalformedFormatLiterals { name: argument_name },
                        )
                    }
                });
            }
        }
    }

    /// Checks if an `#[inline]` is applied to a function or a closure.
    fn check_inline(&self, hir_id: HirId, attr_span: Span, kind: &InlineAttr, target: Target) {
        match target {
            Target::Fn
            | Target::Closure
            | Target::Method(MethodKind::Trait { body: true } | MethodKind::Inherent) => {
                // `#[inline]` is ignored if the symbol must be codegened upstream because it's exported.
                if let Some(did) = hir_id.as_owner()
                    && self.tcx.def_kind(did).has_codegen_attrs()
                    && kind != &InlineAttr::Never
                {
                    let attrs = self.tcx.codegen_fn_attrs(did);
                    // Not checking naked as `#[inline]` is forbidden for naked functions anyways.
                    if attrs.contains_extern_indicator() {
                        self.tcx.emit_node_span_lint(
                            UNUSED_ATTRIBUTES,
                            hir_id,
                            attr_span,
                            errors::InlineIgnoredForExported,
                        );
                    }
                }
            }
            _ => {}
        }
    }

    /// Checks that the `#[sanitize(..)]` attribute is applied to a
    /// function/closure/method, or to an impl block or module.
    fn check_sanitize(
        &self,
        attr_span: Span,
        set: SanitizerSet,
        target_span: Span,
        target: Target,
    ) {
        let mut not_fn_impl_mod = None;
        let mut no_body = None;

        match target {
            Target::Fn
            | Target::Closure
            | Target::Method(MethodKind::Trait { body: true } | MethodKind::Inherent)
            | Target::Impl { .. }
            | Target::Mod => return,
            Target::Static
                // if we mask out the address bits, i.e. *only* address was set,
                // we allow it
                if set & !(SanitizerSet::ADDRESS | SanitizerSet::KERNELADDRESS)
                    == SanitizerSet::empty() =>
            {
                return;
            }

            // These are "functions", but they aren't allowed because they don't
            // have a body, so the usual explanation would be confusing.
            Target::Method(MethodKind::Trait { body: false }) | Target::ForeignFn => {
                no_body = Some(target_span);
            }

            _ => {
                not_fn_impl_mod = Some(target_span);
            }
        }

        self.dcx().emit_err(errors::SanitizeAttributeNotAllowed {
            attr_span,
            not_fn_impl_mod,
            no_body,
            help: (),
        });
    }

    /// Checks if `#[naked]` is applied to a function definition.
    fn check_naked(&self, hir_id: HirId, target: Target) {
        match target {
            Target::Fn
            | Target::Method(MethodKind::Trait { body: true } | MethodKind::Inherent) => {
                let fn_sig = self.tcx.hir_node(hir_id).fn_sig().unwrap();
                let abi = fn_sig.header.abi;
                if abi.is_rustic_abi() && !self.tcx.features().naked_functions_rustic_abi() {
                    feature_err(
                        &self.tcx.sess,
                        sym::naked_functions_rustic_abi,
                        fn_sig.span,
                        format!(
                            "`#[naked]` is currently unstable on `extern \"{}\"` functions",
                            abi.as_str()
                        ),
                    )
                    .emit();
                }
            }
            _ => {}
        }
    }

    /// Debugging aid for the `object_lifetime_default` query.
    fn check_dump_object_lifetime_defaults(&self, hir_id: HirId) {
        let tcx = self.tcx;
        if let Some(owner_id) = hir_id.as_owner()
            && let Some(generics) = tcx.hir_get_generics(owner_id.def_id)
        {
            for p in generics.params {
                let hir::GenericParamKind::Type { .. } = p.kind else { continue };
                let default = tcx.object_lifetime_default(p.def_id);
                let repr = match default {
                    ObjectLifetimeDefault::Empty => "BaseDefault".to_owned(),
                    ObjectLifetimeDefault::Static => "'static".to_owned(),
                    ObjectLifetimeDefault::Param(def_id) => tcx.item_name(def_id).to_string(),
                    ObjectLifetimeDefault::Ambiguous => "Ambiguous".to_owned(),
                };
                tcx.dcx().span_err(p.span, repr);
            }
        }
    }

    /// Checks if a `#[track_caller]` is applied to a function.
    fn check_track_caller(
        &self,
        hir_id: HirId,
        attr_span: Span,
        attrs: &[Attribute],
        target: Target,
    ) {
        match target {
            Target::Fn => {
                // `#[track_caller]` is not valid on weak lang items because they are called via
                // `extern` declarations and `#[track_caller]` would alter their ABI.
                if let Some(item) = find_attr!(attrs, Lang(item, _) => item)
                    && item.is_weak()
                {
                    let sig = self.tcx.hir_node(hir_id).fn_sig().unwrap();

                    self.dcx().emit_err(errors::LangItemWithTrackCaller {
                        attr_span,
                        name: item.name(),
                        sig_span: sig.span,
                    });
                }

                if let Some(impls) = find_attr!(attrs, EiiImpls(impls) => impls) {
                    let sig = self.tcx.hir_node(hir_id).fn_sig().unwrap();
                    for i in impls {
                        let name = match i.resolution {
                            EiiImplResolution::Macro(def_id) => self.tcx.item_name(def_id),
                            EiiImplResolution::Known(decl) => decl.name.name,
                            EiiImplResolution::Error(_eg) => continue,
                        };
                        self.dcx().emit_err(errors::EiiWithTrackCaller {
                            attr_span,
                            name,
                            sig_span: sig.span,
                        });
                    }
                }
            }
            _ => {}
        }
    }

    /// Checks if the `#[non_exhaustive]` attribute on an `item` is valid.
    fn check_non_exhaustive(
        &self,
        attr_span: Span,
        span: Span,
        target: Target,
        item: Option<ItemLike<'_>>,
    ) {
        match target {
            Target::Struct => {
                if let Some(ItemLike::Item(hir::Item {
                    kind: hir::ItemKind::Struct(_, _, hir::VariantData::Struct { fields, .. }),
                    ..
                })) = item
                    && !fields.is_empty()
                    && fields.iter().any(|f| f.default.is_some())
                {
                    self.dcx().emit_err(errors::NonExhaustiveWithDefaultFieldValues {
                        attr_span,
                        defn_span: span,
                    });
                }
            }
            _ => {}
        }
    }

    /// Checks if the `#[target_feature]` attribute on `item` is valid.
    fn check_target_feature(
        &self,
        hir_id: HirId,
        attr_span: Span,
        target: Target,
        attrs: &[Attribute],
    ) {
        match target {
            Target::Method(MethodKind::Trait { body: true } | MethodKind::Inherent)
            | Target::Fn => {
                // `#[target_feature]` is not allowed in lang items.
                if let Some(lang_item) = find_attr!(attrs, Lang(lang, _) => lang)
                    // Calling functions with `#[target_feature]` is
                    // not unsafe on WASM, see #84988
                    && !self.tcx.sess.target.is_like_wasm
                    && !self.tcx.sess.opts.actually_rustdoc
                {
                    let sig = self.tcx.hir_node(hir_id).fn_sig().unwrap();

                    self.dcx().emit_err(errors::LangItemWithTargetFeature {
                        attr_span,
                        name: lang_item.name(),
                        sig_span: sig.span,
                    });
                }
            }
            _ => {}
        }
    }

    fn check_doc_alias_value(&self, span: Span, hir_id: HirId, target: Target, alias: Symbol) {
        if let Some(location) = match target {
            Target::AssocTy => {
                if let DefKind::Impl { .. } =
                    self.tcx.def_kind(self.tcx.local_parent(hir_id.owner.def_id))
                {
                    Some("type alias in implementation block")
                } else {
                    None
                }
            }
            Target::AssocConst => {
                let parent_def_id = self.tcx.hir_get_parent_item(hir_id).def_id;
                let containing_item = self.tcx.hir_expect_item(parent_def_id);
                // We can't link to trait impl's consts.
                let err = "associated constant in trait implementation block";
                match containing_item.kind {
                    ItemKind::Impl(hir::Impl { of_trait: Some(_), .. }) => Some(err),
                    _ => None,
                }
            }
            // we check the validity of params elsewhere
            Target::Param => return,
            Target::Expression
            | Target::Statement
            | Target::Arm
            | Target::ForeignMod
            | Target::Closure
            | Target::Impl { .. }
            | Target::WherePredicate => Some(target.name()),
            Target::ExternCrate
            | Target::Use
            | Target::Static
            | Target::Const
            | Target::Fn
            | Target::Mod
            | Target::GlobalAsm
            | Target::TyAlias
            | Target::Enum
            | Target::Variant
            | Target::Struct
            | Target::Field
            | Target::Union
            | Target::Trait
            | Target::TraitAlias
            | Target::Method(..)
            | Target::ForeignFn
            | Target::ForeignStatic
            | Target::ForeignTy
            | Target::GenericParam { .. }
            | Target::MacroDef
            | Target::PatField
            | Target::ExprField
            | Target::Crate
            | Target::MacroCall
            | Target::Delegation { .. } => None,
        } {
            self.tcx.dcx().emit_err(errors::DocAliasBadLocation { span, location });
            return;
        }
        if self.tcx.hir_opt_name(hir_id) == Some(alias) {
            self.tcx.dcx().emit_err(errors::DocAliasNotAnAlias { span, attr_str: alias });
            return;
        }
    }

    fn check_doc_fake_variadic(&self, span: Span, hir_id: HirId) {
        let item_kind = match self.tcx.hir_node(hir_id) {
            hir::Node::Item(item) => Some(&item.kind),
            _ => None,
        };
        match item_kind {
            Some(ItemKind::Impl(i)) => {
                let is_valid = doc_fake_variadic_is_allowed_self_ty(i.self_ty)
                    || if let Some(&[hir::GenericArg::Type(ty)]) = i
                        .of_trait
                        .and_then(|of_trait| of_trait.trait_ref.path.segments.last())
                        .map(|last_segment| last_segment.args().args)
                    {
                        matches!(&ty.kind, hir::TyKind::Tup([_]))
                    } else {
                        false
                    };
                if !is_valid {
                    self.dcx().emit_err(errors::DocFakeVariadicNotValid { span });
                }
            }
            _ => {
                self.dcx().emit_err(errors::DocKeywordOnlyImpl { span });
            }
        }
    }

    fn check_doc_search_unbox(&self, span: Span, hir_id: HirId) {
        let hir::Node::Item(item) = self.tcx.hir_node(hir_id) else {
            self.dcx().emit_err(errors::DocSearchUnboxInvalid { span });
            return;
        };
        match item.kind {
            ItemKind::Enum(_, generics, _) | ItemKind::Struct(_, generics, _)
                if generics.params.len() != 0 => {}
            ItemKind::Trait(_, _, _, _, generics, _, items)
                if generics.params.len() != 0
                    || items.iter().any(|item| {
                        matches!(self.tcx.def_kind(item.owner_id), DefKind::AssocTy)
                    }) => {}
            ItemKind::TyAlias(_, generics, _) if generics.params.len() != 0 => {}
            _ => {
                self.dcx().emit_err(errors::DocSearchUnboxInvalid { span });
            }
        }
    }

    /// Checks `#[doc(inline)]`/`#[doc(no_inline)]` attributes.
    ///
    /// A doc inlining attribute is invalid if it is applied to a non-`use` item, or
    /// if there are conflicting attributes for one item.
    ///
    /// `specified_inline` is used to keep track of whether we have
    /// already seen an inlining attribute for this item.
    /// If so, `specified_inline` holds the value and the span of
    /// the first `inline`/`no_inline` attribute.
    fn check_doc_inline(&self, hir_id: HirId, target: Target, inline: &[(DocInline, Span)]) {
        let span = match inline {
            [] => return,
            [(_, span)] => *span,
            [(inline, span), rest @ ..] => {
                for (inline2, span2) in rest {
                    if inline2 != inline {
                        let mut spans = MultiSpan::from_spans(vec![*span, *span2]);
                        spans.push_span_label(*span, msg!("this attribute..."));
                        spans.push_span_label(
                            *span2,
                            msg!("{\".\"}..conflicts with this attribute"),
                        );
                        self.dcx().emit_err(errors::DocInlineConflict { spans });
                        return;
                    }
                }
                *span
            }
        };

        match target {
            Target::Use | Target::ExternCrate => {}
            _ => {
                self.tcx.emit_node_span_lint(
                    INVALID_DOC_ATTRIBUTES,
                    hir_id,
                    span,
                    errors::DocInlineOnlyUse {
                        attr_span: span,
                        item_span: self.tcx.hir_span(hir_id),
                    },
                );
            }
        }
    }

    fn check_doc_masked(&self, span: Span, hir_id: HirId, target: Target) {
        if target != Target::ExternCrate {
            self.tcx.emit_node_span_lint(
                INVALID_DOC_ATTRIBUTES,
                hir_id,
                span,
                errors::DocMaskedOnlyExternCrate {
                    attr_span: span,
                    item_span: self.tcx.hir_span(hir_id),
                },
            );
            return;
        }

        if self.tcx.extern_mod_stmt_cnum(hir_id.owner.def_id).is_none() {
            self.tcx.emit_node_span_lint(
                INVALID_DOC_ATTRIBUTES,
                hir_id,
                span,
                errors::DocMaskedNotExternCrateSelf {
                    attr_span: span,
                    item_span: self.tcx.hir_span(hir_id),
                },
            );
        }
    }

    fn check_doc_keyword_and_attribute(&self, span: Span, hir_id: HirId, attr_name: &'static str) {
        let item_kind = match self.tcx.hir_node(hir_id) {
            hir::Node::Item(item) => Some(&item.kind),
            _ => None,
        };
        match item_kind {
            Some(ItemKind::Mod(_, module)) => {
                if !module.item_ids.is_empty() {
                    self.dcx().emit_err(errors::DocKeywordAttributeEmptyMod { span, attr_name });
                    return;
                }
            }
            _ => {
                self.dcx().emit_err(errors::DocKeywordAttributeNotMod { span, attr_name });
                return;
            }
        }
    }

    /// Runs various checks on `#[doc]` attributes.
    ///
    /// `specified_inline` should be initialized to `None` and kept for the scope
    /// of one item. Read the documentation of [`check_doc_inline`] for more information.
    ///
    /// [`check_doc_inline`]: Self::check_doc_inline
    fn check_doc_attrs(&self, attr: &DocAttribute, hir_id: HirId, target: Target) {
        let DocAttribute {
            aliases,
            // valid pretty much anywhere, not checked here?
            // FIXME: should we?
            hidden: _,
            inline,
            // FIXME: currently unchecked
            cfg: _,
            // already checked in attr_parsing
            auto_cfg: _,
            // already checked in attr_parsing
            auto_cfg_change: _,
            fake_variadic,
            keyword,
            masked,
            // FIXME: currently unchecked
            notable_trait: _,
            search_unbox,
            // already checked in attr_parsing
            html_favicon_url: _,
            // already checked in attr_parsing
            html_logo_url: _,
            // already checked in attr_parsing
            html_playground_url: _,
            // already checked in attr_parsing
            html_root_url: _,
            // already checked in attr_parsing
            html_no_source: _,
            // already checked in attr_parsing
            issue_tracker_base_url: _,
            // already checked in attr_parsing
            rust_logo: _,
            // allowed anywhere
            test_attrs: _,
            // already checked in attr_parsing
            no_crate_inject: _,
            attribute,
        } = attr;

        for (alias, span) in aliases {
            self.check_doc_alias_value(*span, hir_id, target, *alias);
        }

        if let Some((_, span)) = keyword {
            self.check_doc_keyword_and_attribute(*span, hir_id, "keyword");
        }
        if let Some((_, span)) = attribute {
            self.check_doc_keyword_and_attribute(*span, hir_id, "attribute");
        }

        if let Some(span) = fake_variadic {
            self.check_doc_fake_variadic(*span, hir_id);
        }

        if let Some(span) = search_unbox {
            self.check_doc_search_unbox(*span, hir_id);
        }

        self.check_doc_inline(hir_id, target, inline);

        if let Some(span) = masked {
            self.check_doc_masked(*span, hir_id, target);
        }
    }

    fn check_ffi_pure(&self, attr_span: Span, attrs: &[Attribute]) {
        if find_attr!(attrs, FfiConst(_)) {
            // `#[ffi_const]` functions cannot be `#[ffi_pure]`
            self.dcx().emit_err(errors::BothFfiConstAndPure { attr_span });
        }
    }

    /// Checks if `#[may_dangle]` is applied to a lifetime or type generic parameter in `Drop` impl.
    fn check_may_dangle(&self, hir_id: HirId, attr_span: Span) {
        if let hir::Node::GenericParam(param) = self.tcx.hir_node(hir_id)
            && matches!(
                param.kind,
                hir::GenericParamKind::Lifetime { .. } | hir::GenericParamKind::Type { .. }
            )
            && matches!(param.source, hir::GenericParamSource::Generics)
            && let parent_hir_id = self.tcx.parent_hir_id(hir_id)
            && let hir::Node::Item(item) = self.tcx.hir_node(parent_hir_id)
            && let hir::ItemKind::Impl(impl_) = item.kind
            && let Some(of_trait) = impl_.of_trait
            && let Some(def_id) = of_trait.trait_ref.trait_def_id()
            && self.tcx.is_lang_item(def_id, hir::LangItem::Drop)
        {
            return;
        }

        self.dcx().emit_err(errors::InvalidMayDangle { attr_span });
    }

    /// Checks if `#[link]` is applied to an item other than a foreign module.
    fn check_link(&self, hir_id: HirId, attr_span: Span, span: Span, target: Target) {
        if target == Target::ForeignMod
            && let hir::Node::Item(item) = self.tcx.hir_node(hir_id)
            && let Item { kind: ItemKind::ForeignMod { abi, .. }, .. } = item
            && !matches!(abi, ExternAbi::Rust)
        {
            return;
        }

        self.tcx.emit_node_span_lint(
            UNUSED_ATTRIBUTES,
            hir_id,
            attr_span,
            errors::Link { span: (target != Target::ForeignMod).then_some(span) },
        );
    }

    /// Checks if `#[rustc_legacy_const_generics]` is applied to a function and has a valid argument.
    fn check_rustc_legacy_const_generics(
        &self,
        item: Option<ItemLike<'_>>,
        attr_span: Span,
        index_list: &ThinVec<(usize, Span)>,
    ) {
        let Some(ItemLike::Item(Item {
            kind: ItemKind::Fn { sig: FnSig { decl, .. }, generics, .. },
            ..
        })) = item
        else {
            // No error here, since it's already given by the parser
            return;
        };

        for param in generics.params {
            match param.kind {
                hir::GenericParamKind::Const { .. } => {}
                _ => {
                    self.dcx().emit_err(errors::RustcLegacyConstGenericsOnly {
                        attr_span,
                        param_span: param.span,
                    });
                    return;
                }
            }
        }

        if index_list.len() != generics.params.len() {
            self.dcx().emit_err(errors::RustcLegacyConstGenericsIndex {
                attr_span,
                generics_span: generics.span,
            });
            return;
        }

        let arg_count = decl.inputs.len() + generics.params.len();
        for (index, span) in index_list {
            if *index >= arg_count {
                self.dcx().emit_err(errors::RustcLegacyConstGenericsIndexExceed {
                    span: *span,
                    arg_count,
                });
            }
        }
    }

    /// Checks if the `#[repr]` attributes on `item` are valid.
    fn check_repr(
        &self,
        attrs: &[Attribute],
        span: Span,
        target: Target,
        item: Option<ItemLike<'_>>,
        hir_id: HirId,
    ) {
        // Extract the names of all repr hints, e.g., [foo, bar, align] for:
        // ```
        // #[repr(foo)]
        // #[repr(bar, align(8))]
        // ```
        let (reprs, first_attr_span) =
            find_attr!(attrs, Repr { reprs, first_span } => (reprs.as_slice(), Some(*first_span)))
                .unwrap_or((&[], None));

        let mut int_reprs = 0;
        let mut is_explicit_rust = false;
        let mut is_c = false;
        let mut is_simd = false;
        let mut is_transparent = false;

        for (repr, repr_span) in reprs {
            match repr {
                ReprAttr::ReprRust => {
                    is_explicit_rust = true;
                    match target {
                        Target::Struct | Target::Union | Target::Enum => continue,
                        _ => {
                            self.dcx().emit_err(errors::AttrApplication::StructEnumUnion {
                                hint_span: *repr_span,
                                span,
                            });
                        }
                    }
                }
                ReprAttr::ReprC => {
                    is_c = true;
                    match target {
                        Target::Struct | Target::Union | Target::Enum => continue,
                        _ => {
                            self.dcx().emit_err(errors::AttrApplication::StructEnumUnion {
                                hint_span: *repr_span,
                                span,
                            });
                        }
                    }
                }
                ReprAttr::ReprAlign(..) => match target {
                    Target::Struct | Target::Union | Target::Enum => {}
                    Target::Fn | Target::Method(_) if self.tcx.features().fn_align() => {
                        self.dcx().emit_err(errors::ReprAlignShouldBeAlign {
                            span: *repr_span,
                            item: target.plural_name(),
                        });
                    }
                    Target::Static if self.tcx.features().static_align() => {
                        self.dcx().emit_err(errors::ReprAlignShouldBeAlignStatic {
                            span: *repr_span,
                            item: target.plural_name(),
                        });
                    }
                    _ => {
                        self.dcx().emit_err(errors::AttrApplication::StructEnumUnion {
                            hint_span: *repr_span,
                            span,
                        });
                    }
                },
                ReprAttr::ReprPacked(_) => {
                    if target != Target::Struct && target != Target::Union {
                        self.dcx().emit_err(errors::AttrApplication::StructUnion {
                            hint_span: *repr_span,
                            span,
                        });
                    } else {
                        continue;
                    }
                }
                ReprAttr::ReprSimd => {
                    is_simd = true;
                    if target != Target::Struct {
                        self.dcx().emit_err(errors::AttrApplication::Struct {
                            hint_span: *repr_span,
                            span,
                        });
                    } else {
                        continue;
                    }
                }
                ReprAttr::ReprTransparent => {
                    is_transparent = true;
                    match target {
                        Target::Struct | Target::Union | Target::Enum => continue,
                        _ => {
                            self.dcx().emit_err(errors::AttrApplication::StructEnumUnion {
                                hint_span: *repr_span,
                                span,
                            });
                        }
                    }
                }
                ReprAttr::ReprInt(_) => {
                    int_reprs += 1;
                    if target != Target::Enum {
                        self.dcx().emit_err(errors::AttrApplication::Enum {
                            hint_span: *repr_span,
                            span,
                        });
                    } else {
                        continue;
                    }
                }
            };
        }

        // catch `repr()` with no arguments, applied to an item (i.e. not `#![repr()]`)
        if let Some(first_attr_span) = first_attr_span
            && reprs.is_empty()
            && item.is_some()
        {
            match target {
                Target::Struct | Target::Union | Target::Enum => {}
                Target::Fn | Target::Method(_) => {
                    self.dcx().emit_err(errors::ReprAlignShouldBeAlign {
                        span: first_attr_span,
                        item: target.plural_name(),
                    });
                }
                _ => {
                    self.dcx().emit_err(errors::AttrApplication::StructEnumUnion {
                        hint_span: first_attr_span,
                        span,
                    });
                }
            }
            return;
        }

        // Just point at all repr hints if there are any incompatibilities.
        // This is not ideal, but tracking precisely which ones are at fault is a huge hassle.
        let hint_spans = reprs.iter().map(|(_, span)| *span);

        // Error on repr(transparent, <anything else>).
        if is_transparent && reprs.len() > 1 {
            let hint_spans = hint_spans.clone().collect();
            self.dcx().emit_err(errors::TransparentIncompatible {
                hint_spans,
                target: target.to_string(),
            });
        }
        // Error on `#[repr(transparent)]` in combination with
        // `#[rustc_pass_indirectly_in_non_rustic_abis]`
        if is_transparent
            && let Some(&pass_indirectly_span) =
                find_attr!(attrs, RustcPassIndirectlyInNonRusticAbis(span) => span)
        {
            self.dcx().emit_err(errors::TransparentIncompatible {
                hint_spans: vec![span, pass_indirectly_span],
                target: target.to_string(),
            });
        }
        if is_explicit_rust && (int_reprs > 0 || is_c || is_simd) {
            let hint_spans = hint_spans.clone().collect();
            self.dcx().emit_err(errors::ReprConflicting { hint_spans });
        }
        // Warn on repr(u8, u16), repr(C, simd), and c-like-enum-repr(C, u8)
        if (int_reprs > 1)
            || (is_simd && is_c)
            || (int_reprs == 1
                && is_c
                && item.is_some_and(|item| {
                    if let ItemLike::Item(item) = item { is_c_like_enum(item) } else { false }
                }))
        {
            self.tcx.emit_node_span_lint(
                CONFLICTING_REPR_HINTS,
                hir_id,
                hint_spans.collect::<Vec<Span>>(),
                errors::ReprConflictingLint,
            );
        }
    }

    /// Outputs an error for attributes that can only be applied to macros, such as
    /// `#[allow_internal_unsafe]` and `#[allow_internal_unstable]`.
    /// (Allows proc_macro functions)
    // FIXME(jdonszelmann): if possible, move to attr parsing
    fn check_macro_only_attr(
        &self,
        attr_span: Span,
        span: Span,
        target: Target,
        attrs: &[Attribute],
    ) {
        match target {
            Target::Fn => {
                for attr in attrs {
                    if attr.is_proc_macro_attr() {
                        // return on proc macros
                        return;
                    }
                }
                self.tcx.dcx().emit_err(errors::MacroOnlyAttribute { attr_span, span });
            }
            _ => {}
        }
    }

    /// Outputs an error for `#[allow_internal_unstable]` which can only be applied to macros.
    /// (Allows proc_macro functions)
    fn check_rustc_allow_const_fn_unstable(
        &self,
        hir_id: HirId,
        attr_span: Span,
        span: Span,
        target: Target,
    ) {
        match target {
            Target::Fn | Target::Method(_) => {
                if !self.tcx.is_const_fn(hir_id.expect_owner().to_def_id()) {
                    self.tcx.dcx().emit_err(errors::RustcAllowConstFnUnstable { attr_span, span });
                }
            }
            _ => {}
        }
    }

    fn check_deprecated(&self, hir_id: HirId, attr_span: Span, target: Target) {
        match target {
            Target::AssocConst | Target::Method(..) | Target::AssocTy
                if self.tcx.def_kind(self.tcx.local_parent(hir_id.owner.def_id))
                    == DefKind::Impl { of_trait: true } =>
            {
                self.tcx.emit_node_span_lint(
                    UNUSED_ATTRIBUTES,
                    hir_id,
                    attr_span,
                    errors::DeprecatedAnnotationHasNoEffect { span: attr_span },
                );
            }
            _ => {}
        }
    }

    fn check_macro_export(&self, hir_id: HirId, attr_span: Span, target: Target) {
        if target != Target::MacroDef {
            return;
        }

        // special case when `#[macro_export]` is applied to a macro 2.0
        let (_, macro_definition, _) = self.tcx.hir_node(hir_id).expect_item().expect_macro();
        let is_decl_macro = !macro_definition.macro_rules;

        if is_decl_macro {
            self.tcx.emit_node_span_lint(
                UNUSED_ATTRIBUTES,
                hir_id,
                attr_span,
                errors::MacroExport::OnDeclMacro,
            );
        }
    }

    fn check_lint_attr(&self, hir_id: HirId, sub_attrs: &[LintAttribute]) {
        for LintAttribute { attr_span, lint_instances, attr_style, .. } in sub_attrs {
            if !lint_instances.iter().any(|id| {
                id.lint_name() == sym::linker_messages || id.lint_name() == sym::linker_info
            }) {
                continue;
            };
            let note = if hir_id != CRATE_HIR_ID {
                match attr_style {
                    ast::AttrStyle::Outer => {
                        let attr_span = attr_span;
                        let bang_position = self
                            .tcx
                            .sess
                            .source_map()
                            .span_until_char(*attr_span, '[')
                            .shrink_to_hi();

                        self.tcx.emit_node_span_lint(
                            UNUSED_ATTRIBUTES,
                            hir_id,
                            *attr_span,
                            errors::OuterCrateLevelAttr {
                                suggestion: errors::OuterCrateLevelAttrSuggestion { bang_position },
                            },
                        )
                    }
                    ast::AttrStyle::Inner => self.tcx.emit_node_span_lint(
                        UNUSED_ATTRIBUTES,
                        hir_id,
                        *attr_span,
                        errors::InnerCrateLevelAttr,
                    ),
                };
                continue;
            } else {
                let never_needs_link = self
                    .tcx
                    .crate_types()
                    .iter()
                    .all(|kind| matches!(kind, CrateType::Rlib | CrateType::StaticLib));
                if never_needs_link {
                    errors::UnusedNote::LinkerMessagesBinaryCrateOnly
                } else {
                    continue;
                }
            };

            self.tcx.emit_node_span_lint(
                UNUSED_ATTRIBUTES,
                hir_id,
                *attr_span,
                errors::Unused { attr_span: *attr_span, note },
            );
        }
    }

    fn check_unused_attribute(&self, hir_id: HirId, attr: &Attribute) {
        // Warn on useless empty attributes.
        // FIXME(jdonszelmann): this lint should be moved to attribute parsing, see `AcceptContext::warn_empty_attribute`
        let note = if attr.has_any_name(&[sym::feature])
            && attr.meta_item_list().is_some_and(|list| list.is_empty())
        {
            errors::UnusedNote::EmptyList { name: attr.name().unwrap() }
        } else if attr.has_name(sym::default_method_body_is_const) {
            errors::UnusedNote::DefaultMethodBodyConst
        } else {
            return;
        };

        self.tcx.emit_node_span_lint(
            UNUSED_ATTRIBUTES,
            hir_id,
            attr.span(),
            errors::Unused { attr_span: attr.span(), note },
        );
    }

    /// A best effort attempt to create an error for a mismatching proc macro signature.
    ///
    /// If this best effort goes wrong, it will just emit a worse error later (see #102923)
    fn check_proc_macro(&self, hir_id: HirId, target: Target, kind: ProcMacroKind) {
        if target != Target::Fn {
            return;
        }

        let tcx = self.tcx;
        let Some(token_stream_def_id) = tcx.get_diagnostic_item(sym::TokenStream) else {
            return;
        };
        let Some(token_stream) = tcx.type_of(token_stream_def_id).no_bound_vars() else {
            return;
        };

        let def_id = hir_id.expect_owner().def_id;
        let param_env = ty::ParamEnv::empty();

        let infcx = tcx.infer_ctxt().build(TypingMode::non_body_analysis());
        let ocx = ObligationCtxt::new_with_diagnostics(&infcx);

        let span = tcx.def_span(def_id);
        let fresh_args = infcx.fresh_args_for_item(span, def_id.to_def_id());
        let sig = tcx.liberate_late_bound_regions(
            def_id.to_def_id(),
            tcx.fn_sig(def_id).instantiate(tcx, fresh_args),
        );

        let mut cause = ObligationCause::misc(span, def_id);
        let sig = ocx.normalize(&cause, param_env, sig);

        // proc macro is not WF.
        let errors = ocx.try_evaluate_obligations();
        if !errors.is_empty() {
            return;
        }

        let expected_sig = tcx.mk_fn_sig(
            std::iter::repeat_n(
                token_stream,
                match kind {
                    ProcMacroKind::Attribute => 2,
                    ProcMacroKind::Derive | ProcMacroKind::FunctionLike => 1,
                },
            ),
            token_stream,
            false,
            Safety::Safe,
            ExternAbi::Rust,
        );

        if let Err(terr) = ocx.eq(&cause, param_env, expected_sig, sig) {
            let mut diag = tcx.dcx().create_err(errors::ProcMacroBadSig { span, kind });

            let hir_sig = tcx.hir_fn_sig_by_hir_id(hir_id);
            if let Some(hir_sig) = hir_sig {
                match terr {
                    TypeError::ArgumentMutability(idx) | TypeError::ArgumentSorts(_, idx) => {
                        if let Some(ty) = hir_sig.decl.inputs.get(idx) {
                            diag.span(ty.span);
                            cause.span = ty.span;
                        } else if idx == hir_sig.decl.inputs.len() {
                            let span = hir_sig.decl.output.span();
                            diag.span(span);
                            cause.span = span;
                        }
                    }
                    TypeError::ArgCount => {
                        if let Some(ty) = hir_sig.decl.inputs.get(expected_sig.inputs().len()) {
                            diag.span(ty.span);
                            cause.span = ty.span;
                        }
                    }
                    TypeError::SafetyMismatch(_) => {
                        // FIXME: Would be nice if we had a span here..
                    }
                    TypeError::AbiMismatch(_) => {
                        // FIXME: Would be nice if we had a span here..
                    }
                    TypeError::VariadicMismatch(_) => {
                        // FIXME: Would be nice if we had a span here..
                    }
                    _ => {}
                }
            }

            infcx.err_ctxt().note_type_err(
                &mut diag,
                &cause,
                None,
                Some(param_env.and(ValuePairs::PolySigs(ExpectedFound {
                    expected: ty::Binder::dummy(expected_sig),
                    found: ty::Binder::dummy(sig),
                }))),
                terr,
                false,
                None,
            );
            diag.emit();
            self.abort.set(true);
        }

        let errors = ocx.evaluate_obligations_error_on_ambiguity();
        if !errors.is_empty() {
            infcx.err_ctxt().report_fulfillment_errors(errors);
            self.abort.set(true);
        }
    }

    fn check_rustc_pub_transparent(&self, attr_span: Span, span: Span, attrs: &[Attribute]) {
        if !find_attr!(attrs, Repr { reprs, .. } => reprs.iter().any(|(r, _)| r == &ReprAttr::ReprTransparent))
            .unwrap_or(false)
        {
            self.dcx().emit_err(errors::RustcPubTransparent { span, attr_span });
        }
    }

    fn check_rustc_force_inline(&self, hir_id: HirId, attrs: &[Attribute], target: Target) {
        if let (Target::Closure, None) = (
            target,
            find_attr!(attrs, Inline(InlineAttr::Force { attr_span, .. }, _) => *attr_span),
        ) {
            let is_coro = matches!(
                self.tcx.hir_expect_expr(hir_id).kind,
                hir::ExprKind::Closure(hir::Closure {
                    kind: hir::ClosureKind::Coroutine(..) | hir::ClosureKind::CoroutineClosure(..),
                    ..
                })
            );
            let parent_did = self.tcx.hir_get_parent_item(hir_id).to_def_id();
            let parent_span = self.tcx.def_span(parent_did);

            if let Some(attr_span) = find_attr!(
                self.tcx, parent_did,
                Inline(InlineAttr::Force { attr_span, .. }, _) => *attr_span
            ) && is_coro
            {
                self.dcx().emit_err(errors::RustcForceInlineCoro { attr_span, span: parent_span });
            }
        }
    }

    fn check_mix_no_mangle_export(&self, hir_id: HirId, attrs: &[Attribute]) {
        if let Some(export_name_span) =
            find_attr!(attrs, ExportName { span: export_name_span, .. } => *export_name_span)
            && let Some(no_mangle_span) =
                find_attr!(attrs, NoMangle(no_mangle_span) => *no_mangle_span)
        {
            let no_mangle_attr = if no_mangle_span.edition() >= Edition::Edition2024 {
                "#[unsafe(no_mangle)]"
            } else {
                "#[no_mangle]"
            };
            let export_name_attr = if export_name_span.edition() >= Edition::Edition2024 {
                "#[unsafe(export_name)]"
            } else {
                "#[export_name]"
            };

            self.tcx.emit_node_span_lint(
                lint::builtin::UNUSED_ATTRIBUTES,
                hir_id,
                no_mangle_span,
                errors::MixedExportNameAndNoMangle {
                    no_mangle_span,
                    export_name_span,
                    no_mangle_attr,
                    export_name_attr,
                },
            );
        }
    }

    fn check_loop_match(&self, hir_id: HirId, attr_span: Span, target: Target) {
        let node_span = self.tcx.hir_span(hir_id);

        if !matches!(target, Target::Expression) {
            return; // Handled in target checking during attr parse
        }

        if !matches!(self.tcx.hir_expect_expr(hir_id).kind, hir::ExprKind::Loop(..)) {
            self.dcx().emit_err(errors::LoopMatchAttr { attr_span, node_span });
        };
    }

    fn check_const_continue(&self, hir_id: HirId, attr_span: Span, target: Target) {
        let node_span = self.tcx.hir_span(hir_id);

        if !matches!(target, Target::Expression) {
            return; // Handled in target checking during attr parse
        }

        if !matches!(self.tcx.hir_expect_expr(hir_id).kind, hir::ExprKind::Break(..)) {
            self.dcx().emit_err(errors::ConstContinueAttr { attr_span, node_span });
        };
    }
}

impl<'tcx> Visitor<'tcx> for CheckAttrVisitor<'tcx> {
    type NestedFilter = nested_filter::OnlyBodies;

    fn maybe_tcx(&mut self) -> Self::MaybeTyCtxt {
        self.tcx
    }

    fn visit_item(&mut self, item: &'tcx Item<'tcx>) {
        // Historically we've run more checks on non-exported than exported macros,
        // so this lets us continue to run them while maintaining backwards compatibility.
        // In the long run, the checks should be harmonized.
        if let ItemKind::Macro(_, macro_def, _) = item.kind {
            let def_id = item.owner_id.to_def_id();
            if macro_def.macro_rules && !find_attr!(self.tcx, def_id, MacroExport { .. }) {
                check_non_exported_macro_for_invalid_attrs(self.tcx, item);
            }
        }

        let target = Target::from_item(item);
        self.check_attributes(item.hir_id(), item.span, target, Some(ItemLike::Item(item)));
        intravisit::walk_item(self, item)
    }

    fn visit_where_predicate(&mut self, where_predicate: &'tcx hir::WherePredicate<'tcx>) {
        self.check_attributes(
            where_predicate.hir_id,
            where_predicate.span,
            Target::WherePredicate,
            None,
        );
        intravisit::walk_where_predicate(self, where_predicate)
    }

    fn visit_generic_param(&mut self, generic_param: &'tcx hir::GenericParam<'tcx>) {
        let target = Target::from_generic_param(generic_param);
        self.check_attributes(generic_param.hir_id, generic_param.span, target, None);
        intravisit::walk_generic_param(self, generic_param)
    }

    fn visit_trait_item(&mut self, trait_item: &'tcx TraitItem<'tcx>) {
        let target = Target::from_trait_item(trait_item);
        self.check_attributes(trait_item.hir_id(), trait_item.span, target, None);
        intravisit::walk_trait_item(self, trait_item)
    }

    fn visit_field_def(&mut self, struct_field: &'tcx hir::FieldDef<'tcx>) {
        self.check_attributes(struct_field.hir_id, struct_field.span, Target::Field, None);
        intravisit::walk_field_def(self, struct_field);
    }

    fn visit_arm(&mut self, arm: &'tcx hir::Arm<'tcx>) {
        self.check_attributes(arm.hir_id, arm.span, Target::Arm, None);
        intravisit::walk_arm(self, arm);
    }

    fn visit_foreign_item(&mut self, f_item: &'tcx ForeignItem<'tcx>) {
        let target = Target::from_foreign_item(f_item);
        self.check_attributes(f_item.hir_id(), f_item.span, target, Some(ItemLike::ForeignItem));
        intravisit::walk_foreign_item(self, f_item)
    }

    fn visit_impl_item(&mut self, impl_item: &'tcx hir::ImplItem<'tcx>) {
        let target = target_from_impl_item(self.tcx, impl_item);
        self.check_attributes(impl_item.hir_id(), impl_item.span, target, None);
        intravisit::walk_impl_item(self, impl_item)
    }

    fn visit_stmt(&mut self, stmt: &'tcx hir::Stmt<'tcx>) {
        // When checking statements ignore expressions, they will be checked later.
        if let hir::StmtKind::Let(l) = stmt.kind {
            self.check_attributes(l.hir_id, stmt.span, Target::Statement, None);
        }
        intravisit::walk_stmt(self, stmt)
    }

    fn visit_expr(&mut self, expr: &'tcx hir::Expr<'tcx>) {
        let target = match expr.kind {
            hir::ExprKind::Closure { .. } => Target::Closure,
            _ => Target::Expression,
        };

        self.check_attributes(expr.hir_id, expr.span, target, None);
        intravisit::walk_expr(self, expr)
    }

    fn visit_expr_field(&mut self, field: &'tcx hir::ExprField<'tcx>) {
        self.check_attributes(field.hir_id, field.span, Target::ExprField, None);
        intravisit::walk_expr_field(self, field)
    }

    fn visit_variant(&mut self, variant: &'tcx hir::Variant<'tcx>) {
        self.check_attributes(variant.hir_id, variant.span, Target::Variant, None);
        intravisit::walk_variant(self, variant)
    }

    fn visit_param(&mut self, param: &'tcx hir::Param<'tcx>) {
        self.check_attributes(param.hir_id, param.span, Target::Param, None);

        intravisit::walk_param(self, param);
    }

    fn visit_pat_field(&mut self, field: &'tcx hir::PatField<'tcx>) {
        self.check_attributes(field.hir_id, field.span, Target::PatField, None);
        intravisit::walk_pat_field(self, field);
    }
}

fn is_c_like_enum(item: &Item<'_>) -> bool {
    if let ItemKind::Enum(_, _, ref def) = item.kind {
        for variant in def.variants {
            match variant.data {
                hir::VariantData::Unit(..) => { /* continue */ }
                _ => return false,
            }
        }
        true
    } else {
        false
    }
}

fn check_non_exported_macro_for_invalid_attrs(tcx: TyCtxt<'_>, item: &Item<'_>) {
    let attrs = tcx.hir_attrs(item.hir_id());

    if let Some(attr_span) =
        find_attr!(attrs, Inline(i, span) if !matches!(i, InlineAttr::Force{..}) => *span)
    {
        tcx.dcx().emit_err(errors::NonExportedMacroInvalidAttrs { attr_span });
    }
}

fn check_mod_attrs(tcx: TyCtxt<'_>, module_def_id: LocalModDefId) {
    let check_attr_visitor = &mut CheckAttrVisitor { tcx, abort: Cell::new(false) };
    tcx.hir_visit_item_likes_in_module(module_def_id, check_attr_visitor);
    if module_def_id.to_local_def_id().is_top_level_module() {
        check_attr_visitor.check_attributes(CRATE_HIR_ID, DUMMY_SP, Target::Mod, None);
    }
    if check_attr_visitor.abort.get() {
        tcx.dcx().abort_if_errors()
    }
}

pub(crate) fn provide(providers: &mut Providers) {
    *providers = Providers { check_mod_attrs, ..*providers };
}

fn doc_fake_variadic_is_allowed_self_ty(self_ty: &hir::Ty<'_>) -> bool {
    matches!(&self_ty.kind, hir::TyKind::Tup([_]))
        || if let hir::TyKind::FnPtr(fn_ptr_ty) = &self_ty.kind {
            fn_ptr_ty.decl.inputs.len() == 1
        } else {
            false
        }
        || (if let hir::TyKind::Path(hir::QPath::Resolved(_, path)) = &self_ty.kind
            && let Some(&[hir::GenericArg::Type(ty)]) =
                path.segments.last().map(|last| last.args().args)
        {
            doc_fake_variadic_is_allowed_self_ty(ty.as_unambig_ty())
        } else {
            false
        })
}