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