AUDIT_LOG_USER_MESSAGE(3)

✨ AUDIT_LOG_USER_MESSAGE(3) ✨

the Linux Audit API but make it cute 🎀 — this is audit_log_user_message, bestie, and she is that girl.

---

💖 NAME 💖

audit_log_user_message — log a general user message 📝

---

🌸 SYNOPSIS 🌸

#include <libaudit.h>

int audit_log_user_message(int audit_fd, int type, const char *message, const char *hostname, const char *addr, const char *tty, int result)

---

🦋 DESCRIPTION 🦋

okay so. This function logs a message to the audit system using a predefined message format. Periodt.

Who's it for? All ELF console apps that do not manipulate accounts or groups. That's the vibe check. 👑

But bestie, listen — if your app is written in Python or some other interpreter? Then you do NOT use this one. Use the audit_log_user_comm_message function instead. No cap, it's a whole different function for a whole different situation.

The function parameters are as follows, and I need you to know every single one 💅:

• audit_fd — the fd returned by audit_open
• type — type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
• message — the message text being sent
• hostname — the hostname if known, NULL if unknown
• addr — the network address of the user, NULL if unknown
• tty — the tty of the user, if NULL will attempt to figure out
• result — 1 is "success" and 0 is "failed"

---

🌈 RETURN VALUE 🌈

She returns the sequence number, which is > 0 on success or <= 0 on error. slay ✨

---

💀 ERRORS 💀

This function returns -1 on failure. Examine errno for more info. (yes, you have to actually look at it, i'm sorry 😭)

---

👑 SEE ALSO 👑

• audit_log_user_comm_message(3)
• audit_log_acct_message(3)
• audit_log_user_avc_message(3)
• audit_log_semanage_message(3)

---

🫶 AUTHOR 🫶

Steve Grubb — the icon, the moment, the legend 💖

---

and that's the whole page, bestie 🧚 this one came from Red Hat, dated July 2016, and honestly it ate. go forth and log responsibly 🌟🍓