HP-UX Reference (11i v1 05/09) - 1 User Commands A-M (vol 1)

f
ftpshut(1) ftpshut(1)
NAME
ftpshut - create shutdown message file to shut down the ftp servers at a given time
SYNOPSIS
/usr/bin/ftpshut
[ -l min ][-d min ] time [ warning-message ... ]
DESCRIPTION
The
ftpshut command provides an automated shutdown procedure that a superuser can use to notify ftp
users when the ftp server is shutting down. This command will create a shutdown message file in the path
specified by the ’shutdown’ directive in the
/etc/ftpd/ftpaccess
file in the real, anonymous and vir-
tual user accounts. For guest accounts the system administrator must copy the message file created in the
real user account to the guest accounts manually. The server will check this file regularly to see if the
server is going to be shut down.
-l min This option is used as deny_offset. New FTP access is disabled ’min’ minutes before
shutdown. The default value of ’min’ is 10 minutes. This value can be reset by the
user.
-d min This option is used as disc_offset. All current FTP connections will be dropped ’min’
minutes before shutdown. The default value of ’min’ is 5 minutes. This value can be
reset by the user.
time time, is the time at which the ftp server will be shutdown. If time is set to the word
‘now’ the shutdown will be immediate. time can also be set to a future time. Future
time can be specified in one of the two formats: + number or HHMM. The first format
brings the ftp servers down in number minutes. The second format brings the ftp
servers down at the time of day indicated, using a 24-hour clock format.
warning-message
The warning-message is the message the server will flash to its clients on shut down.
The user can use a message of his choice or use the ’macros’ or ’magic cookies’ that are
available. The server will replace the macro with the specified text string. The
warning-message will be formatted to be 75 characters long, including the length of
any expanded macros ("magic cookies"). The default warning message is "System shut-
down at %s". The following magic cookies are available:
%s time system is going to shut down
%r time new connections will be denied
%d time current connections will be dropped
%C current working directory
%E the maintainer’s email address as defined in ftpaccess
%L local host name
%M maximum allowed number of users in this class
%N current number of users in this class
%R remote host name
%T local time (form Thu Nov 15 17:12:42 1990)
%U username given at login time
WARNINGS
You can kill the servers only between now and 23:59, if you use the absolute time for
ftpshut.
EXIT STATUS
ftpshut returns:
0 successful
1 failure
-1 the wrong parameter was passed to ftpshut.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1−−321