home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 225.lha / AmigaZmodem / rz.doc < prev    next >
Encoding:
Text File  |  1989-04-08  |  7.5 KB  |  269 lines
  1.  
  2.  
  3.  
  4. RZ(1)               UNIX Programmer's Manual                RZ(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rx, rb, rz - XMODEM, YMODEM, ZMODEM (Batch) file receive
  10.  
  11. SYNOPSIS
  12.      rz [- +1abepqtuv]
  13.      rb [- +1abqtuv]
  14.      rz [- 1abceqtuv] file
  15.      gz file ...
  16. >Not implemented in amiga version
  17. >     [-][v]rzCOMMAND
  18.  
  19. DESCRIPTION
  20.      This program uses error correcting protocol to receive files
  21.      over a serial port from a variety of programs running under
  22.      AmigaDos,PC-DOS, CP/M, Unix, and other operating systems.
  23.  
  24.      The first form of rz (Receive ZMODEM) receives files with
  25.      the ZMODEM batch protocol.  If the sending program does not
  26.      support ZMODEM, rz steps down to YMODEM protocol after 50
  27.      seconds.  This delay can be eliminated by invoking the pro-
  28.      gram as rb .
  29.  
  30.      When receiving with XMODEM or YMODEM, Rz accepts either
  31.      standard 128 byte sectors or 1024 byte sectors (YAM -k
  32.      option).  The user should determine when the longer block
  33.      length actually improves throughput without causing prob-
  34.      lems.
  35.  
  36.      If extended file information (file length, etc.) is
  37.      received, the file length controls the number of bytes writ-
  38.      ten to the output dataset (YMODEM only), and the modify time
  39.      and file mode (iff non zero) are set accordingly.
  40.  
  41.      If no extended file information is received, slashes in the
  42.      pathname are changed to underscore, and any trailing period
  43.      in the pathname is eliminated.  This conversion is useful
  44.      for files received from CP/M systems.  With YMODEM, each
  45.      file name is converted to lower case unless it contains one
  46.      or more lower case letters.
  47.  
  48.  
  49.      The second form of rz receives a single file with XMODEM
  50.      protocol.    The user must supply the file name to both send-
  51.      ing and receiving programs.
  52.  
  53.  
  54.      Gz is a shell script which calls sz to command Pro-YAM or
  55.      ZCOMM to transmit the specified files.  Pathnames used with
  56.      gz must be escaped if they have special significance to the
  57.      Unix shell.
  58.      EXAMPLE: gz "-a C:*.c D:*.h"
  59.  
  60. >Not implemented in amiga version
  61. >     The third form of rz is invoked as rzCOMMAND (with an
  62.  
  63.  
  64.  
  65. Printed 10/25/87          OMEN                1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. RZ(1)               UNIX Programmer's Manual                RZ(1)
  73.  
  74.  
  75.  
  76. >     optional leading - as generated by login(1)).  For each
  77. >     received file, rz will pipe the file to ``COMMAND filename''
  78. >     where filename is the name of the transmitted file with the
  79. >     file contents as standard input.
  80. >
  81. >     Each file transfer is acknowledged when COMMAND exits with 0
  82. >     status.  A non zero exit status terminates transfers.
  83. >
  84. >     A typical use for this form is rzrmail which calls rmail(1)
  85. >     to post mail to the user specified by the transmitted file
  86. >     name.  For example, sending the file "caf" from a PC-DOS
  87. >     system to rzrmail on a Unix system would result in the con-
  88. >     tents of the DOS file "caf" being mailed to user "caf".
  89. >
  90. >     On some Unix systems, the login directory must contain a
  91. >     link to COMMAND as login sets SHELL=rsh which disallows
  92. >     absolute pathnames.  If invoked with a leading ``v'', rz
  93. >     will report progress to /tmp/rzlog.  The following entry
  94. >     works for Unix 3.0:
  95. >         rzrmail::5:1::/bin:/usr/local/rzrmail
  96. >     If the SHELL environment variable includes rsh or rksh (res-
  97. >     tricted shell), rz will not accept absolute pathnames or
  98. >     references to a parent directory, will not modify an exist-
  99. >     ing file, and removes any files received in error.
  100. >
  101. >     If rz is invoked with stdout and stderr to different
  102. >     datasets, Verbose is set to 2, causing frame by frame pro-
  103. >     gress reports to stderr.    This may be disabled with the q
  104. >     option.
  105. >
  106. >
  107.       The meanings of the available options are:
  108.  
  109. >Not implemented in amiga version
  110. >
  111. >     1    Use file descriptor 1 for ioctls and reads (Unix only).
  112. >       By default, file descriptor 0 is used for ioctls and
  113. >       reads.  This option allows rz to be used with the
  114. >       Professional-YAM $ command and some versions of ncu(1).
  115.      a      Convert files to Unix conventions by stripping carriage
  116.       returns and all characters beginning with the first
  117.       Control Z (CP/M end of file).
  118.      b      Binary (tell it like it is) file transfer override.
  119.      c      Request 16 bit CRC.  XMODEM file transfers default to 8
  120.       bit checksum.  YMODEM and ZMODEM normally use 16 bit
  121.       CRC.
  122.      D      Output file data to /dev/null; for testing.
  123.      e      Force sender to escape all control characters; normally
  124.       XON, XOFF, DLE, CR-@-CR, and Ctrl-X are escaped.
  125.      p      (ZMODEM) Protect: skip file if destination file exists.
  126.      q      Quiet suppresses verbosity.
  127.      t tim
  128.       Change timeout to tim tenths of seconds.
  129.      v      Verbose causes a list of file names to be appended to
  130.  
  131.  
  132.  
  133. Printed 10/25/87          OMEN                2
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140. RZ(1)               UNIX Programmer's Manual                RZ(1)
  141.  
  142.  
  143.  
  144.       /tmp/rzlog .    More v's generate more output.
  145.  
  146. EXAMPLES
  147.      (Pro-YAM command)
  148.      <ALT-2>
  149.      Pro-YAM Command: sz *.h *.c
  150.      (This automatically invokes rz on the connected system.)
  151.  
  152. SEE ALSO
  153.      ZMODEM.DOC, YMODEM.DOC, IMP(CP/M), Professional-YAM,
  154.      sz(omen), usq(omen), undos(omen)
  155.  
  156.      Compile time options required for various operating systems
  157.      are described in the source file.
  158.  
  159. NOTES
  160.      The Unix "ulimit" parameter must be set high enough to per-
  161.      mit large file transfers.
  162.  
  163.      The TTY input buffering on some systems may not allow long
  164.      blocks or streaming input at high speed.  You should suspect
  165.      this problem when you can't send data to the Unix system at
  166.      high speeds using ZMODEM when YMODEM with 128 byte blocks
  167.      works properly.  If the system's tty line handling is really
  168.      broken, the serial port or the entire system may not survive
  169.      the onslaught of long bursts of high speed data.
  170.  
  171.      The DSZ or Pro-YAM zmodem l numeric parameter may be set to
  172.      a value between 64 and 1024 to limit the burst length ("zmo-
  173.      dem pl128").
  174.  
  175.      32 bit CRC code courtesy Gary S. Brown.
  176.  
  177. BUGS
  178.      Calling rz from most versions of cu(1) doesn't work because
  179.      cu's receive process fights rz for characters from the
  180.      modem.
  181.  
  182.      Pathnames are restricted to 127 characters.  In XMODEM sin-
  183.      gle file mode, the pathname given on the command line is
  184.      still processed as described above.  The ASCII option's
  185.      CR/LF to NL translation merely deletes CR's; undos(omen)
  186.      performs a more intelligent translation.
  187.  
  188. VMS VERSION
  189.      Some of the #includes with file names enclosed with angle
  190.      brackets <> may need to have the angle brackets changed to
  191.      "", or vice versa.
  192.  
  193.      The VMS version does not set binary mode according to the
  194.      incoming file type.  Non binary file processing consists of
  195.      stripping all characters beginning with CPMEOF (^Z).
  196.  
  197.  
  198.  
  199. Printed 10/25/87          OMEN                3
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206. RZ(1)               UNIX Programmer's Manual                RZ(1)
  207.  
  208.  
  209.  
  210.      The VMS version does not set the file time.
  211.  
  212.      At high speeds, VMS sometimes loses incoming characters,
  213.      resulting in retries and degradation of throughput.
  214.  
  215.      The mysterious VMS C Standard I/O Package and RMS may
  216.      interact to modify file contents unexpectedly.
  217.  
  218.      The VMS version does not support invocation as rzCOMMAND .
  219.      ZMODEM has not yet been implemented on the VMS version.
  220.  
  221. ZMODEM CAPABILITIES
  222.      Rz supports incoming ZMODEM binary (-b), ASCII (-a), protect
  223.      (-p), and append (-+) requests, and ZMODEM command execu-
  224.      tion.
  225.  
  226. FILES
  227.      rz.c, rbsb.c, zm.c, zmodem.h source files.
  228.  
  229.      /tmp/rzlog stores debugging output generated with -vv
  230.      option.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265. Printed 10/25/87          OMEN                4
  266.  
  267.  
  268.  
  269.