ELFTC_TIMESTAMP(3)

✨ ELFTC_TIMESTAMP ✨

okay bestie, so this is elftc_timestamp from the libelftc library — she's a little function that hands you a timestamp, and no cap she's lowkey iconic for it 💅

---

🌸 NAME 🌸

elftc_timestamp — returns the current or environment-provided timestamp. that's it, that's the whole vibe 🕐✨

---

🎀 LIBRARY 🎀

library “libelftc” — yeah, you're gonna need her, she's the main character here 👑

---

🦋 SYNOPSIS 🦋

#include <libelftc.h>

int
elftc_timestamp(time_t *timestamp);

literally just include the header and call her, it's giving one-function-girlboss energy 🫶

---

💜 DESCRIPTION 💜

okay so here's the tea ☕ — elftc_timestamp() returns a timestamp that comes from the SOURCE_DATE_EPOCH environment variable if that's set. and if it's not set? she just falls back to the current time, courtesy of time(3). good for her honestly 🌈

the timestamp argument is a pointer to the spot where the timestamp gets stored — so you're like, "here's where you put it bestie," and she puts it there 🎀

---

🔥 RETURN VALUES 🔥

• elftc_timestamp() returns 0 on success — slay, we love a clean win ✨
• and she returns -1 if something goes wrong — not the vibe, but at least she tells you 😭

---

💀 ERRORS 💀

bestie she may fail with these, so pay attention fr fr:

• [EINVAL] — SOURCE_DATE_EPOCH contains invalid characters. like girl what is that 💀
• [ERANGE] — SOURCE_DATE_EPOCH specifies a negative value, or a value that cannot be stored in a time_t. too much, or too negative — either way, out of range 🚫

also heads up: elftc_timestamp() may also fail for any of the reasons described in strtoll(3). so like, that's a whole other can of worms, go read that one too 🫶

---

🧚 SEE ALSO 🧚

• strtoll(3)
• time(3)

---

and that's the whole page, bestie! go forth and timestamp responsibly 🦋💖

mwah 💋 — this lil Debian-flavoured page is dated August 24, 2016, and it's living rent-free in the ELFTC_TIMESTAMP(3) era ✨