ftpshut(8)

💖 ftpshut — bestie, it's the shutdown button 💖

okay so welcome to ftpshut(8), from the System Manager's Manual section 8 (that's the "sysadmin only, no touching" section, iykyk) ✨

---

🌸 NAME 🌸

ftpshut — shut down all proftpd servers at a given time ⏰💀

---

🎀 SYNOPSIS 🎀

ftpshut [ -R ] [ -l min ] [ -d min ] time [ warning-message ]

---

✨ DESCRIPTION ✨

ok so ftpshut is the automated shutdown procedure, and it's giving superuser main character energy 👑 — a superuser can use it to automagically disconnect the proftpd connections that are currently happening, and deny any new ones from even thinking about it 🚫🔌

The way it works is: the command creates a control file at /etc/shutmsg, and that file is basically a lil gossip note to the proftpd processes being like "hey bestie, a shutdown is coming" 📝✨

---

💅 OPTIONS 💅

• time — the time at which the ftp servers get brought down 🕐 It can be the word now, which means immediate shutdown, no waiting, bye 👋 or it can be a future time in one of two formats: +number or HHMM. The +number form brings the servers down in number minutes, and the HHMM form means an exact time of day using a 24-hour clock format ⏳
• -R — tells ftpshut to remove the /etc/shutmsg file, which restores proftpd to its normal service 🫶 If this option is used, this will be the only operation performed by ftpshut — it's not doing anything else, periodt 💅
• -l min — specifies the number of minutes before shutdown that new ftp access will be disabled 🚧 If -l isn't specified, the default is 10 minutes (or immediately, if less than 10 minutes remains until shutdown) ⏱️
• -d min — specifies the number of minutes before shutdown that existing ftp connections will be disconnected ✂️ If -d isn't specified, the default is 5 minutes (or immediately, if less than 5 minutes remains until shutdown) ⏱️
• warning-message — optionally, you can provide a message 🥺 which will be sent to new connections (if denied) and to existing connections (when disconnected). The message can contain the following magic cookies 🍪, which get replaced as follows before being sent out to new or existing connections:
  • %s — time proftpd is being shut down
  • %r — time new connections will be denied
  • %d — time current connections will be dropped
  • %C — current working directory (where applicable)
  • %L — local host name (or virtualhost name)
  • %R — remote host name
  • %T — local time (format Thu Nov 15 17:12:42 1990)
  • %U — username given at login time

---

😭 CAVEATS 😭

ok this part is the serious part, bestie, listen up 🫡

Proftpd servers can only be shutdown via ftpshut if a master daemon is running in standalone mode. Servers running in inetd mode will honor the shutdown message file created by ftpshut — however, currently running servers may be chroot(2)ed, and unable to read the shutdown message control file 😬

💀 Also: it is possible to set an absolute shutdown time which is earlier than the current time. If that happens, proftpd will not shutdown until the indicated time on the following day. So like, don't do that unless you mean it 🙈

---

🍓 FILES 🍓

• /usr/sbin/ftpshut
• /etc/shutmsg

---

💜 AUTHORS 💜

ProFTPD is written and maintained by a number of people 🫶 — full credits can be found on http://www.proftpd.org/credits.html

---

🌈 SEE ALSO 🌈

inetd(8), ftp(1), proftpd(8), ftpwho(1), ftpcount(1)

Full documentation on ProFTPD, including configuration and FAQs, is available at http://www.proftpd.org/ 📚

For help/support, try the ProFTPD mailing lists, detailed on http://www.proftpd.org/lists.html 📬

Report bugs at http://bugs.proftpd.org/ 🐛

---

and that's the whole page, bestie!! this iconic lil manual page came from March 2003 (throwback fr fr 🕰️), it lives in section 8 of the System Manager's Manual as ftpshut(8), and the source/version vibe is all proftpd 💖 now go schedule that shutdown responsibly, mwah 😘🎀 ✨