timer(8gx)

📦
version 3.6 · 2 versions
, in alpine 3.24

✨ timer(8gx) ✨

Okay so bestie, this is from the Gromox admin reference and it's literally all about the timer daemon. Buckle up, we're scheduling commands like it's nobody's business. 💅

🌸 NAME 🌸

timer — the deferred command executor. It's giving "I'll do it later" but make it Unix. ✨

🎀 SYNOPSIS 🎀

timer [-c config]

That's it. That's the whole vibe. Simple, iconic, periodt.

🦋 DESCRIPTION 🦋

The timer daemon is used to schedule commands to be executed once, at a particular time in the future. It's similar to the at(1) command and its associated daemon, atd. Like, same energy, different font. 💖

timer(8gx) generally receives commands from timer_agent(4gx). So it's not out here taking orders from just anyone — it's got a whole agent situation. No cap.

💜 OPTIONS 💜

  • -c config — Read configuration directives from the given file. If you don't specify this option, it'll read /etc/gromox/gromox.cfg and /etc/gromox/timer.cfg. Default behavior, slay. ✨
  • --version — Output version information and exit. Like, "hey bestie, what version am I?" and then it dips. 💅
  • -? — Display option summary. Your quick lil cheat sheet. 🎀
All time-based command-line options and configuration file directives are subject to the syntax described in gromox(7), section "Duration specifications". So like, if you're confused about time formats, go read that. Iykyk. ⏰

🌈 FILES 🌈

  • /var/lib/gromox/timer.txt — This file is used to save the state of timer(8gx) and persist them across restarts. So when the service goes down and comes back, it's like "oh hey, I remember you." Main character memory energy. 🧠✨

👑 CONFIGURATION DIRECTIVES 👑

The usual config file location is /etc/gromox/timer.cfg. That's where the magic happens.

  • running_identity — An unprivileged user account to switch the process to after startup. To inhibit the switch, assign the empty value. Default: gromox. So like, it drops privileges after startup, but you can turn that off if you're feeling risky. 🙈
  • timer_hosts_allow — A space-separated list of individual IPv6 or v4-mapped IPv6 host addresses that are allowed to converse with the timer service. No networks and no CIDR notations are permitted. So don't try to sneak in a subnet, bestie. It's not gonna work. Default: ::1. 🚫
  • timer_listen_ip — An IPv6 address (or v4-mapped address) for exposing the timer service on. Default: ::1. That's localhost energy unless you change it. 🏠
  • timer_listen_port — The TCP port number for exposing the timer service on. Default: 6666. That's the port, no cap. 🔢
  • timer_log_file — Target for log messages here. Special values: "-" (stderr/syslog depending on parent PID) or "syslog" are recognized. Default: - (auto). So it figures out where to log like a smart lil thing. 📝
  • timer_log_level — Maximum verbosity of logging. 1=crit, 2=error, 3=warn, 4=notice, 5=info, 6=debug. Default: 4 (notice). So it's not out here spamming debug logs unless you ask. 🤫
  • timer_state_path — Default: /var/lib/gromox/timer.txt. Same file as in FILES, just chillin' here too. 🗂️
  • timer_threads_num — The minimum number of client processing threads to keep around. Default: 50. Fifty threads ready to go, like a squad. 👯‍♀️

💀 TIMER PROTOCOL 💀

The timer service is exposed as a line-based text protocol. Upon connection, the event server gratitiously writes "OK", following which the server will wait for timer commands, and execute them synchronously. So it's like "hey bestie, I'm here" and then it waits for your orders. Respectful. 🫶

The command "ADD <seconds> <command>" installs a new timer for the given command to be executed in that many seconds from now. The server will respond with "FALSE 2", "FALSE 3", or respond with the timer ID as "TRUE <id>". So you get either a big fat no or a yes with an ID. Iconic. 🔥

The command "CANCEL <id>" revokes the timer with the chosen ID. So you can be like "actually never mind" and it respects that. Boundaries, bestie. ✋

🌟 SEE ALSO 🌟

Go read those for the full lore. 📚

Okay so that's the whole manual, and it's giving organized, it's giving informative, it's giving slay. This page comes from Gromox and it's the timer(8gx) manual — no specific date on the footer but you know it's current. Stay scheduled, bestie! 💖✨

📦 where this page comes from