HYLAFAX-SHUTDOWN(5F)

✨ HYLAFAX-SHUTDOWN(5F) ✨

okay bestie, buckle up, because this is the <pink>HYLAFAX-SHUTDOWN</pink> page and it's giving server bedtime energy 💤🌸

💖 NAME 💖

etc/shutdown — the server shutdown control file, aka the little note that tells your HylaFAX server when to go night-night 🛌✨

🌸 DESCRIPTION 🌸

so like, if the file etc/shutdown is present, it literally describes when a HylaFAX server is supposed to be shutdown, and it can also carry a cute lil descriptive message to send back to clients explaining why the shutdown is happening. no cap. 🫶

this file is used by the hfaxd(8C) program. iykyk.

the file has this format, exactly:

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

the first line defines the date and time the server should be shutdown, plus the time preceding it at which unprivileged clients should be denied service or disconnected. those fields get their own lil breakdown below. 👇

any lines that come after the first one? those get taken as the text of a message to return to clients when notifying them of a scheduled shutdown, or when denying them service. so go ahead, write a whole paragraph, it's your moment. 💅

• <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> — time 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. 💀

ngl, <deny> and <disconnect> are both HHMM decimals, so 130 is 1 hour and 30 minutes — not 130 minutes, bestie. read it as hours-then-minutes or you're gonna have a bad time 😭

🎀 NOTES 🎀

this file is typically created using the SHUT command supported by hfaxd(8C). so like, you could hand-write it, but the SHUT command is right there being iconic. 👑

🦋 SEE ALSO 🦋

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

and that's the whole vibe, bestie — this page is from January 18, 1996, and it's still out here living its truth in the HylaFAX manual. slay 💖✨