home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Libraries / rzsz 3.24 / rz.doc < prev    next >
Encoding:
Text File  |  1994-05-10  |  10.9 KB  |  331 lines  |  [TEXT/MPS ]
  1.  
  2.  
  3.  
  4.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       rx, rc, rb, rz - Receive Files and Commands with X/Y/ZMODEM
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrrzzzz [-    ttttvvvv]
  13.       rrrrbbbb [-    ttttvvvv]
  14.       rrrrcccc [-    ttttvvvv] _f_i_l_e
  15.       rrrrxxxx [-    ttttvvvv] _f_i_l_e
  16.       ggggzzzz _f_i_l_e ...
  17.       [----][vvvv]rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD
  18.  
  19.      LLLLIIIICCCCEEEENNNNSSSSEEEE AAAAGGGGRRRREEEEEEEEMMMMEEEENNNNTTTT
  20.       This is a Copyrighted    shareware program.  Commercial use of
  21.       this program is subject to licensing conditions detailed in
  22.       the rz.c source code.     "Commercial Use" includes use of this
  23.       program to receive files from    any commercial or shareware
  24.       program not published    by Omen    Technology INC.
  25.  
  26.       Registration information is provided in the file mailer.rz.
  27.  
  28.       Use of this program constitutes agreement to the License
  29.       Agreement.
  30.  
  31.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  32.       This program uses error correcting protocols to receive
  33.       files    over a dial-in serial port from    a variety of programs
  34.       running under    PC-DOS,    CP/M, Unix, and    other operating
  35.       systems.  It is invoked from a shell prompt manually,    or
  36.       automatically    as a result of an "sz file ..."    command    given
  37.       to the calling program.
  38.  
  39.       This program is not designed to be called from _c_u(_1),
  40.       _t_i_p(_1), or other communications programs.  Unix flavors of
  41.       Omen Technology's Professional-YAM communications software
  42.       are available    for dial-out applications.  Unix
  43.       Professional-YAM supports dial-out applications with
  44.       telephone directory, a powerful script language with learn
  45.       function, high quality multiple protocol support, and    UUCP
  46.       port arbitration.
  47.  
  48.  
  49.       RRRRzzzz (Receive ZMODEM) receives one or more files with the
  50.       ZMODEM protocol.  Pathnames are supplied by the sending
  51.       program, and directories are made if necessary (and
  52.       possible).  Normally,    the "rz" command is automatically
  53.       issued by the    calling    ZMODEM program,    but defective ZMODEM
  54.       implementations may require starting _r_z manually.
  55.  
  56.       RRRRbbbb receives file(s) with YMODEM, accepting either standard
  57.       128 byte sectors or 1024 byte    sectors    (YAM sb    ----kkkk option).
  58.       The user should determine when the 1024 byte block length
  59.       actually improves throughput.
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 5/3/93)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       If True YMODEM (Omen Technology trademark) file information
  75.       (file    length,    etc.) is received, the file length controls
  76.       the number of    bytes written to the output dataset, and the
  77.       modify time and file mode (iff non zero) are set
  78.       accordingly.
  79.  
  80.       If True YMODEM file information is not received, slashes in
  81.       the pathname are changed to underscore, and any trailing
  82.       period in the    pathname is eliminated.     This conversion is
  83.       useful for files received from CP/M and other    historical
  84.       systems.
  85.  
  86.       RRRRcccc receives a    single _f_i_l_e with XMODEM-CRC or XMODEM-1k-CRC
  87.       protocol.  The user should determine when the    1024 byte
  88.       block    length actually    improves throughput without causing
  89.       problems.  The user must supply the file name    to both
  90.       sending and receiving    programs.  Up to 1023 garbage
  91.       characters may be added to the received file.
  92.  
  93.       RRRRxxxx receives a    single _f_i_l_e with XMODEM    or XMODEM-1k protocol.
  94.       The user should determine when the 1024 byte block length
  95.       actually improves throughput without causing problems.  The
  96.       user must supply the file name to both sending and receiving
  97.       programs.  Up    to 1023    garbage    characters may be added    to the
  98.       received file.
  99.  
  100.       GGGGzzzz is    a shell    script which calls _s_z to command Pro-YAM or
  101.       ZCOMM    to transmit the    specified files.  Pathnames used with
  102.       _g_z must be escaped if    they have special significance to the
  103.       Unix shell.
  104.       EXAMPLE: gz "-a C:*.c    D:*.h"
  105.  
  106.       If invoked with a leading ``v'', _r_z will report progress to
  107.       /tmp/rzlog.
  108.       EXAMPLE: ln rz vrz; rz=vrz; export rz
  109.  
  110.       If the SHELL environment variable includes _r_s_h or _r_k_s_h
  111.       (restricted shell), _r_z will not accept absolute pathnames or
  112.       references to    a parent directory, will not modify an
  113.       existing file, and removes any files received    in error.
  114.  
  115.  
  116.       The meanings of the available    options    are:
  117.  
  118.       tttt ttttiiiimmmm
  119.            Change timeout to _t_i_m tenths of seconds.
  120.       vvvv    Verbose causes a    list of    file names to be appended to
  121.            /tmp/rzlog .  More v's generate more detailed debugging
  122.            output.
  123.       (Pro-YAM command)
  124.       <_A_L_T-_2>
  125.       Pro-YAM Command: _s_z *._h *._c
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 5/3/93)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       (This    automatically invokes _r_z on the    connected system.)
  141.  
  142.  
  143.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  144.       Exit status is as follows: 0 for successful transfers.  1 if
  145.       unrecoverable    errors are detected.  2    if syntax errors or
  146.       file access problems are detected.  3    if the program was
  147.       terminated by    a caught interrupt.
  148.  
  149.  
  150.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  151.       Professional-YAM, ZCOMM, DSZ,    crc(omen), sz(omen),
  152.       usq(omen), undos(omen)
  153.  
  154.       Compile time options required    for various operating systems
  155.       are described    in the source file.
  156.  
  157.      NNNNOOOOTTTTEEEESSSS
  158.       We have received numerous reports of terminal    servers
  159.       interfering with protocol file transfers.  Sometimes special
  160.       terminal server commands correct the problem.     In other
  161.       cases, the terminal server software is defective and must be
  162.       corrected.
  163.  
  164.       ZMODEM's support of XOFF/XON flow control allows proper
  165.       operation in many environments that do not support XMODEM
  166.       uploads.  Unfortunately, not all Unix    versions support input
  167.       flow control.     The TTY input buffering on some systems may
  168.       not adequately buffer    long blocks or streaming input at high
  169.       speed.  You should suspect this problem when you can't send
  170.       data to the Unix system at high speeds using ZMODEM,
  171.       YMODEM-1k or XMODEM-1k, but YMODEM with 128 byte blocks
  172.       works    properly.
  173.  
  174.       The DSZ or Pro-YAM zzzzmmmmooooddddeeeemmmm llll numeric parameter    may be set to
  175.       a value between 64 and 1024 to limit the burst length
  176.       ("zmodem pl128").  Although this compromises ZMODEM's
  177.       throughput, ZMODEM's superior    reliability remains intact.
  178.  
  179.       If a program that does not properly implement    the specified
  180.       file transfer    protocol causes    _r_z to "hang" the port after a
  181.       failed transfer, either wait for _r_z to time out or keyboard
  182.       a dozen Ctrl-X characters.  Every reported instance of this
  183.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  184.       other    program    with a correct implementation of the specified
  185.       protocol.
  186.  
  187.       Many programs    claiming to support YMODEM only    support    XMODEM
  188.       with 1k blocks, and they often don't get that    quite right.
  189.  
  190.       In the case of a few poorly designed microcomputers, sending
  191.       serial data to a tty port at sustained high speeds has been
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 5/3/93)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.       known    to cause lockups, system halts,    kernel panics, and
  207.       occasional antisocial    behaviour.  This problem is not    unique
  208.       to _r_z; newer versions    of Kermit, CRT terminals with screen
  209.       transmission,    and line noise have the    same effect.  When
  210.       experimenting    with high speed    input to a system, consider
  211.       rebooting the    system if the file transfers are not
  212.       successful, especially if the    personality of the system
  213.       appears altered.
  214.  
  215.       The Unix "ulimit" parameter must be set high enough to
  216.       permit large file transfers to Unix.
  217.  
  218.       Telebit modems must not be set to "spoof" UUCP, XMODEM,
  219.       YMODEM, or KERMIT.  Setting one of these spoofing modes
  220.       interferes with other    protoocls.  Telebit's YMODEM spoofing
  221.       interferes with YMODEM transfers.
  222.  
  223.       32 bit CRC code courtesy Gary    S. Brown.  Directory creation
  224.       code from John Gilmore's PD TAR program.
  225.  
  226.      NNNNEEEETTTTWWWWOOOORRRRKKKK NNNNOOOOTTTTEEEESSSS
  227.       Escaping control characters (sz -E) may help if the transfer
  228.       gets stuck in    the same place on every    attempt.
  229.       Professional-YAM and ZCOMM allow selection of    which control
  230.       characters need to be    escaped.
  231.  
  232.       In extreme cases 7-bit transmission may be required (see
  233.       Professional-YAM/ZCOMM manual).  7-bit transmission requires
  234.       rz version 4.40 or higher.
  235.  
  236.       Please refer to the sz -T command in sz.doc for more help.
  237.  
  238.      BBBBUUUUGGGGSSSS
  239.       This version of _r_z does not support some ZMODEM features.
  240.       Unix flavors of Professional-YAM may be linked to "rz" to
  241.       support these    features.
  242.  
  243.       The ASCII option's CR/LF to NL translation merely deletes
  244.       CR's;    undos(omen) performs a more intelligent    translation.
  245.  
  246.      ZZZZMMMMOOOODDDDEEEEMMMM CCCCAAAAPPPPAAAABBBBIIIILLLLIIIITTTTIIIIEEEESSSS
  247.       _R_z supports ZMODEM command execution (zcommand), incoming
  248.       ZMODEM binary    (-b), ASCII (-a), newer(-n), newer+longer(-N),
  249.       protect (-p),    Crash Recovery(-r), clobber (-y),
  250.       match+clobber    (-Y), compression(-Z), and append (-+)
  251.       requests.  Other options sent    by the sender are ignored.
  252.       The default is protect (-p) and binary (-b).
  253.  
  254.       Unix Professional-YAM    provides higher    performance and    other
  255.       features not supported by _r_z.    Please contact Omen Technology
  256.       Inc for product information.
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                          (printed 5/3/93)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  269.  
  270.  
  271.  
  272.       Omen Technology INC
  273.       Post Office Box 4681
  274.       Portland OR 97208
  275.       503-621-3406
  276.  
  277.  
  278.      FFFFIIIILLLLEEEESSSS
  279.       rz.c,    crctab.c, rbsb.c, zm.c,    zmr.c, zmodem.h, rz.1
  280.  
  281.       /tmp/rzlog stores debugging output generated with -vv    option
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                          (printed 5/3/93)
  328.  
  329.  
  330.  
  331.