Commit | Line | Data |
---|---|---|
0d08c5aa | 1 | /*- |
7b0ba33c | 2 | * @(#)READ_ME 8.13 (Berkeley) %G% |
7a641c36 KB |
3 | */ |
4 | ||
3b61c5e6 | 5 | SENDMAIL RELEASE 8 |
05176eeb | 6 | |
3b61c5e6 KB |
7 | This directory has the latest sendmail software from Berkeley. See |
8 | doc/op/op.me for a summary of changes since 5.67. | |
05176eeb | 9 | |
3b61c5e6 | 10 | Report any bugs to sendmail@CS.Berkeley.EDU. |
05176eeb | 11 | |
3b61c5e6 KB |
12 | The latest version of sendmail is kept on FTP.CS.Berkeley.EDU, directory |
13 | /ucb/sendmail; check there for the latest revision. | |
e22959f2 | 14 | |
2c7395f9 EA |
15 | |
16 | +--------------+ | |
17 | | MANUAL PAGES | | |
18 | +--------------+ | |
19 | ||
20 | The sendmail manual pages use contemporary Berkeley troff macros. If | |
21 | your system does not process these manual pages, you can pick up the | |
0be59012 EA |
22 | new macros in a BSD Net/2 FTP site (e.g. on FTP.UU.NET, the files |
23 | /systems/unix/bsd-sources/share/tmac/me/strip.sed and | |
24 | /systems/unix/bsd-sources/share/tmac/*). | |
2c7395f9 EA |
25 | |
26 | The strip.sed file is only used in installation. | |
27 | ||
28 | After installation, edit tmac.doc and tmac.andoc to reflect the | |
29 | installation path of the tmac files. Those files contain pointers to | |
30 | /usr/share/tmac/, and those pointers are not changed by the `make | |
31 | install` process. | |
32 | ||
33 | Rename the existing tmac.an to be tmac.an.old, and rename tmac.andoc | |
34 | to be tmac.an. | |
35 | ||
36 | tmac.an will choose between tmac.an.old, your old macros, or tmac.doc, | |
37 | which are the new macros, so that both the new man pages and the | |
38 | existing man pages will be translated properly. | |
39 | ||
873b1860 EA |
40 | I'm also told that the groff distribution from MIT has a tmac.doc |
41 | macro set that is compatible with these macros. | |
42 | ||
2c7395f9 | 43 | |
d5a68f3f EA |
44 | +-----------------------+ |
45 | | RELATED DOCUMENTATION | | |
46 | +-----------------------+ | |
47 | ||
48 | There are other files you should read. Rooted in this directory are: | |
49 | ||
50 | CHANGES-R5-R8 | |
51 | Describes changes between Release 5 and Release 8 of sendmail. | |
52 | There are some things that may behave somewhat differently. | |
53 | For example, the rules governing when :include: files will | |
54 | be read have been tightened up for security reasons. | |
55 | FAQ | |
56 | Answers to Frequently Asked Questions. | |
57 | KNOWNBUGS | |
58 | Known bugs in the current release. I try to keep this up | |
59 | to date -- get the latest version from FTP.CS.Berkeley.EDU | |
60 | in /ucb/sendmail/KNOWNBUGS. | |
61 | RELEASE_NOTES | |
62 | A detailed description of the changes in each version. This | |
63 | is quite long, but informative. | |
64 | src/READ_ME | |
65 | Details on compiling and installing sendmail. | |
66 | cf/README | |
67 | Details on configuring sendmail. | |
a85a9171 EA |
68 | doc/op/op.me |
69 | The sendmail Installation & Operations Guide. Be warned: if | |
70 | you are running this off on SunOS or some other system with an | |
71 | old version of -me, you need to add the following macro to the | |
72 | macros: | |
73 | ||
74 | .de sm | |
75 | \s-1\\$1\\s0\\$2 | |
76 | .. | |
77 | ||
78 | This sets a word in a smaller pointsize. | |
d5a68f3f EA |
79 | |
80 | ||
2c7395f9 EA |
81 | +--------------+ |
82 | | RELATED RFCS | | |
83 | +--------------+ | |
84 | ||
4321b2fe EA |
85 | There are several related RFCs that you may wish to read -- they are |
86 | available via anonymous FTP to several sites, including nic.ddn.mil | |
87 | (directory rfc), ftp.nisc.sri.com (rfc), nis.nsf.net (RFC), | |
88 | nisc.jvnc.net (rfc), venera.isi.edu (in-notes), and wuarchive.wustl.edu | |
89 | (info/rfc). They can also be retrieved via electronic mail by sending | |
90 | email to one of: | |
91 | ||
92 | mail-server@nisc.sri.com | |
93 | Put "send rfcNNN" in message body | |
94 | nis-info@nis.nsf.net | |
95 | Put "send RFCnnn.TXT-1" in message body | |
96 | sendrfc@jvnc.net | |
97 | Put "RFCnnn" as Subject: line | |
98 | ||
99 | Important RFCs for electronic mail are: | |
100 | ||
101 | RFC821 SMTP protocol | |
102 | RFC822 Mail header format | |
103 | RFC974 MX routing | |
104 | RFC976 UUCP mail format | |
105 | RFC1123 Host requirements (modifies 821, 822, and 974) | |
c979d06a | 106 | RFC1413 Identification server |
b4a37c16 EA |
107 | RFC1425 SMTP Service Extensions (ESMTP spec) |
108 | RFC1426 SMTP Service Extension for 8bit-MIMEtransport | |
109 | RFC1427 SMTP Service Extension for Message Size Declaration | |
110 | RFC1521 MIME: Multipurpose Internet Mail Extensions | |
1b409091 | 111 | RFC1344 Implications of MIME for Internet Mail Gateways |
b4a37c16 EA |
112 | RFC1428 Transation of Internet Mail from Just-Send-8 to |
113 | 8-bit SMTP/MIME | |
4321b2fe EA |
114 | |
115 | Other standards that may be of interest (but which are less directly | |
116 | relevant to sendmail) are: | |
117 | ||
4321b2fe EA |
118 | RFC987 Mapping between RFC822 and X.400 |
119 | RFC1049 Content-Type header field (extension to RFC822) | |
120 | ||
d7c407fe EA |
121 | Warning to AIX users: this version of sendmail does not implement |
122 | MB, MR, or MG DNS resource records, as defined as experiments in | |
123 | RFC883. | |
4321b2fe | 124 | |
2c7395f9 EA |
125 | |
126 | +-------------------+ | |
127 | | DATABASE ROUTINES | | |
128 | +-------------------+ | |
4321b2fe EA |
129 | |
130 | IF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE: **** DO NOT **** | |
131 | use the version that was on the Net2 tape -- it has a number of | |
132 | nefarious bugs that were bad enough when I got them; you shouldn't have | |
133 | to go through the same thing. Instead, get a new version via public | |
3b61c5e6 | 134 | FTP from ftp.CS.Berkeley.EDU, file ucb/4bsd/db.tar.Z. This software |
4321b2fe EA |
135 | is highly recommended; it gets rid of several stupid limits, it's much |
136 | faster, and the interface is nicer to animals and plants. You will | |
137 | also probably find that you have to add -I/where/you/put/db/include | |
138 | to the sendmail makefile to get db.h to work properly. | |
139 | ||
d7c407fe EA |
140 | Be sure you remove ndbm.h and ndbm.o from the db distribution. These |
141 | will cause problems with sendmail because sendmail already understands | |
142 | about NEWDB and NDBM coexisting. | |
143 | ||
2c7395f9 | 144 | |
bb68a93e | 145 | +--------------------+ |
7b0ba33c | 146 | | HOST NAME SERVICES | |
bb68a93e EA |
147 | +--------------------+ |
148 | ||
bb68a93e EA |
149 | If you are using NIS and /etc/hosts, it is critical that you |
150 | list the long (fully qualified) name first in the /etc/hosts file | |
151 | used to build the NIS database. For example, the line should read | |
152 | ||
153 | 128.32.149.68 mastodon.CS.Berkeley.EDU mastodon | |
154 | ||
155 | **** NOT **** | |
156 | ||
157 | 128.32.149.68 mastodon mastodon.CS.Berkeley.EDU | |
158 | ||
159 | If you use the wrong order, sendmail will conclude that your | |
160 | canonical name is the short version and use that in messages. | |
161 | The name "mastodon" doesn't mean much outside of Berkeley, | |
162 | and so this creates incorrect and unreplyable messages. | |
163 | ||
164 | ||
b032ca5b EA |
165 | +-------------+ |
166 | | USE WITH MH | | |
167 | +-------------+ | |
168 | ||
169 | This version of sendmail notices and reports certain kinds of SMTP | |
170 | protocol violations that were ignored by older versions. If you | |
171 | are running MH you may wish to install the patch in contrib/mh.patch | |
172 | that will prevent these warning reports. This patch also works | |
173 | with the old version of sendmail, so it's safe to go ahead and | |
174 | install it. | |
175 | ||
176 | ||
7b0ba33c EA |
177 | +----------------+ |
178 | | USE WITH IDENT | | |
179 | +----------------+ | |
180 | ||
181 | Sendmail 8 supports the IDENT protocol, as defined by RFC 1413. | |
182 | No ident server is included with this distribution. I have found | |
183 | copies available on: | |
184 | ||
185 | ftp.lysator.liu.se /pub/ident/servers | |
186 | romulus.ucs.uoknor.edu /networking/ident/servers | |
187 | ftp.cyf-kr.edu.pl /agh/uciagh/network/ident | |
188 | ||
189 | If you want to run an IDENT server, I suggest getting a copy from | |
190 | one of those sites. Versions are available for several different | |
191 | systems, including Apollo, BSD, NeXT, AIX, TOPS20, and VMS. | |
192 | ||
193 | ||
a85a9171 EA |
194 | +-----------+ |
195 | | MAKEFILES | | |
196 | +-----------+ | |
197 | ||
198 | The Makefiles in this release use the new Berkeley "make" that is | |
199 | available in BSD Net/2 and 4.4BSD. If you are using this version | |
200 | of make, you may notice one or two places where the Makefile includes | |
201 | "../../Makefile.inc". This file is not included with the sendmail | |
202 | distribution because it's not part of sendmail. However, it is, | |
203 | in toto: | |
204 | ||
205 | # @(#)Makefile.inc 8.1 (Berkeley) 6/6/93 | |
206 | ||
207 | BINDIR?= /usr/sbin | |
208 | ||
209 | The other directories should all have Makefile.dist files that work | |
d7c407fe EA |
210 | on the old make, albeit without all the niceties included. |
211 | ||
212 | You can also get a new Berkeley make from the Net2 release (available | |
213 | on many public FTP archives). This version should also interpret old | |
214 | Makefiles, so you could drop it in as your default make. | |
215 | ||
216 | For more details, see src/READ_ME. | |
a85a9171 EA |
217 | |
218 | ||
2c7395f9 EA |
219 | +---------------------+ |
220 | | DIRECTORY STRUCTURE | | |
221 | +---------------------+ | |
222 | ||
4321b2fe | 223 | The structure of this directory tree is: |
05176eeb EA |
224 | |
225 | cf Source for Berkeley configuration files. These are | |
226 | different than what you've seen before. They are a | |
227 | fairly dramatic rewrite, requiring the new sendmail | |
228 | (since they use new features). | |
c979d06a EA |
229 | contrib Some contributed tools to help with sendmail. THESE |
230 | ARE NOT SUPPORTED by Berkeley -- contact the original | |
3b61c5e6 KB |
231 | authors if you have problems. (This directory is not |
232 | on the 4.4BSD tape.) | |
05176eeb EA |
233 | doc Documentation. If you are getting source, read |
234 | op.me -- it's long, but worth it. | |
b4a37c16 EA |
235 | mail.local The source for the local delivery agent used for 4.4BSD. |
236 | THIS IS NOT PART OF SENDMAIL! and may not compile | |
237 | everywhere, since it depends on some 4.4-isms. Warning: | |
238 | it does mailbox locking differently than other systems. | |
05176eeb EA |
239 | mailstats Statistics printing program. It has the pathname of |
240 | sendmail.st compiled in, so if you've changed that, | |
241 | beware. This isn't all that useful. | |
242 | makemap A program that creates the keyed maps used by the $( ... $) | |
243 | construct in sendmail. It is primitive but effective. | |
244 | It takes a very simple input format, so you will probably | |
245 | expect to preprocess must human-convenient formats | |
246 | using sed scripts before this program will like them. | |
247 | But it should be functionally complete. | |
248 | praliases A program to print the DBM version of the aliases file. | |
249 | It hasn't been converted to understand the new Berkeley | |
250 | DB format (which we are using). | |
251 | rmail Source for rmail(8). This is used as a delivery | |
252 | agent for for UUCP, and could presumably be used by | |
2d13da1c | 253 | other non-socket oriented mailers. Older versions of |
a978890c EA |
254 | rmail are probably deficient. RMAIL IS NOT PART OF |
255 | SENDMAIL!!! The 4.4BSD source is included for you to | |
256 | look at or try to port to your system. I know it doesn't | |
257 | compile on {SunOS, HP-UX, OSF/1, other} (pick one). | |
b4a37c16 EA |
258 | smrsh The "sendmail restricted shell", which can be used as |
259 | a replacement for /bin/mail in the prog mailer to provide | |
260 | increased security control. NOT PART OF SENDMAIL! | |
0d08c5aa | 261 | src Source for the sendmail program itself. |
ac7b5dfd | 262 | test Some test scripts (currently only for compilation aids). |