![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to README CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / usr.bin / uucp|
Return to README CVS log | Up to [CSRG BSD Unix] / 43BSD / usr.bin / uucp |
1.1 root 1: INSTALLATION GUIDE
2: README 5.6 85/06/24
3:
4: This version is based on the "rti uucp" that was on the 4.2BSD tape.
5: It contains many additional features and fixes from Usenet,
6: Tom Truscott, Guy Harris, Lou Salkind, and many others.
7:
8: A few new subdirectories have been added. Do a "make mkdirs" to make
9: sure that you have all of them.
10:
11: I recommend that you change the uucp mail handler in your sendmail.cf
12: to something like:
13:
14: # Muucp, P=/usr/bin/uux, F=sDFMhuU, S=13, R=23, M=100000,
15: # A=uux - -r $h!rmail ($u)
16: Muucp, P=/usr/bin/uux, F=sDFMmhuU, S=13, R=23, M=100000,
17: A=uux - -r -z -a$g -gC $h!rmail ($u)
18:
19: The -a$g provides a return address in case mail fails (So It
20: won't go to yourmachine!uucp anymore.) The -gC specifies a grade
21: for mail. C is a good choice for mail. News should run at 'd'. This
22: way, mail gets sent before news. The 'm' flag specifies that this
23: mail can send to multiple addresses, which uux can.
24:
25: The man pages now describe all the options for the various commands.
26: Make sure you read them. A list of the functional differences is in "Changes".
27:
28: You should also look through the UUAIDS directory. There are some useful
29: programs and hints therein.
30:
31: The maximum length of a site name has been changed from the old 7 to the
32: 14. This is the be compatible with the HoneyDanBer uucp (aka BNU 1) which
33: is as close to a standard uucp as there is. Sites which have sitenames
34: longer than 7 characters that only send you the first 7 characters are
35: broken and should be fixed. However, there is a way of compensating for
36: this until they fix their problem. For each site you talk to that has a
37: name longer that 7 characters, put a line in /usr/lib/uucp/L.aliases of
38: the form:
39: fullname name-truncated-to-7-characters.
40: E.g:
41: tektronix tektron
42: lbl-csam lbl-csa
43: rochester rochest
44: ut-sally ut-sall
45: (See UUAIDS/L.aliases for more details on aliasing uucp names.) If the site
46: name is <= 7 characters, you don't have to do anything.
47:
48:
49: Rick Adams
50: [email protected]
51: June 19, 1985
52:
53: Tom Truscott, rti!trt,decvax!duke!trt (919)541-6488 Research Triangle Institute
54: Bob Gray, gray@berkeley, duke!adiron!bob (315) 336-4989
55:
56: This is a variant of the uucp used at decvax, ittvax, rti, mcnc, adiron,
57: duke and others. There have been tons of bug fixes and enhancements
58: from people on the usenet (thank you). Speed is substantially
59: improved. This version fixes essentially all of the McGeady's bug list.
60:
61: Enhancements:
62:
63: Dialers Lots of dialers included.
64:
65: Subdirectories /usr/spool/uucp is now split into 7 subdirectories.
66: This is a huge help on busy systems.
67:
68: /usr/lib/uucp/L.cmds List of commands permitted for remote execution.
69: A line of form 'PATH=...' sets the search path.
70:
71: expect-send sequence Escape characters now permitted: \r, \n.
72: \r, not \n, is default char sent at end of string.
73: \c (put at end of string). Dont send ending \r.
74: \d pause 1 second (\d\d pauses 2 seconds)
75: "" P_ZERO `expect nothing, start sending zero parity.'
76: P_EVEN (default), P_ODD, P_ONE other parity modes.
77: \05 Send a control-E
78: "" "" `expect nothing, send a \r'.
79:
80: uupoll [sysname] Polls named system.
81: uusnap Displays spooled files, and pending uuxqts.
82:
83:
84: This version runs on all VAXen and PDPs under UNIX-V7 and 4.1bsd, 4.2BSD.
85: It also runs on Gould/SEL Concept series machines (e.g. 32/8750),
86: DUAL 68000 unisoft.
87: It also runns on BTL system III, IV, and V.
88:
89: UUCP installers should read the two papers (by Dave Nowitz)
90: in Vol 2B of version 7 manuals and UUAIDS/setup.tblms.
91: Understand each step below before executing.
92: Some steps will vary slightly from system to system.
93:
94: **** INSTALLATION *******
95:
96: 1. If you are currently running uucp, save the old programs!:
97: su root
98: cd /usr/bin
99: for i in uucp uux uulog uuname (csh: foreach i (uucp ....) )
100: do
101: cp $i $i.old
102: done (csh: end )
103: cd /usr/lib/uucp
104: for i in uucico uuxqt uuclean
105: do
106: cp $i $i.old
107: done
108:
109: 2. Editing Makefile and uucp.h
110: 4.2 sites using the supported dialers are all set with defaults.
111:
112: non-4.2
113: a) sites need to install the Berkeley directory reading library.
114: Try (cd libndir; make install).
115: Edit Makefile to have LIBNDIR= -lndir
116: define NDIR in uucp.h.
117: b) Check LDFLAGS, OWNER, GROUP, and LIBUUCICO.
118: c) pick a method to allow uucp to know its system:
119: Check out GETHOSTNAME/UNAME/WHOAMI/CCWHOAMI in uucp.h
120: d) define SYSIII if appropriate in uucp.h.
121: e) Your "make" may fail because the Makefile is so large.
122: If so, in /usr/src/cmds/make/defs, change
123: '#define NFLEFTS 60' to 512, and re-make make.
124:
125: 3. Make the new commands.
126: make
127:
128: 4. WAIT UNTIL THE UUCP SYSTEM IS IDLE!! Single-user is best.
129: su root (it is important that chmod, chown and chgrp work below)
130:
131: 5. Install the new commands:
132: make install
133: (If you are chicken, type 'make -n install' first).
134:
135: 6. Edit and install the control files:
136: Look in UUAIDS. Edit and install into /usr/lib/uucp if necessary
137: USERFILE, L.cmds, L.sys, L-devices, L-dialcodes.
138: THESE FILES MUST BE OWNED BY THE SAME OWNER AND GROUP AS
139: THE UUCP COMMANDS AND UUCP SPOOL FILES!!! (probably uucp, daemon).
140: The format for dialers is slightly different so that any dialer
141: can be handled.
142:
143: 7. Make new subdirectories:
144: For safety: cd /usr/spool/uucp; tar c . (save Qed files on tape)
145: The following assumes your site name is produced by `uuname -l`.
146: make mkdirs
147: If your system is duke, then the subdirectories created are
148: named C., D., D.duke, D.dukeX, TM., XTMP and X..
149: rmdir /usr/lib/uucp/.XQTDIR
150: which is obsolete (XTMP replaces it).
151:
152: 8. Move old Qed files:
153: If you have spooled files, they must be moved into the subdirectories.
154: Assuming all spool files are in /usr/spool/uucp
155: (i.e. you did not have subdirs before)
156: the following command will move the spool files
157: to the right subdirectories:
158: make mvspoolfiles; ??? does this work now??????????
159: Files beginning C. are put in the C. subdirectory, and so on.
160: Files begining D.dukeX are put in that directory, *not* D..
161: (Note: if you already had a subdirectory version of uucp,
162: you need only create the new subdirectories mentioned above
163: and move the relevant files there.
164: Delete other old directories if you had any (e.g. "LOG.")
165:
166: 9. Compact /usr/spool/uucp:
167: cd /usr/spool
168: mkdir nuucp
169: chown uucp nuucp
170: chgrp daemon nuucp
171: for i in uucp/* (csh: foreach i (uucp/*) )
172: do
173: mv $i nuucp
174: done (csh: end )
175: rmdir uucp
176: mv nuucp uucp
177: (Note: this does *not* work if a filesystem is mounted on
178: /usr/spool/uucp! If that is the case, you should 'tar'
179: /usr/spool/uucp somewhere, unmount, re-mkfs, and re-mount
180: the filesystem, and tar the uucp files back.)
181:
182: 10. Test the new system
183: Test by mailing a letter somewhere and back.
184: If it works, the new system is probably fine.
185: Otherwise, figure out what is wrong.
186: Start by examining LOGFILE. Try /usr/lib/uucp/uucico -r1 -sname -x7
187: If things are no-go, you can back out the changes by restoring the
188: old uu programs and the spooled files.
189: NOTE: The subdirectories foul up a non-subdir version,
190: so be sure that subdirectories exist/do not exist as appropriate.
191:
192:
193: 11. Install handy UUAIDS
194: Look in uuaids for handy other stuff. In particular, uu.* are
195: shell scripts that can be run via cron hourly, daily, and weekly
196: to keep uucp trim. L-devices, L-dialcodes, L.cmds, L.sys, USERFILE
197: are sample files. THEY MOST LIKELY NEED TO BE MODIFIED TO USE
198: THEM ON YOUR OWN SYSTEM!
199:
200: uu.hourly Makes sure sites are polled.
201: uu.daily Runs uuclean to clean up /usr/spool/uucp.
202: **IT HANDLES SUBDIRECTORIES!!
203: Renames LOGFILE to LOGFILE.old.
204: uu.weekly Renames SYSLOG to SYSLOG.old.
205: The above scripts should be run via cron.
206:
207: uucpsummary
208: Summarizes LOGFILE and SYSLOG. It's very helpful in telling
209: what is going on and who is calling who.
210: uucp.daily
211: Daily shell script run at ittvax. Manages SYSLOG files in
212: a convenient form for uuusage. Not integrated in time
213: for this distribution.
214:
215:
216: Comments, bug reports, *and improved code* are welcome.
217: Tom Truscott
218: Bob Gray
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.