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

		<< Guidance of easy definition file setting >>
							Ver 1.6/Oct. 2,1996

This document shows the minimum configuration items which should be
considered whenever a basic configuration of a .def file is done.
Please refer to MANUAL for detail. 

1) Declaration of type of generated sendmail.cf

CF_TYPE ='Type of sendmail.cf'

Types are: R8V8 R8V7 R8V6 R8 R5 R5-mtc R8V8-null R8V7-null R8V6-null
	   R8-null R5-null. 

    R8V8: R8 sendmail V8 config setting (for sendmail 8.9)
    R8V7: R8 sendmail V7 config setting (for sendmail 8.8)
    R8V6: R8 sendmail V6 config setting (for sendmail 8.7)
    R8: R8 sendmail V5 config setting (for sendmail 8.6)
    R5: Setting for R5 sendmail (There is no multi token class expansion). 
    R5-mtc: Setting for R5 sendmail which expands multi token class
	Example of sendmail to which expansion is done:
	    WIDE version sendmail which 1.6W patch applied
	    IDA version sendmail
	    (sendmail of SunOS 4.1.3)
	    (sendmail of NEWS OS 4.2.1)
    R8V8-null: Setting for single host forwarding of R8 sendmail V8 config
    R8V7-null: Setting for single host forwarding of R8 sendmail V7 config
    R8V6-null: Setting for single host forwarding of R8 sendmail V6 config
    R8-null: Setting for single host forwarding of R8 sendmail V5 config
    R5-null: Setting for single host forwarding of R5 sendmail
    R8V8-check: Additional rulesetes for delivery restriction by V8 config
    R8V7-check: Additional rulesetes for delivery restriction by V7 config
	sendmail.cf generated by *-check can be appended to old style
	sendmail.cf which does not have check_* rulesets.

2) Setting of cf making information

DEF_ID ='Version'

The character string specified for "Version" is treated as a comment in
generated sendmail.cf.

VERSION_SEPARATOR='-'
LOCAL_VERSION ='Local version'

The version identifier defined here will appear in the greeting message
and the Received header in received messages by sendmail.

3) Setting of OS

OS_TYPE=<kind of OS>

Specify name of the files which exist in Master/OSTYPE directory
for a kind of operating system. 

4) Setting of host's official address (FQDN)

OFFICIAL_NAME='hemp.imel.kyoto-u.ac.jp'	(Only at the time of R8*)
MY_NAME='hemp.imel.kyoto-u.ac.jp'	(Only at the time of R5)

Sendmail send a quiry of his host name (defined by 'hostname' command)
to a name server to obtain FQDN for the host. If a full name of the host
can not be obtained, there is a possibility of mail delivery failures.
In many cases, this situation will occur when the nameserver is not
running at start time of sendmail. To aboid this problem, it is prefered
that the above-mentioned variable be defined. (With sendmail 8.7, sendmail
of daemon mode will not be started when query to the nameserver fails.)
When sendmail.5.X is used, MY_NAME is defined instead of OFFICIAL_NAME.

5) Setting of host's alias

MY_ALIAS='isles1 isles1.isle.kuis.kyoto-u.ac.jp islegw.kuis.kyoto-u.ac.jp'

The host's various aliases should be defined. If these names appear in
domain part of recipients' mail addresses of a message, the message
will be recognized to be delivered to local mailbox. Please note
that these all names are rewritten to the official name when handled
by the sendmail.

6) Setting of domain name

MY_DOMAIN='isle.kuis.kyoto-u.ac.jp'

The domain name that the host belongs is specified. If this is not
defined, it will be taken from the official hostname; domain name
is a copy of the official hostname without the first host name part.

7) Setting of From address

FROM_ADDRESS='$m'
FROM_ADDRESS='kuis.kyoto-u.ac.jp'

The domain part of mail addresses which should be appended to senders
address when sender's address is not qualified.  If you want to use
the same one as MY_DOMAIN, $m can be specified.

8) Setting concerning address which should be supplemented user
described in To and Cc

RECIPIENT_GENERIC=yes
RECIPIENT_GENERIC=no

Select how to supply domain part to addresses without domain part
in To/Cc fields.  If "yes", the address specified with FROM_ADDRESS
is used. If "no", the official address is used.

9) Another specification of MX sendmail/NOMX sendmail

MX_SENDMAIL=yes
MX_SENDMAIL=no

Specify "yes" when sendmail.mx is used and specify "no" when
sendmail.nomx is used. Sendmail.mx indicates sendmail compiled with
NAMED_BIND=1, and sendmail.nomx indicates sendmail compiled with
NAMED_BIND=0. Please specify -d0.4 to obtain compile-time options
of your sendmail when you are using sendmail 8.7 or later.
If NAMED_BIND is included in a item, your sendmail might be compiled
with NAMED_BIND=1.

10) Specification of address which should be received other than host's alias

ACCEPT_ADDRS='old-machine.kyoto-u.ac.jp'

It is meant to recognize that "Receive" is addressed to the user of
the host. Mail to the address specified for here is received by the
host. For instance, the address leaves as it is though a host associated
with the address is gone, and to make mail received by another host.
To receive mail to user@domain.name (generic address) by the domain
master etc.  ACCEPT_ADDRS is different from definition MY_ALIAS of the
alias of the above-mentioned host, and the header of the received mail
is not rewritten.

(attention) To order mail to MY_DOMAIN to be received when R8 sendmail
is used, $m can be specified for ACCEPT_ADDRS. However, the macro
character cannot be used for ACCEPT_ADDRS with R5 sendmail. It is
necessary to describe an actual domain name. (When the macro character
is not used and MY_DOMAIN is defined, ACCEPT_ADDRS=$MY_DOMAIN is
acceptable)

11) Setting for host who does not have spool

SPOOL_HOST='loafer.kutsuda.kuis.kyoto-u.ac.jp'.

Mail is forwarded to the host specified here without writing mail in
the spool of the mail of the host.

12) Delivery definition of mail to BITNET

BITNET=mx

Direct delivery by MX reference which Japanese BITNET society recommends

BITNET=static
BITNET_RELAY ='relay.host'

Mail is relaid to the specified host.

BITNET=no

The BITNET address is not interpreted. When DEFAULT_RELAY (following
description) is defined, mail is forwarded to the host. Maybe, an
error when DEFAULT_RELAY is not used.

13) Setting of directly/indirect delivery

DIRECT_DELIVER_DOMAINS=all

All mail is delivered directly referring to MX. 

DIRECT_DELIVER_DOMAINS='.jp'
DEFAULT_RELAY='relay.host'

Mail to user@*.jp is delivered directly referring to MX. 
Other mail is forwarded to relay.host. 

DIRECT_DELIVER_DOMAINS=none
DEFAULT_RELAY='relay.host'

All mail is forwarded to relay.host. When MX sendmail is not used,
none will be specified. When STATIC_ROUTE_FILE (Refer to MANUAL.jpn)
is defined, and a static delivery route is specified, mail is
delivered directly referring to MX after the interpretation and
delivered to DEFAULT_RELAY indirectly.

14) Selection of sending person of error mail (Only for R8 *)

SMTP_MAILER_FLAG_ADD='g'
RELAY_MAILER_FLAG_ADD='g'

The address of the sending person of the error mail is <> in R8
sendmail in default (empty address) is used (see RFC1123). g is added
to the mailer flag in the remark situation assumed to be mail from
MAILER-DAEMON of the host where the error occurs as well as R5
sendmail.

15) Interpretation of Errors-To: header (Only for R8*)

USE_ERRORS_TO='True'

In R8 sendmail,  it is default and Errors-To:Header is not interpreted. 
To interpret Errors-To,  USE_ERRORS_TO is made True. 

16) Notification of delivery error to post master

COPY_ERRORS_TO ='Postmaster'

Define this to send the header of original mail which is the
occurrence of the error to postmaster too.  You can change to the user
names other than postmaster.

(attention)
When the error occurs further when the error notification mail is sent,  the error notification mail is sent to postmaster without any relation to the user name specified for here. 

17) Period preserved in mqueue

MSG_TIMEOUT='5d'

preserves for five days. 

MSG_TIMEOUT='5d/4h' (It is possible to specify only for R8)

The undelivery notification is sent to mail which passes four hours
preserved for five days.

TIMEOUT_QUEUERETURN ='5d' (For R8V?)
TIMEOUT_QUEUEWARN ='4h'

The undelivery notification is sent to mail which passes four hours
preserved for five days.

18) The reference to A record (Only for R8*) by primary MX host. 

TRY_NULL_MX_LIST='True'

Though mail has been sent to the host whom 1st MX record orders To
deliver mail referring to not the MX record but A record when the host
is not mail which should be received.  The operation cannot be changed
by setting with R5 by taking this operation for an address concerned
when the MX record is only nothing but one.

In addition, please refer to MANUAL.jpn according to the following
indices to do an advanced setting.

* The plural . I want to bring a common definition in the def file
together in one file. 
	=> [default]
* I send off the address named user@host.my.domain.name sent by hosts
other than GW and after the host name is extinguished with GW like
user@my.domain.name, want to send off mail. 
	=> [address]
* Only when a part of user sends mail, I want to change the address of
From.
	=> [specialfrom]
* wants to supplement the mail address referring to the name
server.
	=> [canon]
* I want to make rewriting the mail address based on a static rule.
	=> [alias]

* I want to receive all mail in the sub-domain to the host by the
domain master.
	=> [acceptaddr], [deliver]

* want to forward only mail to specific user to a certain host without
using aliases want to drop local spool on To: user@myhost, and send to
the domain master for To: user.
	=> [hub]

* I want to forward to the spool of other hosts without dropping mail
to the host to the host's spool directory concerning a specific user.
	=> [spool]
* Mastered the domain setting is done to the host who is turning 2nd
MX. (In a word, the description of the aliases file is made equal to
the domain master of primary) Even when the domain master of primary
stops, I want to transmit mail directly to the host who has the mail
spool of each user.
	=> [secondary]
* wants to define the alias of the host name, and rewrite the address.
	=> [alias] [domaintable] (the latter is only for R8*)
* /to make understanding address not forwarded to host in the upstream
when failing in delivery When it was not possible to deliver, generate
special error.
	=> [one-token] [junet] [redirect] [error]
* I want to refuse the mail which has been sent in the address like
user%somehost@myhost.
	=> [nosourceroute]
* When mail is written in the spool, I want to convert Kanji character
code.
	=> [kanji]
* wants you to make @ address applied when delivering among the same
hosts.
	=> [mailer]
* I want to define an external mailer.
	=> [external]
* It be possible be to receive mail to a specific domain by way of
POP.
	=> [pop-feed]
* I want to change setting the delivery of mail to BITNET.
	=> [bitnet]
* The UUCP connection is set.
	=> [uucp]
* I want to use another mail address for a specific district.
	=> [another_addr]
* I want to use the function of mail > news gateway.
	=> [netnews]
(Of course, there is a method of the definition in aliases without
using this, too)
* Adjustment concerning delivery of mail with address like user@
12.34.56.78
	=> [numeric]
* I want to define a static delivery route.
	=> [deliver] [mailertable] (Only R8 * the latter)
* I want to specify the host who is not adjacent for a relay host.
	=> [route]
* I want to do the delivery by which (*S) refers to hosts of NIS.
	=> nis.hosts
* I want to forward to the sending host for the external without
delivering mail by which refers to MX directly once.
	=> [indirect]
* I want to do the processing forwarded to a different host to two or
more address user@ address1 and user@ address2 by one host. (Only R8*)
	=> [usertable]

* The addition of Trusted Users (Only R5). / Switch of comment form of
From (user (Full Name) or Full Name <user>) Specification of empty
capacity of spool to start refusal of reception of/mail Specification
at preservation period with mqueue of/mail Average loading by stop of
transmission/reception of/mail specification / . I want to make
forward put on not each user's home directory but another place. I
want to generate the error message of the MIME multipart form. / I
want to prevent mail being sent to the sending person even if the
sending person is included in that when aliases is developed. / I want
to change the time zone character string. (JST should not be used. :
RFCxxxx) / I want to set userdatabase (Only R8*). / I want to set fall
back MX.  (MX host of default which should be sent when mail cannot be
sent to any of MX host who retrieved from name server)
	=> [option]
* There might be a client which cannot send mail because there are
two-line ESMTP greeting message.
	=> [brokensmp] (Only R8+2.4W)
 When pure R8 is compiled,  -DBROKENSMTPPEERS is specified. 
* When IDENT protocol is used, mail might be not able to be received
from a specific organization.
	=> [option] [ident] (the latter is only R8+2.4W)
* I want to make a special setting for a moment. 
	=> [localhack]
* I want to configure sendmail.cf with delivery restrictions
	=> [smtpcheck]
* I want to do the delivery limitation. 
	=> Appendix A
