masqmail

annotate docs/howto-report-bugs @ 72:ad034b57f3b2

fixed Debian bug 536060 (log files are closed after SIGHUP receival) Explanation: When run in daemon mode, first the log files are opened. They get assigned to the file descriptors 3 and 4 usually. Then std{in,out,err} are closed. When SIGHUP comes in, all open files are closes and masqmail reexecutes itself. The new masqmail instance opens the log files at fd 0 and 1 now, but std{in,out,err} are closed afterwards, thus the log files are closed. The fix is to close the log files before std{in,out,err} are closed, in case the log files have higher fds. After std{in,out,err} were closed, the log files get opened again, now. See also: http://bugs.debian.org/536060
author meillo@marmaro.de
date Wed, 16 Jun 2010 10:32:20 +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>.