1ftpshut(8)                  System Manager's Manual                 ftpshut(8)
2
3
4

NAME

6       ftpshut - shut down all proftpd servers at a given time
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

18       time      The time at which the ftp servers will be brought  down.   It
19                 may be the word `now', indicating an immediate shutdown, or a
20                 future time in one of two  formats:  +number  or  HHMM.   The
21                 first  form  brings the servers down in number minutes, while
22                 the second form indicates an  exact  time  of  day,  using  a
23                 24-hour clock format.
24
25       -R        Instructs  ftpshut to remove the /etc/shutmsg file, restoring
26                 proftpd to its normal service.  If this option is used,  this
27                 will be the only operation performed by ftpshut
28
29       -l min    Specifies  the number of minutes before shutdown that new ftp
30                 access will be disabled.  If the -l option is not  specified,
31                 a default of 10 minutes (or immediately, if less than 10 min‐
32                 utes remains until shutdown) is used.
33
34       -d min    Specifies the number of minutes before shutdown that existing
35                 ftp  connections  will  be disconnected.  If the -d option is
36                 not specified, a default of 5  minutes  (or  immediately,  if
37                 less than 5 minutes remains until shutdown) is used.
38
39       warning-message
40                 Optionally  provide  a message which will be sent to new con‐
41                 nections (if denied) and existing connections  (when  discon‐
42                 nected).   The  message can contain the following magic cook‐
43                 ies, which will be replaced as follows before being  sent  to
44                 new or existing connections:
45
46                 %s  time proftpd is being shut down
47                 %r  time new connections will be denied
48                 %d  time current connections will be dropped
49                 %C  current working directory (where applicable)
50                 %L  local host name (or virtualhost name)
51                 %R  remote host name
52                 %T  local time (format Thu Nov 15 17:12:42 1990)
53                 %U  username given at login time
54

CAVEATS

56       Proftpd  servers can only be shutdown via ftpshut if a master daemon is
57       running in standalone mode.  Servers running in inetd mode  will  honor
58       the shutdown message file created by ftpshut, however currently running
59       servers may be chroot(2)ed, and unable to  read  the  shutdown  message
60       control file.
61
62       It  is  possible to set an absolute shutdown time which is earlier than
63       the current time.  If this is the case, proftpd will not shutdown until
64       the indicated time on the following day.
65

FILES

67       /usr/sbin/ftpshut
68       /etc/shutmsg
69

AUTHORS

71       ProFTPD  is  written and maintained by a number of people, full credits
72       can be found on http://www.proftpd.org/credits.html
73

SEE ALSO

75       inetd(8),ftp(1),proftpd(8),ftpwho(1),ftpcount(1)
76
77       Full documentation on ProFTPD, including  configuration  and  FAQs,  is
78       available at http://www.proftpd.org/
79
80       For   help/support,   try   the  ProFTPD  mailing  lists,  detailed  on
81       http://www.proftpd.org/lists.html
82
83       Report bugs at http://bugs.proftpd.org/
84
85
86
87                                  March 2003                        ftpshut(8)