9.3 Testing Rule Set 0

To see that what we describe is actually what happens, take a moment to add rule set 0 to the end of your client.cf file:

S0 # select delivery agent                                          


 new
 

R$+     $#hub $@${REMOTE} $:$1          forward to hub              


 new

Now run sendmail in rule-testing mode and give it the address boss@acme :

% 

./sendmail -Cclient.cf -bt

 ADDRESS TEST MODE (ruleset 3 NOT automatically invoked) Enter <ruleset> <address> > 

0 boss@acme

 rewrite: ruleset  0   input: boss @ acme rewrite: ruleset  0 returns: $# hub $@ mailhost $: boss @ acme

The change to the workspace caused by rule set 0 is exactly as predicted:

$# hub $@ mailhost $: boss @ acme

Components from the workspace triple are used by sendmail to define macros used by delivery agents. For example, the text after $@ is copied into the h macro. Similarly, the username appearing after $: is copied into the u macro:

                                                          
from
 $@ 
in rule set 0
                                                                 Mhub,   P=[IPC], S=0, R=0, F=mDFMuXa, T=DNS/RFC822/SMTP, A=IPC $h Mlocal, P=/bin/mail, F=lsDFMAw5:/|@rmn, S=0, R=0, A=mail -d $u                                                                                                            
from
 $: 
in rule set 0

Rule set 0 is different from the other rule sets in several important ways. We'll begin explaining the other rule sets in the next chapter. For now, just be aware that there are a few exceptions to rules in sendmail :

• Rule set 0 is one of the few rule sets that may use $# to return the symbolic name of a delivery agent. [2] If any other rule set returns a $# , the $# can cause unpredictable errors.

  [2] Rule set 5 can also return a $# .

• $@ and $: in rule set 0, when following $# , have different meanings than they do in all the other rule sets. They are even different from the way they are in rule set 0 itself when they don't follow $# . We'll expand on this concept in the next chapter.