ph |
CCSO Nameserver (ph) lookups | V8.10 and above |
Switch |
§ |
Description |
---|---|---|
-A |
-A |
Append values for duplicate keys |
-a |
-a |
Append tag on successful match |
-D |
-D |
Don't use this database map if DeliveryMode=defer |
-f |
-f |
Don't fold keys to lowercase |
-h |
See this section |
Hosts that serve this network database map |
-k |
See this section |
Specify a list of fields to query |
-l |
-l (lowercase L) |
Set a timeout for the lookup[13] |
-m |
-m |
Suppress replacement on match |
-N |
-N |
Append a null byte to all keys |
-O |
-O |
Never add a null byte |
-o |
-o |
This database map is optional |
-q |
-q |
Don't strip quotes from key |
-S |
-S |
Space replacement character |
-T |
-T |
Suffix to append on temporary failure |
-t |
-t |
Ignore temporary errors |
-v |
Deprecated, use -k instead |
[13] As of V8.10, _FFR_PHMAP_TIMEOUT must be defined when compiling sendmail to enable this -l switch. As of V8.11, that definition is no longer necessary.
This ph database map was contributed by Mark Roth of the University of Illinois at Urbana-Champaign. For additional information see http://www-dev.cso.uiuc.edu/sendmail/.
The -h switch is used to specify the host to which to connect for the lookup. In general, the host specified should be a fully qualified hostname:
-h phserver.your.domain
In the event you wish to employ multiple ph servers, you can list them, one separated from the next by a space character:
-h "phserver.your.domain phserver2.your.domain"
Because the host list contains space characters, it must be quoted.
Note that this -h switch is mandatory. If it is omitted, the following error is printed and logged:
ph_map_parseargs: -h flag is required
The -k switch[14] specifies a quoted, space-delimited list of fields to query.[15] Fields are queried in the order listed, and the first query that returns a single match is the one whose returned value is used. If the -k switch is omitted, the list of fields to query is obtained by looking up the mailmatches field in the ph server's siteinfo list.
[14] This used to be the -v switch, but -v has been deprecated in this role.
[15] Note that the spacedname field name is no longer understood by ph.