Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

ftpshut (8)

Name

ftpshut - shut down all proftpd servers at a given time

Synopsis

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

Description

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 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 min-
                 utes 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 con-
                 nections (if denied) and existing connections  (when  discon-
                 nected).   The  message can contain the following magic cook-
                 ies, 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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------+
       |ATTRIBUTE TYPE |  ATTRIBUTE VALUE    |
       +---------------+---------------------+
       |Availability   | service/network/ftp |
       +---------------+---------------------+
       |Stability      | Uncommitted         |
       +---------------+---------------------+
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/



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source     was     downloaded     from       ftp://ftp.proftpd.org/dis-
       trib/source/proftpd-1.3.6.tar.gz

       Further information about this software can be found on the open source
       community website at http://www.proftpd.org/.



                                  March 2003                        ftpshut(8)