readme

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

@(#) XC README, patchlevel 4.3 JPRadley 11 September 1993
This file (and almost every other one in the distribution) uses 4-character
tabstops.
The supplied .exrc file sets ts=4 and sw=4, for vi's purposes.


    B A C K G R O U N D

Once upon a time (in 1985 or so), a fellow named Eric Coe wrote a Unix dialout
telecommunications program with xmodem called XCOMM. This program was
substantially upgraded and improved by another fellow named Larry Gensch, who
brought XCOMM up to Version 2.2. Version 2.2 included a simple script
language, 128-byte Xmodem and Compuserve Quick-B file-transfer protocols, and
some other stuff. Fred Buck then changed the program name to XCMALT, which it
maintained until June 1991, when Jean-Pierre Radley renamed it XC. 

XC is a massive expansion and modification of XCOMM 2.2. Many bugs in
XCOMM 2.2 have been fixed, and many advertised features that didn't work in
XCOMM 2.2 do work in XC. Also, XC includes a fullscreen dialing directory; a
totally rewritten and much more powerful script language allowing, among other
things, remote execution of shell commands and unattended protocol-controlled
file transfer (provided that your system also has Chuck Forsberg's "rz/sz"
Xmodem/Ymodem/Zmodem program, available as shareware from many sources), a
flexible variable mechanism, including access to shell environment variables,
and more; BREAK-signal capability; the capability to upload a file in ASCII
from within a script; and miscellaneous cosmetic changes.

But while XC incorporates much of Larry Gensch's work, it's not supported by
Larry Gensch (although he contributed the key-binding features starting with
XC3.2a). The changes from XCOMM 2.2 are the product of Steve Manes, who
installed uucp LCKfile support and special compile-time tuning for SCO Xenix,
and who wrote the fullscreen dialing directory; Fred Buck, who rewrote the
script language, performed various bugfixes and alterations, and installed
special compile-time tuning for the Tandy 6000; and Jean-Pierre Radley, who
installed the B+ Protocol, used more termcap features, and is now the
"caretaker" of XC.


    I N S T A L L A T I O N

Run Configure. There are various definitions that have to be set according
to your flavor of Unix, your preference for default directories, and other
user-definable items.

Typing just "make" will compile XC. On most systems, XC should be run "suid
uucp", and in order to do this, you should have chosen "uucp" as the user
to own the program, and 4755 as its permissions. If so, typing "make
install.suid" will strip out its symbol table, place the program in INSDIR,
and change its modes and permissions accordingly. If you did not elect
this when running Configure, you can type "make install", but XC's permissions
will probably not allow it to properly cope with dial-in/dial-out ports.

The "xc.nro" file is 'nroff' source for a manual page which describes the
command-line options, the various commands once you're running XC, script
language, file transfers, and the price of milk in Soviet Georgia in 1986.
This file MUST pass through 'tbl' and 'col', e.g.,
     "tbl xc.nro | nroff -man | col > /usr/man/cat.L/xc.L".

Some distribution files that you might adapt to your own purposes:

        .exrc        sets tabstops and shiftwidth to 4, which is necessary
                     to properly view almost every file in the XC distribution.
                     It also contains, commented out, macros
                     to help read CompuServe message downloads, and to
                     prepare replies.

        .xc          sample startup script, demonstrates keyboard bindings

        .phonelist   sample dialing directory data file

        .callhq      sample script to call a Unix/Xenix system

        .uni         sample script to call CompuServe and enter UnixForum

        .aus         sample script to call CompuServe and enter, in turn,
                     SCOForum and UnixForum, uploading any prepared messages,
                     capturing all new messages into separate files, and
                     hanging up.

        .autocis     sample script to call CompuServe, get any waiting
                     Mail into a capture file, then visit the PRACTICE
                     and the Unix Fora in turn, uploading any prepared
                     messages, capturing all new messages into separate
                     files, then hanging up.

        .cisdial     meant to be called as a sub-script for dialing
                     CompuServe.

        .temp_opt    meant to be called as a sub-script for temporary
                     setting of Options in a CompuServe Forum to make
                     efficient use of .autocis, .aus, or .uni.

        .pass        a subscript containing passwords for various sites.
                     This should have very restrictive permissions.

        .rz          sample script to receive files using the public
                     domain "rz/sz" package.

        .sz          sample script to send files using the public domain
                     "rz/sz" package.

        call         a Bourne shell script to use a spare modem to dial
                     voice calls for you.

        callback     a Bourne shell script to call a site and have it
                     return the call and present a 'login:' prompt.

        cisdownload  a Bourne shell script to fetch a file from a Library
                     in a CompuServe Forum.


    X C  R E V I S I O N  H I S T O R Y

Version 4.3.2 McWilliams 24 Nov 1996
    POSIX target

Version 4.3 Radley 11 Sep 1993
    Redid all time routines
    Increased B+ internal buffers to use 2K packets
    Added Debug section to man page

Version 4.2 Radley 30 Aug 1993
    Reverted to 7e|7o|8n
    Read the environment for LINES and COLUMNS (clue from Stockler)
    Took out half-duplex stuff
    Added chdir capability
    Test for return type of signal() in Configure

Version 4.1 Gensch & Radley 10 Apr 1993
    Added Configure script
    Took out T6000 conditional
    Changed 7e|7o|8n to 7e2|7o2|8n1, with CSTOPB as needed

Version 3.4 Radley 13 Feb 1993
    Took out bitmask and 7bit stuff, now have 7E, 7O, or 8N capability
    Sleep(1) after PREFIX to allow modem to react (clue from Doug Scothorne)
    Fixed newbmask signalling to prevent leak into B+ (clue from Jim Asman)
    Deleted for-loops in s_dial and s_term (clue Brian Ferguson)
    Tested for CO if no CN (clue Roy Johnson)

Version 4.0 Radley 11 Jun 1992
    Used ANSI Prototype function declarations
        (this road will not be travelled further...)

Version 3.3 Radley 25 May 1992
    Provided call (clue from John Esak) and cisdownload shell scripts
    Do not fork to terminal mode if stderr is not a tty
    Added mini-menu
    Merged Larry Gensch's 3.2a additions into xcscript.c
    Used Larry Gensch's NIL-pointer macro throughout
    Make a local copy of scriptname within S_Call()
    Renamed isig() to mode()
    Rearranged sections of the manual
    Restored newbmask (clue from Doug Scothorne)
    Set ptr = word early in k_waitfor (clue from Peter Smithem)
    B+ Packet_Size requests 2k if bps > 2400 (CIS may eventually do this)
    Use BS=c_cc[VERASE] == user's ERASE key (clue from Peter Gutmann)
    Used oldmode before printing help or dialdir (clue from Bill Greene)
    SYSVR4 mods for xcport.c (Larry Rosenman)

Version 3.2a Larry Gensch 22 Sep 1991
    Made hard-coded terminal mode escape character a SETable value 
    Added dynamic keyboard binding module
    Added bind_function, bind_script, and bind_function to script language
    Added fullword synonyms for command line keywords (eg, quit, term)
    Incorporated show_bindings() into help display
    Modified help display into more readable (to me, anyway) format
    Added show_bindings() as a terminal mode function (esc - ?)
    Fixed command line input routine

Version 3.2 Radley 24 Aug 1991
    Set terminal's c_oflag to 0 (clue from Ronald Khoo)
    Openfile fix (Peter Smithem)
    Undefined toupper/tolower macros
    Removed toggle() and introduced capt_on() and capt_off()
    Changed diversion pacing back to using waitfor()
    Changed send_slowly to send_string; left out inter-character delay
    Removed newbmask
    Purge() before doing a %take (clue from Bob Stockler)
    Reinstalled xmodem crcheck as it was in 2.5 (clue from Volker Beyer)
    Rearranged some modules to make gcc happier
    Renamed intdel() to isig()
    Unscrambled the SUCCESS/FAILURE nonsense in xcscrpt.c
    Dropped trminp() in favor of fgetc()
    Reworked signal handling

Version 3.1 Radley 14 Jul 1991
    Purge() before starting B+ (Al Bolduc)
    Eliminated purge as a set option.