carta
update-exim4.conf.template(8)

update-exim4.conf.template8

Regenerate exim4 configuration file template.

Usage

update-exim4.conf.template [{-h | --help}] [{-n | --nobackup}] [{-o | --output file}] [{-r | --run}]

Options

-h|--help

Show short help message and exit

-n|--nobackup

Overwrite existing file, instead of keeping it as /etc/exim4/exim4.conf.template.bak.random-number

-o|--output file

Write output to file instead of /etc/exim4/exim4.conf.template.

-r|--run

Actually do something. If this option is not specified update-exim4.conf.template will exit immediately. This option was introduced because update-exim4.conf.template overwrites configuration files.

Overview

The script update-exim4.conf.template regenerates the main configuration file template /etc/exim4/exim4.conf.template from the configuration snippets in the /etc/exim4/conf.d directory tree.

This process will overwrite all local changes in /etc/exim4/exim4.conf.template and might be useful if there are local changes in the /etc/exim4/conf.d directory tree, for example by a new mail related package dropping its own configuration snippets in there.

update-exim4.conf.template ignores all files in the conf.d directory that have a filename which does not consist only of letters, numbers, underscores and hyphens ([:alnum:]_-), similar to run-parts(8). For easy interaction with packages extending Exim additionally /etc/exim4/conf.d/foo/bar.rul is used instead of /etc/exim4/conf.d/foo/bar if it exists!

Environment

If CONFDIR is set update-exim4.conf.template will search for the input files below $CONFDIR/conf.d instead of /etc/exim4/conf.d/ and will write the output to $CONFDIR/exim4.conf.template instead of to /etc/exim4/exim4.conf.template (unless overridden with -o or --output).

History

  • Debian 13 (Trixie) to Debian 4.0 (Etch): the text shown here
  • Debian 3.1 (Sarge)

Bugs

This manual page needs a major re-work. If somebody knows better groff than us and has more experience in writing manual pages, any patches would be greatly appreciated.

Author

Marc Haber <[email protected]>

From exim4-config 4.98.2-1+deb13u4 in Debian 13 (Trixie). Parsed by carta from the page's man source.