AUPARSE_GET_LINE_NUMBER(3)

💖 AUPARSE_GET_LINE_NUMBER 💖

okay bestie, welcome to the auparse_get_line_number(3) page — yes that's the Linux Audit API, and yes we're gonna make line numbers cute. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

auparse_get_line_number — get line number where record was found 🔍

---

🌸 SYNOPSIS 🌸

#include <auparse.h>

unsigned int auparse_get_line_number(const auparse_state_t *au);"

(yes the trailing " is literally in there, no I will not be fixing it, that's canon 💅)

---

🎀 DESCRIPTION 🎀

so, auparse_get_line_number will return the source input line number for the current record of the current event. that's it. that's the whole job. main character behavior tbh.

line numbers start at 1. not zero. one. we're one-based around here, no cap. ✨

and here's the lil plot twist 👀 — if the source input type is AUSOURCE_FILE_ARRAY, the line numbering will reset back to 1 each time a new line in the file array is opened. so like, new file, new count, fresh start, it's giving rebirth era 🦋

---

💫 RETURN VALUE 💫

returns the line number. line numbers are 1 based, and a zero value indicates the line number information is unavailable. 😭

so if you get a 0, that's not "line zero", that's "we literally don't know, bestie". don't @ me, that's just how it is.

---

🌈 SEE ALSO 🌈

• auparse_get_filename(3) — for when you need the where too 🗺️
• auparse_next_record(3) — for when you're ready to move on, periodt

---

👑 AUTHOR 👑

John Dennis — iconic, we stan 💜

---

and that's the whole page!! written by Red Hat, dated June 2016, and the original header/footer said AUPARSE_GET_LINE_NUMBER(3) twice because it's extra like that. mwah, go read your audit logs bestie 💖🎀✨