rcp(1)

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 ":" (colon)  characters,
     or "/" (backslash) before any ":" (colon) characters).

     The hostname can be an IPv4  or  IPv6  address  string.  See
     inet(7P) and inet6(7P). Since IPv6 addresses already contain
     colons, the hostname should be enclosed in a pair of  square
     brackets  when an IPv6 address is used. Otherwise, the first
     occurrence of a colon can be interpreted  as  the  separator
     between hostname and path. For example,

     [1080::8:800:200C:417A]:tmp/file

     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 execu-
     tion by rsh(1).

     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. File names that are not
     full path names will be interpreted  relative  to  the  home
     directory of the user named username, on the remote host.

OPTIONS

     The following options are supported:

     -p    Attempts to  give  each  copy  the  same  modification
           times,  access times, modes, and ACLs if applicable as
           the original file.

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

USAGE

     See largefile(5) for the description of the behavior of  rcp
     when encountering files greater than or equal to 2 Gbyte ( 2
    **31 bytes).

     The rcp command is IPv6-enabled. See ip6(7P).

FILES

     $HOME/.profile

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWrcmdc                   |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|

SEE ALSO

     cpio(1),  ftp(1),  rlogin(1),  rsh(1),  setfacl(1),  tar(1),
     hosts.equiv(4),   attributes(5),   largefile(5),   inet(7P),
     inet6(7P), ip6(7P)

NOTES

     rcp is meant to copy between different hosts. Attempting  to
     rcp a file onto itself, as with:

     example% rcp tmp/file myhost:/tmp/file

     results in a severely corrupted file.

     rcp may not correctly fail when the target of a  copy  is  a
     file instead of a directory.

     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.

     rcp does not properly handle symbolic links. Use tar or cpio
     piped to rsh to obtain remote copies of directories contain-
     ing symbolic links or named pipes. See tar(1) and cpio(1).

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

     rcp will fail if you copy ACLs to a file  system  that  does
     not support ACLs.

     rcp is CSI-enabled except  for  the  handling  of  username,
     hostname, and domain.