head	1.4;
access;
symbols
	RELENG_4_11_0_RELEASE:1.3
	RELENG_4_11:1.3.0.26
	RELENG_4_11_BP:1.3
	RELENG_4_10_0_RELEASE:1.3
	RELENG_4_10:1.3.0.24
	RELENG_4_10_BP:1.3
	RELENG_4_9_0_RELEASE:1.3
	RELENG_4_9:1.3.0.22
	RELENG_4_9_BP:1.3
	RELENG_4_8_0_RELEASE:1.3
	RELENG_4_8:1.3.0.20
	RELENG_4_8_BP:1.3
	RELENG_4_7_0_RELEASE:1.3
	RELENG_4_7:1.3.0.18
	RELENG_4_7_BP:1.3
	RELENG_4_6_2_RELEASE:1.3
	RELENG_4_6_1_RELEASE:1.3
	RELENG_4_6_0_RELEASE:1.3
	RELENG_4_6:1.3.0.16
	RELENG_4_6_BP:1.3
	RELENG_4_5_0_RELEASE:1.3
	RELENG_4_5:1.3.0.14
	RELENG_4_5_BP:1.3
	RELENG_4_4_0_RELEASE:1.3
	RELENG_4_4:1.3.0.12
	RELENG_4_4_BP:1.3
	RELENG_4_3_0_RELEASE:1.3
	RELENG_4_3:1.3.0.10
	RELENG_4_3_BP:1.3
	RELENG_4_2_0_RELEASE:1.3
	RELENG_4_1_1_RELEASE:1.3
	PRE_SMPNG:1.3
	RELENG_4_1_0_RELEASE:1.3
	RELENG_3_5_0_RELEASE:1.3
	RELENG_4_0_0_RELEASE:1.3
	RELENG_4:1.3.0.8
	RELENG_4_BP:1.3
	RELENG_3_4_0_RELEASE:1.3
	RELENG_3_3_0_RELEASE:1.3
	RELENG_3_2_PAO:1.3.0.6
	RELENG_3_2_PAO_BP:1.3
	RELENG_3_2_0_RELEASE:1.3
	RELENG_3_1_0_RELEASE:1.3
	RELENG_3:1.3.0.4
	RELENG_3_BP:1.3
	RELENG_2_2_8_RELEASE:1.3
	RELENG_3_0_0_RELEASE:1.3
	RELENG_2_2_7_RELEASE:1.3
	RELENG_2_2_6_RELEASE:1.3
	RELENG_2_2_5_RELEASE:1.3
	RELENG_2_2_2_RELEASE:1.3
	RELENG_2_2_1_RELEASE:1.3
	RELENG_2_2_0_RELEASE:1.3
	RELENG_2_1_7_RELEASE:1.2.6.1
	RELENG_2_1_6_1_RELEASE:1.2.6.1
	RELENG_2_1_6_RELEASE:1.2.6.1
	RELENG_2_2:1.3.0.2
	RELENG_2_2_BP:1.3
	RELENG_2_1_5_RELEASE:1.2.6.1
	RELENG_2_1_0_RELEASE:1.2.6.1
	RELENG_2_1_0:1.2.0.6
	RELENG_2_1_0_BP:1.2
	RELENG_2_0_5_RELEASE:1.2
	RELENG_2_0_5:1.2.0.4
	RELENG_2_0_5_BP:1.2
	RELENG_2_0_5_ALPHA:1.2
	RELEASE_2_0:1.2
	BETA_2_0:1.2
	ALPHA_2_0:1.2.0.2
	MOVED_NEWCVS:1.2
	FINAL_1_1_5:1.2
	ALPHA_1_1_5:1.2
	FINAL_1_1:1.1
	GAMMA_1_1:1.1
	BETA_1_1:1.1.0.2
	BP_BETA_1_1:1.1
	FINAL_1_0:1.1
	EPSILON_1_0:1.1
	GAMMA_1_0:1.1
	BETA_1_0:1.1;
locks; strict;
comment	@# @;


1.4
date	2001.10.01.06.22.38;	author kris;	state dead;
branches;
next	1.3;

1.3
date	95.08.19.21.23.04;	author ache;	state Exp;
branches;
next	1.2;

1.2
date	94.05.07.18.08.12;	author ache;	state Exp;
branches
	1.2.6.1;
next	1.1;

1.1
date	93.08.05.18.22.24;	author conklin;	state Exp;
branches;
next	;

1.2.6.1
date	95.09.01.06.01.16;	author davidg;	state Exp;
branches;
next	;


desc
@@


1.4
log
@Phase I of UUCP migration to ports.  This leaves behind a minimal build
environment for cu, which is still useful.
@
text
@This is the README file for version 1.06 of the Taylor UUCP package.

It was written by Ian Lance Taylor.  I can be reached at ian@@airs.com,
or, equivalently, uunet!cygint!airs!ian, or c/o Cygnus Support,
48 Grove Street, Somerville, MA 02144, USA.

There is a mailing list for discussion of the package.  The list is
hosted by Eric Schnoebelen at cirr.com.  To join (or get off) the
list, send mail to taylor-uucp-request@@cirr.com.  Mail to this address
is answered by the majordomo program.  To join the list, send the
message ``subscribe ADDRESS'' where ADDRESS is your e-mail address.
To send a message to the list, send it to taylor-uucp@@cirr.com.  The
old list address, taylor-uucp@@gnu.ai.mit.edu, will also work.  There
is an archive of all messages sent to the mailing list at ftp.cirr.com.

This package is covered by the Gnu Public License.  See the file
COPYING for details.  If you would like to do something with this
package that you feel is reasonable but you feel is prohibited by the
license, contact me to see if we can work it out.

The most recent version may be obtained from any Gnu archive site.
The canonical site is prep.ai.mit.edu.  There are many mirror sites,
including ftp.uu.net and wuarchive.wustl.edu.

WHAT IT IS

This is the complete source code for a Unix UUCP package.  It provides
everything you need to make a UUCP connection.  It includes versions
of uucico, uusched, uuxqt, uux, uucp, uustat, uulog, uuname, uuto,
uupick, and cu, as well as uuchk (a program to check configuration
files), uuconv (a program to convert from one type of configuration
file to another) and tstuu (a test harness for the package).

This is the standard UUCP package of the Free Software Foundation.

The package currently supports the 'f', 'g' (in all window and packet
sizes), 'G', 't' and 'e' protocols, as well a Zmodem protocol, the FX
UUCICO 'y' protocol, and two new bidirectional protocols.  If you have
a Berkeley sockets library, it can make TCP connections.  If you have
TLI libraries, it can make TLI connections.  It supports a new
configuration file mechanism which I like (but other people dislike).

The package has a few advantages over regular UUCP:

    You get the source code.

    It uses significantly less CPU time than many UUCP packages.

    You can specify a chat script to run when a system calls in,
    allowing adjustment of modem parameters on a per system basis.

    You can specify failure strings for chat scripts, allowing the
    chat script to fail immediately if the modem returns ``BUSY''.

    If you are talking to another instance of the package, you can use
    the new bidirectional protocol for rapid data transfer in both
    directions at once.  You can also restrict file transfers by size
    based on the time of day and who placed the call.

On the other hand:

    It only runs on Unix.  The code is carefully divided into system
    dependent and system independent portions, so it should be
    possible to port it to other systems.  It would not be trivial.

    You don't get uuclean, uusend, uuq, uusnap, uumonitor, uutry,
    uupoll, etc.  If you have current copies of these programs, you
    may be able to use them.  Shell scripts versions of uuclean and
    uutry are provided, with most, if not all, of the functionality of
    the usual programs.  I believe the supplied uustat program allows
    you to do everything that uuq, uusnap and uumonitor do.  uupoll
    could be written as a shell script.

    The package does not read modemcap or acucap files, although you
    can use V2 configuration files with a BNU Dialers file or a dialer
    file written in my new configuration file format.

    The package cannot use SCO dialer programs directly, although it
    can with a simple shell script interface.

If you start using this package, I suggest that you join the mailing
list (see above) to keep up to date on patches and new versions.  I am
also open to suggestions for improvements and modifications.

DOCUMENTATION

The documentation is in the file uucp.texi, which is a Texinfo file.
Texinfo is a format used by the Free Software Foundation.  You can
print the documentation using TeX in combination with the file
texinfo.tex.  DVI, PostScript and info versions of the documentation
are available in a separate package, uucp-doc-1.06.tar.gz.

See the TODO file for things which should be done.  Please feel free
to do them, although you may want to check with me first.  Send me
suggestions for new things to do.

The compilation instructions are in uucp.texi.  Here is a summary.

    Edit Makefile.in to set installation directories.

    Type ``sh configure''.  You can pass a number of arguments in the
    environment (using bash or sh, enter something like ``CC=gcc
    configure''; using csh, enter something like ``setenv CC gcc; sh
    configure''):
        CC: C compiler to use; default is gcc if it exists, else cc
        CFLAGS: Flags to pass to $CC when compiling; default -g
        LDFLAGS: Flags to pass to $CC when only linking; default none
        LIBS: Library arguments to pass to $CC; default none
        INSTALL: Install program; default install -c or cp
    The configure script will compile a number of test programs to see
    what is available on your system, so if your system is at all
    unusual you will need to pass in $CC and $LIBS correctly.

    The configure script will create config.h from config.h.in and
    Makefile from Makefile.in.  It will also create config.status,
    which is a shell script which actually creates the files.  Please
    report any configuration problems, so that they can be fixed in
    later versions.

    Igor V. Semenyuk provided this (lightly edited) note about ISC
    Unix 3.0.  The configure script will default to passing -posix to
    gcc.  However, using -posix changes the environment to POSIX, and
    on ISC 3.0, at least, the default for POSIX_NO_TRUNC is 1.  This
    means nothing for uucp, but can lead to a problem when uuxqt
    executes rmail.  IDA sendmail has dbm configuration files named
    mailertable.{dir,pag}.  Notice these names are 15 characters long.
    When uuxqt compiled with -posix executes rmail, which in turn
    executes sendmail, the later is run under POSIX environment too!
    This leads to sendmail bombing out with 'error opening 'M'
    database: name too long' (mailertable.dir).  It's rather obscure
    behaviour, and it took me a day to find out the cause.  I don't
    use -posix, instead I run gcc with -D_POSIX_SOURCE, and add
    -lcposix to LIBS.

    On some versions of BSDI there is a bug in the shell which causes
    the default value for CFLAGS to be set incorrectly.  If ``echo
    ${CFLAGS--g}'' echoes ``g'' rather than ``-g'', then you must set
    CFLAGS in the environment before running configure.  There is a
    patch available from BSDI for this bug.  (Reported by David
    Vrona).

    On AIX 3.2.5, and possibly other versions, cc -E does not work,
    reporting ``Option NOROCONST is not valid.''  Test this before
    running configure by doing something like
	touch /tmp/foo.c
	cc -E /tmp/foo.c
    This may give a warning about the file being empty, but it should
    not give the ``Option NOROCONST'' warning.  The workaround is to
    remove the ",noroconst" entry from the "options" clause in the
    "cc" stanza in /etc/xlc.cfg.  (Reported by Chris Lewis).

    Examine config.h and Makefile to make sure they're right.

    Edit policy.h for your local system.    

    Type ``make''.

    Use ``uuchk'' to check configuration files.  You can use
    ``uuconv'' to convert between configuration file formats.

    Type ``make install'' to install.  Note that by default the
    programs are compiled with debugging information, and they are not
    stripped when they are installed.  Read the man page for strip for
    more information.

    On older System V based systems which do not have the setreuid
    system call, problems may arise if ordinary users can start an
    execution of uuxqt, perhaps indirectly via uucp or uux.  UUCP jobs
    may wind up executing with a real user ID of the user who invoked
    uuxqt, which can cause problems if the UUCP job checks the real
    user ID for security purposes.  On such systems, it is safest to
    put ``run-uuxqt never'' in the `config' file, so that uucico never
    starts uuxqt, and invoke uuxqt directly from cron.
@


1.3
log
@Commit delta: current -> 1.06 + FreeBSD configuration
@
text
@@


1.2
log
@Upgrade to version 1.05
@
text
@d1 1
a1 1
This is the README file for version 1.05 of the Taylor UUCP package.
d5 1
a5 1
Building 200, 1 Kendall Square, Cambridge MA, 02139, USA.
d7 8
a14 10
There is a mailing list for discussion of the package.  To join (or
get off) the list, send mail to taylor-uucp-request@@gnu.ai.mit.edu.
Mail to this address is answered by a person, not a program.  When
joining the list, make sure you include the address at which you want
to receive mail in the body of your message.  To send a message to the
list, send it to taylor-uucp@@gnu.ai.mit.edu.

Jeff Ross has volunteered to maintain patches for UUCP releases.  They
may be obtained via anonymous FTP from ftp.fdu.edu, in the directory
pub/taylor-uucp.
d21 4
d37 5
a41 5
sizes), 'G', 't' and 'e' protocols, as well a Zmodem protocol and two
new bidirectional protocols.  If you have a Berkeley sockets library,
it can make TCP connections.  If you have TLI libraries, it can make
TLI connections.  It supports a new configuration file mechanism which
I like (but other people dislike).
d91 1
a91 1
are available in a separate package, uucp-doc-1.05.tar.gz.
a109 1
        INSTALLDATA: Install data; default install -c -m 0644 or cp
d139 2
a140 1
    patch available from BSDI for this bug.  (From David Vrona).
d150 1
a150 1
    "cc" stanza in /etc/xlc.cfg.  (From Chris Lewis).
d165 9
@


1.2.6.1
log
@Brought in changes from main branch: updated to UUCP 1.06.1

Reviewed by:	ache
@
text
@d1 1
a1 1
This is the README file for version 1.06 of the Taylor UUCP package.
d5 1
a5 1
48 Grove Street, Somerville, MA 02144, USA.
d7 10
a16 8
There is a mailing list for discussion of the package.  The list is
hosted by Eric Schnoebelen at cirr.com.  To join (or get off) the
list, send mail to taylor-uucp-request@@cirr.com.  Mail to this address
is answered by the majordomo program.  To join the list, send the
message ``subscribe ADDRESS'' where ADDRESS is your e-mail address.
To send a message to the list, send it to taylor-uucp@@cirr.com.  The
old list address, taylor-uucp@@gnu.ai.mit.edu, will also work.  There
is an archive of all messages sent to the mailing list at ftp.cirr.com.
a22 4
The most recent version may be obtained from any Gnu archive site.
The canonical site is prep.ai.mit.edu.  There are many mirror sites,
including ftp.uu.net and wuarchive.wustl.edu.

d35 5
a39 5
sizes), 'G', 't' and 'e' protocols, as well a Zmodem protocol, the FX
UUCICO 'y' protocol, and two new bidirectional protocols.  If you have
a Berkeley sockets library, it can make TCP connections.  If you have
TLI libraries, it can make TLI connections.  It supports a new
configuration file mechanism which I like (but other people dislike).
d89 1
a89 1
are available in a separate package, uucp-doc-1.06.tar.gz.
d108 1
d138 1
a138 2
    patch available from BSDI for this bug.  (Reported by David
    Vrona).
d148 1
a148 1
    "cc" stanza in /etc/xlc.cfg.  (Reported by Chris Lewis).
a162 9

    On older System V based systems which do not have the setreuid
    system call, problems may arise if ordinary users can start an
    execution of uuxqt, perhaps indirectly via uucp or uux.  UUCP jobs
    may wind up executing with a real user ID of the user who invoked
    uuxqt, which can cause problems if the UUCP job checks the real
    user ID for security purposes.  On such systems, it is safest to
    put ``run-uuxqt never'' in the `config' file, so that uucico never
    starts uuxqt, and invoke uuxqt directly from cron.
@


1.1
log
@Taylor UUCP 1.04
@
text
@d1 1
a1 1
This is the README file for version 1.04 of the Taylor UUCP package.
d4 2
a5 2
or, equivalently, uunet!cygint!airs!ian, or c/o Cygnus Support, 4th
Floor, Building 200, 1 Kendall Square, Cambridge MA, 02139, USA.
d14 4
d32 1
a32 2
The Free Software Foundation plans to make this their standard UUCP
package.
a82 67
CHANGES SINCE 1.03

For a complete list, see ChangeLog.

IMPORTANT: the default when talking to another version of 1.04 is to
use the new bidirectional 'i' protocol.  If you are using a
half-duplex modem, such as a Telebit T2500, you will want to either
mark the port as half-duplex with the ``half-duplex'' command, or
force use of the 'g' protocol by using the ``protocol'' command in the
sys or port file or by adding ``,g'' after the port name in the
Systems or L.sys or Devices file.

    As usual, many bugs were fixed.

    Bidirectional transfers are supported with the new 'i' protocol;
    it requires an eight-bit clear datapath.

    New programs: uusched, cu, uuto and uupick.

    The 'G' protocol and a new Zmodem protocol were added.

    A number of uustat options were added to support uuclean, and a
    sample uuclean shell script was added to the contrib directory.
    The uustat output formats were changed slightly.

    A protocol extension eliminates transfer of the command file for
    simple commands, such as rmail or rnews, when talking to another
    version of 1.04.

    Some TLI support was added.

    UUCP forwarding was added, along with the ``forward-to'',
    ``forward-from'' and ``forward'' commands.

    If a file transfer fails in the middle, the retry will now start
    from where it left off.  The implementation is compatible with
    SVR4.

    The work queue is checked every 10 minutes during a conversation;
    if there is new work and a bidirectional protocol is not in use,
    the receiving uucico requests the sender to transfer control.

    The amount of free disk space is checked periodically as a file is
    received, and if it drops too low the call is aborted.

    The UUCP configuration file reading routines were moved into a
    standalone library, uuconf.  All known bugs in V2 and HDB
    configuration file reading were fixed.

    The ``half-duplex'' command was added for the port and dialer
    files.

    The ``max-retries'', ``success-wait'', ``send-request'' and
    ``receive-request'' commands were added for the sys file.  The
    ``call-request'' and ``called-request'' commands were eliminated
    (they did not work correctly anyhow).

    \d in chat scripts now calls sleep (2) rather than sleep (1), so
    it will sleep longer (on some systems sleep(1) may delay much less
    than one second).

    SPOOLDIR_SVR4 was added for SVR4 style spool directories.

    Defaults are now permitted in the port and dialer files.

    The ALIAS field is supported in the HDB Permissions file.

d89 1
a89 1
are available in a separate package, uucp-doc-1.04.tar.Z.
d113 1
a113 1
    The configure script will create conf.h from conf.h.in and
d134 17
a150 1
    Examine conf.h and Makefile to make sure they're right.
d159 4
a162 1
    Type ``make install'' to install.
@
