/* 
* Copyright (c) 2001 by Sun Microsystems, Inc.
# All rights reserved.
#
*/ 

TEST NAME 

      ftpstress - compare for data corruption

SYNOPSIS 

      sh ftpstress.sh REMOTE-MACHINE

DESCRIPTION 

      This command sends files of different sizes from a local machine to a
      remote machine, back to the local machine, and compares for data
      corruption.

OPERANDS 

      REMOTE-MACHINE  Either a host name or IP address of the machine to
                      which files and directories are copied. If a host name 
                      is given, it must appear in /etc/hosts along with the
                      remote machine's IP address.

USAGE VARIABLES 

      RUNTIME         This environment variable specifies, in seconds, the 
                      duration of the test.

      local_ftpdir    This environment variable specifies the local directory 
                      to use for creating and copying files.

      remote_ftpdir   This environment variable specifies the remote directory 
                      to use for creating and copying files.

SETUP 

      You need two machines connected by a network, either back-to-back, or
      through a hub or switch.

      Before the tests can run, ensure that the local machine can make
      anonymous ftp transfers to the remote machine. This is described in
      detail in the in.ftpd(1M) man page. Under HCTS, this is set up by the
      setup_anon_ftp.sh script at install time.

OUTPUT 

      The test produces self-explanatory output of the progress of the test.

DURATION 

      24 hours

POSSIBLE CONCURRENT TESTS 

      This test can run concurrently with cl2se2, lsalr, mpflip, rcp, and
      spray.

CAVEATS 

      * If several instances of ftpstress are running at the same time, ensure
        that the test directories are different for each instance.

      * This test requires at least 1.2 Gbytes on the local machine and 600
        Mbytes on the remote host.

EXAMPLES 

      # local_ftpdir=/export/home/tmp
      # remote_ftpdir=incoming/
      # RUNTIME=60
      # ./ftpstress.sh cerberus240

      Beginning ftpstress
      Running time: 60 seconds
      Creating fileset for transfer
      Initiating file transfer
      FTP succeeded: transmitted 568888832 bytes so far
      LOOPTIME: 614
      !PASS: No errors detected in ftp
      #

REFERENCES 

      ftp(1), in.ftpd(1M), netstat(1M), hosts(4), netrc(4), rhosts(4)
