CHECKSENDMAIL(8) - Linux man page online | Administration and privileged commands

Verify sendmail address transformations.

November 14, 2000


checksendmail — verify sendmail address transformations.


checksendmail [-a] [-d] [-b] [-C] [-b sendmail_binary] [-l log_file] [-r resolve] [-T test.address]


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 The input file can contain comments started with a # and blank lines.


-a Show aliasing of local addresses in mail address resolution phase of testing -d Precede each address translation line with ruleset sequence summary -C Use the sendmail configuration file instead of the default /etc/ file. -b sendmail_binary Use the specified sendmail_binary as the path to invoke sendmail (instead of /usr/sbin/sendmail). -l log_file Log sendmail address test mode debugging output to log_file -r resolve Use resolve as the input file for the addresses to be used for mail resolv‐ ing. Defaults to address.resolve. -T test.address Use test.address as the single address to test. Cannot be used in conjunc‐ tion with file setting flags.


The following command will pass the addresses in address.resolve through sendmail using the configuration information in example% cat address.resolve user user@site example% checksendmail -C system: current dir: /tmp/Checksendmail resolve file: address.resolve sendmail binary: /usr/sbin/sendmail sendmail version: 8.9.3 config file: /etc/ config file version: V8/Berkeley Mail address resolution user --(ether )--> user[rmtc] user@site --(ether )--> user@site[rmtc] --(ether )-->[rmtc] `To' address transformations for mailer ether: user ----> user user@site ----> user@site ----> `From' address transformations for mailer ether: user ----> user user@site ----> user ----> 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: --(ether )-->[rmtc] The input address resolves to use the ether mailer. That mailer is directed to send the mail to to the user 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: user Standard trivial address user@rmtc qualified at one level @rmtc.central qualified at two levels qualified all the way rmtc!user local but specified as uucp user@summit a workstation (normally delivered locally, though) @summit.central same but more qualified same but fully qualified summit!user same but specified as uucp user@prisma Backward compatibility tests prisma!user user@central Superior domain testing @machine.central more qualified, but unknown @summit.central more qualified and known user@eng name in faraway domain @machine.eng unknown machine in faraway domain @summit.eng local machine, far away domain user@hoback far away machine user@machine apparently local but unknown machine Standard trivial address fully qualified but unknown machine standard, known, really far away domain @foo.dom standard, unknown, really far away domain site!user Single level uucp site1!site2!user Double level uucp @foo.dom@bar.dom Trickier address site!@foo.dom Mixed uucp/domain site! Mixed double uucp/domain


Note that checksendmail is a perl script. If your site does not have perl(1), it can be obtained via anonymous ftp from 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


BSD November 14, 2000 BSD
This manual Reference Other manuals
checksendmail(8) referred by
refer to perl(1) | sendmail(8)
Download raw manual
Index BSD System Manager's Manual (+153) BSD (+3984) № 8 (+5755)
Go top