Provided by: proftpd-basic_1.3.4~rc2-4_i386 bug

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)