                     SENDMAIL SPECIAL INSTRUCTIONS

Beginning with patch 103594-16, Sun's sendmail for Solaris 2.5.1 is upgraded
from the old version SMI-8.6 to the new version 8.8.8+Sun. What does this
mean to you?  A lot if you are interested in using anti-spam, security and 
other new features.  Or very little if you just want stability and
consistency.

Below you will find two sections.  "MIGRATION CHANGES" describes behavioral
changes in 8.8.8+Sun, and provides advice to system administrators in using
it.  "NEW FEATURES" lists the new features provided, and includes pointers
to additional information.


I. MIGRATION CHANGES

    1. Backwards compatibility

       There are many improvements in 8.8.8+Sun over SMI-8.6 (see below).
       New configuration files are provided which enable some of these new
       features; these are known as V7/Sun configuration files.  The old
       configuration files, known as V1/Sun, are still supported.

       Installing this patch will replace the V1/Sun configuration files with
       V7/Sun configuration files.  The old V1/Sun files will be renamed with
       a .v8.6 extension, and they can be used by restoring them.  Use of the
       new files, however, is strongly recommended.

    2. Hierarchy for building configuration files provided

       Modifying sendmail.cf directly is no longer necessary.  A new sub-
       directory, /usr/lib/mail, is provided, under which there is an
       infrastructure for building sendmail configuration files using the m4
       macro processor.  Full details are in /usr/lib/mail/README .  Note
       that the use of long option names has made sendmail.cf more human-
       readable, but it is still strongly recommended that the m4 macros
       be used instead of modifying the configuration files directly.

    3. Security

       Because of tightened security in 8.8.8+Sun, /etc/mail has been modified
       not to be group writable.  If certain other directories -- /etc, /var
       and /var/spool -- are group writable, warning messages to this effect
       will be displayed.

       Also, sendmail needs these files to enable aliases to work properly:

       /etc/mail/aliases.pag
       /etc/mail/aliases.dir

       Since /etc is group writable on 2.5.1, sendmail will consider it
       "unsafe" to create them, so if they do not exist at start-up, the
       system administrator will need to create them, possibly using these
       commands as root:

       # cd /etc/mail
       # /usr/bin/touch aliases.dir aliases.pag
       # /usr/bin/chmod go-w aliases.dir aliases.pag

       Alternatively, the permissions on /etc can be fixed, but this may cause
       the pkgchk command to have errors, and the installation of subsequent
       patches may well restore the group-write permission on /etc .

II. NEW FEATURES

New features available in 8.8.8+Sun

* Probably the most important set of new features are the user-visible
  changes, which are covered at:

	http://www.sendmail.org/sun-specific/migration+sun.html

  The sections covered are:

	* User-visible changes
		* owner- aliases
		* /etc/shells
		* DSNs
		* .forward.machine-name
		* NoRecipientAction
		* Tightened Security
		* Content-Length: header in messages sent to programs or files
		* Directory Permissions
	* Administrator-visible changes that may have a trickle effect
		* MaxAliasRecursion
		* Fully-qualified host names

* Another worthwhile document, which the above links to, is:

	http://www.sendmail.org/sun-specific/differences.html

  The sections cover the differences between:

	* SMI-8.6 and 8.8.8+Sun using the same V1/Sun configuration file
	* 8.8.8 and 8.8.8+Sun using the same V7/Berkeley configuration file
	* A V7/Sun configuration file and a V7/Berkeley configuration file
	  when run by the same 8.8.8+Sun binary
	* Behavioral changes in 8.*+Sun when in V1/Sun Backwards
	  Compatibility Mode
	* Default configuration files
		* Berkeley's generic-solaris2.cf vs. Solaris' main.cf
		* Solaris' main.cf vs. subsidiary.cf

* Other features added when going from SMI-8.6 to 8.8.8+Sun include:

	* Hierarchy for building configuration files

		http://www.sendmail.org/m4/readme.html

	  covers this in detail; except for some mailers and non-Solaris
	  OS types, almost all of this applies to our stuff as well.

	* A makemap binary is now shipped.

	  This is need for some of the virtual-hosting and anti-spam
	  configuration noted below.

	* Virtual hosting (8.8)

		http://www.sendmail.org/virtual-hosting.html

	* Anti-spam configurability (8.8)

		http://www.sendmail.org/antispam.html
  
	* Long option names (8.7)

	  Though sendmail.cf is not supposed to be edited (see the m4 notes
	  above), the options section is much more human-readable thanks to
	  switching from single-character to long option names.

	* 8BITMIME support (8.7)

	  Sendmail can deal with 8-bit message content properly.

	* Richer test mode syntax (8.7)
