[OpenBSD]

How to report a Problem

Released versions problem reports.

Before reporting bugs/problems with released versions, go through this checklist:
  1. First check for patches and notes regarding the release.
  2. Next find out if there is a newer release available.
  3. The last thing to check is for changes made between OpenBSD versions.

If nothing looks like it addresses your problem, then it may be time to read man sendbug before submitting a bug report.

Read further down for the types of bug reports desired.

Current version problem reports.

  1. Test the problem at least twice, with source updated a few days apart.
  2. 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. People working on the project are doing make build at least once per day, and usually several times per day with different architectures.
  3. Remember that the anoncvs servers are updated significantly behind the actual working source tree.
  4. Check for changes made between OpenBSD versions to see if the problem has been addressed.
  5. Much care is made in creating snapshots. Sometimes mistakes are made, and our apologies are extended. Reading/writing the e-mail lists is more appropriate than sending in a bug report.

Sending in bug reports.

Try to pin-point the exact problem. Never give vague instructions, or detail vague problems like "it crashes" or "I get strange interrupt issues on this one box that I built." Talk to others on IRC or some other forum to confirm that it is new, repeatable, etc. and make sure it is not a local problem. And please don't start fixing problems that require significant work until you are sure you understand them, especially during our release periods when we must not change major sections of code. If you are going to write significant amounts of code, check various forums to make sure that someone else is not working on the problem (saving duplication of effort).

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.

For debugging some problems, we must have the hardware that has the problem. Please remember that projects resources are limited. You could donate some hardware.

Types of bug reports in order of desirability:

  1. Repeatable problems with source fixes are the best.
  2. Repeatable problems that are not specific to your hardware/software layout.
  3. Repeatable problems specific to your software layout.
  4. Repeatable problems specific to your hardware layout.
  5. Non-repeatable problems -- or problems you do not wish to repeat.