![]() ![]() |
Note that some additional explanation for a few of these switches is provided in the sections that follow. Also, for an actual example of the regex type, see the file cf/cf/knecht.mc, which demonstrates a way to deal with one type of spam email. The -b regex database-map switchThe -b switch limits the regular expression to a more limited but faster form. If you are using only simple regular expressions, as in the nature of those defined by ed(1), you can use this -b switch to slightly speed up the process: Kmatch regex -b -aLOCAL @localhost Here, the search is for a workspace that contains the substring @localhost. Because this is a very simple regular expression, the -b switch is appropriate. If you use the -b on a complex match (such as the one in the previous section's -n example), you might see an error such as this: configfile: line num: field (2) out of range, only 1 substring in pattern The -d regex database-map switchThere might be times when you would prefer some other character, operator, or token to replace the $| that is returned when using the -s switch. If so, you can specify a different one with the -d database switch. Consider: Kmatch regex -s2,3 -d+|+ -a.FOUND (\<a\>|\<b\>)@(\<bob\>|\<ted\>).(\<com\>|\<org\>) Here we specify that the three characters +|+ will replace the single operator $| in the returned value: > test a@bob.com test input: a @ bob . com test returns: bob+|+com . FOUND Note that here the bob+|+com is a single token. You can opt to have the original key returned. This is done by specifying the -m database switch: Kmatch regex -s2,3 -m -d+|+ -a.FOUND (\<a\>|\<b\>)@(\<bob\>|\<ted\>).(\<com\>|\<org\>) Note that the -m switch overrides the presence of the -s and -d switches: > test a@bob.com test input: a @ bob . com test returns: a @ bob . com . FOUND The -n regex database-map switchThe -n switch inverts the entire sense of the regular expression lookup. It returns a successful match only if the regular expression does not match. Consider: Kmatch regex -m -n -a.FOUND (\<a\>|\<b\>)@(\<bob\>|\<ted\>).(\<com\>|\<org\>) If you view the effect of this switch in rule-testing mode, you will see that the result is inverted: > test a@bob.com test input: a @ bob . com test returns: a @ bob . com > test x@y.net test input: x @ y . net test returns: x @ y . net . FOUND The -s regex database-map switchThe -s database-map switch is used with the regex type to specify a substring to match and return. To illustrate, consider the following mini-configuration file: V10 Kmatch regex -s (\<bob\>|\<ted\>) Stest R $* $@ $(match $1 $) The regular expression looks to match either the name bob or ted, but no other names. The -s says to return the substring actually matched in the expression along with the key, the two separated from each other by a $| operator. Now, observe this mini-configuration file in rule-testing mode: % /usr/sbin/sendmail -bt -Cdemo.cf ADDRESS TEST MODE (ruleset 3 NOT automatically invoked) Enter <ruleset> <address> > test bob test input: bob test returns: bob $| bob > test alice test input: alice test returns: alice By adding a -a switch, which appends text to the matched key: Kmatch regex -s -a.FOUND (bob|ted) we see that the matched key with -s is second: > test bob test input: bob test returns: bob $| bob . FOUND When multiple substrings can be matched, the -s database switch can be used to specify which substring match to return. Consider: Kmatch regex -s2 -a.FOUND (\<a\>|\<b\>)@(\<bob\>|\<ted\>) There are two substring searches here, first the (\<a\>|\<b\>) choice, then the (\<bob\>|\<ted\>) choice. Because the -s has a 2 as its argument, the second matched substring will be returned, not the first: > test a@bob test input: a @ bob test returns: bob . FOUND In more complex expressions it might be desirable to return multiple substrings. To do that just list them following the -s with each separated from the next by a comma: Kmatch regex -s2,3 -a.FOUND (\<a\>|\<b\>)@(\<bob\>|\<ted\>).(\<com\>|\<org\>) When multiple substrings are listed in this way, they are separated by the $| operator when they are returned: > test a@bob.com test input: a @ bob . com test returns: bob $| com . FOUND ![]() |
![]() ![]() |