Patrick Welche <prlw1@cam.ac.uk>
[netbsd-mini2440.git] / crypto / dist / heimdal / appl / rcp / rcp.1
blobb0737e8495da9b9632526ee5f5550e50b44e3fda
1 .\" $Heimdal: rcp.1 12025 2003-04-16 12:20:43Z joda $
2 .\" $NetBSD$
3 .\"
4 .Dd April 16, 2003
5 .Dt RCP 1
6 .Os
7 .Sh NAME
8 .Nm rcp
9 .Nd
10 copy file to and from remote machines
11 .Sh SYNOPSIS
12 .Nm rcp
13 .Op Fl 45FKpxz
14 .Op Fl P Ar port
15 .Ar file1 file2
16 .Nm rcp
17 .Op Fl 45FKprxz
18 .Op Fl P Ar port
19 .Ar file... directory
20 .Sh DESCRIPTION
21 .Nm rcp
22 copies files between machines. Each file argument is either a remote file name of the form 
23 .Dq rname@rhost:path
24 or a local file (containing no colon or with a slash before the first
25 colon).
26 .Pp
27 Supported options:
28 .Bl -tag -width Ds
29 .It Xo
30 .Fl 4 , 
31 .Fl 5 , 
32 .Fl K , 
33 .Fl F , 
34 .Fl x , 
35 .Fl z
36 .Xc
37 These options are passed on to
38 .Xr rsh 1 .
39 .It Fl P Ar port
40 This will pass the option
41 .Fl p Ar port
42 to 
43 .Xr rsh 1 .
44 .It Fl p
45 Preserve file permissions.
46 .It Fl r
47 Copy source directories recursively.
48 .El
49 .\".Sh ENVIRONMENT
50 .\".Sh FILES
51 .\".Sh EXAMPLES
52 .Sh DIAGNOSTICS
53 .Nm rcp
54 is implemented as a protocol on top of
55 .Xr rsh 1 ,
56 and thus requires a working rsh. If you intend to use Kerberos
57 authentication, rsh needs to be Kerberos aware, else you may see more
58 or less strange errors, such as "login incorrect", or "lost
59 connection".
60 .\".Sh SEE ALSO
61 .\".Sh STANDARDS
62 .Sh HISTORY
63 The 
64 .Nm rcp
65 utility first appeared in 4.2BSD. This version is derived from
66 4.3BSD-Reno.
67 .\".Sh AUTHORS
68 .\".Sh BUGS