F E A T U R E S   F O R   F U T U R E   R E L E A S E


In the source code for this package may be one or more segments of code
that are disabled, as they are slated for future release (FFR).  These
are generally unreleased or incomplete features, or can be new algorithms
for existing features.  They are often untested and currently unsupported,
and generally formally become part of the released software in some future
revision.  There may or may not be documentation for them outside of this
file.  Use them at your own risk.

To enable an FFR in the source code, find the feature you want to use
in the list below and arrange to enable that feature at build time by
adding -D_FFR_<feature-name> to the build.  For example, to add the WIDGET
feature, you would add -D_FFR_WIDGET to the build.  You would do this
by adding a line to Makefile.m4 that reads:

	APPENDDEF(`confENVDEF', `-D_FFR_WIDGET')


Feature Name	Description

ANTICIPATE_SENDMAIL_MUNGE
		When canonicalizing headers, anticipate the minor rewrites
		the sendmail MTA is likely to do.  Do not use this with
		sendmail 8.14.x or later.  (dkim-filter)

CAPTURE_UNKNOWN_ERRORS
		When dkim_eom() returns an unexpected error of some kind,
		quarantine the message for further analysis.  (dkim-filter)

DIFFHEADERS	When verification fails for a message for which a "z="
		tag was provided, compare the received headers to the original
		headers to look for possible munging.  Requires the tre
		library.  (dkim-filter, libdkim)

DNS_UPGRADE	Maintain two libar instances, the second in TCP mode, in case
		any UDP queries come back truncated.  Not meaningful unless
		libar is in use.  (libdkim)

PARSE_TIME	Adds a utility function reporting the value of the Date:
		header for easy comparison to signature timestamps in order
		to detect messages in which those values wildly differ.
		INCOMPLETE.  (libdkim)

REPLACE_RULES	Allow specification of a "replacement rules" table
		for use when signing, replacing certain patterns in
		address headers with specific strings to anticipate the
		effects of the "masquerade" and "genericstable" features in
		the MTA.  (dkim-filter)

REQUIRED_HEADERS
		Optionally enforce minimum header requirements per RFC2822.
		(dkim-filter)

SELECT_CANONICALIZATION
		Optionally override the value of the "-c" command line flag
		by specifying a preferred canonicalization on a special
		header line.  Intended mostly for testing, not production
		use.  (dkim-filter)

SELECTOR_HEADER	Enable selection of which selector (and thus which key)
		to use when signing based on the contents of an arbitrary
		header.  (dkim-filter)

STATS		Optional generation of statistics about pass/fail sorted
		by domain and canonicalization.  Requires Sleepycat DB.
		(dkim-filter, libdkim)

VBR		Enable VBR (Vouch By Reference) header addition (outbound)
		and processing (inbound).  Under revision and may not be
		stable.  (dkim-filter, libdkim)

ZTAGS		Save headers to a file for diagnostics when the signer used
		a "z=" tag. (dkim-filter)


$Revision: 1.46 $, Last updated $Date: 2007/11/01 18:13:14 $