ftpshut(1)

ftpshut(1)

NAME

ftpshut - create shutdown message ®le to shut down the ftp servers at a given time

SYNOPSIS

/usr/bin/ftpshut [ -lmin ] [ -dmin ] 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 ®le in the path speci®ed by the 'shutdown' directive in the /etc/ftpd/ftpaccess ®le in the real, anonymous and virtual user accounts. For guest accounts the system administrator must copy the message ®le created in the real user account to the guest accounts manually. The server will check this ®le 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 speci®ed in one of the two formats: + number or HHMM. The ®rst 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 ¯ash 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 speci®ed text string. The warning-messagewill be formatted to be 75 characters long, including the length of any expanded macros ("magic cookies"). The default warning message is "System shutdown 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 de®ned 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:

0successful

1failure

-1 the wrong parameter was passed to ftpshut.

f

HP-UX Release 11i: December 2000

− 1 −

Section 1−311