annotate docs/howto-report-bugs @ 304:d5ce2ba71e7b
manual formating of Received: hdrs; changed hdr for local receival
Now the Received: headers are much friendlier to read.
About folding: We must fold any line at 998 chars before transfer.
We should fold the lines we produce at 78 chars. That is what RFC
2821 requests. We should think about it, somewhen.
The header for locally (i.e. non-SMTP) received mail is changed
to the format postfix uses. This matches RFC 2821 better. The
`from' clause should contain a domain or IP, not a user name. Also,
the `with' clause should contain a registered standard protocol
name, which ``local'' is not.
| author |
markus schnalke <meillo@marmaro.de> |
| date |
Thu, 09 Dec 2010 18:28:11 -0300 |
| parents |
|
| children |
|
| rev |
line source |
|
meillo@67
|
1 Howto report bugs
|
|
meillo@67
|
2 =================
|
|
meillo@67
|
3
|
|
meillo@67
|
4 All non-trivial software has bugs and so does masqmail.
|
|
meillo@67
|
5
|
|
meillo@67
|
6 If you discover a bug then please report it. Your bug reports are an
|
|
meillo@67
|
7 important help in improving masqmail.
|
|
meillo@67
|
8
|
|
meillo@67
|
9 Valuable bug report include the following information. The first two
|
|
meillo@67
|
10 are essential, the others can also be added on request.
|
|
meillo@67
|
11
|
|
meillo@67
|
12 - A good description of what you consider to be the bug.
|
|
meillo@67
|
13
|
|
meillo@67
|
14 - The version of masqmail that was used. (The output of: masqmail -bV).
|
|
meillo@67
|
15
|
|
meillo@67
|
16 - A description on how to reproduce it. This includes information on
|
|
meillo@67
|
17 other software that is involved.
|
|
meillo@67
|
18
|
|
meillo@67
|
19 - The configuration files. These are probably the contents of
|
|
meillo@67
|
20 /etc/masqmail/*. Don't forget to substitute confidential data with
|
|
meillo@67
|
21 placeholders.
|
|
meillo@67
|
22
|
|
meillo@67
|
23 - The relevant log files. Have a look at the value of use_syslog and
|
|
meillo@67
|
24 log_dir in masqmail.conf. If use_syslog is enabled, the files are
|
|
meillo@67
|
25 probably some of /var/log/mail*. If you don't use syslog, then the
|
|
meillo@67
|
26 files reside unter the path assigned to log_dir, or by default in
|
|
meillo@67
|
27 /var/log/masqmail/. Take care to substitute confidential data if you
|
|
meillo@67
|
28 send debug files. (It's good to run masqmail with `-d 5' or `-d 6' to
|
|
meillo@67
|
29 generate debugging data that may help to track down the bug.
|
|
meillo@67
|
30
|
|
meillo@67
|
31 Report the bug to the mailing list <masqmail@marmaro.de>. You don't
|
|
meillo@67
|
32 have to be subscribed to write to the list. Please tell us if you're
|
|
meillo@67
|
33 not subscribed so that we set you on CC. If you want to subscribe, send
|
|
meillo@67
|
34 a mail with subject ``subscribe masqmail'' to <minimalist@marmaro.de>.
|
