head	1.2;
access;
symbols
	C_3:1.2
	C_2:1.2
	C_1:1.1;
locks; strict;
comment	@# @;


1.2
date	90.08.23.22.29.54;	author roger;	state C_3;
branches;
next	1.1;

1.1
date	90.08.23.19.19.02;	author roger;	state C_1;
branches;
next	;


desc
@@


1.2
log
@porting code drop
@
text
@# $Id$
#
		Basic Networking Utilities
Customer Information Documents

Basic Networking Utilities Product Overview - release 1 # 307-038
Basic Networking Utilities Installation Guide and Release Notes
   - Release 1 # 307-036
Basic Networking Utilities - release 1 # 307-165
See the following files:
uucp.D		Administrative manual
		It includes files uucp.D, App*
		(mm -t uucp.D)

See the following for additional information:
Permissions:	an example of a Permissions file. (a default will be generated
		during the installation procedure.
uucp.1c		manual page for uucp
uustat.1c:	uustat man page
uulog.1c:	uulog man page
uucleanup.1m:	man page for uucleanup
uugetty.1m	man page for a getty that permits input/output on a port
uudemon.hour:	hourly demon
uudemon.poll:	polling demon
uudemon.admin:	to send messages about status to the administrator of uucp
uudemon.cleanup:	cleanup demon

Some useful shells:
Uutry:		shell for debugging--starts uucico with debugging option
Cvt:		shell to move C. and D. files from /usr/spool/uucp to proper
		place for the new directory structure
SetUp		shell that copies old system files to the
		new places (L.sys etc)
		NOTE - this will be
		automatically run during installation

Here are some pointers for converting to the new version:

1- There are some significant changes in L.sys  (new name = Systems) format.
    a-	For direct lines, the first device specification is changed
	from "ttyxx" to "Direct"
    b-	On time fields where the default wait time was specified,
	the ',' must be changed to a ';'
	In addition, the time has a slightly different meaning.
	The retry algorithm is now an exponential backoff with initial
	time (RETRYTIME in parms.h) and max retrytime (MAXRETRYTIME in
	parms.h).  If the ;time field is specified, that will always
	be the retry time.  If it is not given, the backoff will be used.
   (SEE Basic Networking Utilities - release 1 # 307-165 for details)

2- The L-devices (new name=Devices) file must also be changed.
    a-	All ACU lines must have "801" or the name of the modem
	(for example, penril) added to the end of the line.
    b-	All DIR lines must have "DIR" changed to "Direct"
	and the word 'direct' added to the line.
    See the comments in the Devices file delivered with the source.
   see uucp.D documentation for details.
   (SEE Basic Networking Utilities - release 1 # 307-165 for details)

3- The uucico program no longer searches for a system to call, it
   must be called with a -s option.  A new program, uusched,
   does the search for work and calls remotes in random order,
   by invoking uucico with -sSYSTEM option.  (see uudemon.hour)

Cron entries should be put into crontab for the demons. For example

39,9 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.hour" > /dev/null
10 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.poll" > /dev/null
45 23 * * * ulimit 5000; /bin/su uucp -c "/usr/lib/uucp/uudemon.cleanup" > /dev/null
48 10,14 * * 1-5 /bin/su uucp -c "/usr/lib/uucp/uudemon.admin" > /dev/null

Note - It is best to run these demons from the root cron file.
At a minimum, the uudemon.cleanup entry must be started as root since it must
invoke a 'ulimit' command.



For building the system:
1- Carefully go through the parms.h file to set it up for your
   environment.
   environment. (see Appendix I for details)
  (SEE Basic Networking Utilities - release 1 # 307-165 for details)

2- During installation, a Permissions file will be created
   if one does not already exist.
   It will also make the needed directories, create some files in
   /usr/lib/uucp and install the uudemons.

3- The demons also send mail to someone (default uucp).  Change as
   desired.


Other misc:
0- See uucp.D to learn how to set up the Permissions file.
   A default one will be created by make install.
1- There is a new undocumented option for the Permissions file.
   MYNAME=somename.  When used on a LOGNAME line, it will be the
   name reported in the Shere message when someone logs in as
   one of the names in LOGNAME.  If used in MACHINE= entry, it
   is the name used to identify you when you call someone.
@


1.1
log
@Initial revision
@
text
@d1 1
a1 2
#	Convergent Technologies - System V - Feb 1986
#ident	"@@(#)README	6.2 :/source/cmd/uucp/s.README 6/17/86 10:14:37"
@
