home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_200 / 260_01 / rz.doc < prev    next >
Text File  |  1988-02-25  |  4KB  |  102 lines
  1. RZ(1)OMEN                                                            RZ(1)OMEN
  2.  
  3.  
  4. NAME
  5.         rz - XMODEM, YMODEM, ZMODEM (Batch) file receive 
  6.  
  7.                 
  8. SYNOPSIS
  9.         rz [-2abuv] [-s<speed>] [-]      (ZMODEM Batch)
  10.         rz [-2abuv] [-s<speed>] [-] -Y   (YMODEM Batch)
  11.         rz [-2abcv] [-s<speed>] file     (XMODEM)
  12.         
  13. DESCRIPTION
  14.         This program uses error correcting protocol to receive  files 
  15.         over  a serial port from a variety of programs running under Unix,
  16.         PC-DOS, CP/M, and other operating systems.  
  17.  
  18.         Rz (Receive  ZMODEM) receives files with the ZMODEM batch protocol.
  19.         If the sending program does not support ZMODEM, rz steps down to
  20.         YMODEM protocol after 50 seconds. This delay can be eliminated by
  21.         calling the program as rz -Y.
  22.  
  23.         When receiving with XMODEM or YMODEM, rz accepts either standard
  24.         128 byte sectors or 1024 byte sectors (YAM -k option).  The user
  25.         should determine when the longer block length actually improves
  26.         throughput without causing problems.  
  27.  
  28.         If extended file information (file length, etc.) is received,
  29.         the file length  controls  the  number  of  bytes written to
  30.         the output dataset (YMODEM only), and the modify time and file
  31.         mode (if non zero) are set accordingly.  
  32.  
  33.         If no extended file information is received, slashes in the
  34.         pathname are changed to underscore, and any trailing period in the
  35.         pathname is eliminated. This conversion is useful for files received
  36.         from CP/M systems.
  37.  
  38.         The second form of receives a single with XMODEM protocol. The
  39.         user must supply the file name to both sending and receiving
  40.         programs. rz -X file
  41.  
  42.         If rz is invoked with stdout and stderr to different datasets,
  43.         Verbose is set to 2, causing frame by frame progress reports
  44.         to stderr. This may be disabled with the q option.  
  45.  
  46.         The meanings of the available options are: 
  47.         
  48.         2       Use COM2 instead of COM1 (MS-DOS only). By default,
  49.                 COM1 is used.
  50.         
  51.         a       Convert files to Unix conventions by stripping carriage
  52.                 returns and all characters beginning with the first
  53.                 Control Z (CP/M end of file).
  54.         
  55.         b       Binary (tell it like it is) file transfer override. 
  56.         
  57.         c       Request 16 bit CRC. XMODEM file transfers default to 8
  58.                 bit checksum. YMODEM and ZMODEM  normally use 16 bit CRC.
  59.         
  60.         p       Protect: skip file if destination file exists.
  61.         
  62.         q       Quiet suppresses verbosity.
  63.         
  64.         t tim   Change timeout to tim tenths of seconds.
  65.         
  66.         v       Verbose causes a list of file names to be appended to
  67.                 /tmp/rzlog. More v's generate more output.
  68.  
  69. SEE ALSO
  70.  
  71.         ZMODEM.DOC, YMODEM.DOC, IMP(CP/M), cu(1), Professional-YAM manual,
  72.         sz(omen), usq(omen), undos(omen) 
  73.  
  74.         
  75. NOTES
  76.         32 bit CRC code courtesy Gary S.Brown.        
  77.         
  78.         
  79. BUGS
  80.         Pathnames are restricted to 127 characters. In XMODEM single file
  81.         mode, the pathname given on the command line is still processed as
  82.         described above. The ASCII option's CR/LF to NL translation merely
  83.         deletes CR's; undos(omen) performs a more intelligent translation.  
  84.  
  85.         Non binary file processing consists of stripping all characters
  86.         beginning with CPMEOF (^Z).  
  87.         
  88. FILES        
  89.         /tmp/rzlog stores debugging output generated with -vv option.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.