AUDIT_LOG_USER_COMMAND(3)

💖 AUDIT_LOG_USER_COMMAND(3) 💖

okay bestie, welcome to the AUDIT_LOG_USER_COMMAND page, part of the Linux Audit API ✨ this is literally the manual page you're looking for, and we're gonna get through it together, no cap 🫶

---

🌸 NAME 🌸

audit_log_user_command — log a user command 💅

---

✨ SYNOPSIS ✨

#include <libaudit.h>

int
audit_log_user_command(intaudit_fd,int"type,constchar*"command,constchar*"tty,int"result);"

(yes, that's the signature exactly as the page gives it — we do not editorialize on the classics 💀)

---

🎀 DESCRIPTION 🎀

okay so. this function logs a command to the audit system using a predefined message format. it encodes the command the way the audit system expects for untrusted strings, which is the whole point — don't be out here hand-rolling your own encoding, bestie, that's how you get got 😭

this function should be used by all apps that need to record commands. all of them. every single one. periodt 👑

now let's do the function parameters, one by one, because they all matter:

• audit_fd — the fd returned by audit_open 🎀
• type — type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN 🦋
• command — the command being logged 📝
• tty — the tty of the user; if NULL it will attempt to figure it out 🔍
• result — 1 is "success" and 0 is "failed" ✅ / ❌

---

🌈 RETURN VALUE 🌈

it returns the sequence number, which is > 0 on success or <= 0 on error. that's the vibe check right there 💫

---

💀 ERRORS 💀

this function returns -1 on failure. go examine errno for more info, bestie — it's holding all the answers 🙈

---

👑 SEE ALSO 👑

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

go read those too, they're iconic 💜

---

💖 AUTHOR 💖

Steve Grubb — legend, honestly, we stan 🫶

---

that's the whole page, bestie!! this one came from Red Hat back in Feb 2007, and it's the Linux Audit API's very own AUDIT_LOG_USER_COMMAND(3) 🎀 log those commands responsibly, and I'll see you in the next man page ✨💅🦋