RCP(C)                                     UNIX System V



     Name
          rcp - copies files across systems


     Syntax
          rcp [ options ] [srcmachine:]srcfile [destmachine:]destfile


     Description
          rcp copies files between systems in a Micnet  network.   The
          command copies the srcmachine:srcfile to destmachine:destfile,
          where   srcmachine:   and   destmachine:   are  optional
          names   of   systems   in   the  network,   and  srcfile  and
          destfile are pathnames of files.  If a machine name  is  not
          given,  the  name of the current system is assumed.  If - is
          given in place of srcfile, rcp uses the  standard  input  as
          the  source.   Directories  named on the destination machine
          must have write permission, and directories and files  named
          on a remote source machine must have read permission.

          The available options are:

          -m   Mails and reports completion of  the  command,  whether
               there is an error or not.

          -u [machine:]user
               Any mail goes  to  the  named  user  on  machine.   The
               default machine is the machine on which the rcp command
               is completed or on which an error was detected.  If  an
               alias for user exists in the system alias files on that
               machine, the mail will be redirected to the appropriate
               mailbox(es).   Since  system  alias  files  are usually
               identical throughout the network, any specified machine
               will   most   likely  be  overridden  by  the  aliasing
               mechanism.  To prevent aliasing, user must  be  escaped
               with  at least two \ characters (at least four if given
               as a shell command).

          rcp is useful for transferring small numbers of files across
          the   network.    The   network  consists  of  daemons  that
          periodically awaken  and  send  files  from  one  system  to
          another.   The  network must be installed using netutil(ADM)
          before rcp can be used.

          Also, to enable transfer of  files  from  a  remote  system,
          either:

               This line  should  be  in  /etc/default/micnet  on  the
               systems in the network:

                         rcp=/usr/bin/rcp

               Or, these lines should be in that file:

                         executeall
                         execpath=PATH=path

               where path must contain /usr/bin.


     Example
               rcp -m machine1:/etc/mnttab  /tmp/vtape


     See Also
          mail(C), micnet(F), netutil(ADM), remote(C)


     Diagnostics
          If an error occurs, mail is sent to the user.


     Notes
          Full pathnames must be specified for remote files.

          rcp  handles  binary  data  files  transparently,  no  extra
          options  or  protocols are needed to handle them.  Wildcards
          are not expanded on the remote machine.


     (printed 8/28/89)                                  RCP(C)