xref: /onnv-gate/usr/src/cmd/bnu/README (revision 0:68f95e015346)
1*0Sstevel@tonic-gate#
2*0Sstevel@tonic-gate# CDDL HEADER START
3*0Sstevel@tonic-gate#
4*0Sstevel@tonic-gate# The contents of this file are subject to the terms of the
5*0Sstevel@tonic-gate# Common Development and Distribution License, Version 1.0 only
6*0Sstevel@tonic-gate# (the "License").  You may not use this file except in compliance
7*0Sstevel@tonic-gate# with the License.
8*0Sstevel@tonic-gate#
9*0Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*0Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
11*0Sstevel@tonic-gate# See the License for the specific language governing permissions
12*0Sstevel@tonic-gate# and limitations under the License.
13*0Sstevel@tonic-gate#
14*0Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
15*0Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*0Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
17*0Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
18*0Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
19*0Sstevel@tonic-gate#
20*0Sstevel@tonic-gate# CDDL HEADER END
21*0Sstevel@tonic-gate#
22*0Sstevel@tonic-gate#ident	"%Z%%M%	%I%	%E% SMI"	/* from SVR4 bnu:README 2.5 */
23*0Sstevel@tonic-gate
24*0Sstevel@tonic-gate		Basic Networking Utilities
25*0Sstevel@tonic-gateCustomer Information Documents
26*0Sstevel@tonic-gate
27*0Sstevel@tonic-gateBasic Networking Utilities Product Overview - release 1 # 307-038
28*0Sstevel@tonic-gateBasic Networking Utilities Installation Guide and Release Notes
29*0Sstevel@tonic-gate   - Release 1 # 307-036
30*0Sstevel@tonic-gateBasic Networking Utilities - release 1 # 307-165
31*0Sstevel@tonic-gate
32*0Sstevel@tonic-gateSee the following for additional information:
33*0Sstevel@tonic-gatePermissions:	an example of a Permissions file. (a default will be generated
34*0Sstevel@tonic-gate		during the installation procedure.
35*0Sstevel@tonic-gateuucp.1c		manual page for uucp
36*0Sstevel@tonic-gateuustat.1c:	uustat man page
37*0Sstevel@tonic-gateuulog.1c:	uulog man page
38*0Sstevel@tonic-gateuucleanup.1m:	man page for uucleanup
39*0Sstevel@tonic-gateuudemon.hour:	hourly demon
40*0Sstevel@tonic-gateuudemon.poll:	polling demon
41*0Sstevel@tonic-gateuudemon.admin:	to send messages about status to the administrator of uucp
42*0Sstevel@tonic-gateuudemon.cleanup:	cleanup demon
43*0Sstevel@tonic-gate
44*0Sstevel@tonic-gateSome useful shells:
45*0Sstevel@tonic-gateUutry:		shell for debugging--starts uucico with debugging option
46*0Sstevel@tonic-gateCvt:		shell to move C. and D. files from /usr/spool/uucp to proper
47*0Sstevel@tonic-gate		place for the new directory structure
48*0Sstevel@tonic-gateSetUp		shell that copies old system files to the
49*0Sstevel@tonic-gate		new places (L.sys etc)
50*0Sstevel@tonic-gate		NOTE - this will be
51*0Sstevel@tonic-gate		automatically run during installation
52*0Sstevel@tonic-gate
53*0Sstevel@tonic-gateHere are some pointers for converting to the new version:
54*0Sstevel@tonic-gate
55*0Sstevel@tonic-gate1- There are some significant changes in L.sys  (new name = Systems) format.
56*0Sstevel@tonic-gate    a-	For direct lines, the first device specification is changed
57*0Sstevel@tonic-gate	from "term/xx" to "Direct"
58*0Sstevel@tonic-gate    b-	On time fields where the default wait time was specified,
59*0Sstevel@tonic-gate	the ',' must be changed to a ';'
60*0Sstevel@tonic-gate	In addition, the time has a slightly different meaning.
61*0Sstevel@tonic-gate	The retry algorithm is now an exponential backoff with initial
62*0Sstevel@tonic-gate	time (RETRYTIME in parms.h) and max retrytime (MAXRETRYTIME in
63*0Sstevel@tonic-gate	parms.h).  If the ;time field is specified, that will always
64*0Sstevel@tonic-gate	be the retry time.  If it is not given, the backoff will be used.
65*0Sstevel@tonic-gate   (SEE Basic Networking Utilities - release 1 # 307-165 for details)
66*0Sstevel@tonic-gate
67*0Sstevel@tonic-gate2- The L-devices (new name=Devices) file must also be changed.
68*0Sstevel@tonic-gate    a-	All ACU lines must have "801" or the name of the modem
69*0Sstevel@tonic-gate	(for example, penril) added to the end of the line.
70*0Sstevel@tonic-gate    b-	All DIR lines must have "DIR" changed to "Direct"
71*0Sstevel@tonic-gate	and the work 'direct' added to the line.
72*0Sstevel@tonic-gate    See the comments in the Devices file delivered with the source.
73*0Sstevel@tonic-gate   (SEE Basic Networking Utilities - release 1 # 307-165 for details)
74*0Sstevel@tonic-gate
75*0Sstevel@tonic-gate3- The uucico program no longer searches for a system to call, it
76*0Sstevel@tonic-gate   must be called with a -s option.  A new program, uusched,
77*0Sstevel@tonic-gate   does the search for work and calls remotes in random order,
78*0Sstevel@tonic-gate   by invoking uucico with -sSYSTEM option.  (see uudemon.hour)
79*0Sstevel@tonic-gate
80*0Sstevel@tonic-gateCron entries should be put into crontab for the demons. For example
81*0Sstevel@tonic-gate
82*0Sstevel@tonic-gate39,9 * * * * /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.hour" > /dev/null
83*0Sstevel@tonic-gate10 * * * * /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.poll" > /dev/null
84*0Sstevel@tonic-gate45 23 * * * ulimit 5000; /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.cleanup" > /dev/null
85*0Sstevel@tonic-gate48 10,14 * * 1-5 /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.admin" > /dev/null
86*0Sstevel@tonic-gate
87*0Sstevel@tonic-gateNote - It is best to run these demons from the root cron file.
88*0Sstevel@tonic-gateAt a minimum, the uudemon.cleanup entry must be started as root since it must
89*0Sstevel@tonic-gateinvoke a 'ulimit' command.
90*0Sstevel@tonic-gate
91*0Sstevel@tonic-gate
92*0Sstevel@tonic-gate
93*0Sstevel@tonic-gateFor building the system:
94*0Sstevel@tonic-gate1- Carefully go through the parms.h file to set it up for your
95*0Sstevel@tonic-gate   environment.
96*0Sstevel@tonic-gate  (SEE Basic Networking Utilities - release 1 # 307-165 for details)
97*0Sstevel@tonic-gate
98*0Sstevel@tonic-gate2- During installation, a Permissions file will be created
99*0Sstevel@tonic-gate   if one does not already exist.
100*0Sstevel@tonic-gate   It will also make the needed directories, create some files in
101*0Sstevel@tonic-gate   /usr/lib/uucp and install the uudemons.
102*0Sstevel@tonic-gate
103*0Sstevel@tonic-gate3- The demons also send mail to someone (default uucp).  Change as
104*0Sstevel@tonic-gate   desired.
105*0Sstevel@tonic-gate
106*0Sstevel@tonic-gate
107*0Sstevel@tonic-gateOther misc:
108*0Sstevel@tonic-gate0- SEE Basic Networking Utilities - release 1 # 307-165
109*0Sstevel@tonic-gate   to learn how to set up the Permissions file.
110*0Sstevel@tonic-gate   A default one will be created by make install.
111