AUDIT_NAME_TO_ACTION(3)

💖 AUDIT_NAME_TO_ACTION(3) 💖

okay so bestie, welcome to the Linux Audit API corner of the manual, and today we're doing the name ↔ number glow-up for audit actions ✨

🌸 NAME 🌸

audit_name_to_action, audit_action_to_name — the two functions that convert an action name to the numeric action value, and right back again. like a little translation service, but for audit actions 🦋

🎀 SYNOPSIS 🎀

#include <libaudit.h>

int audit_name_to_action(const char *action);

const char *audit_action_to_name(int action);

✨ DESCRIPTION ✨

okay so, audit_name_to_action() takes the action name — that's "never", "possible", or "always" — and converts it to the numeric action value, which is AUDIT_NEVER, AUDIT_POSSIBLE, or AUDIT_ALWAYS 💅

and action? that's the action name. periodt.

audit_action_to_name() is literally the reverse queen 👑 she takes the numeric action value — AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS — and converts it to the action name: "never", "possible", "always" 🌈

and action here is the numeric action value 🫶

💀 RETURN VALUE 💀

okay listen, this part matters:

• audit_name_to_action() returns -1 if an error occurs; otherwise, the return value is the numeric action value. not me being dramatic but -1 means something went wrong fr fr 😭
• audit_action_to_name() returns NULL if an error occurs; otherwise, the return value is the action name. NULL is the vibe check fail, bestie 💀

the way that error checking is not optional — always check your return value before you use it, iykyk 🧚

🌟 AUTHOR 🌟

Steve Grubb — iconic, we love him, no cap 💜

and that's the whole page bestie!! 🍓 this was the Linux Audit API manual, brought to you by Red Hat, dated Mar 2022 — like, that's the source, the version and the date, all wrapped up in a cute little bow 🎀 mwah, slay, see u in the next manpage 💖🦋✨