dlog.h(3)

dlog.h(3) — the Library Functions Manual, but make it cute ✨

okay so bestie, welcome to dlog.h(3) 💖 this is the manual page from the Library Functions Manual, and it's literally all about libdaemon's logging header. no cap, this thing is the blueprint for making your daemon actually tell you what it's doing. let's get into it 🫶

---

🌸 NAME 🌸

dlog.h — Contains a robust API for logging messages.

that's it. that's the name section. a header, containing a robust API, for logging messages. iconic, honestly.

---

✨ SYNOPSIS ✨

#include <syslog.h>
#include <stdarg.h>

🎀 Macros 🎀

• #define DAEMON_GCC_PRINTF_ATTR(a, b) — A macro for making use of GCCs printf compilation warnings.
• #define DAEMON_LOGV_AVAILABLE 1 — This variable is defined to 1 iff daemon_logv() is supported.
• #define DAEMON_SET_VERBOSITY_AVAILABLE 1 — This variable is defined to 1 iff daemon_set_verbosity() is available.

🦋 Enumerations 🦋

• enum daemon_log_flags { DAEMON_LOG_SYSLOG = 1, DAEMON_LOG_STDERR = 2, DAEMON_LOG_STDOUT = 4, DAEMON_LOG_AUTO = 8 } — Specifies where to send the log messages to.

⭐ Functions ⭐

• void daemon_log (int prio, const char *t,...) DAEMON_GCC_PRINTF_ATTR(2 — Log a message using printf format strings using the specified syslog priority.
• void daemon_logv (int prio, const char *t, va_list ap) — Same as daemon_log(), but without variadic arguments.
• char * daemon_ident_from_argv0 (char *argv0) — Return a sensible syslog identification for daemon_log_ident generated from argv[0].
• void daemon_set_verbosity (int verbosity_prio) — Setter for the verbosity level of standard output.

💜 Variables 💜

• enum daemon_log_flags daemon_log_use — This variable is used to specify the log target(s) to use.
• const char * daemon_log_ident — Specifies the syslog identification, use daemon_ident_from_argv0() to set this to a sensible value or generate your own.

---

🔥 Detailed Description 🔥

Contains a robust API for logging messages.

Definition in file dlog.h.

---

🌈 Macro Definition Documentation 🌈

#define DAEMON_GCC_PRINTF_ATTR(a, b)

A macro for making use of GCCs printf compilation warnings.

Definition at line 59 of file dlog.h.

#define DAEMON_LOGV_AVAILABLE 1

This variable is defined to 1 iff daemon_logv() is supported.

Since

0.11

See also

daemon_logv()

Definition at line 72 of file dlog.h.

#define DAEMON_SET_VERBOSITY_AVAILABLE 1

This variable is defined to 1 iff daemon_set_verbosity() is available.

Since

0.14

See also

daemon_set_verbosity()

Definition at line 92 of file dlog.h.

---

💅 Enumeration Type Documentation 💅

enum daemon_log_flags

Specifies where to send the log messages to. The global variable daemon_log_use takes values of this type.

Enumerator

• DAEMON_LOG_SYSLOG — Log messages are written to syslog.
• DAEMON_LOG_STDERR — Log messages are written to STDERR.
• DAEMON_LOG_STDOUT — Log messages are written to STDOUT.
• DAEMON_LOG_AUTO — If this is set a daemon_fork() will change this to DAEMON_LOG_SYSLOG in the daemon process.

Definition at line 38 of file dlog.h.

---

🦋 Function Documentation 🦋

char * daemon_ident_from_argv0 (char * argv0)

Return a sensible syslog identification for daemon_log_ident generated from argv[0]. This will return a pointer to the file name of argv[0], i.e. strrchr(argv[0], '\')+1

Parameters

• argv0 — argv[0] as passed to main()

Returns

The identification string

Examples

testd.c.

void daemon_log (int prio, const char * t, ...)

Log a message using printf format strings using the specified syslog priority.

Parameters

• prio — The syslog priority (PRIO_xxx constants)
• t,... — The text message to log

Examples

testd.c.

void daemon_logv (int prio, const char * t, va_list ap)

Same as daemon_log(), but without variadic arguments.

Since

0.11

See also

DAEMON_LOGV_AVAILABLE

void daemon_set_verbosity (int verbosity_prio)

Setter for the verbosity level of standard output.

Parameters

• verbosity_prio — Minimum priority level for messages to output on standard output/error

Allows to decide which messages to output on standard output/error streams. All messages are logged to syslog and this setting does not influence that.

The default value is LOG_WARNING.

Since

0.14

See also

DAEMON_SET_VERBOSITY_AVAILABLE

---

💖 Variable Documentation 💖

const char* daemon_log_ident [extern]

Specifies the syslog identification, use daemon_ident_from_argv0() to set this to a sensible value or generate your own.

Examples

testd.c.

enum daemon_log_flags daemon_log_use [extern]

This variable is used to specify the log target(s) to use. Defaults to DAEMON_LOG_STDERR|DAEMON_LOG_AUTO

---

👑 Author 👑

Generated automatically by Doxygen for libdaemon from the source code.

---

aaaand that's the whole page bestie 🫶 no notes, we ate. this was libdaemon, Version 0.14, serving you dlog.h(3) realness. go log something, you've got this 💜✨