[BACK]Return to report.html CVS log [TXT][DIR] Up to [local] / www / opensmtpd
File: [local] / www / opensmtpd / report.html (download) (as text)

Revision 1.11, Thu Jun 13 07:34:36 2019 UTC (4 years, 11 months ago) by bentley
Branch: MAIN
CVS Tags: HEAD
Changes since 1.10: +15 -20 lines 

HTML cleanup in remaining subprojects.

<!doctype html>
<html lang=en>
<meta charset=utf-8>

<title>OpenSMTPD: Problem Reports</title>
<meta name="description" content="OpenSMTPD Problem Reports">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" type="text/css" href="openbsd.css">
<link rel="canonical" href="https://www.opensmtpd.org/report.html">

<style>
h3 {
        color: var(--blue);
}
</style>

<h2 id=OpenBSD>
<a href="index.html">
<i>Open</i><b>SMTPD</b></a>
Problem Reports
</h2>
<hr>

<h3>Released versions problem reports</h3>

<p>
Before reporting bugs/problems with released OpenSMTPD versions,
go through this checklist:

<ol>
<li>Check for <a href="https://www.openbsd.org/errata.html">patches
	and notes regarding OpenSMTPD.</a>
<li>Find out if there is a newer version available for OpenBSD
or for the <a href="portable.html">portable release</a>,
depending upon your platform.
<!--
<li>Check the <a href="faq.html">FAQ</a> for problems frequently reported
	as bugs but which aren't.
-->
<li>Check the list of <a
href="https://github.com/poolpOrg/OpenSMTPD/issues?state=closed">
bugs fixed since the last release</a> and
<a
href="https://github.com/poolpOrg/OpenSMTPD/issues?state=open">
known bugs reported since the last release</a>.
</ol>

<p>
If nothing looks like it addresses your problem, then use the
<a href="http://github.com/poolpOrg/OpenSMTPD/issues">bug tracker</a>
to submit a bug report (but see below for reporting security
bugs privately).

<p>
<b>You can reach the OpenSMTPD developers by sending email to one of
the following <a href="list.html">lists</a></b>.

<h3>Current version problem reports</h3>

<ol>
<li>Test the problem at least twice, with source updated a few days apart.
<li>Do not report source tree compilation problems, unless they persist.
	They are almost always your mistake or they are being worked on
	as you encounter them.
<li>Remember that the <a href="https://www.openbsd.org/anoncvs.html">AnonCVS</a>
	servers are updated significantly behind the actual working source tree.
<li>Check for <a href="https://www.openbsd.org/plus.html">OpenSMTPD changes</a>
        to see if the problem has been addressed.
</ol>


<h3 id="bugtypes">Sending in bug reports</h3>

<p>
Try to pin-point the exact problem.  Never give vague instructions,
or detail vague problems like "it crashes."
Talk to others on IRC or use some
other forum such as the <a href="http://news.gmane.org/gmane.mail.opensmtpd.general">
mailing list archives</a>
to confirm that it is new, repeatable, etc., and make sure
it is not a local problem.

<p>
For an excellent overview of the art of reporting bugs, see Simon
Tatham's <a href="https://www.chiark.greenend.org.uk/~sgtatham/bugs.html">
How to Report Bugs Effectively</a>. Remember, the better the
information in your report, the better the chance that your problem
will be resolved.

<p>
New features are accepted, especially with code that implements
your suggested new feature.
If someone else writes code for your new feature, the chances are that
it will be misunderstood and created so that you will not recognize it.

<p>
Types of bug reports in order of desirability:

<ol>
<li>Repeatable problems with source fixes are the best.
<li>Repeatable problems that are not specific to your hardware/software
     layout.
<li>Repeatable problems specific to your software layout.
<li>Repeatable problems specific to your hardware layout.
</ol>