SETAUID(2)

📦 version 12.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 SETAUID(2) 💖

okay so bestie, welcome to setauid — it's a system call, it lives in section 2 of the manual, and it's here to let you ✨set the audit session ID✨. yeah. we're doing audit stuff today. put your seatbelt on 🎀

🌸 NAME 🌸

setauid — set audit session ID. that's it. that's the whole vibe. short, sweet, iconic 👑

✨ SYNOPSIS ✨

#include <bsm/audit.h>

int
setauid(au_id_t *auid);

look at her. so clean. so simple. no cap 💅

🦋 DESCRIPTION 🦋

so like, 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. that's the whole job. she's a one-task queen 👑

fr fr though — this system call requires an appropriate privilege to complete. so like, you can't just waltz in there without the right permissions. main character energy only, bestie 😭

💀 RETURN VALUES 💀

  • if everything goes slay: the value 0 is returned ✨
  • if it does NOT go slay: the value -1 is returned, and the global variable errno gets set to tell you what went wrong 🙈

🔥 ERRORS 🔥

the setauid() function will fail if:

  • [EFAULT] — a failure occurred while data transferred to the kernel failed. yeah, the transfer just... didn't transfer. embarrassing for everyone involved 💀
  • [EPERM] — the process does not have sufficient permission to complete the operation. no permission, no service. that's the rule 🚫

🌈 SEE ALSO 🌈

the whole audit friend group 🫶 they all hang out together, iykyk

📜 HISTORY 📜

the OpenBSM implementation was created by McAfee Research — that's the security division of McAfee Inc., not a vibe, an actual company — under contract to Apple Computer Inc. in 2004. and then, plot twist, it was subsequently adopted by the TrustedBSD Project as the foundation for the OpenBSM distribution. glow up fr fr ✨

👑 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 the audit event stream format were defined by Sun Microsystems. legends, honestly 🌟

and this manual page was written by Robert Watson <rwatson@FreeBSD.org>. thank you for your service, king 🫡💖

and that's the whole page, bestie!! this Debian version dropped on April 19, 2005, and it's giving vintage but make it secure 🎀✨ go forth and set those audit session IDs responsibly. mwah 💋

📦 where this page comes from