masqmail-0.2

annotate docs/howto-report-bugs @ 179:ec3fe72a3e99

Fixed an important bug with folded headers! g_strconcat() returns a *copy* of the string, but hdr->value still pointed to the old header (which probably was a memory leak, too). If the folded part had been quite small it was likely that the new string was at the same position as the old one, thus making everything go well. But if pretty long headers were folded several times it was likely that the new string was allocated somewhere else in memory, thus breaking things. In result mails to lots of recipients (folded header) were frequently only sent to the ones in the first line. Sorry for the inconvenience.
author meillo@marmaro.de
date Fri, 03 Jun 2011 09:52:17 +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>.