![[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 [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104|
Return to README CVS log | Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104 |
1.1 root 1: This is the README file for version 1.04 of the Taylor UUCP package.
2:
3: It was written by Ian Lance Taylor. I can be reached at [email protected],
4: or, equivalently, uunet!cygint!airs!ian, or c/o Cygnus Support, 4th
5: Floor, Building 200, 1 Kendall Square, Cambridge MA, 02139, USA.
6:
7: There is a mailing list for discussion of the package. To join (or
8: get off) the list, send mail to [email protected].
9: Mail to this address is answered by a person, not a program. When
10: joining the list, make sure you include the address at which you want
11: to receive mail in the body of your message. To send a message to the
12: list, send it to [email protected].
13:
14: This package is covered by the Gnu Public License. See the file
15: COPYING for details. If you would like to do something with this
16: package that you feel is reasonable but you feel is prohibited by the
17: license, contact me to see if we can work it out.
18:
19: WHAT IT IS
20:
21: This is the complete source code for a Unix UUCP package. It provides
22: everything you need to make a UUCP connection. It includes versions
23: of uucico, uusched, uuxqt, uux, uucp, uustat, uulog, uuname, uuto,
24: uupick, and cu, as well as uuchk (a program to check configuration
25: files), uuconv (a program to convert from one type of configuration
26: file to another) and tstuu (a test harness for the package).
27:
28: The Free Software Foundation plans to make this their standard UUCP
29: package.
30:
31: The package currently supports the 'f', 'g' (in all window and packet
32: sizes), 'G', 't' and 'e' protocols, as well a Zmodem protocol and two
33: new bidirectional protocols. If you have a Berkeley sockets library,
34: it can make TCP connections. If you have TLI libraries, it can make
35: TLI connections. It supports a new configuration file mechanism which
36: I like (but other people dislike).
37:
38: The package has a few advantages over regular UUCP:
39:
40: You get the source code.
41:
42: It uses significantly less CPU time than many UUCP packages.
43:
44: You can specify a chat script to run when a system calls in,
45: allowing adjustment of modem parameters on a per system basis.
46:
47: You can specify failure strings for chat scripts, allowing the
48: chat script to fail immediately if the modem returns ``BUSY''.
49:
50: If you are talking to another instance of the package, you can use
51: the new bidirectional protocol for rapid data transfer in both
52: directions at once. You can also restrict file transfers by size
53: based on the time of day and who placed the call.
54:
55: On the other hand:
56:
57: It only runs on Unix. The code is carefully divided into system
58: dependent and system independent portions, so it should be
59: possible to port it to other systems. It would not be trivial.
60:
61: You don't get uuclean, uusend, uuq, uusnap, uumonitor, uutry,
62: uupoll, etc. If you have current copies of these programs, you
63: may be able to use them. Shell scripts versions of uuclean and
64: uutry are provided, with most, if not all, of the functionality of
65: the usual programs. I believe the supplied uustat program allows
66: you to do everything that uuq, uusnap and uumonitor do. uupoll
67: could be written as a shell script.
68:
69: The package does not read modemcap or acucap files, although you
70: can use V2 configuration files with a BNU Dialers file or a dialer
71: file written in my new configuration file format.
72:
73: The package cannot use SCO dialer programs directly, although it
74: can with a simple shell script interface.
75:
76: If you start using this package, I suggest that you join the mailing
77: list (see above) to keep up to date on patches and new versions. I am
78: also open to suggestions for improvements and modifications.
79:
80: CHANGES SINCE 1.03
81:
82: For a complete list, see ChangeLog.
83:
84: IMPORTANT: the default when talking to another version of 1.04 is to
85: use the new bidirectional 'i' protocol. If you are using a
86: half-duplex modem, such as a Telebit T2500, you will want to either
87: mark the port as half-duplex with the ``half-duplex'' command, or
88: force use of the 'g' protocol by using the ``protocol'' command in the
89: sys or port file or by adding ``,g'' after the port name in the
90: Systems or L.sys or Devices file.
91:
92: As usual, many bugs were fixed.
93:
94: Bidirectional transfers are supported with the new 'i' protocol;
95: it requires an eight-bit clear datapath.
96:
97: New programs: uusched, cu, uuto and uupick.
98:
99: The 'G' protocol and a new Zmodem protocol were added.
100:
101: A number of uustat options were added to support uuclean, and a
102: sample uuclean shell script was added to the contrib directory.
103: The uustat output formats were changed slightly.
104:
105: A protocol extension eliminates transfer of the command file for
106: simple commands, such as rmail or rnews, when talking to another
107: version of 1.04.
108:
109: Some TLI support was added.
110:
111: UUCP forwarding was added, along with the ``forward-to'',
112: ``forward-from'' and ``forward'' commands.
113:
114: If a file transfer fails in the middle, the retry will now start
115: from where it left off. The implementation is compatible with
116: SVR4.
117:
118: The work queue is checked every 10 minutes during a conversation;
119: if there is new work and a bidirectional protocol is not in use,
120: the receiving uucico requests the sender to transfer control.
121:
122: The amount of free disk space is checked periodically as a file is
123: received, and if it drops too low the call is aborted.
124:
125: The UUCP configuration file reading routines were moved into a
126: standalone library, uuconf. All known bugs in V2 and HDB
127: configuration file reading were fixed.
128:
129: The ``half-duplex'' command was added for the port and dialer
130: files.
131:
132: The ``max-retries'', ``success-wait'', ``send-request'' and
133: ``receive-request'' commands were added for the sys file. The
134: ``call-request'' and ``called-request'' commands were eliminated
135: (they did not work correctly anyhow).
136:
137: \d in chat scripts now calls sleep (2) rather than sleep (1), so
138: it will sleep longer (on some systems sleep(1) may delay much less
139: than one second).
140:
141: SPOOLDIR_SVR4 was added for SVR4 style spool directories.
142:
143: Defaults are now permitted in the port and dialer files.
144:
145: The ALIAS field is supported in the HDB Permissions file.
146:
147: DOCUMENTATION
148:
149: The documentation is in the file uucp.texi, which is a Texinfo file.
150: Texinfo is a format used by the Free Software Foundation. You can
151: print the documentation using TeX in combination with the file
152: texinfo.tex. DVI, PostScript and info versions of the documentation
153: are available in a separate package, uucp-doc-1.04.tar.Z.
154:
155: See the TODO file for things which should be done. Please feel free
156: to do them, although you may want to check with me first. Send me
157: suggestions for new things to do.
158:
159: The compilation instructions are in uucp.texi. Here is a summary.
160:
161: Edit Makefile.in to set installation directories.
162:
163: Type ``sh configure''. You can pass a number of arguments in the
164: environment (using bash or sh, enter something like ``CC=gcc
165: configure''; using csh, enter something like ``setenv CC gcc; sh
166: configure''):
167: CC: C compiler to use; default is gcc if it exists, else cc
168: CFLAGS: Flags to pass to $CC when compiling; default -g
169: LDFLAGS: Flags to pass to $CC when only linking; default none
170: LIBS: Library arguments to pass to $CC; default none
171: INSTALL: Install program; default install -c or cp
172: INSTALLDATA: Install data; default install -c -m 0644 or cp
173: The configure script will compile a number of test programs to see
174: what is available on your system, so if your system is at all
175: unusual you will need to pass in $CC and $LIBS correctly.
176:
177: The configure script will create conf.h from conf.h.in and
178: Makefile from Makefile.in. It will also create config.status,
179: which is a shell script which actually creates the files. Please
180: report any configuration problems, so that they can be fixed in
181: later versions.
182:
183: Igor V. Semenyuk provided this (lightly edited) note about ISC
184: Unix 3.0. The configure script will default to passing -posix to
185: gcc. However, using -posix changes the environment to POSIX, and
186: on ISC 3.0, at least, the default for POSIX_NO_TRUNC is 1. This
187: means nothing for uucp, but can lead to a problem when uuxqt
188: executes rmail. IDA sendmail has dbm configuration files named
189: mailertable.{dir,pag}. Notice these names are 15 characters long.
190: When uuxqt compiled with -posix executes rmail, which in turn
191: executes sendmail, the later is run under POSIX environment too!
192: This leads to sendmail bombing out with 'error opening 'M'
193: database: name too long' (mailertable.dir). It's rather obscure
194: behaviour, and it took me a day to find out the cause. I don't
195: use -posix, instead I run gcc with -D_POSIX_SOURCE, and add
196: -lcposix to LIBS.
197:
198: Examine conf.h and Makefile to make sure they're right.
199:
200: Edit policy.h for your local system.
201:
202: Type ``make''.
203:
204: Use ``uuchk'' to check configuration files. You can use
205: ``uuconv'' to convert between configuration file formats.
206:
207: Type ``make install'' to install.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.