-d38.9

Trace database map closings and appends

Debug command-line switch

The -d38.9 debugging switch traces map closures for maps that can be closed:

ndbm_map_close(name, file, flags) 
db_map_close(name, file, flags) 
impl_map_close(name, file, flags) 
ph_map_close(name): pmap-ph_fastclose=num
prog_map_lookup(name) failed (errno) -- closing 
seq_map_close(name)

Here, the name is either the name you gave to the map with the K configuration command or one assigned internally by sendmail (such as aliases.files). The file is the filename on disk that contains the database. The flags describe the specific features of a map. They are printed in hexadecimal, and the meanings of the values printed are listed in Table 16-11.

Table 16-11. Flags describing properties of database maps
Hex	Text	Description
MF_VALID	0x00000001	This entry is valid
MF_INCLNULL	0x00000002	Include null byte in key
MF_OPTIONAL	0x00000004	Don't complain if map is not found
MF_NOFOLDCASE	0x00000008	Don't fold case in keys
MF_MATCHONLY	0x00000010	Only check for existence of the key
MF_OPEN	0x00000020	This database is open
MF_WRITABLE	0x00000040	Open for writing
MF_ALIAS	0x00000080	This is an alias file
MF_TRY0NULL	0x00000100	Try with no null byte
MF_TRY1NULL	0x00000200	Try with the null byte
MF_LOCKED	0x00000400	This map is currently locked
MF_ALIASWAIT	0x00000800	Alias map in aliaswait state
MF_IMPL_HASH	0x00001000	Implicit: underlying hash database
MF_IMPL_NDBM	0x00002000	Implicit: underlying ndbm database
MF_UNSAFEDB	0x00004000	This map is world-writable (prior to V8.12.1)
MF_APPEND	0x00008000	Append new entry on rebuild
MF_KEEPQUOTES	0x00010000	Don't dequote key before lookup
MF_NODEFER	0x00020000	Don't defer if map lookup fails (V8.8 and above)
MF_REGEX_NOT	0x00040000	Regular expression negation (V8.9 and above)
MF_DEFER	0x00080000	Don't look up map in defer mode (V8.10 and above)
MF_SINGLEMATCH	0x00100000	Successful only if matches one key (V8.10 and above)
MF_FILECLASS	0x00400000	This is a file database type (V8.12 and above)
MF_OPENBOGUS	0x00800000	Open failed, don't call map_close (V8.12 and above)
MF_CLOSING	0x01000000	This map is being closed (V8.12 and above)

In addition to tracing map closures, the -d38.9 debugging switch traces map appends allowed by the MF_APPEND flag (-A) as specified when the database is declared by the K configuration command:

ndbm_map_store append=new
db_map_store append=new

Here new is the new value appended to the old. Because this property is used for alias files, the new and old values have a comma inserted between them.

Table 16-11. Flags describing properties of database maps