n7/vdso.7.html
it's quite interesting
as someone mentioned a few threads back, the posix standard explicitly ignores leap seconds. rather interesting choice, but i guess it's mostly understandable given machine limitations
beyond this, i found the error section amusing
Error returns from this system call are indistinguishable from
successful reports that the time is a few seconds before the
Epoch, so the C library wrapper function never sets errno as a
result of this call.
also, the part right below this about how it can never fail seems to conflict with the part about how it can fail with EOVERFLOW, but hey, what do i know?
relevant resources:
man man
man syscalls
https://man7.org/linux/man-pages/
https://linux.die.net/man/
https://elixir.bootlin.com/linux/
https://elixir.bootlin.com/musl/
https://elixir.bootlin.com/glibc/