RESETTODR(9)

💖 NAME 💖

okay so bestie, welcome to the RESETTODR(9) page from the Kernel Developer's Manual — this one is about resettodr, and it's literally the function that sets the battery-backed clock from system time. 🫶

---

✨ SYNOPSIS ✨

First, the includes — do not skip these, bestie:

#include <sys/types.h>
#include <sys/systm.h>

void
resettodr(void);

That's the whole signature: void resettodr(void); — no args, no return value, just a clock-setting moment. 💅

---

🌸 DESCRIPTION 🌸

The resettodr() function sets the system's battery-backed clock based on the contents of the system time variable. That's it — it takes what's in the system time variable and uses it to set the battery-backed clock. ⭐

---

🦋 SEE ALSO 🦋

• inittodr(9)
• time(9)

iykyk, go peek at those when you're done here. 🫶

---

💀 BUGS 💀

Okay, slight yikes: on many systems, resettodr() has to convert from time to a time expressed in terms of year, month, day, hours, minutes, and seconds. Many of the implementations could share code, but do not. Not them having duplicate code and refusing to share 😭 — it's literally called out here.

---

xoxo, Debian · November 13, 1995 🎀