POE::R...xtrefs(3pm)

✨ POE::Resource::Extrefs ✨

okay bestie, welcome to POE::Resource::Extrefs — the internal reference counts manager for POE::Kernel. She's from the User Contributed Perl Documentation collection, and she is, and I cannot stress this enough, not for you. She's for the Kernel. The Kernel only. 💅

---

🌸 NAME 🌸

POE::Resource::Extrefs — internal reference counts manager for POE::Kernel.

Like. That's the whole job. She counts refs. She's the accountant in the back office. 🧾

---

🎀 SYNOPSIS 🎀

There is no public API.

That's it. That's the synopsis. Not me being lazy, that's genuinely the whole thing. No public API, no little example block, no nothing. The synopsis is just the void staring back at you. 😭

---

🦋 DESCRIPTION 🦋

Okay so here's the tea. POE::Resource::Extrefs is a mix-in class for POE::Kernel.

What does she do? She provides the features to manage session reference counts — and specifically the ones that applications may actually use. So like, the refs that normal humans touch. Not the secret internal ones. Those are somebody else's problem.

And then the key bit: POE::Resource::Extrefs is used internally by POE::Kernel, so it has no public interface.

Translating for the girlies: she's backstage. She's the stagehand. You will never call her directly, and honestly? She doesn't want you to. 🫶

---

🌈 SEE ALSO 🌈

• See "Public Reference Counters" in POE::Kernel for the public extref API. That's where the actual usable stuff lives, go there bestie. ✨
• See "Resources" in POE::Kernel for public information about POE resources. The lore. The worldbuilding. 👑
• See POE::Resource for general discussion about resources and the classes that manage them. The meta-narrative, if you will. 💜

---

💀 BUGS 💀

Ooh okay, real talk time, this one's juicy.

Reference counters have no ownership information. Which means one entity's reference counts may conflict with another's. Two sessions walk into a bar, both think the ref count is theirs, and now nobody knows who's holding the bag. 😭

But — and this is the good part — this is usually not a problem if all entities behave.

So basically: it's fine as long as everyone's a well-behaved little angel. The moment somebody starts acting up? Chaos. Absolute chaos. Main character energy from a ref counter that was never supposed to have any. 🙈

---

🍓 AUTHORS & COPYRIGHTS 🍓

Please see POE for more information about authors and contributors. That's where the credits live — I'm not about to list a whole cast when the manpage just points you at the main POE page, periodt. 💖

---

and that's the whole page, no cap. you read a manpage about a class with no public API and honestly? iconic of you. 🌟

this was perl v5.34.0, dated 2022-03-25, delivered to you by User Contributed Perl Documentation. mwah, go call POE::Kernel instead, love u bye 💅🦋🌸