media_entit...e_pad_unique(9)

📦 version 7.3.1, in nixpkgs unstable

💅 media_entity_remote_source_pad_unique(9) — Kernel API Manual 🎀

okay bestie, welcome to the Kernel API Manual, this one's a media-entity situation and honestly she's giving very functional, very single-source, very "we don't do chaos here" ✨

🌸 NAME 🌸

media_entity_remote_source_pad_unique — find a remote source pad that's connected to an entity, and like... make sure there's exactly one of them. no drama, no duplicates 💅

🦋 SYNOPSIS 🦋

struct media_pad * media_entity_remote_source_pad_unique (const struct media_entity *entity );

🎀 ARGUMENTS 🎀

  • entity — the entity. that's it. that's the argument. she's the main character here 👑

✨ DESCRIPTION ✨

So what she does is: she searches for a remote source pad that's connected to entity through an enabled link, and she returns it. 🫶

But here's the vibe check, and listen closely babe — if multiple remote pads match those criteria, or none do, you get an error back. no "close enough", no "pick a favourite". it's all or nothing, periodt 💀

The whole uniqueness constraint is literally the point — it's what makes this helper function suitable for entities that only support a single active source at a time. icon behaviour, honestly. one source. one queen. no sharing. ✨

  • -ENOTUNIQ — multiple links are enabled. too many besties showed up 😭
  • -ENOLINK — no connected pad found. the group chat is empty 💔

🔥 RETURN 🔥

A pointer to the remote pad, or one of the following error pointers if an error occurs:

bestie please always check the return value — she can come back as an error pointer and that is not a pad, no cap 🙈

👑 SEE ALSO 👑

Kernel file ./include/media/media-entity.h — and omg the whole extended universe shows up in this one, it's giving crossover episode 🌈

fr fr that's the whole list, don't come for me, I didn't pick them 💀

okay and last thing bestie, the cute little sign-off: this page lives in ./include/media, dated October 2026, and it's all about media_entity_remote_source_pad_unique(9). go find your one true source pad, ily 🧚💜

📦 where this page comes from