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)