make '' default to file beginning if no large movements yet
[unix-history] / usr / src / usr.bin / uucp / DOC / README
index ba463ba..8141da3 100644 (file)
@@ -1,5 +1,54 @@
 INSTALLATION GUIDE
 INSTALLATION GUIDE
-README 5.1     83/07/02
+README 5.6     85/06/24
+
+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
 
 Tom Truscott, rti!trt,decvax!duke!trt (919)541-6488 Research Triangle Institute
 Bob Gray, gray@berkeley, duke!adiron!bob (315) 336-4989
@@ -35,8 +84,7 @@ 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.
 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 should not be hard to get it running on BTL system III, IV, and V.
-On such systems, put "#define SYSIII" in uucp.h and pray.
+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.
 
 UUCP installers should read the two papers (by Dave Nowitz)
 in Vol 2B of version 7 manuals and UUAIDS/setup.tblms.
@@ -63,7 +111,7 @@ Some steps will vary slightly from system to system.
 
        non-4.2
                a) sites need to install the Berkeley directory reading library.
 
        non-4.2
                a) sites need to install the Berkeley directory reading library.
-                       Try (cd LIBNDIR; make install).
+                       Try (cd libndir; make install).
                        Edit Makefile to have LIBNDIR= -lndir
                        define NDIR in uucp.h.
                b) Check LDFLAGS, OWNER, GROUP, and LIBUUCICO.
                        Edit Makefile to have LIBNDIR= -lndir
                        define NDIR in uucp.h.
                b) Check LDFLAGS, OWNER, GROUP, and LIBUUCICO.
@@ -85,11 +133,12 @@ Some steps will vary slightly from system to system.
        (If you are chicken, type 'make -n install' first).
 
 6. Edit and install the control files:
        (If you are chicken, type 'make -n install' first).
 
 6. Edit and install the control files:
-       cp UUAIDS/L.cmds /usr/lib/uucp/L.cmds
-       Make needed changes to it.  Make sure it has all the commands you want.
-       Edit if necessary L.sys, L-devices, L-dialcodes.  The format for
-       dialers is slightly different so that any dialer can be handled.
-       Install these L* files in /usr/lib/uucp.  See samples in UUAIDS.
+       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)
 
 7. Make new subdirectories:
        For safety:  cd /usr/spool/uucp; tar c .   (save Qed files on tape)
@@ -155,24 +204,9 @@ Some steps will vary slightly from system to system.
        uu.weekly               Renames SYSLOG to SYSLOG.old.
        The above scripts should be run via cron.
 
        uu.weekly               Renames SYSLOG to SYSLOG.old.
        The above scripts should be run via cron.
 
-       uuq
-               Reports number of command ('C.') files queued for each system,
-               number of remote executions ('XQT') pending,
-               and with what systems uucico is currently conversing.
-               (It would also be handy to know the status of each site
-               such as 'decvax: last connection 03:00 Fri Jan 20' and
-               failures such as 'harpo: no answer 07:00 Fri Jan 20'.
-               It would also be handy to have a manual page for this thing.)
-
-       uuusage, uuusage.1, uutbl
-               Summarizes SYSLOG.  Very handy.  (Alan S. Watt).
-               Works best if you use uucp.daily.  Slow if SYSLOG is big.
-
-       uurate
-               More detailed summary of SYSLOG.  Useful for checking
-               throughput.  Modified from program provided by ittvax!swatt.
-               Slow if SYSLOG is big.
-
+       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
        uucp.daily
                Daily shell script run at ittvax.  Manages SYSLOG files in
                a convenient form for uuusage.  Not integrated in time