Sisima...Control(3pm)

💖 Sisima...Control — the Sisimai::Lhost::SurfControl era 💖

okay bestie, sit down, hydrate, and let me tell you about this little 3pm manual page, because it's a whole vibe. this is the User Contributed Perl Documentation, and today's main character is a bounce mail parser class. yes, a parser. yes, it's iconic. 🦋

---

✨ NAME ✨

Sisimai::Lhost::SurfControl — it's the bounce mail parser class for "SurfControl". that's it, that's the name, no notes. 💅

---

✨ SYNOPSIS ✨

the way you summon it is literally just:

use Sisimai::Lhost::SurfControl;

one line. that's the whole ritual. slay. 🎀

---

✨ DESCRIPTION ✨

so Sisimai::Lhost::SurfControl parses a bounce email which was created by "WebSense SurfControl". like, it reads the sad little "your mail bounced" message and makes sense of it. 🫶

and here's the thing, bestie — the methods in this module are only called from Sisimai::Message. you don't just walk up and call them yourself, okay? they get called for you. it's giving "I don't do the talking, my manager does." 👑

---

✨ CLASS METHODS ✨

🌸 "description()"

description() returns the description string of this module. so cute, so simple.

print Sisimai::Lhost::SurfControl->description;

look at that. one line. print it. done. ✨

🌸 "inquire(header data, reference to body string)"

inquire() method parses a bounced email and returns the results as an array reference. 📬

if you want the whole tea on how that works, go read Sisimai::Message for more details — that's where the full story lives. iykyk. 💜

---

✨ AUTHOR ✨

azumakuniyuki — the legend, the moment, the author. 👑

---

✨ COPYRIGHT ✨

Copyright (C) 2014-2021,2023 azumakuniyuki, All rights reserved. 🎀

---

✨ LICENSE ✨

This software is distributed under The BSD 2-Clause License. free, legal, and honestly kind of generous of them. 🌈

---

okay so that's the whole page, and now the cute sign-off: this beauty is from perl v5.38.2, dated 2024-03-03, and it lives under the Sisima...Control(3pm) header. no cap, that's the whole thing. bye bestie, go parse some bounces. 💖🦋💅