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