AUDIT_LOG_USER_AVC_MESSAGE(3)

💖 AUDIT_LOG_USER_AVC_MESSAGE(3) 💖

okay so bestie, we're in the Linux Audit API section of the manual, and today's main character is audit_log_user_avc_message 🎀 she lives in libaudit and she is literally the girl who files the report.

---

✨ NAME ✨

audit_log_user_avc_message — log a user avc message 🦋

---

🌸 SYNOPSIS 🌸

#include <libaudit.h>

int
audit_log_user_avc_message(intaudit_fd,int"type,constchar*"message,constchar*"hostname,constchar*"addr,constchar*"tty,uid_t"auid);"

not me copying that signature exactly as the page has it 💀 yes the spacing/quoting is giving typo energy, but we do not edit the sacred text, periodt.

---

💅 DESCRIPTION 💅

So here's the vibe: this function logs a message to the audit system using a predefined message format ✨ no cap. And who should be using her? all apps that are SE Linux object managers — like, if that's you, this is your girl, you're not doing it any other way 💁‍♀️

The function parameters are as follows:

• audit_fd — the fd returned by audit_open 🔑
• type — type of message, ex: AUDIT_USER_AVC
• message — the message being sent 📨
• hostname — the hostname if known
• addr — the network address of the user 🌐
• tty — the tty of the user, if NULL will attempt to figure out 🖥️
• auid — the auid of the person related to the avc message

These values should correspond to who the message is about. 👑 like, keep it accurate, the audit log is not a place for guessing games.

---

🫶 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 — go look, bestie, the answer is in there 🔍

---

🌈 SEE ALSO 🌈

• audit_log_user_message(3)
• audit_log_acct_message(3)
• audit_log_user_comm_message(3)
• audit_log_semanage_message(3)

the whole friend group, honestly 💜

---

⭐ AUTHOR ⭐

Steve Grubb 👑

---

and that's the page!! source/version situation: Red Hat, Oct 2006, and the manual page name is AUDIT_LOG_USER_AVC_MESSAGE(3) — mwah, iconic, no notes 💅✨💖