Return to README CVS log

Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104

Annotation of coherent/g/usr/lib/uucp/tay104/README, revision 1.1

1.1     ! root        1: This is the README file for version 1.04 of the Taylor UUCP package.
        !             2: 
        !             3: It was written by Ian Lance Taylor.  I can be reached at [email protected],
        !             4: or, equivalently, uunet!cygint!airs!ian, or c/o Cygnus Support, 4th
        !             5: Floor, Building 200, 1 Kendall Square, Cambridge MA, 02139, USA.
        !             6: 
        !             7: There is a mailing list for discussion of the package.  To join (or
        !             8: get off) the list, send mail to [email protected].
        !             9: Mail to this address is answered by a person, not a program.  When
        !            10: joining the list, make sure you include the address at which you want
        !            11: to receive mail in the body of your message.  To send a message to the
        !            12: list, send it to [email protected].
        !            13: 
        !            14: This package is covered by the Gnu Public License.  See the file
        !            15: COPYING for details.  If you would like to do something with this
        !            16: package that you feel is reasonable but you feel is prohibited by the
        !            17: license, contact me to see if we can work it out.
        !            18: 
        !            19: WHAT IT IS
        !            20: 
        !            21: This is the complete source code for a Unix UUCP package.  It provides
        !            22: everything you need to make a UUCP connection.  It includes versions
        !            23: of uucico, uusched, uuxqt, uux, uucp, uustat, uulog, uuname, uuto,
        !            24: uupick, and cu, as well as uuchk (a program to check configuration
        !            25: files), uuconv (a program to convert from one type of configuration
        !            26: file to another) and tstuu (a test harness for the package).
        !            27: 
        !            28: The Free Software Foundation plans to make this their standard UUCP
        !            29: package.
        !            30: 
        !            31: The package currently supports the 'f', 'g' (in all window and packet
        !            32: sizes), 'G', 't' and 'e' protocols, as well a Zmodem protocol and two
        !            33: new bidirectional protocols.  If you have a Berkeley sockets library,
        !            34: it can make TCP connections.  If you have TLI libraries, it can make
        !            35: TLI connections.  It supports a new configuration file mechanism which
        !            36: I like (but other people dislike).
        !            37: 
        !            38: The package has a few advantages over regular UUCP:
        !            39: 
        !            40:     You get the source code.
        !            41: 
        !            42:     It uses significantly less CPU time than many UUCP packages.
        !            43: 
        !            44:     You can specify a chat script to run when a system calls in,
        !            45:     allowing adjustment of modem parameters on a per system basis.
        !            46: 
        !            47:     You can specify failure strings for chat scripts, allowing the
        !            48:     chat script to fail immediately if the modem returns ``BUSY''.
        !            49: 
        !            50:     If you are talking to another instance of the package, you can use
        !            51:     the new bidirectional protocol for rapid data transfer in both
        !            52:     directions at once.  You can also restrict file transfers by size
        !            53:     based on the time of day and who placed the call.
        !            54: 
        !            55: On the other hand:
        !            56: 
        !            57:     It only runs on Unix.  The code is carefully divided into system
        !            58:     dependent and system independent portions, so it should be
        !            59:     possible to port it to other systems.  It would not be trivial.
        !            60: 
        !            61:     You don't get uuclean, uusend, uuq, uusnap, uumonitor, uutry,
        !            62:     uupoll, etc.  If you have current copies of these programs, you
        !            63:     may be able to use them.  Shell scripts versions of uuclean and
        !            64:     uutry are provided, with most, if not all, of the functionality of
        !            65:     the usual programs.  I believe the supplied uustat program allows
        !            66:     you to do everything that uuq, uusnap and uumonitor do.  uupoll
        !            67:     could be written as a shell script.
        !            68: 
        !            69:     The package does not read modemcap or acucap files, although you
        !            70:     can use V2 configuration files with a BNU Dialers file or a dialer
        !            71:     file written in my new configuration file format.
        !            72: 
        !            73:     The package cannot use SCO dialer programs directly, although it
        !            74:     can with a simple shell script interface.
        !            75: 
        !            76: If you start using this package, I suggest that you join the mailing
        !            77: list (see above) to keep up to date on patches and new versions.  I am
        !            78: also open to suggestions for improvements and modifications.
        !            79: 
        !            80: CHANGES SINCE 1.03
        !            81: 
        !            82: For a complete list, see ChangeLog.
        !            83: 
        !            84: IMPORTANT: the default when talking to another version of 1.04 is to
        !            85: use the new bidirectional 'i' protocol.  If you are using a
        !            86: half-duplex modem, such as a Telebit T2500, you will want to either
        !            87: mark the port as half-duplex with the ``half-duplex'' command, or
        !            88: force use of the 'g' protocol by using the ``protocol'' command in the
        !            89: sys or port file or by adding ``,g'' after the port name in the
        !            90: Systems or L.sys or Devices file.
        !            91: 
        !            92:     As usual, many bugs were fixed.
        !            93: 
        !            94:     Bidirectional transfers are supported with the new 'i' protocol;
        !            95:     it requires an eight-bit clear datapath.
        !            96: 
        !            97:     New programs: uusched, cu, uuto and uupick.
        !            98: 
        !            99:     The 'G' protocol and a new Zmodem protocol were added.
        !           100: 
        !           101:     A number of uustat options were added to support uuclean, and a
        !           102:     sample uuclean shell script was added to the contrib directory.
        !           103:     The uustat output formats were changed slightly.
        !           104: 
        !           105:     A protocol extension eliminates transfer of the command file for
        !           106:     simple commands, such as rmail or rnews, when talking to another
        !           107:     version of 1.04.
        !           108: 
        !           109:     Some TLI support was added.
        !           110: 
        !           111:     UUCP forwarding was added, along with the ``forward-to'',
        !           112:     ``forward-from'' and ``forward'' commands.
        !           113: 
        !           114:     If a file transfer fails in the middle, the retry will now start
        !           115:     from where it left off.  The implementation is compatible with
        !           116:     SVR4.
        !           117: 
        !           118:     The work queue is checked every 10 minutes during a conversation;
        !           119:     if there is new work and a bidirectional protocol is not in use,
        !           120:     the receiving uucico requests the sender to transfer control.
        !           121: 
        !           122:     The amount of free disk space is checked periodically as a file is
        !           123:     received, and if it drops too low the call is aborted.
        !           124: 
        !           125:     The UUCP configuration file reading routines were moved into a
        !           126:     standalone library, uuconf.  All known bugs in V2 and HDB
        !           127:     configuration file reading were fixed.
        !           128: 
        !           129:     The ``half-duplex'' command was added for the port and dialer
        !           130:     files.
        !           131: 
        !           132:     The ``max-retries'', ``success-wait'', ``send-request'' and
        !           133:     ``receive-request'' commands were added for the sys file.  The
        !           134:     ``call-request'' and ``called-request'' commands were eliminated
        !           135:     (they did not work correctly anyhow).
        !           136: 
        !           137:     \d in chat scripts now calls sleep (2) rather than sleep (1), so
        !           138:     it will sleep longer (on some systems sleep(1) may delay much less
        !           139:     than one second).
        !           140: 
        !           141:     SPOOLDIR_SVR4 was added for SVR4 style spool directories.
        !           142: 
        !           143:     Defaults are now permitted in the port and dialer files.
        !           144: 
        !           145:     The ALIAS field is supported in the HDB Permissions file.
        !           146: 
        !           147: DOCUMENTATION
        !           148: 
        !           149: The documentation is in the file uucp.texi, which is a Texinfo file.
        !           150: Texinfo is a format used by the Free Software Foundation.  You can
        !           151: print the documentation using TeX in combination with the file
        !           152: texinfo.tex.  DVI, PostScript and info versions of the documentation
        !           153: are available in a separate package, uucp-doc-1.04.tar.Z.
        !           154: 
        !           155: See the TODO file for things which should be done.  Please feel free
        !           156: to do them, although you may want to check with me first.  Send me
        !           157: suggestions for new things to do.
        !           158: 
        !           159: The compilation instructions are in uucp.texi.  Here is a summary.
        !           160: 
        !           161:     Edit Makefile.in to set installation directories.
        !           162: 
        !           163:     Type ``sh configure''.  You can pass a number of arguments in the
        !           164:     environment (using bash or sh, enter something like ``CC=gcc
        !           165:     configure''; using csh, enter something like ``setenv CC gcc; sh
        !           166:     configure''):
        !           167:         CC: C compiler to use; default is gcc if it exists, else cc
        !           168:         CFLAGS: Flags to pass to $CC when compiling; default -g
        !           169:         LDFLAGS: Flags to pass to $CC when only linking; default none
        !           170:         LIBS: Library arguments to pass to $CC; default none
        !           171:         INSTALL: Install program; default install -c or cp
        !           172:         INSTALLDATA: Install data; default install -c -m 0644 or cp
        !           173:     The configure script will compile a number of test programs to see
        !           174:     what is available on your system, so if your system is at all
        !           175:     unusual you will need to pass in $CC and $LIBS correctly.
        !           176: 
        !           177:     The configure script will create conf.h from conf.h.in and
        !           178:     Makefile from Makefile.in.  It will also create config.status,
        !           179:     which is a shell script which actually creates the files.  Please
        !           180:     report any configuration problems, so that they can be fixed in
        !           181:     later versions.
        !           182: 
        !           183:     Igor V. Semenyuk provided this (lightly edited) note about ISC
        !           184:     Unix 3.0.  The configure script will default to passing -posix to
        !           185:     gcc.  However, using -posix changes the environment to POSIX, and
        !           186:     on ISC 3.0, at least, the default for POSIX_NO_TRUNC is 1.  This
        !           187:     means nothing for uucp, but can lead to a problem when uuxqt
        !           188:     executes rmail.  IDA sendmail has dbm configuration files named
        !           189:     mailertable.{dir,pag}.  Notice these names are 15 characters long.
        !           190:     When uuxqt compiled with -posix executes rmail, which in turn
        !           191:     executes sendmail, the later is run under POSIX environment too!
        !           192:     This leads to sendmail bombing out with 'error opening 'M'
        !           193:     database: name too long' (mailertable.dir).  It's rather obscure
        !           194:     behaviour, and it took me a day to find out the cause.  I don't
        !           195:     use -posix, instead I run gcc with -D_POSIX_SOURCE, and add
        !           196:     -lcposix to LIBS.
        !           197: 
        !           198:     Examine conf.h and Makefile to make sure they're right.
        !           199: 
        !           200:     Edit policy.h for your local system.    
        !           201: 
        !           202:     Type ``make''.
        !           203: 
        !           204:     Use ``uuchk'' to check configuration files.  You can use
        !           205:     ``uuconv'' to convert between configuration file formats.
        !           206: 
        !           207:     Type ``make install'' to install.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.