masqmail
annotate docs/howto-report-bugs @ 407:164468dd0953
Minor refactoring.
| author | markus schnalke <meillo@marmaro.de> |
|---|---|
| date | Wed, 29 Feb 2012 10:37:21 +0100 |
| 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>. |