HYLAFAX-SHUTDOWN(5)

💖 HYLAFAX-SHUTDOWN(5) 💖

ok so bestie, this is the manual page for the HYLAFAX-SHUTDOWN file format, and we're talking about etc/shutdown — the server shutdown control file. yes it's a whole vibe, yes it's important, let's get into it 🫶

✨ NAME ✨

etc/shutdown — server shutdown control file

🌸 DESCRIPTION 🌸

okay so here's the tea ☕: if the file etc/shutdown exists, it's basically telling the whole HylaFAX server when to shut down. and not just that — it can also hold a little descriptive message to send back to clients explaining why the shutdown is happening. like a "sorry bestie, we're closing, here's why" note. this file is used by the hfaxd(8) program.

the file has this format:

<year> <month> <day> <hour> <minute> <deny> <disconnect>
<shutdown message text>

the first line is the main character 🔥 — it defines the date and time the server should be shutdown, plus the times preceding it at which unprivileged clients should be denied service or disconnected. all those fields get described in more detail down below, don't worry.

any lines that come after that first one? those are taken as the text of a message that gets returned to clients — when notifying them of a scheduled shutdown, or when denying them service. so basically your little goodbye speech 💌

• <year> — the decimal year; e.g. 1996.
• <month> — the decimal month; e.g. 10 for October.
• <day> — the decimal day of the month, in the range [1..31].
• <hour> — the decimal hour since midnight; in the range [0..23].
• <minute> — the decimal minute after the hour; in the range [0..59].
• <deny> — the time prior to the shutdown time at which to deny service to unprivileged clients. this value is specified as a decimal number in the form HHMM; e.g. 130 for 1 hour and 30 minutes.
• <disconnect> — the time prior to the shutdown time at which to disconnect unprivileged clients that are logged in to the server. this value is specified as a decimal number in the form HHMM.

📝 NOTES 📝

ngl this file is typically created using the ``SHUT'' command supported by hfaxd(8). so like, you don't usually hand-write it — the command does it for you, periodt 💅

👀 SEE ALSO 👀

• hfaxd(8)
• hylafax-server(5)

and that's the whole page bestie!! 💖 this one's from January 18, 1996, living under the HYLAFAX-SHUTDOWN(5) manual name, in case you needed to cite your sources. go forth and schedule your shutdowns responsibly, mwah 🎀✨🦋