EFIWAKE(8)

✨ NAME ✨

okay so welcome to the EFIWAKE(8) page from the System Manager's Manual, bestie — this is all about efiwake, the little command whose whole job is to manipulate the EFI wake timer. She reports the current value of it, disables it, or enables it. Iconic behavior, no cap. 💅

---

🦋 SYNOPSIS 🦋

efiwake
efiwake -d
efiwake -e yyyy-mm-ddThh:mm:ss

💖 DESCRIPTION 💖

okay so efiwake reports the current value of, disables, or enables the EFI wake timer — the one that can wake your machine from S3 sleep at a given time. literally main character energy for your sleep state. 😴✨

If invoked without arguments, the current EFI time and the current value of the wake timer will be printed, followed by an enabled status and a pending status. EFI time is supposed to be in UTC. Note that it can be out of sync with kernel time — lowkey messy, but that's the vibe. The pending status tells whether the wake timer fired recently; it is cleared upon reading. 👀

If invoked with the -d option, the wake timer is reset and disabled.

• -d — resets and disables the wake timer. bye-bye timer 💀

If invoked with the -e option, the wake timer is set to the given time and date. If the date or time is invalid, an error is returned.

• -e — sets the wake timer to the given time and date; if the date or time is invalid, an error is returned. the format is yyyy-mm-ddThh:mm:ss, periodt. ⏰

The current EFI time is always printed. always. every single time. 🫶

🎀 EXAMPLES 🎀

Without arguments:

# efiwake
Current EFI time: 2023-05-04T15:30:45
EFI wake time: 2023-05-04T10:00:00; enabled=0, pending=1

Disabling and resetting the wake timer:

# efiwake -d
Current EFI time: 2023-05-04T15:32:16
EFI wake time: 2023-05-04T15:32:16; enabled=0, pending=0

Enabling the wake timer with a valid date:

# efiwake -e 2023-05-04T15:35:00
Current EFI time: 2023-05-04T15:34:05
EFI wake time: 2023-05-04T15:35:00; enabled=1, pending=0

Trying to enable with an invalid date (there is no 31st of April):

# efiwake -e 2023-04-31T15:35:00
Current EFI time: 2023-05-04T15:35:25
efiwake: cannot enable EFI wake time: Invalid argument

🌸 AUTHORS 🌸

The tool and manual page were written by Johannes Totz <jo@bruelltuete.com>. slay, Johannes. 👑💖

💀 BUGS 💀

The quality of EFI implementations differs widely. Corruption of the wake-up date has been observed on real hardware.

real talk: not me finding out on actual hardware 😭 — this is a genuine caveat, bestie.

💌 this page is from Debian, dated May 9, 2023, and it's the EFIWAKE(8) manual — mwah 💋