rcp(1C)                        DG/UX R4.11MU05                       rcp(1C)


NAME
       rcp - remote file copy

SYNOPSIS
       rcp [ -p ] filename1 filename2
       rcp [ -pr ]  filename ...  directory

DESCRIPTION
       The rcp command copies files between machines.  Each filename or
       directory argument is either a remote file name of the form:

              hostname:path

       or a local file name (containing no : characters, or a / before any :
       characters).

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

       rcp does not prompt for passwords; your current local user name must
       exist on hostname and allow remote command execution by remsh(1) or
       rsh(1C).

       rcp handles third party copies, where neither source nor target files
       are on the current machine.  Hostnames may also take the form

              username@hostname:filename

       to use username rather than your current local user name as the user
       name on the remote host.  rcp also supports Internet domain
       addressing of the remote host, so that:

              username@host.domain:filename

       specifies the username to be used, the hostname, and the domain in
       which that host resides.  Filenames that are not full path names will
       be interpreted relative to the home directory of the user named
       username, on the remote host.

       The following options are available:

       -p     Attempt to give each copy the same modification times, access
              times, and modes as the original file.

       -r     Copy each subtree rooted at filename; in this case the
              destination must be a directory.

EXAMPLES
            rcp sys8:/udd/test1 test2

       Copies the remote file test1 from host sys8 into the file test2 in
       your current directory.

            rcp -r sys8:net net2

       Copies the contents of the remote directory net into the local
       directory net2.  The destination argument (net2) must either be a
       directory or not exist.  If net2 does not exist, a directory with
       that name will be created.

            rcp wilsonh@sys8:test1 sys9:net/test1

       Copies test1, which is located on the remote machine sys8, into the
       file test1 on the remote machine sys9.  The name wilsonh represents
       the user's username on sys8.

FILES
       $HOME/.profile, $HOME/.rhosts, /etc/hosts.equiv.

DIAGNOSTICS
       If you forget to quote metacharacters intended for the remote host
       you get an incomprehensible error message.

SEE ALSO
       ftp(1C), remsh(1C), rlogin(1C), rshd(1M), hosts.equiv(4M).

NOTES
       rcp cannot detect all cases where it might copy a file onto itself.
       This is especially true if the source or destination file system is
       remotely mounted via NFS.  For instance:

              rcp foo:/a/b/prog.c bar:/c/b/prog.c

       results in a severely corrupted file if the directory c on bar is
       remotely mounted via NFS from directory a on foo.

       rcp does not detect all cases where the target of a copy might be a
       file in cases where only a directory should be legal.

       rcp can become confused by output generated by commands in a
       $HOME/.profile on the remote host.

       rcp requires that the source host have permission to execute commands
       on the remote host when doing third-party copies.


Licensed material--property of copyright holder(s)