Home | History | Annotate | Download | only in bnu
      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
     25 Customer Information Documents
     26 
     27 Basic Networking Utilities Product Overview - release 1 # 307-038
     28 Basic Networking Utilities Installation Guide and Release Notes
     29    - Release 1 # 307-036
     30 Basic Networking Utilities - release 1 # 307-165
     31 
     32 See the following for additional information:
     33 Permissions:	an example of a Permissions file. (a default will be generated
     34 		during the installation procedure.
     35 uucp.1c		manual page for uucp
     36 uustat.1c:	uustat man page
     37 uulog.1c:	uulog man page
     38 uucleanup.1m:	man page for uucleanup
     39 uudemon.hour:	hourly demon
     40 uudemon.poll:	polling demon
     41 uudemon.admin:	to send messages about status to the administrator of uucp
     42 uudemon.cleanup:	cleanup demon
     43 
     44 Some useful shells:
     45 Uutry:		shell for debugging--starts uucico with debugging option
     46 Cvt:		shell to move C. and D. files from /usr/spool/uucp to proper
     47 		place for the new directory structure
     48 SetUp		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 
     53 Here are some pointers for converting to the new version:
     54 
     55 1- 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 
     67 2- 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 
     75 3- 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 
     80 Cron entries should be put into crontab for the demons. For example
     81 
     82 39,9 * * * * /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.hour" > /dev/null
     83 10 * * * * /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.poll" > /dev/null
     84 45 23 * * * ulimit 5000; /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.cleanup" > /dev/null
     85 48 10,14 * * 1-5 /usr/bin/su uucp -c "/usr/lib/uucp/uudemon.admin" > /dev/null
     86 
     87 Note - It is best to run these demons from the root cron file.
     88 At a minimum, the uudemon.cleanup entry must be started as root since it must
     89 invoke a 'ulimit' command.
     90 
     91 
     92 
     93 For building the system:
     94 1- 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 
     98 2- 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 
    103 3- The demons also send mail to someone (default uucp).  Change as
    104    desired.
    105 
    106 
    107 Other misc:
    108 0- 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