SETAUID(2)

📦
version 1.1 · 2 versions
, in nixos 26.05, nixpkgs unstable

💖 SETAUID(2) 💖

okay so real talk bestie, this is the <setauid> page from the System Calls Manual and it's literally all about setting your audit session ID. tiny page, big energy 🫶

✨ NAME ✨

setauid — set audit session ID 🎀

🌸 SYNOPSIS 🌸

#include <bsm/audit.h>

int
setauid(au_id_t *auid);

🦋 DESCRIPTION 🦋

so the setauid() system call sets the active audit session ID for the current process, and it pulls that ID from the au_id_t that auid is pointing at. like, pointer goes in, session ID comes out, no cap ✨

💅 heads up: this system call requires an appropriate privilege to complete. no privilege, no slay.

👑 RETURN VALUES 👑

when it works? you get the value 0 back. iconic, flawless, ate.

when it doesn't? you get the value -1, and the global variable errno is set to indicate the error. sad girl hours 😭

🔥 ERRORS 🔥

the setauid() function will fail if:

  • [EFAULT] — a failure occurred while data transferred to the kernel failed 💀
  • [EPERM] — the process does not have sufficient permission to complete the operation 🙈

🌈 SEE ALSO 🌈

audit(2), auditon(2), getaudit(2), getaudit_addr(2), getauid(2), setaudit(2), setaudit_addr(2), libbsm(3)

⭐ HISTORY ⭐

the OpenBSM implementation was created by McAfee Research, the security division of McAfee Inc., under contract to Apple Computer Inc. in 2004. it was subsequently adopted by the TrustedBSD Project as the foundation for the OpenBSM distribution. little bit of lore for you 🧚

💜 AUTHORS 💜

this software was created by McAfee Research, the security research division of McAfee, Inc., under contract to Apple Computer Inc. additional authors include Wayne Salamon, Robert Watson, and SPARTA Inc. 🫶

the Basic Security Module (BSM) interface to audit records and audit event stream format were defined by Sun Microsystems.

this manual page was written by Robert Watson <rwatson@FreeBSD.org> ✨

okay that's the whole page bestie, go forth and audit responsibly 💅🍓

Debian · April 19, 2005 · SETAUID(2) — signed, sealed, and delivered with main character energy 👑💖

📦 where this page comes from