diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:44:08 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:44:08 +0000 |
commit | 933bbaf3ed7bd659a5c044745aea763815928598 (patch) | |
tree | 6fe3906ff9f7121999800da3683c206d128b7d39 /debian/manpages/update-exim4.conf.template.8 | |
parent | Adding upstream version 4.94.2. (diff) | |
download | exim4-debian.tar.xz exim4-debian.zip |
Adding debian version 4.94.2-7+deb11u2.debian/4.94.2-7+deb11u2debian
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'debian/manpages/update-exim4.conf.template.8')
-rw-r--r-- | debian/manpages/update-exim4.conf.template.8 | 92 |
1 files changed, 92 insertions, 0 deletions
diff --git a/debian/manpages/update-exim4.conf.template.8 b/debian/manpages/update-exim4.conf.template.8 new file mode 100644 index 0000000..4b65a82 --- /dev/null +++ b/debian/manpages/update-exim4.conf.template.8 @@ -0,0 +1,92 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH UPDATE-EXIM4.CONF.TEMPLATE 8 "Feb 27, 2005" EXIM4 +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.\" \(oqthis text is enclosed in single quotes\(cq +.\" \(lqthis text is enclosed in double quotes\(rq +.SH NAME +update\-exim4.conf.template \- Regenerate exim4 configuration file template. +.SH SYNOPSIS +.B update\-exim4.conf.template [\-h|\-\-help] [\-n|\-\-nobackup] [\-o|\-\-output file] [\-r|\-\-run] + +.SH OPTIONS +.TP +.I \-h|\-\-help +Show short help message and exit +.TP +.I \-n|\-\-nobackup +Overwrite existing file, instead of keeping it as +/etc/exim4/exim4.conf.template.bak.random-number +.TP +.I \-o|\-\-output file +Write output to file instead of /etc/exim4/exim4.conf.template. +.TP +.I \-r|\-\-run +Actually do something. If this option is not specified +.B update\-exim4.conf.template +will exit immediately. This option was introduced because +.B update\-exim4.conf.template +overwrites configuration files. + +.SH DESCRIPTION +The script +.B update\-exim4.conf.template +regenerates the main configuration file template +.I /etc/exim4/exim4.conf.template +from the configuration snippets in the +.I /etc/exim4/conf.d +directory tree. +.PP +This process will overwrite all local changes in +.I /etc/exim4/exim4.conf.template +and might be useful if there are local changes in the +.I /etc/exim4/conf.d +directory tree, for example by a new mail related package dropping its +own configuration snippets in there. + +.B 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 +.B 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! + +.SH ENVIRONMENT +If +.B CONFDIR +is set +.B 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). + + +.SH 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. + +.SH SEE ALSO +.BR exim4 (8), +/usr/share/doc/exim4\-base/ and for general notes and details about interaction +with debconf +/usr/share/doc/exim4\-base/README.Debian.gz + +.SH AUTHOR +Marc Haber <mh+debian\-packages@zugschlus.de> |