Andrew Hudson - Fedora™ Unleashed, 2008 edition

ftpshut [ -V ] [ -l min] [ -d min] time [ warning-message ... ]

The -Vparameter displays the command's version information. The timeparameter is the time when the ftpshutcommand will stop the FTP servers. This parameter takes either a +number for the number of minutes from the current time, or a specific hour and minute in 24-hour clock format with the syntax of HH:MM .

The -l parameter enables the FTP server administrator to specify how long, in minutes, before shutdown the server disallows new connections. The default is 10 minutes. If the time given to shut down the servers is less than 10 minutes, new connections are disallowed immediately.

The -dparameter is similar to the -l parameter, but controls when the FTP server terminates the current connections. By default, this occurs five minutes before the server shuts down. If the shutdown time is less than five minutes, the server terminates the current connections immediately.

When you execute this command, the FTP server creates a file containing the shutdown information in the location specified under the shutdown section in the ftpaccessfile. The default configuration for this file is /etc/shutmsg. If you execute the ftpshutcommand with warning messages, the messages are displayed when the user logs in to the server.

Name (pheniox:tdc): anonymous

331 Guest login ok, send your complete e-mail address as password.

Password:

230-system doing down at Mon Sep 3 06:23:00 2001

230-0 users of unlimited on pheniox.

230 Guest login ok, access restrictions apply.

Remote system type is UNIX.

Using binary mode to transfer files.

Here is a sample ftpshutcommand:

ftpshut -l 5 -d 5 +10 "system going down at %s %N users of %M on %R"

This command tells the FTP server to disconnect new connections in 5 minutes, drop all current connections in 5 minutes, shut down the server in 10 minutes, and display a warning message to the users at login. The message can be a mixture of text and the magic cookies defined in Table 20.4. It is important to keep in mind that the message can be a maximum of 75 characters in length. Additionally, it is not important to know how many characters the magic cookies take because the system knows this information and truncates the message at 75 characters.

TABLE 20.4 Magic Cookies for the ftpshutCommand

When ftpshutis issued to the system, it creates a file that stores the necessary information. The ftprestartcommand removes this file for all servers, either canceling the impending shutdown or removing the shutdown file and restarting the FTP server. The ftprestarthas only one optional argument, -V, to show version information.

The xferlogfile gives a log of what transactions have occurred with the FTP server. Depending on the settings in the /etc/ftpaccessfile, the contents of this file can contain the files sent or received, by whom, with a date stamp. Table 20.5 lists the fields of this file. The same information can also be found in the corresponding man page included in the wu-ftpRPM.

TABLE 20.5 /var/log/xferlogFields

An example of this file is seen in Listing 20.5.

Mon Sep 3 07:13:05 2001 1 localhost.localdomain 100 /var/ftp/pub/README b o a testing@test.com ftp 0 * c

Mon Sep 3 02:35:35 2001 1 helios 8 /var/ftp/pub/configuration a _ o a testing@test.com ftp 0 * c

Mon Sep 3 02:35:35 2001 1 helios 8 /var/ftp/pub/temp.txt a o a testing@test.com ftp 0 * c