ftpshut(8)						      System Manager's Manual							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 connec-
       tions, and deny new connections.  The command creates a control file as /etc/shutmsg to inform proftpd processes about an  impending  shut-
       down.

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 connec-
		 tions:

		 %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)