Previous Section Next Section

ph

CCSO Nameserver (ph) lookups V8.10 and above

Prior to V8.10 sendmail, redirecting email with a ph server required running the phquery program. Beginning with V8.10 sendmail, a database-map type called ph has been added that allows sendmail to perform direct ph queries. You declare it like this:

Kname ph  switches  

The complete list of switches for this database-map type is shown in Table 23-22.

Table 23-22. The ph database-map type K command switches

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 ph database-map switch

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 ph database-map switch

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.

Previous Section Next Section