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