23.3 The K Command switches

The switches must follow the type and precede the file_or_map:

Kname type switches file_or_map

If any switches follow file_or_map, they will be silently ignored.^[3] All switches begin with a - character and are listed in Table 23-3. Note that some database-map types utilize only a small subset of all switches (e.g., dequote uses only -a, -D, -s, and -S, and sequence doesn't use any).

^[3] This is true as of V8.12. Future versions might change the semantics of the K line such that switches can follow.

Table 23-3. K command switches
Switch	§	Description
`-1`	See this section	Consider successful only if exactly one key is matched (`ldap` only)
`-A`	-A	Append values for duplicate keys
`-a`	-a	Append tag on successful match
`-b`	See this section	Base from which to begin the search (`ldap` only)
`-b`	See this section	Use basic, not extended, regular expression matching (`regex` only)
`-D`	-D	Don't use this database map if `DeliveryMode=defer`
`-d`	See this section	DN to bind to server as (`ldap` only)
`-d`	See this section	The delimiting string (`regex` only)
`-d`	See this section	The res_search( ) `_res.retry` interval (`dns` and `host` only)
`-f`	-f	Preserve case
`-h`	See this section	Hosts that serve this network database (`ldap` only)
`-h`	See this section	Hosts that serve this network database (`ph` only)
`-k`	-k	Specify column for key
`-k`	See this section	The search query (`ldap` only)
`-k`	netinfo	The property that is searched (`netinfo` only)
`-k`	See this section	Specify a list of fields to query (`ph` only)
`-L`	syslog	The logging level at which to log (`syslog` only)
`-l`	-l (lowercase L)	Time limit to timeout connection (`ldap` and `ph` only)
`-M`	See this section	The method to use for binding (`ldap` only)
`-m`	-m	Suppress replacement on match
`-N`	-N	Append a null byte to all keys
`-n`	See this section	Retrieve attribute names only, not values (`ldap` only)
`-n`	See this section	NOT, that is, invert the test (`regex` only)
`-O`	-O	Never add a null byte
`-o`	-o	The database map is optional
`-P`	See this section	The secret password to use for binding (`ldap` only)
`-p`	See this section	Port to use when connecting to host (`ldap` only)
`-q`	-q	Don't strip quotes from key
`-R`	See this section	Don't auto-chase referrals (`ldap` only)
`-R`	dns	Record type to look up (`dns` only)
`-r`	See this section	Allow dereferencing of aliases (`ldap` only)
`-r`	See this section	The res_search( ) `_res.retries` limit (`dns` and `host` only)
`-S`	-S	Space replacement character for database map
`-s`	See this section	Search scope of "base," "one," or "sub" (`ldap` only)
`-s`	See this section	Substring to match and return (`regex` only)
`-T`	-T	Suffix to append on temporary failure
`-t`	-t	Ignore temporary errors
`-V`	See this section	Specify return attribute list separator (`ldap` only)
`-v`	-v	Specify the value's column
`-v`	netinfo	The property to return (`netinfo` only)
`-v`	ph	Specify a list of fields to return (`ph` only, deprecated)
`-v`	See this section	Specify the list of attributes to return (`ldap` only)
	See this section	Limit the number of matches to return (`ldap` only)
`-z`	-z	Specify the column delimiter

If a switch other than those listed is specified, that switch is either silently ignored or an error reports, depending on the version of sendmail and the particular type.

In the sections that follow, we document the switches that are common to a number of database-map types. Those that are unique, or unique in meaning, to a particular database-map type are listed with the type.

23.3 The K Command switches

Table 23-3. K command switches