ssam_nfblk_call_chain(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ssam_nfblk_call_chain — the kernel API manual page, but make it make sense

okay so bestie, welcome to ssam_nfblk_call_chain(9) from the Kernel API Manual ✨ this is the notifier-chain girlie and she is so important, so let's get into it.

🌸 NAME

ssam_nfblk_call_chain — call event notifier callbacks of the given chain. that's it. that's the job. she calls the callbacks, no cap 💅

✨ SYNOPSIS

int ssam_nfblk_call_chain (struct ssam_nf_head *nh , struct ssam_event *event );

like, she takes two things and gives you back an int. iconic behavior honestly 🫶

🎀 ARGUMENTS

  • nh — the notifier head for which the notifier callbacks should be called. so this is the chain you're about to ring up 📞
  • event — the event data provided to the callbacks. this is the little care package every callback gets handed 🎁

🦋 DESCRIPTION

Call all registered notifier callbacks in order of their priority until either no notifier is left or a notifier returns a value with the SSAM_NOTIF_STOP bit set. sooo it's a priority-ordered roll call and the first one to hit STOP shuts the whole thing down, periodt.

⚠️ note that this bit is automatically set via ssam_notifier_from_errno on any non-zero error value. so like, an error basically slams the brakes for you, no extra work required 😭

💖 RETURN

Returns the notifier status value, which contains the notifier status bits (SSAM_NOTIF_HANDLED and SSAM_NOTIF_STOP) as well as a potential error value returned from the last executed notifier callback.

so it's a little combo platter, bestie 🍓 if you actually want the raw error back, use ssam_notifier_to_errno to convert this value to the original error value. iykyk 💅

🌈 SEE ALSO

first up, the source file herself:

  • Kernel file ./drivers/platform/surface/aggregator/controller.c

and now the extended friend group, literally all of them, in order 👑

💀 yes that's genuinely the whole list, i counted, every single one is here, don't come for me

and that's the page, bestie 🧚 this one shipped out of ./drivers/platform/surface/agg... in October 2026 — mwah, slay, go call your callbacks in priority order 💜

📦 where this page comes from