ftpshut(8)

NAME

   ftpshut - shut down all proftpd servers at a given time

SYNOPSIS

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

DESCRIPTION

   The  ftpshut  command  provides  an automated shutdown procedure that a
   superuser  can  use  to  automagically   disconnect   current   proftpd
   connections,  and  deny new connections.  The command creates a control
   file as /etc/shutmsg to inform proftpd  processes  about  an  impending
   shutdown.

OPTIONS

   time      The  time  at which the ftp servers will be brought down.  It
             may be the word `now', indicating an immediate shutdown, or a
             future  time  in  one  of  two formats: +number or HHMM.  The
             first form brings the servers down in number  minutes,  while
             the  second  form  indicates  an  exact  time of day, using a
             24-hour clock format.

   -R        Instructs ftpshut to remove the /etc/shutmsg file,  restoring
             proftpd  to its normal service.  If this option is used, this
             will be the only operation performed by ftpshut

   -l min    Specifies the number of minutes before shutdown that new  ftp
             access  will be disabled.  If the -l option is not specified,
             a default of 10 minutes (or  immediately,  if  less  than  10
             minutes remains until shutdown) is used.

   -d min    Specifies the number of minutes before shutdown that existing
             ftp connections will be disconnected.  If the  -d  option  is
             not  specified,  a  default  of 5 minutes (or immediately, if
             less than 5 minutes remains until shutdown) is used.

   warning-message
             Optionally provide a  message  which  will  be  sent  to  new
             connections   (if  denied)  and  existing  connections  (when
             disconnected).  The message can contain the  following  magic
             cookies,  which will be replaced as follows before being sent
             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

   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.

   It is possible to set an absolute shutdown time which is  earlier  than
   the current time.  If this is the case, proftpd will not shutdown until
   the indicated time on the following day.

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/

                              March 2003                        ftpshut(8)

---

Free and Open Source Software