Building the sendmail.cf Configuration File

How to Build a New sendmail.cf File shows you how to build the configuration file. Although you can still use older versions of sendmail.cf files, the best practice is to use the new format.

For more details, refer to the following.

• /etc/mail/cf/README provides a complete description of the configuration process.

• http://www.sendmail.org provides online information about sendmail configuration.

• Versions of the Configuration File and sendmail Configuration File, in Chapter 14, Mail Services (Reference), provide some guidance.

• Additional and Revised m4 Configuration Macros From Version 8.12 of sendmail is also helpful.

How to Build a New sendmail.cf File

The following procedure shows you how to build a new configuration file.

Note - /usr/lib/mail/cf/main-v7sun.mc is now /etc/mail/cf/cf/main.mc.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services. To configure a role with the Primary Administrator profile, see Chapter 2, Working With the Solaris Management Console (Tasks), in System Administration Guide: Basic Administration.

2. Stop sendmail.

   # svcadm -t disable network/smtp:sendmail

3. Make a copy of the configuration files that you are changing.

   # cd /etc/mail/cf/cf
   # cp sendmail.mc myhost.mc

   myhost

   Select a new name for your .mc file.

4. Edit the new configuration files (for example, myhost.mc), as necessary.

   For example, add the following command line to enable domain masquerading.

   # cat myhost.mc
   ..
   MASQUERADE_AS(`host.domain')

   host.domain

   Use the desired host name and domain name.

   In this example, MASQUERADE_AS causes sent mail to be labeled as originating from host.domain, rather than $j.

5. Build the configuration file by using m4.

   # /usr/ccs/bin/make myhost.cf

6. Test the new configuration file by using the -C option to specify the new file.

   # /usr/lib/sendmail -C myhost.cf -v testaddr </dev/null

   While this command displays messages, it sends a message to testaddr. Only outgoing mail can be tested without restarting the sendmail service on the system. For systems that are not handling mail yet, use the full testing procedure in How to Test the Mail Configuration.

7. Install the new configuration file after making a copy of the original.

   # cp /etc/mail/sendmail.cf /etc/mail/sendmail.cf.save
   # cp myhost.cf /etc/mail/sendmail.cf

8. Restart the sendmail service.

   # svcadm enable network/smtp:sendmail