.\" SCCSID: @(#)rcp.1c	8.2	3/6/91.TH rcp 1c.SH Namercp \- remote file copy.SH Syntax.B rcp[ \fB\-p\fR ]\fIfile1 file2\fR.br.B rcp[\fB\-r\fR] [\fB\-p\fR] \fIfile... directory\fR.SH Description.NXR "rcp command".NXA "rlogin command" "rcp command".NXA "ftp program" "rcp command".NXA "rsh program" "rcp command".NXR "file" "copying remote"The.PN rcpcommandcopies files between machines.  Each.I fileor.I directoryargument is either a remote file name of theform rhost:path, or a local file name.  Localfile names do not contain colons (:) or backslashes (\\) before colons..PPNote that the.PN rcp command refuses to copy a file onto itself..PPIf.I pathis not a full path name, it is interpreted relative toyour login directory on .IR rhost .To ensure that the metacharacters are interpretedremotely, a remote host's.I pathcan be quoted by either using a backslash (\\) beforea single character, or enclosing character strings in double (") or single (') quotes..PPThe.PN rcpcommand does not prompt for passwords; your current local user namemust exist on.I rhostand allow remote command execution via.MS rsh 1c ..PPThe.PN rcpcommandhandles third party copies, where neither source nor target filesare on the current machine.Hostnames may also take the form rname@rhost to use.I rnamerather than the current user name on the remote host.The following example shows how to copy the file foofrom user1@mach1 to user2@mach2:.EX $ rcp user1@mach1:foo  user2@mach2:foo.EENote that the file .rhosts on mach2 inuser2's account must include an entry for mach1 user1.Also note that it may be necessary for the person implementing the .PN rcpcommand to be listed in the .rhosts file for mach1 user1..PPBy default, the mode and owner of.I file2 are preserved if.I file2already exists.Otherwise, the mode of the source file modified by .MS umask 2on the destination host is used..SH Options.IP \fB\-p\fR 5 Preserves the modification times and modesof the source files in its copies, ignoring the.PN umask ..IP \fB\-r\fRCopies files in all subdirectories recursively, if thefile to be copied is a directory.  In this case thedestination must be a directory.    .SH RestrictionsThe .PN rcpcommand is confused by output generated by commands in a \&.cshrc file on the remote host.In particular, `where are you?' and `stty: Can't assign requested address' are messageswhich can result if output is generated by the startup file..SH See Alsoftp(1c), rlogin(1c), rsh(1c)