INSTALLATION GUIDE
README	8.1	93/06/06

This version is based on the "rti uucp" that was on the 4.2BSD tape.
It contains many additional  features and fixes from Usenet,
Tom Truscott, Guy Harris, Lou Salkind, and many others.

A few new subdirectories have been added. Do a "make mkdirs" to make
sure that you have all of them.

I recommend that you change the uucp mail handler in your sendmail.cf
to something like:

	# Muucp, P=/usr/bin/uux, F=sDFMhuU, S=13, R=23, M=100000,
	# 	A=uux - -r $h!rmail ($u)
	Muucp, P=/usr/bin/uux, F=sDFMmhuU, S=13, R=23, M=100000,
		A=uux - -r -z -a$g -gC $h!rmail ($u)

The -a$g provides a return address in case mail fails (So It
won't go to yourmachine!uucp anymore.) The -gC specifies a grade
for mail. C is a good choice for mail. News should run at 'd'. This
way, mail gets sent before news. The 'm' flag specifies that this
mail can send to multiple addresses, which uux can.

The man pages now describe all the options for the various commands.
Make sure you read them. A list of the functional differences is in "Changes".

You should also look through the UUAIDS directory. There are some useful
programs and hints therein.

The maximum length of a site name has been changed from the old 7 to the
14. This is the be compatible with the HoneyDanBer uucp (aka BNU 1) which
is as close to a standard uucp as there is. Sites which have sitenames
longer than 7 characters that only send you the first 7 characters are
broken and should be fixed. However, there is a way of compensating for
this until they fix their problem. For each site you talk to that has a
name longer that 7 characters, put a line in /usr/lib/uucp/L.aliases of
the form:
	fullname name-truncated-to-7-characters.
E.g:
	tektronix tektron
	lbl-csam lbl-csa
	rochester rochest
	ut-sally ut-sall
(See UUAIDS/L.aliases for more details on aliasing uucp names.) If the site
name is <= 7 characters, you don't have to do anything.


Rick Adams
rick@seismo.ARPA
June 19, 1985

Tom Truscott, rti!trt,decvax!duke!trt (919)541-6488 Research Triangle Institute
Bob Gray, gray@berkeley, duke!adiron!bob (315) 336-4989

This is a variant of the uucp used at decvax, ittvax, rti, mcnc, adiron,
duke and others.  There have been tons of bug fixes and enhancements
from people on the usenet (thank you).  Speed is substantially
improved.  This version fixes essentially all of the McGeady's bug list.

Enhancements:

Dialers			Lots of dialers included.

Subdirectories		/usr/spool/uucp is now split into 7 subdirectories.
			This is a huge help on busy systems.

/usr/lib/uucp/L.cmds	List of commands permitted for remote execution.
			A line of form 'PATH=...' sets the search path.

expect-send sequence	Escape characters now permitted: \r, \n.
			\r, not \n, is default char sent at end of string.
			\c	(put at end of string). Dont send ending \r.
			\d	pause 1 second (\d\d pauses 2 seconds)
			"" P_ZERO  `expect nothing, start sending zero parity.'
			P_EVEN (default), P_ODD, P_ONE other parity modes.
			\05	Send a control-E
			"" ""   `expect nothing, send a \r'.

uupoll [sysname]	Polls named system.
uusnap			Displays spooled files, and pending uuxqts.


This version runs on all VAXen and PDPs under UNIX-V7 and 4.1bsd, 4.2BSD.
It also runs on Gould/SEL Concept series machines (e.g. 32/8750),
DUAL 68000 unisoft.
It also runns on BTL system III, IV, and V.

UUCP installers should read the two papers (by Dave Nowitz)
in Vol 2B of version 7 manuals and UUAIDS/setup.tblms.
Understand each step below before executing.
Some steps will vary slightly from system to system.

**** INSTALLATION *******

1. If you are currently running uucp, save the old programs!:
	su root
	cd /usr/bin
	for i in uucp uux uulog uuname	     (csh: foreach i (uucp ....) )
	do
		cp $i $i.old
	done					(csh: end )
	cd /usr/lib/uucp
	for i in uucico uuxqt uuclean
	do
		cp $i $i.old
	done

2. Editing Makefile and uucp.h
	4.2 sites using the supported dialers are all set with defaults.

	non-4.2
		a) sites need to install the Berkeley directory reading library.
			Try (cd libndir; make install).
			Edit Makefile to have LIBNDIR= -lndir
			define NDIR in uucp.h.
		b) Check LDFLAGS, OWNER, GROUP, and LIBUUCICO.
		c) pick a method to allow uucp to know its system:
			Check out GETHOSTNAME/UNAME/WHOAMI/CCWHOAMI in uucp.h
		d) define SYSIII if appropriate in uucp.h.
		e) Your "make" may fail because the Makefile is so large.
			If so, in /usr/src/cmds/make/defs, change
			'#define NFLEFTS 60' to 512, and re-make make.

3. Make the new commands.
	make

4. WAIT UNTIL THE UUCP SYSTEM IS IDLE!! Single-user is best.
	su root  (it is important that chmod, chown and chgrp work below)

5. Install the new commands:
	make install
	(If you are chicken, type 'make -n install' first).

6. Edit and install the control files:
	Look in UUAIDS.  Edit and install into /usr/lib/uucp if necessary
	USERFILE, L.cmds, L.sys, L-devices, L-dialcodes.
	THESE FILES MUST BE OWNED BY THE SAME OWNER AND GROUP AS
	THE UUCP COMMANDS AND UUCP SPOOL FILES!!! (probably uucp, daemon).
	The format for dialers is slightly different so that any dialer
	can be handled.

7. Make new subdirectories:
	For safety:  cd /usr/spool/uucp; tar c .   (save Qed files on tape)
	The following assumes your site name is produced by `uuname -l`.
	make mkdirs
		If your system is duke, then the subdirectories created are
		named C., D., D.duke, D.dukeX, TM., XTMP and X..
	rmdir /usr/lib/uucp/.XQTDIR
		which is obsolete (XTMP replaces it).

8. Move old Qed files:
	If you have spooled files, they must be moved into the subdirectories.
	Assuming all spool files are in /usr/spool/uucp
	(i.e. you did not have subdirs before)
	the following command will move the spool files
	to the right subdirectories:
    make mvspoolfiles; ??? does this work now??????????
	Files beginning C. are put in the C. subdirectory, and so on.
	Files begining D.dukeX are put in that directory, *not* D..
	(Note: if you already had a subdirectory version of uucp,
	you need only create the new subdirectories mentioned above
	and move the relevant files there.
    Delete other old directories if you had any (e.g. "LOG.")

9. Compact /usr/spool/uucp:
	cd /usr/spool
	mkdir nuucp
	chown uucp nuucp
	chgrp daemon nuucp
	for i in uucp/*    		(csh: foreach i (uucp/*) )
	do
		mv $i nuucp
	done				(csh: end )
	rmdir uucp
	mv nuucp uucp
		(Note: this does *not* work if a filesystem is mounted on
		/usr/spool/uucp!  If that is the case, you should 'tar'
		/usr/spool/uucp somewhere, unmount, re-mkfs, and re-mount
		the filesystem, and tar the uucp files back.)

10. Test the new system
	Test by mailing a letter somewhere and back.
	If it works, the new system is probably fine.
	Otherwise, figure out what is wrong.
	Start by examining LOGFILE.  Try /usr/lib/uucp/uucico -r1 -sname -x7
	If things are no-go, you can back out the changes by restoring the
	old uu programs and the spooled files.
	NOTE: The subdirectories foul up a non-subdir version,
	so be sure that subdirectories exist/do not exist as appropriate.


11. Install handy UUAIDS
	Look in uuaids for handy other stuff.  In particular, uu.* are
	shell scripts that can be run via cron hourly, daily, and weekly
	to keep uucp trim.  L-devices, L-dialcodes, L.cmds, L.sys, USERFILE
	are sample files.  THEY MOST LIKELY NEED TO BE MODIFIED TO USE
	THEM ON YOUR OWN SYSTEM!

	uu.hourly		Makes sure sites are polled.
	uu.daily		Runs uuclean to clean up /usr/spool/uucp.
				**IT HANDLES SUBDIRECTORIES!!
				Renames LOGFILE to LOGFILE.old.
	uu.weekly		Renames SYSLOG to SYSLOG.old.
	The above scripts should be run via cron.

	uucpsummary
		Summarizes LOGFILE and SYSLOG. It's very helpful in telling
		what is going on and who is calling who.
	uucp.daily
		Daily shell script run at ittvax.  Manages SYSLOG files in
		a convenient form for uuusage.  Not integrated in time
		for this distribution.


Comments, bug reports, *and improved code* are welcome.
	Tom Truscott
	Bob Gray

The rest of this file is oriented to updating a vanilla 4.2 system.
As 4.3 comes configured, all you have to do is uncomment the "uucpd"
line in /etc/inetd.conf (and of course update your L.sys as needed).
If you want to turn off logging uucp logins in wtmp, set the "user"
field in inetd.conf to "uucp", who doesn't have write permission on wtmp.

----------------------------------------------------------------------
Basically, to run UUCP on top of TCP, the code had to be changed to
not do ioctl's on sockets,etc. Also, a new protocl 't' was added.
This is because the 'g' protocol maxes out at about 9000 baud
regardless of the physical medium. The 't' protocol presumes an
error free channel, and is essentially the 'g' protocol with the
checksumming and packetizing ripped out.

To install it, make uucp with BSD4_2 defined in uucp.h.

Add a line in /etc/services that looks like:
uucp		540/tcp		uucpd

Add lines to /etc/rc.local that looks something like:
if [ -f /etc/uucpd ]; then
	/etc/uucpd & echo -n ' uucpd'				>/dev/console
fi

The L.sys entry should look something like:
uucpname time-to-call TCP port networkname standard uucp login chat

This is how it would look for rochester.
rochester Any TCP uucp ur-seneca "" uucplogin "" uucppasswd

UUCP site rochester is arpanet site ur-seneca (and there is a
arpanet site rochester  that is a different machine)

The "port" field is either a word or a number. It is a number,
that number is used as the port. If it is a word, the word is
looked up in /etc/services and the port is taken from there.

Another example would be:
seismo Any TCP 33 seismo "" uucplogin "" uucppassword

In almost every case, the networkname field will be the same as the
uucpname field. Similarly, the port field will usually be "uucp", which
says to use the standard uucp port from the services file.

The daemon expects the incoming site to send its login and password
for authentication.

If you have any problems feel free to call me:

	Rick Adams
	Center for Seismic Studies
	1300 North 17th Street, Suite 1450
	Arlington, VA 22209
	(703) 276-7900
	rick@seismo.ARPA
	seismo!rick

We started to use uucp after the dialin lines had been in place for a while.
It would have been very unpopular here to remove one of lines from public use
to let uucp dial out.  The first version of these changes ran here early in
1983.

Having this ability is very useful way to make full use of your modems. For
one thing, I can smile when a neighoring site complains that their one dialer
is tied up from news backed up to one of their neighbors which has been down
for a while and has just come back up. For another thing some of our neighbors
seem to be reachable better by some modems than by others.  For example, I can
only reach rocky2 with a Racal Vadic.  I can only reach akgua, burl, and
sjuvax with a Hayes.  When our 2400 baud modem arrives so I can make special
note of that --- and I don't have to buy two 2400 baud modems to have two-way
2400 baud capability.

The key to this is a program is provided in the file acucntrl.c .  This should
be installed suid to root in the file /usr/lib/uucp/acucntrl .


uucp notes:
The 3rd field of the L-devices file should contain "inout"  for all devices
intended for dialin/out use.  Devices without the "inout" specification will
be used like before: for dialout only.

Good luck.  I want to never go back to reserving modems for dialout.

Bill Sebok			Princeton University, Astrophysics
{allegra,akgua,burl,cbosgd,decvax,ihnp4,noao,princeton,vax135}!astrovax!wls