RCP(1N)                 COMMAND REFERENCE                 RCP(1N)



NAME
     rcp - remote file copy

SYNOPSIS
     rcp filename1 filename2
     rcp [ -r ] [ -l ] filename ... directory

DESCRIPTION
     Rcp copies files between machines.  Each filename or
     directory argument is either a remote filename of the form
     rhostname:pathname , or a local filename (containing no
     colon (:) characters, or a slash (/) before any colons (:)).

     If the -r is specified and any of the source files are
     directories (and -l is not specified, or the file is not a
     symbolic link), rcp copies each subtree rooted at that name;
     in this case the destination must be a directory.  With -l
     any source file which is a symbolic link will be copied
     without being followed, whether or not it links to a
     directory, and whether or not -r is given.

     If path is not a full pathname, it is interpreted relative
     to your login directory on rhost.  A path on a remote host
     may be quoted (using \, ", or ') so that the metacharacters
     are interpreted remotely.

     Rcp does not prompt for passwords.  Therefore, access to the
     remote system is based on the contents of either of two
     files on the remote system.  Those files are .rhosts in a
     remote user's login directory or /etc/hosts.equiv. See
     rlogin(1n) for more details.  Rcp normally requires the
     current local user name to exist on rhostname . To
     circumvent this requirement, hostnames may take the form
     rhostname.rname to use rname rather than the current user
     name on the remote host.

     Rcp handles third party copies, where neither source nor
     target files are on the current machine.

OPTIONS
     -r  Recursively copy all files and subdirectories from the
         given source directories. With -r, the destination must
         be a directory.

     -l  Copy symbolic links instead of following them.  Copied
         links will look just like the original.

EXAMPLES
          Example:

               rcp host1:"*.c" src




Printed 10/17/86                                                1

RCP(1N)                 COMMAND REFERENCE                 RCP(1N)



     In the above example, rcp copies all files with extensions
     .c in the user's login directory on host1 to the directory
     named src on the local system.  Note that *.c is quoted so
     that the local shell will not attempt to expand the '*'.
     The quotes will, however, be stripped off by the local shell
     so that the shell on the remote host will do the filename
     expansion.

          Example:

               rcp -r host1.jeffm:doc /usr/chrisd



     This example copies the directory doc (in jeffm's home
     directory on host1) and all the files in it (including other
     directories) to chrisd's directory on the local host.  The
     use of '.jeffm' is only necessary if the user initiating the
     rcp is not jeffm.  For this approach to work, the user
     initiating the rcp must appear along with the name of his
     host machine in the .rhosts file in jeffm's home directory.
     (See .rhosts(5n)).

          Example:

               rcp -r file1 file2 host2:file3 host1:dir1



     This example copies the local files file1 and file2 and
     remote file file3 on host2 to the directory dir1 on host1.

DIAGNOSTICS
     Rcp prints error messages received from the remote rcp as
     well as messages generated by the shell on the remote host.

     The latter have the format:
          rcp : Message from rhost: ` <message> '

     If you are using csh(1csh) on the remote system then rcp
     will print any output generated by commands in the remote
     .cshrc file.

RETURN VALUE
     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.



Printed 10/17/86                                                2

RCP(1N)                 COMMAND REFERENCE                 RCP(1N)



     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

     [INTERNAL]     An unexpected error occurred.  Execution was
                    terminated.  Record the message and save the
                    core file for analysis.  Contact service
                    personnel at your Tektronix field office.

SEE ALSO
     ftp(1n), rsh(1n), rlogin(1n). .rhosts(5n), hosts.equiv(5n).








































Printed 10/17/86                                                3

%%index%%
na:72,58;
sy:130,263;
de:393,1949;
op:2342,361;
ex:2703,113;2960,1380;
di:4340,523;
rv:4863,393;5400,598;
se:5998,229;
%%index%%000000000152