home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / TELECOM / rzsz_3_36_3_src.lzh / rz.doc < prev    next >
Text File  |  1996-01-08  |  16KB  |  397 lines
  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 any use of
  23.       this program to receive files    from a 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.      SSSSUUUUPPPPPPPPOOOORRRRTTTT
  32.       Unregistered users may dial 900-737-7836 (900-737-RTFM) for
  33.       technical assistance.     There is a charge of $4.69 per    minute
  34.       to use this support line.  Callers must be 18    years or
  35.       older.
  36.  
  37.       Registered users encountering    problems using this program on
  38.       standard serial ports    to transfer files with Professional-
  39.       YAM or ZCOMM may call    the support number listed in the
  40.       Professional-YAM/ZCOMM documentation.     Solutions to nearly
  41.       all file transfer problems are described in the
  42.       Professional-YAM/ZCOMM documentation.
  43.  
  44.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.       This program uses error correcting protocols to receive
  46.       files    over a dial-in serial port from    a variety of programs
  47.       running under    PC-DOS,    CP/M, Unix, and    other operating
  48.       systems.  It is invoked from a shell prompt manually,    or
  49.       automatically    as a result of an "sz file ..."    command    given
  50.       to the calling program.
  51.  
  52.       To obtain the    maximum    performance and    full functionality of
  53.       this program we recommend its    use with GSZ, Professional-YAM
  54.       or ZCOMM.
  55.  
  56.       This program is intended to interface    with terminal
  57.       programs, not    to act as one.    This program is    not designed
  58.       to be    called from _c_u(_1), _t_i_p(_1), or other communications
  59.       programs.  Unix flavors of Omen Technology's Professional-
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 3/30/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       YAM communications software are suitable for dial-out
  75.       applications.     Unix Professional-YAM supports    dial-out
  76.       applications with telephone directory, a powerful script
  77.       language with    learn function,    high quality multiple protocol
  78.       support, and UUCP port arbitration.
  79.  
  80.  
  81.       RRRRzzzz (Receive ZMODEM) receives one or more files with the
  82.       ZMODEM protocol.  Pathnames are supplied by the sending
  83.       program, and directories are made if necessary (and
  84.       possible).  Normally,    the "rz" command is automatically
  85.       issued by the    calling    ZMODEM program,    but defective ZMODEM
  86.       implementations may require starting _r_z manually.
  87.  
  88.       RRRRbbbb receives file(s) with YMODEM, accepting either standard
  89.       128 byte sectors or 1024 byte    sectors    (Pro-YAM/ZCOMM sb ----kkkk
  90.       option).  The    user should determine when the 1024 byte block
  91.       length actually improves throughput.
  92.  
  93.       If True YMODEM (Omen Technology trademark) file information
  94.       (file    length,    etc.) is received, the file length controls
  95.       the number of    bytes written to the output dataset, and the
  96.       modify time and file mode (iff non zero) are set
  97.       accordingly.
  98.  
  99.       If True YMODEM file information is not received, slashes in
  100.       the pathname are changed to underscore, and any trailing
  101.       period in the    pathname is eliminated.     This conversion is
  102.       useful for files received from CP/M and other    historical
  103.       systems.
  104.  
  105.       RRRRcccc receives a    single _f_i_l_e with XMODEM-CRC or XMODEM-1k-CRC
  106.       protocol.  The user should determine when the    1024 byte
  107.       block    length actually    improves throughput without causing
  108.       problems.  The user must supply the file name    to both
  109.       sending and receiving    programs.  Up to 1023 garbage
  110.       characters may be added to the received file.
  111.  
  112.       RRRRxxxx receives a    single _f_i_l_e with XMODEM    or XMODEM-1k protocol.
  113.       The user should determine when the 1024 byte block length
  114.       actually improves throughput without causing problems.  The
  115.       user must supply the file name to both sending and receiving
  116.       programs.  Up    to 1023    garbage    characters may be added    to the
  117.       received file.
  118.  
  119.       GGGGzzzz is    a shell    script which calls _s_z to command Pro-YAM or
  120.       ZCOMM    to transmit the    specified files.  Pathnames used with
  121.       _g_z must be escaped if    they have special significance to the
  122.       Unix shell.
  123.       EXAMPLE: gz "-a C:*.c    D:*.h"
  124.  
  125.       If invoked with a leading ``v'', _r_z will report progress to
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 3/30/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       /tmp/rzlog.
  141.       EXAMPLE: ln rz vrz; rz=vrz; export rz
  142.  
  143.       If the SHELL environment variable includes _r_s_h or _r_k_s_h
  144.       (restricted shell), _r_z will not accept absolute pathnames or
  145.       references to    a parent directory, will not modify an
  146.       existing file, and removes any files received    in error.
  147.  
  148.  
  149.       The meanings of the available    options    are:
  150.  
  151.       ttttttttiiiimmmm Change timeout to _t_i_m tenths of seconds.
  152.       vvvv    Verbose causes a    list of    file names to be appended to
  153.            /tmp/rzlog .  More v's generate more detailed debugging
  154.            output.
  155.       (Pro-YAM command)
  156.       <_A_L_T-_2>
  157.       Pro-YAM Command: _s_z *._h *._c
  158.       This automatically invokes _r_z    on the connected system, and
  159.       sends    all .h and .c files in the current directory.
  160.  
  161.       _s_z -_n    -_R_f .
  162.       This Professional-YAM    command    recursively follows the
  163.       current directory tree (.) (Pro-YAM -R option), sends    the
  164.       full relative    pathname (-f), for files that are newer    (-n)
  165.       than their copies on the destination system.
  166.  
  167.  
  168.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  169.       Exit status is as follows: 0 for successful transfers.  1 if
  170.       unrecoverable    errors are detected.  2    if syntax errors or
  171.       file access problems are detected.  3    if the program was
  172.       terminated by    a caught interrupt.
  173.  
  174.  
  175.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  176.       Professional-YAM, ZCOMM, DSZ,    crc(omen), sz(omen),
  177.       usq(omen), undos(omen)
  178.  
  179.       Compile time options required    for various operating systems
  180.       are described    in the source file.
  181.  
  182.      SSSSEEEERRRRVVVVEEEERRRR////NNNNEEEETTTTWWWWOOOORRRRKKKK NNNNOOOOTTTTEEEESSSS
  183.       Terminals on some timesharing    systems    are connected
  184.       indirectly to    the host with TTTTEEEERRRRMMMMIIIINNNNAAAALLLL SSSSEEEERRRRVVVVEEEERRRRSSSS operating over
  185.       networks.  Terminal servers often interfere with file
  186.       transfers by "eating"    control    characters and/or losing data.
  187.  
  188.       When terminal    servers    interfere with file transfers, server
  189.       commands are often available to help the problem.  When
  190.       possible, enable the server and modems for hardware flow
  191.       control in and out.  Set the terminal    server to telnet
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 3/30/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.       transparent mode.  Some typical commands are "SET TERMINAL
  207.       DOWNLOAD", "set session passall", and    "SET TERMINAL NO ESC",
  208.       but there is no standard set of commands suitable for    all
  209.       terminal servers.  Normally these commands are given before
  210.       attempting file transfers, but one user has reported that
  211.       the command must be given _a_f_t_e_r the file transfer is
  212.       started(!).  Until terminal server vendors improve the
  213.       quality of their product, you    may have to get    on their case
  214.       until    they adequately    support    high performance file
  215.       transfers.
  216.  
  217.       Escaping control characters (sz -e) may help if the transfer
  218.       gets stuck in    the same place on every    attempt.
  219.       Professional-YAM and ZCOMM allow selection of    which control
  220.       characters need to be    escaped.  In extreme cases 7-bit
  221.       transmission may be required (see the    Professional-YAM/ZCOMM
  222.       manual).
  223.  
  224.       If you encounter problems with control characters Please
  225.       refer    to the sz -T command in    sz.doc for more    help.
  226.  
  227.       Flow control between the server and modem is often
  228.       defective.  This rarely causes a problem in interactive
  229.       applications whose short bursts (a screenfull    at most) fit
  230.       within the available memory buffers.    Streaming protocols
  231.       such as YMODEM-g, long packet    SuperKermit, and ZMODEM    can
  232.       overload the available buffering.  Some terminal servers
  233.       support commands to enable hardware flow control such    as
  234.       "TERM    FLOWCONTROL HARDWARE IN    OUT"; this assumes the modem
  235.       attached to the server is properly configured.
  236.  
  237.       If the terminal server is too    brain damaged to support flow
  238.       control, you can fake    it with    ZMODEM.     Try "sz -
  239.       w1024    file..." to enable software flow control. Experiment
  240.       with different values    to find    the best throughput.
  241.  
  242.       Terminal servers are designed    to accept keyboard input from
  243.       human    operators.  They may lose data when a program sends
  244.       data to the host faster than humans type.  Some servers
  245.       allow    larger input buffers to    support    file uploads.  If you
  246.       can upload short files (less than 100    bytes) but not longer
  247.       files, try "sz -w1024    file..." with your uploading program.
  248.       (Not all programs support this option; use ZCOMM or
  249.       Professional-YAM.)
  250.  
  251.       When both flow control and character transparency are
  252.       problems, use    "sz -ew1024 file..." as    a starting point.
  253.  
  254.       Sometimes the    terminal server    software is defective and must
  255.       be upgraded.    Please contact the network's vendor for
  256.       corrective procedures.  An alternative is to install direct
  257.       serial ports for users desiring to upload files.
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 3/30/94)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  269.  
  270.  
  271.  
  272.       Some systems enforce a timeout which disconnects a user
  273.       after    several    minutes    of no keyboarding.  This can cause
  274.       problems in long, error free ZMODEM transfers.  Restricting
  275.       the window size with a "-w8192" option provides terminal
  276.       input    at regular intervals even when no error    correction is
  277.       needed.  If problems persist,    try setting a packet length
  278.       (sz -l1024).
  279.  
  280.  
  281.      NNNNOOOOTTTTEEEESSSS
  282.       ZMODEM's support of XOFF/XON flow control allows proper
  283.       operation in many environments that do not support XMODEM
  284.       uploads.  Unfortunately, not all Unix    versions support input
  285.       flow control.     The TTY input buffering on some systems may
  286.       not adequately buffer    long blocks or streaming input at high
  287.       speed.  You should suspect this problem when you can't send
  288.       data to the Unix system at high speeds using ZMODEM,
  289.       YMODEM-1k or XMODEM-1k, but YMODEM with 128 byte blocks
  290.       works    properly.
  291.  
  292.       The DSZ or Pro-YAM zzzzmmmmooooddddeeeemmmm llll numeric parameter    may be set to
  293.       a value between 64 and 1024 to limit the burst length
  294.       ("zmodem pl128").  Although this compromises ZMODEM's
  295.       throughput, ZMODEM's superior    reliability remains intact.
  296.  
  297.       If a program that does not properly implement    the specified
  298.       file transfer    protocol causes    _r_z to "hang" the port after a
  299.       failed transfer, either wait for _r_z to time out or keyboard
  300.       a dozen Ctrl-X characters.  Every reported instance of this
  301.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  302.       other    program    with a correct implementation of the specified
  303.       protocol.
  304.  
  305.       Many programs    claiming to support YMODEM only    support    XMODEM
  306.       with 1k blocks, and they often don't get that    quite right.
  307.  
  308.       In the case of a few poorly designed microcomputers, sending
  309.       serial data to a tty port at sustained high speeds has been
  310.       known    to cause lockups, system halts,    kernel panics, and
  311.       occasional antisocial    behaviour.  This problem is not    unique
  312.       to _r_z; newer versions    of Kermit, CRT terminals with screen
  313.       transmission,    and line noise have the    same effect.  When
  314.       experimenting    with high speed    input to a system, consider
  315.       rebooting the    system if the file transfers are not
  316.       successful, especially if the    personality of the system
  317.       appears altered.
  318.  
  319.       The Unix "ulimit" parameter must be set high enough to
  320.       permit large file transfers to Unix.
  321.  
  322.       Telebit modems must not be set to "spoof" UUCP, XMODEM,
  323.       YMODEM, or KERMIT.  Setting one of these spoofing modes
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 3/30/94)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  335.  
  336.  
  337.  
  338.       interferes with other    protocols.  Telebit's YMODEM spoofing
  339.       interferes with YMODEM transfers.
  340.  
  341.       32 bit CRC code courtesy Gary    S. Brown.  Directory creation
  342.       code from John Gilmore's PD TAR program.
  343.  
  344.      NNNNEEEETTTTWWWWOOOORRRRKKKK NNNNOOOOTTTTEEEESSSS
  345.       Escaping all control characters (sz -e) may help if the
  346.       transfer gets    stuck in the same place    on every attempt.
  347.       Professional-YAM and ZCOMM allow selection of    which control
  348.       characters need to be    escaped.
  349.  
  350.       In extreme cases 7-bit transmission may be required (see
  351.       Professional-YAM/ZCOMM manual).  7-bit transmission requires
  352.       rz version 4.50 or higher.
  353.  
  354.       Please refer to the sz -T command in sz.doc for more help.
  355.  
  356.      BBBBUUUUGGGGSSSS
  357.       This version of _r_z does not support some ZMODEM features.
  358.       Unix flavors of Professional-YAM may be linked to "rz" to
  359.       support these    features.
  360.  
  361.       The ASCII option's CR/LF to NL translation merely deletes
  362.       CR's;    undos(omen) performs a more intelligent    translation.
  363.  
  364.      ZZZZMMMMOOOODDDDEEEEMMMM CCCCAAAAPPPPAAAABBBBIIIILLLLIIIITTTTIIIIEEEESSSS
  365.       _R_z supports ZMODEM command execution (zcommand), incoming
  366.       ZMODEM binary    (-b), ASCII (-a), newer(-n), newer+longer(-N),
  367.       protect (-p),    Crash Recovery(-r), clobber (-y),
  368.       match+clobber    (-Y), compression(-Z), and append (-+)
  369.       requests.  Other options sent    by the sender are ignored.
  370.       The default is protect (-p) and binary (-b).
  371.  
  372.       Unix Professional-YAM    provides higher    performance and    other
  373.       features not supported by _r_z.    Please contact Omen Technology
  374.       Inc for product information.
  375.  
  376.       Omen Technology INC
  377.       503-621-3406
  378.       Post Office Box 4681
  379.       Portland OR 97208
  380.  
  381.  
  382.      FFFFIIIILLLLEEEESSSS
  383.       rz.c,    crctab.c, rbsb.c, zm.c,    zmr.c, zmodem.h, rz.1
  384.  
  385.       /tmp/rzlog stores debugging output generated with -vv    option
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 3/30/94)
  394.  
  395.  
  396.  
  397.