readme

< linux网络编程工具>>配套源码

			messages to deliver in a single connection for the
			smtp, smtp8, esmtp, or dsmtp mailers.
SMTP_MAILER_ARGS	[TCP $h] The arguments passed to the smtp mailer.
			About the only reason you would want to change this
			would be to change the default port.
ESMTP_MAILER_ARGS	[TCP $h] The arguments passed to the esmtp mailer.
SMTP8_MAILER_ARGS	[TCP $h] The arguments passed to the smtp8 mailer.
DSMTP_MAILER_ARGS	[TCP $h] The arguments passed to the dsmtp mailer.
RELAY_MAILER_ARGS	[TCP $h] The arguments passed to the relay mailer.
RELAY_MAILER_MAXMSGS	[undefined] If defined, the maximum number of
			messages to deliver in a single connection for the
			relay mailer.
SMTP_MAILER_CHARSET	[undefined] If defined, messages containing 8-bit data
			that ARRIVE from an address that resolves to one of
			the SMTP mailers and which are converted to MIME will
			be labeled with this character set.
UUCP_MAILER_PATH	[/usr/bin/uux] The program used to send UUCP mail.
UUCP_MAILER_FLAGS	[undefined] Flags added to UUCP mailer.  Default
			flags are `DFMhuU' (and `m' for uucp-new mailer,
			minus `U' for uucp-dom mailer).
UUCP_MAILER_ARGS	[uux - -r -z -a$g -gC $h!rmail ($u)] The arguments
			passed to the UUCP mailer.
UUCP_MAILER_MAX		[100000] The maximum size message accepted for
			transmission by the UUCP mailers.
UUCP_MAILER_CHARSET	[undefined] If defined, messages containing 8-bit data
			that ARRIVE from an address that resolves to one of
			the UUCP mailers and which are converted to MIME will
			be labeled with this character set.
FAX_MAILER_PATH		[/usr/local/lib/fax/mailfax] The program used to
			submit FAX messages.
FAX_MAILER_ARGS		[mailfax $u $h $f] The arguments passed to the FAX
			mailer.
FAX_MAILER_MAX		[100000] The maximum size message accepted for
			transmission by FAX.
POP_MAILER_PATH		[/usr/lib/mh/spop] The pathname of the POP mailer.
POP_MAILER_FLAGS	[Penu] Flags added to POP mailer.  Flags lsDFMq
			are always added.
POP_MAILER_ARGS		[pop $u] The arguments passed to the POP mailer.
PROCMAIL_MAILER_PATH	[/usr/local/bin/procmail] The path to the procmail
			program.  This is also used by
			FEATURE(`local_procmail').
PROCMAIL_MAILER_FLAGS	[SPhnu9] Flags added to Procmail mailer.  Flags
			DFM are always set.  This is NOT used by
			FEATURE(`local_procmail'); tweak LOCAL_MAILER_FLAGS
			instead.
PROCMAIL_MAILER_ARGS	[procmail -Y -m $h $f $u] The arguments passed to
			the Procmail mailer.  This is NOT used by
			FEATURE(`local_procmail'); tweak LOCAL_MAILER_ARGS
			instead.
PROCMAIL_MAILER_MAX	[undefined] If set, the maximum size message that
			will be accepted by the procmail mailer.
MAIL11_MAILER_PATH	[/usr/etc/mail11] The path to the mail11 mailer.
MAIL11_MAILER_FLAGS	[nsFx] Flags for the mail11 mailer.
MAIL11_MAILER_ARGS	[mail11 $g $x $h $u] Arguments passed to the mail11
			mailer.
PH_MAILER_PATH		[/usr/local/etc/phquery] The path to the phquery
			program.
PH_MAILER_FLAGS		[ehmu] Flags for the phquery mailer.  Flags nrDFM
			are always set.
PH_MAILER_ARGS		[phquery -- $u] -- arguments to the phquery mailer.
CYRUS_MAILER_FLAGS	[Ah5@/:|] The flags used by the cyrus mailer.  The
			flags lsDFMnPq are always included.
CYRUS_MAILER_PATH	[/usr/cyrus/bin/deliver] The program used to deliver
			cyrus mail.
CYRUS_MAILER_ARGS	[deliver -e -m $h -- $u] The arguments passed
			to deliver cyrus mail.
CYRUS_MAILER_MAX	[undefined] If set, the maximum size message that
			will be accepted by the cyrus mailer.
CYRUS_MAILER_USER	[cyrus:mail] The user and group to become when
			running the cyrus mailer.
CYRUS_BB_MAILER_FLAGS	[u] The flags used by the cyrusbb mailer.
			The flags lsDFMnP are always included.
CYRUS_BB_MAILER_ARGS	[deliver -e -m $u] The arguments passed
			to deliver cyrusbb mail.
confEBINDIR		[/usr/libexec] The directory for executables.
			Currently used for FEATURE(`local_lmtp') and
			FEATURE(`smrsh').
QPAGE_MAILER_FLAGS	[mDFMs] The flags used by the qpage mailer.
QPAGE_MAILER_PATH	[/usr/local/bin/qpage] The program used to deliver
			qpage mail.
QPAGE_MAILER_ARGS	[qpage -l0 -m -P$u] The arguments passed
			to deliver qpage mail.
QPAGE_MAILER_MAX	[4096] If set, the maximum size message that
			will be accepted by the qpage mailer.

Note: to tweak Name_MAILER_FLAGS use the macro MODIFY_MAILER_FLAGS:
MODIFY_MAILER_FLAGS(`Name', `change') where Name is the first part of
the macro Name_MAILER_FLAGS and change can be: flags that should
be used directly (thus overriding the default value), or if it
starts with `+' (`-') then those flags are added to (removed from)
the default value.  Example:

	MODIFY_MAILER_FLAGS(`LOCAL', `+e')

will add the flag `e' to LOCAL_MAILER_FLAGS.
WARNING: The FEATUREs local_lmtp and local_procmail set LOCAL_MAILER_FLAGS
unconditionally, i.e., without respecting any definitions in an
OSTYPE setting.


+---------+
| DOMAINS |
+---------+

You will probably want to collect domain-dependent defines into one
file, referenced by the DOMAIN macro.  For example, the Berkeley
domain file includes definitions for several internal distinguished
hosts:

UUCP_RELAY	The host that will accept UUCP-addressed email.
		If not defined, all UUCP sites must be directly
		connected.
BITNET_RELAY	The host that will accept BITNET-addressed email.
		If not defined, the .BITNET pseudo-domain won't work.
DECNET_RELAY	The host that will accept DECNET-addressed email.
		If not defined, the .DECNET pseudo-domain and addresses
		of the form node::user will not work.
FAX_RELAY	The host that will accept mail to the .FAX pseudo-domain.
		The "fax" mailer overrides this value.
LOCAL_RELAY	DEPRECATED.  The site that will handle unqualified
		names -- that is, names with out an @domain extension.
		If not set, they are assumed to belong on this machine.
		This allows you to have a central site to store a
		company- or department-wide alias database.  This
		only works at small sites, and only with some user
		agents.
LUSER_RELAY	The site that will handle lusers -- that is, apparently
		local names that aren't local accounts or aliases.  To
		specify a local user instead of a site, set this to
		``local:username''.

Any of these can be either ``mailer:hostname'' (in which case the
mailer is the internal mailer name, such as ``uucp-new'' and the hostname
is the name of the host as appropriate for that mailer) or just a
``hostname'', in which case a default mailer type (usually ``relay'',
a variant on SMTP) is used.  WARNING: if you have a wildcard MX
record matching your domain, you probably want to define these to
have a trailing dot so that you won't get the mail diverted back
to yourself.

The domain file can also be used to define a domain name, if needed
(using "DD<domain>") and set certain site-wide features.  If all hosts
at your site masquerade behind one email name, you could also use
MASQUERADE_AS here.

You do not have to define a domain -- in particular, if you are a
single machine sitting off somewhere, it is probably more work than
it's worth.  This is just a mechanism for combining "domain dependent
knowledge" into one place.

+---------+
| MAILERS |
+---------+

There are fewer mailers supported in this version than the previous
version, owing mostly to a simpler world.  As a general rule, put the
MAILER definitions last in your .mc file, and always put MAILER(`smtp')
before MAILER(`uucp') and MAILER(`procmail') -- several features and
definitions will modify the definition of mailers, and the smtp mailer
modifies the UUCP mailer.  Moreover, MAILER(`cyrus'), MAILER(`pop'),
MAILER(`phquery'), and MAILER(`usenet') must be defined after
MAILER(`local').

local		The local and prog mailers.  You will almost always
		need these; the only exception is if you relay ALL
		your mail to another site.  This mailer is included
		automatically.

smtp		The Simple Mail Transport Protocol mailer.  This does
		not hide hosts behind a gateway or another other
		such hack; it assumes a world where everyone is
		running the name server.  This file actually defines
		five mailers: "smtp" for regular (old-style) SMTP to
		other servers, "esmtp" for extended SMTP to other
		servers, "smtp8" to do SMTP to other servers without
		converting 8-bit data to MIME (essentially, this is
		your statement that you know the other end is 8-bit
		clean even if it doesn't say so), "dsmtp" to do on
		demand delivery, and "relay" for transmission to the
		RELAY_HOST, LUSER_RELAY, or MAIL_HUB.

uucp		The UNIX-to-UNIX Copy Program mailer.  Actually, this
		defines two mailers, "uucp-old" (a.k.a. "uucp") and
		"uucp-new" (a.k.a. "suucp").  The latter is for when you
		know that the UUCP mailer at the other end can handle
		multiple recipients in one transfer.  If the smtp mailer
		is also included in your configuration, two other mailers
		("uucp-dom" and "uucp-uudom") are also defined [warning:
		you MUST specify MAILER(smtp) before MAILER(uucp)].  When you
		include the uucp mailer, sendmail looks for all names in
		class {U} and sends them to the uucp-old mailer; all
		names in class {Y} are sent to uucp-new; and all
		names in class {Z} are sent to uucp-uudom.  Note that
		this is a function of what version of rmail runs on
		the receiving end, and hence may be out of your control.
		See the section below describing UUCP mailers in more
		detail.

usenet		Usenet (network news) delivery.  If this is specified,
		an extra rule is added to ruleset 0 that forwards all
		local email for users named ``group.usenet'' to the
		``inews'' program.  Note that this works for all groups,
		and may be considered a security problem.

fax		Facsimile transmission.  This is experimental and based
		on Sam Leffler's HylaFAX software.  For more information,
		see http://www.vix.com/hylafax/.

pop		Post Office Protocol.

procmail	An interface to procmail (does not come with sendmail).
		This is designed to be used in mailertables.  For example,
		a common question is "how do I forward all mail for a given
		domain to a single person?".  If you have this mailer
		defined, you could set up a mailertable reading:

			host.com	procmail:/etc/procmailrcs/host.com

		with the file /etc/procmailrcs/host.com reading:

			:0	# forward mail for host.com
			! -oi -f $1 [e-mail]

		This would arrange for (anything)@host.com to be sent
		to [e-mail].  Within the procmail script, $1 is
		the name of the sender and $2 is the name of the recipient.
		If you use this with FEATURE(`local_procmail'), the FEATURE
		should be listed first.

mail11		The DECnet mail11 mailer, useful only if you have the mail11
		program from gatekeeper.dec.com:/pub/DEC/gwtools (and
		DECnet, of course).  This is for Phase IV DECnet support;
		if you have Phase V at your site you may have additional
		problems.

phquery		The phquery program.  This is somewhat counterintuitively
		referenced as the "ph" mailer internally.  It can be used
		to do CCSO name server lookups.  The phquery program, which
		this mailer uses, is distributed with the ph client.

cyrus		The cyrus and cyrusbb mailers.  The cyrus mailer delivers to
		a local cyrus user.  this mailer can make use of the
		"[e-mail]" syntax; it will deliver the mail to
		the user's "detail" mailbox if the mailbox's ACL permits.
		The cyrusbb mailer delivers to a system-wide cyrus mailbox
		if the mailbox's ACL permits.  The cyrus mailer must be
		defined after the local mailer.

qpage		A mailer for QuickPage, a pager interface.  See
		http://www.qpage.org/ for further information.

The local mailer accepts addresses of the form "user+detail", where
the "+detail" is not used for mailbox matching but is available
to certain local mail programs (in particular, see
FEATURE(`local_procmail')).  For example, "eric", "eric+sendmail", and
"eric+sww" all indicate the same user, but additional arguments <null>,
"sendmail", and "sww" may be provided for use in sorting mail.


+----------+
| FEATURES |
+----------+

Special features can be requested using the "FEATURE" macro.  For
example, the .mc line:

	FEATURE(`use_cw_file')

tells sendmail that you want to have it read an /etc/mail/local-host-names
file to get values for class {w}.  The FEATURE may contain up to 9
optional parameters -- for example:

	FEATURE(`mailertable', `dbm /usr/lib/mailertable')

The default database map type for the table features can be set with

	define(`DATABASE_MAP_TYPE', `dbm')

which would set it to use ndbm databases.  The default is the Berkeley DB
hash database format.  Note that you must still declare a database map type
if you specify an argument to a FEATURE.  DATABASE_MAP_TYPE is only used
if no argument is given for the FEATURE.  It must be specified before any
feature that uses a map.

Available features are:

use_cw_file	Read the file /etc/mail/local-host-names file to get
		alternate names for this host.  This might be used if you
		were on a host that MXed for a dynamic set of other hosts.
		If the set is static, just including the line "Cw<name1>
		<name2> ..." (where the names are fully qualified domain
		names) is probably superior.  The actual filename can be
		overridden by redefining confCW_FILE.

use_ct_file	Read the file /etc/mail/trusted-users file to get the
		names of users that will be ``trusted'', that is, able to
		set their envelope from address using -f without generating
		a warning message.  The actual filename can be overridden
		by redefining confCT_FILE.

redirect	Reject all mail addressed to "address.REDIRECT" with
		a ``551 User has moved; please try <address>'' message.
		If this is set, you can alias people who have left
		to their new address with ".REDIRECT" appended.

nouucp		Don't route UUCP addresses.  This feature takes one
		parameter:
		`reject': reject addresses which have "!" in the local
			part unless it originates from a system