encode result code with right length, pointed out by Rangar Sundblad, thanks!
[heimdal.git] / appl / rcp / rcp.1
blobe56491cfcb4828ce12c957e469955feaddcfcbbc
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
20 copies files between machines. Each file argument is either a remote file name of the form
21 .Dq rname@rhost:path
22 or a local file (containing no colon or with a slash before the first
23 colon).
24 .Pp
25 Supported 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
35 These options are passed on to
36 .Xr rsh 1 .
37 .It Fl P Ar port
38 This will pass the option
39 .Fl p Ar port
41 .Xr rsh 1 .
42 .It Fl p
43 Preserve file permissions.
44 .It Fl r
45 Copy source directories recursively.
46 .El
47 .\".Sh ENVIRONMENT
48 .\".Sh FILES
49 .\".Sh EXAMPLES
50 .Sh DIAGNOSTICS
51 .Nm rcp
52 is implemented as a protocol on top of
53 .Xr rsh 1 ,
54 and thus requires a working rsh. If you intend to use Kerberos
55 authentication, rsh needs to be Kerberos aware, else you may see more
56 or less strange errors, such as "login incorrect", or "lost
57 connection".
58 .\".Sh SEE ALSO
59 .\".Sh STANDARDS
60 .Sh HISTORY
61 The
62 .Nm rcp
63 utility first appeared in 4.2BSD. This version is derived from
64 4.3BSD-Reno.
65 .\".Sh AUTHORS
66 .\".Sh BUGS