ftpshut(1m) - osol9

1ftpshut(1M)             System Administration Commands             ftpshut(1M)
2
3
4

NAME

6       ftpshut - close down the FTP Servers at a given time
7

SYNOPSIS

9       ftpshut [-V] [-v] [-l min] [-d min] time
10            [warning-message]...
11
12

DESCRIPTION

14       The  ftpshut  command provides an automated shutdown procedure that the
15       superuser can use to notify FTP users when the FTP Server  is  shutting
16       down.
17
18
19       Ten  minutes  before  shutdown,  or immediately if the value of time is
20       less than ten minutes, any new FTP Server connections will be disabled.
21       You  may  adjust the shutdown of new FTP Server connections by means of
22       the -l option.
23
24
25        Five minutes before shutdown, or immediately if the value of  time  is
26       less  than  five  minutes,  all current FTP connections will be discon‐
27       nected. You may adjust the shutdown of current FTP connections by means
28       of the -d option.
29
30
31        The ftpshut command creates shutdown message files that the FTP Server
32       uses to determine when to shutdown. Separate shutdown message files are
33       created in the anonymous and virtual host FTP Server areas, in addition
34       to the system wide shutdown message file. Once the shutdown occurs, the
35       server  continues  to refuse connections until the appropriate shutdown
36       message  file  is  removed.  This  normally  is  done  by   using   the
37       ftprestart(1M)  command.  The  location of the shutdown message file is
38       specified by the shutdown capability in the ftpaccess file.
39
40
41       The following magic cookies are available:
42
43       %s    The time system is going to shut down.
44
45
46       %r    The time new connections will be denied.
47
48
49       %d    The time current connections will be dropped.
50
51
52       %C    The current working directory.
53
54
55       %E    The maintainer's email address as defined in the ftpaccess file.
56
57
58       %F    The free space in the partition of CWD, in kilobytes.
59
60
61       %L    The local host name.
62
63
64       %M    The maximum allowed number of users in this class.
65
66
67       %N    The current number of users in this class.
68
69
70       %R    The remote host name.
71
72
73       %T    The local time (form Thu Nov 15 17:12:42 1990).
74
75
76       %U    The username given at login time.
77
78

OPTIONS

80       The ftpshut command supports the following options:
81
82       -V        Display program copyright and version information, then  ter‐
83                 minate.
84
85
86       -d min    The time ahead of shutdown, in minutes, that existing connec‐
87                 tions will be disconnected upon completion of  their  current
88                 or next (if idle) FTP request.
89
90
91       -l min    The  time ahead of shutdown, in minutes, that new connections
92                 will be refused.
93
94
95       -v        Verbose. Output the pathname of the  shutdown  message  files
96                 created.
97
98

OPERANDS

100       The ftpshut command supports the following operands:
101
102       time               The time at which ftpshut will bring the FTP Servers
103                          down. time can have a value of now, which  indicates
104                          an immediate shutdown. Alternatively, time can spec‐
105                          ify a future time in one of two formats: +number  or
106                          HHMM.  The  first form brings the FTP Server down in
107                          number minutes. The second  brings  the  FTP  Server
108                          down  at  the time of day indicated, using a 24-hour
109                          clock format. When using the absolute  time  format,
110                          you can only specify times between now and 23:59.
111
112
113       warning-message    The  message  to  display that warns of the imminent
114                          shutdown. The warning-message will be  formatted  at
115                          70  characters wide. ftpshut knows the actual string
116                          length of the magic cookies. If  no  warning-message
117                          is supplied, the default message "System shutdown at
118                          %s" is used.
119
120

EXIT STATUS

122       The following exit values are returned:
123
124       0     Successful completion.
125
126
127       >0    An error occurred.
128
129

FILES

131       /etc/ftpd/ftpaccess
132
133
134       /etc/ftpd/ftpservers
135
136

ATTRIBUTES

138       See attributes(5) for descriptions of the following attributes:
139
140
141
142
143       ┌─────────────────────────────┬─────────────────────────────┐
144       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
145       ├─────────────────────────────┼─────────────────────────────┤
146       │Availability                 │SUNWftpu                     │
147       ├─────────────────────────────┼─────────────────────────────┤
148       │Interface Stability          │External                     │
149       └─────────────────────────────┴─────────────────────────────┘
150