AUPARSE_GOTO_RECORD_NUM(3)

💖 AUPARSE_GOTO_RECORD_NUM(3) 💖

okay bestie, so this is a page from the Linux Audit API manual, section 3, and it's all about auparse_goto_record_num — yes the name is a mouthful, we love her anyway 💅

---

✨ NAME ✨

auparse_goto_record_num — move the record cursor to a specific record 🎯

---

🌸 SYNOPSIS 🌸

#include <auparse.h>

int auparse_goto_record_num(const auparse_state_t *au,unsignedint"num);"

no fr, that's exactly what it says, we don't edit the sacred texts around here 🙈

---

🦋 DESCRIPTION 🦋

so like. auparse_goto_record_num will move the library's internal cursors so they point at one specific physical record number. that's the whole vibe. it's giving "teleport but for cursors" ✨

and here's the key detail, don't skip it: records that live inside the same event get numbered starting from 0. zero-indexed girlies rise up 🫶

ngl, you generally do not need this one — it's lowkey not the main character of the API. but there are some cases where you want precise control over the exact record you're looking at, and in those moments? she's iconic. that's it, that's the use case 👑

---

⭐ RETURN VALUE ⭐

• returns 0 on error 💀
• returns 1 for success ✨

that's it. binary. no in-between. very "you either ate or you didn't" energy.

---

👀 SEE ALSO 👀

• auparse_get_num_records(3)
• auparse_next_record(3)

go read those too, they're her friends 💜

---

🎀 AUTHOR 🎀

Steve Grubb

---

and that's the whole page bestie!! 🌈 written by Red Hat, dated May 2008 — yes she's vintage, she's been serving this exact information since before some of us could walk, and she still slays 💖✨🎀🦋 periodt.