RS: fix for fix
[minix.git] / man / man1 / rz.1
blobe0f3f5dbc8233d90bed3cdc77c333a949e8495f2
1 .TH RZ 1
2 .SH NAME
3 rz \- receive a file using the zmodem protocol
4 .SH SYNOPSIS
5 \fBrz\fR [\-\fBabepqvy\fR]\fR [\fB\-t \fItimeout\fR]\fR
6 .br
7 .de FL
8 .TP
9 \\fB\\$1\\fR
10 \\$2
12 .de EX
13 .TP 20
14 \\fB\\$1\\fR
15 # \\$2
17 .SH OPTIONS
18 .TP 5
19 .B \-a
20 # CP/M to UNIX conventions
21 .TP 5
22 .B \-b
23 # Binary file
24 .TP 5
25 .B \-e
26 # Escape for all control characters
27 .TP 5
28 .B \-p
29 # Protect file if it already exists
30 .TP 5
31 .B \-q
32 # Quiet; opposite of verbose
33 .TP 5
34 .B \-t
35 # Set \fItimeout\fR in tenths of a second
36 .TP 5
37 .B \-v
38 # Verbose; opposite of quiet
39 .TP 5
40 .B \-y
41 # Yes, clobber existing files
42 .SH EXAMPLES
43 .TP 20
44 .B rz </dev/tty01 >/dev/tty01
45 # Receive a file
46 .SH DESCRIPTION
47 .PP
48 The XMODEM, YMODEM, and ZMODEM family of file transfer programs are widely
49 used on personal computers.
50 \s-1MINIX 3\s-1
51 supports ZMODEM, the most advanced of the set.
52 The programs \fIsz\fR and \fIrz\fR are used for sending and receiving,
53 respectively.
54 .PP
55 \fIRz\fR and \fIsz\fR are programs that uses an error correcting protocol to 
56 transfer files over a dial-in serial port from a variety of programs 
57 running under various operating systems.
58 \fIRz\fR (Receive ZMODEM) receives files with the ZMODEM batch
59 protocol.  Pathnames are supplied by the sending program,
60 and directories are made if necessary (and possible).
61 The meanings of the available options are:
62 .in +0.25i
63 .ti -0.25i
64 .B \-a
65 .br
66 Convert files to
67 \s-2UNIX\s+2
68 conventions by stripping carriage
69 returns and all characters beginning with the first
70 Control Z (CP/M end of file).
71 .ti -0.25i
72 .B \-b
73 .br
74 Binary (tell it like it is) file transfer override.
75 .ti -0.25i
76 .B \-c
77 .br
78 Request 16 bit CRC.  XMODEM file transfers default to 8
79 bit checksum.  YMODEM and ZMODEM normally use 16 bit CRC.
80 .ti -0.25i
81 .B \-D
82 .br
83 Output file data to /dev/null; for testing. 
84 .ti -0.25i
85 .B \-e
86 .br
87 Force sender to escape all control characters; normally
88 XON, XOFF, DLE, CR-@-CR, and Ctrl-X are escaped.
89 .ti -0.25i
90 .B \-p
91 .br
92 Protect: skip file if destination file exists.
93 .ti -0.25i
94 .B \-q
95 .br
96 Quiet suppresses verbosity.
97 .ti -0.25i
98 .B \-t
99 .br
100 Change timeout tenths of seconds (timeout follows flag).
101 .ti -0.25i
102 .B \-v 
104 Verbose causes a list of file names to be appended to \fI/tmp/rzlog\fR. 
105 More v's generate more output.
106 .ti -0.25i
107 .B \-y
109 Yes, clobber any existing files with the same name.
110 .in -0.25i
111 .SH "SEE ALSO"
112 .BR sz (1),
113 .BR term (1).