minix/commands/zmodem/rz.1

   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
  11 ..
  12 .de EX
  13 .TP 20
  14 \\fB\\$1\\fR
  15 # \\$2
  16 ..
  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
 103 .br
 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
 108 .br
 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).