SLEEPENH(1)

💤 SLEEPENH(1) — user commands, but make it a whole vibe 💤

okay bestie, sit down, hydrate, because we're talking about sleepenh — the enhanced sleep program — and honestly? it's giving main character energy in the shell-scripting world. 🫶

---

✨ NAME ✨

sleepenh — an enhanced sleep program 🌙

---

🎀 SYNOPSIS 🎀

sleepenh [[--warp|-w] INITIALTIME] TIMETOSLEEP

---

💅 DESCRIPTION 💅

so here's the tea, bestie: sleepenh is the program you reach for when you need to run stuff periodically inside a shell script. 🔁

and like — important — it was not designed to be accurate for one single sleep. it's designed to be accurate across a sequence of consecutive sleeps. that's the whole point, that's the moment, no cap. ✨

after it runs successfully, it prints to stdout the timestamp it finished running. and that value? you feed it back in as INITIALTIME to the next sleepenh call. it's a little relay race and it's iconic. 🏃♀️💨

---

🌸 OPTIONS 🌸

• -h, --help — display this help and exit 🫡
• -w, --warp — warp the resulting timestamp, for when there's no need to sleep. an immediately following call of sleepenh with the resulting TIMESTAMP would most probably result in a real sleep. 🌀
• -V, --version — output version information and exit 👑

---

🦋 ARGUMENTS 🦋

• TIMETOSLEEP — a real number in seconds, with microseconds resolution. so like, 1 minute, 20 seconds and 123456 microseconds would be 80.123456. math but make it cute. 🧮✨
• INITIALTIME — also a real number in seconds, with microseconds resolution. heads up though: this number is system dependent. on GNU/Linux systems it's the number of seconds since midnight 1970-01-01 GMT. ⏳

⚠️ do not try to get a good value of INITIALTIME yourself, bestie. just use the value supplied by a previous execution of sleepenh. trust the process. 🙏

if you don't specify INITIALTIME, it's assumed to be the current time. easy. 🌈

---

💀 EXIT STATUS 💀

an exit status greater or equal to 10 means failure. here's the known lineup:

• 0 — Success. 🎉
• 1 — Success. There was no need to sleep. (this means that INITIALTIME + TIMETOSLEEP was greater than current time). 😴
• 10 — Failure. Missing command line arguments. 🙈
• 11 — Failure. Did not receive SIGALRM. 😭
• 12 — Failure. Argument is not a number. 🔢💔
• 13 — Failure. System error, could not get current time. 💥

---

🍓 USAGE EXAMPLE 🍓

suppose you need to send the char 'A' to the serial port ttyS0 every 4 seconds. this will do that, fr fr:

#!/bin/sh
TIMESTAMP=$(sleepenh 0)
while true; do
  # send the byte to ttyS0
  echo -n "A" > /dev/ttyS0;

  # just print a nice message on screen
  echo -n "I sent 'A' to ttyS0, time now is ";
  sleepenh 0;

  # wait the required time
  TIMESTAMP=$(sleepenh $TIMESTAMP 4.0);
done

---

🧚 HINT 🧚

this program can be used to get the current time. just execute:

sleepenh 0

and boom, you're a time lord now. ⏰👑

---

😭 BUGS 😭

it is not accurate for a single sleep. short TIMETOSLEEPs will also not be accurate. she's a group-project girlie, not a solo act. 💔

---

🔥 SEE ALSO 🔥

date(1), sleep(1).

---

👑 AUTHOR 👑

this manual page was written by Pedro Zorzenon Neto. 💜

---

and that's the whole page, bestie — this version of the sleepenh manual is from 2024-12-09, and it's filed under the sleepenh name in the user commands section. sleep tight, literally. 💤✨🎀