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