quick.start

支持X/YModem和cis_b+协议的串口通讯程序

  
  XC QUICK START DOCS                         24 Nov 1996 

  1) If you wish to use the binaries included here you will have to
     have the Linux ELF shared library libc.so.5.2.18 or later, otherwise
     recompile this package. See the "bin" directory for binaries.
     Read the INSTALL document.

  2) Edit the modem initialization string in the file "xc.init" to
     suite your own modem.

  3) Type 'make install'. Or alternatively, manually move the files
     in the xc ./bin directory to /usr/bin or some other directory in 
     your path. 

     For safety, even if you type 'make install' you must manually
     move xc.init, and phonelist to /usr/local/lib/xc.  You will
     probably have to create this directory. Make sure that the
     directory /var/lock has proper read/write permissions.  This is
     where lock files will be created (as per the Linux file system
     standard for lock files).

     The included phonelist file is probably out of date. It was 
     originally culled from Rasca Gmelch's Linux BBS list. If you 
     need to contact him, Rasca's e-mail addresses are:
             [e-mail]  
             [e-mail]. 

     Note that the xc "dotfiles" directory contains various helpful
     scripts. List them with "ls -al" command.

  4) XC suppports cis-b+, xmodem, ymodem, and ymodem-g file transfers.
     For zmodem transfers use rzsz available as lrzsz from sunsite.unc.edu
     in /pub/Linux/apps/comm/lrzsz-012b.tar.gz. Note that the Debian
     and rpm version 0.11b is flawed and does not return the proper
     exit codes, therefore 0.11 versions of lrzsz are not recommended. 

  5) Installation is now complete. Read the docs.

  6) Entering XC -h will display the command line options.

  7) here's the quick tour:

        XC is very command line driven. It has 3 basic modes:

         a) main command line at the <XC> prompt.
               all settings of options and file transfer initiation
               take place here.
                                
         b) dialing directory mode
               can dial from a pick list or dial manually.

         c) ordinary terminal mode.
               when you are on-line with another system.

The main thing to remember is to use <control> <A> as a prefix in order
to switch modes when you are in the terminal mode.

Examples:

say you are in the terminal mode and you want to exit to the main command 
line:
        <control>  <A>   x      (the "x" means exit)

say you are in the terminal mode and you want to hang-up the line:

        <control>  <A>   h      (the "h" means hang-up the line )

IF YOU ARE IN THE DIALING DIRECTORY OR AT THE MAIN COMMAND LINE
YOU DON'T NEED TO TYPE <control> <A>.    

here's another example:

        <control>  <A>   d      (the "d" means go to the dialing directory)

The only reason for the control A sequence is so the program knows that you
aren't just typing at the terminal keyboard but are actually giving a 
command to the program.

A NOTE about file transfers:

There are two transfer modes--internal protocol and external protocol.
The internal protocol transfer commands are given at the XC command
line. 

To  receive a file via the internal XMODEM command do the following
at the XC command prompt:

            rx  myfile.zip

To send send the file "fuzzy.zip" via the original XMODEM protocol
enter this at the XC command line:

            sx  fuzzy.zip


To send send the file "fuzzy.zip" via 1K XMODEM enter this at the XC
command line:

            so  fuzzy.zip

The "s" means send, the "o" means "old YMODEM". Note that there is
also a newer "real" YMODEM which allows batch transfers. To use real
YMODEM you would do this:

            sy  fuzzy.zip foobar.tar.gz zImage.gz

The above command will send all three specified files (but don't forget
both ends of the transfer must be using real YMODEM). Some systems that
you connect to have the YMODEM commands installed as 'rb' and 'sb' 
where the 'b' designates batch mode. These are identical with the
ry and sy available with XC.
         
One advantage of YMODEM is that, when receiving files, there is no
need to specify the incoming files on the command line. YMODEM 
automatically knows the name of incoming files, and it also preserves
each file's date, size, and permission bits. To receive files
via YMODEM, merely type 'ry' at the <XC> command prompt:  ry

EXTERNAL PROTOCOLS:

to send a file via ZMODEM, at the <XC> command prompt enter:

         $ sz  myfile.zip 

NOTE CAREFULLY the DOLLAR SIGN prefix!

To receive a file with ZMODEM is even simpler: XC will detect
a zmodem transfer and automatically invoke rz. If you wish to
manually receive via rz you can type the following at the <XC>
command prompt (again, remember the dollar sign).

         $ rz

REMEMBER: file transfers are entered at the main command prompt.
If you are in the terminal mode, to start a transfer, type:
 
                  <control> <A>  x  

That will put you in the command line mode for the transfer. After the
transfer is complete, type the letter "t" to put you in the terminal
mode again. If you are receiving a file via zmodem and you interrupt
the transfer with a <control> <C> , you may find that the other end 
continues sending. To manually cancel a zmodem tranmission send a
long strings of <control> <X> characters to the other end (i.e hold
down the cotnrol key and the `X' key simultaneously.

Thomas McWilliams
INTERNET: [e-mail]
FIDO via INTERNET: [e-mail]