24.4 Options in the mc File

When you create a configuration file with the mc configuration technique (see Chapter 4), you can tune each option by including an appropriate statement in your .mc configuration file:^[5]

^[5] Some mc macros use the define m4 directive, while others don't require that directive. Those that don't are suffixed with parentheses in the table.

define(`option',`value')         enclose in opposing single quotes 
define(`confAUTO_REBUILD',`True')    for example
DAEMON_OPTIONS(`Port=1097')      for example

The option is selected from one of the mc option names shown in the leftmost column of Table 24-3. The value is an appropriate value for that option, as described in the reference section at the end of this chapter. Note that the option and the value should each be enclosed in opposing single quotes to prevent m4 from wrongly recognizing either as a keyword or macro. The leftmost single quote is the reverse apostrophe, and the rightmost is the normal apostrophe.

Table 24-3. All option mc macros ordered by name
mc name	Option name	§
ALIAS_FILE	AliasFile	AliasFile
CLIENT_OPTIONS( )	ClientPortOptions	ClientPortOptions
confALIAS_WAIT	AliasWait	AliasWait
confALLOW_BOGUS_HELO	AllowBogusHELO	AllowBogusHELO
confAUTH_MAX_BITS	AuthMaxBits	AuthMaxBits
confAUTH_MECHANISMS	AuthMechanisms	AuthMechanisms
confAUTH_OPTIONS	AuthOptions	AuthOptions
confAUTO_REBUILD	AutoRebuildAliases	AutoRebuildAliases
confBAD_RCPT_THROTTLE	BadRcptThrottle	BadRcptThrottle
confBIND_OPTS	ResolverOptions	ResolverOptions
confBLANK_SUB	BlankSub	BlankSub
confCACERT	CACertFile	CACertFile
confCACERT_PATH	CACertPath	CACertPath
confCHECKPOINT_INTERVAL	CheckpointInterval	CheckpointInterval
confCHECK_ALIASES	CheckAliases	CheckAliases
confCLIENT_CERT	ClientCertFile	ClientCertFile
confCLIENT_KEY	ClientKeyFile	ClientKeyFile
confCLIENT_OPTIONS (deprecated)	ClientPortOptions	ClientPortOptions
confCOLON_OK_IN_ADDR	ColonOkInAddr	ColonOkInAddr
confCONNECTION_RATE_THROTTLE	ConnectionRateThrottle	ConnectionRateThrottle
confCONNECT_ONLY_TO	ConnectOnlyTo	ConnectOnlyTo
confCONTROL_SOCKET_NAME	ControlSocketName	ControlSocketName
confCON_EXPENSIVE	HoldExpensive	HoldExpensive
confCOPY_ERRORS_TO	PostmasterCopy	PostmasterCopy
confDAEMON_OPTIONS (deprecated)	DaemonPortOptions	DaemonPortOptions
confDEAD_LETTER_DROP	DeadLetterDrop	DeadLetterDrop
confDEF_AUTH_INFO	DefaultAuthInfo	DefaultAuthInfo
confDEF_CHAR_SET	DefaultCharSet	DefaultCharSet
confDEF_USER_ID	DefaultUser	DefaultUser
confDELAY_LA	DelayLA	DelayLA
confDELIVERY_MODE	DeliveryMode	DeliveryMode
confDELIVER_BY_MIN	DeliverByMin	DeliverByMin
confDF_BUFFER_SIZE	DataFileBufferSize	DataFileBufferSize
confDH_PARAMETERS	DHParameters	DHParameters
confDIAL_DELAY	DialDelay	DialDelay
confDIRECT_SUBMISSION_MODIFIERS	DirectSubmissionModifiers	DirectSubmissionModifiers
confDONT_BLAME_SENDMAIL	DontBlameSendmail	DontBlameSendmail
confDONT_EXPAND_CNAMES	DontExpandCnames	DontExpandCnames
confDONT_INIT_GROUPS	DontInitGroups	DontInitGroups
confDONT_PROBE_INTERFACES	DontProbeInterfaces	DontProbeInterfaces
confDONT_PRUNE_ROUTES	DontPruneRoutes	DontPruneRoutes
confDOUBLE_BOUNCE_ADDRESS	DoubleBounceAddress	DoubleBounceAddress
confEIGHT_BIT_HANDLING	EightBitMode	EightBitMode
confERROR_MESSAGE	ErrorHeader	ErrorHeader
confERROR_MODE	ErrorMode	ErrorMode
confFALLBACK_MX	FallbackMXhost	FallbackMXhost
confFAST_SPLIT	FastSplit	FastSplit
confFORWARD_PATH	ForwardPath	ForwardPath
confFROM_LINE	UnixFromLine	UnixFromLine
confHOSTS_FILE	HostsFile	HostsFile
confHOST_STATUS_DIRECTORY	HostStatusDirectory	HostStatusDirectory
confIGNORE_DOTS	IgnoreDots	IgnoreDots
confINPUT_MAIL_FILTERS	InputMailFilters	InputMailFilters
confLDAP_DEFAULT_SPEC	LDAPDefaultSpec	LDAPDefaultSpec
confLOG_LEVEL	LogLevel	LogLevel
confMAILBOX_DATABASE	MailboxDatabase	MailboxDatabase
confMATCH_GECOS	MatchGECOS	MatchGECOS
confMAX_ALIAS_RECURSION	MaxAliasRecursion	MaxAliasRecursion
confMAX_DAEMON_CHILDREN	MaxDaemonChildren	MaxDaemonChildren
confMAX_HEADERS_LENGTH	MaxHeadersLength	MaxHeadersLength
confMAX_HOP	MaxHopCount	MaxHopCount
confMAX_MESSAGE_SIZE	MaxMessageSize	MaxMessageSize
confMAX_MIME_HEADER_LENGTH	MaxMimeHeaderLength	MaxMimeHeaderLength
confMAX_QUEUE_CHILDREN	MaxQueueChildren	MaxQueueChildren
confMAX_QUEUE_RUN_SIZE	MaxQueueRunSize	MaxQueueRunSize
confMAX_RCPTS_PER_MESSAGE	MaxRecipientsPerMessage	MaxRecipientsPerMessage
confMAX_RUNNERS_PER_QUEUE	MaxRunnersPerQueue	MaxRunnersPerQueue
confMCI_CACHE_SIZE	ConnectionCacheSize	ConnectionCacheSize
confMCI_CACHE_TIMEOUT	ConnectionCacheTimeout	ConnectionCacheTimeout
confMESSAGE_TIMEOUT (deprecated)	QueueTimeout	QueueTimeout
confME_TOO	MeToo	MeToo
confMILTER_LOG_LEVEL	Milter.LogLevel	Milter
confMILTER_MACROS_CONNECT	Milter.macros.connect	Milter
confMILTER_MACROS_ENVFROM	Milter.macros.envfrom	Milter
confMILTER_MACROS_ENVRCPT	Milter.macros.envrcpt	Milter
confMILTER_MACROS_HELO	Milter.macros.helo	Milter
confMIME_FORMAT_ERRORS	SendMimeErrors	SendMimeErrors
confMIN_FREE_BLOCKS	MinFreeBlocks	MinFreeBlocks
confMIN_QUEUE_AGE	MinQueueAge	MinQueueAge
confMUST_QUOTE_CHARS	MustQuoteChars	MustQuoteChars
confNICE_QUEUE_RUN	NiceQueueRun	NiceQueueRun
confNO_RCPT_ACTION	NoRecipientAction	NoRecipientAction
confOLD_STYLE_HEADERS	OldStyleHeaders	OldStyleHeaders
confOPERATORS	OperatorChars	OperatorChars
confPID_FILE	PidFile	PidFile
confPRIVACY_FLAGS	PrivacyOptions	PrivacyOptions
confPROCESS_TITLE_PREFIX	ProcessTitlePrefix	ProcessTitlePrefix
confQUEUE_FACTOR	QueueFactor	QueueFactor
confQUEUE_FILE_MODE	QueueFileMode	QueueFileMode
confQUEUE_LA	QueueLA	QueueLA
confQUEUE_SORT_ORDER	QueueSortOrder	QueueSortOrder
confRAND_FILE	RandFile	RandFile
confREAD_TIMEOUT (deprecated)	Timeout	Timeout
confREFUSE_LA	RefuseLA	RefuseLA
confRRT_IMPLIES_DSN	RrtImpliesDsn	RrtImpliesDsn
confRUN_AS_USER	RunAsUser	RunAsUser
confSAFE_FILE_ENV	SafeFileEnvironment	SafeFileEnvironment
confSAFE_QUEUE	SuperSafe	SuperSafe
confSAVE_FROM_LINES	SaveFromLine	SaveFromLine
confSEPARATE_PROC	ForkEachJob	ForkEachJob
confSERVER_CERT	ServerCertFile	ServerCertFile
confSERVER_KEY	ServerKeyFile	ServerKeyFile
confSERVICE_SWITCH_FILE	ServiceSwitchFile	ServiceSwitchFile
confSEVEN_BIT_INPUT	SevenBitInput	SevenBitInput
confSHARED_MEMORY_KEY	SharedMemoryKey	SharedMemoryKey
confSINGLE_LINE_FROM_HEADER	SingleLineFromHeader	SingleLineFromHeader
confSINGLE_THREAD_DELIVERY	SingleThreadDelivery	SingleThreadDelivery
confSMTP_LOGIN_MSG	SmtpGreetingMessage	SmtpGreetingMessage
confTEMP_FILE_MODE	TempFileMode	TempFileMode
confTIME_ZONE	TimeZoneSpec	TimeZoneSpec
confTLS_SRV_OPTIONS	TLSSrvOptions	TLSSrvOptions
confTO_ACONNECT	Timeout.aconnect	See this section
confTO_AUTH	Timeout.auth	See this section
confTO_COMMAND	Timeout.command	See this section
confTO_CONNECT	Timeout.connect	See this section
confTO_CONTROL	Timeout.control	See this section
confTO_DATABLOCK	Timeout.datablock	See this section
confTO_DATAFINAL	Timeout.datafinal	See this section
confTO_DATAINIT	Timeout.datainit	See this section
confTO_FILEOPEN	Timeout.fileopen	See this section
confTO_HELO	Timeout.helo	See this section
confTO_HOSTSTATUS	Timeout.hoststatus	See this section
confTO_ICONNECT	Timeout.iconnect	See this section
confTO_IDENT	Timeout.ident	See this section
confTO_INITIAL	Timeout.initial	See this section
confTO_LHLO	Timeout.lhlo	See this section
confTO_MAIL	Timeout.mail	See this section
confTO_MISC	Timeout.misc	See this section
confTO_QUEUERETURN	Timeout.queuereturn	See this section
confTO_QUEUERETURN_NONURGENT	Timeout.queuereturn.non-urgent	See this section
confTO_QUEUERETURN_NORMAL	Timeout.queuereturn.normal	See this section
confTO_QUEUERETURN_URGENT	Timeout.queuereturn.urgent	See this section
confTO_QUEUEWARN	Timeout.queuewarn	See this section
confTO_QUEUEWARN_NONURGENT	Timeout.queuewarn.non-urgent	See this section
confTO_QUEUEWARN_NORMAL	Timeout.queuewarn.normal	See this section
confTO_QUEUEWARN_URGENT	Timeout.queuewarn.urgent	See this section
confTO_QUIT	Timeout.quit	See this section
confTO_RCPT	Timeout.rcpt	See this section
confTO_RESOLVER_RETRANS	Timeout.resolver.retrans	See this section
confTO_RESOLVER_RETRANS_FIRST	Timeout.resolver.retrans.first	See this section
confTO_RESOLVER_RETRANS_NORMAL	Timeout.resolver.retrans.normal	See this section
confTO_RESOLVER_RETRY	Timeout.resolver.retry	See this section
confTO_RESOLVER_RETRY_FIRST	Timeout.resolver.retry.first	See this section
confTO_RESOLVER_RETRY_NORMAL	Timeout.resolver.retry.normal	See this section
confTO_RSET	Timeout.rset	See this section
confTO_STARTTLS	Timeout.starttls	See this section
confTRUSTED_USER	TrustedUser	TrustedUser
confTRY_NULL_MX_LIST	TryNullMXList	TryNullMXList
confUNSAFE_GROUP_WRITES (deprecated)	UnsafeGroupWrites	UnsafeGroupWrites
confUSERDB_SPEC	UserDatabaseSpec	UserDatabaseSpec
confUSE_ERRORS_TO	UseErrorsTo	UseErrorsTo
confUSE_MSP	UseMSP	UseMSP
confWORK_CLASS_FACTOR	ClassFactor	ClassFactor
confWORK_RECIPIENT_FACTOR	RecipientFactor	RecipientFactor
confWORK_TIME_FACTOR	RetryFactor	RetryFactor
confXF_BUFFER_SIZE	XscriptFileBufferSize	XscriptFileBufferSize
DAEMON_OPTIONS( )	DaemonPortOptions	DaemonPortOptions
HELP_FILE	HelpFile	HelpFile
INPUT_MAIL_FILTER( )	InputMailFilters	InputMailFilters
QUEUE_DIR	QueueDirectory	QueueDirectory
STATUS_FILE	StatusFile	StatusFile

24.4 Options in the mc File

Table 24-3. All option mc macros ordered by name