arm_smmu_invs_purge(9)

📦 version 7.3.1, in nixpkgs unstable

💅 arm_smmu_invs_purge — Kernel API Manual ✨

okay so bestie, welcome to the <rainbow>arm_smmu_invs_purge(9)</rainbow> glow-up page — it's a kernel API manual entry and honestly it's giving "tiny function, big responsibilities" energy 🎀

🌸 NAME 🌸

arm_smmu_invs_purge — bestie, this one literally purges all the trash entries in the @invs 🗑️✨ no cap, that's the whole vibe.

✨ SYNOPSIS ✨

VISIBLE_IF_KUNIT struct arm_smmu_invs * arm_smmu_invs_purge (struct arm_smmu_invs *invs );

yep, that's the whole signature. VISIBLE_IF_KUNIT included, we do NOT skip the macro around here 💅

🦋 ARGUMENTS 🦋

  • invs — the base invalidation array. that's it, that's the argument. she's the main character of this function 🫶

💖 RETURN 💖

so like, on success you get a newly allocated array with all the trash entries removed — slay, clean, iconic 👑

but also, it returns NULL in two very specific situations, and we're not skipping these:

  • if there is no trash entry in the array at all, or
  • if the allocation failed 😭

either way: NULL. don't come for her, she's just being honest.

🔥 DESCRIPTION 🔥

okay so here's where the ground rules live, and you need these, bestie:

this function must be locked and serialized with arm_smmu_invs_merge and arm_smmu_invs_unref — like, all three of them, same lock energy, no cutting corners 🔒

but — and this is the fun little exception — do not lockdep on any lock for KUNIT test. that's the rule, okay? KUNIT gets a pass 🙈

and the part everyone forgets: the caller is responsible for freeing the invs and the returned new one. both of them. not one. both. free your stuff, bestie, the kernel is not your mom 💀

🧚 SEE ALSO 🧚

go read those too, iykyk 💜

okay and finally, the credits because we always give credit 🎀 this page lives under ./drivers/iommu/arm/arm-smmu-v3, dated October 2026, and the manual title is <pink>arm_smmu_invs_purge(9)</pink>. that's the whole footer, folded into a cute little sign-off. periodt. 💅✨🌸

📦 where this page comes from