Messag...ileTail(3pm)

💖 Message::Passing::Input::FileTail 💖

okay bestie, so this is a Perl module from the Message::Passing family — it's the file tailing input one, i.e. you point it at a file and it goes 👀 at the end of it forever. It's Message::Passing::Input::FileTail, and it lives in the 3pm section of the manual (that's the Perl module docs section, iykyk). Let's get into it fr fr 🦋

---

✨ SYNOPSIS ✨

message-pass --input FileTail --input_options '{"filename": "/var/log/foo.log"} --output STDOUT
{"filename":"/var/log/foo.log","message":"example line","hostname":"www.example.com","epochtime":"1346705476","type":"log_line"}

so the first line is you calling message-pass, setting --input to FileTail, passing your --input_options as JSON (with the filename key, here /var/log/foo.log), and dumping it all out to --output STDOUT. And the second line is what a message looks like when it comes out the other side — a whole little hash of data with filename, message, hostname, epochtime and type set to log_line. cute right? 🌸

---

🌈 DESCRIPTION 🌈

no cap, the DESCRIPTION section is literally empty. the attributes are where all the actual tea is, so scroll down 💅

---

🎀 ATTRIBUTES 🎀

filename

the filename of the file you wanna tail. that's it, that's the whole vibe. give it a path, it watches the end of that file 🫶

raw

if the file data should be output raw — as in, just a line, plain and simple. normally though, lines get output as a hash of data, with all those fields you saw in the SYNOPSIS (filename, message, hostname, epochtime, type). so set raw when you want the bare line and not the whole lil hash situation ✨

---

👑 SEE ALSO 👑

• Message::Passing — the parent vibe, go read that one too bestie

---

💜 SPONSORSHIP 💜

this module literally exists because of the wonderful people at Suretec Systems Ltd. <http://www.suretecsystems.com/> — they sponsored its development for their VoIP division called SureVoIP <http://www.surevoip.co.uk/>, for use with the SureVoIP API — <http://www.surevoip.co.uk/support/wiki/api_documentation>. shoutout to them, absolute icons 🫶✨

---

📜 AUTHOR, COPYRIGHT AND LICENSE 📜

see Message::Passing. that's the whole section, they said go look over there 💀 (affectionate)

---

real talk: this page is short but every detail counts, so don't sleep on filename and raw — those are your only two knobs 🔥

---

and that's the whole page bestie!! 🌟 this one came from perl v5.32.1, dated 2021-11-09, and it's part of the User Contributed Perl Documentation — so like, it's giving community-coded, and we love that for it 💖 mwah, go tail some files 🦋💅