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_OSK.lzh / sz.doc < prev   
Text File  |  1996-01-08  |  23KB  |  529 lines
  1.  
  2.  
  3.  
  4.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       sx, sb, sz - Send Files with ZMODEM, YMODEM, or XMODEM
  10.       zcommand, zcommandi -    Send Commands with ZMODEM
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       sz [-++++aaaabbbbddddeeeeffffkkkkLLLLllllNNNNnnnnooooppppttttuuuuvvvvyyyyYYYYZZZZ] _f_i_l_e ...
  14.       sb [-ddddffffkkkkttttuuuuvvvv] _f_i_l_e ...
  15.       sx [-kkkkttttuuuuvvvv] _f_i_l_e
  16.       zcommand [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
  17.       zcommandi [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
  18.       sz -T
  19.  
  20.  
  21.      LLLLIIIICCCCEEEENNNNSSSSEEEE AAAAGGGGRRRREEEEEEEEMMMMEEEENNNNTTTT
  22.       This is a copyrighted    shareware program.  Commercial use of
  23.       this program is subject to licensing conditions detailed in
  24.       the rz.c source code.     "Commercial Use" includes any use of
  25.       this program to send files to    a commercial or    shareware
  26.       program not published    or licensed by Omen Technology INC.
  27.  
  28.       Registration information is provided in the file mailer.rz.
  29.  
  30.       Use of this program constitutes agreement to the License
  31.       Agreement.
  32.  
  33.      SSSSUUUUPPPPPPPPOOOORRRRTTTT
  34.       Unregistered users may dial 900-737-7836 (900-737-RTFM) for
  35.       technical assistance.     There is a charge of $4.69 per    minute
  36.       to use this support line.  Callers must be 18    years or
  37.       older.
  38.  
  39.       Registered users encountering    problems using this program on
  40.       standard serial ports    to transfer files with Professional-
  41.       YAM or ZCOMM may call    the support number listed in the
  42.       Professional-YAM/ZCOMM documentation.
  43.  
  44.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.       SSSSzzzz (send ZMODEM) uses    the ZMODEM, YMODEM or XMODEM error
  46.       correcting protocol to send one or more files    over a dial-in
  47.       serial port to a variety of programs running under PC-DOS,
  48.       CP/M,    Unix, VMS, and other operating systems.
  49.  
  50.       To obtain the    maximum    performance and    full functionality of
  51.       this program we recommend its    use with GSZ, Professional-YAM
  52.       or ZCOMM.
  53.  
  54.       This program is intended to interface    with terminal
  55.       programs, not    to act as one.    This program is    not designed
  56.       to be    called from _c_u(_1) _t_i_p(_1), or other communications
  57.       programs.  Unix flavors of Omen Technology's Professional-
  58.       YAM communications software are available for    dial-out
  59.       applications.     Unix Professional-YAM supports    dial-out
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 3/30/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       applications with telephone directory, a powerful script
  75.       language with    learn function,    high quality multiple protocol
  76.       support, and UUCP port arbitration.
  77.  
  78.       SSSSzzzz sends one or more files with ZMODEM protocol.
  79.  
  80.       ZMODEM greatly simplifies file transfers compared to XMODEM.
  81.       In addition to a friendly user interface, ZMODEM provides
  82.       Personal Computer and    other users an efficient, accurate,
  83.       and robust file transfer method.
  84.  
  85.       ZMODEM provides complete EEEENNNNDDDD----TTTTOOOO----EEEENNNNDDDD data integrity between
  86.       application programs.     ZMODEM's 32 bit CRC catches errors
  87.       that sneak into even the most    advanced networks.
  88.  
  89.       Advanced file    management features include AutoDownload
  90.       (Automatic file Download initiated without user
  91.       intervention), Display of individual and total file lengths
  92.       and transmission time    estimates, Crash Recovery, selective
  93.       file transfers, and preservation of exact file date and
  94.       length.
  95.  
  96.       The ----yyyy option    instructs the receiver to open the file    for
  97.       writing unconditionally.  The    ----aaaa option causes the receiver
  98.       to convert Unix newlines to PC-DOS carriage returns and
  99.       linefeeds.
  100.  
  101.  
  102.       SSSSbbbb sends one or more files with YMODEM or ZMODEM protocol.
  103.       The initial ZMODEM initialization is not sent.  When
  104.       requested by the receiver, ssssbbbb    supports YYYYMMMMOOOODDDDEEEEMMMM----gggg with
  105.       "cbreak" tty mode, XON/XOFF flow control, and    interrupt
  106.       character set    to CAN (^X).  YYYYMMMMOOOODDDDEEEEMMMM----gggg (Professional-YAM gggg
  107.       option) increases YMODEM throughput over error free channels
  108.       (direct connection, X.PC, etc.) by disabling error recovery.
  109.  
  110.       On Unix systems, additional information about    the file is
  111.       transmitted.    If the receiving program uses this
  112.       information, the transmitted file length controls the    exact
  113.       number of bytes written to the output    dataset, and the
  114.       modify time and file mode are    set accordingly.
  115.  
  116.  
  117.       SSSSxxxx sends a single _f_i_l_e with XXXXMMMMOOOODDDDEEEEMMMM or    XXXXMMMMOOOODDDDEEEEMMMM----1111kkkk protocol
  118.       (sometimes incorrectly called    "ymodem").  The    user must
  119.       supply the file name to both sending and receiving programs.
  120.  
  121.       Iff sssszzzz is invoked with $SHELL    set and    iff that variable
  122.       contains the string _r_s_h or _r_k_s_h (restricted shell), sssszzzz
  123.       operates in restricted mode.    Restricted mode    restricts
  124.       pathnames to the current directory and PUBDIR    (usually
  125.       /usr/spool/uucppublic) and/or    subdirectories thereof.
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 3/30/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       The fourth form sends    a single COMMAND to a ZMODEM receiver
  141.       for execution.  ZZZZccccoooommmmmmmmaaaannnndddd exits with the COMMAND return
  142.       value.  If COMMAND includes spaces or    characters special to
  143.       the shell, it    must be    quoted.
  144.  
  145.  
  146.       The fifth form sends a single    COMMAND    to a ZMODEM receiver
  147.       for execution.  ZZZZccccoooommmmmmmmaaaannnnddddiiii exits as soon as the receiver has
  148.       correctly received the command, before it is executed.
  149.  
  150.  
  151.       The sixth form (sz -T) outputs all 256 code combinations to
  152.       the terminal.     The hex value of the character, a space, and
  153.       the raw character are    sent, 8    per line.  In you are having
  154.       difficulty sending files, this command lets you see which
  155.       character codes are being eaten by the operating system or
  156.       network.  The    terminal program must be set to    display    all
  157.       256 codes in a distinct form.     Check that each code is sent,
  158.       and that the 8th bit on codes    0x80 to    0xFF is    set.
  159.  
  160.       Sz -T    then allows the    caller to input    characters which are
  161.       echoed in hex.  You should check that    all control characters
  162.       can be input this way.
  163.  
  164.  
  165.  
  166.       The meanings of the available    options    are:
  167.  
  168.       ++++    Instruct    the receiver to    append transmitted data    to an
  169.            existing    file (ZMODEM only).
  170.       aaaa    Instruct    the ZMODEM receiver to convert text file
  171.            format as appropriate for the receiving system.    Valid
  172.            only for    ZMODEM.
  173.       bbbb    (ZMODEM)    Binary override: transfer file without any
  174.            translation.
  175.       cccc    Instruct    the receiver to    change the pathname if the
  176.            destination file    exists.
  177.       dddd    Change all instances of "." to "/" in the transmitted
  178.            pathname.  Thus,    C.omenB0000 (which is unacceptable to
  179.            MSDOS or    CP/M) is transmitted as    C/omenB0000.  If the
  180.            resultant filename has more than    8 characters in    the
  181.            stem, a "." is inserted to allow    a total    of eleven.
  182.       eeee    Escape all control characters; normally only XON, XOFF,
  183.            DLE, CR-@-CR, and Ctrl-X    are escaped.
  184.       ffff    Send Full pathname.  Normally directory prefixes    are
  185.            stripped    from the transmitted filename.
  186.       gggg    Send ESC-[-?-3-4-l to start DSZ from Kermit.
  187.       kkkk    (XMODEM/YMODEM) Send files using    1024 byte blocks
  188.            rather than the default 128 byte    blocks.     1024 byte
  189.            packets speed file transfers at high bit    rates.
  190.            (ZMODEM streams the data    for the    best possible
  191.            throughput.)
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 3/30/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.       LLLLNNNN   Use ZMODEM sub-packets of length    N.  A larger N (32 <=
  207.            N <= 1024) gives    slightly higher    throughput, a smaller
  208.            N speeds    error recovery.     The default is    128 below 300
  209.            baud, 256 above 300 baud, or 1024 above 2400 baud.
  210.       llllNNNN   Wait for    the receiver to    acknowledge correct data every
  211.            NNNN (32 <=    N <= 1024) characters.    This may be used to
  212.            avoid network overrun when XOFF flow control is
  213.            lacking.
  214.       nnnn    (ZMODEM)    Send each file if destination file does    not
  215.            exist.  Overwrite destination file if source file is
  216.            newer than the destination file.
  217.       NNNN    (ZMODEM)    Send each file if destination file does    not
  218.            exist.  Overwrite destination file if source file is
  219.            newer or    longer than the    destination file.
  220.       oooo    (ZMODEM)    Disable    automatic selection of 32 bit CRC.
  221.       pppp    (ZMODEM)    Protect    existing destination files by skipping
  222.            transfer    if the destination file    exists.
  223.       rrrr    (ZMODEM)    Resume interrupted file    transfer.  If the
  224.            source file is longer than the destination file,    the
  225.            transfer    commences at the offset    in the source file
  226.            that equals the length of the destination file.
  227.       rrrrrrrr   As above, but compares the files    (the portion common to
  228.            sender and receiver) before resuming the    transfer.
  229.       ttttttttiiiimmmm Change timeout to _t_i_m tenths of seconds.
  230.       uuuu    Unlink the file after successful    transmission.  Users
  231.            should not manually abort or skip file transfers    when
  232.            this option is used.
  233.       wwwwNNNN   Limit the transmit window size to N bytes (ZMODEM).
  234.       vvvv    Verbose causes a    list of    file names to be appended to
  235.            /tmp/szlog .  More v's generate more output.
  236.       yyyy    Instruct    a ZMODEM receiving program to overwrite    any
  237.            existing    file with the same name.
  238.       YYYY    Instruct    a ZMODEM receiving program to overwrite    any
  239.            existing    file with the same name, and to    skip any
  240.            source files that do have a file    with the same pathname
  241.            on the destination system.
  242.       ZZZZ    Use ZMODEM file compression to speed file transfer.
  243.  
  244.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  245.       Exit status is as follows: 0 for successful transfers.  1 if
  246.       unrecoverable    errors are detected.  2    if syntax errors or
  247.       file access problems are detected.  3    if the program was
  248.       terminated by    a caught interrupt.
  249.  
  250.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  251.       ZZZZMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    DSZ/ZCOMM/Professional-YAM)
  252.       %%%% sssszzzz ----aaaa ****....cccc
  253.       This single command transfers    all .c files in    the current
  254.       Unix directory with conversion (----aaaa) to end of    line
  255.       conventions appropriate to the receiving environment.     With
  256.       ZMODEM AutoDownload enabled, Professional-YAM     and ZCOMM
  257.       will automatically receive the files after performing    a
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 3/30/94)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  269.  
  270.  
  271.  
  272.       security check.
  273.  
  274.       %%%% sssszzzz ----YYYYaaaannnn ****....cccc    ****....hhhh
  275.       Send only the    .c and .h files    that exist on both systems,
  276.       and are newer    on the sending system than the corresponding
  277.       version on the receiving system, converting Unix to DOS text
  278.       format.
  279.  
  280.       ZZZZMMMMOOOODDDDEEEEMMMM CCCCoooommmmmmmmaaaannnndddd DDDDoooowwwwnnnnllllooooaaaadddd (Unix    to Professional-YAM)
  281.        cpszall:all
  282.           zcommand "c:;cd /yam/dist"
  283.           sz -ya $(YD)/*.me
  284.           sz -yb y*.exe
  285.           zcommand "cd /yam"
  286.           zcommandi    "!insms"
  287.       This Makefile    fragment uses zzzzccccoooommmmmmmmaaaannnndddd to issue    commands to
  288.       Professional-YAM to change current disk and directory.
  289.       Next,    sssszzzz transfers the ._m_e files from    the $YD    directory,
  290.       commanding the receiver to overwrite the old files and to
  291.       convert from Unix end    of line    conventions to PC-DOS
  292.       conventions.    The third line transfers some ._e_x_e files.  The
  293.       fourth and fifth lines command Pro-YAM to change directory
  294.       and execute a    PC-DOS batch file _i_n_s_m_s    . Since    the batch file
  295.       takes    considerable time, the zzzzccccoooommmmmmmmaaaannnnddddiiii form is used to allow
  296.       the program to exit immediately.
  297.  
  298.       XXXXMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    Crosstalk)
  299.       % ssssxxxx ffffoooooooo....cccc
  300.       EEEESSSSCCCC
  301.       rrrrxxxx ffffoooooooo....cccc
  302.       The above three commands transfer a single file from Unix to
  303.       a PC and Crosstalk.  This combination    is much    slower and
  304.       less reliable    than ZMODEM.
  305.  
  306.      EEEERRRRRRRROOOORRRR MMMMEEEESSSSSSSSAAAAGGGGEEEESSSS
  307.       "Caught signal 99" indicates the program was not properly
  308.       compiled, refer to "bibi(99)"    in rbsb.c for details.
  309.  
  310.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  311.       rz(omen), ZCOMM User's Manual, Professional-YAM User's
  312.       Manual, crc(omen), sq(omen), todos(omen), tocpm(omen),
  313.       tomac(omen), yam(omen)
  314.  
  315.       Compile time options required    for various operating systems
  316.       are described    in the source file.
  317.  
  318.      FFFFIIIILLLLEEEESSSS
  319.       32 bit CRC code courtesy Gary    S. Brown.
  320.  
  321.       sz.c,    crctab.c, rbsb.c, zm.c,    zmr.c, zmodem.h    Unix source
  322.       files
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 3/30/94)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  335.  
  336.  
  337.  
  338.       /tmp/szlog stores debugging output (sz -vv)
  339.  
  340.      TTTTEEEESSSSTTTTIIIINNNNGGGG FFFFEEEEAAAATTTTUUUURRRREEEE
  341.       The command "sz -T file" exercises the AAAAttttttttnnnn sequence error
  342.       recovery by commanding errors    with unterminated packets.
  343.       The receiving    program    should complain    five times about
  344.       binary data packets being too    long.  Each time sssszzzz is
  345.       interrupted, it should send a    ZDATA header followed by
  346.       another defective packet.  If    the receiver does not detect
  347.       five long data packets, the AAAAttttttttnnnn sequence is not
  348.       interrupting the sender, and the MMMMyyyyaaaattttttttnnnn string in sssszzzz....cccc must
  349.       be modified.
  350.  
  351.       After    5 packets, sssszzzz stops the    "transfer" and prints the
  352.       total    number of characters "sent" (Tcount).  The difference
  353.       between Tcount and 5120 represents the number    of characters
  354.       stored in various buffers when the Attn sequence is
  355.       generated.
  356.  
  357.      SSSSEEEERRRRVVVVEEEERRRR////NNNNEEEETTTTWWWWOOOORRRRKKKK NNNNOOOOTTTTEEEESSSS
  358.       Terminals on some timesharing    systems    are connected
  359.       indirectly to    the host with TTTTEEEERRRRMMMMIIIINNNNAAAALLLL SSSSEEEERRRRVVVVEEEERRRRSSSS operating over
  360.       networks.  Terminal servers often interfere with file
  361.       transfers by "eating"    control    characters and/or losing data.
  362.  
  363.       When terminal    servers    interfere with file transfers, server
  364.       commands are often available to help the problem.  When
  365.       possible, enable the server and modems for hardware flow
  366.       control in and out.  Set the terminal    server to telnet
  367.       transparent mode.  Some typical commands are "SET TERMINAL
  368.       DOWNLOAD", "set session passall", and    "SET TERMINAL NO ESC",
  369.       but there is no standard set of commands suitable for    all
  370.       terminal servers.  Normally these commands are given before
  371.       attempting file transfers, but one user has reported that
  372.       the command must be given _a_f_t_e_r the file transfer is
  373.       started(!).  Until terminal server vendors improve the
  374.       quality of their product, you    may have to get    on their case
  375.       until    they adequately    support    high performance file
  376.       transfers.
  377.  
  378.       Escaping control characters (sz -e) may help if the transfer
  379.       gets stuck in    the same place on every    attempt.
  380.       Professional-YAM and ZCOMM allow selection of    which control
  381.       characters need to be    escaped.  In extreme cases 7-bit
  382.       transmission may be required (see the    Professional-YAM/ZCOMM
  383.       manual).
  384.  
  385.       If you encounter problems with control characters Please
  386.       refer    to the sz -T command in    sz.doc for more    help.
  387.  
  388.       Flow control between the server and modem is often
  389.       defective.  This rarely causes a problem in interactive
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 3/30/94)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  401.  
  402.  
  403.  
  404.       applications whose short bursts (a screenfull    at most) fit
  405.       within the available memory buffers.    Streaming protocols
  406.       such as YMODEM-g, long packet    SuperKermit, and ZMODEM    can
  407.       overload the available buffering.  Some terminal servers
  408.       support commands to enable hardware flow control such    as
  409.       "TERM    FLOWCONTROL HARDWARE IN    OUT"; this assumes the modem
  410.       attached to the server is properly configured.
  411.  
  412.       If the terminal server is too    brain damaged to support flow
  413.       control, you can fake    it with    ZMODEM.     Try "sz -
  414.       w1024    file..." to enable software flow control. Experiment
  415.       with different values    to find    the best throughput.
  416.  
  417.       Terminal servers are designed    to accept keyboard input from
  418.       human    operators.  They may lose data when a program sends
  419.       data to the host faster than humans type.  Some servers
  420.       allow    larger input buffers to    support    file uploads.  If you
  421.       can upload short files (less than 100    bytes) but not longer
  422.       files, try "sz -w1024    file..." with your uploading program.
  423.       (Not all programs support this option; use ZCOMM or
  424.       Professional-YAM.)
  425.  
  426.       When both flow control and character transparency are
  427.       problems, use    "sz -ew1024 file..." as    a starting point.
  428.  
  429.       Sometimes the    terminal server    software is defective and must
  430.       be upgraded.    Please contact the network's vendor for
  431.       corrective procedures.  An alternative is to install direct
  432.       serial ports for users desiring to upload files.
  433.  
  434.       Some systems enforce a timeout which disconnects a user
  435.       after    several    minutes    of no keyboarding.  This can cause
  436.       problems in long, error free ZMODEM transfers.  Restricting
  437.       the window size with a "-w8192" option provides terminal
  438.       input    at regular intervals even when no error    correction is
  439.       needed.  If problems persist,    try setting a packet length
  440.       (sz -l1024).
  441.  
  442.  
  443.      NNNNOOOOTTTTEEEESSSS
  444.       Particular attention must be paid to flow control.  The
  445.       modem    and Unix must agree on the flow    control    method.     Sz on
  446.       USG (SYS III/V) systems use XON/XOFF flow control.  Some
  447.       terminal servers do not provide working flow control.     If
  448.       flow control cannot be properly set up,
  449.       Try a    "-w1024" option    (given to the sending program) to
  450.       enforce protocol level flow control.    Experiment with
  451.       different window sizes for best results.
  452.  
  453.       Telebit modems must not be set to "spoof" UUCP, XMODEM,
  454.       YMODEM, or KERMIT.  Setting one of these spoofing modes
  455.       interferes with other    protocols.  Telebit's YMODEM spoofing
  456.  
  457.  
  458.  
  459.      Page 7                         (printed 3/30/94)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  467.  
  468.  
  469.  
  470.       interferes with YMODEM transfers.
  471.  
  472.       If a program that does not properly implement    the specified
  473.       file transfer    protocol causes    _s_b to "hang" the port after a
  474.       failed transfer, either wait for _s_b to time out or keyboard
  475.       a dozen Ctrl-X characters.  Every reported instance of this
  476.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  477.       other    program    with a correct implementation of the specified
  478.       protocol.
  479.  
  480.       Many programs    claiming to support YMODEM only    support    XMODEM
  481.       with 1k blocks, and they often don't get that    quite right.
  482.       XMODEM transfers add up to 127 garbage bytes per file.
  483.       XMODEM-1k and    YMODEM-1k transfers use    128 byte blocks    to
  484.       avoid    extra padding.
  485.  
  486.       YMODEM programs use the file length transmitted at the
  487.       beginning of the transfer to prune the file to the correct
  488.       length; this may cause problems with source files that grow
  489.       during the course of the transfer.  This problem does    not
  490.       pertain to ZMODEM transfers, which preserve the exact    file
  491.       length unconditionally.
  492.  
  493.       Most ZMODEM options are merely passed    to the receiving
  494.       program; some    programs do not    implement all of these
  495.       options.
  496.  
  497.       Circular buffering and a ZMODEM sliding window should    be
  498.       used when input is from pipes    instead    of acknowledging
  499.       frames each 1024 bytes.  If no files can be opened, sssszzzz sends
  500.       a ZMODEM command to echo a suitable complaint; perhaps it
  501.       should check for the presence    of at least one    accessible
  502.       file before getting hot and bothered.
  503.  
  504.       Unix Professional-YAM    provides higher    performance and    other
  505.       features not supported by _s_z.    Please contact Omen Technology
  506.       Inc for product information.
  507.  
  508.       Omen Technology INC
  509.       503-621-3406
  510.       Post Office Box 4681
  511.       Portland OR 97208
  512.  
  513.  
  514.      BBBBUUUUGGGGSSSS
  515.       On at    least one BSD system, sz would abend it    got within a
  516.       few kilobytes    of the end of file.
  517.       Using    the "-w8192" option fixed the problem.    The real cause
  518.       is unknown, perhaps a    bug in the kernel TTY output routines.
  519.  
  520.       The test mode    leaves a zero length file on the receiving
  521.       system.
  522.  
  523.  
  524.  
  525.      Page 8                         (printed 3/30/94)
  526.  
  527.  
  528.  
  529.