Commit | Line | Data |
---|---|---|
de45f55a AM |
1 | .\" Hey, EMACS: -*- nroff -*- |
2 | .\" First parameter, NAME, should be all caps | |
3 | .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection | |
4 | .\" other parameters are allowed: see man(7), man(1) | |
5 | .TH EXIM_CONVERT4R4 8 "March 26, 2003" | |
6 | .\" Please adjust this date whenever revising the manpage. | |
7 | .\" | |
8 | .\" Some roff macros, for reference: | |
9 | .\" .nh disable hyphenation | |
10 | .\" .hy enable hyphenation | |
11 | .\" .ad l left justify | |
12 | .\" .ad b justify to both left and right margins | |
13 | .\" .nf disable filling | |
14 | .\" .fi enable filling | |
15 | .\" .br insert line break | |
16 | .\" .sp <n> insert n+1 empty lines | |
17 | .\" for manpage-specific macros, see man(7) | |
18 | .\" \(oqthis text is enclosed in single quotes\(cq | |
19 | .\" \(lqthis text is enclosed in double quotes\(rq | |
20 | .SH NAME | |
21 | exim_convert4r4 \- Convert Exim configuration from v3 to v4 format | |
22 | .SH SYNOPSIS | |
23 | .B exim_convert4r4 | |
24 | ||
25 | .SH DESCRIPTION | |
26 | This script is provided to assist in updating Exim configuration files. | |
27 | It reads an Exim 3 configuration file on the standard input, and writes a | |
28 | modified file on the standard output. | |
29 | It also writes comments about what it has done to the standard error file. | |
30 | It assumes that the input is a valid Exim 3 configuration file. | |
31 | A typical call to the conversion script might be | |
32 | ||
33 | .I exim_convert4r4 < /etc/exim/exim.conf > /etc/exim4/exim4.conf.new | |
34 | ||
35 | The output file | |
36 | .B MUST | |
37 | be checked and tested before trying to use it on a live system. | |
38 | The conversion script is just an aid which does a lot of the \(lqgrunt | |
39 | work\(rq. | |
40 | It does not guarantee to produce an Exim 4 configuration that behaves | |
41 | exactly the same as the Exim 3 configuration it reads. | |
42 | ||
43 | Each option change in the new file is preceded by an identifying comment. | |
44 | In fact, the conversion script tends to make quite a mess of your | |
45 | configuration, and you should expect to go through it afterwards and tidy | |
46 | it up by hand. | |
47 | ||
48 | Unless you are running a very straightforward configuration, the automatic | |
49 | conversion is likely to generate a non-optimal configuration. | |
50 | You should not only check it thoroughly, but also run as many tests as you | |
51 | can, to ensure that it is working as you expect. | |
52 | In particular, you should test address routing, using \-bt and \-bv, and the | |
53 | policy controls, using \-bh. | |
54 | If possible, you should also do some live tests (i.e. send and receive | |
55 | some messages) before putting Exim 4 into service. | |
56 | ||
57 | If you have a very complicated configuration, it is possible that | |
58 | exim_convert4r4 will break it in some situations, which is why thorough | |
59 | testing is strongly recommended. | |
60 | ||
61 | .SH BUGS | |
62 | This manual page needs a major re-work. If somebody knows better groff | |
63 | than us and has more experience in writing manual pages, any patches | |
64 | would be greatly appreciated. | |
65 | ||
66 | .SH SEE ALSO | |
67 | .BR exim (8), | |
68 | the files in /usr/share/doc/exim4\-base/, especially Exim4.upgrade.gz | |
69 | ||
70 | .SH AUTHOR | |
71 | This manual page was stitched together from Exim4.upgrade by | |
72 | Andreas Metzler <ametzler at downhill.at.eu.org>, | |
73 | for the Debian GNU/Linux system (but may be used by others). |