annotate docs/howto-report-bugs @ 160:60c92aa59911
added a script to guess the host's name
| author |
meillo@marmaro.de |
| date |
Thu, 08 Jul 2010 11:27:03 +0200 |
| 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>.
|
