|
|
1.1 root 1: .\" Copyright (c) 1983 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)rcp.1 6.5 (Berkeley) 9/16/87
6: .\"
7: .TH RCP 1C "September 16, 1987"
8: .UC 5
9: .SH NAME
10: rcp \- remote file copy
11: .SH SYNOPSIS
12: .B rcp
13: [
14: .B \-p
15: ] file1 file2
16: .br
17: .B rcp
18: [
19: .B \-p
20: ] [
21: .B \-r
22: ] file ... directory
23: .SH DESCRIPTION
24: .I Rcp
25: copies files between machines. Each
26: .I file
27: or
28: .I directory
29: argument is either a remote file name of the
30: form ``rhost:path'', or a local file name (containing no `:' characters,
31: or a `/' before any `:'s).
32: .PP
33: If the
34: .B \-r
35: option
36: is specified and any of the source files are directories,
37: .I rcp
38: copies each subtree rooted at that name; in this case
39: the destination must be a directory.
40: .PP
41: By default, the mode and owner of
42: .I file2
43: are preserved if it already existed; otherwise the mode of the source file
44: modified by the
45: .IR umask (2)
46: on the destination host is used.
47: The
48: .B \-p
49: option causes
50: .I rcp
51: to attempt to preserve (duplicate) in its copies the modification
52: times and modes of the source files, ignoring the
53: .IR umask .
54: .PP
55: If
56: .I path
57: is not a full path name, it is interpreted relative to
58: your login directory on
59: .IR rhost .
60: A
61: .I path
62: on a remote host may be quoted (using \e, ", or \(aa)
63: so that the metacharacters are interpreted remotely.
64: .PP
65: .I Rcp
66: does not prompt for passwords; your current local user name
67: must exist on
68: .I rhost
69: and allow remote command execution via
70: .IR rsh (1C).
71: .PP
72: .I Rcp
73: handles third party copies, where neither source nor target files
74: are on the current machine.
75: Hostnames may also take the form ``rname@rhost'' to use
76: .I rname
77: rather than the current user name on the remote host.
78: .SH SEE ALSO
79: cp(1), ftp(1C), rsh(1C), rlogin(1C)
80: .SH BUGS
81: Doesn't detect all cases where the target of a copy might
82: be a file in cases where only a directory should be legal.
83: .PP
84: Is confused by any output generated by commands in a
85: \&.login, \&.profile, or \&.cshrc file on the remote host.
86: .PP
87: The destination user and hostname may have to be specified as
88: ``rhost.rname'' when the destination machine is running the 4.2BSD
89: version of \fIrcp\fP.
90:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.