The checksendmail program is a perl script that aids the testing of sendmail(8)'s various configuration files. checksendmail passes typical addresses (supplied in input files) through sendmail and prints the results of the resolution and transformation routines.
The input files contain a list of addresses, one per line. For example:
user user@site firstname.lastname@example.org
The input file can contain comments started with a # and blank lines.
The following command will pass the addresses in address.resolve through sendmail using the configuration information in myconfig.cf .
example% cat address.resolve user user@site email@example.com example% checksendmail -C myconfig.cf system: myhost.gadget.com current dir: /tmp/Checksendmail resolve file: address.resolve sendmail binary: /usr/sbin/sendmail sendmail version: 8.9.3 config file: /etc/sendmail.cf config file version: V8/Berkeley Mail address resolution user --(ether )--> user[rmtc] user@site --(ether )--> user@site[rmtc] firstname.lastname@example.org --(ether )--> email@example.com[rmtc] `To' address transformations for mailer ether: user ----> user user@site ----> user@site firstname.lastname@example.org ----> email@example.com `From' address transformations for mailer ether: user ----> user user@site ----> user firstname.lastname@example.org ----> user
The first section of the output shows how the addresses in the input files are resolved by sendmail(8). Consider the following output line:
email@example.com --(ether )--> firstname.lastname@example.org[rmtc]
The input address
email@example.com resolves to use the ether mailer. That mailer is directed to send the mail to to the user firstname.lastname@example.org at site rmtc (as indicated in the square brackets).
The two later sections of output show how the addresses specified as the To and From address are transformed in the text of the headers. In the example above, the To addresses are untouched. The From addresses, however, all lose their machine information on the way through the mailer:
user@site ----> user
This may be desirable when using a configuration file on a
workstation which is to be hidden as a mailhost from the rest of the network.
The following is a set of addresses used at one site for the purposes of testing address resolution. Comments after the addresses detail why particular addresses are present:
sendmail requires that the user have access to directory specified by the OQ parameter in the configuration file (normally /usr/spool/mqueue ) checksendmail verifies that the user has access to this directory before allowing the test to continue.
Gene Kim Rob Kolstad Jeff Polk
Modified by Robert Harker