projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| b1691f10 C |
1 | .TH RCP 1C "17 March 1982" |
| 2 | .UC 4 | |
| 3 | .SH NAME | |
| 4 | rcp \- remote file copy | |
| 5 | .SH SYNOPSIS | |
| 6 | .B rcp | |
| 7 | file1 file2 | |
| 8 | .br | |
| 9 | .B rcp | |
| 10 | [ | |
| 11 | .B \-r | |
| 12 | ] file ... directory | |
| 13 | .SH DESCRIPTION | |
| 14 | .I Rcp | |
| 15 | copies files between machines. Each | |
| 16 | .I file | |
| 17 | or | |
| 18 | .I directory | |
| 19 | argument is either a remote file name of the | |
| 20 | form ``rhost:path'', or a local file name (containing no `:' characters, | |
| 21 | or a `/' before any `:'s.) | |
| 22 | .PP | |
| 23 | If the | |
| 24 | .B \-r | |
| 25 | is specified and any of the source files are directories, | |
| 26 | .I rcp | |
| 27 | copies each subtree rooted at that name; in this case | |
| 28 | the destination must be a directory. | |
| 29 | .PP | |
| 30 | If | |
| 31 | .I path | |
| 32 | is not a full path name, it is interpreted relative to | |
| 33 | your login directory on | |
| 34 | .IR rhost . | |
| 35 | A | |
| 36 | .I path | |
| 37 | on a remote host may be quoted (using \e, ", or \(aa) | |
| 38 | so that the metacharacters are interpreted remotely. | |
| 39 | .PP | |
| 40 | .I Rcp | |
| 41 | does not prompt for passwords; your current local user name | |
| 42 | must exist on | |
| 43 | .I rhost | |
| 44 | and allow remote command execution via | |
| 45 | .IR rsh (1C). | |
| 46 | .PP | |
| 47 | .I Rcp | |
| 48 | handles third party copies, where neither source nor target files | |
| 49 | are on the current machine. | |
| 50 | Hostnames may also take the form ``rhost.rname'' to use | |
| 51 | .I rname | |
| 52 | rather than the current user name on the remote host. | |
| 53 | .SH SEE ALSO | |
| 54 | ftp(1C), rsh(1C), rlogin(1C) | |
| 55 | .SH BUGS | |
| 56 | Doesn't detect all cases where the target of a copy might | |
| 57 | be a file in cases where only a directory should be legal. | |
| 58 | .br | |
| 59 | Is confused by any output generated by commands in a | |
| 60 | \&.login, \&.profile, or \&.cshrc file on the remote host. |