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

TEST NAME 

      rcp rcpdisk rcptree - copy files from one machine to another 

SYNOPSIS 

      sh rcp.sh REMOTE-MACHINE
      sh rcpdisk.sh REMOTE-MACHINE
      sh rcptree.sh REMOTE-MACHINE

DESCRIPTION 

      These tests use the 'rcp' command to copy files from one machine to another. The
      tests terminate if any file becomes corrupted. 

OPERANDS 

      REMOTE-MACHINE   Either the host name or IP address of the machine to
                       which files and directories are copied. If the host name
                       is specified, 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. 

SETUP 

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

      Before this test is run, change the following files to ensure that the 
      local host has remote login permissions: 

      $HOME/.rhosts         add hostname 
      /etc/default/login    comment-out CONSOLE variable 

      Ensure that sufficient disk space is available on the remote machine for
      copying.

OUTPUT 

      At the start of each iteration, the current time is output. 

DURATION 

      24 hours 

POSSIBLE CONCURRENT TESTS 

      You can run this test concurrently with lsalr, mpflip, cl2se2, ftpstress, and spray. 

NOTES 

      * Check the login permissions as described in 'SETUP'.

      * The rcp test copies /kernel/unix on the local machine to /tmp on the
        remote machine.

      * The rcpdisk test copies also, but creates more remote disk activity by
        copying to remote:/usr/tmp instead.

      * The rcptree test copies the whole /kernel tree to remote:/tmp.

EXAMPLES 

      # RUNTIME=30
      # export RUNTIME
      # ./rcp.sh dellboy240 
      Runtime: 30 seconds
      Changing local directory to /tmp
      Thursday March  2 13:52:21 GMT 2000
      Thursday March  2 13:52:29 GMT 2000
      Thursday March  2 13:52:37 GMT 2000
      Thursday March  2 13:52:46 GMT 2000
      !PASS: Completed 5 copies successfully
      #

REFERENCES 

      rcp(1), rlogin(1), rsh(1), hosts(4), rhosts(4) 
