Net::Daemon::Log(3pm)

💖 Net::Daemon::Log — the vibes ✨

okay so bestie, quick intro before we dive: this is Net::Daemon::Log, and it's literally just a little utility squad for logging. That's the whole gig. Logging messages, but portable logging messages, so you're not stuck rewriting everything depending on which OS you woke up on. 🫶

---

✨ SYNOPSIS ✨

okay here's the group chat receipts, copy them exactly bestie:

# Choose logging method: syslog or Win32::EventLog
$self->{'facility'} = 'mail'; # Default: Daemon
$self->{'logfile'} = undef;   # Default

# Choose logging method: stderr
$self->{'logfile'} = 1;

# Choose logging method: IO handle
my $file = IO::File->new("my.log", "a");
$self->{'logfile'} = $file;

# Debugging messages (equivalent):
$self->Log('debug', "This is a debugging message");
$self->Debug("This is a debugging message");

# Error messages (equivalent):
$self->Log('err', "This is an error message");
$self->Error("This is an error message");

# Fatal error messages (implies 'die')
$self->Fatal("This is a fatal error message");

---

🌸 DESCRIPTION 🌸

Net::Daemon::Log is a utility class for portable logging messages. Like, that's its whole personality and honestly? Iconic. By default it uses syslog on Unix, or Win32::EventLog on Windows — but if you want, you can redirect those logging messages to stderr or to a log file instead. Your call, bestie. 💅

🦋 Generic Logging

$self->Log($level, $msg, @args);

This right here is the generic interface, the main character. The logging level is in syslog style, so it's one of these words: 'debug', 'info', 'notice', 'err' or 'crit'. ngl you'll rarely need info and notice, and bestie I can hardly imagine a reason for crit (critical). In 95% of all cases debug and err will be sufficient. That's it. That's the whole level situation. ✨

The logging string $msg is a format string similar to printf.

🎀 Utility methods

$self->Debug($msg, @args);
$self->Error($msg, @args);
$self->Fatal($msg, @args);

These are basically replacements for logging with the levels debug and err. The difference between the latter two — so Error vs Fatal, bestie, keep up 💖 — is that Fatal includes throwing a Perl exception. So yeah, Fatal is the dramatic one. It's giving main character energy, as it should.

🧚 Choosing a logging target

By default, logging will happen to syslog (Unix) or EventLog (Windows). But you absolutely may choose logging to stderr by setting:

$self->{'logfile'} = 1;

This is required if neither syslog nor EventLog is available. Lowkey important, don't skip it. 🙈

An alternative option is setting:

$self->{'logfile'} = $handle;

where $handle is any object supporting a print method, for example an IO::Handle object. Usually the logging target is chosen as soon as you call $self->Log() the first time. However, you may force choosing the target by doing a:

$self->OpenLog();

before calling Log the first time. So if you wanna be proactive about it, that's your move. 🌟

---

💀 MULTITHREADING 💀

okay this part is a little "it depends" and I need you to hear me out. The multithreading capabilities of this class are depending heavily on the underlying classes Sys::Syslog, Win32::EventLog or IO::Handle. So like — if they're thread safe, you can well assume that this package is too. fr fr. 🔥

✨ The one exception bestie: you should better call $self->OpenLog() before threading. Like, before. Not during. Before. 🫶

---

👑 AUTHOR AND COPYRIGHT 👑

copying this exactly because legal stuff stays untouched even when the vibes are immaculate:

Net::Daemon is Copyright (C) 1998, Jochen Wiedmann
                                   Am Eisteich 9
                                   72555 Metzingen
                                   Germany

                                   Phone: +49 7123 14887
                                   Email: joe@ispsoft.de

All rights reserved.

You may distribute this package under the terms of either the GNU
General Public License or the Artistic License, as specified in the
Perl README file.

All rights reserved, periodt. 💅

---

🌈 SEE ALSO 🌈

• Net::Daemon(3)
• Sys::Syslog(3)
• Win32::EventLog(3)
• IO::Handle(3)

go read those too bestie, they're the supporting cast and they ate. ⭐

---

and that's the whole page!! 🎀 this was perl v5.40.1, dated 2026-05-06, and you just read Net::Daemon::Log(3pm) — log responsibly, hydrate, and call $self->OpenLog() before you thread. mwah 💖🦋✨