[[ This document is based on automatic translation from Japanese. ]]
[[ Any correction on English expressions are welcome. ]]

	WIDE Sendmail.cf Generation Package Version 3.7
								Jun. 15,1998
							   Motonori Nakamura
								WIDE Project
							 motonori@wide.ad.jp

<< About this package >>

This package is consist of a tool to make sendmail.cf and sample files
made by the tool.  The tool can generate both type of sendmail.cf
for sendmail.mx and sendmail.nomx. The tool can generate sendmail.cf
for sendmail 5.xx or sendmail 8.x.

If your sendmail is special featured version offered by vender
for vender's OS, some option character etc. used by newer version
of original sendmail might be used in another meaning in the vender's
sendmail. Please be careful if you are planning to use vender's
sendmail with sendmail.cf generated by the tool. This tool is only
for original versions.

This tool is consist of many "sh" scripts and "perl" scripts generated
automatically.  Therefore, the compilation is not required.

There is no limitation in distribution and no change of this package. 
Please describe clearly so when you distribute changed what. Moreover,
it is assumed the one according to the condition described to it
concerning the distribution of sendmail.cf made from this package. The
author does not assume any responsibilities of damage that the content
of this package is generated from incompleteness etc.  Please report
the comment concerning this package etc. to the author.

<< Version of sendmail.cf >>

The concept of the version entered sendmail.cf from sendmail 8.x. This
is 8 leaving compatibility with past sendmail 5.x . It is
consideration to use the new function introduced from x. In 8.x, past
cf for 5.x is located to Version 1. The cf can be used as it is almost
unquestionable. It is necessary to use cf of Version of corresponding
to use all new functions introduced from 8.x.

sendmail release 5.x : Version 1 (V1)
sendmail release 8.6 : Version 5 (V5)
sendmail release 8.7 : Version 6 (V6)
sendmail release 8.8 : Version 7 (V7)
sendmail release 8.9 : Version 8 (V8)

Of course, sendmail.cf of Version 5 can be used also with sendmail
8.8. In this package, Each cf of V1, V5, V6, V7 and V8 can be
made. However, please note that sendmail.cf of new Version cannot be
used in sendmail of old Release though it is natural.

V1 V5 V6 V7 V8 shows the version of sendmail.cf. R5 (i.e. sendmail 5.xx)
and R8 (i.e. sendmail 8.x.x) shows the release version of sendmail. R5
sendmail might be uncommonly written as V5. R8 sendmail might be
uncommonly written as V8. Please do not confuse and note the version
of sendmail.cf and the version of sendmail enough.

<< Sendmail 5.xx  which supports multi token class >>

The support of the multi token class means the domain names connected
by '.' like wxyz.ac.jp can be described in the class definition of
sendmail.cf. It is likely to be expanded so that attached sendmail may
also support the multi token class to sendmail 5.67+1.6W and SunOS
4.1.X and NewsOS 4.2.1, etc. though original sendmail 5.xx does not
support the multi token class. It can be confirmed whether sendmail on
hand supports the multi token class by using CheckMTC.cf in the doc
directory. The confirmation method is written in the first part of
CheckMTC.cf.

<< Security hole of sendmail >>

Some the security holes where can it be possible to see, and execute
the program by the person who does not have the account though it is a
file to old sendmail including sendmail 5.xx without the seen power
are reported. You are recommended to replace sendmail with the latest
version on hosts which is connected with the internet and easily
accessed from the internet. Moreover, because the version up of
sendmail is served according to the vender, it might be also good to
take the confirmation in the vender.

<< Use of package >>

1.  The command name of perl is set in the PERL variable of Makefile.
If you are using names other than perl like perl4 and perl5, etc.,
the value of the PERL variable does not need to be changed. In the
environment by which this package is executed, perl should be able to
be found in the command search path, please. Perl is automatically
retrieved.

2.  When make cleantools and make tools are sequentially executed, the
tool for the sendmail.cf making prepared in Tools directory is
restructured according to the environment. The perl command of the
cast path when make is executed set in the PERL variable is retrieved,
and it is used for the start of the script. Please operate
restructuring when the fault actually different from the one of the
script, that is, the path in Tools where perl exists.

3. Standard definition def file is made. 

% make samples

The following def files are made by this operation. 

	sendmail-v8.def General for sendmail 8.9.x
	sendmail-v7.def General for sendmail 8.8.x
	sendmail-v6.def General for sendmail 8.7.x
	sendmail-v5.def General for sendmail 8.6.x
	sendmail-v1.def General for sendmail 5.x+1.6W
	nmtc.def	General for original sendmail 5.x
	null-v8.def	Null client for sendmail 8.9.x
	null-v7.def	Null client for sendmail 8.8.x
	null-v6.def	Null client for sendmail 8.7.x
	null-v5.def	Null client for sendmail 8.6.x
	null-v1.def	Null client for sendmail 5.x
	(Null client is used to send all mail to a specific host)

In the distribution package, since the made .cf file is appended,
this operation is not necessary with standard definition .def file
as long as make clean was not done.

4.  Copy one of *.def to the file of a suitable name such as
sendmail.def, and necessary settings should be described.

% cp Standards/sendmail-v8.def sendmail.def
% vi sendmail.def
:

Please refer to doc/INTRO at least common in a lot of hosts for
setting times and refer to doc/MANUAL for the explanation of setting
in detail. It is shown that the sign named V1/V5 which appears to
the comment filing def is the one to show the version of sendmail.cf
to which this document is written first, and setting with sendmail.cf
which can be used respectively with sendmail of R5/R8.

4. When setting is completed,  generate your sendmail.cf.

% make sendmail.cf

The name of ${BASE}.cf is specified for an argument of make,
${BASE}.cf will be made from ${BASE}.def.

5. Sendmail.cf is installed in the system directory. 

Note the permission of the file and the directory so as not to become
a security hole when you install sendmail.cf. When make all is
executed, sendmail-v8.cf Sendmail-v7.cf etc. are made. A general host
who should not do a special setting at all can use these as they are.

It might be more convenient to use Makefile in the "Samples" directory
when you are working in another directory. It is also convenient
because the Makefile has depend rules that shows which .cf file is
generated from which .def file. Type "make depend" to reconstruct
depend rules in your working directory.

<< Null sendmail.cf >>

Sample definition file, sendmail-v?.def, required to set various
functions in this package is prepared. But Null-v?.def does not.
Null-v?.def is for hosts which does not have a mail spool, and
make easy sendmail.cf which achieves a function only sending to
a host which has mail spool. Be sure to specify a host which has
a ail spool to SPOOL_HOST when null-v?.def is used.

<< Debugging of this package >>

When the operation is confusing, debugging output file DEBUG.* can be
created by setting either filter, sample, config, or all or the plural
delimiting with colon(:)s in the CF_DEBUG environment variable.

 filter: Debugging information on making Tools/*
 sample: Debugging information on making such as samples.def
 config: Debugging information on making *.cf
    all: Debugging information all above-mentioned

<< Acknowledgments >>

This package is made thanks to Kyoto University, Ritsumeikan University,
the TDI Co., Ltd., and the cooperation of other people. We wish to
express our gratitude here.
